Add perlnetware to docs; regen toc; supply skeleton

docs for some Memoize submodules.

p4raw-id: //depot/perl@10647

6 files changed, 71 insertions, 13 deletions

diff --git a/lib/Memoize/AnyDBM_File.pm b/lib/Memoize/AnyDBM_File.pm
index eb2e659c0d..d634f40dca 100644
--- a/lib/Memoize/AnyDBM_File.pm
+++ b/lib/Memoize/AnyDBM_File.pm
@@ -1,5 +1,15 @@
 package Memoize::AnyDBM_File;
 
+=head1 NAME
+
+Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for Storable use
+
+=head1 DESCRIPTION
+
+See L<Memoize>.
+
+=cut
+
 use vars qw(@ISA);
 @ISA = qw(DB_File GDBM_File Memoize::NDBM_File Memoize::SDBM_File ODBM_File) unless @ISA;
 
diff --git a/lib/Memoize/ExpireFile.pm b/lib/Memoize/ExpireFile.pm
index 958b807cfa..22e4d67b99 100644
--- a/lib/Memoize/ExpireFile.pm
+++ b/lib/Memoize/ExpireFile.pm
@@ -1,5 +1,15 @@
-
 package Memoize::ExpireFile;
+
+=head1 NAME
+
+Memoize::ExpireFile - test for Memoize expiration semantics
+
+=head1 DESCRIPTION
+
+See L<Memoize::Expire>.
+
+=cut
+
 use Carp;
 
 sub TIEHASH {
diff --git a/lib/Memoize/ExpireTest.pm b/lib/Memoize/ExpireTest.pm
index 1c889ed934..41a3ad9a40 100644
--- a/lib/Memoize/ExpireTest.pm
+++ b/lib/Memoize/ExpireTest.pm
@@ -1,16 +1,22 @@
+package Memoize::ExpireTest;
 
-# This is just for testing expiration semantics.
-# It's not actually a very good example of how to write
-# an expiration module.  
-#
-# If you are looking for an example, I recommend that you look at the
-# simple example in the Memoize::Expire documentation, or at the
-# code for Memoize::Expire itself.
-#
-# If you have questions, I will be happy to answer them if you
-# send them to mjd-perl/memoize+@plover.com.
+=head1 NAME
 
-package Memoize::ExpireTest;
+Memoize::ExpireTest - test for Memoize expiration semantics
+
+=head1 DESCRIPTION
+
+This is just for testing expiration semantics.  It's not actually a
+very good example of how to write an expiration module.
+
+If you are looking for an example, I recommend that you look at the
+simple example in the Memoize::Expire documentation, or at the code
+for Memoize::Expire itself.
+
+If you have questions, I will be happy to answer them if you send them
+to mjd-perl/memoize+@plover.com.
+
+=cut
 
 my %cache;
 
diff --git a/lib/Memoize/NDBM_File.pm b/lib/Memoize/NDBM_File.pm
index ee58cc4d7c..6c36d88ea3 100644
--- a/lib/Memoize/NDBM_File.pm
+++ b/lib/Memoize/NDBM_File.pm
@@ -1,4 +1,15 @@
 package Memoize::NDBM_File;
+
+=head1 NAME
+
+Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for Storable use
+
+=head1 DESCRIPTION
+
+See L<Memoize>.
+
+=cut
+
 use NDBM_File;
 @ISA = qw(NDBM_File);
 
diff --git a/lib/Memoize/SDBM_File.pm b/lib/Memoize/SDBM_File.pm
index 46e550f9a2..d11f69add2 100644
--- a/lib/Memoize/SDBM_File.pm
+++ b/lib/Memoize/SDBM_File.pm
@@ -1,4 +1,15 @@
 package Memoize::SDBM_File;
+
+=head1 NAME
+
+Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for Storable use
+
+=head1 DESCRIPTION
+
+See L<Memoize>.
+
+=cut
+
 use SDBM_File;
 @ISA = qw(SDBM_File);
 
diff --git a/lib/Memoize/Storable.pm b/lib/Memoize/Storable.pm
index ff712aecc4..71e9433256 100644
--- a/lib/Memoize/Storable.pm
+++ b/lib/Memoize/Storable.pm
@@ -1,5 +1,15 @@
-
 package Memoize::Storable;
+
+=head1 NAME
+
+Memoize::Storable - store Memoized data in Storable database
+
+=head1 DESCRIPTION
+
+See L<Memoize>.
+
+=cut
+
 use Storable ();
 $Verbose = 0;