summaryrefslogtreecommitdiff
path: root/lib
diff options
context:
space:
mode:
authorJarkko Hietaniemi <jhi@iki.fi>2003-04-17 09:20:27 +0000
committerJarkko Hietaniemi <jhi@iki.fi>2003-04-17 09:20:27 +0000
commit164794897687cae4b298b3efb3ed2d20c601262b (patch)
tree685422b69eda8b2ba45b223cc2b0a35498c8494d /lib
parente6f587345b9c1d67a11dd2bb5a1df7a6bf9eec59 (diff)
downloadperl-164794897687cae4b298b3efb3ed2d20c601262b.tar.gz
Document that the open pragma does not affect
the three-headed hydra, ummm, open. p4raw-id: //depot/perl@19245
Diffstat (limited to 'lib')
-rw-r--r--lib/open.pm9
1 files changed, 6 insertions, 3 deletions
diff --git a/lib/open.pm b/lib/open.pm
index c2940931b7..39e194fd19 100644
--- a/lib/open.pm
+++ b/lib/open.pm
@@ -166,9 +166,12 @@ Perl is configured to use PerlIO as its IO system (which is now the
default).
The C<open> pragma serves as one of the interfaces to declare default
-"layers" (also known as "disciplines") for all I/O. Any open(),
-readpipe() (aka qx//) and similar operators found within the lexical
-scope of this pragma will use the declared defaults.
+"layers" (also known as "disciplines") for all I/O. Any two-argument
+open(), readpipe() (aka qx//) and similar operators found within the
+lexical scope of this pragma will use the declared defaults.
+Three-argument opens are not affected by this pragma since there you
+(can) explicitly specify the layers and are supposed to know what you
+are doing.
With the C<IN> subpragma you can declare the default layers
of input streams, and with the C<OUT> subpragma you can declare