Updates to modules-related pod
[p5sagit/p5-mst-13.2.git] / pod / perltoc.pod
index 12701b5..4fabc20 100644 (file)
@@ -2091,6 +2091,8 @@ PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y///
 
 =item How to Eat an Egg on a Net
 
+=item Byte-order modifiers
+
 =item Floating point Numbers
 
 =back
@@ -2131,6 +2133,8 @@ PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y///
 
 =item The Alignment Pit
 
+=item Dealing with Endian-ness
+
 =item Alignment, Take 2
 
 =item Alignment, Take 3
@@ -2255,7 +2259,7 @@ B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
 B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>,
-B<-X>, B<-x> I<directory>
+B<-X>, B<-x>, B<-x> I<directory>
 
 =back
 
@@ -2547,6 +2551,24 @@ C<(?(condition)yes-pattern|no-pattern)>
 
 =over 4
 
+=item Text Fields
+
+=item Numeric Fields
+
+=item The Field @* for Variable Width Multi-Line Text
+
+=item The Field ^* for Variable Width One-line-at-a-time Text
+
+=item Specifying Values
+
+=item Using Fill Mode
+
+=item Suppressing Lines Where All Fields Are Void
+
+=item Repeating Format Lines
+
+=item Top of Form Processing
+
 =item Format Variables
 
 =back
@@ -3342,8 +3364,8 @@ LC_NUMERIC, LC_TIME, LANG
 =item Important Caveats
 
 Input and Output Layers, Regular Expressions, C<use utf8> still needed to
-enable UTF-8/UTF-EBCDIC in scripts, C<use encoding> needed to upgrade
-non-Latin-1 byte strings
+enable UTF-8/UTF-EBCDIC in scripts, BOM-marked scripts and UTF-16 scripts
+autodetected, C<use encoding> needed to upgrade non-Latin-1 byte strings
 
 =item Byte and Character Semantics
 
@@ -3601,20 +3623,21 @@ B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
-Class::Struct, Config, Cwd, DB, DB_File, Data::Dumper, Devel::DProf,
-Devel::PPPort, Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5,
-Digest::base, DirHandle, Dumpvalue, DynaLoader, Encode, Encode::Alias,
-Encode::Byte, Encode::CJKConstants, Encode::CN, Encode::CN::HZ,
-Encode::Config, Encode::EBCDIC, Encode::Encoder, Encode::Encoding,
-Encode::Guess, Encode::JP, Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR,
-Encode::KR::2022_KR, Encode::MIME::Header, Encode::PerlIO,
-Encode::Supported, Encode::Symbol, Encode::TW, Encode::Unicode,
-Encode::Unicode::UTF7, English, Env, Errno, Exporter, Exporter::Heavy,
-ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant,
-ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
-ExtUtils::MM, ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin,
-ExtUtils::MM_DOS, ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2,
-ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
+Class::Struct, Config, Cwd, DB, DBM_Filter, DB_File, Data::Dumper,
+Devel::DProf, Devel::PPPort, Devel::Peek, Devel::SelfStubber, Digest,
+Digest::MD5, Digest::base, DirHandle, Dumpvalue, DynaLoader, Encode,
+Encode::Alias, Encode::Byte, Encode::CJKConstants, Encode::CN,
+Encode::CN::HZ, Encode::Config, Encode::EBCDIC, Encode::Encoder,
+Encode::Encoding, Encode::Guess, Encode::JP, Encode::JP::H2Z,
+Encode::JP::JIS7, Encode::KR, Encode::KR::2022_KR, Encode::MIME::Header,
+Encode::PerlIO, Encode::Supported, Encode::Symbol, Encode::TW,
+Encode::Unicode, Encode::Unicode::UTF7, English, Env, Errno, Exporter,
+Exporter::Heavy, ExtUtils::Command, ExtUtils::Command::MM,
+ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install,
+ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_Any,
+ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS,
+ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_UWIN,
+ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker,
 ExtUtils::MakeMaker::FAQ, ExtUtils::MakeMaker::Tutorial,
 ExtUtils::MakeMaker::bytes, ExtUtils::MakeMaker::vmsish,
@@ -3633,16 +3656,16 @@ IPC::SysV::Semaphore, List::Util, Locale::Constants, Locale::Country,
 Locale::Currency, Locale::Language, Locale::Maketext,
 Locale::Maketext::TPJ13, Locale::Script, MIME::Base64,
 MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt,
-Math::BigInt::Calc, Math::BigRat, Math::Complex, Math::Trig, Memoize,
-Memoize::AnyDBM_File, Memoize::Expire, Memoize::ExpireFile,
-Memoize::ExpireTest, Memoize::NDBM_File, Memoize::SDBM_File,
-Memoize::Storable, NDBM_File, NEXT, Net::Cmd, Net::Config, Net::Domain,
-Net::FTP, Net::NNTP, Net::Netrc, Net::POP3, Net::Ping, Net::SMTP,
-Net::Time, Net::hostent, Net::libnetFAQ, Net::netent, Net::protoent,
-Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO, PerlIO::encoding,
-PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint, Pod::Checker,
-Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects, Pod::LaTeX,
-Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser,
+Math::BigInt::Calc, Math::BigInt::CalcEmu, Math::BigRat, Math::Complex,
+Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire,
+Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File,
+Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT, Net::Cmd,
+Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3,
+Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent,
+Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO,
+PerlIO::encoding, PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint,
+Pod::Checker, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects,
+Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser,
 Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff,
 Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText,
 Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer,
