This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
PATCH: pod/perlutil.pod - utilities packaged with the Perl distribution
authorSimon Cozens <simon@netthink.co.uk>
Mon, 19 Jun 2000 15:18:27 +0000 (15:18 +0000)
committerJarkko Hietaniemi <jhi@iki.fi>
Fri, 23 Jun 2000 16:10:02 +0000 (16:10 +0000)
Message-ID: <slrn8ksee3.cp9.simon@justanother.perlhacker.org>

plus update pod/Makefile and regenerate perltoc

p4raw-id: //depot/cfgperl@6232

MANIFEST
Todo-5.6
pod/Makefile
pod/perltoc.pod
pod/perlutil.pod [new file with mode: 0644]
pod/roffitall

index 2681a11..b21da7d 100644 (file)
--- a/MANIFEST
+++ b/MANIFEST
@@ -1190,6 +1190,7 @@ pod/perltoot.pod  Tom's object-oriented tutorial
 pod/perltootc.pod      Tom's object-oriented tutorial (more on class data)
 pod/perltrap.pod       Trap info
 pod/perlunicode.pod    Unicode support info
+pod/perlutil.pod       Accompanying utilities explained
 pod/perlvar.pod                Variable info
 pod/perlxs.pod         XS api info
 pod/perlxstut.pod      XS tutorial
index a94df37..04b5fe0 100644 (file)
--- a/Todo-5.6
+++ b/Todo-5.6
@@ -170,3 +170,5 @@ Documentation
     spot-check all new modules for completeness
     better docs for pack()/unpack()
     reorg tutorials vs. reference sections
+    make roffitall to be dynamical about its pods and libs
+
index 5f6c40c..a6f4efb 100644 (file)
@@ -16,60 +16,24 @@ REALPERL = ../perl
 
 POD = \
        perl.pod        \
-       perldelta.pod   \
        perl5004delta.pod       \
        perl5005delta.pod       \
-       perldata.pod    \
-       perlsyn.pod     \
-       perlop.pod      \
-       perlre.pod      \
-       perlrun.pod     \
-       perlfunc.pod    \
-       perlopentut.pod \
-       perlvar.pod     \
-       perlsub.pod     \
-       perlmod.pod     \
-       perlmodlib.pod  \
-       perlmodinstall.pod      \
-       perlnewmod.pod  \
-       perlfork.pod    \
-       perlform.pod    \
-       perllocale.pod  \
-       perlref.pod     \
-       perlreftut.pod  \
-       perldsc.pod     \
-       perllol.pod     \
+       perl56delta.pod \
+       perlapi.pod     \
+       perlapio.pod    \
+       perlbook.pod    \
        perlboot.pod    \
-       perltoot.pod    \
-       perltootc.pod   \
-       perlobj.pod     \
-       perltie.pod     \
        perlbot.pod     \
-       perlipc.pod     \
-       perlthrtut.pod  \
+       perlcall.pod    \
+       perlcompile.pod \
+       perldata.pod    \
        perldbmfilter.pod       \
        perldebguts.pod \
        perldebug.pod   \
-       perlnumber.pod  \
+       perldelta.pod   \
        perldiag.pod    \
-       perlsec.pod     \
-       perltrap.pod    \
-       perlport.pod    \
-       perlstyle.pod   \
-       perlpod.pod     \
-       perlbook.pod    \
+       perldsc.pod     \
        perlembed.pod   \
-       perlapio.pod    \
-       perlxs.pod      \
-       perlxstut.pod   \
-       perlguts.pod    \
-       perlcall.pod    \
-       perlcompile.pod \
-       perltodo.pod    \
-       perlapi.pod     \
-       perlintern.pod  \
-       perlhack.pod    \
-       perlhist.pod    \
        perlfaq.pod     \
        perlfaq1.pod    \
        perlfaq2.pod    \
@@ -80,64 +44,71 @@ POD = \
        perlfaq7.pod    \
        perlfaq8.pod    \
        perlfaq9.pod    \
-       perltoc.pod
+       perlfilter.pod  \
+       perlfork.pod    \
+       perlform.pod    \
+       perlfunc.pod    \
+       perlguts.pod    \
+       perlhack.pod    \
+       perlhist.pod    \
+       perlintern.pod  \
+       perlipc.pod     \
+       perllexwarn.pod \
+       perllocale.pod  \
+       perllol.pod     \
+       perlmod.pod     \
+       perlmodinstall.pod      \
+       perlmodlib.pod  \
+       perlnewmod.pod  \
+       perlnumber.pod  \
+       perlobj.pod     \
+       perlop.pod      \
+       perlopentut.pod \
+       perlpod.pod     \
+       perlport.pod    \
+       perlre.pod      \
+       perlref.pod     \
+       perlreftut.pod  \
+       perlrequick.pod \
+       perlretut.pod   \
+       perlrun.pod     \
+       perlsec.pod     \
+       perlstyle.pod   \
+       perlsub.pod     \
+       perlsyn.pod     \
+       perlthrtut.pod  \
+       perltie.pod     \
+       perltoc.pod     \
+       perltodo.pod    \
+       perltoot.pod    \
+       perltootc.pod   \
+       perltrap.pod    \
+       perlunicode.pod \
+       perlutil.pod    \
+       perlvar.pod     \
+       perlxs.pod      \
+       perlxstut.pod
 
 MAN = \
        perl.man        \
-       perldelta.man   \
        perl5004delta.man       \
        perl5005delta.man       \
-       perldata.man    \
-       perlsyn.man     \
-       perlop.man      \
-       perlre.man      \
-       perlrun.man     \
-       perlfunc.man    \
-       perlopentut.man \
-       perlvar.man     \
-       perlsub.man     \
-       perlmod.man     \
-       perlmodlib.man  \
-       perlmodinstall.man      \
-       perlnewmod.man  \
-       perlfork.man    \
-       perlform.man    \
-       perllocale.man  \
-       perlref.man     \
-       perlreftut.man  \
-       perldsc.man     \
-       perllol.man     \
+       perl56delta.man \
+       perlapi.man     \
+       perlapio.man    \
+       perlbook.man    \
        perlboot.man    \
