summaryrefslogtreecommitdiff
path: root/pod/perlrun.pod
diff options
context:
space:
mode:
authorBram <perl-rt@wizbit.be>2008-04-27 23:13:36 +0200
committerRafael Garcia-Suarez <rgarciasuarez@gmail.com>2008-04-27 20:04:30 +0000
commit3d6c2ba7f810e9262a5ab163b7db957e54c6f909 (patch)
tree3ccb2b42f7295ba8c45a1cb439fa33ebc13d434f /pod/perlrun.pod
parent8241c1c0382dd31d3def3db892c79428fb5ea2fc (diff)
downloadperl-3d6c2ba7f810e9262a5ab163b7db957e54c6f909.tar.gz
doc patch for perlrun -x
Message-ID: <20080427211336.g8mvjusbcc4gwsk4@horde.wizbit.be> p4raw-id: //depot/perl@33760
Diffstat (limited to 'pod/perlrun.pod')
-rw-r--r--pod/perlrun.pod8
1 files changed, 8 insertions, 0 deletions
diff --git a/pod/perlrun.pod b/pod/perlrun.pod
index 74fd0adcaa..a8458a8b7d 100644
--- a/pod/perlrun.pod
+++ b/pod/perlrun.pod
@@ -899,6 +899,14 @@ tells Perl that the program is embedded in a larger chunk of unrelated
ASCII text, such as in a mail message. Leading garbage will be
discarded until the first line that starts with #! and contains the
string "perl". Any meaningful switches on that line will be applied.
+
+All references to line numbers by the program (warnings, errors, ...)
+will treat the #! line as the first line.
+Thus a warning on the 2nd line of the program (which is on the 100th
+line in the file) will be reported as line 2, and not as line 100.
+This can be overridden by using the #line directive.
+(See L<perlsyn/"Plain-Old-Comments-(Not!)">)
+
If a directory name is specified, Perl will switch to that directory
before running the program. The B<-x> switch controls only the
disposal of leading garbage. The program must be terminated with