summaryrefslogtreecommitdiff
path: root/lib/PerlIO.pm
diff options
context:
space:
mode:
authorKarl Williamson <public@khwilliamson.com>2014-04-02 20:45:03 -0600
committerKarl Williamson <public@khwilliamson.com>2014-04-13 14:32:00 -0600
commit78269f095bc831a3ca7c226f93a5bba93565dfad (patch)
treeda0125572103c7152d91b9bdfd14aa9e21b6052e /lib/PerlIO.pm
parent41cd218c697e124b75c2964b6eb074160433569a (diff)
downloadperl-78269f095bc831a3ca7c226f93a5bba93565dfad.tar.gz
PerlIO.pm: Make pod :utf8 caution more prominent
The :utf8 layer continues to have security issues. This moves the warning about that to earlier where it's more likely to be seen, and makes it stand out more.
Diffstat (limited to 'lib/PerlIO.pm')
-rw-r--r--lib/PerlIO.pm8
1 files changed, 4 insertions, 4 deletions
diff --git a/lib/PerlIO.pm b/lib/PerlIO.pm
index 0a68f3a7bb..2e27f98bba 100644
--- a/lib/PerlIO.pm
+++ b/lib/PerlIO.pm
@@ -1,6 +1,6 @@
package PerlIO;
-our $VERSION = '1.08';
+our $VERSION = '1.09';
# Map layer name to package that defines it
our %alias;
@@ -103,6 +103,9 @@ represent to be read from or written to the stream. The UTF-X encoding
is chosen to render simple text parts (i.e. non-accented letters,
digits and common punctuation) human readable in the encoded file.
+(B<CAUTION>: This layer does not validate byte sequences. For reading input,
+you should instead use C<:encoding(utf8)> instead of bare C<:utf8>.)
+
Here is how to write your native data out using UTF-8 (or UTF-EBCDIC)
and then read it back in.
@@ -114,9 +117,6 @@ and then read it back in.
$in = <F>;
close(F);
-Note that this layer does not validate byte sequences. For reading
-input, using C<:encoding(utf8)> instead of bare C<:utf8> is strongly
-recommended.
=item :bytes