@@ -4224,6 +4247,8 @@ C<!!!>, C<!!>, C<!>
 
 =item The RETVAL Variable
 
+=item Returning SVs, AVs and HVs through RETVAL
+
 =item The MODULE Keyword
 
 =item The PACKAGE Keyword
@@ -4613,7 +4638,7 @@ GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
 
 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
-get_av, newAV, Nullav, sortsv
+get_av, newAV, sortsv
 
 =item Callback Functions
 
@@ -4630,7 +4655,7 @@ perl_clone
 
 =item CV Manipulation Functions
 
-CvSTASH, get_cv, Nullcv
+CvSTASH, get_cv
 
 =item Embedding Functions
 
@@ -4652,33 +4677,34 @@ gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
 
 =item Handy Values
 
-HEf_SVKEY, Nullch, Nullsv
+Nullav, Nullch, Nullcv, Nullhv, Nullsv
 
 =item Hash Manipulation Functions
 
-get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set,
-HeVAL, HvNAME, hv_assert, hv_clear, hv_clear_placeholders, hv_delete,
-hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
+get_hv, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force,
+HeSVKEY_set, HeVAL, HvNAME, hv_assert, hv_clear, hv_clear_placeholders,
+hv_delete, hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
 hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv,
 hv_iternext_flags, hv_iterval, hv_magic, hv_scalar, hv_store, hv_store_ent,
-hv_undef, newHV, Nullhv
+hv_undef, newHV
 
 =item Magical Functions
 
 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
-SvSetSV, SvSetSV_nosteal, SvSHARE
+SvSetSV, SvSetSV_nosteal, SvSHARE, SvUNLOCK
 
 =item Memory Management
 
-Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree,
-savepv, savepvn, savesharedpv, StructCopy, Zero
+Copy, CopyD, Move, MoveD, New, Newc, Newz, Poison, Renew, Renewc, Safefree,
+savepv, savepvn, savesharedpv, StructCopy, Zero, ZeroD
 
 =item Miscellaneous Functions
 
 fbm_compile, fbm_instr, form, getcwd_sv, new_version, scan_version, strEQ,
 strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_nolocking,
-sv_nosharing, sv_nounlocking, upg_version, vcmp, vnumify, vstringify
+sv_nosharing, sv_nounlocking, upg_version, vcmp, vnormal, vnumify,
+vstringify
 
 =item Numeric functions
 
@@ -4695,12 +4721,13 @@ pad_sv
 
 =item Stack Manipulation Macros
 
-dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp,
-POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
-PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN,
-XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
-XSRETURN_UV, XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF,
-XST_mYES
+dMARK, dORIGMARK, dSP, EXTEND, MARK, mPUSHi, mPUSHn, mPUSHp, mPUSHu,
+mXPUSHi, mXPUSHn, mXPUSHp, mXPUSHu, ORIGMARK, POPi, POPl, POPn, POPp,
+POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHmortal, PUSHn, PUSHp, PUSHs,
+PUSHu, PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHmortal, XPUSHn, XPUSHp, XPUSHs,
+XPUSHu, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, XSRETURN_NV,
+XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_UV, XSRETURN_YES, XST_mIV, XST_mNO,
+XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
 
 =item SV Flags
 
@@ -4708,33 +4735,33 @@ svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
 
 =item SV Manipulation Functions
 
-get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
-newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
-SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off,
-SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIsCOW,
-SvIsCOW_shared_hash, SvIV, SvIVx, SvIVX, SvLEN, SvNIOK, SvNIOKp,
+get_sv, looks_like_number, newRV_inc, newRV_noinc, NEWSV, newSV, newSViv,
+newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv,
+newSVuv, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV,
+SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIsCOW,
+SvIsCOW_shared_hash, SvIV, SvIVx, SvIVX, SvIV_nomg, SvLEN, SvNIOK, SvNIOKp,
 SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX,
 SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only,
 SvPOK_only_UTF8, SvPV, SvPVbyte, SvPVbytex, SvPVbytex_force,
 SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, SvPVutf8x, SvPVutf8x_force,
 SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX, SvPV_force, SvPV_force_nomg,
-SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off,
-SvROK_on, SvRV, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on,
-SvTRUE, SvTYPE, SvUNLOCK, SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on,
-SvUV, SvUVX, SvUVx, SvVOK, sv_2bool, sv_2cv, sv_2io, sv_2iv, sv_2mortal,
-sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen, sv_2pvutf8, sv_2pvutf8_nolen,
-sv_2pv_flags, sv_2pv_nolen, sv_2uv, sv_backoff, sv_bless, sv_catpv,
-sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_flags, sv_catpvn_mg,
-sv_catpv_mg, sv_catsv, sv_catsv_flags, sv_catsv_mg, sv_chop, sv_clear,
-sv_cmp, sv_cmp_locale, sv_collxfrm, sv_copypv, sv_dec, sv_derived_from,
-sv_eq, sv_force_normal, sv_force_normal_flags, sv_free, sv_gets, sv_grow,
-sv_inc, sv_insert, sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8,
-sv_magic, sv_magicext, sv_mortalcopy, sv_newmortal, sv_newref, sv_nv,
-sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force,
-sv_pvn, sv_pvn_force, sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n,
-sv_pvutf8n_force, sv_reftype, sv_replace, sv_report_used, sv_reset,
-sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv,
-sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn,
+SvPV_nolen, SvPV_nomg, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK,
+SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off,
+SvTAINTED_on, SvTRUE, SvTYPE, SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off,
+SvUTF8_on, SvUV, SvUVX, SvUVx, SvUV_nomg, SvVOK, sv_2bool, sv_2cv, sv_2io,
+sv_2iv_flags, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen, sv_2pvutf8,
+sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv_flags, sv_backoff,
+sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_flags,
+sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags, sv_catsv_mg, sv_chop,
+sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm, sv_copypv, sv_dec,
+sv_derived_from, sv_eq, sv_force_normal, sv_force_normal_flags, sv_free,
+sv_gets, sv_grow, sv_inc, sv_insert, sv_isa, sv_isobject, sv_iv, sv_len,
+sv_len_utf8, sv_magic, sv_magicext, sv_mortalcopy, sv_newmortal, sv_newref,
+sv_nv, sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, sv_pvbyten,
+sv_pvbyten_force, sv_pvn, sv_pvn_force, sv_pvn_force_flags, sv_pvutf8,
+sv_pvutf8n, sv_pvutf8n_force, sv_reftype, sv_replace, sv_report_used,
+sv_reset, sv_rvweaken, 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_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg,
 sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref,
@@ -4753,8 +4780,8 @@ uvuni_to_utf8_flags
 
 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
 
-ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST,
-THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK
+ax, CLASS, dAX, dITEMS, dUNDERBAR, dXSARGS, dXSI32, items, ix, newXSproto,
+RETVAL, ST, THIS, UNDERBAR, XS, XS_VERSION, XS_VERSION_BOOTCHECK
 
 =item Warning and Dieing
 
@@ -4815,7 +4842,8 @@ djSP, LVRET
 
 =item SV Manipulation Functions
 
-report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
+find_uninit_var, report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs,
+sv_free_arenas
 
 =item AUTHORS
 
@@ -4955,6 +4983,8 @@ It's easier to rsync the source tree, It's more reliable
 It's easier to rsync the patches, It's a good reference, Finding a start
 point, Finding how to fix a bug, Finding the source of misbehaviour
 
+=item Working with the source
+
 =item Perlbug administration
 
 =item Submitting patches
@@ -5077,417 +5107,380 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item DESCRIPTION
 
-=item To do during 5.6.x
+=item assertions
 
-=over 4
+=item iCOW
 
-=item Support for I/O disciplines
+=item (?{...}) closures in regexps
 
-=item Autoload bytes.pm
+=item A re-entrant regexp engine
 
-=item Make "\u{XXXX}" et al work
+=item pragmata
 
-=item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
-
-=item Overloadable regex assertions
-
-=item Unicode
-
-=item Work out exit/die semantics for threads
-
-=item Better support for nonpreemptive threading systems like GNU pth
+=over 4
 
-=item Typed lexicals for compiler
+=item lexical pragmas
 
-=item Compiler workarounds for Win32
+=item use less 'memory'
 
-=item AUTOLOADing in the compiler
+=back
 
-=item Fixing comppadlist when compiling
+=item prototypes and functions
 
-=item Cleaning up exported namespace
+=over 4
 
-=item Complete signal handling
+=item _ prototype character
 
-=item Out-of-source builds
+=item inlining autoloaded constants
 
-=item POSIX realtime support
+=item Finish off lvalue functions
 
-=item UNIX98 support
+=back
 
-=item IPv6 Support
+=item Unicode and UTF8
 
-=item Long double conversion
+=over 4
 
-=item Locales
+=item Implicit Latin 1 => Unicode translation
 
-=item Arithmetic on non-Arabic numerals
+=item UTF8 caching code
 
-=item POSIX Unicode character classes
+=item Unicode in Filenames
 
-=item Factoring out common suffices/prefices in regexps (trie optimization)
+=item Unicode in %ENV
 
-=item Security audit shipped utilities
+=back
 
-=item Sort out the uid-setting mess
+=item Regexps
 
-=item Custom opcodes
+=over 4
 
-=item DLL Versioning
+=item regexp optimiser optional
 
-=item Introduce @( and @)
+=item common suffices/prefices in regexps (trie optimization)
 
-=item Floating point handling
+=back
 
-=item IV/UV preservation
+=item POD
 
-=item Replace pod2html with something using Pod::Parser
+=over 4
 
-=item Automate module testing on CPAN
+=item POD -> HTML conversion still sucks
 
-=item sendmsg and recvmsg
+=back
 
-=item Rewrite perlre documentation
+=item Misc medium sized projects
 
