X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=gitmo%2FMouse.git;a=blobdiff_plain;f=lib%2FMouse.pm;h=279d58caabdd4d3c3904cbbe470c9ebefef00bd5;hp=41f6b0cd9811b98bc4e50ffec6c3845233081872;hb=13756394019ebd1535c45fdca817887ce6a0b122;hpb=d0773d24434581f9ef0603d47dd2bc325097cc1b

diff --git a/lib/Mouse.pm b/lib/Mouse.pm
index 41f6b0c..279d58c 100644
--- a/lib/Mouse.pm
+++ b/lib/Mouse.pm
@@ -402,6 +402,21 @@ You may use L</extends> to replace the superclass list.
 Please unimport Mouse (C<no Mouse>) so that if someone calls one of the
 keywords (such as L</extends>) it will break loudly instead breaking subtly.
 
+=head1 CAVEATS
+
+If you use Mouse::XS you might see a silent fatal error when you use
+callbacks which include C<eval 'use MayNotBeInstalled'>. This is not
+a bug in Mouse. In fact, it is a bug in Perl (RT #69939).
+
+To work around this problem, surround C<eval STRING> with C<eval BLOCK>:
+
+    sub callback {
+        # eval 'use MayNotBeInstalled';       # NG
+        eval{ eval 'use MayNotBeInstalled' }; # OK
+    }
+
+It seems ridiculous, but it works as you expected.
+
 =head1 SOURCE CODE ACCESS
 
 We have a public git repository: