Integrate mainline.

[p5sagit/p5-mst-13.2.git] / pod / perlmodlib.pod

diff --git a/pod/perlmodlib.pod b/pod/perlmodlib.pod
index 1c58080..8f3eb61 100644 (file)
--- a/pod/perlmodlib.pod
+++ b/pod/perlmodlib.pod
@@ -98,10 +98,6 @@ Compute arithmetic in integer instead of double
 
 Request less of something from the compiler
 
-=item lib
-
-Manipulate @INC at compile time
-
 =item locale
 
 Use and avoid POSIX locales for built-in operations
@@ -118,6 +114,10 @@ Restrict unsafe operations when compiling
 
 Package for overloading perl operations
 
+=item perlio
+
+Configure C level IO
+
 =item re
 
 Alter regular expression behaviour
@@ -134,6 +134,10 @@ Restrict unsafe constructs
 
 Predeclare sub names
 
+=item unicode::distinct
+
+Strictly distinguish UTF8 data and non-UTF data.
+
 =item utf8
 
 Enable/disable UTF-8 in source code
@@ -146,6 +150,10 @@ Predeclare global variable names (obsolete)
 
 Control optional warnings
 
+=item warnings::register
+
+Warnings import function
+
 =back
 
 =head2 Standard Modules
@@ -196,6 +204,10 @@ Perl compiler's C backend
 
 Perl compiler's optimized C translation backend
 
+=item B::Concise
+
+Walk Perl syntax tree, printing concise info about ops
+
 =item B::Debug
 
 Walk Perl syntax tree, printing debug info about ops
@@ -220,6 +232,10 @@ Show lexical variables used in functions or files
 
 Helper module for CC backend
 
+=item B::Stash
+
+Show what stashes are loaded
+
 =item B::Terse
 
 Walk Perl syntax tree, printing terse info about ops
@@ -286,7 +302,7 @@ Warn of errors (from perspective of caller)
 
 =item Carp::Heavy
 
-Carp guts
+No user serviceable parts inside
 
 =item Class::Struct
 
@@ -316,6 +332,10 @@ Supply object methods for directory handles
 
 Provides screen dump of Perl data.
 
+=item Encode
+
+Character encodings
+
 =item English
 
 Use nice English (or awk) names for ugly punctuation variables
@@ -436,6 +456,10 @@ Create or remove directory trees
 
 Portably perform operations on file names
 
+=item File::Spec::Epoc
+
+Methods for Epoc file specs
+
 =item File::Spec::Functions
 
 Portably perform operations on file names
@@ -476,10 +500,18 @@ Keep more files open than the system permits
 
 Supply object methods for filehandles
 
+=item Filter::Simple
+
+Simplified source filtering
+
 =item FindBin
 
 Locate directory of original perl script
 
+=item GDBM_File
+
+Perl5 access to the gdbm library.
+
 =item Getopt::Long
 
 Extended processing of command line options
@@ -572,6 +604,10 @@ Module to convert pod files to HTML
 
 Objects representing POD input paragraphs, commands, etc.
 
+=item Pod::LaTeX
+
+Convert Pod data to formatted Latex
+
 =item Pod::Man
 
 Convert POD data to formatted *roff input
@@ -600,6 +636,10 @@ Convert POD data to formatted ASCII text
 
 Convert POD data to formatted color ASCII text
 
+=item Pod::Text::Overstrike
+
+Convert POD data to formatted overstrike text
+
 =item Pod::Text::Termcap
 
 Convert POD data to ASCII text with format escapes
@@ -636,6 +676,10 @@ Run shell commands transparently within perl
 
 Load the C socket.h defines and structure manipulators 
 
+=item Storable
+
+Persistency for perl data structures
+
 =item Symbol
 
 Manipulate Perl symbols and their names
@@ -736,7 +780,7 @@ By-name interface to Perl's built-in getpw*() functions
 
 To find out I<all> modules installed on your system, including
 those without documentation or outside the standard release,
-jus tdo this:
+just do this:
 
     % find `perl -e 'print "@INC"'` -name '*.pm' -print
 
@@ -1201,6 +1245,12 @@ If adding a new module to a set, follow the original author's
 standards for naming modules and the interface to methods in
 those modules.
 
+If developing modules for private internal or project specific use,
+that will never be released to the public, then you should ensure
+that their names will not clash with any future public module. You
+can do this either by using the reserved Local::* category or by
+using a category name that includes an underscore like Foo_Corp::*.
+
 To be portable each component of a module name should be limited to
 11 characters. If it might be used on MS-DOS then try to ensure each is
 unique in the first 8 characters. Nested modules make this easier.