-=item Convert example code to IO::Handle filehandles
+=over 4
 
-=item Document Win32 choices
+=item UNITCHECK
 
-=item Check new modules
+=item optional optimizer
 
-=item Make roffitall find pods and libs itself
+=item You WANT *how* many
 
-=back
+=item lexical aliases
 
-=item To do at some point
+=item no 6
 
-=over 4
+=item IPv6
 
-=item Remove regular expression recursion
+=item entersub XS vs Perl
 
-=item Memory leaks after failed eval
+=item @INC source filter to Filter::Simple
 
-=item bitfields in pack
+=item bincompat functions
 
-=item Cross compilation
+=item Use fchown/fchmod internally
 
-=item Perl preprocessor / macros
+=back
 
-=item Perl lexer in Perl
+=item Tests
 
-=item Using POSIX calls internally
+=over 4
 
-=item -i rename file when changed
+=item Make Schwern poorer
 
-=item All ARGV input should act like E<lt>E<gt>
+=item test B
 
-=item Support for rerunning debugger
+=item Improve tests for Config.pm
 
-=item Test Suite for the Debugger
+=item common test code for timed bailout
 
-=item my sub foo { }
+=back
 
-=item One-pass global destruction
+=item Installation
 
-=item Rewrite regexp parser
+=over 4
 
-=item Cache recently used regexps
+=item compressed man pages
 
-=item Cross-compilation support
+=item Make Config.pm cope with differences between build and installed perl
 
-=item Bit-shifting bitvectors
+=item Relocatable perl
 
-=item debugger pragma
+=item make HTML install work
 
-=item use less pragma
+=item put patchlevel in -v
 
-=item switch structures
+=back
 
-=item Cache eval tree
+=item Incremental things
 
-=item rcatmaybe
+=over 4
 
-=item Shrink opcode tables
+=item autovivification
 
-=item Optimize away @_
+=item fix tainting bugs
 
-=item Prototypes versus indirect objects
+=item Make tainting consistent
 
-=item Install HTML
+=item Dual life everything
 
-=item Prototype method calls
+=back
 
-=item Return context prototype declarations
+=item Vague things
 
-=item magic_setisa
+=over 4
 
-=item Garbage collection
+=item threads
 
-=item IO tutorial
+=item POSIX memory footprint
 
-=item Rewrite perldoc
+=item Optimize away @_
 
-=item Install .3p manpages
+=item switch ops
 
-=item Unicode tutorial
+=item Attach/detach debugger from running program
 
-=item Update POSIX.pm for 1003.1-2
+=item A decent benchmark
 
-=item Retargetable installation
+=back
 
-=item POSIX emulation on non-POSIX systems
+=back
 
-=item Rename Win32 headers
+=head2 perldoc - Look up Perl documentation in Pod format.
 
-=item Finish off lvalue functions
+=over 4
 
-=item Update sprintf documentation
+=item SYNOPSIS
 
-=item Use fchown/fchmod internally
+=item DESCRIPTION
 
-=item Make v-strings overloaded objects
+=item OPTIONS
 
-=item Allow restricted hash assignment
+B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
+I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
+I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
+B<-w> I<option:value> or B<-w> I<option>, B<-X>,
+B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
+B<-V>
 
-=item Should overload be inheritable?
+=item SECURITY
 
-=item Taint rethink
+=item ENVIRONMENT
 
-=item Perform correctly when XSUBs call subroutines that exit via
-goto(LABEL) and friends
+=item AUTHOR
 
 =back
 
-=item Vague ideas
+=head2 perlhist - the Perl history records
 
 =over 4
 
-=item ref() in list context
+=item DESCRIPTION
 
-=item Make tr/// return histogram of characters in list context
+=item INTRODUCTION
 
-=item Compile to real threaded code
+=item THE KEEPERS OF THE PUMPKIN
 
-=item Structured types
+=over 4
 
-=item Modifiable $1 et al.
+=item PUMPKIN?
 
-=item Procedural interfaces for IO::*, etc.
+=back
 
-=item RPC modules
+=item THE RECORDS
 
-=item Attach/detach debugger from running program
+=over 4
 
-=item GUI::Native
+=item SELECTED RELEASE SIZES
 
-=item foreach(reverse ...)
+=item SELECTED PATCH SIZES
 
-=item Constant function cache
+=back
 
-=item Approximate regular expression matching
+=item THE KEEPERS OF THE RECORDS
 
 =back
 
-=item Ongoing
+=head2 perldelta - what is new for perl v5.9.2
 
 =over 4
 
-=item Update guts documentation
-
-=item Add more tests
-
-=item Update auxiliary tools
-
-=item Create debugging macros
-
-=item truncate to the people
-
-=item Unicode in Filenames
+=item DESCRIPTION
 
-=back
+=item Incompatible Changes
 
-=item Unicode in %ENV
+=item Core Enhancements
 
-=item Recently done things
+=item Modules and Pragmata
 
-=over 4
+=item Utility Changes
 
-=item Alternative RE syntax module
+=item Documentation
 
-=item Safe signal handling
+=item Performance Enhancements
 
-=item Tie Modules
+=item Installation and Configuration Improvements
 
