From: Nicholas Clark Date: Tue, 31 Mar 2009 21:06:14 +0000 (+0100) Subject: Remove the 5.005 threads details from the documentation for :locked and :method X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=0a8c518df299633eda796f21e99f6f1d0a78715a;p=p5sagit%2Fp5-mst-13.2.git Remove the 5.005 threads details from the documentation for :locked and :method --- diff --git a/lib/attributes.pm b/lib/attributes.pm index aa532c2..216583a 100644 --- a/lib/attributes.pm +++ b/lib/attributes.pm @@ -1,6 +1,6 @@ package attributes; -our $VERSION = 0.09; +our $VERSION = 0.10; @EXPORT_OK = qw(get reftype); @EXPORT = (); @@ -194,34 +194,21 @@ The following are the built-in attributes for subroutines: =over 4 -=item locked - -B<5.005 threads only! The use of the "locked" attribute currently -only makes sense if you are using the deprecated "Perl 5.005 threads" -implementation of threads.> +=item lvalue -Setting this attribute is only meaningful when the subroutine or -method is to be called by multiple threads. When set on a method -subroutine (i.e., one marked with the B attribute below), -Perl ensures that any invocation of it implicitly locks its first -argument before execution. When set on a non-method subroutine, -Perl ensures that a lock is taken on the subroutine itself before -execution. The semantics of the lock are exactly those of one -explicitly taken with the C operator immediately after the -subroutine is entered. +Indicates that the referenced subroutine is a valid lvalue and can +be assigned to. The subroutine must return a modifiable value such +as a scalar variable, as described in L. =item method -Indicates that the referenced subroutine is a method. -This has a meaning when taken together with the B attribute, -as described there. It also means that a subroutine so marked +Indicates that the referenced subroutine is a method. A subroutine so marked will not trigger the "Ambiguous call resolved as CORE::%s" warning. -=item lvalue +=item locked -Indicates that the referenced subroutine is a valid lvalue and can -be assigned to. The subroutine must return a modifiable value such -as a scalar variable, as described in L. +The "locked" attribute has no effect in 5.10.0 and later. It was used as part +of the now-removed "Perl 5.005 threads". =back