Docuemnt $_ vs. $@ gotcha in catch for exception stack capturing

diff --git a/lib/Try/Tiny.pm b/lib/Try/Tiny.pm
index a220602..e1885d7 100644 (file)
--- a/lib/Try/Tiny.pm
+++ b/lib/Try/Tiny.pm
@@ -236,6 +236,11 @@ Inside the catch block the previous value of C<$@> is still available for use.
 This value may or may not be meaningful depending on what happened before the
 C<try>, but it might be a good idea to preserve it in an error stack.
 
+For code that captures C<$@> when throwing new errors (i.e.
+L<Class::Throwable>), you'll need to do:
+
+       local $@ = $_;
+
 =item finally (&;$)
 
   try     { ... }