Change 12094 by jhi@alpha on 2001/09/20 12:49:17
Subject: [PATCH docs] Re: ARGV and read
From: Dave Mitchell <[EMAIL PROTECTED]>
Date: Thu, 20 Sep 2001 13:21:31 +0100 (BST)
Message-Id: <[EMAIL PROTECTED]>
Affected files ...
... //depot/perl/pod/perltodo.pod#33 edit
... //depot/perl/pod/perlvar.pod#75 edit
Differences ...
==== //depot/perl/pod/perltodo.pod#33 (text) ====
Index: perl/pod/perltodo.pod
--- perl/pod/perltodo.pod.~1~ Thu Sep 20 07:00:06 2001
+++ perl/pod/perltodo.pod Thu Sep 20 07:00:06 2001
@@ -330,6 +330,8 @@
=head2 All ARGV input should act like E<lt>E<gt>
+eg C<read(ARGV, ...)> doesn't currently read across multiple files.
+
=head2 Support for rerunning debugger
There should be a way of restarting the debugger on demand.
==== //depot/perl/pod/perlvar.pod#75 (text) ====
Index: perl/pod/perlvar.pod
--- perl/pod/perlvar.pod.~1~ Thu Sep 20 07:00:06 2001
+++ perl/pod/perlvar.pod Thu Sep 20 07:00:06 2001
@@ -1095,6 +1095,17 @@
The name that the Perl binary itself was executed as, from C's C<argv[0]>.
This may not be a full pathname, nor even necessarily in your path.
+=item ARGV
+
+The special filehandle that iterates over command-line filenames in
+C<@ARGV>. Usually written as the null filehandle in the angle operator
+C<< <> >>. Note that currently C<ARGV> only has its magical effect
+within the C<< <> >> operator; elsewhere it is just a plain filehandle
+corresponding to the last file opened by C<< <> >>. In particular,
+passing C<\*ARGV> as a parameter to a function that expects a filehandle
+may not cause your function to automatically read the contents of all the
+files in C<@ARGV>.
+
=item $ARGV
contains the name of the current file when reading from <>.
End of Patch.
