Outline docs for PerlIO and PerlIO::Scalar

[perl5.git] / lib / PerlIO.pm

diff --git a/lib/PerlIO.pm b/lib/PerlIO.pm
index c5ce016..65b7ec3 100644 (file)
--- a/lib/PerlIO.pm
+++ b/lib/PerlIO.pm
@@ -24,3 +24,30 @@ sub import
 
 1;
 __END__
+
+=head1 NAME
+
+PerlIO - On demand loader for PerlIO::* name space
+
+=head1 SYNOPSIS
+
+  open($fh,">:foo",...)
+
+=head1 DESCRIPTION
+
+When an undefined layer 'foo' is encountered in an C<open> or C<binmode> layer
+specification then C code performs the equivalent of:
+
+  use PerlIO 'foo';
+
+The perl code in PerlIO.pm then attempts to locate a layer by doing
+
+  require PerlIO::foo;
+
+Otherwise the C<PerlIO> package is a place holder for additional PerLIO related
+functions.
+
+
+=cut
+
+