Protect run_perl() tests against old relocated perls

[perl/modules/indirect.git] / README

diff --git a/README b/README
index ab4fa5e204652fa8988e61722ca8dc0cbe088095..6088d3085ac097a307c7a0be19c4fc09a77dab90 100644 (file)
--- a/README
+++ b/README
@@ -2,7 +2,7 @@ NAME
     indirect - Lexically warn about using the indirect method call syntax.
 
 VERSION
-    Version 0.26
+    Version 0.33
 
 SYNOPSIS
     In a script :
@@ -54,7 +54,14 @@ DESCRIPTION
     This module is not a source filter.
 
 METHODS
-  "unimport [ 'global', hook => $hook | 'fatal' ]"
+  "unimport"
+        no indirect;
+        no indirect 'fatal';
+        no indirect hook => sub { my ($obj, $name, $file, $line) = @_; ... };
+        no indirect 'global';
+        no indirect 'global, 'fatal';
+        no indirect 'global', hook => sub { ... };
+
     Magically called when "no indirect @opts" is encountered. Turns the
     module on. The policy to apply depends on what is first found in @opts :
 
@@ -101,6 +108,8 @@ METHODS
             }
 
   "import"
+        use indirect;
+
     Magically called at each "use indirect". Turns the module off.
 
     As explained in "unimport"'s description, an "use indirect" statement
@@ -108,7 +117,9 @@ METHODS
     indirect 'global', ..." (if there's one).
 
 FUNCTIONS
-  "msg $object, $method, $file, $line"
+  "msg"
+        my $msg = msg($object, $method, $file, $line);
+
     Returns the default error message that "indirect" generates when an
     indirect method call is reported.
 
@@ -159,6 +170,10 @@ CAVEATS
     is due to a shortcoming in the way perl handles the hints hash, which is
     addressed in perl 5.10.
 
+    Indirect constructs that appear in code "eval"'d during the global
+    destruction phase of a spawned thread or pseudo-fork (the processes used
+    internally for the "fork" emulation on Windows) are not reported.
+
     The search for indirect method calls happens before constant folding.
     Hence "my $x = new Class if 0" will be caught.
 
@@ -168,7 +183,7 @@ DEPENDENCIES
     A C compiler. This module may happen to build with a C++ compiler as
     well, but don't rely on it, as no guarantee is made in this regard.
 
-    Carp (standard since perl 5), XSLoader (since perl 5.006).
+    Carp (standard since perl 5), XSLoader (since perl 5.6.0).
 
 AUTHOR
     Vincent Pit, "<perl at profvince.com>", <http://www.profvince.com>.
@@ -197,7 +212,8 @@ ACKNOWLEDGEMENTS
     reporting issues.
 
 COPYRIGHT & LICENSE
-    Copyright 2008,2009,2010,2011 Vincent Pit, all rights reserved.
+    Copyright 2008,2009,2010,2011,2012,2013,2014 Vincent Pit, all rights
+    reserved.
 
     This program is free software; you can redistribute it and/or modify it
     under the same terms as Perl itself.