Only enable the pragma during compile time

[perl/modules/indirect.git] / README

diff --git a/README b/README
index 18baca1937f77f7e2ae3bc8d39b1aada845f2bd4..efc7130ba9c2bf37cc91fa642f84fcc5852ff653 100644 (file)
--- a/README
+++ b/README
@@ -2,7 +2,7 @@ NAME
     indirect - Lexically warn about using the indirect object syntax.
 
 VERSION
     indirect - Lexically warn about using the indirect object syntax.
 
 VERSION

-    Version 0.13
+    Version 0.15

 
 SYNOPSIS
         # In a script
 
 SYNOPSIS
         # In a script


@@ -12,8 +12,8 @@ SYNOPSIS
          use indirect;
          my $y = new Pear; # ok
          {
          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 hook => sub { die "You really wanted $_[0]\->$_[1] at $_[2]:$_[3]" };
+          my $z = new Pineapple 'fresh'; # croaks 'You really wanted Pineapple->new at blurp.pm:13'

          }
         }
         no indirect ':fatal';
          }
         }
         no indirect ':fatal';


@@ -31,8 +31,8 @@ DESCRIPTION
     turn it on by calling "no indirect"), this pragma warns about indirect
     object syntax constructs that may have slipped into your code. This
     syntax is now considered harmful, since its parsing has many quirks and
     turn it on by calling "no indirect"), this pragma warns about indirect
     object syntax constructs that may have slipped into your code. This
     syntax is now considered harmful, since its parsing has many quirks and

-    its use is error prone (when "sub" isn't defined, "sub $x" is actually
-    interpreted as "$x->sub").
+    its use is error prone (when "swoosh" isn't defined, "swoosh $x"
+    actually compiles to "$x->swoosh").

 
     It currently does not warn when the object is enclosed between braces
     (like "meth { $obj } @args") or for core functions ("print" or "say").
 
     It currently does not warn when the object is enclosed between braces
     (like "meth { $obj } @args") or for core functions ("print" or "say").


@@ -60,9 +60,15 @@ METHODS
 
 CONSTANTS
   "I_THREADSAFE"
 
 CONSTANTS
   "I_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.

 
 CAVEATS
 
 CAVEATS

+    The implementation was tweaked to work around several limitations of
+    vanilla "perl" pragmas : it's thread safe, and doesn't suffer from a
+    "perl 5.8.x-5.10.0" bug that causes all pragmas to propagate into
+    "require"d scopes.
+

     "meth $obj" (no semicolon) at the end of a file won't be seen as an
     indirect object syntax, although it will as soon as there is another
     token before the end (as in "meth $obj;" or "meth $obj 1").
     "meth $obj" (no semicolon) at the end of a file won't be seen as an
     indirect object syntax, although it will as soon as there is another
     token before the end (as in "meth $obj;" or "meth $obj 1").