-       perltoot.man    \
-       perltootc.man   \
-       perlobj.man     \
-       perltie.man     \
        perlbot.man     \
-       perlipc.man     \
-       perlthrtut.man  \
+       perlcall.man    \
+       perlcompile.man \
+       perldata.man    \
        perldbmfilter.man       \
        perldebguts.man \
        perldebug.man   \
-       perlnumber.man  \
+       perldelta.man   \
        perldiag.man    \
-       perlsec.man     \
-       perltrap.man    \
-       perlport.man    \
-       perlstyle.man   \
-       perlpod.man     \
-       perlbook.man    \
+       perldsc.man     \
        perlembed.man   \
-       perlapio.man    \
-       perlxs.man      \
-       perlxstut.man   \
-       perlguts.man    \
-       perlcall.man    \
-       perlcompile.man \
-       perltodo.man    \
-       perlapi.man     \
-       perlintern.man  \
-       perlhack.man    \
-       perlhist.man    \
        perlfaq.man     \
        perlfaq1.man    \
        perlfaq2.man    \
@@ -148,64 +119,71 @@ MAN = \
        perlfaq7.man    \
        perlfaq8.man    \
        perlfaq9.man    \
-       perltoc.man
+       perlfilter.man  \
+       perlfork.man    \
+       perlform.man    \
+       perlfunc.man    \
+       perlguts.man    \
+       perlhack.man    \
+       perlhist.man    \
+       perlintern.man  \
+       perlipc.man     \
+       perllexwarn.man \
+       perllocale.man  \
+       perllol.man     \
+       perlmod.man     \
+       perlmodinstall.man      \
+       perlmodlib.man  \
+       perlnewmod.man  \
+       perlnumber.man  \
+       perlobj.man     \
+       perlop.man      \
+       perlopentut.man \
+       perlpod.man     \
+       perlport.man    \
+       perlre.man      \
+       perlref.man     \
+       perlreftut.man  \
+       perlrequick.man \
+       perlretut.man   \
+       perlrun.man     \
+       perlsec.man     \
+       perlstyle.man   \
+       perlsub.man     \
+       perlsyn.man     \
+       perlthrtut.man  \
+       perltie.man     \
+       perltoc.man     \
+       perltodo.man    \
+       perltoot.man    \
+       perltootc.man   \
+       perltrap.man    \
+       perlunicode.man \
+       perlutil.man    \
+       perlvar.man     \
+       perlxs.man      \
+       perlxstut.man
 
 HTML = \
        perl.html       \
-       perldelta.html  \
        perl5004delta.html      \
        perl5005delta.html      \
-       perldata.html   \
-       perlsyn.html    \
-       perlop.html     \
-       perlre.html     \
-       perlrun.html    \
-       perlfunc.html   \
-       perlopentut.html        \
-       perlvar.html    \
-       perlsub.html    \
-       perlmod.html    \
-       perlmodlib.html \
-       perlmodinstall.html     \
-       perlnewmod.html \
-       perlfork.html   \
-       perlform.html   \
-       perllocale.html \
-       perlref.html    \
-       perlreftut.html \
-       perldsc.html    \
-       perllol.html    \
+       perl56delta.html        \
+       perlapi.html    \
+       perlapio.html   \
+       perlbook.html   \
        perlboot.html   \
-       perltoot.html   \
-       perltootc.html  \
-       perlobj.html    \
-       perltie.html    \
        perlbot.html    \
-       perlipc.html    \
-       perlthrtut.html \
+       perlcall.html   \
+       perlcompile.html        \
+       perldata.html   \
        perldbmfilter.html      \
        perldebguts.html        \
        perldebug.html  \
-       perlnumber.html \
+       perldelta.html  \
        perldiag.html   \
-       perlsec.html    \
-       perltrap.html   \
-       perlport.html   \
-       perlstyle.html  \
-       perlpod.html    \
-       perlbook.html   \
+       perldsc.html    \
        perlembed.html  \
-       perlapio.html   \
-       perlxs.html     \
-       perlxstut.html  \
-       perlguts.html   \
-       perlcall.html   \
-       perlcompile.html        \
-       perltodo.html   \
-       perlapi.html    \
-       perlintern.html \
-       perlhack.html   \
-       perlhist.html   \
        perlfaq.html    \
        perlfaq1.html   \
        perlfaq2.html   \
@@ -215,65 +193,73 @@ HTML = \
        perlfaq6.html   \
        perlfaq7.html   \
        perlfaq8.html   \
-       perlfaq9.html
+       perlfaq9.html   \
+       perlfilter.html \
+       perlfork.html   \
+       perlform.html   \
+       perlfunc.html   \
+       perlguts.html   \
+       perlhack.html   \
+       perlhist.html   \
+       perlintern.html \
+       perlipc.html    \
+       perllexwarn.html        \
+       perllocale.html \
+       perllol.html    \
+       perlmod.html    \
+       perlmodinstall.html     \
+       perlmodlib.html \
+       perlnewmod.html \
+       perlnumber.html \
+       perlobj.html    \
+       perlop.html     \
+       perlopentut.html        \
+       perlpod.html    \
+       perlport.html   \
+       perlre.html     \
+       perlref.html    \
+       perlreftut.html \
+       perlrequick.html        \
+       perlretut.html  \
+       perlrun.html    \
+       perlsec.html    \
+       perlstyle.html  \
+       perlsub.html    \
+       perlsyn.html    \
+       perlthrtut.html \
+       perltie.html    \
+       perltodo.html   \
+       perltoot.html   \
+       perltootc.html  \
+       perltrap.html   \
+       perlunicode.html        \
+       perlutil.html   \
+       perlvar.html    \
+       perlxs.html     \
+       perlxstut.html
+
 # not perltoc.html
 
 TEX = \
        perl.tex        \
-       perldelta.tex   \
        perl5004delta.tex       \
        perl5005delta.tex       \
