From: Jarkko Hietaniemi <jhi@iki.fi>
Date: Sat, 7 Apr 2001 17:46:33 +0000 (+0000)
Subject: Add PerlIO and Encode information to perl571delta, fron NI-S.
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=65db47215523af11c8787049ce2d448171db15a0;p=p5sagit%2Fp5-mst-13.2.git

Add PerlIO and Encode information to perl571delta, fron NI-S.

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

diff --git a/pod/perl571delta.pod b/pod/perl571delta.pod
index ae5dd7f..d58384a 100644
--- a/pod/perl571delta.pod
+++ b/pod/perl571delta.pod
@@ -29,9 +29,64 @@ More details are in L<perldelta/Performance Enhancements>.
 
 =item *
 
+Anonymous temporary files are available without need to
+'use FileHandle' or other module via
+
+   open($fh,"+>", undef) || ...
+
+=item *
+
+IO is now by default done via PerlIO rather than system's "stdio".
+PerlIO allows "layers" to be "pushed" onto a file handle to alter the
+handle's behaviour.  Layers can be specified at open time via 3-arg
+form of open:
+
+   open($fh,'>:crlf :utf8', $path) || ...
+
+or on already opened handles via extended C<binmode>:
+
+   binmode($fh,':encoding(iso-8859-7)');
+
+The built-in layers are: unix (low level read/write), stdio (as in
+previous Perls), perlio (re-implementation of stdio buffering in a
+portable manner), crlf (does CRLF <=> "\n" translation as on Win32,
+but available on any platform).  A mmap layer may be available if
+platform supports it (mostly UNIXes).
+
+Layers to be applied by default may be specified via the 'open' pragma.
+
+=item *
+
+File handles can be marked as accepting Perl's internal encoding of Unicode
+(UTF-8 or UTF-EBCDIC depending on platfrom) by a pseudo layer ":utf8" :
+
+   open($fh,">:utf8","Uni.txt");
+
+=item *
+
+File handles can translate character encodings from/to Perl's internal
+Unicode form on read/write via the ":encoding()" layer.
+
+=item *
+
+File handles can be opened to "in memory" files held in Perl scalars via:
+
+   open($fh,'>', \$variable) || ...
+
+=item *
+
 Formats now support zero-padded decimal fields.
 
 =item *
+
+The list form of C<open> is now implemented for pipes (at least on UNIX):
+
+   open($fh,"-|", 'cat', '/etc/motd')
+
+creates a pipe, and runs the equivalent of exec('cat', '/etc/motd') in
+the child process.
+
+=item *
  
 The printf and sprintf now support parameter reordering using the
 C<%\d+\$> and C<*\d+\$> syntaxes.
@@ -78,6 +133,63 @@ the string, it is no longer considered to be utf8-encoded.
 
 =back
 
+=head1 Core Enhancements
+
+=head2 New Modules
+
+=over 4
+
+=item *
+
+Encode provides a mechanism to translate between different character
+encodings.  Support for Unicode, ISO-8859-*, ASCII, CP*, KOI8-R, and
+three variants of EBCDIC are compiled in to the module.  Several other
+encodings (like Japanese, Chinese, and MacIntosh encodings) are
+included and will be loaded at runtime.
+
+=item *
+
+Any encoding supported by Encode module is also available to the
+":encoding()" layer if PerlIO is used.
+
+=item *
+
+PerlIO::Scalar provides the IO to "in memory" perl scalars discussed
+above.  It also serves as an example of a loadable layer.
+
+=item *
+
+PerlIO::Via acts as a PerlIO layer and wraps PerlIO layer
+functionality provided by a class (typically implemented in
+perl code).
+
+=item *
+
+MIME::QuotedPrint has been enhanced to provide the basic methods
+necessary to use it with PerlIO::Via as in :
+
+ use MIME::QuotedPrint;
+ open($fh,">Via(MIME::QuotedPrint)",$path)
+
+=back
+
+=head2 Updated And Improved Modules and Pragmata
+
+=over 4
+
+=item *
+
+The C<open> pragma allows layers other than ":raw" and ":crlf" when
+using PerlIO.
+
+=item *
+
+The utf8:: name space (as in the pragma) provides various
+Perl-callable functions to provide low level access to Perl's
+internal Unicode representation.
+
+=back
+
 =head1 Known Problems
 
 =head2 sprintf tests 129 and 130