-=item gettimeofday
+=item Selected Bug Fixes
 
-=item setitimer and getimiter
+=item New or Changed Diagnostics
 
-=item Testing __DIE__ hook
+=item Changed Internals
 
-=item CPP equivalent in Perl
+=item Known Problems
 
-=item Explicit switch statements
+=over 4
 
-=item autocroak
+=item Platform Specific Problems
 
-=item UTF/EBCDIC
+=back
 
-=item UTF Regexes
+=item Reporting Bugs
 
-=item perlcc to produce executable
+=item SEE ALSO
 
-=item END blocks saved in compiled output
+=back
 
-=item Secure temporary file module
+=head2 perl592delta, perldelta - what is new for perl v5.9.2
 
-=item Integrate Time::HiRes
+=over 4
 
-=item Turn Cwd into XS
+=item DESCRIPTION
 
-=item Mmap for input
+=item Incompatible Changes
 
-=item Byte to/from UTF-8 and UTF-8 to/from local conversion
+=item Core Enhancements
 
-=item Add sockatmark support
+=item Modules and Pragmata
 
-=item Mailing list archives
+=item Utility Changes
 
-=item Bug tracking
+=item Documentation
 
-=item Integrate MacPerl
+=item Performance Enhancements
 
-=item Web "nerve center" for Perl
+=item Installation and Configuration Improvements
 
-=item Regular expression tutorial
+=item Selected Bug Fixes
 
-=item Debugging Tutorial
+=item New or Changed Diagnostics
 
-=item Integrate new modules
+=item Changed Internals
 
-=item Integrate profiler
+=item Known Problems
 
-=item Y2K error detection
+=over 4
 
-=item Regular expression debugger
+=item Platform Specific Problems
 
-=item POD checker
+=back
 
-=item "Dynamic" lexicals
+=item Reporting Bugs
 
-=item Cache precompiled modules
+=item SEE ALSO
 
 =back
 
-=item Deprecated Wishes
+=head2 perl591delta, perldelta - what is new for perl v5.9.1
 
 =over 4
 
-=item Loop control on do{}
+=item DESCRIPTION
 
-=item Lexically scoped typeglobs
+=item Incompatible Changes
 
-=item format BOTTOM
+=over 4
 
-=item report HANDLE
+=item substr() lvalues are no longer fixed-length
 
-=item Generalised want()/caller())
+=item The C<:unique> attribute is only meaningful for globals
 
-=item Named prototypes
+=back
 
-=item Built-in globbing
+=item Core Enhancements
 
-=item Regression tests for suidperl
+=over 4
 
-=item Cached hash values
+=item Lexical C<$_>
 
-=item Add compression modules
+=item Tied hashes in scalar context
 
-=item Reorganise documentation into tutorials/references
+=item Formats
 
-=item Remove distinction between functions and operators
+=item Stacked filetest operators
 
-=item Make XS easier to use
+=back
 
-=item Make embedding easier to use
+=item Modules and Pragmata
 
-=item man for perl
+Benchmark, Carp, Exporter, FindBin, List::Util, threads::shared
 
-=item my $Package::variable
+=item Utility Changes
 
-=item "or" tests defined, not truth
+=item Documentation
 
-=item "class"-based lexicals
+=item Performance Enhancements
 
-=item byteperl
+=item Selected Bug Fixes
 
-=item Lazy evaluation / tail recursion removal
+=over 4
 
-=item Make "use utf8" the default
+=item UTF-8 bugs
 
-=item Unicode collation and normalization
+=item Threading bugs
 
-=item pack/unpack tutorial
+=item More bugs
 
 =back
 
-=back
+=item New or Changed Diagnostics
 
-=head2 perldoc - Look up Perl documentation in Pod format.
+=item Changed Internals
 
 =over 4
 
-=item SYNOPSIS
-
-=item DESCRIPTION
+=item Reordering of SVt_* constants
 
-=item OPTIONS
+=item Removal of CPP symbols
 
-B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
-I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
-I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
-B<-w> I<option:value> or B<-w> I<option>, B<-X>,
-B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
-B<-V>
-
-=item SECURITY
+=item Less space is used by ops
 
-=item ENVIRONMENT
-
-=item AUTHOR
+=item New parser
 
 =back
 
-=head2 perlhist - the Perl history records
-
-=over 4
-
-=item DESCRIPTION
-
-=item INTRODUCTION
+=item Configuration and Building
 
-=item THE KEEPERS OF THE PUMPKIN
+=item Known Problems
 
 =over 4
 
-=item PUMPKIN?
+=item Platform Specific Problems
 
 =back
 
-=item THE RECORDS
-
-=over 4
-
-=item SELECTED RELEASE SIZES
-
-=item SELECTED PATCH SIZES
+=item To-do for perl 5.10.0
 
-=back
+=item Reporting Bugs
 
-=item THE KEEPERS OF THE RECORDS
+=item SEE ALSO
 
 =back
 
-=head2 perldelta - what is new for perl v5.9.0
+=head2 perl590delta, perldelta - what is new for perl v5.9.0
 
 =over 4
 