-       perldata.tex    \
-       perlsyn.tex     \
-       perlop.tex      \
-       perlre.tex      \
-       perlrun.tex     \
-       perlfunc.tex    \
-       perlopentut.tex \
-       perlvar.tex     \
-       perlsub.tex     \
-       perlmod.tex     \
-       perlmodlib.tex  \
-       perlmodinstall.tex      \
-       perlnewmod.tex  \
-       perlfork.tex    \
-       perlform.tex    \
-       perllocale.tex  \
-       perlref.tex     \
-       perlreftut.tex  \
-       perldsc.tex     \
-       perllol.tex     \
+       perl56delta.tex \
+       perlapi.tex     \
+       perlapio.tex    \
+       perlbook.tex    \
        perlboot.tex    \
-       perltoot.tex    \
-       perltootc.tex   \
-       perlobj.tex     \
-       perltie.tex     \
        perlbot.tex     \
-       perlipc.tex     \
-       perlthrtut.tex  \
+       perlcall.tex    \
+       perlcompile.tex \
+       perldata.tex    \
        perldbmfilter.tex       \
        perldebguts.tex \
        perldebug.tex   \
-       perlnumber.tex  \
+       perldelta.tex   \
        perldiag.tex    \
-       perlsec.tex     \
-       perltrap.tex    \
-       perlport.tex    \
-       perlstyle.tex   \
-       perlpod.tex     \
-       perlbook.tex    \
+       perldsc.tex     \
        perlembed.tex   \
-       perlapio.tex    \
-       perlxs.tex      \
-       perlxstut.tex   \
-       perlguts.tex    \
-       perlcall.tex    \
-       perlcompile.tex \
-       perltodo.tex    \
-       perlapi.tex     \
-       perlintern.tex  \
-       perlhack.tex    \
-       perlhist.tex    \
        perlfaq.tex     \
        perlfaq1.tex    \
        perlfaq2.tex    \
@@ -284,7 +270,50 @@ TEX = \
        perlfaq7.tex    \
        perlfaq8.tex    \
        perlfaq9.tex    \
-       perltoc.tex
+       perlfilter.tex  \
+       perlfork.tex    \
+       perlform.tex    \
+       perlfunc.tex    \
+       perlguts.tex    \
+       perlhack.tex    \
+       perlhist.tex    \
+       perlintern.tex  \
+       perlipc.tex     \
+       perllexwarn.tex \
+       perllocale.tex  \
+       perllol.tex     \
+       perlmod.tex     \
+       perlmodinstall.tex      \
+       perlmodlib.tex  \
+       perlnewmod.tex  \
+       perlnumber.tex  \
+       perlobj.tex     \
+       perlop.tex      \
+       perlopentut.tex \
+       perlpod.tex     \
+       perlport.tex    \
+       perlre.tex      \
+       perlref.tex     \
+       perlreftut.tex  \
+       perlrequick.tex \
+       perlretut.tex   \
+       perlrun.tex     \
+       perlsec.tex     \
+       perlstyle.tex   \
+       perlsub.tex     \
+       perlsyn.tex     \
+       perlthrtut.tex  \
+       perltie.tex     \
+       perltoc.tex     \
+       perltodo.tex    \
+       perltoot.tex    \
+       perltootc.tex   \
+       perltrap.tex    \
+       perlunicode.tex \
+       perlutil.tex    \
+       perlvar.tex     \
+       perlxs.tex      \
+       perlxstut.tex
 
 man:   pod2man $(MAN)
 
index 1b111cb..5768081 100644 (file)
@@ -1647,8 +1647,8 @@ unary &, unary *, (TYPE)
 
 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
-s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cdsUC,
-y/SEARCHLIST/REPLACEMENTLIST/cdsUC
+s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
+y/SEARCHLIST/REPLACEMENTLIST/cds
 
 =item Gory details of parsing quoted constructs
 
@@ -2746,8 +2746,6 @@ LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, DESTROY this
 
 =item INSTANCE VARIABLES
 
-=item SCALAR INSTANCE VARIABLES
-
 =item INSTANCE VARIABLE INHERITANCE
 
 =item OBJECT RELATIONSHIPS
@@ -3075,7 +3073,7 @@ Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
 
 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
-Discontinuance, Deprecation, Discontinuance
+Discontinuance, Deprecation, Discontinuance, Discontinuance
 
 =item Parsing Traps
 
@@ -3837,26 +3835,26 @@ PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew, Renewc,
 require_pv, RETVAL, Safefree, savepv, savepvn, SAVETMPS, SP, SPAGAIN, ST,
 strEQ, strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, StructCopy,
 SvCUR, SvCUR_set, SvEND, SvGETMAGIC, SvGROW, SvIOK, SvIOKp, SvIOK_off,
-SvIOK_on, SvIOK_only, SvIV, SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off,
-SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX, SvOK, SvOOK,
-SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only, SvPV, SvPVX, SvPV_force,
-SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off,
-SvROK_on, SvRV, SvSETMAGIC, SvSetSV, SvSetSV_nosteal, SvSTASH, SvTAINT,
-SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, svtype, SVt_IV,
-SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUPGRADE, SvUV,
-SvUVX, sv_2mortal, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn,
-sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_mg, sv_chop, sv_cmp, sv_dec,
-sv_derived_from, sv_eq, sv_grow, sv_inc, sv_insert, sv_isa, sv_isobject,
-sv_len, sv_magic, sv_mortalcopy, sv_newmortal, sv_setiv, sv_setiv_mg,
-sv_setnv, sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv,
-sv_setpviv_mg, sv_setpvn, sv_setpvn_mg, sv_setpv_mg, sv_setref_iv,
-sv_setref_nv, sv_setref_pv, sv_setref_pvn, sv_setsv, sv_setsv_mg, sv_setuv,
-sv_setuv_mg, sv_unref, sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_vcatpvfn,
-sv_vsetpvfn, THIS, toLOWER, toUPPER, warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs,
-XPUSHu, XS, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO,
-XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNO,
-XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK,
-Zero
+SvIOK_on, SvIOK_only, SvIV, SvIVX, SvLEN, SvLOCK, SvNIOK, SvNIOKp,
+SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX,
+SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only, SvPV, SvPVX,
+SvPV_force, SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK,
+SvROK_off, SvROK_on, SvRV, SvSETMAGIC, SvSetSV, SvSetSV_nosteal, SvSTASH,
+SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, svtype,
+SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUNLOCK,
+SvUPGRADE, SvUV, SvUVX, sv_2mortal, sv_bless, sv_catpv, sv_catpvf,
+sv_catpvf_mg, sv_catpvn, sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_mg,
+sv_chop, sv_cmp, sv_dec, sv_derived_from, sv_eq, sv_grow, sv_inc,
+sv_insert, sv_isa, sv_isobject, sv_len, sv_magic, sv_mortalcopy,
+sv_newmortal, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv,
+sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn,
+sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv,
+sv_setref_pvn, sv_setsv, sv_setsv_mg, sv_setuv, sv_setuv_mg, sv_unref,
+sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_vcatpvfn, sv_vsetpvfn, THIS,
+toLOWER, toUPPER, warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XS,
+XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, XSRETURN_NV,
+XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV,
+XST_mPV, XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK, Zero
 
 =item AUTHORS
 
