Get rid of NonRecoverableThrowable, mention way to opt-out stacktrace… (#1420)
Get rid of NonRecoverableThrowable, mention way to opt-out stacktrace recovery in debugging.md
diff --git a/docs/debugging.md b/docs/debugging.md
index fc85701..e2c7ec1 100644
--- a/docs/debugging.md
+++ b/docs/debugging.md
@@ -45,7 +45,7 @@
The only downside of this approach is losing referential transparency of the exception.
-### Stacktrace recovery machinery
+### Stacktrace recovery machinery
This section explains the inner mechanism of stacktrace recovery and can be skipped.
@@ -56,6 +56,7 @@
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.