Re: [PATCH @14870] long C<=item>s and other pod->man->troff problems
[p5sagit/p5-mst-13.2.git] / pod / perltoc.pod
index 6e045f4..806e12f 100644 (file)
@@ -101,8 +101,8 @@ Parentheses for capturing, Other regexp features
 
 =back
 
-=head2 perlfaq - frequently asked questions about Perl ($Date: 2001/11/19
-17:09:37 $)
+=head2 perlfaq - frequently asked questions about Perl ($Date: 2002/01/31
+04:27:54 $)
 
 =over 4
 
@@ -122,7 +122,7 @@ Parentheses for capturing, Other regexp features
 
 =item L<perlfaq5>: Files and Formats
 
-=item L<perlfaq6>: Regexps
+=item L<perlfaq6>: Regular Expressions
 
 =item L<perlfaq7>: General Perl Language Issues
 
@@ -426,22 +426,22 @@ lstat EXPR, lstat, m//, map BLOCK LIST, map EXPR,LIST, mkdir FILENAME,MASK,
 mkdir FILENAME, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgrcv
 ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my EXPR : ATTRIBUTES,
 next LABEL, next, no Module LIST, oct EXPR, oct, open FILEHANDLE,EXPR, open
-FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE,
-opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR : ATTRIBUTES,
-pack TEMPLATE,LIST, package NAMESPACE, package, pipe
-READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos, print FILEHANDLE
-LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST, printf FORMAT,
-LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/, qq/STRING/,
-qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta, rand EXPR,
-rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read FILEHANDLE,SCALAR,LENGTH,
-readdir DIRHANDLE, readline EXPR, readlink EXPR, readlink, readpipe EXPR,
-recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, ref EXPR, ref, rename
-OLDNAME,NEWNAME, require VERSION, require EXPR, require, reset EXPR, reset,
-return EXPR, return, reverse LIST, rewinddir DIRHANDLE, rindex
-STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, rmdir, s///, scalar
-EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir DIRHANDLE,POS, select
-FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, semctl
-ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
+FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, open
+FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, opendir DIRHANDLE,EXPR, ord
+EXPR, ord, our EXPR, our EXPR : ATTRIBUTES, pack TEMPLATE,LIST, package
+NAMESPACE, package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos
+SCALAR, pos, print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE
+FORMAT, LIST, printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST,
+q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR,
+quotemeta, rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
+FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
+readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
+ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR,
+require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir
+DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME,
+rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir
+DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT,
+semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
@@ -842,8 +842,8 @@ B<-D>I<letters>, B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>,
 B<-h>, 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<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>, B<-X>,
-B<-x> I<directory>
+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>
 
 =back
 
@@ -944,10 +944,10 @@ B<-w>, B<-W>, B<-X>
 
 =item Debugger Commands
 
-h [command], p expr, x expr, V [pkg [vars]], X [vars], T, s [expr], n
-[expr], r, <CR>, c [line|sub], l, l min+incr, l min-max, l line, l subname,
--, w [line], f filename, /pattern/, ?pattern?, L, S [[!]regex], t, t expr,
-b [line] [condition], b subname [condition], b postpone subname
+h [command], p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], T, s
+[expr], n [expr], r, <CR>, c [line|sub], l, l min+incr, l min-max, l line,
+l subname, -, w [line], f filename, /pattern/, ?pattern?, L, S [[!]regex],
+t, t expr, b [line] [condition], b subname [condition], b postpone subname
 [condition], b load filename, b compile subname, d [line], D, a [line]
 command, a [line], A, W expr, W, O booloption .., O anyoption? .., O
 option=value .., < ?, < [ command ], << command, > ?, > command, >>
@@ -960,9 +960,10 @@ cmd, @ file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, man
 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
-C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
-C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>, C<HighBit>,
-C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>, C<NonStop>
+C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
+C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
+C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
+C<NonStop>
 
 =item Debugger input/output
 
@@ -1168,6 +1169,8 @@ $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
 
 =item  Unicode
 
+=item Another Portable Binary Encoding
+
 =back
 
 =item Lengths and Widths
@@ -1178,8 +1181,6 @@ $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
 
 =item Dynamic Templates
 
-=item Another Portable Binary Encoding
-
 =back
 
 =item Packing and Unpacking C Structures
@@ -1198,6 +1199,8 @@ $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
 
 =item Pack Recipes
 
+=item Funnies Section
+
 =item Authors
 
 =back
@@ -2203,6 +2206,8 @@ LC_NUMERIC, LC_TIME, LANG
 
 =item Unicode I/O
 
+=item Displaying Unicode As Text
+
 =item Special Cases
 
 =item Advanced Topics
@@ -2212,10 +2217,10 @@ LC_NUMERIC, LC_TIME, LANG
 =item Questions With Answers
 
 Will My Old Scripts Break?, How Do I Make My Scripts Work With Unicode?,
-How Do I Know Whether My String Is In Unicode?, How Do I Detect Invalid
-UTF-8?, How Do I Convert Data Into UTF-8?  Or Vice Versa?, How Do I Display
-Unicode?  How Do I Input Unicode?, How Does Unicode Work With Traditional
-Locales?
+How Do I Know Whether My String Is In Unicode?, How Do I Detect Data That's
+Not Valid In a Particular Encoding, How Do I Convert Binary Data Into a
+Particular Encoding, Or Vice Versa?, How Do I Display Unicode? How Do I
+Input Unicode?, How Does Unicode Work With Traditional Locales?
 
 =item Hexadecimal Notation
 
@@ -2266,13 +2271,15 @@ to enable UTF-8/UTF-EBCDIC in scripts
 
 =item Unicode Encodings
 
-UTF-8, UTF-16, UTF-16BE, UTF16-LE, Surrogates, and BOMs (Byte Order Marks),
-UTF-32, UTF-32BE, UTF32-LE, UCS-2, UCS-4, UTF-7
+UTF-8, UTF-EBCDIC, UTF-16, UTF-16BE, UTF16-LE, Surrogates, and BOMs (Byte
+Order Marks), UTF-32, UTF-32BE, UTF32-LE, UCS-2, UCS-4, UTF-7
 
 =item Security Implications of Malformed UTF-8
 
 =item Unicode in Perl on EBCDIC
 
+=item Using Unicode in XS
+
 =back
 
 =item SEE ALSO
@@ -2488,48 +2495,43 @@ module (sometimes unnecessary), B<INSTALL> the module
 
 =item Pragmatic Modules
 
-attributes, attrs, autouse, base, blib, bytes, charnames, constant,
-diagnostics, encoding, fields, filetest, integer, less, locale, open, ops,
-overload, re, sigtrap, sort, strict, subs, threads, utf8, vars, vmsish,
-warnings, warnings::register
+attributes, autouse, base, blib, bytes, charnames, constant, diagnostics,
+encoding, fields, filetest, integer, less, locale, open, overload, sigtrap,
+sort, strict, subs, utf8, vars, vmsish, warnings, warnings::register
 
 =item Standard Modules
 
-AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
-B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
-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, Cwd, DB, DB_File, Devel::SelfStubber, Digest, DirHandle,
-Dumpvalue, Encode, Encode::EncodeFormat, Encode::Tcl, English, Env,
-Exporter, Exporter::Heavy, ExtUtils::Command, ExtUtils::Constant,
-ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
-ExtUtils::MM_Cygwin, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_Unix,
-ExtUtils::MM_VMS, ExtUtils::MM_Win32, ExtUtils::MakeMaker,
-ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists,
-ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename,
-File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find,
-File::Path, File::Spec, File::Spec::Epoc, File::Spec::Functions,
+AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, Benchmark, 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, Cwd, DB, Devel::SelfStubber,
+Digest, DirHandle, Dumpvalue, English, Env, Exporter, Exporter::Heavy,
+ExtUtils::Command, ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install,
+ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM_Cygwin,
+ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_Unix, ExtUtils::MM_VMS,
+ExtUtils::MM_Win32, ExtUtils::MakeMaker, ExtUtils::Manifest,
+ExtUtils::Mkbootstrap, ExtUtils::Mksymlists, ExtUtils::Packlist,
+ExtUtils::testlib, Fatal, File::Basename, File::CheckTree, File::Compare,
+File::Copy, File::DosGlob, File::Find, File::Path, File::Spec,
+File::Spec::Cygwin, File::Spec::Epoc, File::Spec::Functions,
 File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, File::Spec::VMS,
 File::Spec::Win32, File::Temp, File::stat, FileCache, FileHandle,
 Filter::Simple, FindBin, Getopt::Long, Getopt::Std, I18N::Collate,