@@ -3977,18 +3975,6 @@ FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
 
 =back
 
-=head2 attrs - set/get attributes of a subroutine (deprecated)
-
-=over
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-method, locked
-
-=back
-
 =head2 autouse - postpone load of modules until a function is used
 
 =over
@@ -4208,18 +4194,6 @@ operations
 
 =back
 
-=head2 ops - Perl pragma to restrict unsafe operations when compiling
-
-=over
-
-=item SYNOPSIS 
-
-=item DESCRIPTION
-
-=item SEE ALSO
-
-=back
-
 =head2 overload - Package for overloading perl operations
 
 =over
@@ -4316,6 +4290,22 @@ integer, float, binary, q, qr
 
 =back
 
+=head2 pwent - Perl pragma to control the pwent functions
+
+=over
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over
+
+=item subpragma shadow_password
+
+=back
+
+=back
+
 =head2 re - Perl pragma to alter regular expression behaviour
 
 =over
@@ -4636,7 +4626,7 @@ bytecode
 
 =item DESCRIPTION
 
-=item AUTHOR
+=item AUTHORS
 
 =back
 
@@ -4663,14 +4653,15 @@ bytecode
 =item OPTIONS
 
 B<-ofilename>, B<-afilename>, 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>
+B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
+B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-Ppackage>    Stores package in the
+output.    =back
 
 =item EXAMPLES
 
 =item BUGS
 
-=item AUTHOR
+=item AUTHORS
 
 =back
 