@@ -5525,8 +5518,6 @@ B<-V>
 
 =item Tied Arrays with Negative Array Indices
 
-=item Tied hashes in scalar context
-
 =item local ${$x}
 
 =item Unicode Character Database 4.0.0
@@ -5614,6 +5605,8 @@ Win32::GetOSVersion
 
 =over 4
 
+=item Tied hashes in scalar context
+
 =item Net::Ping 450_service and 510_ping_udp failures
 
 =item B::C
@@ -5648,7 +5641,105 @@ Win32::GetOSVersion
 
 =back
 
-=head2 perl583delta, perldelta - what is new for perl v5.8.3
+=head2 perl585delta - what is new for perl v5.8.5
+
+=over 4
+
+=item DESCRIPTION
+
+=item Incompatible Changes
+
+=item Core Enhancements
+
+=item Modules and Pragmata
+
+=item Utility Changes
+
+=over 4
+
+=item Perl's debugger
+
+=item h2ph
+
+=back
+
+=item Installation and Configuration Improvements
+
+=item Selected Bug Fixes
+
+=item New or Changed Diagnostics
+
+=item Changed Internals
+
+=item Known Problems
+
+=item Platform Specific Problems
+
+=item Reporting Bugs
+
+=item SEE ALSO
+
+=back
+
+=head2 perl584delta - what is new for perl v5.8.4
+
+=over 4
+
+=item DESCRIPTION
+
+=item Incompatible Changes
+
+=item Core Enhancements
+
+=over 4
+
+=item Malloc wrapping
+
+=item Unicode Character Database 4.0.1
+
+=item suidperl less insecure
+
+=item format
+
+=back
+
+=item Modules and Pragmata
+
+=over 4
+
+=item Updated modules
+
+Attribute::Handlers, B, Benchmark, CGI, Carp, Cwd, Exporter, File::Find,
+IO, IPC::Open3, Local::Maketext, Math::BigFloat, Math::BigInt,
+Math::BigRat, MIME::Base64, ODBM_File, POSIX, Shell, Socket, Storable,
+Switch, Sys::Syslog, Term::ANSIColor, Time::HiRes, Unicode::UCD, Win32,
+base, open, threads, utf8
+
+=back
+
+=item Performance Enhancements
+
+=item Utility Changes
+
+=item Installation and Configuration Improvements
+
+=item Selected Bug Fixes
+
+=item New or Changed Diagnostics
+
+=item Changed Internals
+
+=item Future Directions
+
+=item Platform Specific Problems
+
+=item Reporting Bugs
+
+=item SEE ALSO
+
+=back
+
+=head2 perl583delta - what is new for perl v5.8.3
 
 =over 4
 
@@ -8124,7 +8215,7 @@ DJGPP, Pthreads
 
 =item PA-RISC 2.0
 
-=item Itanium
+=item Itanium & Itanium 2
 
 =item Portability Between PA-RISC Versions
 
@@ -8215,7 +8306,9 @@ systems
 
 =over 4
 
-=item Compiling Perl 5 on MachTen
+=item Perl version 5.8.x and greater not supported
+
+=item Compiling Perl 5.6.x on MachTen
 
 =item Failures during C<make test> on MachTen
 
@@ -9069,7 +9162,7 @@ LIST, waitpid PID,FLAGS
 =item Setting Up Perl on Win32
 
 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform
-SDK 64-bit Compiler, MinGW32 with gcc, MinGW release 1
+SDK 64-bit Compiler, MinGW release 3 with gcc, MinGW release 1 with gcc
 
 =item Building
 
@@ -9091,6 +9184,8 @@ Miscellaneous Things
 
 =item BUGS AND CAVEATS
 
+=item ACKNOWLEDGEMENTS
+
 =item AUTHORS
 
 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
@@ -9176,8 +9271,7 @@ A thread exited while %d other threads were still running
 =item BUGS
 
 Parent-Child threads, Returning objects, Creating threads inside BEGIN
-blocks, PERL_OLD_SIGNALS are not threadsafe, will not be, Detached threads
-on Windows
+blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
 
 =item AUTHOR and COPYRIGHT
 
@@ -9285,6 +9379,10 @@ FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
 
 =item DESCRIPTION
 
+=item DIAGNOSTICS
+
+Base class package "%s" is empty
+
 =item HISTORY
 
 =item CAVEATS
@@ -9961,22 +10059,24 @@ utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
 
 =item What IS a version
 
-Numeric Versions, V-String Versions
+Numeric Versions, Quoted Versions
+
+=item What about v-strings?
 
 =item Numeric Versions
 
-=item V-String Versions
+=item Quoted Versions
 
 =item Object Methods
 
-New Operator, Stringification, Numification, Comparison operators, Logical
-Operators
+New Operator, qv(), Normal Form, Numification, Stringification, Comparison
+operators, Logical Operators
 
 =item Quoting
 
 =item Types of Versions Objects
 
-Ordinary versions, alpha versions
+Ordinary versions, Alpha versions
 
 =item Replacement UNIVERSAL::VERSION
 
@@ -10437,32 +10537,84 @@ B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
 
 =item OPTIONS
 
