POD enhancements

diff --git a/lib/Lexical/Types.pm b/lib/Lexical/Types.pm
index 14f269957ad364a3ee8537df2da517e213e57fda..e4d9787aff251867d4df231e7ece47c6879f4b77 100644 (file)
--- a/lib/Lexical/Types.pm
+++ b/lib/Lexical/Types.pm
@@ -249,7 +249,7 @@ If you prefer to use constants rather than creating empty packages, you can repl
 
 =head2 C<LT_THREADSAFE>
 
-True iff the module could have been built when thread-safety features.
+True iff the module could have been built with thread-safety features enabled.
 
 =head1 CAVEATS
 
@@ -257,6 +257,11 @@ The restrictions on the type (being either a defined package name or a constant)
 
 Only one mangler or prefix can be in use at the same time in a given scope.
 
+The implementation was tweaked to work around several limitations of vanilla C<perl> pragmas : it's thread safe, and doesn't suffer from a C<perl 5.8.x-5.10.0> bug that causes all pragmas to propagate into C<require>d scopes.
+
+With 5.8 perls, the pragma does not propagate into C<eval STRING>.
+This is due to a shortcoming in the way perl handles the hints hash, which is addressed in perl 5.10.
+
 =head1 DEPENDENCIES
 
 L<perl> 5.8, L<XSLoader>.