docs patch: 'unicode_strings' doesn't change utf8ness
authorKarl Williamson <public@khwilliamson.com>
Wed, 6 Jun 2012 17:12:24 +0000 (11:12 -0600)
committerKarl Williamson <public@khwilliamson.com>
Thu, 7 Jun 2012 15:55:50 +0000 (09:55 -0600)
We had a field report of lack of clarity around this, so add some
text.

lib/feature.pm
pod/perlunicode.pod
regen/feature.pl

index 37e571f..cc89bde 100644 (file)
@@ -5,7 +5,7 @@
 
 package feature;
 
-our $VERSION = '1.28';
+our $VERSION = '1.29';
 
 our %feature = (
     fc              => 'feature_fc',
@@ -139,7 +139,8 @@ C<use feature 'unicode_strings'> tells the compiler to use Unicode semantics
 in all string operations executed within its scope (unless they are also
 within the scope of either C<use locale> or C<use bytes>).  The same applies
 to all regular expressions compiled within the scope, even if executed outside
-it.
+it.  It does not change the internal representation of strings, but only how
+they are interpreted.
 
 C<no feature 'unicode_strings'> tells the compiler to use the traditional
 Perl semantics wherein the native character set semantics is used unless it is
index 77daca3..e893571 100644 (file)
@@ -28,8 +28,10 @@ C<use feature 'unicode_strings'> is specified.  (This is automatically
 selected if you use C<use 5.012> or higher.)  Failure to do this can
 trigger unexpected surprises.  See L</The "Unicode Bug"> below.
 
-This pragma doesn't affect I/O, and there are still several places
-where Unicode isn't fully supported, such as in filenames.
+This pragma doesn't affect I/O.  Nor does it change the internal
+representation of strings, only their interpretation.  There are still
+several places where Unicode isn't fully supported, such as in
+filenames.
 
 =item Input and Output Layers
 
index 15315c7..1a85d0a 100755 (executable)
@@ -338,7 +338,7 @@ read_only_bottom_close_and_rename($h);
 __END__
 package feature;
 
-our $VERSION = '1.28';
+our $VERSION = '1.29';
 
 FEATURES
 
@@ -437,7 +437,8 @@ C<use feature 'unicode_strings'> tells the compiler to use Unicode semantics
 in all string operations executed within its scope (unless they are also
 within the scope of either C<use locale> or C<use bytes>).  The same applies
 to all regular expressions compiled within the scope, even if executed outside
-it.
+it.  It does not change the internal representation of strings, but only how
+they are interpreted.
 
 C<no feature 'unicode_strings'> tells the compiler to use the traditional
 Perl semantics wherein the native character set semantics is used unless it is