X-Git-Url: http://git.vpit.fr/?a=blobdiff_plain;f=README;h=c8d4438069cd48b8c935dbfb0066d55407211097;hb=9e1c36b4c0f232d32543bae20c0510cca7c287ea;hp=50f7a527557bb2bbe22eed79e73e704a393fff4e;hpb=d4d9cefeb432c16bc7994c784bed08b6b17f2b25;p=perl%2Fmodules%2Findirect.git

diff --git a/README b/README
index 50f7a52..c8d4438 100644
--- a/README
+++ b/README
@@ -2,18 +2,30 @@ NAME
     indirect - Lexically warn about using the indirect object syntax.
 
 VERSION
-    Version 0.09_01
+    Version 0.12
 
 SYNOPSIS
+        # In a script
         no indirect;
         my $x = new Apple 1, 2, 3; # warns
         {
          use indirect;
          my $y = new Pear; # ok
+         {
+          no indirect hook => sub { die "You really wanted $_[0]\->$_[1]" };
+          my $z = new Pineapple 'fresh'; # croaks 'You really wanted Pineapple->new'
+         }
         }
         no indirect ':fatal';
         if (defied $foo) { ... } # croaks, note the typo
 
+        # From the command-line
+        perl -M-indirect -e 'my $x = new Banana;' # warns
+
+        # Or each time perl is ran
+        export PERL5OPT="-M-indirect"
+        perl -e 'my $y = new Coconut;' # warns
+
 DESCRIPTION
     When enabled (or disabled as some may prefer to say, since you actually
     turn it on by calling "no indirect"), this pragma warns about indirect
@@ -30,18 +42,25 @@ DESCRIPTION
     This module is not a source filter.
 
 METHODS
-  "unimport @opts"
+  "unimport [ hook => $hook | ':fatal' ]"
     Magically called when "no indirect @opts" is encountered. Turns the
-    module on. If @opts contains ':fatal', the module will croak on the
-    first indirect syntax met.
+    module on. The policy to apply depends on what is first found in @opts :
+
+    *   If it's the string ':fatal', the compilation will croak on the first
+        indirect syntax met.
+
+    *   If the key/value pair "hook => $hook" comes first, $hook will be
+        called for each error with the object name as $_[0] and the method
+        name as $_[1].
+
+    *   Otherwise, a warning will be emitted for each indirect construct.
 
   "import"
     Magically called at each "use indirect". Turns the module off.
 
-DEPENDENCIES
-    perl 5.8.
-
-    XSLoader (standard since perl 5.006).
+CONSTANTS
+  "I_THREADSAFE"
+    True iff the module could have been built when thread-safety features.
 
 CAVEATS
     "meth $obj" (no semicolon) at the end of a file won't be seen as an
@@ -52,6 +71,11 @@ CAVEATS
     is due to a shortcoming in the way perl handles the hints hash, which is
     addressed in perl 5.10.
 
+DEPENDENCIES
+    perl 5.8.
+
+    XSLoader (standard since perl 5.006).
+
 AUTHOR
     Vincent Pit, "<perl at profvince.com>", <http://www.profvince.com>.
 
@@ -76,7 +100,7 @@ ACKNOWLEDGEMENTS
     Bram, for motivation and advices.
 
 COPYRIGHT & LICENSE
-    Copyright 2008 Vincent Pit, all rights reserved.
+    Copyright 2008-2009 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.