X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlvar.pod;h=ed9061011ac8b82582abf69848b754dff30493ef;hb=000c65fce914409ad42f49763dbced48187b5baf;hp=68573e3d498177d17ea7c4236bf8c77253704f81;hpb=4c85b59c156c7ad7ba08eb430618e674134ced22;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perlvar.pod b/pod/perlvar.pod index 68573e3..ed90610 100644 --- a/pod/perlvar.pod +++ b/pod/perlvar.pod @@ -214,11 +214,11 @@ able to use them in the sort() comparison block or function. =over 8 -=item $> +=item $> ($1, $2, ...) X<$1> X<$2> X<$3> Contains the subpattern from the corresponding set of capturing -parentheses from the last pattern match, not counting patterns +parentheses from the last successful pattern match, not counting patterns matched in nested blocks that have been exited already. (Mnemonic: like \digits.) These variables are all read-only and dynamically scoped to the current BLOCK. @@ -241,7 +241,7 @@ See L for a replacement. =item ${^MATCH} X<${^MATCH}> -This is similar to C<$&> (C<$POSTMATCH>) except that it does not incur the +This is similar to C<$&> (C<$MATCH>) except that it does not incur the performance penalty associated with that variable, and is only guaranteed to return a defined value when the pattern was compiled or executed with the C

modifier. @@ -349,6 +349,8 @@ past where $2 ends, and so on. You can use C<$#+> to determine how many subgroups were in the last successful match. See the examples given for the C<@-> variable. +=item %LAST_PAREN_MATCH + =item %+ X<%+> @@ -1021,6 +1023,16 @@ to ps(1) (assuming the operating system plays along). Note that the view of C<$0> the other threads have will not change since they have their own copies of it. +If the program has been given to perl via the switches C<-e> or C<-E>, +C<$0> will contain the string C<"-e">. + +On Linux as of perl 5.14 the legacy process name will be set with +L, in addition to altering the POSIX name via C as +perl has done since version 4.000. Now system utilities that read the +legacy process name such as ps, top and killall will recognize the +name you set when assigning to C<$0>. The string you supply will be +cut off at 16 bytes, this is a limitation imposed by Linux. + =item $[ X<$[> @@ -1032,8 +1044,8 @@ subscripting and when evaluating the index() and substr() functions. As of release 5 of Perl, assignment to C<$[> is treated as a compiler directive, and cannot influence the behavior of any other file. -(That's why you can only assign compile-time constants to it.) -Its use is highly discouraged. +(That's why you can only assign compile-time constants to it.) Its +use is deprecated, and by default will trigger a warning. Note that, unlike other compile-time directives (such as L), assignment to C<$[> can be seen from outer lexical scopes in the same file. @@ -1316,7 +1328,7 @@ all its results against linear scans, and panicking on any discrepancy. =item ${^UTF8LOCALE} -This variable indicates whether an UTF-8 locale was detected by perl at +This variable indicates whether a UTF-8 locale was detected by perl at startup. This information is used by perl when it's in adjust-utf8ness-to-locale mode (as when run with the C<-CL> command-line switch); see L for more info on this. @@ -1363,6 +1375,7 @@ The current set of warning checks enabled by the C pragma. See the documentation of C for more details. =item ${^WIN32_SLOPPY_STAT} +X X If this variable is set to a true value, then stat() on Windows will not try to open the file. This means that the link count cannot be @@ -1372,7 +1385,8 @@ is considerably faster, especially for files on network drives. This variable could be set in the F file to configure the local Perl installation to use "sloppy" stat() by -default. See L for more information about site +default. See the documentation for B<-f> in +L for more information about site customization. =item $EXECUTABLE_NAME