From 96d431b0c268c36f027238777432d472c736c948 Mon Sep 17 00:00:00 2001
From: Simon Cozens <simon@netthink.co.uk>
Date: Mon, 19 Jun 2000 15:18:27 +0000
Subject: [PATCH] PATCH: pod/perlutil.pod - utilities packaged with the Perl
 distribution Message-ID: <slrn8ksee3.cp9.simon@justanother.perlhacker.org>

plus update pod/Makefile and regenerate perltoc

p4raw-id: //depot/cfgperl@6232
---
 MANIFEST         |   1 +
 Todo-5.6         |   2 +
 pod/Makefile     | 397 +++++++++++++++++---------------
 pod/perltoc.pod  | 688 ++++++++++++++++++-------------------------------------
 pod/perlutil.pod | 185 +++++++++++++++
 pod/roffitall    | 136 ++++++-----
 6 files changed, 700 insertions(+), 709 deletions(-)
 create mode 100644 pod/perlutil.pod

diff --git a/MANIFEST b/MANIFEST
index 2681a11..b21da7d 100644
--- 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
diff --git a/Todo-5.6 b/Todo-5.6
index a94df37..04b5fe0 100644
--- 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
+
diff --git a/pod/Makefile b/pod/Makefile
index 5f6c40c..a6f4efb 100644
--- a/pod/Makefile
+++ b/pod/Makefile
@@ -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)
 
diff --git a/pod/perltoc.pod b/pod/perltoc.pod
index 1b111cb..5768081 100644
--- a/pod/perltoc.pod
+++ b/pod/perltoc.pod
@@ -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
index 0000000..1b2c178
--- /dev/null
+++ b/pod/perlutil.pod
@@ -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
diff --git a/pod/roffitall b/pod/roffitall
index 018c0b3..396da6f 100644
--- a/pod/roffitall
+++ b/pod/roffitall
@@ -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	\
-- 
2.7.4