summaryrefslogtreecommitdiff
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
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.
-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