Author: particle Date: 2009-02-05 02:56:04 +0100 (Thu, 05 Feb 2009) New Revision: 25198
Modified: docs/Perl6/Spec/S19-commandline.pod Log: [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 <jerry....@rakudoconsulting.com> 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 C<++CMD -V ++/CMD ++PARSER -V ++/PARSER ++DEBUGGER -V ++/DEBUGGER>. +=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>. + =back
