Author: particle
Date: 2008-12-19 23:06:58 +0100 (Fri, 19 Dec 2008)
New Revision: 24501
Modified:
docs/Perl6/Spec/S19-commandline.pod
Log:
[spec] updates to notes, and minor clarifications
Modified: docs/Perl6/Spec/S19-commandline.pod
===================================================================
--- docs/Perl6/Spec/S19-commandline.pod 2008-12-19 22:06:16 UTC (rev 24500)
+++ docs/Perl6/Spec/S19-commandline.pod 2008-12-19 22:06:58 UTC (rev 24501)
@@ -27,13 +27,10 @@
the compiler and the operating system's command line shell, and thus is not
accessed via a consistent syntax everywhere. Perl is born of Unix, and as such
the syntax presented in this document is expected to work in a Unix-style
-shell. To explore the particularities of other operating systems, see ....
+shell. To explore the particularities of other operating systems, see
+L<Synopsis 25|S25-portability> (TBD).
-{{ -jg
-need reference to 'porting' chapter or equivalent above -- S25?
-}
-
=head1 Command Line Elements
The command line is broken down into two basic elements: a I<compiler>, and
@@ -100,8 +97,9 @@
=item *
-The special option C<--> signals the parser to stop option processing,
-everything afterwards is parsed as a value.
+The special option C<--> signals the parser to stop option processing.
+Arguments following C<--> are always parsed as a list of values, even if
+they look like valid options.
=back
@@ -278,6 +276,10 @@
Service: Option
+Notes: When this option is parsed, it immediately triggers an action that
+could affect the remainder of the parse. Therefore, it's a good idea to put
+this option/value pair as early as possible in the argument list.
+
{{ TODO more details needed }}
=item -c
@@ -502,15 +504,10 @@
do i need to address any unicode concerns?
-loading a switch parsing module by a switch, instead of using the default.
-maybe via ++RTS, since it needs to happen *before* switches are evaluated.
-
sandboxing? maybe-r
env var? maybe -E
-redefining services like -n or -p
-
-e multiple args or multiple times, to affect later -e's
}}
