From: Jarkko Hietaniemi <jhi@iki.fi>
Date: Mon, 14 Apr 2003 18:48:04 +0000 (+0000)
Subject: Bump up the version and admonish against aspiring (ab)use.
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=92a3e63c3aba23d356cf70f5886c704d07f8067d;p=p5sagit%2Fp5-mst-13.2.git

Bump up the version and admonish against aspiring (ab)use.

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

diff --git a/lib/PerlIO.pm b/lib/PerlIO.pm
index c3c5c97..ad99a30 100644
--- a/lib/PerlIO.pm
+++ b/lib/PerlIO.pm
@@ -1,6 +1,6 @@
 package PerlIO;
 
-our $VERSION = '1.01';
+our $VERSION = '1.02';
 
 # Map layer name to package that defines it
 our %alias;
@@ -241,6 +241,12 @@ returned, to get the output side use the optional C<output> argument:
 (Usually the layers are identical on either side of a filehandle but
 for example with sockets there may be differences.)
 
+There is no set_layers(), nor does get_layers() return a tied array
+mirroring the stack, or anything fancy like that.  This is not
+accidental or unintentional.  The PerlIO layer stack is a bit more
+complicated than just a stack (see for example the behaviour of C<:raw>).
+You are supposed to use open() and binmode() to manipulate the stack.
+
 B<Implementation details follow, please close your eyes.>
 
 The arguments to layers are by default returned in parenthesis after