This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perlvar: discourage $OLD_PERL_VERSION
authorAristotle Pagaltzis <pagaltzis@gmx.de>
Mon, 27 Jul 2015 12:24:21 +0000 (14:24 +0200)
committerAristotle Pagaltzis <pagaltzis@gmx.de>
Mon, 27 Jul 2015 12:24:21 +0000 (14:24 +0200)
pod/perlvar.pod

index f825754..342a596 100644 (file)
@@ -464,9 +464,12 @@ version objects) and numeric comparisons can occasionally fail; it's good
 for string literal version checks and bad for comparing to a variable
 that hasn't been sanity-checked.
 
-Mnemonic: Is this version of perl in the right bracket?
+The C<$OLD_PERL_VERSION> form was added in Perl v5.20.0 for historical
+reasons but its use is discouraged. (If your reason to use C<$]> is to
+run code on old perls then referring to it as C<$OLD_PERL_VERSION> would
+be self-defeating.)
 
-The C<$OLD_PERL_VERSION> form was added in Perl v5.20.0.
+Mnemonic: Is this version of perl in the right bracket?
 
 =item $SYSTEM_FD_MAX