-I18N::LangTags, I18N::LangTags::List, IO, IPC::Open2, IPC::Open3,
+I18N::LangTags, I18N::LangTags::List, IPC::Open2, IPC::Open3,
 Locale::Constants, Locale::Country, Locale::Currency, Locale::Language,
 Locale::Maketext, Locale::Maketext::TPJ13, Math::BigFloat, Math::BigInt,
 Math::BigInt::Calc, Math::Complex, Math::Trig, Memoize,
 Memoize::AnyDBM_File, Memoize::Expire, Memoize::ExpireFile,
 Memoize::ExpireTest, Memoize::NDBM_File, Memoize::SDBM_File,
-Memoize::Saves, 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,
-Pod::Checker, Pod::Find, Pod::Html, Pod::InputObjects, Pod::LaTeX,
-Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser, Pod::Plainer,
-Pod::Select, Pod::Text, Pod::Text::Color, Pod::Text::Overstrike,
-Pod::Text::Termcap, Pod::Usage, Pod::t::basic, SDBM_File, Safe,
-Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch,
-Symbol, Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine, Test,
+Memoize::Storable, 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,
+PerlIO, Pod::Checker, Pod::Find, Pod::Functions, Pod::Html,
+Pod::InputObjects, Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils,
+Pod::Parser, Pod::Plainer, Pod::Select, Pod::Text, Pod::Text::Color,
+Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage, Pod::t::basic,
+Search::Dict, SelectSaver, SelfLoader, Shell, Switch, Symbol,
+Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine, Test,
 Test::Builder, Test::Harness, Test::More, Test::Simple, Test::Tutorial,
 Text::Abbrev, Text::Balanced, Text::ParseWords, Text::Soundex, Text::Tabs,
 Text::Wrap, Thread, Tie::Array, Tie::Handle, Tie::Hash, Tie::RefHash,
@@ -2713,8 +2715,8 @@ tarball, Announce to the modules list, Announce to clpa, Fix bugs!
 
 =back
 
-=head2 perlfaq1 - General Questions About Perl ($Revision: 1.2 $, $Date:
-2001/11/09 08:06:04 $)
+=head2 perlfaq1 - General Questions About Perl ($Revision: 1.6 $, $Date:
+2002/01/31 01:46:23 $)
 
 =over 4
 
@@ -2752,7 +2754,7 @@ Scheme, or Tcl?
 =item Where can I get a list of Larry Wall witticisms?
 
 =item How can I convince my sysadmin/supervisor/employees to use version
-5/5.005/Perl instead of some other language?
+5/5.6.1/Perl instead of some other language?
 
 =back
 
@@ -2760,8 +2762,8 @@ Scheme, or Tcl?
 
 =back
 
-=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.3 $,
-$Date: 2001/11/09 08:06:04 $)
+=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.8 $,
+$Date: 2002/02/08 22:31:57 $)
 
 =over 4
 
@@ -2808,7 +2810,7 @@ References, Tutorials, Task-Oriented, Special Topics
 
 =item Where do I send bug reports?
 
-=item What is perl.com? Perl Mongers? pm.org? perl.org?
+=item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
 
 =back
 
@@ -2816,8 +2818,8 @@ References, Tutorials, Task-Oriented, Special Topics
 
 =back
 
-=head2 perlfaq3 - Programming Tools ($Revision: 1.10 $, $Date: 2001/11/19
-17:09:37 $)
+=head2 perlfaq3 - Programming Tools ($Revision: 1.15 $, $Date: 2002/02/11
+19:29:52 $)
 
 =over 4
 
@@ -2891,8 +2893,7 @@ stringification, Pass by reference, Tie large variables to disk
 =item I've read perlembed, perlguts, etc., but I can't embed perl in
 my C program; what am I doing wrong?
 
-=item When I tried to run my script, I got this message. What does it
-mean?
+=item When I tried to run my script, I got this message. What does it mean?
 
 =item What's MakeMaker?
 
@@ -2902,8 +2903,8 @@ mean?
 
 =back
 
-=head2 perlfaq4 - Data Manipulation ($Revision: 1.8 $, $Date: 2001/11/09
-08:06:04 $)
+=head2 perlfaq4 - Data Manipulation ($Revision: 1.14 $, $Date: 2002/02/08
+22:30:23 $)
 
 =over 4
 
@@ -2921,7 +2922,7 @@ numbers I should be getting (eg, 19.95)?
 =item Does Perl have a round() function?  What about ceil() and floor()? 
 Trig functions?
 
-=item How do I convert between numeric representations:
+=item How do I convert between numeric representations?
 
 B<How do I convert Hexadecimal into decimal:>, B<How do I convert from
 decimal to hexadecimal:>, B<How do I convert from octal to decimal:>, B<How
@@ -3117,8 +3118,8 @@ array of hashes or arrays?
 
 =back
 
-=head2 perlfaq5 - Files and Formats ($Revision: 1.4 $, $Date: 2001/11/09
-08:06:04 $)
+=head2 perlfaq5 - Files and Formats ($Revision: 1.9 $, $Date: 2002/02/11
+19:30:21 $)
 
 =over 4
 
@@ -3210,7 +3211,8 @@ protected files?  Isn't this a bug in Perl?
 
 =back
 
-=head2 perlfaq6 - Regexes ($Revision: 1.4 $, $Date: 2001/11/09 08:06:04 $)
+=head2 perlfaq6 - Regular Expressions ($Revision: 1.8 $, $Date: 2002/01/31
+04:27:55 $)
 
 =over 4
 
@@ -3276,8 +3278,8 @@ file?
 
 =back
 
-=head2 perlfaq7 - Perl Language Issues ($Revision: 1.4 $, $Date: 2001/11/07
-02:27:50 $)
+=head2 perlfaq7 - General Perl Language Issues ($Revision: 1.7 $, $Date:
+2002/01/31 04:27:55 $)
 
 =over 4
 
@@ -3355,8 +3357,8 @@ is in scope?
 
 =back
 
-=head2 perlfaq8 - System Interaction ($Revision: 1.4 $, $Date: 2001/11/09
-08:06:04 $)
+=head2 perlfaq8 - System Interaction ($Revision: 1.6 $, $Date: 2002/01/28
+04:17:27 $)
 
 =over 4
 
@@ -3483,7 +3485,7 @@ search path?
 
 =back
 
