From 60cf4914ce8be9dda8380ff641184f6bb31a9e33 Mon Sep 17 00:00:00 2001 From: Brian Fraser Date: Wed, 27 Jun 2012 08:54:06 -0700 Subject: [PATCH] perlvar: #109408 --- pod/perlvar.pod | 76 ++++++++++++++++++++++++++++----------------------------- 1 file changed, 38 insertions(+), 38 deletions(-) diff --git a/pod/perlvar.pod b/pod/perlvar.pod index cfa82f9..da02cc6 100644 --- a/pod/perlvar.pod +++ b/pod/perlvar.pod @@ -24,7 +24,7 @@ C) is the scalar variable whose name is the single character control-C. This is better than typing a literal control-C into your program. -Since Perl 5.6, Perl variable names may be alphanumeric +Since Perl v5.6.0, Perl variable names may be alphanumeric strings that begin with control characters (or better yet, a caret). These variables must be written in the form C<${^Foo}>; the braces are not optional. C<${^Foo}> denotes the scalar variable whose @@ -145,7 +145,7 @@ test. Outside a C test, this will not happen. =back As C<$_> is a global variable, this may lead in some cases to unwanted -side-effects. As of perl 5.10, you can now use a lexical version of +side-effects. As of perl v5.10.0, you can now use a lexical version of C<$_> by declaring it in a file or in a block with C. Moreover, declaring C restores the global C<$_> in the current scope. @@ -250,7 +250,7 @@ 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 +On Linux as of perl v5.14.0 the legacy process name will be set with C, 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 @@ -549,7 +549,7 @@ lest you inadvertently call it. If your system has the C function then signal handlers are installed using it. This means you get reliable signal handling. -The default delivery policy of signals changed in Perl 5.8.0 from +The default delivery policy of signals changed in Perl v5.8.0 from immediate (also known as "unsafe") to deferred, also known as "safe signals". See L for more information. @@ -629,8 +629,8 @@ X<$^V> X<$PERL_VERSION> The revision, version, and subversion of the Perl interpreter, represented as a C object. -This variable first appeared in perl 5.6.0; earlier versions of perl -will see an undefined value. Before perl 5.10.0 C<$^V> was represented +This variable first appeared in perl v5.6.0; earlier versions of perl +will see an undefined value. Before perl v5.10.0 C<$^V> was represented as a v-string. C<$^V> can be used to determine whether the Perl interpreter executing @@ -648,7 +648,7 @@ for a convenient way to fail if the running Perl interpreter is too old. See also C<$]> for an older representation of the Perl version. -This variable was added in Perl 5.6. +This variable was added in Perl v5.6.0. Mnemonic: use ^V for Version Control. @@ -667,7 +667,7 @@ default. See the documentation for B<-f> in L for more information about site customization. -This variable was added in Perl 5.10. +This variable was added in Perl v5.10.0. =item $EXECUTABLE_NAME @@ -785,7 +785,7 @@ The C and C modules can help you find uses of these problematic match variables in your code. -Since Perl 5.10, you can use the C

match operator flag and the +Since Perl v5.10.0, you can use the C

match operator flag and the C<${^PREMATCH}>, C<${^MATCH}>, and C<${^POSTMATCH}> variables instead so you only suffer the performance penalties. @@ -814,7 +814,7 @@ BLOCK). The use of this variable anywhere in a program imposes a considerable performance penalty on all regular expression matches. To avoid this penalty, you can extract the same substring by using L. Starting -with Perl 5.10, you can use the C

match flag and the C<${^MATCH}> +with Perl v5.10.0, you can use the C

match flag and the C<${^MATCH}> variable to do the same thing for particular match operations. This variable is read-only and dynamically-scoped. @@ -829,7 +829,7 @@ 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. -This variable was added in Perl 5.10. +This variable was added in Perl v5.10.0. This variable is read-only and dynamically-scoped. @@ -845,7 +845,7 @@ enclosed by the current BLOCK. The use of this variable anywhere in a program imposes a considerable performance penalty on all regular expression matches. To avoid this penalty, you can extract the same substring by using L. Starting -with Perl 5.10, you can use the C

match flag and the +with Perl v5.10.0, you can use the C

match flag and the C<${^PREMATCH}> variable to do the same thing for particular match operations. @@ -861,7 +861,7 @@ 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. -This variable was added in Perl 5.10 +This variable was added in Perl v5.10.0 This variable is read-only and dynamically-scoped. @@ -881,7 +881,7 @@ enclosed by the current BLOCK). Example: The use of this variable anywhere in a program imposes a considerable performance penalty on all regular expression matches. To avoid this penalty, you can extract the same substring by -using L. Starting with Perl 5.10, you can use the C

match flag +using L. Starting with Perl v5.10.0, you can use the C