@@ -4962,14 +4953,15 @@ STYLE ] ), cmpthese ( RESULTSHASHREF ), countit(TIME, CODE), disablecache (
 =item OPTIONS
 
 B<-ofilename>, B<-afilename>, 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>
+B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
+B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-Ppackage>    Stores package in the
+output.    =back
 
 =item EXAMPLES
 
 =item BUGS
 
-=item AUTHOR
+=item AUTHORS
 
 =back
 
@@ -5611,58 +5603,58 @@ C<d_fcntl>, C<d_fd_macros>, C<d_fd_set>, C<d_fds_bits>, C<d_fgetpos>,
 C<d_flexfnam>, C<d_flock>, C<d_fork>, C<d_fpathconf>, C<d_fpos64_t>,
 C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>,
 C<d_fstatvfs>, C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>,
-C<d_getfsstat>, C<d_getgrent>, C<d_getgrps>, C<d_gethbyaddr>,
-C<d_gethbyname>, C<d_gethent>, C<d_gethname>, C<d_gethostprotos>,
-C<d_getlogin>, C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>,
-C<d_getnbyname>, C<d_getnent>, C<d_getnetprotos>, C<d_getpbyname>,
-C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>,
-C<d_getppid>, C<d_getprior>, C<d_getprotoprotos>, C<d_getpwent>,
-C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>, C<d_getservprotos>,
-C<d_getspnam>, C<d_gettimeod>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
-C<d_htonl>, C<d_iconv>, C<d_index>, C<d_inetaton>, C<d_int64_t>,
-C<d_isascii>, C<d_isnan>, C<d_isnanl>, C<d_killpg>, C<d_lchown>,
-C<d_ldbl_dig>, C<d_link>, C<d_locconv>, C<d_lockf>, C<d_longdbl>,
-C<d_longlong>, C<d_lseekproto>, C<d_lstat>, C<d_madvise>, C<d_mblen>,
-C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>, C<d_memcpy>,
-C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>,
-C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>, C<d_modfl>,
-C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>,
-C<d_msg_peek>, C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msgrcv>,
-C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>,
-C<d_nv_preserved_bits>, C<d_nv_preserves_uv>, C<d_off64_t>,
-C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
-C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
-C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
-C<d_PRIeldbl>, C<d_PRIEldbl>, C<d_PRIfldbl>, C<d_PRIFldbl>, C<d_PRIgldbl>,
-C<d_PRIGldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>, C<d_PRIx64>,
-C<d_PRIX64>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>, C<d_pwclass>,
-C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>,
-C<d_qgcvt>, C<d_quad>, C<d_readdir>, C<d_readlink>, C<d_rename>,
-C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>,
-C<d_sched_yield>, C<d_scm_rights>, C<d_seekdir>, C<d_select>, C<d_sem>,
-C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>,
-C<d_semop>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, C<d_setgrps>,
-C<d_sethent>, C<d_setlinebuf>, C<d_setlocale>, C<d_setnent>, C<d_setpent>,
-C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>, C<d_setprior>, C<d_setpwent>,
-C<d_setregid>, C<d_setresgid>, C<d_setresuid>, C<d_setreuid>, C<d_setrgid>,
-C<d_setruid>, C<d_setsent>, C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>,
-C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>,
-C<d_sigaction>, C<d_sigsetjmp>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>,
-C<d_sqrtl>, C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>,
-C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
-C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>,
-C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strtod>,
-C<d_strtol>, C<d_strtold>, C<d_strtoll>, C<d_strtoul>, C<d_strtoull>,
-C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>,
-C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>,
-C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>,
-C<d_truncate>, C<d_tzname>, C<d_umask>, C<d_uname>, C<d_union_semun>,
-C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>, C<d_vendorlib>, C<d_vfork>,
-C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>, C<d_volatile>,
-C<d_vprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>,
-C<d_xenix>, C<date>, C<db_hashtype>, C<db_prefixtype>, C<defvoidused>,
-C<direntrytype>, C<dlext>, C<dlsrc>, C<doublesize>, C<drand01>,
-C<dynamic_ext>
+C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>, C<d_getgrps>,
+C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
+C<d_gethostprotos>, C<d_getlogin>, C<d_getmnt>, C<d_getmntent>,
+C<d_getnbyaddr>, C<d_getnbyname>, C<d_getnent>, C<d_getnetprotos>,
+C<d_getpbyname>, C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>,
+C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>, C<d_getprior>,
+C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>, C<d_getsbyname>,
+C<d_getsbyport>, C<d_getsent>, C<d_getservprotos>, C<d_getspnam>,
+C<d_gettimeod>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>,
+C<d_iconv>, C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>,
+C<d_isnan>, C<d_isnanl>, C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>,
+C<d_link>, C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>,
+C<d_lseekproto>, C<d_lstat>, C<d_madvise>, C<d_mblen>, C<d_mbstowcs>,
+C<d_mbtowc>, C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>,
+C<d_memset>, C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>,
+C<d_mkstemps>, C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_mprotect>, C<d_msg>,
+C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>,
+C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msgrcv>, C<d_msgsnd>,
+C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nv_preserves_uv>,
+C<d_nv_preserves_uv_bits>, C<d_off64_t>, C<d_old_pthread_create_joinable>,
+C<d_oldpthreads>, C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>,
+C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>,
+C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEldbl>, C<d_PRIfldbl>,
+C<d_PRIFldbl>, C<d_PRIgldbl>, C<d_PRIGldbl>, C<d_PRIi64>, C<d_PRIo64>,
+C<d_PRIu64>, C<d_PRIx64>, C<d_PRIX64>, C<d_pthread_yield>, C<d_pwage>,
+C<d_pwchange>, C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>,
+C<d_pwpasswd>, C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_readdir>,
+C<d_readlink>, C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>,
+C<d_safemcpy>, C<d_sanemcmp>, C<d_sched_yield>, C<d_scm_rights>,
+C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>, C<d_semctl_semid_ds>,
+C<d_semctl_semun>, C<d_semget>, C<d_semop>, C<d_setegid>, C<d_seteuid>,
+C<d_setgrent>, C<d_setgrps>, C<d_sethent>, C<d_setlinebuf>, C<d_setlocale>,
+C<d_setnent>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>,
+C<d_setprior>, C<d_setpwent>, C<d_setregid>, C<d_setresgid>,
+C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>,
+C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>,
+C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>,
+C<d_sigsetjmp>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>, C<d_sqrtl>,
+C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>,
+C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, C<d_stdio_stream_array>,
+C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>,
+C<d_strerrm>, C<d_strerror>, C<d_strtod>, C<d_strtol>, C<d_strtold>,
+C<d_strtoll>, C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>,
+C<d_suidsafe>, C<d_symlink>, C<d_syscall>, C<d_sysconf>, C<d_sysernlst>,
+C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
+C<d_telldirproto>, C<d_time>, C<d_times>, C<d_truncate>, C<d_tzname>,
+C<d_umask>, C<d_uname>, C<d_union_semun>, C<d_ustat>, C<d_vendorarch>,
+C<d_vendorbin>, C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>,
+C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
+C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_xenix>, C<date>,
+C<db_hashtype>, C<db_prefixtype>, C<defvoidused>, C<direntrytype>,
+C<dlext>, C<dlsrc>, C<doublesize>, C<drand01>, C<dynamic_ext>
 
 =item e
 
@@ -5691,12 +5683,12 @@ C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>, C<i_gdbm>,
 C<i_grp>, C<i_iconv>, C<i_ieeefp>, C<i_inttypes>, C<i_limits>, C<i_locale>,
 C<i_machcthr>, C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>,
 C<i_netdb>, C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>,
-C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
-C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
-C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
-C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
-C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
-C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
+C<i_prot>, C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>,
+C<i_shadow>, C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>,
+C<i_string>, C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>,
+C<i_sysfilio>, C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>,
+C<i_sysmode>, C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>,
+C<i_syssecrt>, C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
@@ -6205,7 +6197,7 @@ variables
 
 =item DESCRIPTION
 
-=item BUGS
+=item PERFORMANCE
 
 =back
 
@@ -6224,22 +6216,6 @@ arrays
 
 =back
 
-=head2 Errno - System errno constants
-
-=over
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item CAVEATS
-
-=item AUTHOR
-
-=item COPYRIGHT
-
-=back
-
 =head2 Exporter - Implements default import method for modules
 
 =over
@@ -7631,239 +7607,6 @@ locale
 
 =back
 
-=head2 IO::Dir - supply object methods for directory handles
-
-=over
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
-rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
-
-=item SEE ALSO
-
-=item AUTHOR
-
-=item COPYRIGHT
-
-=back
-
-=head2 IO::File - supply object methods for filehandles
-
-=over
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item CONSTRUCTOR
-
-new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
-
-=item METHODS
-
-open( FILENAME [,MODE [,PERMS]] )
-
-=item SEE ALSO
-
-=item HISTORY
-
-=back
-
-=head2 IO::Handle - supply object methods for I/O handles
-
-=over
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item CONSTRUCTOR
-
-new (), new_from_fd ( FD, MODE )
-
-=item METHODS
-
-$io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
-$io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
-$io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
-$io->blocking ( [ BOOL ] ), $io->untaint
-
-=item NOTE
-
-=item SEE ALSO
-
-=item BUGS
-
-=item HISTORY
-
-=back
-
-=head2 IO::Pipe - supply object methods for pipes
-
-=over
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item CONSTRUCTOR
-
-new ( [READER, WRITER] )
-
-=item METHODS
-
-reader ([ARGS]), writer ([ARGS]), handles ()
-
-=item SEE ALSO
-
-=item AUTHOR
-
-=item COPYRIGHT
-
-=back
-
-=head2 IO::Poll - Object interface to system poll call
-
-=over
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item METHODS
-
-mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
-IO ), handles( [ EVENT_MASK ] )
-
-=item SEE ALSO
-
-=item AUTHOR
-
-=item COPYRIGHT
-
-=back
-
-=head2 IO::Seekable - supply seek based methods for I/O objects
-
-=over
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item SEE ALSO
-
-=item HISTORY
-
-=back
-
-=head2 IO::Select - OO interface to the select system call
-
-=over
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item CONSTRUCTOR
-
-new ( [ HANDLES ] )
-
-=item METHODS
-
-add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
-[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
-count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
-
-=item EXAMPLE
-
-=item AUTHOR
-
-=item COPYRIGHT
-
-=back
-
-=head2 IO::Socket - Object interface to socket communications
-
-=over
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item CONSTRUCTOR
-
-new ( [ARGS] )
-
-=item METHODS
-
-accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), timeout([VAL]),
-sockopt(OPT [, VAL]), sockdomain, socktype, protocol, connected
-
-=item SEE ALSO
-
-=item AUTHOR
-
-=item COPYRIGHT
-
-=back
-
-=head2 IO::Socket::INET - Object interface for AF_INET domain sockets
-
-=over
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item CONSTRUCTOR
-
-new ( [ARGS] )
-
-=over
-
-=item METHODS
-
-sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
-()
-
-=back
-
-=item SEE ALSO
-
-=item AUTHOR
-
-=item COPYRIGHT
-
-=back
-
-=head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
-
-=over
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item CONSTRUCTOR
-
-new ( [ARGS] )
-
-=item METHODS
-
-hostpath(), peerpath()
-
-=item SEE ALSO
-
-=item AUTHOR
-
-=item COPYRIGHT
-
-=back
-
 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
 handles
 