-=head2 perlfaq9 - Networking ($Revision: 1.5 $, $Date: 2001/11/09 08:06:04
+=head2 perlfaq9 - Networking ($Revision: 1.7 $, $Date: 2002/01/28 04:17:27
 $)
 
 =over 4
@@ -4276,47 +4278,111 @@ B<filter_fetch_value>
 
 =item DESCRIPTION
 
+=item "Gimme" Values
+
+GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
+
+=item Array Manipulation Functions
+
 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,
-ax, bytes_from_utf8, bytes_to_utf8, call_argv, call_method, call_pv,
-call_sv, CLASS, Copy, croak, CvSTASH, cv_const_sv, dAX, dITEMS, dMARK,
-dORIGMARK, dSP, dXSARGS, dXSI32, ENTER, eval_pv, eval_sv, EXTEND,
-fbm_compile, fbm_instr, FREETMPS, getcwd_sv, get_av, get_cv, get_hv,
-get_sv, GIMME, GIMME_V, grok_bin, grok_hex, grok_number,
-grok_numeric_radix, grok_oct, GvSV, gv_fetchmeth, gv_fetchmethod,
-gv_fetchmethod_autoload, gv_stashpv, gv_stashsv, G_ARRAY, G_DISCARD,
-G_EVAL, G_NOARGS, G_SCALAR, G_VOID, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV,
-HeSVKEY, HeSVKEY_force, HeSVKEY_set, HeVAL, HvNAME, hv_clear, 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_iterval, hv_magic, hv_store, hv_store_ent, hv_undef, isALNUM, isALPHA,
-isDIGIT, isLOWER, isSPACE, isUPPER, is_utf8_char, is_utf8_string, items,
-ix, LEAVE, load_module, looks_like_number, MARK, mg_clear, mg_copy,
-mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set, Move, New, newAV,
-Newc, newCONSTSUB, newHV, newRV_inc, newRV_noinc, NEWSV, newSV, newSViv,
-newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv,
-newSVuv, newXS, newXSproto, Newz, new_vstring, Nullav, Nullch, Nullcv,
-Nullhv, Nullsv, ORIGMARK, perl_alloc, perl_clone, perl_construct,
-perl_destruct, perl_free, perl_parse, perl_run, PL_modglobal, PL_na,
-PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, POPl, POPn, POPp, POPpbytex, POPpx,
-POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew, Renewc,
-require_pv, RETVAL, Safefree, savepv, savepvn, SAVETMPS, scan_bin,
-scan_hex, scan_oct, sharedsv_find, sharedsv_init, sharedsv_lock,
-sharedsv_new, sharedsv_thrcnt_dec, sharedsv_thrcnt_inc, sharedsv_unlock,
-sortsv, SP, SPAGAIN, ST, strEQ, strGE, strGT, strLE, strLT, strNE, strnEQ,
-strnNE, StructCopy, SvCUR, SvCUR_set, SvEND, SvGETMAGIC, SvGROW, SvIOK,
-SvIOKp, SvIOK_notUV, SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV,
-SvIOK_UV, SvIV, SvIVX, SvIVx, 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, SvSETMAGIC,
-SvSetMagicSV, SvSetMagicSV_nosteal, 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, SvUOK,
-SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVx, SvUVX, sv_2bool,
+get_av, newAV, Nullav, sortsv
+
+=item Callback Functions
+
+call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
+FREETMPS, LEAVE, SAVETMPS
+
+=item Character classes
+
+isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
+
+=item Cloning an interpreter
+
+perl_clone
+
+=item CV Manipulation Functions
+
+CvSTASH, get_cv, Nullcv
+
+=item Embedding Functions
+
+load_module, perl_alloc, perl_construct, perl_destruct, perl_free,
+perl_parse, perl_run, require_pv
+
+=item Global Variables
+
+PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
+
+=item GV Functions
+
+GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload, gv_stashpv,
+gv_stashsv
+
+=item Handy Values
+
+HEf_SVKEY, Nullch, Nullsv
+
+=item Hash Manipulation Functions
+
+get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set,
+HeVAL, HvNAME, hv_clear, 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_iterval, hv_magic, hv_store,
+hv_store_ent, hv_undef, newHV, Nullhv
+
+=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
+
+=item Memory Management
+
+Copy, Move, New, Newc, NEWSV, Newz, Renew, Renewc, Safefree, savepv,
+savepvn, savesharedpv, StructCopy, Zero
+
+=item Miscellaneous Functions
+
+fbm_compile, fbm_instr, form, getcwd_sv, strEQ, strGE, strGT, strLE, strLT,
+strNE, strnEQ, strnNE
+
+=item Numeric functions
+
+grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
+scan_hex, scan_oct
+
+=item Optree Manipulation Functions
+
+cv_const_sv, newCONSTSUB, newXS
+
+=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_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
+
+=item SV Flags
+
+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,
+new_vstring, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV,
+SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIV, SvIVX,
+SvIVx, 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, 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,
@@ -4324,25 +4390,35 @@ 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_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_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_recode_to_utf8, 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, sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn,
-sv_usepvn_mg, sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode,
-sv_utf8_upgrade, sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn,
-THIS, toLOWER, toUPPER, to_utf8_case, utf8n_to_uvchr, utf8n_to_uvuni,
-utf8_distance, utf8_hop, utf8_length, utf8_to_bytes, utf8_to_uvchr,
-utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8, 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
+sv_len_utf8, sv_magic, sv_magicext, sv_mortalcopy, sv_newmortal, sv_newref,
+sv_nolocking, sv_nosharing, sv_nounlocking, 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, sv_unref_flags, sv_untaint, sv_upgrade,
+sv_usepvn, sv_usepvn_mg, sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode,
+sv_utf8_upgrade, sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn
+
+=item Unicode Support
+
+bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
+pv_uni_display, sv_recode_to_utf8, sv_uni_display, to_utf8_case,
+to_utf8_fold, to_utf8_lower, to_utf8_title, to_utf8_upper, utf8n_to_uvchr,
+utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length, utf8_to_bytes,
+utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, 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
+
+=item Warning and Dieing
+
+croak, warn
 
 =item AUTHORS
 
@@ -4357,9 +4433,30 @@ Zero
 
 =item DESCRIPTION
 
-djSP, is_gv_magical, LVRET, PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn,
-PL_last_in_gv, PL_ofs_sv, PL_rs, report_uninit, start_glob, sv_add_arena,
-sv_clean_all, sv_clean_objs, sv_free_arenas
+=item Global Variables
+
+PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
+PL_rs
+
+=item GV Functions
+
+is_gv_magical
+
+=item IO Functions
+
+start_glob
+
+=item Pad Data Structures
+
+CvPADLIST
+
+=item Stack Manipulation Macros
+
+djSP, LVRET
+
+=item SV Manipulation Functions
+
+report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
 
 =item AUTHORS
 
@@ -4398,20 +4495,25 @@ PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
 
 =item Methods in Detail
 
- IV            (*Pushed)(PerlIO *f,const char *mode, SV *arg);,  IV       
-    (*Popped)(PerlIO *f);,  PerlIO *       (*Open)(...);, SV *            
-(*Getarg)(PerlIO *f);, IV      (*Fileno)(PerlIO *f);,  SSize_t
-(*Read)(PerlIO *f, void *vbuf, Size_t count);, SSize_t (*Unread)(PerlIO
-*f, const void *vbuf, Size_t count);,  SSize_t (*Write)(PerlIO *f, const
-void *vbuf, Size_t count);,  IV              (*Seek)(PerlIO *f, Off_t
-offset, int whence);,  Off_t          (*Tell)(PerlIO *f);,  IV            
-   (*Close)(PerlIO *f);,  IV              (*Flush)(PerlIO *f);,  IV       
-       (*Fill)(PerlIO *f);,  IV               (*Eof)(PerlIO *f);,  IV     
-   (*Error)(PerlIO *f);,  void            (*Clearerr)(PerlIO *f);,  void  
-       (*Setlinebuf)(PerlIO *f);,  STDCHAR *   (*Get_base)(PerlIO *f);, 
-Size_t               (*Get_bufsiz)(PerlIO *f);,  STDCHAR *  
-(*Get_ptr)(PerlIO *f);,  SSize_t       (*Get_cnt)(PerlIO *f);,  void      
-    (*Set_ptrcnt)(PerlIO *f,STDCHAR *ptr,SSize_t cnt);
+char * name;, Size_t size;, IV kind;, PERLIO_K_BUFFERED, PERLIO_K_CANCRLF,
+PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, PERLIO_K_RAW, IV             
+(*Pushed)(pTHX_ PerlIO *f,const char *mode, SV *arg);, IV             
+(*Popped)(pTHX_ PerlIO *f);,  PerlIO * (*Open)(...);, SV *     
+(*Getarg)(pTHX_ PerlIO *f, CLONE_PARAMS *param, int flags), IV      
+(*Fileno)(pTHX_ PerlIO *f);, PerlIO *  (*Dup)(pTHX_ PerlIO *f, PerlIO *o,
+CLONE_PARAMS *param, int flags),  SSize_t      (*Read)(pTHX_ PerlIO *f,
+void *vbuf, Size_t count);,  SSize_t   (*Unread)(pTHX_ PerlIO *f, const
+void *vbuf, Size_t count);,  SSize_t   (*Write)(PerlIO *f, const void
+*vbuf, Size_t count);, IV               (*Seek)(pTHX_ PerlIO *f, Off_t
+offset, int whence);,  Off_t            (*Tell)(pTHX_ PerlIO *f);,  IV    
+     (*Close)(pTHX_ PerlIO *f);,  IV        (*Flush)(pTHX_ PerlIO *f);, 
+IV        (*Fill)(pTHX_ PerlIO *f);,  IV          (*Eof)(pTHX_ PerlIO
+*f);,  IV          (*Error)(pTHX_ PerlIO *f);,  void              
+(*Clearerr)(pTHX_ PerlIO *f);, void            (*Setlinebuf)(pTHX_ PerlIO
+*f);,  STDCHAR *     (*Get_base)(pTHX_ PerlIO *f);,  Size_t        
+(*Get_bufsiz)(pTHX_ PerlIO *f);,  STDCHAR *    (*Get_ptr)(pTHX_ PerlIO
+*f);,  SSize_t (*Get_cnt)(pTHX_ PerlIO *f);,  void            
+(*Set_ptrcnt)(pTHX_ PerlIO *f,STDCHAR *ptr,SSize_t cnt);
 
 =item Core Layers
 
@@ -4423,6 +4525,8 @@ Size_t                  (*Get_bufsiz)(PerlIO *f);,  STDCHAR *
 
 =back
 
+=item TODO
+
 =back
 
 =head2 perlapio - perl's IO abstraction interface.
@@ -4530,7 +4634,7 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item Security audit shipped utilities
 
-=item Custom opcodes
+=item Sort out the uid-setting mess
 
 =item DLL Versioning
 
@@ -4566,6 +4670,8 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item Memory leaks after failed eval
 
+=item pack for IV, UVs, NVs, and long doubles
+
 =item pack "(stuff)*"
 
 =item bitfields in pack
@@ -4628,8 +4734,6 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item IO tutorial
 
-=item pack/unpack tutorial
-
 =item Rewrite perldoc
 
 =item Install .3p manpages
@@ -4674,8 +4778,6 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item Attach/detach debugger from running program
 
-=item Alternative RE syntax module
-
 =item GUI::Native
 
 =item foreach(reverse ...)
@@ -4702,6 +4804,8 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =over 4
 
+=item Alternative RE syntax module
+
 =item Safe signal handling
 
 =item Tie Modules
@@ -4816,6 +4920,10 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item Create debugging macros
 
+=item truncate to the people
+
+=item pack/unpack tutorial
+
 =back
 
 =back
@@ -4977,6 +5085,8 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item DESCRIPTION
 
+=item Highlights In 5.8.0
+
 =item Incompatible Changes
 
 =over 4
@@ -4985,9 +5095,13 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item AIX Dynaloading
 
+=item Attributes for C<my> variables now handled at run-time.
+
 =item Socket Extension Dynamic in VMS
 
-=item Different Definition of the Unicode Character Classes \p{In...}
+=item IEEE-format Floating Point Default on OpenVMS Alpha
+
+=item New Unicode Properties
 
 =item Perl Parser Stress Tested
 
@@ -5003,13 +5117,13 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item PerlIO is Now The Default
 
-=item Signals Are Now Safe
+=item Safe Signals
 
 =item Unicode Overhaul
 
 =item Understanding of Numbers
 
-=item Miscellaneous Enhancements
+=item Miscellaneous Changes
 
 =back
 
@@ -5073,6 +5187,8 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item Linux With Sfio Fails op/misc Test 48
 
+=item Mac OS X
+
 =item OS/390
 
 =item op/sprintf tests 129 and 130
@@ -5085,21 +5201,23 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item VMS
 
+=item Win32
+
 =item Localising a Tied Variable Leaks Memory
 
 =item Localising Tied Arrays and Hashes Is Broken
 
 =item Self-tying of Arrays and Hashes Is Forbidden
 
-=item Variable Attributes are not Currently Usable for Tieing
-
 =item Building Extensions Can Fail Because Of Largefiles
 
 =item Unicode Support on EBCDIC Still Spotty
 
 =item The Compiler Suite Is Still Experimental
 
-=item The Long Double Support is Still Experimental
+=item The Long Double Support Is Still Experimental
+
+=item Seen In Perl 5.7 But Gone Now
 
 =back
 
@@ -5331,117 +5449,537 @@ d_strtoq, d_u32align, d_ualarm, d_usleep
 
 =item Known Problems
 
-=over 4
+=over 4
+
+=item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
+
+=item lib/ftmp-security tests warn 'system possibly insecure'
+
+=item lib/io_multihomed Fails In LP64-Configured HP-UX
+
+=item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
+
+=item lib/b test 19
+
+=item Linux With Sfio Fails op/misc Test 48
+
+=item sigaction test 13 in VMS
+
+=item sprintf tests 129 and 130
+
+=item  Failure of Thread tests
+
+=item Localising a Tied Variable Leaks Memory
+
+=item Self-tying of Arrays and Hashes Is Forbidden
+
+=item Building Extensions Can Fail Because Of Largefiles
+
+=item The Compiler Suite Is Still Experimental
+
+=back
+
+=item Reporting Bugs
+
+=item SEE ALSO
+
+=item HISTORY
+
+=back
+
+=head2 perl570delta - what's new for perl v5.7.0
+
+=over 4
+
+=item DESCRIPTION
+
+=item Security Vulnerability Closed
+
+=item Incompatible Changes
+
+=item Core Enhancements
+
+=item Modules and Pragmata
+
+=over 4
+
+=item New Modules
+
+=item Updated And Improved Modules and Pragmata
+
+=back
+
+=item Utility Changes
+
+=item New Documentation
+
+=item Performance Enhancements
+
+=item Installation and Configuration Improvements
+
+=over 4
+
+=item Generic Improvements
+
+=back
+
+=item Selected Bug Fixes
+
+=over 4
+
+=item Platform Specific Changes and Fixes
+
+=back
+
+=item New or Changed Diagnostics
+
+=item Changed Internals
+
+=item Known Problems
+
+=over 4
+
+=item Unicode Support Still Far From Perfect
+
+=item EBCDIC Still A Lost Platform
+
+=item Building Extensions Can Fail Because Of Largefiles
+
+=item ftmp-security tests warn 'system possibly insecure'
+
+=item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
+
+=item Long Doubles Still Don't Work In Solaris
+
+=item Linux With Sfio Fails op/misc Test 48
+
+=item Storable tests fail in some platforms
+
+=item Threads Are Still Experimental
+
+=item The Compiler Suite Is Still Experimental
+
+=back
+
+=item Reporting Bugs
+
+=item SEE ALSO
+
+=item HISTORY
+
+=back
+
+=head2 perl561delta - what's new for perl v5.6.x
+
+=over 4
+
+=item DESCRIPTION
+
+=item Summary of changes between 5.6.0 and 5.6.1
+
+=over 4
+
+=item Security Issues
+
+=item Core bug fixes
+
+C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
+Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
+references to special variables, Lexical warnings, Spurious warnings and
+errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
+map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
+Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
+Module;>, Tests
+
+=item Core features
+
+=item Configuration issues
+
+=item Documentation
+
+=item Bundled modules
+
+B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
+Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
+IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
+Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
+
+=item Platform-specific improvements
+
+NCR MP-RAS, NonStop-UX
+
+=back
+
+=item Core Enhancements
+
+=over 4
+
+=item Interpreter cloning, threads, and concurrency
+
+=item Lexically scoped warning categories
+
+=item Unicode and UTF-8 support
+
+=item Support for interpolating named characters
+
+=item "our" declarations
+
+=item Support for strings represented as a vector of ordinals
+
+=item Improved Perl version numbering system
+
+=item New syntax for declaring subroutine attributes
+
+=item File and directory handles can be autovivified
+
+=item open() with more than two arguments
+
+=item 64-bit support
+
+=item Large file support
+
+=item Long doubles
+
+=item "more bits"
+
+=item Enhanced support for sort() subroutines
+
+=item C<sort $coderef @foo> allowed
+
+=item File globbing implemented internally
+
+=item Support for CHECK blocks
+
+=item POSIX character class syntax [: :] supported
+
+=item Better pseudo-random number generator
+
+=item Improved C<qw//> operator
+
+=item Better worst-case behavior of hashes
+
+=item pack() format 'Z' supported
+
+=item pack() format modifier '!' supported
+
+=item pack() and unpack() support counted strings
+
+=item Comments in pack() templates
+
+=item Weak references
+
+=item Binary numbers supported
+
+=item Lvalue subroutines
+
+=item Some arrows may be omitted in calls through references
+
+=item Boolean assignment operators are legal lvalues
+
+=item exists() is supported on subroutine names
+
+=item exists() and delete() are supported on array elements
+
+=item Pseudo-hashes work better
+
+=item Automatic flushing of output buffers
+
+=item Better diagnostics on meaningless filehandle operations
+
+=item Where possible, buffered data discarded from duped input filehandle
+
+=item eof() has the same old magic as <>
+
+=item binmode() can be used to set :crlf and :raw modes
+
+=item C<-T> filetest recognizes UTF-8 encoded files as "text"
+
+=item system(), backticks and pipe open now reflect exec() failure
+
+=item Improved diagnostics
+
+=item Diagnostics follow STDERR
+
+=item More consistent close-on-exec behavior
+
+=item syswrite() ease-of-use
+
+=item Better syntax checks on parenthesized unary operators
+
+=item Bit operators support full native integer width
+
+=item Improved security features
+
+=item More functional bareword prototype (*)
+
+=item C<require> and C<do> may be overridden
+
+=item $^X variables may now have names longer than one character
+
+=item New variable $^C reflects C<-c> switch
+
+=item New variable $^V contains Perl version as a string
+
+=item Optional Y2K warnings
+
+=item Arrays now always interpolate into double-quoted strings
+
+=back
+
+=item Modules and Pragmata
+
+=over 4
+
+=item Modules
+
+attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
+DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
+Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
+File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
+Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
+podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
+pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
+Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
+
+=item Pragmata
+
+=back
+
+=item Utility Changes
+
+=over 4
+
+=item dprofpp
+
+=item find2perl
+
+=item h2xs
+
+=item perlcc
+
+=item perldoc
+
+=item The Perl Debugger
+
+=back
+
+=item Improved Documentation
+
+perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
+perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
+perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
+perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
+
+=item Performance enhancements
+
+=over 4
+
+=item Simple sort() using { $a <=> $b } and the like are optimized
+
+=item Optimized assignments to lexical variables
+
+=item Faster subroutine calls
+
+=item delete(), each(), values() and hash iteration are faster
+
+=back
+
+=item Installation and Configuration Improvements
+
+=over 4
+
+=item -Dusethreads means something different
+
+=item New Configure flags
+
+=item Threadedness and 64-bitness now more daring
+
+=item Long Doubles
+
+=item -Dusemorebits
+
+=item -Duselargefiles
+
+=item installusrbinperl
+
+=item SOCKS support
+
+=item C<-A> flag
 
-=item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
+=item Enhanced Installation Directories
 
-=item lib/ftmp-security tests warn 'system possibly insecure'
+=item gcc automatically tried if 'cc' does not seem to be working
 
-=item lib/io_multihomed Fails In LP64-Configured HP-UX
+=back
 
-=item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
+=item Platform specific changes
 
-=item lib/b test 19
+=over 4
 
-=item Linux With Sfio Fails op/misc Test 48
+=item Supported platforms
 
-=item sigaction test 13 in VMS
+=item DOS
 
-=item sprintf tests 129 and 130
+=item OS390 (OpenEdition MVS)
 
-=item  Failure of Thread tests
+=item VMS
 
-=item Localising a Tied Variable Leaks Memory
+=item Win32
 
-=item Self-tying of Arrays and Hashes Is Forbidden
+=back
 
-=item Building Extensions Can Fail Because Of Largefiles
+=item Significant bug fixes
 
-=item The Compiler Suite Is Still Experimental
+=over 4
 
-=back
+=item <HANDLE> on empty files
 
-=item Reporting Bugs
+=item C<eval '...'> improvements
 
-=item SEE ALSO
+=item All compilation errors are true errors
 
-=item HISTORY
+=item Implicitly closed filehandles are safer
 
-=back
+=item Behavior of list slices is more consistent
 
-=head2 perl570delta - what's new for perl v5.7.0
+=item C<(\$)> prototype and C<$foo{a}>
 
-=over 4
+=item C<goto &sub> and AUTOLOAD
 
-=item DESCRIPTION
+=item C<-bareword> allowed under C<use integer>
 
-=item Security Vulnerability Closed
+=item Failures in DESTROY()
 
-=item Incompatible Changes
+=item Locale bugs fixed
 
-=item Core Enhancements
+=item Memory leaks
 
-=item Modules and Pragmata
+=item Spurious subroutine stubs after failed subroutine calls
 
-=over 4
+=item Taint failures under C<-U>
 
-=item New Modules
+=item END blocks and the C<-c> switch
 
-=item Updated And Improved Modules and Pragmata
+=item Potential to leak DATA filehandles
 
 =back
 
-=item Utility Changes
+=item New or Changed Diagnostics
 
-=item New Documentation
+"%s" variable %s masks earlier declaration in same %s, "my sub" not yet
+implemented, "our" variable %s redeclared, '!' allowed only after types %s,
+/ cannot take a count, / must be followed by a, A or Z, / must be followed
+by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
+\\%c passed through, /%s/: Unrecognized escape \\%c in character class
+passed through, /%s/ should probably be written as "%s", %s() called too
+early to check prototype, %s argument is not a HASH or ARRAY element, %s
+argument is not a HASH or ARRAY element or slice, %s argument is not a
+subroutine name, %s package attribute may clash with future reserved word:
+%s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
+substitution pattern, Bad realloc() ignored, Bareword found in conditional,
+Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
+size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
+filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
+Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
+Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
+remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
+weaken a nonreference, Character class [:%s:] unknown, Character class
+syntax [%s] belongs inside character classes, Constant is not %s reference,
+constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
+defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
+"local" instead of "our"?), Document contains no data, entering effective
+%s failed, false [] range "%s" in regexp, Filehandle %s opened only for
+output, flock() on closed filehandle %s, Global symbol "%s" requires
+explicit package name, Hexadecimal number > 0xffffffff non-portable,
+Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
+|%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
+number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
+%s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
+separator character %s in attribute list, Invalid separator character %s in
+subroutine attribute list, leaving effective %s failed, Lvalue subs
+returning %s not implemented yet, Method %s not permitted, Missing
+%sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
+No %s specified for -%c, No package name allowed for variable %s in "our",
+No space allowed after -%c, no UTC offset information; assuming local time
+is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
+panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
+around "%s" list, Possible unintended interpolation of %s in string,
+Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
+instead, Premature end of script headers, Repeat count in pack overflows,
+Repeat count in unpack overflows, realloc() of freed memory ignored,
+Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
+zero-length expression, switching effective %s is not implemented, This
+Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
+environ elements (%s=%s), Too late to run %s block, Unknown open() mode
+'%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
+escape \\%c passed through, Unterminated attribute parameter in attribute
+list, Unterminated attribute list, Unterminated attribute parameter in
+subroutine attribute list, Unterminated subroutine attribute list, Value of
+CLI symbol "%s" too long, Version number must be a constant number
 
