From: Jarkko Hietaniemi <jhi@iki.fi>
Date: Sun, 19 May 2002 03:05:41 +0000 (+0000)
Subject: Document once more the difference between :utf8
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=b5d8778e12b33cd239660fb278832ca8eca3ed7b;p=p5sagit%2Fp5-mst-13.2.git

Document once more the difference between :utf8
and :encoding(...).

p4raw-id: //depot/perl@16692
---

diff --git a/lib/open.pm b/lib/open.pm
index a5c337a..aab99fb 100644
--- a/lib/open.pm
+++ b/lib/open.pm
@@ -208,6 +208,13 @@ and these
     use open ':encoding(iso-8859-7)';
     use open IO => ':encoding(iso-8859-7)';
 
+The matching of encoding names is loose: case does not matter, and
+many encodings have several aliases.  See L<Encode::Supported> for
+details and the list of supported locales.
+
+Note that C<:utf8> discipline must always be specified exactly like
+that, it is not subject to the loose matching of encoding names.
+
 When open() is given an explicit list of layers they are appended to
 the list declared using this pragma.
 
diff --git a/pod/perluniintro.pod b/pod/perluniintro.pod
index 6e39125..68fb0fa 100644
--- a/pod/perluniintro.pod
+++ b/pod/perluniintro.pod
@@ -316,6 +316,11 @@ and on already open streams use C<binmode()>:
     binmode(STDOUT, ":encoding(UTF-8)");
     binmode(STDOUT, ":encoding(shift_jis)");
 
+The matching of encoding names is loose: case does not matter, and
+many encodings have several aliases.  Note that C<:utf8> discipline
+must always be specified exactly like that, it is not subject to the
+loose matching of encoding names.
+
 See L<PerlIO> for the C<:utf8> layer;
 L<PerlIO::encoding> and L<Encode::PerlIO> for the C<:encoding()> layer;
 L<Encode::Supported> for many encodings supported by the C<Encode> module.