@@ -8104,28 +7847,6 @@ hostpath(), peerpath()
 
 =back
 
-=head2 IPC::Msg - SysV Msg IPC object class
-
-=over
-
-=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
-
-=back
-
 =head2 IPC::Open2, open2 - open a process for both reading and writing
 
 =over
@@ -8153,29 +7874,6 @@ handling
 
 =back
 
-=head2 IPC::Semaphore - SysV Semaphore IPC object class
-
-=over
-
-=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
-
-=back
-
 =head2 IPC::SysV - SysV IPC constants
 
 =over
@@ -9050,6 +8748,124 @@ B<Pod::ParseTree>
 
 =back
 
+=head2 Pod::LaTeX - Convert Pod data to formatted Latex
+
+=over
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
+=over
+
+=item OBJECT METHODS
+
+C<initialize>
+
+=back
+
+=over
+
+=item Data Accessors
+
+B<AddPreamble>
+
+=back
+
+B<AddPostamble>
+
+B<Head1Level>
+
+B<Label>
+
+B<LevelNoNum>
+
+B<MakeIndex>
+
+B<ReplaceNAMEwithSection>
+
+B<StartWithNewPage>
+
+B<TableOfContents>
+
+B<UniqueLabels>
+
+B<UserPreamble>
+
+B<UserPostamble>
+
+B<Lists>
+
+=over
+
+=item Subclassed methods
+
+=back
+
+B<begin_pod>
+
+B<end_pod>
+
+B<command>
+
+B<verbatim>
+
+B<textblock>
+
+B<interior_sequence>
+
+=over
+
+=item List Methods
+
+B<begin_list>
+
+=back
+
+B<end_list>
+
+B<add_item>
+
+=over
+
+=item Methods for headings
+
+B<head>
+
+=back
+
+=over
+
+=item Internal methods
+
+B<_output>
+
+=back
+
+B<_replace_special_chars>
+
+B<_create_label>
+
+B<_create_index>
+
+B<_clean_latex_commands>
+
+=over
+
+=item NOTES
+
+=item SEE ALSO
+
+=item AUTHORS
+
+=item COPYRIGHT
+
+=item REVISION
+
+=back
+
 =head2 Pod::Man - Convert POD data to formatted *roff input
 
 =over
@@ -9640,39 +9456,6 @@ C<-pathlist>
 
 =back
 
