perldiag: Correct misstatement
authorKarl Williamson <public@khwilliamson.com>
Wed, 9 Apr 2014 01:20:52 +0000 (19:20 -0600)
committerKarl Williamson <public@khwilliamson.com>
Wed, 9 Apr 2014 01:25:45 +0000 (19:25 -0600)
It's not non-alphabetic characters that are discouraged; its the
characters X where \cX doesn't map to a control that are discouraged

pod/perldiag.pod

index fe16386..1296490 100644 (file)
@@ -1313,7 +1313,9 @@ instances in Perl v5.22.  In
 the cases where it isn't fatal, the character this evaluates to is
 derived by exclusive or'ing the code point of this character with 0x40.
 
-Note that non-alphabetic ASCII characters are discouraged here as well.
+Note that ASCII characters that don't map to control characters are
+discouraged here as well, and will generate the warning (when enabled)
+L</""\c%c" is more clearly written simply as "%s"">.
 
 =item Character in 'C' format wrapped in pack
 
@@ -1439,7 +1441,7 @@ but not higher.  Code points above 0xFFFF_FFFF require larger than a
 =item %s: Command not found
 
 (A) You've accidentally run your script through B<csh> or another shell
-instead of Perl.  Check the #! line, or manually feed your script
+shell instead of Perl.  Check the #! line, or manually feed your script
 into Perl yourself.  The #! line at the top of your file could look like
 
   #!/usr/bin/perl -w
@@ -1478,7 +1480,7 @@ L<charnames/CUSTOM TRANSLATORS>) returned an undefined value.
 
 (F) The parser found inconsistencies while attempting to define an
 overloaded constant.  Perhaps you forgot to load the corresponding
-L<overload> pragma?
+L<overload> pragma?.
 
 =item Constant is not %s reference
 
@@ -6464,7 +6466,7 @@ You need to add either braces or blanks to disambiguate.
 
 (D deprecated) You tried to use a hash as a reference, as in
 C<< %foo->{"bar"} >> or C<< %$ref->{"hello"} >>.  Versions of perl <= 5.6.1
-used to allow this syntax, but shouldn't have.  It is now
+used to allow this syntax, but shouldn't have.   It is now
 deprecated, and will be removed in a future version.
 
 =item Using an array as a reference is deprecated