X-Git-Url: http://git.vpit.fr/?p=perl%2Fmodules%2Findirect.git;a=blobdiff_plain;f=README;h=efc7130ba9c2bf37cc91fa642f84fcc5852ff653;hp=18baca1937f77f7e2ae3bc8d39b1aada845f2bd4;hb=8e1c49f42da7671812398f92d819da04c7a41e1b;hpb=93dd6e5ecfa09f52a9aa17909df51d09a0a0a6ff diff --git a/README b/README index 18baca1..efc7130 100644 --- a/README +++ b/README @@ -2,7 +2,7 @@ NAME indirect - Lexically warn about using the indirect object syntax. VERSION - Version 0.13 + Version 0.15 SYNOPSIS # In a script @@ -12,8 +12,8 @@ SYNOPSIS 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'; @@ -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 - 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"). @@ -60,9 +60,15 @@ METHODS 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 + 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").