Outline docs for PerlIO and PerlIO::Scalar

p4raw-id: //depot/perlio@9395

diff --git a/ext/PerlIO/Scalar/Scalar.pm b/ext/PerlIO/Scalar/Scalar.pm
index e733a72..2879407 100644 (file)
--- a/ext/PerlIO/Scalar/Scalar.pm
+++ b/ext/PerlIO/Scalar/Scalar.pm
@@ -4,3 +4,23 @@ use XSLoader ();
 XSLoader::load 'PerlIO::Scalar';
 1;
 __END__
+
+=head1 NAME
+
+PerlIO::Scalar - support module for in-memory IO.
+
+=head1 SYNOPSIS
+
+   open($fh,"<...",\$scalar);
+
+=head1 DESCRIPTION
+
+C<PerlIO::Scalar> only exists to use XSLoader to load C code that provides
+support for treating a scalar as an "in memory" file.
+
+All normal file operations can be performed on the handle. The scalar is considered
+a stream of bytes. Currently fileno($fh) returns C<undef>.
+
+=cut
+
+

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
+
+