In perl.git, the branch blead has been updated
<https://perl5.git.perl.org/perl.git/commitdiff/0165f7b01e9c43629d0c6f4b5eb2e672abeda51a?hp=dd9e86b4501b7c8aeba1f5ebda9f8907747c443f>
- Log -----------------------------------------------------------------
commit 0165f7b01e9c43629d0c6f4b5eb2e672abeda51a
Author: Zefram <zef...@fysh.org>
Date: Tue Dec 12 03:53:33 2017 +0000
fix doc about filter subroutines' $_[0]
Filter subroutines established by an @INC callback have always received
a numeric zero as their first argument, not a referencet to the sub
as documented. Fixes [perl #115754].
-----------------------------------------------------------------------
Summary of changes:
pod/perlfunc.pod | 5 +++--
1 file changed, 3 insertions(+), 2 deletions(-)
diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index 8e3a9079b5..0cf5031c25 100644
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -6507,11 +6507,12 @@ subroutine will be called to act as a simple source
filter, with the
line as read in L<C<$_>|perlvar/$_>.
Again, return 1 for each valid line, and 0 after all lines have been
returned.
+For historical reasons the subroutine will receive a meaningless argument
+(in fact always the numeric value zero) as C<$_[0]>.
=item 4
-Optional state for the subroutine. The state is passed in as C<$_[1]>. A
-reference to the subroutine itself is passed in as C<$_[0]>.
+Optional state for the subroutine. The state is passed in as C<$_[1]>.
=back
--
Perl5 Master Repository