-=head2 Safe - Compile and execute code in restricted compartments
-
-=over
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-a new namespace, an operator mask
-
-=item WARNING
-
-=over
-
-=item RECENT CHANGES
-
-=item Methods in class Safe
-
-permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
-...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
-(PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
-root (NAMESPACE), mask (MASK)
-
-=item Some Safety Issues
-
-Memory, CPU, Snooping, Signals, State Changes
-
-=item AUTHOR
-
-=back
-
-=back
-
 =head2 Search::Dict, look - search for key in dictionary file
 
 =over
@@ -9772,27 +9555,6 @@ pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
 
 =back
 
-=head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
-interface to the UNIX syslog(3) calls
-
-=over
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
-setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
-closelog
-
-=item EXAMPLES
-
-=item SEE ALSO
-
-=item AUTHOR
-
-=back
-
 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
 Perl interface to the UNIX syslog(3) calls
 
diff --git a/pod/perlutil.pod b/pod/perlutil.pod
new file mode 100644 (file)
index 0000000..1b2c178
--- /dev/null
@@ -0,0 +1,185 @@
+=head1 NAME
+
+perlutil - utilities packaged with the Perl distribution
+
+=head1 DESCRIPTION
+
+Along with the Perl interpreter itself, the Perl distribution installs a
+range of utilities on your system. There are also several utilities
+which are used by the Perl distribution itself as part of the install
+process. This document exists to list all of these utilities, explain
+what they are for and provide pointers to each module's documentation,
+if appropriate.
+
+=head2 DOCUMENTATION
+
+=over 3
+
+=item L<perldoc|perldoc>
+
+The main interface to Perl's documentation is C<perldoc>, although
+if you're reading this, it's more than likely that you've already found
+it. F<perldoc> will extract and format the documentation from any file
+in the current directory, any Perl module installed on the system, or
+any of the standard documentation pages, such as this one. Use 
+C<perldoc E<lt>nameE<gt>> to get information on any of the utilities
+described in this document.
+
+=item L<pod2man|pod2man> and L<pod2text|pod2text>
+
+If it's run from a terminal, F<perldoc> will usually call F<pod2man> to
+translate POD (Plain Old Documentation - see L<perlpod> for an
+explanation) into a man page, and then run F<man> to display it; if
+F<man> isn't available, F<pod2text> will be used instead and the output
+piped through your favourite pager.
+
+=item L<pod2html|pod2html> and L<pod2latex|pod2latex>
+
+As well as these two, there are two other convertors: F<pod2html> will
+produce HTML pages from POD, and F<pod2latex>, which produces LaTeX
+files.
+
+=item L<pod2usage|pod2usage>
+
+If you just want to know how to use the utilities described here,
+F<pod2usage> will just extract the "USAGE" section; some of
+the utilities will automatically call F<pod2usage> on themselves when
+you call them with C<-help>.
+
+=item L<podselect|podselect>
+
+F<pod2usage> is a special case of F<podselect>, a utility to extract
+named sections from documents written in POD. For instance, while
+utilities have "USAGE" sections, Perl modules usually have "SYNOPSIS"
+sections: C<podselect -s "SYNOPSIS" ...> will extract this section for
+a given file.
+
+=item L<podchecker|podchecker>
+
+If you're writing your own documentation in POD, the F<podchecker>
+utility will look for errors in your markup.
+
+=item L<splain|splain>
+
+F<splain> is an interface to L<perldiag> - paste in your error message
+to it, and it'll explain it for you.
+
+=item L<roffitall|roffitall>
+
+The C<roffitall> utility is not installed on your system but lives in
+the F<pod/> directory of your Perl source kit; it converts all the
+documentation from the distribution to F<*roff> format, and produces a
+typeset PostScript or text file of the whole lot.
+
+=back
+
+=head2 CONVERTORS
+
+To help you convert legacy programs to Perl, we've included three
+conversion filters:
+
+=over 3
+
+=item L<a2p|a2p>
+
+F<a2p> converts F<awk> scripts to Perl programs; for example, C<a2p -F:>
+on the simple F<awk> script C<{print $2}> will produce a Perl program
+based around this code:
+
+    while (<>) {
+        ($Fld1,$Fld2) = split(/[:\n]/, $_, 9999);
+        print $Fld2;
+    }
+
+=item L<s2p|s2p>
+
+Similarly, F<s2p> converts F<sed> scripts to Perl programs. F<s2p> run
+on C<s/foo/bar> will produce a Perl program based around this:
+
+    while (<>) {
+        chop;
+        s/foo/bar/g;
+        print if $printit;
+    }
+
+=item L<find2perl|find2perl>
+
+Finally, F<find2perl> translates C<find> commands to Perl equivalents which 
+use the L<File::Find|File::Find> module. As an example, 
+C<find2perl . -user root -perm 4000 -print> produces the following callback
+subroutine for C<File::Find>:
+
+    sub wanted {
+        my ($dev,$ino,$mode,$nlink,$uid,$gid);
+        (($dev,$ino,$mode,$nlink,$uid,$gid) = lstat($_)) &&
+        $uid == $uid{'root'}) &&
+        (($mode & 0777) == 04000);
+        print("$name\n");
+    }
+
+=back
+
+As well as these filters for converting other languages, the
+L<pl2pm|pl2pm> utility will help you convert old-style Perl 4 libraries to 
+new-style Perl5 modules.
+
+=head2 Development
+
+There are a set of utilities which help you in developing Perl programs, 
+and in particular, extending Perl with C.
+
+=over 3
+
+=item L<perlbug|perlbug>
+
+F<perlbug> is the recommended way to report bugs in the perl interpreter
+itself or any of the standard library modules back to the developers;
+please read through the documentation for F<perlbug> thoroughly before
+using it to submit a bug report.
+
+=item L<h2ph|h2ph>
+
+Back before Perl had the XS system for connecting with C libraries,
+programmers used to get library constants by reading through the C
+header files. You may still see C<require 'syscall.ph'> or similar
+around - the F<.ph> file should be created by running F<h2ph> on the
+corresponding F<.h> file. See the F<h2ph> documentation for more on how
+to convert a whole bunch of header files at ones.
+
+=item L<c2ph|c2ph> and L<pstruct|pstruct>
+
+F<c2ph> and F<pstruct>, which are actually the same program but behave
+differently depending on how they are called, provide another way of
+getting at C with Perl - they'll convert C structures and union declarations
+to Perl code. This is deprecated in favour of F<h2xs> these days.
+
+=item L<h2xs|h2xs>
+
+F<h2xs> converts C header files into XS modules, and will try and write
+as much glue between C libraries and Perl modules as it can. It's also
+very useful for creating skeletons of pure Perl modules.
+
+=item L<dprofpp|dprofpp>
+
+Perl comes with a profiler, the F<Devel::Dprof> module. The
+F<dprofpp> utility analyzes the output of this profiler and tells you
+which subroutines are taking up the most run time. See L<Devel::Dprof>
+for more information.
+
+=item L<perlcc|perlcc>
+
+F<perlcc> is the interface to the experimental Perl compiler suite.
+
+=back
+
+=head2 SEE ALSO
+
+L<perldoc|perldoc>, L<pod2man|pod2man>, L<perlpod>,
+L<pod2html|pod2html>, L<pod2usage|pod2usage>, L<podselect|podselect>,
+L<podchecker|podchecker>, L<splain|splain>, L<perldiag>,
+L<roffitall|roffitall>, L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>,
+L<File::Find|File::Find>, L<pl2pm|pl2pm>, L<perlbug|perlbug>,
+L<h2ph|h2ph>, L<c2ph|c2ph>, L<h2xs|h2xs>, L<dprofpp|dprofpp>,
+L<Devel::Dprof>, L<perlcc|perlcc>
+
+=cut
index 018c0b3..396da6f 100644 (file)
@@ -27,70 +27,82 @@ case "$1" in
        ;;
 esac
 
