This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
English.pm: Update -no_match_vars docs
[perl5.git] / lib / English.pm
index 1f1e85d..6a57ffb 100644 (file)
@@ -11,8 +11,9 @@ English - use nice English (or awk) names for ugly punctuation variables
 
 =head1 SYNOPSIS
 
 
 =head1 SYNOPSIS
 
-    use English qw( -no_match_vars ) ;  # Avoids regex performance penalty
     use English;
     use English;
+    use English qw( -no_match_vars ) ;  # Avoids regex performance penalty
+                                        # in perl 5.16 and earlier
     ...
     if ($ERRNO =~ /denied/) { ... }
 
     ...
     if ($ERRNO =~ /denied/) { ... }
 
@@ -32,6 +33,10 @@ See L<perlvar> for a complete list of these.
 
 =head1 PERFORMANCE
 
 
 =head1 PERFORMANCE
 
+NOTE: This was fixed in perl 5.18.  Mentioning these three variables no
+longer makes a speed difference.  This section still applies if your code
+is to run on perl 5.16 or earlier.
+
 This module can provoke sizeable inefficiencies for regular expressions,
 due to unfortunate implementation details.  If performance matters in
 your application and you don't need $PREMATCH, $MATCH, or $POSTMATCH,
 This module can provoke sizeable inefficiencies for regular expressions,
 due to unfortunate implementation details.  If performance matters in
 your application and you don't need $PREMATCH, $MATCH, or $POSTMATCH,