add perlmodinstall, regen perltoc
Gurusamy Sarathy [Wed, 22 Jul 1998 17:58:42 +0000 (17:58 +0000)]
p4raw-id: //depot/perl@1642

MANIFEST
pod/Makefile
pod/buildtoc
pod/perl.pod
pod/perlmodinstall.pod [new file with mode: 0644]
pod/perltoc.pod
win32/pod.mak

index a4629ce..056e369 100644 (file)
--- a/MANIFEST
+++ b/MANIFEST
@@ -718,6 +718,7 @@ pod/perlipc.pod             IPC info
 pod/perllocale.pod     Locale support info
 pod/perllol.pod                How to use lists of lists
 pod/perlmod.pod                Module mechanism info
+pod/perlmodinstall.pod Installing CPAN Modules
 pod/perlmodlib.pod     Module policy info
 pod/perlobj.pod                Object info
 pod/perlop.pod         Operator info
index 785f977..9187c84 100644 (file)
@@ -26,6 +26,7 @@ POD = \
        perlsub.pod     \
        perlmod.pod     \
        perlmodlib.pod  \
+       perlmodinstall.pod      \
        perlform.pod    \
        perllocale.pod  \
        perlref.pod     \
@@ -40,6 +41,7 @@ POD = \
        perldiag.pod    \
        perlsec.pod     \
        perltrap.pod    \
+       perlport.pod    \
        perlstyle.pod   \
        perlpod.pod     \
        perlbook.pod    \
@@ -74,6 +76,7 @@ MAN = \
        perlsub.man     \
        perlmod.man     \
        perlmodlib.man  \
+       perlmodinstall.man      \
        perlform.man    \
        perllocale.man  \
        perlref.man     \
@@ -88,6 +91,7 @@ MAN = \
        perldiag.man    \
        perlsec.man     \
        perltrap.man    \
+       perlport.man    \
        perlstyle.man   \
        perlpod.man     \
        perlbook.man    \
@@ -122,6 +126,7 @@ HTML = \
        perlsub.html    \
        perlmod.html    \
        perlmodlib.html \
+       perlmodinstall.html     \
        perlform.html   \
        perllocale.html \
        perlref.html    \
@@ -136,6 +141,7 @@ HTML = \
        perldiag.html   \
        perlsec.html    \
        perltrap.html   \
+       perlport.html   \
        perlstyle.html  \
        perlpod.html    \
        perlbook.html   \
@@ -170,6 +176,7 @@ TEX = \
        perlsub.tex     \
        perlmod.tex     \
        perlmodlib.tex  \
+       perlmodinstall.tex      \
        perlform.tex    \
        perllocale.tex  \
        perlref.tex     \
@@ -184,6 +191,7 @@ TEX = \
        perldiag.tex    \
        perlsec.tex     \
        perltrap.tex    \
+       perlport.tex    \
        perlstyle.tex   \
        perlpod.tex     \
        perlbook.tex    \
index bd880c3..80ca2ec 100644 (file)
@@ -8,9 +8,9 @@ sub output ($);
           perl perlfaq perlfaq1 perlfaq2 perlfaq3 perlfaq4 perlfaq5
           perlfaq6 perlfaq7 perlfaq8 perlfaq9 perldelta perldata
           perlsyn perlop perlre perlrun perlfunc perlvar perlsub
-          perlmod perlmodlib perlform perllocale perlref perldsc
+          perlmod perlmodlib perlmodinstall perlform perllocale perlref perldsc
           perllol perltoot perlobj perltie perlbot perlipc perldebug
-          perldiag perlsec perltrap perlstyle perlpod perlbook
+          perldiag perlsec perltrap perlport perlstyle perlpod perlbook
           perlembed perlapio perlxs perlxstut perlguts perlcall
           perlhist
          );
index 1924d46..0b9e9fa 100644 (file)
@@ -18,51 +18,52 @@ B<perl>     S<[ B<-sTuU> ]>
 For ease of access, the Perl manual has been split up into a number
 of sections:
 
-    perl       Perl overview (this section)
-    perldelta  Perl changes since previous version
-    perlfaq    Perl frequently asked questions
-    perltoc    Perl documentation table of contents
-
-    perldata   Perl data structures
-    perlsyn    Perl syntax
-    perlop     Perl operators and precedence
-    perlre     Perl regular expressions
-    perlrun    Perl execution and options
-    perlfunc   Perl builtin functions
-    perlvar    Perl predefined variables
-    perlsub    Perl subroutines
-    perlmod    Perl modules: how they work
-    perlmodlib Perl modules: how to write and use
-    perlform   Perl formats
-    perllocale Perl locale support
-
-    perlref    Perl references
-    perldsc    Perl data structures intro
-    perllol    Perl data structures: lists of lists
-    perltoot   Perl OO tutorial
-    perlobj    Perl objects
-    perltie    Perl objects hidden behind simple variables
-    perlbot    Perl OO tricks and examples
-    perlipc    Perl interprocess communication
-
-    perldebug  Perl debugging
-    perldiag   Perl diagnostic messages
-    perlsec    Perl security
-    perltrap   Perl traps for the unwary
-    perlport   Perl portability guide
-    perlstyle  Perl style guide
-
-    perlpod    Perl plain old documentation
-    perlbook   Perl book information
-
-    perlembed  Perl ways to embed perl in your C or C++ application
-    perlapio   Perl internal IO abstraction interface
-    perlxs     Perl XS application programming interface
-    perlxstut  Perl XS tutorial
-    perlguts   Perl internal functions for those doing extensions
-    perlcall   Perl calling conventions from C
-
-    perlhist   Perl history records
+    perl               Perl overview (this section)
+    perldelta          Perl changes since previous version
+    perlfaq            Perl frequently asked questions
+    perltoc            Perl documentation table of contents
+
+    perldata           Perl data structures
+    perlsyn            Perl syntax
+    perlop             Perl operators and precedence
+    perlre             Perl regular expressions
+    perlrun            Perl execution and options
+    perlfunc           Perl builtin functions
+    perlvar            Perl predefined variables
+    perlsub            Perl subroutines
+    perlmod            Perl modules: how they work
+    perlmodlib         Perl modules: how to write and use
+    perlmodinstall     Perl modules: how to install from CPAN
+    perlform           Perl formats
+    perllocale         Perl locale support
+
+    perlref            Perl references
+    perldsc            Perl data structures intro
+    perllol            Perl data structures: lists of lists
+    perltoot           Perl OO tutorial
+    perlobj            Perl objects
+    perltie            Perl objects hidden behind simple variables
+    perlbot            Perl OO tricks and examples
+    perlipc            Perl interprocess communication
+
+    perldebug          Perl debugging
+    perldiag           Perl diagnostic messages
+    perlsec            Perl security
+    perltrap           Perl traps for the unwary
+    perlport           Perl portability guide
+    perlstyle          Perl style guide
+
+    perlpod            Perl plain old documentation
+    perlbook           Perl book information
+
+    perlembed          Perl ways to embed perl in your C or C++ application
+    perlapio           Perl internal IO abstraction interface
+    perlxs             Perl XS application programming interface
+    perlxstut          Perl XS tutorial
+    perlguts           Perl internal functions for those doing extensions
+    perlcall           Perl calling conventions from C
+
+    perlhist           Perl history records
 
 (If you're intending to read these straight through for the first time,
 the suggested order will tend to reduce the number of forward references.)
