Document message identity in debugging.md

Addresses #1931
Kotlin · Jun 7, 2021 · b5eb8c4 · b5eb8c4
1 parent 113e034
commit b5eb8c4
Showing 1 changed file with 3 additions and 1 deletion.
diff --git a/docs/topics/debugging.md b/docs/topics/debugging.md
@@ -63,7 +63,9 @@ Exception copy logic is straightforward:
   1) If the exception class implements [CopyableThrowable], [CopyableThrowable.createCopy] is used.
      `null` can be returned from `createCopy` to opt-out specific exception from being recovered.
   2) If the exception class has class-specific fields not inherited from Throwable, the exception is not copied.
-  3) Otherwise, one of the public exception's constructor is invoked reflectively with an optional `initCause` call.  
+  3) Otherwise, one of the public exception's constructor is invoked reflectively with an optional `initCause` call. 
+  4) If the reflective copy has a changed message (exception class modifies 'message' parameter before passing it to the superclass), 
+     the exception is not copied in order to preserve a human-readable message. [CopyableThrowable] does not have such limitation.
 
 ## Debug agent