-B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
-B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
-B<-terse>, B<-linenoise>, B<-debug>, B<-env>
+=over 4
+
+=item Options for Opcode Ordering
+
+B<-basic>, B<-exec>, B<-tree>
+
+=item Options for Line-Style
+
+B<-concise>, B<-terse>, B<-linenoise>, B<-debug>, B<-env>
+
+=item Options for tree-specific formatting
+
+B<-compact>, B<-loose>, B<-vt>, B<-ascii>
+
+=item Options controlling sequence numbering
+
+B<-base>I<n>, B<-bigendian>, B<-littleendian>
+
+=item Other options
+
+B<-main>, B<-nomain>, B<-nobanner>, B<-banner>, B<-banneris> => subref
+
+=item Option Stickiness
+
+=back
+
+=item ABBREVIATIONS
+
+=over 4
+
+=item OP class abbreviations
+
+=item OP flags abbreviations
+
+=back
 
 =item FORMATTING SPECIFICATIONS
 
+=over 4
+
+=item Special Patterns
+
 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
-B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
+B<~>
+
+=item # Variables
+
+B<#>I<var>, B<#>I<var>I<N>, B<#>I<Var>, B<#addr>, B<#arg>, B<#class>,
 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
-B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
-B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
+B<#seq>, B<#opt>, B<#static>, B<#sibaddr>, B<#svaddr>, B<#svclass>,
+B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
 
-=item ABBREVIATIONS
+=back
+
+=item Using B::Concise outside of the O framework
 
 =over 4
 
-=item OP flags abbreviations
+=item Example: Altering Concise Renderings
 
-=item OP class abbreviations
+=item set_style()
 
-=back
+=item set_style_standard($name)
 
-=item Using B::Concise outside of the O framework
+=item add_style()
+
+=item add_callback()
+
+=item Running B::Concise::compile()
+
+=item B::Concise::reset_sequence()
+
+=item Errors
+
+=back
 
 =item AUTHOR
 
@@ -11330,7 +11482,7 @@ module
 
 =back
 
-=head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
+=head2 Carp::Heavy - heavy machinery, no user serviceable parts inside
 
 =head2 Class::ISA -- report the search path for a class's ISA tree
 
@@ -11633,8 +11785,8 @@ C<perl>, C<perl_patchlevel>
 
 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
-C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
-C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
+C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>,
+C<procselfexe>, C<prototype>, C<ptrsize>
 
 =item q
 
@@ -11700,7 +11852,7 @@ C<versiononly>, C<vi>, C<voidflags>
 
 =item x
 
-C<xlibpth>, C<xs_apiversion>
+C<xlibpth>
 
 =item y
 
@@ -11728,7 +11880,7 @@ C<zcat>, C<zip>
 
 =item getcwd and friends
 
-getcwd, cwd, fastcwd, fastgetcwd
+getcwd, cwd, fastcwd, fastgetcwd, getdcwd
 
 =item abs_path and friends
 
@@ -11740,6 +11892,8 @@ abs_path, realpath, fast_abs_path
 
 =item NOTES
 
+=item AUTHOR
+
 =item SEE ALSO
 
 =back
@@ -11781,6 +11935,74 @@ CLIENT->output(LIST)
 
 =back
 
+=head2 DBM_Filter -- Filter DBM keys/values 
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item What is a DBM Filter?
+
+=over 4
+
+=item So what's new?
+
+=back
+
+=item METHODS
+
+=over 4
+
+=item $db->Filter_Push()
+
+=item $db->Filter_Key_Push()
+
+=item $db->Filter_Value_Push()
+
+Filter_Push, Filter_Key_Push, Filter_Value_Push
+
+=item $db->Filter_Pop()
+
+=item $db->Filtered()
+
+=back
+
+=item Writing a Filter
+
+=over 4
+
+=item Immediate Filters
+
+=item Canned Filters
+
+"name", params
+
+=back
+
+=item Filters Included
+
+utf8, encode, compress, int32, null
+
+=item NOTES
+
+=over 4
+
+=item Maintain Round Trip Integrity
+
+=item Don't mix filtered & non-filtered data in the same database file. 
+
+=back
+
+=item EXAMPLE
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=back
+
 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
 
 =over 4
@@ -12180,10 +12402,10 @@ compactDump, veryCompact, set, get
 =item DESCRIPTION
 
 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
-@dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
-dl_load_file(), dl_unload_file(), dl_load_flags(), dl_find_symbol(),
-dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
-bootstrap()
+@dl_modules, @dl_shared_objects, dl_error(), $dl_debug, dl_findfile(),
+dl_expandspec(), dl_load_file(), dl_unload_file(), dl_load_flags(),
+dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(),
+dl_install_xsub(), bootstrap()
 
 =item AUTHOR
 
@@ -13970,6 +14192,8 @@ fixpath
 
 os_flavor
 
+blibdirs_target (override)
+
 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
 ExtUtils::MakeMaker
 
@@ -14531,6 +14755,8 @@ $dont_use_nlink, symlinks
 
 =item NOTES
 
+=item BUGS AND CAVEATS
+
 =item HISTORY
 
 =back
