diff options
| author | Jarkko Hietaniemi <jhi@iki.fi> | 2002-05-19 03:05:41 +0000 |
|---|---|---|
| committer | Jarkko Hietaniemi <jhi@iki.fi> | 2002-05-19 03:05:41 +0000 |
| commit | b5d8778e12b33cd239660fb278832ca8eca3ed7b (patch) | |
| tree | 195222f32685328000664da3f417fd7a4f089ae4 | |
| parent | dca31ef4955f66a1fcca0ce503929b683e309b41 (diff) | |
| download | perl-b5d8778e12b33cd239660fb278832ca8eca3ed7b.tar.gz | |
Document once more the difference between :utf8
and :encoding(...).
p4raw-id: //depot/perl@16692
| -rw-r--r-- | lib/open.pm | 7 | ||||
| -rw-r--r-- | pod/perluniintro.pod | 5 |
2 files changed, 12 insertions, 0 deletions
diff --git a/lib/open.pm b/lib/open.pm index a5c337ad81..aab99fb713 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 6e39125604..68fb0fa87a 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. |