Author: particle Date: 2009-02-05 03:14:01 +0100 (Thu, 05 Feb 2009) New Revision: 25200
Added: t/spec/S19-command-line/ t/spec/S19-invalid/ Modified: docs/Perl6/Spec/S19-commandline.pod Log: [S19] --autoloop-split, -a: assigns result to @_; signature and option name fixups Modified: docs/Perl6/Spec/S19-commandline.pod =================================================================== --- docs/Perl6/Spec/S19-commandline.pod 2009-02-05 01:59:03 UTC (rev 25199) +++ docs/Perl6/Spec/S19-commandline.pod 2009-02-05 02:14:01 UTC (rev 25200) @@ -15,7 +15,7 @@ Maintainer: Jerry Gay <jerry....@rakudoconsulting.com> Date: 12 Dec 2008 Last Modified: 4 Feb 2009 - Version: 17 + Version: 18 This is a draft document. This document describes the command line interface. It has changed extensively from previous versions of Perl in order to increase @@ -369,20 +369,21 @@ =head2 Synopsis multi sub perl6( - Bool :a($autosplit), + Bool :a($autoloop-split), Bool :c($check-syntax), Bool :$doc, :e($execute), - :F($autoloop-split), + :F($autoloop-delim), Bool :h($help), :I(@include), - :u($use), + :L($language), Bool :n($autoloop-no-print), :O($output-format) = 'exe', :o($output-file) = $*OUT, Bool :p($autoloop-print), Bool :S($search-path), Bool :T($taint), + :u($use), Bool :v($version), Bool :V($verbose-config), ); @@ -391,12 +392,13 @@ =over 4 -=item --autosplit, -a +=item --autoloop-split, -a -Turns on autosplit mode. +When used with C<-n> or C<-p>, implicitly splits input on whitespace +(by default) and assigns the result to C<@_> within the loop produced +by the C<-n> or C<-p>. -=for consideration -[what does it split to? @F like P5? Or should we switch to @_? --law] +An alternate delimiter may be specified with C<--autoloop-delim>, a.k.a. C<-F>. =item ++CMD --command-line-parser *parser* ++/CMD @@ -440,7 +442,7 @@ =for consideration [doesn't work without a semicolon! (unless we special case it) --law] -=item --autoloop-split, -F *expression* +=item --autoloop-delim, -F *expression* Pattern to split on (used with -a). Substitutes an expression for the default split function, which is C<{split ' '}>. Accepts unicode strings (as long as