-=item Performance Enhancements
+=item New tests
 
-=item Installation and Configuration Improvements
+=item Incompatible Changes
 
 =over 4
 
-=item Generic Improvements
+=item Perl Source Incompatibilities
 
-=back
+CHECK is a new keyword, Treatment of list slices of undef has changed,
+Format of $English::PERL_VERSION is different, Literals of the form
+C<1.2.3> parse differently, Possibly changed pseudo-random number
+generator, Hashing function for hash keys has changed, C<undef> fails on
+read only values, Close-on-exec bit may be set on pipe and socket handles,
+Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
+values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
+Text of some diagnostic output has changed, C<%@> has been removed,
+Parenthesized not() behaves like a list operator, Semantics of bareword
+prototype C<(*)> have changed, Semantics of bit operators may have changed
+on 64-bit platforms, More builtins taint their results
 
-=item Selected Bug Fixes
+=item C Source Incompatibilities
 
-=over 4
+C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
 
-=item Platform Specific Changes and Fixes
+=item Compatible C Source API Changes
 
-=back
+C<PATCHLEVEL> is now C<PERL_VERSION>
 
-=item New or Changed Diagnostics
+=item Binary Incompatibilities
 
-=item Changed Internals
+=back
 
 =item Known Problems
 
 =over 4
 
