perlvar: #109408
authorBrian Fraser <fraserbn@gmail.com>
Wed, 27 Jun 2012 15:54:06 +0000 (08:54 -0700)
committerFather Chrysostomos <sprout@cpan.org>
Wed, 27 Jun 2012 15:54:06 +0000 (08:54 -0700)
pod/perlvar.pod

index cfa82f9..da02cc6 100644 (file)
@@ -24,7 +24,7 @@ C<W>) is the scalar variable whose name is the single character
 control-C<W>.  This is better than typing a literal control-C<W>
 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<while> 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<my>.  Moreover,
 declaring C<our $_> 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<prctl(2)>, in addition to altering the POSIX name via C<argv[0]> 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<sigaction()> 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<perlipc> 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<version> 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<perlrun|perlrun/"Command Switches"> 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<Devel::NYTProf> and C<Devel::FindAmpersand>
 modules can help you find uses of these
 problematic match variables in your code.
 
-Since Perl 5.10, you can use the C</p> match operator flag and the
+Since Perl v5.10.0, you can use the C</p> 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</p> match flag and the C<${^MATCH}>
+with Perl v5.10.0, you can use the C</p> 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</p> 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</p> match flag and the
+with Perl v5.10.0, you can use the C</p> 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</p> 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</p> match flag
+using L</@->.  Starting with Perl v5.10.0, you can use the C</p> 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</p> 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<each> 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<each> 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<re 'debug'> module is loaded.  See L<re> 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<POSIX> module.
 Under VMS this reflects the actual VMS exit status; i.e. it is the
 same as C<$?> when the pragma C<use vmsish 'status'> 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<warnings> 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<AUTOLOAD> at compile
 time rather than normal, deferred loading.  Setting
 C<$^C = 1> is similar to calling C<B::minus_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<Foo::Bar> should use keys such as C<Foo::Bar/baz>.
 
-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<perlrun> 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<perldiag> 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</s> and C</m> 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<strict>).  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<arybase> module.  See
+As of Perl v5.16.0, it is implemented by the L<arybase> module.  See
 L<arybase> for more details on its behaviour.
 
 Under C<use v5.16>, or C<no feature "array_base">, 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