diff options
| author | Father Chrysostomos <sprout@cpan.org> | 2012-03-01 12:24:38 -0800 |
|---|---|---|
| committer | Father Chrysostomos <sprout@cpan.org> | 2012-03-01 12:34:33 -0800 |
| commit | 345d70e3f599db40c8311185ac403b1a5b35d2a5 (patch) | |
| tree | 7c552c2997e5770ec28a1ea7ff1c82257942b9ca /pod | |
| parent | d68a48384ff2e631bc3a38a3fdb6c2bc75e0ea9f (diff) | |
| download | perl-345d70e3f599db40c8311185ac403b1a5b35d2a5.tar.gz | |
[perl #107366] Allow attributes to set :lvalue on defined sub
This provides enough rope for those who want to hang themselves, and
also for those who know how to use the rope without hanging them-
selves. :-)
Since this is not generally a reliable thing to be doing, a warning is emitted whenever :lvalue is turned on or off on a defined subroutine.
But attributes.pm will flip the flag anyway. :lvalue in a sub declar-
ation still refuses to modify a defined Perl sub, as before.
Diffstat (limited to 'pod')
| -rw-r--r-- | pod/perldiag.pod | 22 |
1 files changed, 14 insertions, 8 deletions
diff --git a/pod/perldiag.pod b/pod/perldiag.pod index 1b67ccde28..5f6ed837f1 100644 --- a/pod/perldiag.pod +++ b/pod/perldiag.pod @@ -2627,18 +2627,24 @@ You may wish to switch to using L<Math::BigInt> explicitly. by that? lstat() makes sense only on filenames. (Perl did a fstat() instead on the filehandle.) -=item lvalue attribute cannot be removed after the subroutine has been defined +=item lvalue attribute %s already-defined subroutine -(W misc) The lvalue attribute on a Perl subroutine cannot be turned off -once the subroutine is defined. +(W misc) Although L<attributes.pm|attributes> allows this, turning the lvalue +attribute on or off on a Perl subroutine that is already defined +does not always work properly. It may or may not do what you +want, depending on what code is inside the subroutine, with exact +details subject to change between Perl versions. Only do this +if you really know what you are doing. =item lvalue attribute ignored after the subroutine has been defined -(W misc) Making a Perl subroutine an lvalue subroutine after it has been -defined, whether by declaring the subroutine with an lvalue attribute -or by using L<attributes.pm|attributes>, is not possible. To make the subroutine an -lvalue subroutine, add the lvalue attribute to the definition, or put -the declaration before the definition. +(W misc) Using the C<:lvalue> declarative syntax to make a Perl +subroutine an lvalue subroutine after it has been defined is +not permitted. To make the subroutine an lvalue subroutine, +add the lvalue attribute to the definition, or put the C<sub +foo :lvalue;> declaration before the definition. + +See also L<attributes.pm|attributes>. =item Malformed integer in [] in pack |