@@ -14992,8 +15218,6 @@ cacheout EXPR, cacheout MODE, EXPR
 
 =item BUGS
 
-=item NOTES
-
 =back
 
 =head2 FileHandle - supply object methods for filehandles
@@ -15329,6 +15553,9 @@ the function alternate_language_tags($lang1)
 
 the function @langs = panic_languages(@accept_languages)
 
+the function implicate_supers( ...languages... ), the function
+implicate_supers_strictly( ...languages... )
+
 =over 4
 
 =item ABOUT LOWERCASING
@@ -15343,6 +15570,26 @@ the function @langs = panic_languages(@accept_languages)
 
 =back
 
+=head2 I18N::LangTags::Detect - detect the user's language preferences
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item FUNCTIONS
+
+=item ENVIRONMENT
+
+=item SEE ALSO
+
+=item COPYRIGHT
+
+=item AUTHOR
+
+=back
+
 =head2 I18N::LangTags::List -- tags and names for human languages
 
 =over 4
@@ -17242,23 +17489,23 @@ hostfqdn (), hostname (), hostdomain ()
 
 =item CONSTRUCTOR
 
-new (HOST [,OPTIONS])
+new ([ HOST ] [, OPTIONS ])
 
 =item METHODS
 
 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
 site (ARGS), ascii, binary, rename ( OLDNAME, NEWNAME ), delete ( FILENAME
 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR [,
-RECURSE ]), mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), alloc ( SIZE [,
-RECORD_SIZE] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]]
-), put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [,
-REMOTE_FILE ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (),
-mdtm ( FILE ), size ( FILE ), supported ( CMD ), hash (
-[FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [
-DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe ( FILE ), port (
-[ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
-pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait (
-NON_PASV_SERVER ), abort (), quit ()
+RECURSE ]), mkdir ( DIR [, RECURSE ]), alloc ( SIZE [, RECORD_SIZE] ), ls (
+[ DIR ] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ),
+put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE
+] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ),
+size ( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[
+BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ DIR ] ), retr ( FILE ),
+stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [ PORT ] ), pasv (),
+pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_xfer_unique (
+SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( NON_PASV_SERVER ),
+abort (), quit ()
 
 =over 4
 
@@ -17351,14 +17598,15 @@ MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
 
 =item CONSTRUCTOR
 
-new ( [ HOST, ] [ OPTIONS ] )
+new ( [ HOST ] [, OPTIONS ] 0
 
 =item METHODS
 
-user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
-PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
-[, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
-MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
+auth ( USERNAME, PASSWORD ), user ( USER ), pass ( PASS ), login ( [ USER
+[, PASS ]] ), apop ( [ USER [, PASS ]] ), banner (), capa (),  capabilities
+(), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [, FH ]
+), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ]
+), delete ( MSGNUM ), reset (), quit ()
 
 =item NOTES
 
@@ -17415,17 +17663,17 @@ $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
 
 =item CONSTRUCTOR
 
-new Net::SMTP [ HOST, ] [ OPTIONS ]
+new ( [ HOST ] [, OPTIONS ] )
 
 =item METHODS
 
-banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
-PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
-ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
-ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
-ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
-DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
-quit ()
+banner (), domain (), hello ( DOMAIN ), host (), etrn ( DOMAIN ), auth (
+USERNAME, PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ),
+send_or_mail ( ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient (
+ADDRESS [, ADDRESS, [...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]]
+), cc ( ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ),
+data ( [ DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [
+$subject ] ), quit ()
 
 =item ADDRESSES
 
@@ -19443,10 +19691,16 @@ set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
 
 =over 4
 
-=item OBJECT ORIENTED SYNTAX
+=item Caveats
+
+=item Escaping Magic Characters
+
+=item Configuration
 
 =back
 
+=item BUGS
+
 =item AUTHOR
 
 =back
@@ -19785,6 +20039,8 @@ NORMAL TESTS, SKIPPED TESTS, TODO TESTS
 
 =item BUGS and CAVEATS
 
+=item ENVIRONMENT
+
 =item NOTE
 
 =item SEE ALSO
@@ -20847,6 +21103,8 @@ $which )
 
 =item Ambiguous Local Times (DST)
 
+=item Non-Existent Local Times (DST)
+
 =item Negative Epoch Values
 
 =back
@@ -21163,39 +21421,6 @@ March 18th, 2000
 
 =back
 
-=head2 Win32 - Interfaces to some Win32 API Functions
-
-=over 4
-
-=item DESCRIPTION
-
-=over 4
-
-=item Alphabetical Listing of Win32 Functions
-
-Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
-Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
-Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
-Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
-Win32::GetChipName(), Win32::GetCwd(), Win32::GetFolderPath(FOLDER [,
-CREATE]), Win32::GetFullPathName(FILENAME), Win32::GetLastError(),
-Win32::GetLongPathName(PATHNAME), Win32::GetNextAvailDrive(),
-Win32::GetOSVersion(), Win32::GetOSName(),
-Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
-PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
-Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
-Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
-SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
-Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
-Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
-Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
-Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
-Win32::UnregisterServer(LIBRARYNAME)
-
-=back
-
-=back
-
 =head2 XSLoader - Dynamically load C libraries into Perl code
 
 =over 4