summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDan Book <grinnz@grinnz.com>2019-03-18 18:29:26 -0400
committerKarl Williamson <khw@cpan.org>2019-12-18 18:47:54 -0700
commit758600332df6396bd902fa4a761230f89664ecb8 (patch)
treeec7f21e878ccd0111ac90922d4dbaa05fb08ae49
parent135c152c04369d49cad1146e7f7635ef3c11bd4c (diff)
downloadperl-758600332df6396bd902fa4a761230f89664ecb8.tar.gz
perlfunc: link to "Plain Old Comments" section of perlsyn from __FILE__, __LINE__, and caller
-rw-r--r--pod/perlfunc.pod8
1 files changed, 8 insertions, 0 deletions
diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index 81cf8099ac..af47dc2025 100644
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -947,6 +947,10 @@ list context, caller returns
# 0 1 2
my ($package, $filename, $line) = caller;
+Like L<C<__FILE__>|/__FILE__> and L<C<__LINE__>|/__LINE__>, the filename and
+line number returned here may be altered by the mechanism described at
+L<perlsyn/"Plain Old Comments (Not!)">.
+
With EXPR, it returns some extra information that the debugger uses to
print a stack trace. The value of EXPR indicates how many call frames
to go back before the current one.
@@ -2701,6 +2705,8 @@ X<__FILE__>
=for Pod::Functions the name of the current source file
A special token that returns the name of the file in which it occurs.
+It can be altered by the mechanism described at
+L<perlsyn/"Plain Old Comments (Not!)">.
=item fileno FILEHANDLE
X<fileno>
@@ -3955,6 +3961,8 @@ X<__LINE__>
=for Pod::Functions the current source line number
A special token that compiles to the current line number.
+It can be altered by the mechanism described at
+L<perlsyn/"Plain Old Comments (Not!)">.
=item link OLDFILE,NEWFILE
X<link>