From: Jarkko Hietaniemi <jhi@iki.fi>
Date: Tue, 5 Aug 2003 14:03:43 +0000 (+0000)
Subject: A suggested perlio doc addition from Stas.
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=2535a4f71a2208467dfdb5b9b31ccb3976f18b7d;p=p5sagit%2Fp5-mst-13.2.git

A suggested perlio doc addition from Stas.

p4raw-id: //depot/perl@20499
---

diff --git a/pod/perliol.pod b/pod/perliol.pod
index f8eb01e..9abc72e 100644
--- a/pod/perliol.pod
+++ b/pod/perliol.pod
@@ -684,6 +684,23 @@ The application (or layer above) must ensure they are consistent.
 
 =head2 Implementing PerlIO Layers
 
+If you find the implementation document unclear or not sufficient,
+look at the existing perlio layer implementations, which include:
+
+=over
+
+=item * C implementations
+
+PerlIO::encoding, PerlIO::scalar, PerlIO::via in the Perl core.
+
+PerlIO::gzip and APR::PerlIO (mod_perl 2.0) on CPAN.
+
+=item * Perl implementations
+
+PerlIO::via::QuotedPrint in the Perl core and PerlIO::via::* on CPAN.
+
+=back
+
 If you are creating a PerlIO layer, you may want to be lazy, in other
 words, implement only the methods that interest you.  The other methods
 you can either replace with the "blank" methods