Author: particle
Date: 2009-02-05 02:56:04 +0100 (Thu, 05 Feb 2009)
New Revision: 25198

[S19] adding --extract-from-text, -x; similar behavior to perl 5, but file may 
now contain unicode text

Modified: docs/Perl6/Spec/S19-commandline.pod
--- docs/Perl6/Spec/S19-commandline.pod 2009-02-05 01:50:35 UTC (rev 25197)
+++ docs/Perl6/Spec/S19-commandline.pod 2009-02-05 01:56:04 UTC (rev 25198)
@@ -14,8 +14,8 @@
   Maintainer: Jerry Gay <>
   Date: 12 Dec 2008
-  Last Modified: 1 Feb 2009
-  Version: 16
+  Last Modified: 4 Feb 2009
+  Version: 17
 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
@@ -212,14 +212,6 @@
 Enable all warnings.  This is infrequently used, and doesn't deserve its
 own command-line option.
-=item -x
-Run program embedded in ASCII text.  Infrequently used, and doesn't
-deserve its own command-line option.
-=for consideration
-[but there's no other way to get that functionality if we ever want it. --law]
 =item -X
 Disable all warnings.  This is infrequently used, and doesn't deserve its
@@ -525,6 +517,16 @@
 Display configuration details.  Desugars to
+=item --extract-from-text, -x
+Run program embedded in Unicode text.  Scan for the first line starting
+with C<#!> and containing the word C<perl>, and start there instead.
+This is useful for running a program embedded in a larger message.
+(In this case you would indicate the end of the program using the C<=END>
+block, as defined in L<Synopsis 26|S26-documentation/"The =END block">.)
+Desugars to C<--PARSER --Perl6-extract-from-text --/PARSER>.

Reply via email to