From 8f9560913216a49da8aab6644875567d25b2914b Mon Sep 17 00:00:00 2001
From: Nick Ing-Simmons <nik@tiuk.ti.com>
Date: Tue, 27 Mar 2001 21:18:58 +0000
Subject: Outline docs for PerlIO and PerlIO::Scalar

p4raw-id: //depot/perlio@9395
---
 lib/PerlIO.pm | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

(limited to 'lib/PerlIO.pm')

diff --git a/lib/PerlIO.pm b/lib/PerlIO.pm
index c5ce016db4..65b7ec3530 100644
--- 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
+
+
-- 
cgit v1.2.1