NetWare changeover from Watcom to Codewarrior, from C Aditya.

[p5sagit/p5-mst-13.2.git] / lib / PerlIO.pm

diff --git a/lib/PerlIO.pm b/lib/PerlIO.pm
index d52d58b..6bef21f 100644 (file)
--- a/lib/PerlIO.pm
+++ b/lib/PerlIO.pm
@@ -1,7 +1,9 @@
 package PerlIO;
 
+our $VERSION = '1.01';
+
 # Map layer name to package that defines it
-my %alias = (encoding => 'Encode');
+our %alias;
 
 sub import
 {
@@ -96,6 +98,14 @@ and then read it back in.
        $in = <F>;
        close(F);
 
+=item bytes
+
+This is the inverse of C<:utf8> layer. It turns off the flag
+on the layer below so that data read from it is considered to
+be "octets" i.e. characters in range 0..255 only. Likewise
+on output perl will warn if a "wide" character is written
+to a such a stream.
+
 =item raw
 
 A pseudo-layer which performs two functions (which is messy, but
@@ -103,7 +113,7 @@ necessary to maintain compatibility with non-PerlIO builds of Perl
 and their way things have been documented elsewhere).
 
 Firstly it forces the file handle to be considered binary at that
-point in the layer stack,
+point in the layer stack, i.e. it turns off any CRLF translation.
 
 Secondly in prevents the IO system seaching back before it in the
 layer specification.  Thus:
@@ -112,7 +122,8 @@ layer specification.  Thus:
 
 Forces the use of C<perlio> layer even if the platform default, or
 C<use open> default is something else (such as ":encoding(iso-8859-7)")
-which would interfere with binary nature of the stream.
+(the C<:encoding> requires C<use Encode>) which would interfere with
+binary nature of the stream.
 
 =back