diff --git a/pod/perlmodinstall.pod b/pod/perlmodinstall.pod
new file mode 100644 (file)
index 0000000..6eda8ec
--- /dev/null
@@ -0,0 +1,407 @@
+=head1 NAME
+
+perlmodinstall - Installing CPAN Modules
+
+=head1 DESCRIPTION
+
+You can think of a module as the fundamental unit of reusable Perl
+code; see L<perlmod> for details.  Whenever anyone creates a chunk of
+Perl code that they think will be useful to the world, they register
+as a Perl developer at http://www.perl.com/CPAN/modules/04pause.html
+so that they can then upload their code to the CPAN.  The CPAN is the
+Comprehensive Perl Archive Network and can be accessed at
+http://www.perl.com/CPAN/.
+
+This documentation is for people who want to download CPAN modules
+and install them on their own computer.
+
+=head2 PREAMBLE
+
+You have a file ending in .tar.gz (or, less often, .zip).  You know
+there's a tasty module inside.  There are four steps you must now
+take:
+
+=over 5
+
+=item B<DECOMPRESS> the file
+=item B<UNPACK> the file into a directory
+=item B<BUILD> the module (sometimes unnecessary)
+=item B<INSTALL> the module.
+
+=back
+
+Here's how to perform each step for each operating system.  This is
+I<not> a substitute for reading the README and INSTALL files that
+might have come with your module!
+
+Also note that these instructions are tailored for installing the
+module into your system's repository of Perl modules.  But you can
+install modules into any directory you wish.  For instance, where I
+say C<perl Makefile.PL>, you can substitute C<perl
+Makefile.PL PREFIX=/my/perl_directory> to install the modules
+into C</my/perl_directory>.  Then you can use the modules
+from your Perl programs with C<use lib
+"/my/perl_directory/lib/site_perl";> or sometimes just C<use
+"/my/perl_directory";>.  
+
+=over 4
+
+=item *
+
+B<If you're on Unix,>
+
+You can use Andreas Koenig's CPAN module 
+( http://www.perl.com/CPAN/modules/by-module/CPAN ) 
+to automate the following steps, from DECOMPRESS through INSTALL.
+
+A. DECOMPRESS 
+
+Decompress the file with C<gzip -d yourmodule.tar.gz>
+
+You can get gzip from ftp://prep.ai.mit.edu/pub/gnu. 
+
+Or, you can combine this step with the next to save disk space:
+
+     gzip -dc yourmodule.tar.gz | tar -xof -
+
+B. UNPACK
+
+Unpack the result with C<tar -xof yourmodule.tar>
+
+C. BUILD
+
+Go into the newly-created directory and type:
+
+      perl Makefile.PL
+      make
+      make test
+
+D. INSTALL
+
+While still in that directory, type:
+
+      make install
+
+Make sure you have the appropriate permissions to install the module
+in your Perl 5 library directory.  Often, you'll need to be root.
+
+That's all you need to do on Unix systems with dynamic linking.
+Most Unix systems have dynamic linking -- if yours doesn't, or if for
+another reason you have a statically-linked perl, B<and> the
+module requires compilation, you'll need to build a new Perl binary
+that includes the module.  Again, you'll probably need to be root.
+
+=item *
+
+B<If you're running Windows 95 or NT with the ActiveState port of Perl>
+
+   A. DECOMPRESS
+
+You can use the shareware Winzip ( http://www.winzip.com ) to
+decompress and unpack modules.
+
+   B. UNPACK
+
+If you used WinZip, this was already done for you.
+
+   C. BUILD
+
+Does the module require compilation (i.e. does it have files
+that end in .xs, .c, .h, .y, .cc, .cxx, or .C)?  If it does, you're on
+your own.  You can try compiling it yourself if you have a C compiler.
+If you're successful, consider uploading the resulting binary to the
+CPAN for others to use.  If it doesn't, go to INSTALL.
+
+   D. INSTALL
+
+Copy the module into your Perl's I<lib> directory.  That'll be one
+of the directories you see when you type 
+
+   perl -e 'print "@INC"'
+
+=item *
+
+B<If you're running Windows 95 or NT with the core Windows distribution of Perl,>
+
+   A. DECOMPRESS
+
+When you download the module, make sure it ends in either
+C<.tar.gz> or C<.zip>.  Windows browsers sometimes
+download C<.tar.gz> files as C<_tar.tar>, because
+early versions of Windows prohibited more than one dot in a filename.
+
+You can use the shareware WinZip ( http://www.winzip.com ) to
+decompress and unpack modules.
+
+Or, you can use InfoZip's C<unzip> utility (
+http://www.cdrom.com/pub/infozip/Info-Zip.html ) to uncompress
+C<.zip> files; type C<unzip yourmodule.zip> in
+your shell.
+
+Or, if you have a working C<tar> and C<gzip>, you can
+type
+
+   gzip -cd yourmodule.tar.gz | tar xvf -
+
+in the shell to decompress C<yourmodule.tar.gz>.  This will
+UNPACK your module as well.
+
+   B. UNPACK
+
+All of the methods in DECOMPRESS will have done this for you.
+
+   C. BUILD
+
+Go into the newly-created directory and type:
+
+      perl Makefile.PL
+      dmake
+      dmake test
+
+Depending on your perl configuration, C<dmake> might not be
+available.  You might have to substitute whatever C<perl
+-V:make> says. (Usually, that will be C<nmake> or
+C<make>.)
+
+   D. INSTALL
+
+While still in that directory, type:
+
+      dmake install
+
+=item *
+
+B<If you're using a Macintosh,>
+
+A. DECOMPRESS
+
+You can either use StuffIt Expander ( http://www.aladdinsys.com/ ) in
+combination with I<DropStuff with Expander Enhancer>
+(shareware), or the freeware MacGzip (
+http://persephone.cps.unizar.es/general/gente/spd/gzip/gzip.html ).
+
+B. UNPACK
+
+If you're using DropStuff or Stuffit, you can just extract the tar
+archive.  Otherwise, you can use the freeware I<suntar> (
+http://www.cirfid.unibo.it/~speranza ).
+
+C. BUILD
+
+Does the module require compilation? 
+
+1. If it does,
+
+Overview: You need MPW and a combination of new and old CodeWarrior
+compilers for MPW and libraries.  Makefiles created for building under
+MPW use the Metrowerks compilers.  It's most likely possible to build
+without other compilers, but it has not been done successfully, to our
+knowledge.  Read the documentation in MacPerl: Power and Ease (
+http://www.ptf.com/macperl/ ) on porting/building extensions, or find
+an existing precompiled binary, or hire someone to build it for you.
+
+Or, ask someone on the mac-perl mailing list (mac-perl@iis.ee.ethz.ch)
+to build it for you.  To subscribe to the mac-perl mailing list, send
+mail to mac-perl-request@iis.ee.ethz.ch.
+
+2. If the module doesn't require compilation, go to INSTALL.
+
+D. INSTALL
+
+Make sure the newlines for the modules are in Mac format, not Unix format.
+Move the files manually into the correct folders.
+
+Move the files to their final destination: This will
+most likely be in C<$ENV{MACPERL}site_lib:> (i.e.,
+C<HD:MacPerl folder:site_lib:>).  You can add new paths to
+the default C<@INC> in the Preferences menu item in the
+MacPerl application (C<$ENV{MACPERL}site_lib:> is added
+automagically).  Create whatever directory structures are required
+(i.e., for C<Some::Module>, create
+C<$ENV{MACPERL}site_lib:Some:> and put
+C<Module.pm> in that directory).
+
+Run the following script (or something like it):
+
+     #!perl -w
+     use AutoSplit;
+     my $dir = "${MACPERL}site_perl";
+     autosplit("$dir:Some:Module.pm", "$dir:auto", 0, 1, 1);
+
+Eventually there should be a way to automate the installation process; some
+solutions exist, but none are ready for the general public yet.
+
+=item *
+
+B<If you're on the DJGPP port of DOS,>
+
+   A. DECOMPRESS
+
+djtarx ( ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2/ )
+will both uncompress and unpack.  
+
+   B. UNPACK
+
+See above.
+
+   C. BUILD
+
+Go into the newly-created directory and type:
+
+      perl Makefile.PL
+      make
+      make test
+
+You will need the packages mentioned in C<Readme.dos>
+in the Perl distribution.
+
+   D. INSTALL
+
+While still in that directory, type:
+
+     make install      
+     
+You will need the packages mentioned in Readme.dos in the Perl distribution.
+
+=item *
+
+B<If you're on OS/2,>
+
+Get the EMX development suite and gzip/tar, from either Hobbes (
+http://hobbes.nmsu.edu ) or Leo ( http://www.leo.org ), and then follow
+the instructions for Unix.
+
+=item *
+
+B<If you're on VMS,>
+
+When downloading from CPAN, save your file with a C<.tgz>
+extension instead of C<.tar.gz>.  All other periods in the
+filename should be replaced with underscores.  For example,
+C<Your-Module-1.33.tar.gz> should be downloaded as
+C<Your-Module-1_33.tgz>.
+
+A. DECOMPRESS
+
+Type 
+
+    gzip -d Your-Module.tgz
+
+or, for zipped modules, type 
+
+    unzip Your-Module.zip
+
+Executables for gzip, zip, and VMStar ( Alphas:
+http://www.openvms.digital.com/cd/000TOOLS/ALPHA/ and Vaxen:
+http://www.openvms.digital.com/cd/000TOOLS/VAX/ ).  
+
+gzip and tar
+are also available at ftp://ftp.digital.com/pub/VMS.
+
+Note that GNU's gzip/gunzip is not the same as Info-ZIP's zip/unzip
+package.  The former is a simple compression tool; the latter permits
+creation of multi-file archives.
+
+B. UNPACK
+
+If you're using VMStar:
+
+     VMStar xf Your-Module.tar
+
+Or, if you're fond of VMS command syntax:
+
+     tar/extract/verbose Your_Module.tar
+
+C. BUILD 
+
+Make sure you have MMS (from Digital) or the freeware MMK ( available from MadGoat at  http://www.madgoat.com ).  Then type this to create the
+DESCRIP.MMS for the module: 
+
+    perl Makefile.PL
+
+Now you're ready to build:
+
+    mms
+    mms test
+
+Substitute C<mmk> for C<mms> above if you're using MMK.
+
+D. INSTALL
+
+Type 
+
+    mms install
+
+Substitute C<mmk> for C<mms> above if you're using MMK.
+
+=item *
+
+B<If you're on MVS>,
+
+Introduce the .tar.gz file into an HFS as binary; don't translate from
+ASCII to EBCDIC.
+
+A. DECOMPRESS 
+
+      Decompress the file with C<gzip -d yourmodule.tar.gz>
+
+      You can get gzip from 
+      http://www.s390.ibm.com/products/oe/bpxqp1.html.
+
+B. UNPACK
+
+Unpack the result with 
+
+     pax -o to=IBM-1047,from=ISO8859-1 -r < yourmodule.tar
+
+The BUILD and INSTALL steps are identical to those for Unix.  Some
+modules generate Makefiles that work better with GNU make, which is
+available from http://www.mks.com/s390/gnu/index.htm.
+
+=back
+
+=head1 HEY
+
+If you have any suggested changes for this page, let me know.  Please
+don't send me mail asking for help on how to install your modules.
+There are too many modules, and too few Orwants, for me to be able to
+answer or even acknowledge all your questions.  Contact the module
+author instead, or post to comp.lang.perl.modules, or ask someone
+familiar with Perl on your operating system.
+
+=head1 AUTHOR
+
+Jon Orwant 
+
+orwant@tpj.com
+
+The Perl Journal, http://tpj.com
+
+with invaluable help from Brandon Allbery, Charles Bailey, Graham
+Barr, Dominic Dunlop, Jarkko Hietaniemi, Ben Holzman, Tom Horsley,
+Nick Ing-Simmons, Tuomas J. Lukka, Laszlo Molnar, Chris Nandor, Alan
+Olsen, Peter Prymmer, Gurusamy Sarathy, Christoph Spalinger, Dan
+Sugalski, Larry Virden, and Ilya Zakharevich.
+
+July 22, 1998
+
+=head1 COPYRIGHT
+
+Copyright (C) 1998 Jon Orwant.  All Rights Reserved.
+
+Permission is granted to make and distribute verbatim copies of this
+documentation provided the copyright notice and this permission notice are
+preserved on all copies.
+
+Permission is granted to copy and distribute modified versions of this
+documentation under the conditions for verbatim copying, provided also
+that they are marked clearly as modified versions, that the authors'
+names and title are unchanged (though subtitles and additional
+authors' names may be added), and that the entire resulting derived
+work is distributed under the terms of a permission notice identical
+to this one.
+
+Permission is granted to copy and distribute translations of this
+documentation into another language, under the above conditions for
+modified versions.
+
index acec1a6..67294b4 100644 (file)
@@ -38,8 +38,8 @@ expression enhancements, Innumerable Unbundled Modules, Compilability
 
 =item NOTES
 
-=head2 perlfaq - frequently asked questions about Perl ($Date: 1997/04/24
-22:46:06 $)
+=head2 perlfaq - frequently asked questions about Perl ($Date: 1998/07/20
+23:12:17 $)
 
 =item DESCRIPTION
 
@@ -66,9 +66,7 @@ authors
 
 =over
 
-=item Noncommercial Reproduction
-
-=item Commercial Reproduction
+=item Bundled Distributions
 
 =item Disclaimer
 
@@ -79,8 +77,8 @@ authors
 24/April/97, 23/April/97, 25/March/97, 18/March/97, 17/March/97 Version,
 Initial Release: 11/March/97
 
-=head2 perlfaq1 - General Questions About Perl ($Revision: 1.12 $, $Date:
-1997/04/24 22:43:34 $)
+=head2 perlfaq1 - General Questions About Perl ($Revision: 1.14 $, $Date:
+1998/06/14 22:15:25 $)
 
 =item DESCRIPTION
 
@@ -120,8 +118,8 @@ Scheme, or Tcl?
 
 =item AUTHOR AND COPYRIGHT
 
-=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.16 $,
-$Date: 1997/04/23 18:04:09 $)
+=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.24 $,
+$Date: 1998/07/20 23:40:28 $)
 
 =item DESCRIPTION
 
@@ -166,8 +164,6 @@ MacPerl, Perl5-Porters, NTPerl, Perl-Packrats
 
 =item Archives of comp.lang.perl.misc
 
-=item Perl Training
-
 =item Where can I buy a commercial version of Perl?
 
 =item Where do I send bug reports?
@@ -180,8 +176,8 @@ MacPerl, Perl5-Porters, NTPerl, Perl-Packrats
 
 =item AUTHOR AND COPYRIGHT
 
-=head2 perlfaq3 - Programming Tools ($Revision: 1.22 $, $Date: 1997/04/24
-22:43:42 $)
+=head2 perlfaq3 - Programming Tools ($Revision: 1.28 $, $Date: 1998/07/16
+22:08:49 $)
 
 =item DESCRIPTION
 
@@ -229,7 +225,7 @@ MacPerl, Perl5-Porters, NTPerl, Perl-Packrats
 
 =item How can I compile my Perl program into byte code or C?
 
-=item How can I get '#!perl' to work on [MS-DOS,NT,...]?
+=item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
 
 =item Can I write useful perl programs on the command line?
 
@@ -253,8 +249,8 @@ mean?
 
 =item AUTHOR AND COPYRIGHT
 
-=head2 perlfaq4 - Data Manipulation ($Revision: 1.19 $, $Date: 1997/04/24
-22:43:57 $)
+=head2 perlfaq4 - Data Manipulation ($Revision: 1.25 $, $Date: 1998/07/16
+22:49:55 $)
 
 =item DESCRIPTION
 
@@ -288,7 +284,7 @@ Trig functions?
 
 =item How do I find the week-of-the-year/day-of-the-year?
 
-=item How can I compare two date strings?
+=item How can I compare two dates and find the difference?
 
 =item How can I take a string and turn it into epoch seconds?
 
@@ -448,8 +444,8 @@ array of hashes or arrays?
 
 =item AUTHOR AND COPYRIGHT
 
-=head2 perlfaq5 - Files and Formats ($Revision: 1.22 $, $Date: 1997/04/24
-22:44:02 $)
+=head2 perlfaq5 - Files and Formats ($Revision: 1.24 $, $Date: 1998/07/05
+15:07:20 $)
 
 =item DESCRIPTION
 
@@ -530,7 +526,7 @@ protected files?  Isn't this a bug in Perl?
 
 =item AUTHOR AND COPYRIGHT
 
-=head2 perlfaq6 - Regexps ($Revision: 1.17 $, $Date: 1997/04/24 22:44:10 $)
+=head2 perlfaq6 - Regexps ($Revision: 1.22 $, $Date: 1998/07/16 14:01:07 $)
 
 =item DESCRIPTION
 
@@ -591,8 +587,8 @@ file?
 
 =item AUTHOR AND COPYRIGHT
 
-=head2 perlfaq7 - Perl Language Issues ($Revision: 1.18 $, $Date:
-1997/04/24 22:44:14 $)
+=head2 perlfaq7 - Perl Language Issues ($Revision: 1.21 $, $Date:
+1998/06/22 15:20:07 $)
 
 =item DESCRIPTION
 
@@ -642,7 +638,7 @@ is in scope?
 
 =item What's the difference between deep and shallow binding?
 
-=item Why doesn't "local($foo) = <FILE>;" work right?
+=item Why doesn't "my($foo) = <FILE>;" work right?
 
 =item How do I redefine a builtin function, operator, or method?
 
@@ -662,8 +658,8 @@ is in scope?
 
 =item AUTHOR AND COPYRIGHT
 
-=head2 perlfaq8 - System Interaction ($Revision: 1.21 $, $Date: 1997/04/24
-22:44:19 $)
+=head2 perlfaq8 - System Interaction ($Revision: 1.25 $, $Date: 1998/07/05
+15:07:20 $)
 
 =item DESCRIPTION
 
@@ -677,6 +673,16 @@ is in scope?
 
 Keyboard, Screen, Mouse
 
+=item How do I print something out in color?
+
+=item How do I read just one key without waiting for a return key?
+
+=item How do I check whether input is ready on the keyboard?
+
+=item How do I clear the screen?
+
+=item How do I get the screen size?
+
 =item How do I ask the user for a password?
 
 =item How do I read and write the serial port?
@@ -687,7 +693,7 @@ lockfiles, open mode, end of line, flushing output, non-blocking input
 
 =item How do I start a process in the background?
 
-STDIN, STDOUT and STDERR are shared, Signals, Zombies
+STDIN, STDOUT, and STDERR are shared, Signals, Zombies
 
 =item How do I trap control characters/signals?
 
@@ -738,7 +744,7 @@ does the error message "Protocol not supported" mean?
 come the change disappeared when I exited the script?  How do I get my
 changes to be visible?
 
-Unix, VMS
+Unix
 
 =item How do I close a process's filehandle without waiting for it to
 complete?
@@ -763,6 +769,8 @@ complete?
 
 =item How do I install a CPAN module?
 
+=item What's the difference between require and use?
+
 =item How do I keep my own module/library directory?
 
 =item How do I add the directory my program lives in to the module/library
@@ -772,19 +780,19 @@ search path?
 
 =back
 
-=item How do I get one key from the terminal at a time, under POSIX?
-
 =item AUTHOR AND COPYRIGHT
 
-=head2 perlfaq9 - Networking ($Revision: 1.17 $, $Date: 1997/04/24 22:44:29
+=head2 perlfaq9 - Networking ($Revision: 1.20 $, $Date: 1998/06/22 18:31:09
 $)
 
 =item DESCRIPTION
 
 =over
 
-=item My CGI script runs from the command line but not the browser.  Can
-you help me fix it?
+=item My CGI script runs from the command line but not the browser.   (500
+Server Error)
+
+=item How can I get better error messages from a CGI program?
 
 =item How do I remove HTML from a string?
 
@@ -797,7 +805,9 @@ file on another machine?
 
 =item How do I fetch an HTML file?
 
-=item how do I decode or create those %-encodings on the web?
+=item How do I automate an HTML form submission?
+
+=item How do I decode or create those %-encodings on the web?
 
 =item How do I redirect to another page?
 
@@ -818,7 +828,9 @@ CGI script to do bad things?
 
 =item How do I return the user's mail address?
 
-=item How do I send/read mail?
+=item How do I send mail?
+
+=item How do I read mail?
 
 =item How do I find out my hostname/domainname/IP address?
 
@@ -836,24 +848,170 @@ CGI script to do bad things?
 
 =item DESCRIPTION
 
+=item About the new versioning system
+
 =item Incompatible Changes
 
+=over
+
+=item WARNING:  This version is not binary compatible with Perl 5.004.
+
+=item Default installation structure has changed
+
+=item Perl Source Compatibility
+
+=item C Source Compatibility
+
+Core sources now require ANSI C compiler, Enabling threads has source
+compatibility issues
+
+=item Binary Compatibility
+
+=item Security fixes may affect compatibility
+
+=item Relaxed new mandatory warnings introduced in 5.004
+
+=item Licensing
+
+=back
+
 =item Core Changes
 
-=item Modules
+=over
+
+=item Threads
+
+=item Compiler
+
+=item Regular Expressions
+
+=item   Improved malloc()
+
+=item Quicksort is internally implemented
+
+=item Reliable signals
+
+=item Reliable stack pointers
+
+=item Behavior of local() on array and hash elements is now well-defined
+
+=item C<%!> is transparently tied to the L<Errno> module
+
+=item Pseudo-hashes are supported
+
+=item C<EXPR foreach EXPR> is supported
+
+=item Keywords can be globally overridden
+
+=item C<$^E> is meaningful on Win32
+
+=item C<foreach (1..1000000)> optimized
+
+=item C<Foo::> can be used as implicitly quoted package name
+
+=item C<exists $Foo::{Bar::}> tests existence of a package
+
+=item Better locale support
+
+=item Experimental support for 64-bit platforms
+
+=item prototype() returns useful results on builtins
+
+=item Extended support for exception handling
+
+=item Re-blessing in DESTROY() supported for chaining DESTROY() methods
+
+=item All C<printf> format conversions are handled internally
+
+=item New C<INIT> keyword
+
+=item New C<lock> keyword
+
+=item New C<qr//> operator
+
+=item C<our> is now a reserved word
+
+=item Tied arrays are now fully supported
+
+=item Tied handles support is better
+
+=item 4th argument to substr
+
+=item Negative LENGTH argument to splice
+
+=item Magic lvalues are now more magical
+
+=item E<lt>E<gt> now reads in records
+
+=back
+
+=item Supported Platforms
+
+=over
+
+=item New Platforms
+
+=item Changes in existing support
+
+=back
+
+=item Modules and Pragmata
 
 =over
 
-=item Required Updates
+=item New Modules
+
+B, Data::Dumper, Errno, File::Spec, ExtUtils::Installed,
+ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
+Thread, attrs, fields, re
+
+=item Changes in existing modules
+
+CGI, POSIX, DB_File, MakeMaker, CPAN, Cwd, Benchmark
 
 =back
 
 =item Utility Changes
 
-=item C Language API Changes
+=item API Changes
+
+=over
+
+=item Incompatible Changes
+
+=item Deprecations, Extensions
+
+=item C++ Support
+
+=back
 
 =item Documentation Changes
 
+=item New Diagnostics
+
+Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
+while coercing array into hash, Bareword "%s" refers to nonexistent
+package, Can't call method "%s" on an undefined value, Can't coerce array
+into hash, Can't goto subroutine from an eval-string, Can't localize
+pseudo-hash element, Can't use %%! because Errno.pm is not available,
+Cannot find an opnumber for "%s", Character class syntax [. .] is reserved
+for future extensions, Character class syntax [: :] is reserved for future
+extensions, Character class syntax [= =] is reserved for future extensions,
+%s: Eval-group in insecure regular expression, %s: Eval-group not allowed,
+use re 'eval', %s: Eval-group not allowed at run time, Explicit blessing to
+'' (assuming package main), Illegal hex digit ignored, No such array field,
+No such field "%s" in variable %s of type %s, Out of memory during
+ridiculously large request, Range iterator outside integer range, Recursive
+inheritance detected while looking for method '%s' in package '%s',
+Reference found where even-sized list expected, Undefined value assigned to
+typeglob, Use of reserved word "%s" is deprecated, perl: warning: Setting
+locale failed
+
+=item Obsolete Diagnostics
+
+Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
+temporary file
+
 =item BUGS
 
 =item SEE ALSO
@@ -973,10 +1131,18 @@ unary &, unary *, (TYPE)
 =item Regexp Quote-Like Operators
 
 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
-qq/STRING/, "STRING", qx/STRING/, `STRING`, qw/STRING/,
+qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
 y/SEARCHLIST/REPLACEMENTLIST/cds
 
+=item Gory details of parsing quoted constructs
+
+Finding the end, Removal of backslashes before delimiters, Interpolation,
+C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
+C<``>, C<qq//>, C<qx//>, C<<file*globE<gt>>, C<?RE?>, C</RE/>, C<m/RE/>,
+C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
+regular expressions
+
 =item I/O Operators
 
 =item Constant Folding
@@ -1001,10 +1167,10 @@ i, m, s, x
 
 =item Regular Expressions
 
-C<(?#text)>, C<(?:pattern)>, C<(?=pattern)>, C<(?!pattern)>,
-C<(?E<lt>=pattern)>, C<(?<!pattern)>, C<(?{ code })>, C<(?E<gt>pattern)>,
-C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>,
-C<(?imsx)>
+C<(?#text)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>, C<(?=pattern)>,
+C<(?!pattern)>, C<(?E<lt>=pattern)>, C<(?<!pattern)>, C<(?{ code })>,
+C<(?E<gt>pattern)>, C<(?(condition)yes-pattern|no-pattern)>,
+C<(?(condition)yes-pattern)>, C<(?imsx-imsx)>
 
 =item Backtracking
 
@@ -1012,6 +1178,10 @@ C<(?imsx)>
 
 =item WARNING on \1 vs $1
 
+=item Repeated patterns matching zero-length substring
+
+=item Creating custom RE engines
+
 =item SEE ALSO
 
 =back
@@ -1073,22 +1243,22 @@ NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
 binmode FILEHANDLE, bless REF,CLASSNAME, bless REF, caller EXPR, caller,
 chdir EXPR, chmod LIST, chomp VARIABLE, chomp LIST, chomp, chop VARIABLE,
 chop LIST, chop, chown LIST, chr NUMBER, chr, chroot FILENAME, chroot,
-close FILEHANDLE, closedir DIRHANDLE, connect SOCKET,NAME, continue BLOCK,
-cos EXPR, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE,
-defined EXPR, defined, delete EXPR, die LIST, do BLOCK, do
-SUBROUTINE(LIST), do EXPR, dump LABEL, each HASH, eof FILEHANDLE, eof (),
-eof, eval EXPR, eval BLOCK, exec LIST, exec PROGRAM LIST, exists EXPR, exit
-EXPR, exp EXPR, exp, fcntl FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE,
-flock FILEHANDLE,OPERATION, fork, format, formline PICTURE,LIST, getc
-FILEHANDLE, getc, getlogin, getpeername SOCKET, getpgrp PID, getppid,
-getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME, gethostbyname NAME,
-getnetbyname NAME, getprotobyname NAME, getpwuid UID, getgrgid GID,
-getservbyname NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE, getnetbyaddr
-ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent,
-getgrent, gethostent, getnetent, getprotoent, getservent, setpwent,
-setgrent, sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN,
-setservent STAYOPEN, endpwent, endgrent, endhostent, endnetent,
-endprotoent, endservent, getsockname SOCKET, getsockopt
+close FILEHANDLE, close, closedir DIRHANDLE, connect SOCKET,NAME, continue
+BLOCK, cos EXPR, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen
+HASH,DBNAME,MODE, defined EXPR, defined, delete EXPR, die LIST, do BLOCK,
+do SUBROUTINE(LIST), do EXPR, dump LABEL, each HASH, eof FILEHANDLE, eof
+(), eof, eval EXPR, eval BLOCK, exec LIST, exec PROGRAM LIST, exists EXPR,
+exit EXPR, exp EXPR, exp, fcntl FILEHANDLE,FUNCTION,SCALAR, fileno
+FILEHANDLE, flock FILEHANDLE,OPERATION, fork, format, formline
+PICTURE,LIST, getc FILEHANDLE, getc, getlogin, getpeername SOCKET, getpgrp
+PID, getppid, getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME,
+gethostbyname NAME, getnetbyname NAME, getprotobyname NAME, getpwuid UID,
+getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE,
+getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport
+PORT,PROTO, getpwent, getgrent, gethostent, getnetent, getprotoent,
+getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent STAYOPEN,
+setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, endhostent,
+endnetent, endprotoent, endservent, getsockname SOCKET, getsockopt
 SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL, goto EXPR,
 goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex, import, index
 STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
@@ -1103,21 +1273,21 @@ DIRHANDLE,EXPR, ord EXPR, ord, pack TEMPLATE,LIST, package, package
 NAMESPACE, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos,
 print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST,
 printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/,
-qq/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta, rand EXPR,
-rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read FILEHANDLE,SCALAR,LENGTH,
-readdir DIRHANDLE, readline EXPR, readlink EXPR, readlink, readpipe EXPR,
-recv SOCKET,SCALAR,LEN,FLAGS, redo LABEL, redo, ref EXPR, ref, rename
-OLDNAME,NEWNAME, require EXPR, require, reset EXPR, reset, return EXPR,
-return, reverse LIST, rewinddir DIRHANDLE, rindex STR,SUBSTR,POSITION,
-rindex STR,SUBSTR, rmdir FILENAME, rmdir, s///, scalar EXPR, seek
-FILEHANDLE,POSITION,WHENCE, seekdir DIRHANDLE,POS, select FILEHANDLE,
-select, select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
-KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send SOCKET,MSG,FLAGS,TO, send
-SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority WHICH,WHO,PRIORITY,
-setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY, shift, shmctl
-ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE, shmwrite
-ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep EXPR, sleep,
-socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
+qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta,
+rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
+FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
+readlink, readpipe EXPR, recv SOCKET,SCALAR,LEN,FLAGS, redo LABEL, redo,
+ref EXPR, ref, rename OLDNAME,NEWNAME, require EXPR, require, reset EXPR,
+reset, return EXPR, return, reverse LIST, rewinddir DIRHANDLE, rindex
+STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, rmdir, s///, scalar
+EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir DIRHANDLE,POS, select
+FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, semctl
+ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
+SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
+WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
+shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
+shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
+EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
 splice ARRAY,OFFSET, split /PATTERN/,EXPR,LIMIT, split /PATTERN/,EXPR,
@@ -1166,10 +1336,12 @@ $EVAL_ERROR, $@, $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<,
 $EFFECTIVE_USER_ID, $EUID, $>, $REAL_GROUP_ID, $GID, $(,
 $EFFECTIVE_GROUP_ID, $EGID, $), $PROGRAM_NAME, $0, $[, $PERL_VERSION, $],
 $DEBUGGING, $^D, $SYSTEM_FD_MAX, $^F, $^H, $INPLACE_EDIT, $^I, $^M,
-$OSNAME, $^O, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, $^S,
+$OSNAME, $^O, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, $^R, $^S,
 $BASETIME, $^T, $WARNING, $^W, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @INC,
 @_, %INC, %ENV  $ENV{expr}, %SIG  $SIG{expr}
 
+=item Error Indicators
+
 =back
 
 =head2 perlsub - Perl subroutines
@@ -1180,7 +1352,7 @@ $BASETIME, $^T, $WARNING, $^W, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @INC,
 
 =over
 
-=item Private Variables via my()
+=item Private Variables via C<my()>
 
 =item Peristent Private Variables
 
@@ -1190,9 +1362,9 @@ $BASETIME, $^T, $WARNING, $^W, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @INC,
 
 =item When to Still Use local()
 
-1. You need to give a global variable a temporary value, especially $_, 2.
-You need to create a local file or directory handle or a local function, 3.
-You want to temporarily change just one element of an array or hash
+1. You need to give a global variable a temporary value, especially C<$_>,
+2. You need to create a local file or directory handle or a local function,
+3. You want to temporarily change just one element of an array or hash
 
 =item Pass by Reference
 
@@ -1239,7 +1411,7 @@ You want to temporarily change just one element of an array or hash
 =item Pragmatic Modules
 
 use autouse MODULE => qw(sub1 sub2 sub3), blib, diagnostics, integer, less,
-lib, locale, ops, overload, sigtrap, strict, subs, vmsish, vars
+lib, locale, ops, overload, re, sigtrap, strict, subs, vmsish, vars
 
 =item Standard Modules
 
@@ -1320,6 +1492,26 @@ can then be reduced to a small
 
 =item NOTE
 
+=head2 perlmodinstall - Installing CPAN Modules
+
+=item DESCRIPTION
+
+=over
+
+=item PREAMBLE
+
+B<DECOMPRESS> the file=item B<UNPACK> the file into a directory
+=item B<BUILD> the module (sometimes unnecessary)
+=item B<INSTALL> the module
+
+=back
+
+=item HEY
+
+=item AUTHOR
+
+=item COPYRIGHT
+
 =head2 perlform - Perl formats
 
 =item DESCRIPTION
@@ -1455,6 +1647,8 @@ LC_TIME, LANG
 
 =item Not-so-symbolic references
 
+=item Pseudo-hashes: Using an array as a hash
+
 =item Function Templates
 
 =back
@@ -1901,6 +2095,23 @@ C<!!!>, C<!!>, C<!>
 
 =back
 
+=item Debugging regular expressions
+
+=over
+
+=item Compile-time output
+
+C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
+I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
+I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
+C<anchored(TYPE)>
+
+=item Types of nodes
+
+=item Run-time output
+
+=back
+
 =head2 perldiag - various Perl diagnostics
 
 =item DESCRIPTION
@@ -1956,7 +2167,7 @@ Discontinuance, Discontinuance, Deprecation, Discontinuance
 
 =item Parsing Traps
 
-Parsing, Parsing, Parsing
+Parsing, Parsing, Parsing, Parsing
 
 =item Numerical Traps
 
@@ -1973,13 +2184,14 @@ Numerical, Numerical, Numerical
 
 =item Precedence Traps
 
-Precedence, Precedence, Precedence, Precedence, Precedence, Precedence
+Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
+Precedence
 
 =item General Regular Expression Traps using s///, etc.
 
 Regular Expression, Regular Expression, Regular Expression, Regular
 Expression, Regular Expression, Regular Expression, Regular Expression,
-Regular Expression, Regular Expression
+Regular Expression
 
 =item Subroutine, Signal, Sorting Traps
 
@@ -2005,6 +2217,115 @@ LIMIT specified
 
 =back
 
+=head2 perlport - Writing portable Perl
+
+=item DESCRIPTION
+
+Not all Perl programs have to be portable, The vast majority of Perl B<is>
+portable
+
+=item ISSUES
+
+=over
+
+=item Newlines
+
+=item File Paths
+
+=item System Interaction
+
+=item Interprocess Communication (IPC)
+
+=item External Subroutines (XS)
+
+=item Standard Modules
+
+=item Time and Date
+
+=item System Resources
+
+=item Security
+
+=item Style
+
+=back
+
+=item CPAN TESTERS
+
+Mailing list: cpan-testers@perl.org, Testing results:
+C<http://www.connect.net/gbarr/cpan-test/>
+
+=item PLATFORMS
+
+=over
+
+=item Unix
+
+=item DOS and Derivatives
+
+The djgpp environment for DOS, C<http://www.delorie.com/djgpp/>, The EMX
+environment for DOS, OS/2, etc.
+C<emx@iaehv.nl>,C<http://www.juge.com/bbs/Hobb.19.html>, Build instructions
+for Win32, L<perlwin32>, The ActiveState Pages,
+C<http://www.activestate.com/>
+
+=item MacPerl
+
+The MacPerl Pages, C<http://www.ptf.com/macperl/>, The MacPerl mailing
+list, C<mac-perl-request@iis.ee.ethz.ch>
+
+=item VMS
+
+L<perlvms.pod>, vmsperl list, C<vmsperl-request@newman.upenn.edu>, vmsperl
+on the web, C<http://www.sidhe.org/vmsperl/index.html>
+
+=item EBCDIC Platforms
+
+perl-mvs list, AS/400 Perl information at C<http://as400.rochester.ibm.com>
+
+=item Other perls
+
+Atari, Guido Flohr's page C<http://stud.uni-sb.de/~gufl0000/>, HP 300
+MPE/iX  C<http://www.cccd.edu/~markb/perlix.html>, Novell Netware
+
+=back
+
+=item FUNCTION IMPLEMENTATIONS
+
+=over
+
+=item Alphabetical Listing of Perl Functions
+
+-I<X> FILEHANDLE, -I<X> EXPR, -I<X>, binmode FILEHANDLE, chmod LIST, chown
+LIST, chroot FILENAME, chroot, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen
+HASH,DBNAME,MODE, dump LABEL, exec LIST, fcntl FILEHANDLE,FUNCTION,SCALAR,
+flock FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid,
+getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME,
+getpwuid UID, getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber
+NUMBER, getservbyport PORT,PROTO, getpwent, getgrent, gethostent,
+getnetent, getprotoent, getservent, setpwent, setgrent, sethostent
+STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN,
+endpwent, endgrent, endhostent, endnetent, endprotoent, endservent,
+getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl
+FILEHANDLE,FUNCTION,SCALAR, kill LIST, link OLDFILE,NEWFILE, lstat
+FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd
+ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open
+FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select
+RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
+KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setpgrp PID,PGRP, setpriority
+WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl
+ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE, shmwrite
+ID,STRING,POS,SIZE, socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat
+FILEHANDLE, stat EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, system
+LIST, times, truncate FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR,
+umask, utime LIST, wait, waitpid PID,FLAGS
+
+=back
+
+=item AUTHORS / CONTRIBUTORS
+
+=item VERSION
+
 =head2 perlstyle - Perl style guide
 
 =item DESCRIPTION
@@ -2515,6 +2836,12 @@ callback
 
 method, locked
 
+=head2 re - Perl pragma to alter regular expression behaviour
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
 =head2 autouse - postpone load of modules until a function is used
 
 =item SYNOPSIS
@@ -2533,7 +2860,7 @@ method, locked
 
 =item DESCRIPTION
 
-=item BUGS
+=item SEE ALSO
 
 =head2 blib - Use MakeMaker's uninstalled version of a package
 
@@ -2590,6 +2917,8 @@ diagnostics
 
 =item DESCRIPTION
 
+=item SEE ALSO
+
 =head2 integer - Perl pragma to compute arithmetic in integer instead of
 double
 
@@ -2691,6 +3020,10 @@ I<Concatenation>, I<Comparison operations>, I<Copy operator>
 
 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
 
+=item Overloading constants
+
+integer, float, binary, q, qr
+
 =item IMPLEMENTATION
 
 =item AUTHOR
@@ -2803,164 +3136,479 @@ $keep, $check, $modtime
 
 =item DIAGNOSTICS
 
-=head2 B::Lint - Perl lint
+=head2 B - The Perl Compiler
 
 =item SYNOPSIS
 
 =item DESCRIPTION
 
-=item OPTIONS AND LINT CHECKS
+=item OVERVIEW OF CLASSES
 
-B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
-B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
+=over
 
-=item NON LINT-CHECK OPTIONS
+=item SV-RELATED CLASSES
 
-B<-u Package>
+=item B::SV METHODS
 
-=item BUGS
+REFCNT, FLAGS
 
-=item AUTHOR
+=item B::IV METHODS
 
-=head2 B::Xref - Generates cross reference reports for Perl programs
+IV, IVX, needs64bits, packiv
 
-=item SYNOPSIS
+=item B::NV METHODS
 
-=item DESCRIPTION
+NV, NVX
 
-=item OPTIONS
+=item B::RV METHODS
 
-C<-oFILENAME>, C<-r>, C<-D[tO]>
+RV
 
-=item BUGS
+=item B::PV METHODS
 
-=item AUTHOR
+PV
 
-=head2 Benchmark - benchmark running times of code
+=item B::PVMG METHODS
 
-=item SYNOPSIS
+MAGIC, SvSTASH
 
-=item DESCRIPTION
+=item B::MAGIC METHODS
 
-=over
+MOREMAGIC, PRIVATE, TYPE, FLAGS, OBJ, PTR
 
-=item Methods
+=item B::PVLV METHODS
 
-new, debug
+TARGOFF, TARGLEN, TYPE, TARG
 
-=item Standard Exports
+=item B::BM METHODS
 
-timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
-timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
-TIMEDIFF, [ STYLE, [ FORMAT ] ] )
+USEFUL, PREVIOUS, RARE, TABLE
 
-=item Optional Exports
+=item B::GV METHODS
 
-clearcache ( COUNT ), clearallcache ( ), disablecache ( ), enablecache ( )
+NAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN, LINE, FILEGV, GvREFCNT,
+FLAGS
 
-=back
+=item B::IO METHODS
 
-=item NOTES
+LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
+BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS
 
-=item INHERITANCE
+=item B::AV METHODS
 
-=item CAVEATS
+FILL, MAX, OFF, ARRAY, AvFLAGS
 
-=item AUTHORS
+=item B::CV METHODS
 
-=item MODIFICATION HISTORY
+STASH, START, ROOT, GV, FILEGV, DEPTH, PADLIST, OUTSIDE, XSUB, XSUBANY
 
-=head2 Bundle::CPAN - A bundle to play with all the other modules on CPAN
+=item B::HV METHODS
 
-=item SYNOPSIS
+FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
 
-=item CONTENTS
+=item OP-RELATED CLASSES
 
-=item DESCRIPTION
+=item B::OP METHODS
 
-=item AUTHOR
+next, sibling, ppaddr, desc, targ, type, seq, flags, private
 
-=head2 CGI - Simple Common Gateway Interface Class
+=item B::UNOP METHOD
 
-=item SYNOPSIS
+first
 
-=item ABSTRACT
+=item B::BINOP METHOD
 
-=item INSTALLATION
+last
 
-=item DESCRIPTION
+=item B::LOGOP METHOD
 
-=over
+other
 
-=item CREATING A NEW QUERY OBJECT:
+=item B::CONDOP METHODS
 
-=item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
+true, false
 
-=item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
+=item B::LISTOP METHOD
 
-=item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
+children
 
-=item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
+=item B::PMOP METHODS
 
-=item SETTING THE VALUE(S) OF A NAMED PARAMETER:
+pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmpermflags, precomp
 
-=item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
+=item B::SVOP METHOD
 
-=item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
+sv
 
-=item DELETING A PARAMETER COMPLETELY:
+=item B::GVOP METHOD
 
-=item DELETING ALL PARAMETERS:
+gv
 
-=item SAVING THE STATE OF THE FORM TO A FILE:
+=item B::PVOP METHOD
 
-=item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
+pv
 
-=item COMPATIBILITY WITH CGI-LIB.PL
+=item B::LOOP METHODS
 
-=item CALLING CGI FUNCTIONS THAT TAKE MULTIPLE ARGUMENTS
+redoop, nextop, lastop
 
-=item CREATING THE HTTP HEADER:
+=item B::COP METHODS
 
-=item GENERATING A REDIRECTION INSTRUCTION
+label, stash, filegv, cop_seq, arybase, line
 
-=item CREATING THE HTML HEADER:
+=back
 
-B<Parameters:>, 4, 5, 6..
+=item FUNCTIONS EXPORTED BY C<B>
 
-=item ENDING THE HTML DOCUMENT:
+main_cv, main_root, main_start, comppadlist, sv_undef, sv_yes, sv_no,
+walkoptree(OP, METHOD), walkoptree_debug(DEBUG), walksymtable(SYMREF,
+METHOD, RECURSE), svref_2object(SV), ppname(OPNUM), hash(STR), cast_I32(I),
+minus_c, cstring(STR), class(OBJ), threadsv_names, byteload_fh(FILEHANDLE)
 
-=back
+=item AUTHOR
 
-=item CREATING FORMS
+=head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
+bytecode
 
-=over
+=item SYNOPSIS
 
-=item CREATING AN ISINDEX TAG
+=item DESCRIPTION
 
-=item STARTING AND ENDING A FORM
+=item AUTHOR
 
-B<application/x-www-form-urlencoded>, B<multipart/form-data>
+=head2 B::Assembler - Assemble Perl bytecode
 
-=item CREATING A TEXT FIELD
+=item SYNOPSIS
 
-B<Parameters>
+=item DESCRIPTION
 
-=item CREATING A BIG TEXT FIELD
+=item AUTHOR
 
-=item CREATING A PASSWORD FIELD
+=head2 B::Bblock - Walk basic blocks
 
-=item CREATING A FILE UPLOAD FIELD
+=item SYNOPSIS
 
-B<Parameters>
+=item DESCRIPTION
 
-=item CREATING A POPUP MENU
+=item AUTHOR
 
-=item CREATING A SCROLLING LIST
+=head2 B::Bytecode - Perl compiler's bytecode backend
 
-B<Parameters:>
+=item SYNOPSIS
 
-=item CREATING A GROUP OF RELATED CHECKBOXES
+=item DESCRIPTION
+
+=item OPTIONS
+
+B<-ofilename>, B<-->, B<-f>, B<-fcompress-nullops>,
+B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-fstrip-syntax-tree>,
+B<-On>, B<-D>, B<-Do>, B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-m>
+
+=item BUGS
+
+=item AUTHOR
+
+=head2 B::C - Perl compiler's C backend
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item OPTIONS
+
+B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
+B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fno-cog>, B<-On>
+
+=item EXAMPLES
+
+=item BUGS
+
+=item AUTHOR
+
+=head2 B::CC - Perl compiler's optimized C translation backend
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item OPTIONS
+
+B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
+B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
+B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
+
+=item EXAMPLES
+
+=item BUGS
+
+=item DIFFERENCES
+
+=over
+
+=item Loops
+
+=item Context of ".."
+
+=item Arithmetic
+
+=item Deprecated features
+
+=back
+
+=item AUTHOR
+
+=head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item AUTHOR
+
+=head2 B::Deparse - Perl compiler backend to produce perl code
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item OPTIONS
+
+B<-p>, B<-u>I<PACKAGE>, B<-l>, B<-s>I<LETTERS>, B<C>
+
+=item BUGS
+
+=item AUTHOR
+
+=head2 B::Disassembler - Disassemble Perl bytecode
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item AUTHOR
+
+=head2 B::Lint - Perl lint
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item OPTIONS AND LINT CHECKS
+
+B<context>, B<implicit-read> and B<implicit-write>, B<dollar-underscore>,
+B<private-names>, B<undefined-subs>, B<regexp-variables>, B<all>, B<none>
+
+=item NON LINT-CHECK OPTIONS
+
+B<-u Package>
+
+=item BUGS
+
+=item AUTHOR
+
+=head2 B::O, O - Generic interface to Perl Compiler backends
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONVENTIONS
+
+=item IMPLEMENTATION
+
+=item AUTHOR
+
+=head2 B::Showlex - Show lexical variables used in functions or files
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item AUTHOR
+
+=head2 B::Stackobj - Helper module for CC backend
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item AUTHOR
+
+=head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item AUTHOR
+
+=head2 B::Xref - Generates cross reference reports for Perl programs
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item OPTIONS
+
+C<-oFILENAME>, C<-r>, C<-D[tO]>
+
+=item BUGS
+
+=item AUTHOR
+
+=head2 Benchmark - benchmark running times of code
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over
+
+=item Methods
+
+new, debug
+
+=item Standard Exports
+
+timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
+timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
+TIMEDIFF, [ STYLE, [ FORMAT ] ] )
+
+=item Optional Exports
+
+clearcache ( COUNT ), clearallcache ( ), disablecache ( ), enablecache ( )
+
+=back
+
+=item NOTES
+
+=item INHERITANCE
+
+=item CAVEATS
+
+=item AUTHORS
+
+=item MODIFICATION HISTORY
+
+=head2 CGI - Simple Common Gateway Interface Class
+
+=item SYNOPSIS
+
+=item ABSTRACT
+
+=item DESCRIPTION
+
+=over
+
+=item PROGRAMMING STYLE
+
+=item CALLING CGI.PM ROUTINES
+
+1. Use another name for the argument, if one is available.  Forexample,
+-value is an alias for -values, 2. Change the capitalization, e.g. -Values,
+3. Put quotes around the argument name, e.g. '-values'
+
+=item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
+
+=item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
+
+=item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
+
+=item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
+
+=item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
+
+=item SETTING THE VALUE(S) OF A NAMED PARAMETER:
+
+=item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
+
+=item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
+
+=item DELETING A PARAMETER COMPLETELY:
+
+=item DELETING ALL PARAMETERS:
+
+=item DIRECT ACCESS TO THE PARAMETER LIST:
+
+=item SAVING THE STATE OF THE SCRIPT TO A FILE:
+
+=item USING THE FUNCTION-ORIENTED INTERFACE
+
+B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:netscape>, B<:html>,
+B<:standard>, B<:all>
+
+=item PRAGMAS
+
+-any, -compile, -nph, -autoload, -no_debug, -private_tempfiles
+
+=back
+
+=item GENERATING DYNAMIC DOCUMENTS
+
+=over
+
+=item CREATING A STANDARD HTTP HEADER:
+
+=item GENERATING A REDIRECTION HEADER
+
+=item CREATING THE HTML DOCUMENT HEADER
+
+B<Parameters:>, 4, 5, 6..
+
+=item ENDING THE HTML DOCUMENT:
+
+=item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
+
+=item OBTAINING THE SCRIPT'S URL
+
+B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
+(B<-query_string>)
+
+=back
+
+=item CREATING STANDARD HTML ELEMENTS:
+
+=over
+
+=item PROVIDING ARGUMENTS TO HTML SHORTCUTS
+
+=item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
+
+=item HTML SHORTCUTS AND LIST INTERPOLATION
+
+=item NON-STANDARD HTML SHORTCUTS
+
+=back
+
+=item CREATING FILL-OUT FORMS:
+
+=over
+
+=item CREATING AN ISINDEX TAG
+
+=item STARTING AND ENDING A FORM
+
+B<application/x-www-form-urlencoded>, B<multipart/form-data>
+
+=item CREATING A TEXT FIELD
+
+B<Parameters>
+
+=item CREATING A BIG TEXT FIELD
+
+=item CREATING A PASSWORD FIELD
+
+=item CREATING A FILE UPLOAD FIELD
+
+B<Parameters>
+
+=item CREATING A POPUP MENU
+
+=item CREATING A SCROLLING LIST
+
+B<Parameters:>
+
+=item CREATING A GROUP OF RELATED CHECKBOXES
 
 B<Parameters:>
 
@@ -3024,26 +3672,22 @@ scripts, B<referer()>, B<auth_type ()>, B<server_name ()>, B<virtual_host
 ()>, B<server_software ()>, B<remote_user ()>, B<user_name ()>,
 B<request_method()>
 
-=item CREATING HTML ELEMENTS
-
-=over
-
-=item PROVIDING ARGUMENTS TO HTML SHORTCUTS
+=item USING NPH SCRIPTS
 
-=item Generating new HTML tags
+In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
+parameters in the B<header()> and B<redirect()>  statements:
 
-=back
+=item Server Push
 
-=item IMPORTING CGI METHOD CALLS INTO YOUR NAME SPACE
+multipart_init()     
+multipart_init(-boundary=>$boundary);, multipart_start(), multipart_end()
 
-B<cgi>, B<form>, B<html2>, B<html3>, B<netscape>, B<shortcuts>,
-B<standard>, B<all>
+=item Avoiding Denial of Service Attacks
 
-=item USING NPH SCRIPTS
+B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
+basis>, B<2. Globally for all scripts>
 
-In the B<use> statementSimply add ":nph" to the list of symbols to be
-imported into your script:, By calling the B<nph()> method:, By using
-B<-nph> parameters in the B<header()> and B<redirect()>  statements:
+=item COMPATIBILITY WITH CGI-LIB.PL
 
 =item AUTHOR INFORMATION
 
@@ -3059,7 +3703,8 @@ Christiansen (tchrist@convex.com), Andreas Koenig
 (k@franz.ww.TU-Berlin.DE), Tim MacKenzie (Tim.MacKenzie@fulcrum.com.au),
 Kevin B. Hendricks (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen
 (joyfire@inxpress.net), Ed Jordan (ed@fidalgo.net), David Alan Pisoni
-(david@cnation.com), ...and many many more..
+(david@cnation.com), Doug MacEachern (dougm@opengroup.org), Robin Houston
+(robin@oneworld.org), ...and many many more..
 
 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
 
@@ -3092,12 +3737,48 @@ other) error log
 
 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
 
+=over
+
+=item Changing the default message
+
+=back
+
 =item CHANGE LOG
 
 =item AUTHORS
 
 =item SEE ALSO
 
+=head2 CGI::Cookie - Interface to Netscape Cookies
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item USING CGI::Cookie
+
+B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
+
+=over
+
+=item Creating New Cookies
+
+=item Sending the Cookie to the Browser
+
+=item Recovering Previous Cookies
+
+=item Manipulating Cookies
+
+B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
+
+=back
+
+=item AUTHOR INFORMATION
+
+=item BUGS
+
+=item SEE ALSO
+
 =head2 CGI::Fast - CGI Interface for Fast CGI
 
 =item SYNOPSIS
@@ -3130,6 +3811,14 @@ other) error log
 
 -next_page, -last_page, -type, -delay, -cookie, -target, -expires
 
+=over
+
+=item Heterogeneous Pages
+
+=item Changing the Page Delay on the Fly
+
+=back
+
 =item INSTALLING CGI::Push SCRIPTS
 
 =item CAVEATS
@@ -3163,7 +3852,7 @@ object available
 
 Searching for authors, bundles, distribution files and modules, make, test,
 install, clean modules or distributions, readme, look module or
-distribution
+distribution, Signals
 
 =item CPAN::Shell
 
@@ -3185,6 +3874,8 @@ expand($type,@things), Programming Examples
 
 =item Prerequisites
 
+=item Finding packages and VERSION
+
 =item Debugging
 
 =item Floppy, Zip, and all that Jazz
@@ -3376,6 +4067,57 @@ $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
 
 =item AUTHOR
 
+=head2 Data::Dumper - stringified perl data structures, suitable for both
+printing and C<eval>
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over
+
+=item Methods
+
+I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or>
+I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dumpxs I<or>
+I<PACKAGE>->Dumpxs(I<ARRAYREF [>, I<ARRAYREF]>),
+I<$OBJ>->Seen(I<[HASHREF]>), I<$OBJ>->Values(I<[ARRAYREF]>),
+I<$OBJ>->Names(I<[ARRAYREF]>), I<$OBJ>->Reset
+
+=item Functions
+
+Dumper(I<LIST>), DumperX(I<LIST>)
+
+=item Configuration Variables or Methods
+
+$Data::Dumper::Indent  I<or>  I<$OBJ>->Indent(I<[NEWVAL]>),
+$Data::Dumper::Purity  I<or>  I<$OBJ>->Purity(I<[NEWVAL]>),
+$Data::Dumper::Pad  I<or>  I<$OBJ>->Pad(I<[NEWVAL]>),
+$Data::Dumper::Varname I<or>  I<$OBJ>->Varname(I<[NEWVAL]>),
+$Data::Dumper::Useqq  I<or>  I<$OBJ>->Useqq(I<[NEWVAL]>),
+$Data::Dumper::Terse  I<or>  I<$OBJ>->Terse(I<[NEWVAL]>),
+$Data::Dumper::Freezer I<or>  $I<OBJ>->Freezer(I<[NEWVAL]>),
+$Data::Dumper::Toaster I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
+$Data::Dumper::Deepcopy  I<or> $I<OBJ>->Deepcopy(I<[NEWVAL]>),
+$Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
+$Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>)
+
+=item Exports
+
+Dumper
+
+=back
+
+=item EXAMPLES
+
+=item BUGS
+
+=item AUTHOR
+
+=item VERSION
+
+=item SEE ALSO
+
 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
 
 =item SYNOPSIS
@@ -3480,6 +4222,8 @@ ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
 new(), modules(), files(), directories(), directory_tree(), validate(),
 packlist(), version()
 
+=item EXAMPLE
+
 =item AUTHOR
 
 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
@@ -3546,10 +4290,11 @@ extliblist, file_name_is_absolute, find_perl
 fixin, force (o), guess_name, has_link_code, init_dirscan, init_main,
 init_others, install (o), installbin (o), libscan (o), linkext (o), lsdir,
 macro (o), makeaperl (o), makefile (o), manifypods (o), maybe_command,
-maybe_command_in_dirs, needs_linking (o), nicetext, parse_version, pasthru
-(o), path, perl_script, perldepend (o), pm_to_blib, post_constants (o),
-post_initialize (o), postamble (o), prefixify, processPL (o), realclean
-(o), replace_manpage_separator, static (o), static_lib (o), staticmake (o),
+maybe_command_in_dirs, needs_linking (o), nicetext, parse_version,
+parse_abstract, pasthru (o), path, perl_script, perldepend (o), ppd,
+perm_rw (o), perm_rwx (o), pm_to_blib, post_constants (o), post_initialize
+(o), postamble (o), prefixify, processPL (o), realclean (o),
+replace_manpage_separator, static (o), static_lib (o), staticmake (o),
 subdir_x (o), subdirs (o), test (o), test_via_harness (o), test_via_script
 (o), tool_autosplit (o), tools_other (o), tool_xsubpp (o), top_targets (o),
 writedoc, xs_c (o), xs_o (o), perl_archive, export_list
@@ -3642,9 +4387,9 @@ INSTALLSITEARCH, INST_ARCHLIB, INST_BIN, INST_EXE, INST_LIB, INST_MAN1DIR,
 INST_MAN3DIR, INST_SCRIPT, LDFROM, LIBPERL_A, LIB, LIBS, LINKTYPE,
 MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME,
 NEEDS_LINKING, NOECHO, NORECURS, OBJECT, OPTIMIZE, PERL, PERLMAINCC,
-PERL_ARCHLIB, PERL_LIB, PERL_SRC, PL_FILES, PM, PMLIBDIRS, PREFIX,
-PREREQ_PM, SKIP, TYPEMAPS, VERSION, VERSION_FROM, XS, XSOPT, XSPROTOARG,
-XS_VERSION
+PERL_ARCHLIB, PERL_LIB, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM,
+PMLIBDIRS, PREFIX, PREREQ_PM, SKIP, TYPEMAPS, VERSION, VERSION_FROM, XS,
+XSOPT, XSPROTOARG, XS_VERSION
 
 =item Additional lowercase attributes
 
@@ -3721,6 +4466,8 @@ NAME, DL_FUNCS, DL_VARS, FILE, FUNCLIST, DLBASE
 
 new(), read(), write(), validate(), packlist_file()
 
+=item EXAMPLE
+
 =item AUTHOR
 
 =head2 ExtUtils::testlib - add blib/* directories to @INC
@@ -3827,6 +4574,71 @@ rmscopy($from,$to[,$date_flag])
 
 =item REVISION
 
+=head2 File::Spec - portably perform operations on file names
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=item AUTHORS
+
+=head2 File::Spec::Mac - File::Spec for MacOS
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item METHODS
+
+canonpath, catdir, catfile, curdir, rootdir, updir, file_name_is_absolute,
+path
+
+=item SEE ALSO
+
+=head2 File::Spec::OS2 - methods for OS/2 file specs
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=head2 File::Spec::Unix - methods used by File::Spec
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item METHODS
+
+canonpath, catdir, catfile, curdir, rootdir, updir, no_upwards,
+file_name_is_absolute, path, join, nativename
+
+=item SEE ALSO
+
+=head2 File::Spec::VMS - methods for VMS file specs
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over
+
+=item Methods always loaded
+
+catdir, catfile, curdir (override), rootdir (override), updir (override),
+path (override), file_name_is_absolute (override)
+
+=back
+
+=head2 File::Spec::Win32 - methods for Win32 file specs
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+catfile, canonpath
+
 =head2 File::stat - by-name interface to Perl's built-in stat() functions
 
 =item SYNOPSIS
@@ -4102,6 +4914,58 @@ handling
 
 =item WARNING
 
+=head2 IPC::SysV - SysV IPC constants
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+ftok( PATH, ID )
+
+=item SEE ALSO
+
+=item AUTHORS
+
+=item COPYRIGHT
+
+=head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item METHODS
+
+new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
+( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
+FLAGS ] ), stat
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
+class
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item METHODS
+
+new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
+getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
+set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
+, VALUE ), stat
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
 =head2 Math::BigFloat - Arbitrary length float math package
 
 =item SYNOPSIS
@@ -4124,6 +4988,8 @@ Canonical notation, Input, Output
 
 =item EXAMPLES
 
+=item Autocreating constants
+
 =item BUGS
 
 =item AUTHOR
@@ -4159,6 +5025,8 @@ functions
 
 =item TRIGONOMETRIC FUNCTIONS
 
+B<tan>
+
 =over
 
 =item ERRORS DUE TO DIVISION BY ZERO
@@ -4167,7 +5035,24 @@ functions
 
 =back
 
-=item ANGLE CONVERSIONS
+=item PLANE ANGLE CONVERSIONS
+
+=item RADIAL COORDINATE CONVERSIONS
+
+=over
+
+=item COORDINATE SYSTEMS
+
+=item 3-D ANGLE CONVERSIONS
+
+cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
+cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
+
+=back
+
+=item GREAT CIRCLE DISTANCES
+
+=item EXAMPLES
 
 =item BUGS
 
@@ -4573,15 +5458,8 @@ interface to the UNIX syslog(3) calls
 =item DESCRIPTION
 
 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
-setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_03) 
-Sets the socket type to be used for the next call to
-C<openlog()> or C<syslog()>.
-
-A value of 'unix' will connect to the UNIX domain socket returned by
-C<_PATH_LOG> in F<syslog.ph>. If F<syslog.ph> fails to define
-C<_PATH_LOG>, C<setlogsock> returns C<undef>; otherwise a true value is
-returned. A value of 'inet' will connect to an INET socket returned by
-getservbyname().  Any other value croaks, closelog
+setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
+closelog
 
 =item EXAMPLES
 
@@ -4670,6 +5548,8 @@ C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
 %s>
 
+=item ENVIRONMENT
+
 =item SEE ALSO
 
 =item AUTHORS
index 7ad153c..f17e959 100644 (file)
@@ -26,6 +26,7 @@ POD = \
        perlsub.pod     \
        perlmod.pod     \
        perlmodlib.pod  \
+       perlmodinstall.pod      \
        perlform.pod    \
        perllocale.pod  \
        perlref.pod     \
@@ -40,11 +41,13 @@ POD = \
        perldiag.pod    \
        perlsec.pod     \
        perltrap.pod    \
+       perlport.pod    \
        perlstyle.pod   \
        perlpod.pod     \
        perlbook.pod    \
        perlembed.pod   \
        perlapio.pod    \
+       perlwin32.pod   \
        perlxs.pod      \
        perlxstut.pod   \
        perlguts.pod    \
@@ -74,6 +77,7 @@ MAN = \
        perlsub.man     \
        perlmod.man     \
        perlmodlib.man  \
+       perlmodinstall.man      \
        perlform.man    \
        perllocale.man  \
        perlref.man     \
@@ -88,11 +92,13 @@ MAN = \
        perldiag.man    \
        perlsec.man     \
        perltrap.man    \
+       perlport.man    \
        perlstyle.man   \
        perlpod.man     \
        perlbook.man    \
        perlembed.man   \
        perlapio.man    \
+       perlwin32.man   \
        perlxs.man      \
        perlxstut.man   \
        perlguts.man    \
@@ -122,6 +128,7 @@ HTML = \
        perlsub.html    \
        perlmod.html    \
        perlmodlib.html \
+       perlmodinstall.html     \
        perlform.html   \
        perllocale.html \
        perlref.html    \
@@ -136,11 +143,13 @@ HTML = \
        perldiag.html   \
        perlsec.html    \
        perltrap.html   \
+       perlport.html   \
        perlstyle.html  \
        perlpod.html    \
        perlbook.html   \
        perlembed.html  \
        perlapio.html   \
+       perlwin32.html  \
        perlxs.html     \
        perlxstut.html  \
        perlguts.html   \
@@ -170,6 +179,7 @@ TEX = \
        perlsub.tex     \
        perlmod.tex     \
        perlmodlib.tex  \
+       perlmodinstall.tex      \
        perlform.tex    \
        perllocale.tex  \
        perlref.tex     \
@@ -184,11 +194,13 @@ TEX = \
        perldiag.tex    \
        perlsec.tex     \
        perltrap.tex    \
+       perlport.tex    \
        perlstyle.tex   \
        perlpod.tex     \
        perlbook.tex    \
        perlembed.tex   \
        perlapio.tex    \
+       perlwin32.tex   \
        perlxs.tex      \
        perlxstut.tex   \
        perlguts.tex    \