+# NEEDS TO BE BUILT BASED ON Makefile (or Makefile.SH, should such happen)
 toroff=`
        echo            \
-    $mandir/perl.1     \
-    $mandir/perldata.1 \
-    $mandir/perlsyn.1  \
-    $mandir/perlop.1   \
-    $mandir/perlre.1   \
-    $mandir/perlrun.1  \
-    $mandir/perlfunc.1 \
-    $mandir/perlvar.1  \
-    $mandir/perlsub.1  \
-    $mandir/perlopentut.1      \
-    $mandir/perlmod.1  \
-    $mandir/perlmodlib.1       \
-    $mandir/perlmodinstall.1   \
-    $mandir/perlfork.1 \
-    $mandir/perlform.1 \
-    $mandir/perllocale.1       \
-    $mandir/perlref.1  \
-    $mandir/perlreftut.1       \
-    $mandir/perldsc.1  \
-    $mandir/perllol.1  \
-    $mandir/perlboot.1 \
-    $mandir/perltoot.1 \
-    $mandir/perlobj.1  \
-    $mandir/perltie.1  \
-    $mandir/perlbot.1  \
-    $mandir/perlipc.1  \
-    $mandir/perlthrtut.1       \
-    $mandir/perldebguts.1      \
-    $mandir/perldebug.1        \
-    $mandir/perlnumber.1       \
-    $mandir/perldiag.1 \
-    $mandir/perlsec.1  \
-    $mandir/perltrap.1 \
-    $mandir/perlport.1 \
-    $mandir/perlstyle.1        \
-    $mandir/perlpod.1  \
-    $mandir/perlbook.1 \
-    $mandir/perlembed.1        \
-    $mandir/perlapio.1 \
-    $mandir/perlxs.1   \
-    $mandir/perlxstut.1        \
-    $mandir/perlguts.1 \
-    $mandir/perlcall.1 \
-    $mandir/perlcompile.1      \
-    $mandir/perltodo.1 \
-    $mandir/perlapi.1  \
-    $mandir/perlintern.1       \
-    $mandir/perlhack.1 \
-    $mandir/perlhist.1 \
-    $mandir/perldelta.1        \
-    $mandir/perl5004delta.1    \
-    $mandir/perl5005delta.1    \
-    $mandir/perlfaq.1  \
-    $mandir/perlfaq1.1 \
-    $mandir/perlfaq2.1 \
-    $mandir/perlfaq3.1 \
-    $mandir/perlfaq4.1 \
-    $mandir/perlfaq5.1 \
-    $mandir/perlfaq6.1 \
-    $mandir/perlfaq7.1 \
-    $mandir/perlfaq8.1 \
-    $mandir/perlfaq9.1 \
+       $mandir/perl.1  \
+       $mandir/perl5004delta.1 \
+       $mandir/perl5005delta.1 \
+       $mandir/perl56delta.1   \
+       $mandir/perlapi.1       \
+       $mandir/perlapio.1      \
+       $mandir/perlbook.1      \
+       $mandir/perlboot.1      \
+       $mandir/perlbot.1       \
+       $mandir/perlcall.1      \
+       $mandir/perlcompile.1   \
+       $mandir/perldata.1      \
+       $mandir/perldbmfilter.1 \
+       $mandir/perldebguts.1   \
+       $mandir/perldebug.1     \
+       $mandir/perldelta.1     \
+       $mandir/perldiag.1      \
+       $mandir/perldsc.1       \
+       $mandir/perlembed.1     \
+       $mandir/perlfaq.1       \
+       $mandir/perlfaq1.1      \
+       $mandir/perlfaq2.1      \
+       $mandir/perlfaq3.1      \
+       $mandir/perlfaq4.1      \
+       $mandir/perlfaq5.1      \
+       $mandir/perlfaq6.1      \
+       $mandir/perlfaq7.1      \
+       $mandir/perlfaq8.1      \
+       $mandir/perlfaq9.1      \
+       $mandir/perlfilter.1    \
+       $mandir/perlfork.1      \
+       $mandir/perlform.1      \
+       $mandir/perlfunc.1      \
+       $mandir/perlguts.1      \
+       $mandir/perlhack.1      \
+       $mandir/perlhist.1      \
+       $mandir/perlintern.1    \
+       $mandir/perlipc.1       \
+       $mandir/perllexwarn.1   \
+       $mandir/perllocale.1    \
+       $mandir/perllol.1       \
+       $mandir/perlmod.1       \
+       $mandir/perlmodinstall.1        \
+       $mandir/perlmodlib.1    \
+       $mandir/perlnewmod.1    \
+       $mandir/perlnumber.1    \
+       $mandir/perlobj.1       \
+       $mandir/perlop.1        \
+       $mandir/perlopentut.1   \
+       $mandir/perlpod.1       \
+       $mandir/perlport.1      \
+       $mandir/perlre.1        \
+       $mandir/perlref.1       \
+       $mandir/perlreftut.1    \
+       $mandir/perlrequick.1   \
+       $mandir/perlretut.1     \
+       $mandir/perlrun.1       \
+       $mandir/perlsec.1       \
+       $mandir/perlstyle.1     \
+       $mandir/perlsub.1       \
+       $mandir/perlsyn.1       \
+       $mandir/perlthrtut.1    \
+       $mandir/perltie.1       \
+       $mandir/perltoc.1       \
+       $mandir/perltodo.1      \
+       $mandir/perltoot.1      \
+       $mandir/perltootc.1     \
+       $mandir/perltrap.1      \
+       $mandir/perlunicode.1   \
+       $mandir/perlutil.1      \
+       $mandir/perlvar.1       \
+       $mandir/perlxs.1        \
+       $mandir/perlxstut.1     \
        \
     $mandir/a2p.1      \
     $mandir/c2ph.1     \