-=item Unicode Support Still Far From Perfect
+=item Localizing a tied hash element may leak memory
 
-=item EBCDIC Still A Lost Platform
+=item Known test failures
 
-=item Building Extensions Can Fail Because Of Largefiles
+64-bit builds, Failure of Thread tests, NEXTSTEP 3.3 POSIX test failure,
+Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with gcc
 
-=item ftmp-security tests warn 'system possibly insecure'
+=item EBCDIC platforms not fully supported
 
-=item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
+=item UNICOS/mk CC failures during Configure run
 
-=item Long Doubles Still Don't Work In Solaris
+=item Arrow operator and arrays
 
-=item Linux With Sfio Fails op/misc Test 48
+=item Experimental features
 
-=item Storable tests fail in some platforms
+Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
+pseudo-hash data type, The Compiler suite, Internal implementation of file
+globbing, The DB module, The regular expression code constructs:
 
-=item Threads Are Still Experimental
+=back
 
-=item The Compiler Suite Is Still Experimental
+=item Obsolete Diagnostics
 
-=back
+Character class syntax [: :] is reserved for future extensions, Ill-formed
+logical name |%s| in prime_env_iter, In string, @%s now must be written as
+\@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
+to mean "${$}<digit>" is deprecated
 
 =item Reporting Bugs
 
