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

[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