Doc patch about PerlIO::encoding:
authorTels <nospam-abuse@bloodgate.com>
Fri, 2 Mar 2007 11:31:39 +0000 (11:31 +0000)
committerRafael Garcia-Suarez <rgarciasuarez@gmail.com>
Tue, 6 Mar 2007 11:10:26 +0000 (11:10 +0000)
Subject: [PATCH] Re: 'Unknown PerlIO layer "encoding"...' message
Message-Id: <200703021131.41085@bloodgate.com>

p4raw-id: //depot/perl@30484

pod/perlfunc.pod

index 67e8c1e..3e2c57a 100644 (file)
@@ -542,7 +542,10 @@ functionality has moved from "discipline" to "layer".  All documentation
 of this version of Perl therefore refers to "layers" rather than to
 "disciplines".  Now back to the regularly scheduled documentation...>
 
-To mark FILEHANDLE as UTF-8, use C<:utf8>.
+To mark FILEHANDLE as UTF-8, use C<:utf8> or C<:encoding(utf8)>.
+C<:utf8> just marks the data as UTF-8 without further checking,
+while C<:encoding(utf8)> checks the data for actually being valid
+UTF-8. More details can be found in L<PerlIO::encoding>.
 
 In general, binmode() should be called after open() but before any I/O
 is done on the filehandle.  Calling binmode() will normally flush any