@@ -5451,7 +5989,7 @@ d_strtoq, d_u32align, d_ualarm, d_usleep
 
 =back
 
-=head2 perl56delta, perldelta - what's new for perl v5.6.0
+=head2 perl56delta - what's new for perl v5.6.0
 
 =over 4
 
@@ -5836,7 +6374,7 @@ to mean "${$}<digit>" is deprecated
 
 =back
 
-=head2 perl5005delta, perldelta - what's new for perl5.005
+=head2 perl5005delta - what's new for perl5.005
 
 =over 4
 
@@ -6012,7 +6550,7 @@ temporary file, regexp too big
 
 =back
 
-=head2 perl5004delta, perldelta - what's new for perl5.004
+=head2 perl5004delta - what's new for perl5.004
 
 =over 4
 
@@ -6331,6 +6869,8 @@ R4 x86, R4 PPC
 
 =item Contact Information
 
+=item Update 2001-12-26
+
 =back
 
 =back
@@ -6457,14 +6997,6 @@ I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
 
 =item File Permissions on Cygwin
 
-=item Hard Links on Cygwin
-
-=item Filetime Granularity on Cygwin
-
-=item Tainting Checks on Cygwin
-
-=item /etc/group on Cygwin
-
 =item Script Portability on Cygwin
 
 Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous
@@ -7413,6 +7945,8 @@ LIST, waitpid PID,FLAGS
 
 =over 4
 
+=item Multiple methods to build perl for VOS
+
 =item Stratus POSIX Support
 
 =back
@@ -7527,6 +8061,8 @@ data structures between threads
 share VARIABLE, lock VARIABLE, unlock VARIABLE, cond_wait VARIABLE,
 cond_signal VARIABLE, cond_broadcast VARIABLE
 
+=item NOTES
+
 =item BUGS
 
 =item AUTHOR
@@ -7544,7 +8080,7 @@ from perl
 
 =item DESCRIPTION
 
-$thread = new(function, LIST), $thread->join, $thread->detach,
+$thread = threads->create(function, LIST), $thread->join, $thread->detach,
 threads->self, $thread->tid
 
 =item TODO
@@ -7691,6 +8227,8 @@ escapes.
 
 =item charnames::vianame(code)
 
+=item ILLEGAL CHARACTERS
+
 =item BUGS
 
 =back
@@ -7797,6 +8335,20 @@ new, phash
 
 =back
 
+=head2 if - C<use> a Perl module if a condition holds
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item BUGS
+
+=item AUTHOR
+
+=back
+
 =head2 integer - Perl pragma to use integer arithmetic instead of floating
 point
 
@@ -7836,6 +8388,8 @@ point
 
 =back
 
+=item CAVEATS
+
 =item SEE ALSO
 
 =item AUTHOR
@@ -8061,7 +8615,7 @@ from perl
 
 =item DESCRIPTION
 
-$thread = new(function, LIST), $thread->join, $thread->detach,
+$thread = threads->create(function, LIST), $thread->join, $thread->detach,
 threads->self, $thread->tid
 
 =item TODO
@@ -8096,6 +8650,8 @@ structures between threads
 share VARIABLE, lock VARIABLE, unlock VARIABLE, cond_wait VARIABLE,
 cond_signal VARIABLE, cond_broadcast VARIABLE
 
+=item NOTES
+
 =item BUGS
 
 =item AUTHOR
@@ -8229,7 +8785,8 @@ warnings::warnif($object, $message)
 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
 attributes>, C<Declaration of %s attribute in package %s may clash with
 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
-C<Can't autotie a %s>, C<Internal error: %s symbol went missing>
+C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
+be able to apply END handler>
 
 =item AUTHOR
 
@@ -8321,7 +8878,7 @@ RV
 
 =item B::PV METHODS
 
-PV, PVX
+PV, RV, PVX
 
 =item B::PVMG METHODS
 
@@ -8329,7 +8886,7 @@ MAGIC, SvSTASH
 
 =item B::MAGIC METHODS
 
-MOREMAGIC, PRIVATE, TYPE, FLAGS, OBJ, PTR
+MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
 
 =item B::PVLV METHODS
 
@@ -8347,7 +8904,7 @@ LINE, FILE, FILEGV, GvREFCNT, FLAGS
 =item B::IO METHODS
 
 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
-BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS
+BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
 
 =item B::AV METHODS
 
@@ -8386,7 +8943,8 @@ children
 
 =item B::PMOP METHODS
 
-pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmpermflags, precomp
+pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
+pmpermflags, precomp, pmoffet
 
 =item B::SVOP METHOD
 
@@ -8412,11 +8970,11 @@ label, stash, file, cop_seq, arybase, line
 
 =item FUNCTIONS EXPORTED BY C<B>
 
-main_cv, init_av, main_root, main_start, comppadlist, sv_undef, sv_yes,
-sv_no, amagic_generation, walkoptree(OP, METHOD), walkoptree_debug(DEBUG),
-walksymtable(SYMREF, METHOD, RECURSE, PREFIX), svref_2object(SV),
-ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR), class(OBJ),
-threadsv_names
+main_cv, init_av, begin_av, end_av, main_root, main_start, comppadlist,
+regex_padav, sv_undef, sv_yes, sv_no, amagic_generation, walkoptree(OP,
+METHOD), walkoptree_debug(DEBUG), walksymtable(SYMREF, METHOD, RECURSE,
+PREFIX), svref_2object(SV), ppname(OPNUM), hash(STR), cast_I32(I), minus_c,
+cstring(STR), class(OBJ), threadsv_names
 
 =item AUTHOR
 
@@ -8431,6 +8989,8 @@ bytecode
 
 =item DESCRIPTION
 
+%insn_data, @insn_name, @optype, @specialsv_name
+
 =item AUTHOR
 
 =back
@@ -8455,6 +9015,14 @@ bytecode
 
 =item DESCRIPTION
 
+=over 4
+
+=item Functions
+
+B<find_leaders>
+
+=back
+
 =item AUTHOR
 
 =back
@@ -8492,7 +9060,9 @@ B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
 =item OPTIONS
 
 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
-B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fno-cog>, B<-On>, B<-llimit>
+B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
+B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
+B<-llimit>
 
 =item EXAMPLES
 
@@ -8601,8 +9171,8 @@ B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
 
 =item OPTIONS
 
-B<-l>, B<-p>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>, B<i>I<NUMBER>,
-B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
+B<-l>, B<-p>, B<-P>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>,
+B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
 
 =item USING B::Deparse AS A MODULE
 
@@ -8743,6 +9313,14 @@ C<-oFILENAME>, C<-r>, C<-D[tO]>
 
 =item DESCRIPTION
 
+=over 4
+
+=item Functions
+
+B<find_leaders>
+
+=back
+
 =item AUTHOR
 
 =back
@@ -8873,7 +9451,7 @@ B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
 
 =item USING THE FUNCTION-ORIENTED INTERFACE
 
-B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:netscape>, B<:html>,
+B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
 B<:standard>, B<:all>
 
 =item PRAGMAS
@@ -8884,9 +9462,9 @@ B<:standard>, B<:all>
 
 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
 
-1. start_table() (generates a <TABLE> tag), 2. end_table() (generates a
-</TABLE> tag), 3. start_ul() (generates a <UL> tag), 4. end_ul() (generates
-a </UL> tag)
+1. start_table() (generates a <table> tag), 2. end_table() (generates a
+</table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
+a </ul> tag)
 
 =back
 
@@ -9006,7 +9584,7 @@ B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
 
 1. Create a <Frameset> document, 2. Specify the destination for the
 document in the HTTP header, 3. Specify the destination for the document in
-the <FORM> tag
+the <form> tag
 
 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
 
@@ -9617,7 +10195,8 @@ C<full_sed>
 =item g
 
 C<gccosandvers>, C<gccversion>, C<gidformat>, C<gidsign>, C<gidsize>,
-C<gidtype>, C<glibpth>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
+C<gidtype>, C<glibpth>, C<gmake>, C<grep>, C<groupcat>, C<groupstype>,
+C<gzip>
 
 =item h
 
