summaryrefslogtreecommitdiff
path: root/lib/PerlIO.pm
diff options
context:
space:
mode:
authorJarkko Hietaniemi <jhi@iki.fi>2003-04-14 18:48:04 +0000
committerJarkko Hietaniemi <jhi@iki.fi>2003-04-14 18:48:04 +0000
commit92a3e63c3aba23d356cf70f5886c704d07f8067d (patch)
tree6dca081eb7b744173add9af2b472b3d3877b235b /lib/PerlIO.pm
parent39f7a87036eb8d13c207511143dc7f2e620b3891 (diff)
downloadperl-92a3e63c3aba23d356cf70f5886c704d07f8067d.tar.gz
Bump up the version and admonish against aspiring (ab)use.
p4raw-id: //depot/perl@19204
Diffstat (limited to 'lib/PerlIO.pm')
-rw-r--r--lib/PerlIO.pm8
1 files changed, 7 insertions, 1 deletions
diff --git a/lib/PerlIO.pm b/lib/PerlIO.pm
index c3c5c97074..ad99a30886 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