match flag and the C<${^POSTMATCH}> variable to do the same thing for particular match operations. @@ -897,7 +897,7 @@ 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. -This variable was added in Perl 5.10. +This variable was added in Perl v5.10.0. This variable is read-only and dynamically-scoped. @@ -934,7 +934,7 @@ recently matched. For example, to effectively capture text to a variable By setting and then using C<$var> in this way relieves you from having to worry about exactly which numbered set of parentheses they are. -This variable was added in Perl 5.8. +This variable was added in Perl v5.8.0. Mnemonic: the (possibly) Nested parenthesis that most recently closed. @@ -954,7 +954,7 @@ past where C<$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. -This variable was added in Perl 5.6. +This variable was added in Perl v5.6.0. =item %LAST_PAREN_MATCH @@ -981,7 +981,7 @@ iterative access to them via C may have unpredictable results. Likewise, if the last successful match changes, then the results may be surprising. -This variable was added in Perl 5.10. +This variable was added in Perl v5.10.0. This variable is read-only and dynamically-scoped. @@ -1027,7 +1027,7 @@ After a match against some variable C<$var>: =back -This variable was added in Perl 5.6. +This variable was added in Perl v5.6.0. =item %LAST_MATCH_START @@ -1075,7 +1075,7 @@ iterative access to them via C may have unpredictable results. Likewise, if the last successful match changes, then the results may be surprising. -This variable was added in Perl 5.10 +This variable was added in Perl v5.10.0. This variable is read-only and dynamically-scoped. @@ -1095,7 +1095,7 @@ X<${^RE_DEBUG_FLAGS}> The current value of the regex debugging flags. Set to 0 for no debug output even when the C module is loaded. See L for details. -This variable was added in Perl 5.10. +This variable was added in Perl v5.10.0. =item ${^RE_TRIE_MAXBUF} X<${^RE_TRIE_MAXBUF}> @@ -1109,7 +1109,7 @@ be as conservative of memory as possible but still occur, and set it to a negative value to prevent the optimisation and conserve the most memory. Under normal situations this variable should be of no interest to you. -This variable was added in Perl 5.10. +This variable was added in Perl v5.10.0. =back @@ -1566,7 +1566,7 @@ WSTOPSIG and WIFCONTINUED functions provided by the L module. Under VMS this reflects the actual VMS exit status; i.e. it is the same as C<$?> when the pragma C is in effect. -This variable was added in Perl 5.8.9. +This variable was added in Perl v5.10.0. =item $EXTENDED_OS_ERROR @@ -1637,7 +1637,7 @@ It has the same scoping as the C<$^H> and C<%^H> variables. The exact values are considered internal to the L pragma and may change between versions of Perl. -This variable was added in Perl 5.6. +This variable was added in Perl v5.6.0. =item $OS_ERROR @@ -1764,7 +1764,7 @@ when being compiled, such as for example to C at compile time rather than normal, deferred loading. Setting C<$^C = 1> is similar to calling C. -This variable was added in Perl 5.6. +This variable was added in Perl v5.6.0. =item $DEBUGGING @@ -1956,7 +1956,7 @@ A module should use only keys that begin with the module's name (the name of its main package) and a "/" character. For example, a module C should use keys such as C. -This variable was added in Perl 5.6. +This variable was added in Perl v5.6.0. =item ${^OPEN} X<${^OPEN}> @@ -1965,7 +1965,7 @@ An internal variable used by PerlIO. A string in two parts, separated by a C<\0> byte, the first part describes the input layers, the second part describes the output layers. -This variable was added in Perl 5.8.0. +This variable was added in Perl v5.8.0. =item $PERLDB @@ -2039,7 +2039,7 @@ B<-t> or B<-TU>). This variable is read-only. -This variable was added in Perl 5.8. +This variable was added in Perl v5.8.0. =item ${^UNICODE} X<${^UNICODE}> @@ -2050,7 +2050,7 @@ the possible values. This variable is set during Perl startup and is thereafter read-only. -This variable was added in Perl 5.8.2. +This variable was added in Perl v5.8.2. =item ${^UTF8CACHE} X<${^UTF8CACHE}> @@ -2059,7 +2059,7 @@ This variable controls the state of the internal UTF-8 offset caching code. 1 for on (the default), 0 for off, -1 to debug the caching code by checking all its results against linear scans, and panicking on any discrepancy. -This variable was added in Perl 5.8.9. +This variable was added in Perl v5.8.9. =item ${^UTF8LOCALE} X<${^UTF8LOCALE}> @@ -2069,7 +2069,7 @@ 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. -This variable was added in Perl 5.8.8. +This variable was added in Perl v5.8.8. =back @@ -2093,7 +2093,7 @@ See L for details about error messages. X<$#> X<$OFMT> C<$#> was a variable that could be used to format printed numbers. -After a deprecation cycle, its magic was removed in Perl 5.10 and +After a deprecation cycle, its magic was removed in Perl v5.10.0 and using it now triggers a warning: C<$# is no longer supported>. This is not the sigil you use in front of an array name to get the @@ -2102,19 +2102,19 @@ of an array in Perl. The two have nothing to do with each other. Deprecated in Perl 5. -Removed in Perl 5.10. +Removed in Perl v5.10.0. =item $* X<$*> C<$*> was a variable that you could use to enable multiline matching. -After a deprecation cycle, its magic was removed in Perl 5.10. +After a deprecation cycle, its magic was removed in Perl v5.10.0. Using it now triggers a warning: C<$* is no longer supported>. You should use the C and C regexp modifiers instead. Deprecated in Perl 5. -Removed in Perl 5.10. +Removed in Perl v5.10.0. =item $ARRAY_BASE @@ -2131,12 +2131,12 @@ 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. -Prior to Perl 5.10, assignment to C<$[> could be seen from outer lexical +Prior to Perl v5.10.0, assignment to C<$[> could be seen from outer lexical scopes in the same file, unlike other compile-time directives (such as L). Using local() on it would bind its value strictly to a lexical block. Now it is always lexically scoped. -As of Perl 5.16, it is implemented by the L module. See +As of Perl v5.16.0, it is implemented by the L module. See L for more details on its behaviour. Under C, or C, C<$[> no longer has any @@ -2145,7 +2145,7 @@ other value will produce an error. Mnemonic: [ begins subscripts. -Deprecated in Perl 5.12. +Deprecated in Perl v5.12.0. =item $OLD_PERL_VERSION -- 2.7.4