@@ -10059,6 +10638,8 @@ Dumper
 
 =back
 
+=item ppport.h
+
 =item AUTHOR
 
 =item SEE ALSO
@@ -10333,8 +10914,12 @@ variants of EBCDIC, symbol and dingbats as used by Tk on X11
 
 =back
 
-=head2 Encode::EncodeFormat, EncodeFormat - the format of encoding tables
-of the Encode extension
+=head2 Encode::Tcl - Tcl encodings
+
+=head2 Encode::lib::Encode::Tcl, Encode::Tcl - Tcl encodings
+
+=head2 Encode::lib::EncodeFormat, EncodeFormat - the format of encoding
+tables of the Encode extension
 
 =over 4
 
@@ -10348,8 +10933,6 @@ of the Encode extension
 
 =back
 
-=head2 Encode::Tcl - Tcl encodings
-
 =head2 EncodeFormat - the format of encoding tables of the Encode extension
 
 =over 4
@@ -10422,9 +11005,19 @@ arrays
 
 =item Selecting What To Export
 
+=item How to Import
+
+C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
+
+=back
+
+=item Advanced features
+
+=over 4
+
 =item Specialised Import Lists
 
-=item Exporting without using Export's import method
+=item Exporting without using Exporter's import method
 
 =item Module Version Checking
 
@@ -10432,6 +11025,8 @@ arrays
 
 =item Tag Handling Utility Functions
 
+=item Generating combined tags
+
 =item C<AUTOLOAD>ed Constants
 
 =back
@@ -10442,7 +11037,7 @@ arrays
 
 =over 4
 
-=item SYNOPIS
+=item SYNOPSIS
 
 =item DESCRIPTION
 
@@ -10629,6 +11224,19 @@ For static extensions, For dynamic extensions, For dynamic extensions
 
 =back
 
+=head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
+ExtUtils::MakeMaker
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
+perl_archive
+
 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
 ExtUtils::MakeMaker
 
@@ -11364,7 +11972,7 @@ rmscopy($from,$to[,$date_flag])
 
 =back
 
-=head2 File::Find, find - traverse a file tree
+=head2 File::Find - Traverse a directory tree.
 
 =over 4
 
@@ -11372,10 +11980,24 @@ rmscopy($from,$to[,$date_flag])
 
 =item DESCRIPTION
 
+B<find>, B<finddepth>
+
+=over 4
+
+=item %options
+
 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
 C<untaint>, C<untaint_pattern>, C<untaint_skip>
 
+=item The wanted function
+
+C<$File::Find::dir> is the current directory name,, C<$_> is the current
+filename within that directory, C<$File::Find::name> is the complete
+pathname to the file
+
+=back
+
 =item WARNINGS
 
 =item CAVEAT
@@ -11442,6 +12064,16 @@ splitdir, catpath(), abs2rel, rel2abs()
 
 =back
 
+=head2 File::Spec::Cygwin - methods for Cygwin file specs
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
 =head2 File::Spec::Epoc - methods for Epoc file specs
 
 =over 4
@@ -11544,6 +12176,14 @@ rel2abs
 
 =back
 
+canonpath
+
+splitpath
+
+splitdir
+
+catpath
+
 =head2 File::Spec::OS2 - methods for OS/2 file specs
 
 =over 4
@@ -12916,6 +13556,8 @@ set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
 BLOCK LIST, shuffle LIST, sum LIST
 
+=item KNOWN BUGS
+
 =item SUGGESTED ADDITIONS
 
 =item COPYRIGHT
@@ -12934,6 +13576,8 @@ general-utility list subroutines
 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
 BLOCK LIST, shuffle LIST, sum LIST
 
+=item KNOWN BUGS
+
 =item SUGGESTED ADDITIONS
 
 =item COPYRIGHT
@@ -12952,6 +13596,8 @@ general-utility scalar subroutines
 blessed EXPR, dualvar NUM, STRING, isweak EXPR, readonly SCALAR, reftype
 EXPR, tainted EXPR, weaken REF
 
+=item KNOWN BUGS
+
 =item COPYRIGHT
 
 =item BLATANT PLUG
@@ -12970,7 +13616,7 @@ EXPR, tainted EXPR, weaken REF
 
 =item SEE ALSO
 
-Locale::Language, Locale::Country, Locale::Currency
+Locale::Language, Locale::Country, Locale::Script, Locale::Currency
 
 =item AUTHOR
 
@@ -12984,41 +13630,21 @@ Locale::Language, Locale::Country, Locale::Currency
 
 =item SYNOPSIS
 
-=back
-
-=over 4
-
 =item DESCRIPTION
 
 B<alpha-2>, B<alpha-3>, B<numeric>
 
-=back
-
-=over 4
-
 =item CONVERSION ROUTINES
 
 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
 country_code2code( CODE, CODESET, CODESET )
 
-=back
-
-=over 4
-
 =item QUERY ROUTINES
 
 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
 
-=back
-
-=over 4
-
 =item CODE ALIASING
 
-=back
-
-=over 4
-
 =item EXAMPLES
 
 =item DOMAIN NAMES
@@ -13027,7 +13653,7 @@ C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
 
 =item SEE ALSO
 
-Locale::Language, Locale::Currency, ISO 3166,
+Locale::Language, Locale::Script, Locale::Currency, ISO 3166,
 http://www.din.de/gremien/nas/nabd/iso3166ma/,
 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
 http://www.cia.gov/cia/publications/factbook/docs/app-f.html
@@ -13045,41 +13671,26 @@ identification (ISO 4217)
 
 =item SYNOPSIS
 
-=back
-
-=over 4
-
 =item DESCRIPTION
 
 XTS, XXX
 
-=back
-
-=over 4
-
 =item CONVERSION ROUTINES
 
 code2currency(), currency2code()
 
-=back
-
-=over 4
-
 =item QUERY ROUTINES
 
 C<all_currency_codes()>, C<all_currency_names()>
 
-=back
-
-=over 4
-
 =item EXAMPLES
 
 =item KNOWN BUGS AND LIMITATIONS
 
 =item SEE ALSO
 
-Locale::Country, ISO 4217:1995, http://www.bsi-global.com/iso4217currency
+Locale::Country, Locale::Script, ISO 4217:1995,
+http://www.bsi-global.com/iso4217currency
 
 =item AUTHOR
 
@@ -13094,39 +13705,23 @@ Locale::Country, ISO 4217:1995, http://www.bsi-global.com/iso4217currency
 
 =item SYNOPSIS
 
-=back
-
-=over 4
-
 =item DESCRIPTION
 
-=back
-
-=over 4
-
 =item CONVERSION ROUTINES
 
 code2language(), language2code()
 
-=back
-
-=over 4
-
 =item QUERY ROUTINES
 
 C<all_language_codes()>, C<all_language_names()>
 
-=back
-
-=over 4
-
 =item EXAMPLES
 
 =item KNOWN BUGS AND LIMITATIONS
 
 =item SEE ALSO
 
-Locale::Country, Locale::Currency, ISO 639:1988 (E/F),
+Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
 http://lcweb.loc.gov/standards/iso639-2/langhome.html
 
 =item AUTHOR
@@ -13224,6 +13819,46 @@ $language->language_tag(), $language->encoding()
 
 =back
 
+=head2 Locale::Script - ISO codes for script identification (ISO 15924)
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+B<alpha-2>, B<alpha-3>, B<numeric>
+
+=over 4
+
+=item SPECIAL CODES
+
+=back
+
+=item CONVERSION ROUTINES
+
+code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
+script_code2code( CODE, CODESET, CODESET )
+
+=item QUERY ROUTINES
+
+C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
+
+=item EXAMPLES
+
+=item KNOWN BUGS AND LIMITATIONS
+
+=item SEE ALSO
+
+Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
+http://www.evertype.com/standards/iso15924/
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
 =head2 MIME::Base64 - Encoding and decoding of base64 strings
 
 =over 4
@@ -13360,7 +13995,7 @@ Remarks
 
 =item EXAMPLES
 
-  use Math::BigInt qw(bstr);
+  use Math::BigInt;
 
 =item Autocreating constants
 
@@ -13616,23 +14251,6 @@ Storable use
 
 =back
 
