Author: particle
Date: 2009-01-02 16:42:53 +0100 (Fri, 02 Jan 2009)
New Revision: 24735

Modified:
   docs/Perl6/Spec/S19-commandline.pod
Log:
[S19] explain how script passed on command-line or via STDIN works

Modified: docs/Perl6/Spec/S19-commandline.pod
===================================================================
--- docs/Perl6/Spec/S19-commandline.pod 2009-01-02 14:15:35 UTC (rev 24734)
+++ docs/Perl6/Spec/S19-commandline.pod 2009-01-02 15:42:53 UTC (rev 24735)
@@ -73,7 +73,9 @@
 Command line I<arguments> are broken down into I<options> and I<values>.
 Each option may take zero or more values. After all options have been
 processed, the remaining values (if any) generally consist of the name of a
-script, followed by arguments for that script.
+script for Perl to execute, followed by arguments for that script. If no
+values remain, Perl 6 reads the script from STDIN--you must specify the
+special C<-> option if you wish to pass arguments to a script read from STDIN.
 
 
 =head1 Backward (In)compatibility
@@ -305,9 +307,10 @@
 
 {{rename done}}
 
+
 =head1 Option Reference
 
-Perl 6 options, descriptions, categories, and services
+Perl 6 options, descriptions, and services.
 
 =over 4
 
@@ -458,15 +461,12 @@
 
 Notes: Desugars to C<++PARSER --prelude=Perl6-autoloop-print ++/PARSER>.
 
-=item --search-path, -S
+=item --search-path, -S path
 
-Use path to search for program.
+Use path to search for script specified on command-line.
 
 Service: Runtime
 
-[you need a story for when the first argument is treated as
-the program name. e.g. when you *don't* use -e to supply the program.]
-
 =item --taint, -T
 
 Turns on "taint" checking. See L<...> for details.

Reply via email to