X-Git-Url: http://git.vpit.fr/?p=perl%2Fmodules%2Findirect.git;a=blobdiff_plain;f=README;h=6088d3085ac097a307c7a0be19c4fc09a77dab90;hp=ab4fa5e204652fa8988e61722ca8dc0cbe088095;hb=0a8741013832fe465960ec1d6c7618f697f3d21e;hpb=781011eb8539d9f2d52748e681882d94dd004039 diff --git a/README b/README index ab4fa5e..6088d30 100644 --- 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, "", . @@ -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.