-=head2 Memoize::Saves - Plug-in module to specify which return values
-should be memoized
-
-=over 4
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item CAVEATS
-
-=item AUTHOR
-
-=item SEE ALSO
-
-=back
-
 =head2 Memoize::Storable - store Memoized data in Storable database
 
 =over 4
@@ -13900,19 +14518,24 @@ MSGNUM ), reset (), quit ()
 
 =item DESCRIPTION
 
-icmp, udp, tcp, stream, external
-
 =over 4
 
 =item Functions
 
-Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [,
-$timeout]);, $p->open($host);, $p->close();, pingecho($host [, $timeout]);
+Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);,
+$p->bind($local_addr);, $p->ping($host [, $timeout]);, $p->open($host);,
+$p->open($host);, $p->close();, pingecho($host [, $timeout]);
 
 =back
 
+=item WARNING
+
 =item NOTES
 
+=item AUTHORS
+
+=item COPYRIGHT
+
 =back
 
 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
@@ -14415,7 +15038,8 @@ Constants
 
 =item WAIT
 
-Constants, Macros
+Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
+WTERMSIG, WIFSTOPPED, WSTOPSIG
 
 =back
 
@@ -15508,8 +16132,8 @@ alt, code, indent, loose, quotes, sentence, width
 =item DIAGNOSTICS
 
 Bizarre space in item, Item called without tag, Can't open %s for reading:
-%s, Invalid quote specification "%s", %s:%d: Unknown command paragraph
-"%s", %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
+%s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
+%s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
 Unmatched =back
 
 =item RESTRICTIONS
@@ -15646,6 +16270,8 @@ E<amp>, E<apos>, E<lt>, E<gt>, E<quot>, E<sol>
 
 =item VERBATIM
 
+=item CONCLUSION
+
 =back
 
 =head2 SDBM_File - Tied access to sdbm files
@@ -15714,6 +16340,8 @@ Memory, CPU, Snooping, Signals, State Changes
 blessed EXPR, dualvar NUM, STRING, isweak EXPR, readonly SCALAR, reftype
 EXPR, tainted EXPR, weaken REF
 
+=item KNOWN BUGS
+
 =item COPYRIGHT
 
 =item BLATANT PLUG
@@ -15796,10 +16424,10 @@ socket.h defines and structure manipulators
 =item DESCRIPTION
 
 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
-INADDR_LOOPBACK, INADDR_NONE, sockaddr_in PORT, ADDRESS, sockaddr_in
-SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, unpack_sockaddr_in
-SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un SOCKADDR_UN,
-pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
+INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
+ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
+unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
+SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
 
 =back
 
@@ -15841,6 +16469,8 @@ C<Storable::is_retrieving>
 
 =back
 
+=item Storable magic
+
 =item EXAMPLES
 
 =item WARNING
@@ -16153,10 +16783,18 @@ B<ok>
 
 B<is_eq>, B<is_num>
 
-B<like>
+B<isnt_eq>, B<isnt_num>
+
+B<like>, B<unlike>
+
+B<cmp_ok>
+
+B<BAILOUT>
 
 B<skip>
 
+B<todo_skip>
+
 B<skip_rest>
 
 =over 4
@@ -16227,9 +16865,15 @@ B<_my_exit>
 
 =item The test script output
 
-B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>,
-B<$Test::Harness::verbose>, B<$Test::Harness::switches>, B<Skipping tests>,
-B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything else>
+B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
+B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
+else>
+
+=item Taint mode
+
+=item Configuration variables.
+
+B<$Test::Harness::verbose>, B<$Test::Harness::switches>
 
 =item Failure
 
@@ -16252,6 +16896,8 @@ B<_run_all_tests>
 
 B<_mk_leader>
 
+B<_leader_width>
+
 =over 4
 
 =item EXPORT
@@ -16281,6 +16927,116 @@ C<HARNESS_ACTIVE>
 
 =back
 
+=head2 Test::Harness::Assert - simple assert
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Functions
+
+B<assert>
+
+=back
+
+=back
+
+=over 4
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
+=head2 Test::Harness::Iterator - Internal Test::Harness Iterator
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
+=head2 Test::Harness::Straps - detailed analysis of test results
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Construction
+
+B<new>
+
+=back
+
+=back
+
+B<_init>
+
+=over 4
+
+=item Analysis
+
+B<analyze>
+
+=back
+
+B<analyze_fh>
+
+B<analyze_file>
+
+B<_switches>
+
+B<_INC2PERL5LIB>
+
+B<_filtered_INC>
+
+B<_restore_PERL5LIB>
+
+=over 4
+
+=item Parsing
+
+B<_is_comment>
+
+=back
+
+B<_is_header>
+
+B<_is_test>
+
+B<_is_bail_out>
+
+B<_reset_file_state>
+
+=over 4
+
+=item Results
+
+B<_detailize>
+
+=back
+
+=over 4
+
+=item EXAMPLES
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
 =head2 Test::More - yet another framework for writing test scripts
 
 =over 4
@@ -16311,6 +17067,10 @@ B<is>, B<isnt>
 
 B<like>
 
+B<unlike>
+
+B<cmp_ok>
+
 B<can_ok>
 
 B<isa_ok>
@@ -16319,6 +17079,14 @@ B<pass>, B<fail>
 
 =over 4
 
+=item Diagnostics
+
+B<diag>
+
+=back
+
+=over 4
+
 =item Module tests
 
 B<use_ok>
@@ -16335,7 +17103,7 @@ B<SKIP: BLOCK>
 
 =back
 
-B<TODO: BLOCK>
+B<TODO: BLOCK>, B<todo_skip>
 
 =over 4
 
@@ -16353,11 +17121,19 @@ B<eq_set>
 
 =over 4
 
+=item Extending and Embedding Test::More
+
+B<builder>
+
+=back
+
+=over 4
+
 =item NOTES
 
 =item BUGS and CAVEATS
 
-Making your own ok(), The eq_* family have some caveats, Test::Harness
+Making your own ok(), The eq_* family has some caveats, Test::Harness
 upgrades
 
 =item HISTORY
@@ -16702,7 +17478,8 @@ EOF this, TELL this, SEEK this, offset, whence, DESTROY this
 
 =back
 
-=head2 Tie::Hash, Tie::StdHash - base class definitions for tied hashes
+=head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
+tied hashes
 
 =over 4
 
@@ -16713,12 +17490,34 @@ EOF this, TELL this, SEEK this, offset, whence, DESTROY this
 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
 
-=item CAVEATS
+=item Inheriting from B<Tie::StdHash>
+
+=item Inheriting from B<Tie::ExtraHash>
+
+=item C<UNTIE> and C<DESTROY>
 
 =item MORE INFORMATION
 
 =back
 
+=head2 Tie::Memoize - add data to hash when needed
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item Inheriting from B<Tie::Memoize>
+
+=item EXAMPLE
+
+=item BUGS
+
+=item AUTHOR
+
+=back
+
 =head2 Tie::RefHash - use references as hash keys
 
 =over 4
@@ -16910,11 +17709,20 @@ Unicode Collation Algorithm - Unicode TR #10, L<Unicode::Normalize>
 
 =item DESCRIPTION
 
+=over 4
+
+=item Normalization Forms
+
 C<$string_NFD = NFD($raw_string)>, C<$string_NFC = NFC($raw_string)>,
 C<$string_NFKD = NFKD($raw_string)>, C<$string_NFKC = NFKC($raw_string)>,
 C<$normalized_string = normalize($form_name, $raw_string)>
 
-=over 4
+=item Character Data
+
+C<$canonical_decomposed = getCanon($codepoint)>,
+C<$compatibility_decomposed = getCompat($codepoint)>, C<$uv_composite =
+getComposite($uv_here, $uv_next)>, C<$combining_class =
+getCombinClass($codepoint)>, C<$is_exclusion = isExclusion($codepoint)>
 
 =item EXPORT
 
@@ -16924,7 +17732,7 @@ C<$normalized_string = normalize($form_name, $raw_string)>
 
 =item SEE ALSO
 
-L<Lingua::KO::Hangul::Util>, http://www.unicode.org/unicode/reports/tr15/
+http://www.unicode.org/unicode/reports/tr15/
 
 =back
 
@@ -17081,9 +17889,10 @@ 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::SetCwd(NEWDIRECTORY),
-Win32::SetLastError(ERROR), Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS,
-PID), Win32::UnregisterServer(LIBRARYNAME)
+Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
+Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
+Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
+Win32::UnregisterServer(LIBRARYNAME)
 
 =back