Notes in perlstyle about POD formatting, by Sébastien
[p5sagit/p5-mst-13.2.git] / pod / perltoc.pod
index 00ca67b..dd01b90 100644 (file)
@@ -673,54 +673,84 @@ Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
 
 =item Discontinuance, Deprecation, and BugFix traps
 
-Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
-Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
-Discontinuance, Deprecation, Discontinuance, Discontinuance
+Symbols starting with "_" no longer forced into main, Double-colon valid
+package separator in variable name, 2nd and 3rd args to C<splice()> are now
+in scalar context, Can't do C<goto> into a block that is optimized away,
+Can't use whitespace as variable name or quote delimiter, C<while/if BLOCK
+BLOCK> gone, C<**> binds tighter than unary minus, C<foreach> changed when
+iterating over a list, C<split> with no args behavior changed, B<-e>
+behavior fixed, C<push> returns number of elements in resulting list, Some
+error messages differ, C<split()> honors subroutine args, Bugs removed
 
 =item Parsing Traps
 
-Parsing, Parsing, Parsing, Parsing, Parsing
+Space between . and = triggers syntax error, Better parsing in perl 5,
+Function parsing, String interpolation of C<$#array> differs, Perl guesses
+on C<map>, C<grep> followed by C<{> if it starts BLOCK or hash ref
 
 =item Numerical Traps
 
-Numerical, Numerical, Numerical, Bitwise string ops
+Formatted output and significant digits, Auto-increment operator over
+signed int limit deleted, Assignment of return values from numeric equality
+tests doesn't work, Bitwise string ops
 
 =item General data type traps
 
-(Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
-(Constants), (Scalars), (Variable Suicide)
+Negative array subscripts now count from the end of array, Setting
+C<$#array> lower now discards array elements, Hashes get defined before
+use, Glob assignment from localized variable to variable, Assigning
+C<undef> to glob, Changes in unary negation (of strings), Modifying of
+constants prohibited, C<defined $var> behavior changed, Variable Suicide
 
 =item Context Traps - scalar, list contexts
 
-(list context), (scalar context), (scalar context), (list, builtin)
+Elements of argument lists for formats evaluated in list context,
+C<caller()> returns false value in scalar context if no caller present,
+Comma operator in scalar context gives scalar context to args, C<sprintf()>
+prototyped as C<($;@)>
 
 =item Precedence Traps
 
-Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
-Precedence
+LHS vs. RHS of any assignment operator, Semantic errors introduced due to
+precedence, Precedence of assignment operators same as the precedence of
+assignment, C<open> requires parentheses around filehandle, C<$:>
+precedence over C<$::> gone, Precedence of file test operators documented,
+C<keys>, C<each>, C<values> are regular named unary operators
 
 =item General Regular Expression Traps using s///, etc.
 
-Regular Expression, Regular Expression, Regular Expression, Regular
-Expression, Regular Expression, Regular Expression, Regular Expression,
-Regular Expression, Regular Expression
+C<s'$lhs'$rhs'> interpolates on either side, C<m//g> attaches its state to
+the searched string, C<m//o> used within an anonymous sub, C<$+> isn't set
+to whole match, Substitution now returns null string if it fails,
+C<s`lhs`rhs`> is now a normal substitution, Stricter parsing of variables
+in regular expressions, C<m?x?> matches only once, Failed matches don't
+reset the match variables
 
 =item Subroutine, Signal, Sorting Traps
 
-(Signals), (Sort Subroutine), warn() won't let you specify a filehandle
+Barewords that used to look like strings look like subroutine calls,
+Reverse is no longer allowed as the name of a sort subroutine, C<warn()>
+won't let you specify a filehandle
 
 =item OS Traps
 
-(SysV), (SysV)
+SysV resets signal handler correctly, SysV C<seek()> appends correctly
 
 =item Interpolation Traps
 
-Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
-Interpolation, Interpolation, Interpolation, Interpolation
+C<@> always interpolates an array in double-quotish strings, Double-quoted
+strings may no longer end with an unescaped $, Arbitrary expressions are
+evaluated inside braces within double quotes, C<$$x> now tries to
+dereference $x, Creation of hashes on the fly with C<eval "EXPR"> requires
+protection, Bugs in earlier perl versions, Array and hash brackets during
+interpolation, Interpolation of C<\$$foo{bar}>, C<qq()> string passed to
+C<eval> will not find string terminator
 
 =item DBM Traps
 
-DBM, DBM
+Perl5 must have been linked with same dbm/ndbm as the default for
+C<dbmopen()>, DBM exceeding limit on the key/value size will cause perl5 to
+exit immediately
 
 =item Unclassified Traps
 
@@ -765,8 +795,8 @@ LIMIT specified
 
 =back
 
-=head2 perlfaq - frequently asked questions about Perl ($Date: 2003/01/31
-17:37:17 $)
+=head2 perlfaq - frequently asked questions about Perl ($Date: 2005/03/27
+07:21:21 $)
 
 =over 4
 
@@ -829,8 +859,8 @@ Interaction, perlfaq9 - Networking
 
 =back
 
-=head2 perlfaq1 - General Questions About Perl ($Revision: 1.12 $, $Date:
-2003/07/09 15:47:28 $)
+=head2 perlfaq1 - General Questions About Perl ($Revision: 1.18 $, $Date:
+2005/04/01 16:15:25 $)
 
 =over 4
 
@@ -844,7 +874,7 @@ Interaction, perlfaq9 - Networking
 
 =item Which version of Perl should I use?
 
-=item What are perl4 and perl5?
+=item What are perl4, perl5, or perl6?
 
 =item What is Ponie?
 
@@ -878,8 +908,8 @@ Scheme, or Tcl?
 
 =back
 
-=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.20 $,
-$Date: 2003/01/26 17:50:56 $)
+=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.32 $,
+$Date: 2005/04/22 19:04:48 $)
 
 =over 4
 
@@ -934,8 +964,8 @@ References, Tutorials, Task-Oriented, Special Topics
 
 =back
 
-=head2 perlfaq3 - Programming Tools ($Revision: 1.35 $, $Date: 2003/08/24
-05:26:59 $)
+=head2 perlfaq3 - Programming Tools ($Revision: 1.48 $, $Date: 2005/04/22
+19:04:48 $)
 
 =over 4
 
@@ -963,9 +993,10 @@ References, Tutorials, Task-Oriented, Special Topics
 
 =item Is there an IDE or Windows Perl Editor?
 
-Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl,
-GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis, Vile, Vim, Codewright,
-MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
+Eclipse, Komodo, Open Perl IDE, OptiPerl, PerlBuilder, visiPerl+, Visual
+Perl, GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis, Vile, Vim, Codewright,
+MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, Affrus, Alpha, BBEdit and
+BBEdit Lite
 
 =item Where can I get Perl macros for vi?
 
@@ -975,8 +1006,6 @@ MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
 
 =item How can I use X or Tk with Perl?
 
-=item How can I generate simple menus without using CGI or Tk?
-
 =item How can I make my Perl program run faster?
 
 =item How can I make my Perl program take less memory?
@@ -1008,8 +1037,8 @@ stringification, Pass by reference, Tie large variables to disk
 
 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
 
-=item I've read perlembed, perlguts, etc., but I can't embed perl in
-my C program; what am I doing wrong?
+=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?
 
@@ -1021,8 +1050,8 @@ my C program; what am I doing wrong?
 
 =back
 
-=head2 perlfaq4 - Data Manipulation ($Revision: 1.49 $, $Date: 2003/09/20
-06:37:43 $)
+=head2 perlfaq4 - Data Manipulation ($Revision: 1.64 $, $Date: 2005/04/27
+00:18:04 $)
 
 =over 4
 
@@ -1145,8 +1174,6 @@ the tag
 
 =item How can I remove duplicate elements from a list or array?
 
-a), b), c), d), e)
-
 =item How can I tell whether a certain element is contained in a list or
 array?
 
@@ -1240,8 +1267,8 @@ array of hashes or arrays?
 
 =back
 
-=head2 perlfaq5 - Files and Formats ($Revision: 1.28 $, $Date: 2003/01/26
-17:45:46 $)
+=head2 perlfaq5 - Files and Formats ($Revision: 1.36 $, $Date: 2005/04/22
+19:04:48 $)
 
 =over 4
 
@@ -1258,6 +1285,8 @@ line in the middle of a file/append to the beginning of a file?
 
 =item How can I use Perl's C<-i> option from within a program?
 
+=item How can I copy a file?
+
 =item How do I make a temporary file name?
 
 =item How can I manipulate fixed-record-length files?
@@ -1336,8 +1365,8 @@ protected files?  Isn't this a bug in Perl?
 
 =back
 
-=head2 perlfaq6 - Regular Expressions ($Revision: 1.20 $, $Date: 2003/01/03
-20:05:28 $)
+=head2 perlfaq6 - Regular Expressions ($Revision: 1.32 $, $Date: 2005/04/22
+19:04:48 $)
 
 =over 4
 
@@ -1403,8 +1432,8 @@ file?
 
 =back
 
-=head2 perlfaq7 - General Perl Language Issues ($Revision: 1.15 $, $Date:
-2003/07/24 02:17:21 $)
+=head2 perlfaq7 - General Perl Language Issues ($Revision: 1.23 $, $Date:
+2005/04/07 21:39:34 $)
 
 =over 4
 
@@ -1485,8 +1514,8 @@ methods?
 
 =back
 
-=head2 perlfaq8 - System Interaction ($Revision: 1.17 $, $Date: 2003/01/26
-17:44:04 $)
+=head2 perlfaq8 - System Interaction ($Revision: 1.24 $, $Date: 2005/04/22
+19:04:48 $)
 
 =over 4
 
@@ -1594,6 +1623,8 @@ complete?
 
 =item How do I open a file without blocking?
 
+=item How do I tell the difference between errors from the shell and perl?
+
 =item How do I install a module from CPAN?
 
 =item What's the difference between require and use?
@@ -1613,7 +1644,7 @@ search path?
 
 =back
 
-=head2 perlfaq9 - Networking ($Revision: 1.15 $, $Date: 2003/01/31 17:36:57
+=head2 perlfaq9 - Networking ($Revision: 1.21 $, $Date: 2005/04/22 19:04:48
 $)
 
 =over 4
@@ -1697,6 +1728,10 @@ CGI script to do bad things?
 
 =item Simple Statements
 
+=item Truth and Falsehood
+
+=item Statement Modifiers
+
 =item Compound Statements
 
 =item Loop Control
@@ -1751,12 +1786,12 @@ CGI script to do bad things?
 
 =over 4
 
-=item SYNOPSIS
-
 =item DESCRIPTION
 
 =over 4
 
+=item Operator Precedence and Associativity
+
 =item Terms and List Operators (Leftward)
 
 =item The Arrow Operator
@@ -1832,6 +1867,8 @@ regular expressions
 
 =item Constant Folding
 
+=item No-ops
+
 =item Bitwise String Operators
 
 =item Integer Arithmetic
@@ -1939,28 +1976,29 @@ import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
 FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST,
 last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length,
 link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR,
-lock THING, log EXPR, log, 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
-TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL, next, no
-Module VERSION LIST, no Module VERSION, no Module LIST, no Module, oct
-EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open
-FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE,MODE,REFERENCE, open FILEHANDLE,
-opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR TYPE, our EXPR :
-ATTRS, our TYPE EXPR : ATTRS, 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
+localtime, lock THING, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK
+LIST, map EXPR,LIST, mkdir FILENAME,MASK, mkdir FILENAME, mkdir, msgctl
+ID,CMD,ARG, msgget KEY,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd
+ID,MSG,FLAGS, my EXPR, my TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS,
+next LABEL, next, no Module VERSION LIST, no Module VERSION, no Module
+LIST, no Module, oct EXPR, oct, open FILEHANDLE,EXPR, open
+FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, open
+FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, opendir DIRHANDLE,EXPR, ord
+EXPR, ord, our EXPR, our EXPR TYPE, our EXPR : ATTRS, our TYPE EXPR :
+ATTRS, 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,
@@ -2087,6 +2125,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
@@ -2127,6 +2167,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
@@ -2244,14 +2286,15 @@ OS/2, MS-DOS, Win95/NT, Macintosh, VMS
 
 =item Command Switches
 
-B<-0>[I<octal/hexadecimal>], B<-A [I<assertions>]>, B<-a>, B<-C
-[I<number/list>]>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>, 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<-0>[I<octal/hexadecimal>], B<-A[I<module>][=I<assertions>]>, B<-a>, B<-C
+[I<number/list>]>, B<-c>, B<-d>, B<-dt>, B<-d:>I<foo[=bar,baz]>,
+B<-dt:>I<foo[=bar,baz]>, B<-D>I<letters>, B<-D>I<number>, B<-e>
+I<commandline>, B<-f>, 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<-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<configvar>, B<-w>, B<-W>,
+B<-X>, B<-x>, B<-x> I<directory>
 
 =back
 
@@ -2259,10 +2302,11 @@ B<-X>, B<-x> I<directory>
 
 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
 :perlio, :pop, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
-PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS,
-PERL_DESTRUCT_LEVEL, PERL_ENCODING, PERL_HASH_SEED, PERL_HASH_SEED_DEBUG,
-PERL_ROOT (specific to the VMS port), PERL_SIGNALS, PERL_UNICODE, SYS$LOGIN
-(specific to the VMS port)
+PERL5DB, PERL5DB_THREADED, PERL5SHELL (specific to the Win32 port),
+PERL_ALLOW_NON_IFS_LSP (specific to the Win32 port), PERL_DEBUG_MSTATS,
+PERL_DESTRUCT_LEVEL, PERL_DL_NONLAZY, PERL_ENCODING, PERL_HASH_SEED,
+PERL_HASH_SEED_DEBUG, PERL_ROOT (specific to the VMS port), PERL_SIGNALS,
+PERL_UNICODE, SYS$LOGIN (specific to the VMS port)
 
 =back
 
@@ -2398,18 +2442,19 @@ C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
 IO::Handle->format_line_break_characters EXPR,
 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
-$FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
-$OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
-$PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
-$>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
-$PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
+$FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?,
+${^CHILD_ERROR_NATIVE}, ${^ENCODING}, $OS_ERROR, $ERRNO, $!, %!,
+$EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@, $PROCESS_ID, $PID, $$,
+$REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID, $>, $REAL_GROUP_ID,
+$GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $), $PROGRAM_NAME, $0, $[, $],
+$COMPILING, $^C, $DEBUGGING, $^D, ${^RE_DEBUG_FLAGS}, ${^RE_TRIE_MAXBUF},
 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
 0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R,
 $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, ${^UNICODE},
-$PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, $EXECUTABLE_NAME, $^X,
-ARGV, $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG,
-$SIG{expr}
+${^UTF8LOCALE}, $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS},
+$EXECUTABLE_NAME, $^X, ARGV, $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC,
+%ENV, $ENV{expr}, %SIG, $SIG{expr}
 
 =item Error Indicators
 
@@ -2543,6 +2588,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
@@ -2622,7 +2685,7 @@ this
 
 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
-this, NEXTKEY this, lastkey, UNTIE this, DESTROY this
+this, NEXTKEY this, lastkey, SCALAR this, UNTIE this, DESTROY this
 
 =item Tying FileHandles
 
@@ -3105,9 +3168,6 @@ portable
 
 =item CPAN Testers
 
-Mailing list: cpan-testers@perl.org, Testing results:
-http://testers.cpan.org/
-
 =item PLATFORMS
 
 =over 4
@@ -3136,43 +3196,21 @@ http://testers.cpan.org/
 
 =item Alphabetical Listing of Perl Functions
 
--I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
-FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
-PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
-LIST, exit EXPR, exit, fcntl FILEHANDLE,FUNCTION,SCALAR, flock
-FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, getpriority
-WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, getpwuid UID,
-getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
-getservbyport PORT,PROTO, getpwent, getgrent, gethostbyname, gethostent,
-getnetent, getprotoent, getservent, sethostent STAYOPEN, setnetent
-STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
-endhostent, endnetent, endprotoent, endservent, getsockopt
-SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR,
-kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR,
-lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv
-ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open FILEHANDLE, pipe
-READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select
-RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
-KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
-setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
-SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
-shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
-socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
-EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
-FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
-FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
-wait, waitpid PID,FLAGS
-
-=back
-
-=item CHANGES
-
-v1.49, 12 August 2002, v1.48, 02 February 2001, v1.47, 22 March 2000,
-v1.46, 12 February 2000, v1.45, 20 December 1999, v1.44, 19 July 1999,
-v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May 1999, v1.40, 11 April
-1999, v1.39, 11 February 1999, v1.38, 31 December 1998, v1.37, 19 December
-1998, v1.36, 9 September 1998, v1.35, 13 August 1998, v1.33, 06 August
-1998, v1.32, 05 August 1998, v1.30, 03 August 1998, v1.23, 10 July 1998
+-I<X>, atan2, binmode, chmod, chown, chroot, crypt, dbmclose, dbmopen,
+dump, exec, exit, fcntl, flock, fork, getlogin, getpgrp, getppid,
+getpriority, getpwnam, getgrnam, getnetbyname, getpwuid, getgrgid,
+getnetbyaddr, getprotobynumber, getservbyport, getpwent, getgrent,
+gethostbyname, gethostent, getnetent, getprotoent, getservent, sethostent,
+setnetent, setprotoent, setservent, endpwent, endgrent, endhostent,
+endnetent, endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob,
+gmtime, ioctl FILEHANDLE,FUNCTION,SCALAR, kill, link, localtime, lstat,
+msgctl, msgget, msgsnd, msgrcv, open, pipe, readlink, rename, select,
+semctl, semget, semop, setgrent, setpgrp, setpriority, setpwent,
+setsockopt, shmctl, shmget, shmread, shmwrite, sockatmark, socketpair,
+stat, symlink, syscall, sysopen, system, times, truncate, umask, utime,
+wait, waitpid
+
+=back
 
 =item Supported Platforms
 
@@ -3339,7 +3377,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
+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
 
@@ -3529,6 +3568,8 @@ chcp, dataset access, OS/390, z/OS iconv, locales
 
 =item Switches On the "#!" Line
 
+=item Taint mode and @INC
+
 =item Cleaning Up Your Path
 
 =item Security Bugs
@@ -3557,7 +3598,7 @@ chcp, dataset access, OS/390, z/OS iconv, locales
 
 =item Symbol Tables
 
-=item Package Constructors and Destructors
+=item BEGIN, CHECK, INIT and END
 
 =item Perl Classes
 
@@ -3581,62 +3622,69 @@ chcp, dataset access, OS/390, z/OS iconv, locales
 
 =item Pragmatic Modules
 
-assertions, assertions::activate, attributes, attrs, autouse, base, bigint,
-bignum, bigrat, blib, bytes, charnames, constant, diagnostics, encoding,
-fields, filetest, if, integer, less, lib, locale, open, ops, overload, re,
-sigtrap, sort, strict, subs, threads, threads::shared, utf8, vars, version,
-vmsish, warnings, warnings::register
+assertions, assertions::activate, assertions::compat, attributes, attrs,
+autouse, base, bigint, bignum, bigrat, blib, bytes, charnames, constant,
+diagnostics, encoding, encoding::warnings, fields, filetest, if, integer,
+less, lib, locale, open, ops, overload, re, sigtrap, sort, strict, subs,
+threads, threads::shared, utf8, vars, version, 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, Config, Cwd, DB, DB_File, Data::Dumper, Devel::DProf,
+AnyDBM_File, Archive::Tar, Archive::Tar::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, Compress::Zlib,
+Config, Cwd, DB, DBM_Filter, DB_File, Data::Dumper, Devel::DProf,
 Devel::PPPort, Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5,
-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,
+Digest::base, Digest::file, 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::CBuilder, ExtUtils::CBuilder::Platform::Windows,
 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,
-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::Glob, File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc,
+ExtUtils::Constant::Base, ExtUtils::Constant::Utils,
+ExtUtils::Constant::XS, ExtUtils::Embed, ExtUtils::Install,
+ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_AIX,
+ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS,
+ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_QNX,
+ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_VOS,
+ExtUtils::MM_Win32, ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker,
+ExtUtils::MakeMaker::Config, ExtUtils::MakeMaker::FAQ,
+ExtUtils::MakeMaker::Tutorial, ExtUtils::MakeMaker::bytes,
+ExtUtils::MakeMaker::vmsish, ExtUtils::Manifest, ExtUtils::Mkbootstrap,
+ExtUtils::Mksymlists, ExtUtils::Packlist, ExtUtils::ParseXS,
+ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree,
+File::Compare, File::Copy, File::DosGlob, File::Find, File::Glob,
+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, Filter::Util::Call, FindBin, GDBM_File,
 Getopt::Long, Getopt::Std, Hash::Util, I18N::Collate, I18N::LangTags,
-I18N::LangTags::List, I18N::Langinfo, IO, IO::Dir, IO::File, IO::Handle,
-IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET,
-IO::Socket::UNIX, IPC::Open2, IPC::Open3, IPC::SysV, IPC::SysV::Msg,
-IPC::SysV::Semaphore, List::Util, Locale::Constants, Locale::Country,
-Locale::Currency, Locale::Language, Locale::Maketext,
-Locale::Maketext::TPJ13, Locale::Script, MIME::Base64,
+I18N::LangTags::Detect, I18N::LangTags::List, I18N::Langinfo, IO, IO::Dir,
+IO::File, IO::Handle, IO::Pipe, IO::Poll, IO::Seekable, IO::Select,
+IO::Socket, IO::Socket::INET, IO::Socket::UNIX, IO::Zlib, IPC::Open2,
+IPC::Open3, IPC::SysV, IPC::SysV::Msg, 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::BigInt::Scalar, 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::BigInt::FastCalc,
+Math::BigRat, Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File,
+Memoize::Expire, Memoize::ExpireFile, Memoize::ExpireTest,
+Memoize::NDBM_File, Memoize::SDBM_File, Memoize::Storable,
+Module::CoreList, 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,
@@ -3645,15 +3693,15 @@ Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Scalar::Util,
 Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch,
 Symbol, Sys::Hostname, Sys::Syslog, Term::ANSIColor, Term::Cap,
 Term::Complete, Term::ReadLine, Test, Test::Builder, Test::Harness,
-Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Straps,
-Test::More, Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced,
-Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Thread,
-Thread::Queue, Thread::Semaphore, Thread::Signal, Thread::Specific,
-Tie::Array, Tie::File, Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash,
-Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::gmtime,
-Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate, Unicode::Normalize,
-Unicode::UCD, User::grent, User::pwent, Win32, XS::APItest, XS::Typemap,
-XSLoader
+Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Point,
+Test::Harness::Straps, Test::Harness::TAP, Test::More, Test::Simple,
+Test::Tutorial, Text::Abbrev, Text::Balanced, Text::ParseWords,
+Text::Soundex, Text::Tabs, Text::Wrap, Thread, Thread::Queue,
+Thread::Semaphore, Thread::Signal, Thread::Specific, Tie::Array, Tie::File,
+Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash, Tie::Scalar,
+Tie::SubstrHash, Time::HiRes, Time::Local, Time::gmtime, Time::localtime,
+Time::tm, UNIVERSAL, Unicode::Collate, Unicode::Normalize, Unicode::UCD,
+User::grent, User::pwent, XS::APItest, XS::Typemap, XSLoader
 
 =item Extension Modules
 
@@ -3868,9 +3916,9 @@ Look around, Check it's new, Discuss the need, Choose a name, Check again
 
 =item Step-by-step: Making the module
 
-Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
-L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
-documentation|perlpod>, Write tests, Write the README
+Start with F<module-starter> or F<h2xs>, Use L<strict|strict> and
+L<warnings|warnings>, Use L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!,
+Use L<plain old documentation|perlpod>, Write tests, Write the README
 
 =item Step-by-step: Distributing your module
 
@@ -4001,6 +4049,100 @@ Some Filters Clobber the C<DATA> Handle
 
 =back
 
+=head2 perlglossary - Perl Glossary
+
+=over 4
+
+=item DESCRIPTION
+
+=item Terms
+
+accessor methods, actual arguments, address operator, algorithm, alias,
+alternatives, anonymous, architecture, argument, ARGV, arithmetical
+operator, array, array context, ASCII, assertion, assignment, assignment
+operator, associative array, associativity, asynchronous, atom, atomic
+operation, attribute, autogeneration, autoincrement, autoload, autosplit,
+autovivification, AV, awk, backreference, backtracking, backward
+compatibility, bareword, base class, big-endian, binary, binary operator,
+bind, bit, bit shift, bit string, bless, block, BLOCK, block buffering,
+Boolean, Boolean context, breakpoint, broadcast, BSD, bucket, buffer,
+built-in, bundle, byte, bytecode, C, C preprocessor, call by reference,
+call by value, callback, canonical, capturing, character, character class,
+character property, circumfix operator, class, class method, client,
+cloister, closure, cluster, CODE, code generator, code subpattern,
+collating sequence, command, command buffering, command name, command-line
+arguments, comment, compilation unit, compile phase, compile time,
+compiler, composer, concatenation, conditional, connection, construct,
+constructor, context, continuation, core dump, CPAN, cracker, current
+package, current working directory, currently selected output channel, CV,
+dangling statement, data structure, data type, datagram, DBM, declaration,
+decrement, default, defined, delimiter, dereference, derived class,
+descriptor, destroy, destructor, device, directive, directory, directory
+handle, dispatch, distribution, dweomer, dwimmer, dynamic scoping,
+eclectic, element, embedding, empty subclass test, en passant,
+encapsulation, endian, environment, environment variable, EOF, errno,
+error, escape sequence, exception, exception handling, exec, executable
+file, execute, execute bit, exit status, export, expression, extension,
+false, FAQ, fatal error, field, FIFO, file, file descriptor, file test
+operator, fileglob, filehandle, filename, filesystem, filter, flag,
+floating point, flush, FMTEYEWTK, fork, formal arguments, format, freely
+available, freely redistributable, freeware, function, funny character,
+garbage collection, GID, glob, global, global destruction, glue language,
+granularity, greedy, grep, group, GV, hacker, handler, hard reference,
+hash, hash table, header file, here document, hexadecimal, home directory,
+host, hubris, HV, identifier, impatience, implementation, import,
+increment, indexing, indirect filehandle, indirect object, indirect object
+slot, indirection, infix, inheritance, instance, instance variable,
+integer, interface, interpolation, interpreter, invocant, invocation, I/O,
+IO, IP, IPC, is-a, iteration, iterator, IV, JAPH, key, keyword, label,
+laziness, left shift, leftmost longest, lexeme, lexer, lexical analysis,
+lexical scoping, lexical variable, library, LIFO, line, line buffering,
+line number, link, LIST, list, list context, list operator, list value,
+literal, little-endian, local, logical operator, lookahead, lookbehind,
+loop, loop control statement, loop label, lvaluable, lvalue, lvalue
+modifier, magic, magical increment, magical variables, Makefile, man,
+manpage, matching, member data, memory, metacharacter, metasymbol, method,
+minimalism, mode, modifier, module, modulus, monger, mortal,
+multidimensional array, multiple inheritance, named pipe, namespace,
+network address, newline, NFS, null character, null list, null string,
+numeric context, NV, nybble, object, octal, offset, one-liner, open source
+software, operand, operating system, operator, operator overloading,
+options, overloading, overriding, owner, package, pad, parameter, parent
+class, parse tree, parsing, patch, PATH, pathname, pattern, pattern
+matching, permission bits, Pern, pipe, pipeline, platform, pod, pointer,
+polymorphism, port, portable, porter, POSIX, postfix, pp, pragma,
+precedence, prefix, preprocessing, procedure, process, program generator,
+progressive matching, property, protocol, prototype, pseudofunction,
+pseudohash, pseudoliteral, public domain, pumpkin, pumpking, PV, qualified,
+quantifier, readable, reaping, record, recursion, reference, referent,
+regex, regular expression, regular expression modifier, regular file,
+relational operator, reserved words, return value, RFC, right shift, root,
+RTFM, run phase, run time, run-time pattern, RV, rvalue, scalar, scalar
+context, scalar literal, scalar value, scalar variable, scope, scratchpad,
+script, script kiddie, sed, semaphore, separator, serialization, server,
+service, setgid, setuid, shared memory, shebang, shell, side effects,
+signal, signal handler, single inheritance, slice, slurp, socket, soft
+reference, source filter, stack, standard, standard error, standard I/O,
+standard input, standard output, stat structure, statement, statement
+modifier, static, static method, static scoping, static variable, status,
+STDERR, STDIN, STDIO, STDOUT, stream, string, string context,
+stringification, struct, structure, subclass, subpattern, subroutine,
+subscript, substitution, substring, superclass, superuser, SV, switch,
+switch cluster, switch statement, symbol, symbol table, symbolic debugger,
+symbolic link, symbolic reference, synchronous, syntactic sugar, syntax,
+syntax tree, syscall, tainted, TCP, term, terminator, ternary, text,
+thread, tie, TMTOWTDI, token, tokener, tokenizing, toolbox approach,
+transliterate, trigger, trinary, troff, true, truncating, type, type
+casting, typed lexical, typedef, typeglob, typemap, UDP, UID, umask, unary
+operator, Unicode, Unix, value, variable, variable interpolation, variadic,
+vector, virtual, void context, v-string, warning, watch expression,
+whitespace, word, working directory, wrapper, WYSIWYG, XS, XSUB, yacc, zero
+width, zombie
+
+=item AUTHOR AND COPYRIGHT
+
+=back
+
 =head2 perlembed - how to embed perl in your C program
 
 =over 4
@@ -4218,6 +4360,8 @@ C<!!!>, C<!!>, C<!>
 
 =item The RETVAL Variable
 
+=item Returning SVs, AVs and HVs through RETVAL
+
 =item The MODULE Keyword
 
 =item The PACKAGE Keyword
@@ -4469,7 +4613,7 @@ save_hptr(HV **hptr)>
 
 =item Internal Functions
 
-A, p, d, s, n, r, f, M, o, j, x
+A, p, d, s, n, r, f, M, o, x, m, X, E, b
 
 =over 4
 
@@ -4477,8 +4621,12 @@ A, p, d, s, n, r, f, M, o, j, x
 
 =item Pointer-To-Integer and Integer-To-Pointer
 
+=item Exception Handling
+
 =item Source Documentation
 
+=item Backwards compatibility
+
 =back
 
 =item Unicode Support
@@ -4607,7 +4755,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
 
@@ -4624,7 +4772,7 @@ perl_clone
 
 =item CV Manipulation Functions
 
-CvSTASH, get_cv, Nullcv
+CvSTASH, get_cv
 
 =item Embedding Functions
 
@@ -4642,36 +4790,38 @@ 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_fetchmeth_autoload, gv_stashpv, gv_stashsv
+gv_fetchmeth_autoload, gv_stashpv, gv_stashpvn, 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_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_iternext_flags, hv_iterval,
-hv_magic, hv_store, hv_store_ent, hv_undef, newHV, Nullhv
+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
 
 =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, savesvpv, 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
 
@@ -4686,14 +4836,19 @@ cv_const_sv, newCONSTSUB, newXS
 
 pad_sv
 
+=item Simple Exception Handling Macros
+
+dXCPT, XCPT_CATCH, XCPT_RETHROW, XCPT_TRY_END, XCPT_TRY_START
+
 =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
 
@@ -4701,24 +4856,26 @@ 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,
-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,
+get_sv, looks_like_number, newRV_inc, newRV_noinc, NEWSV, newSV, newSVhek,
+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, SvIV_set,
+SvLEN, SvLEN_set, SvMAGIC_set, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp,
+SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX, SvNVx, SvNV_set, 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, SvPV_nomg, SvPV_set,
+SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV,
+SvRV_set, SvSTASH, SvSTASH_set, SvTAINT, SvTAINTED, SvTAINTED_off,
+SvTAINTED_on, SvTRUE, SvTYPE, SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off,
+SvUTF8_on, SvUV, SvUVX, SvUVx, SvUV_nomg, SvUV_set, 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_catpvn_nomg, sv_catpv_mg,
+sv_catsv, sv_catsv_flags, sv_catsv_mg, sv_catsv_nomg, 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,
@@ -4730,24 +4887,26 @@ 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
+sv_setsv_nomg, 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_vcatpvf, sv_vcatpvfn,
+sv_vcatpvf_mg, sv_vsetpvf, sv_vsetpvfn, sv_vsetpvf_mg
 
 =item Unicode Support
 
 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
-is_utf8_string_loc, pv_uni_display, sv_cat_decode, 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
+is_utf8_string_loc, is_utf8_string_loclen, pv_uni_display, sv_cat_decode,
+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
+ax, CLASS, dAX, dAXMARK, dITEMS, dUNDERBAR, dXSARGS, dXSI32, items, ix,
+newXSproto, RETVAL, ST, THIS, UNDERBAR, XS, XS_VERSION,
+XS_VERSION_BOOTCHECK
 
 =item Warning and Dieing
 
@@ -4773,10 +4932,11 @@ CvWEAKOUTSIDE
 =item Functions in file pad.h
 
 CX_CURPAD_SAVE, CX_CURPAD_SV, PAD_BASE_SV, PAD_CLONE_VARS,
-PAD_COMPNAME_FLAGS, PAD_COMPNAME_GEN, PAD_COMPNAME_OURSTASH,
-PAD_COMPNAME_PV, PAD_COMPNAME_TYPE, PAD_DUP, PAD_RESTORE_LOCAL,
-PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV, PAD_SET_CUR, PAD_SV,
-PAD_SVl, SAVECLEARSV, SAVECOMPPAD, SAVEPADSV
+PAD_COMPNAME_FLAGS, PAD_COMPNAME_GEN, PAD_COMPNAME_GEN_set,
+PAD_COMPNAME_OURSTASH, PAD_COMPNAME_PV, PAD_COMPNAME_TYPE, PAD_DUP,
+PAD_RESTORE_LOCAL, PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV,
+PAD_SET_CUR, PAD_SET_CUR_NOSAVE, PAD_SV, PAD_SVl, SAVECLEARSV, SAVECOMPPAD,
+SAVEPADSV
 
 =item Functions in file pp_ctl.c
 
@@ -4789,12 +4949,16 @@ PL_rs
 
 =item GV Functions
 
-is_gv_magical
+is_gv_magical, is_gv_magical_sv
 
 =item IO Functions
 
 start_glob
 
+=item Magical Functions
+
+mg_localize
+
 =item Pad Data Structures
 
 CvPADLIST, cv_clone, cv_dump, do_dump_pad, intro_my, pad_add_anon,
@@ -4808,7 +4972,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
 
@@ -4948,6 +5113,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
@@ -4961,7 +5128,7 @@ Core modules, Tests, Documentation, Configure, Interpreter
 
 =item Elements of the interpreter
 
-Startup, Parsing, Optimization, Running
+Startup, Parsing, Optimization, Running, Exception handing
 
 =item Internal Variable Types
 
@@ -5000,14 +5167,15 @@ t/cmd t/run t/io t/op, t/lib ext lib
 
 =item Special Make Test Targets
 
-coretest, test.deparse, minitest, test.valgrind check.valgrind
-utest.valgrind ucheck.valgrind, test.third check.third utest.third
-ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8,
-test_harness
+coretest, test.deparse, test.taintwarn, minitest, test.valgrind
+check.valgrind utest.valgrind ucheck.valgrind, test.third check.third
+utest.third ucheck.third, test.torture torturetest, utest ucheck test.utf8
+check.utf8, minitest.utf16 test.utf16, test_harness, test-notty test_notty
 
 =item Running tests by hand
 
-PERL_CORE=1, PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST
+-v, -torture, -re=PATTERN, -re LIST OF PATTERNS, PERL_CORE=1,
+PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST
 
 =back
 
@@ -5070,523 +5238,498 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item DESCRIPTION
 
-=item To do during 5.6.x
-
-=over 4
-
-=item Support for I/O disciplines
+=item assertions
 
-=item Autoload bytes.pm
+=item iCOW
 
-=item Make "\u{XXXX}" et al work
+=item (?{...}) closures in regexps
 
-=item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
+=item A re-entrant regexp engine
 
-=item Overloadable regex assertions
+=item pragmata
 
-=item Unicode
-
-=item Work out exit/die semantics for threads
+=over 4
 
-=item Better support for nonpreemptive threading systems like GNU pth
+=item lexical pragmas
 
-=item Typed lexicals for compiler
+=item use less 'memory'
 
-=item Compiler workarounds for Win32
+=back
 
-=item AUTOLOADing in the compiler
+=item prototypes and functions
 
-=item Fixing comppadlist when compiling
+=over 4
 
-=item Cleaning up exported namespace
+=item _ prototype character
 
-=item Complete signal handling
+=item inlining autoloaded constants
 
-=item Out-of-source builds
+=item Finish off lvalue functions
 
-=item POSIX realtime support
+=back
 
-=item UNIX98 support
+=item Unicode and UTF8
 
-=item IPv6 Support
+=over 4
 
-=item Long double conversion
+=item Implicit Latin 1 => Unicode translation
 
-=item Locales
+=item UTF8 caching code
 
-=item Arithmetic on non-Arabic numerals
+=item Unicode in Filenames
 
-=item POSIX Unicode character classes
+=item Unicode in %ENV
 
-=item Factoring out common suffices/prefices in regexps (trie optimization)
+=back
 
-=item Security audit shipped utilities
+=item Regexps
 
-=item Sort out the uid-setting mess
+=over 4
 
-=item Custom opcodes
+=item regexp optimiser optional
 
-=item DLL Versioning
+=back
 
-=item Introduce @( and @)
+=item POD
 
-=item Floating point handling
+=over 4
 
-=item IV/UV preservation
+=item POD -> HTML conversion still sucks
 
-=item Replace pod2html with something using Pod::Parser
+=back
 
-=item Automate module testing on CPAN
+=item Misc medium sized projects
 
-=item sendmsg and recvmsg
+=over 4
 
-=item Rewrite perlre documentation
+=item UNITCHECK
 
-=item Convert example code to IO::Handle filehandles
+=item optional optimizer
 
-=item Document Win32 choices
+=item You WANT *how* many
 
-=item Check new modules
+=item lexical aliases
 
-=item Make roffitall find pods and libs itself
+=item no 6
 
-=back
+=item IPv6
 
-=item To do at some point
+=item entersub XS vs Perl
 
-=over 4
+=item @INC source filter to Filter::Simple
 
-=item Remove regular expression recursion
+=item bincompat functions
 
-=item Memory leaks after failed eval
+=item Use fchown/fchmod internally
 
-=item bitfields in pack
+=item Constant folding
 
-=item Cross compilation
+=back
 
-=item Perl preprocessor / macros
+=item Tests
 
-=item Perl lexer in Perl
+=over 4
 
-=item Using POSIX calls internally
+=item Make Schwern poorer
 
-=item -i rename file when changed
+=item test B
 
-=item All ARGV input should act like E<lt>E<gt>
+=item common test code for timed bailout
 
-=item Support for rerunning debugger
+=back
 
-=item Test Suite for the Debugger
+=item Installation
 
-=item my sub foo { }
+=over 4
 
-=item One-pass global destruction
+=item compressed man pages
 
-=item Rewrite regexp parser
+=item Make Config.pm cope with differences between build and installed perl
 
-=item Cache recently used regexps
+=item Relocatable perl
 
-=item Cross-compilation support
+=item make HTML install work
 
-=item Bit-shifting bitvectors
+=item put patchlevel in -v
 
-=item debugger pragma
+=back
 
-=item use less pragma
+=item Incremental things
 
-=item switch structures
+=over 4
 
-=item Cache eval tree
+=item autovivification
 
-=item rcatmaybe
+=item fix tainting bugs
 
-=item Shrink opcode tables
+=item Make tainting consistent
 
-=item Optimize away @_
+=item Dual life everything
 
-=item Prototypes versus indirect objects
+=back
 
-=item Install HTML
+=item Vague things
 
-=item Prototype method calls
+=over 4
 
-=item Return context prototype declarations
+=item threads
 
-=item magic_setisa
+=item POSIX memory footprint
 
-=item Garbage collection
+=item Optimize away @_
 
-=item IO tutorial
+=item switch ops
 
-=item Rewrite perldoc
+=item Attach/detach debugger from running program
 
-=item Install .3p manpages
+=item A decent benchmark
 
-=item Unicode tutorial
+=item readpipe(LIST)
 
-=item Update POSIX.pm for 1003.1-2
+=item Self ties
 
-=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.3
 
 =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 perl593delta, perldelta - what is new for perl v5.9.3
 
-=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 perl592delta, perldelta - what is new for perl v5.9.2
 
 =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 Packing and UTF-8 strings
 
-=item Generalised want()/caller())
+=item Miscellaneous
 
-=item Named prototypes
+=back
 
-=item Built-in globbing
+=item Core Enhancements
 
-=item Regression tests for suidperl
+=over 4
 
-=item Cached hash values
+=item Malloc wrapping
 
-=item Add compression modules
+=item Unicode Character Database 4.0.1
 
-=item Reorganise documentation into tutorials/references
+=item suidperl less insecure
 
-=item Remove distinction between functions and operators
+=item PERLIO_DEBUG
 
-=item Make XS easier to use
+=item Formats
 
-=item Make embedding easier to use
+=item Unicode Character Classes
 
-=item man for perl
+=item Byte-order modifiers for pack() and unpack()
 
-=item my $Package::variable
+=item Byte count feature in pack()
 
-=item "or" tests defined, not truth
+=item New variables
 
-=item "class"-based lexicals
+=back
 
-=item byteperl
+=item Modules and Pragmata
 
-=item Lazy evaluation / tail recursion removal
+=over 4
 
-=item Make "use utf8" the default
+=item New modules
 
-=item Unicode collation and normalization
+=item Updated And Improved Modules and Pragmata
 
-=item pack/unpack tutorial
+B::Concise, Socket, Sys::Syslog, threads
 
 =back
 
-=back
+=item Utility Changes
 
-=head2 perldoc - Look up Perl documentation in Pod format.
+=item Performance Enhancements
 
-=over 4
+=item Installation and Configuration Improvements
 
-=item SYNOPSIS
+=item Selected Bug Fixes
 
-=item DESCRIPTION
+=item New or Changed Diagnostics
 
-=item OPTIONS
+=item Changed Internals
 
-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 Known Problems
 
-=item SECURITY
+=item Plans for the next release
 
-=item ENVIRONMENT
+=item Reporting Bugs
 
-=item AUTHOR
+=item SEE ALSO
 
 =back
 
-=head2 perlhist - the Perl history records
+=head2 perl591delta, perldelta - what is new for perl v5.9.1
 
 =over 4
 
 =item DESCRIPTION
 
-=item INTRODUCTION
-
-=item THE KEEPERS OF THE PUMPKIN
+=item Incompatible Changes
 
 =over 4
 
-=item PUMPKIN?
+=item substr() lvalues are no longer fixed-length
+
+=item The C<:unique> attribute is only meaningful for globals
 
 =back
 
-=item THE RECORDS
+=item Core Enhancements
 
 =over 4
 
-=item SELECTED RELEASE SIZES
+=item Lexical C<$_>
 
-=item SELECTED PATCH SIZES
+=item Tied hashes in scalar context
 
-=back
+=item Formats
 
-=item THE KEEPERS OF THE RECORDS
+=item Stacked filetest operators
 
 =back
 
-=head2 perldelta - what is new for perl v5.9.0
+=item Modules and Pragmata
 
-=over 4
+Benchmark, Carp, Exporter, FindBin, List::Util, threads::shared
 
-=item DESCRIPTION
+=item Utility Changes
 
-=item Incompatible Changes
+=item Documentation
 
-=over 4
+=item Performance Enhancements
 
-=item The C<$*> variable has been removed
+=item Selected Bug Fixes
 
-=back
+=over 4
 
-=item Core Enhancements
+=item UTF-8 bugs
 
-=over 4
+=item Threading bugs
 
-=item Tied Arrays with Negative Array Indices
+=item More bugs
 
 =back
 
-=item Modules and Pragmata
+=item New or Changed Diagnostics
 
-=item Utility Changes
+=item Changed Internals
 
-=item New Documentation
+=over 4
 
-=item Performance Enhancements
+=item Reordering of SVt_* constants
 
-=item Installation and Configuration Improvements
+=item Removal of CPP symbols
 
-=item Selected Bug Fixes
+=item Less space is used by ops
 
-=item New or Changed Diagnostics
+=item New parser
 
-=item Changed Internals
+=back
 
-=item New Tests
+=item Configuration and Building
 
 =item Known Problems
 
+=over 4
+
 =item Platform Specific Problems
 
+=back
+
+=item To-do for perl 5.10.0
+
 =item Reporting Bugs
 
 =item SEE ALSO
 
 =back
 
-=head2 perl58delta, perldelta - what is new for perl v5.8.0
+=head2 perl590delta, perldelta - what is new for perl v5.9.0
 
 =over 4
 
 =item DESCRIPTION
 
-=item Highlights In 5.8.0
-
 =item Incompatible Changes
 
 =over 4
 
-=item Binary Incompatibility
+=item Hash Randomisation
 
-=item 64-bit platforms and malloc
+=item UTF-8 On Filehandles No Longer Activated By Locale
 
-=item AIX Dynaloading
+=item Single-number v-strings are no longer v-strings before "=>"
 
-=item Attributes for C<my> variables now handled at run-time
+=item (Win32) The -C Switch Has Been Repurposed
 
-=item Socket Extension Dynamic in VMS
+=item (Win32) The /d Switch Of cmd.exe
 
-=item IEEE-format Floating Point Default on OpenVMS Alpha
+=item The C<$*> variable has been removed
 
-=item New Unicode Semantics (no more C<use utf8>, almost)
+=back
 
-=item New Unicode Properties
+=item Core Enhancements
 
-=item REF(...) Instead Of SCALAR(...)
+=over 4
 
-=item pack/unpack D/F recycled
+=item Assertions
 
-=item glob() now returns filenames in alphabetical order
-
-=item Deprecations
-
-=back
-
-=item Core Enhancements
-
-=over 4
-
-=item Unicode Overhaul
-
-=item PerlIO is Now The Default
+=item Defined-or operators
 
-=item ithreads
+=item UTF-8 no longer default under UTF-8 locales
 
-=item Restricted Hashes
+=item Unsafe signals again available
 
-=item Safe Signals
+=item Tied Arrays with Negative Array Indices
 
-=item Understanding of Numbers
+=item local ${$x}
 
-=item Arrays now always interpolate into double-quoted strings [561]
+=item Unicode Character Database 4.0.0
 
-=item Miscellaneous Changes
+=item Miscellaneous Enhancements
 
 =back
 
@@ -5594,9 +5737,16 @@ B<-V>
 
 =over 4
 
-=item New Modules and Pragmata
+=item Updated Modules And Pragmata
 
-=item Updated And Improved Modules and Pragmata
+base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
+CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
+Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
+PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
+Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
+Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
+Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
+Win32::GetOSVersion
 
 =back
 
@@ -5610,9 +5760,7 @@ B<-V>
 
 =over 4
 
-=item Generic Improvements
-
-=item New Or Improved Platforms
+=item Platform-specific enhancements
 
 =back
 
@@ -5620,51 +5768,55 @@ B<-V>
 
 =over 4
 
-=item Platform Specific Changes and Fixes
+=item Closures, eval and lexicals
+
+=item Generic fixes
+
+=item Platform-specific fixes
 
 =back
 
 =item New or Changed Diagnostics
 
-=item Changed Internals
+=over 4
 
-=item Security Vulnerability Closed [561]
+=item Changed "A thread exited while %d threads were running"
 
-=item New Tests
+=item Removed "Attempt to clear a restricted hash"
 
-=item Known Problems
+=item New "Illegal declaration of anonymous subroutine"
 
-=over 4
+=item Changed "Invalid range "%s" in transliteration operator"
 
-=item The Compiler Suite Is Still Very Experimental
+=item New "Missing control char name in \c"
 
-=item Localising Tied Arrays and Hashes Is Broken
+=item New "Newline in left-justified string for %s"
 
-=item Building Extensions Can Fail Because Of Largefiles
+=item New "Possible precedence problem on bitwise %c operator"
 
-=item Modifying $_ Inside for(..)
+=item New "read() on %s filehandle %s"
 
-=item mod_perl 1.26 Doesn't Build With Threaded Perl
+=item New "Tied variable freed while still in use"
 
-=item lib/ftmp-security tests warn 'system possibly insecure'
+=item New "To%s: illegal mapping '%s'"
 
-=item libwww-perl (LWP) fails base/date #51
+=item New "Use of freed value in iteration"
 
-=item PDL failing some tests
+=back
 
-=item Perl_get_sv
+=item Changed Internals
 
-=item Self-tying Problems
+=item New Tests
 
-=item ext/threads/t/libc
+=item Known Problems
 
-=item Failure of Thread (5.005-style) tests
+=over 4
 
-=item Timing problems
+=item Tied hashes in scalar context
 
-=item Tied/Magical Array/Hash Elements Do Not Autovivify
+=item Net::Ping 450_service and 510_ping_udp failures
 
-=item Unicode in package/class and subroutine names does not work
+=item B::C
 
 =back
 
@@ -5672,79 +5824,83 @@ B<-V>
 
 =over 4
 
-=item AIX
+=item EBCDIC Platforms
 
-=item Alpha systems with old gccs fail several tests
+=item Cygwin 1.5 problems
 
-=item AmigaOS
+=item HP-UX: HP cc warnings about sendfile and sendpath
 
-=item BeOS
+=item IRIX: t/uni/tr_7jis.t falsely failing
 
-=item Cygwin "unable to remap"
+=item Mac OS X: no usemymalloc
 
-=item Cygwin ndbm tests fail on FAT
+=item Tru64: No threaded builds with GNU cc (gcc)
 
-=item DJGPP Failures
+=item Win32: sysopen, sysread, syswrite
 
-=item FreeBSD built with ithreads coredumps reading large directories
+=back
 
-=item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
+=item TODO
 
-=item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
+=item Reporting Bugs
 
-=item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
+=item SEE ALSO
 
-=item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
+=back
 
-=item Linux With Sfio Fails op/misc Test 48
+=head2 perl587delta, perldelta - what is new for perl v5.8.7
 
-=item Mac OS X
+=over 4
 
-=item Mac OS X dyld undefined symbols
+=item DESCRIPTION
 
-=item OS/2 Test Failures
+=item Incompatible Changes
 
-=item op/sprintf tests 91, 129, and 130
+=item Core Enhancements
 
-=item SCO
+=over 4
 
-=item Solaris 2.5
+=item Unicode Character Database 4.1.0
 
-=item Solaris x86 Fails Tests With -Duse64bitint
+=item suidperl less insecure
 
-=item SUPER-UX (NEC SX)
+=item Optional site customization script
 
-=item Term::ReadKey not working on Win32
+=item C<Config.pm> is now much smaller.
 
-=item UNICOS/mk
+=back
 
-=item UTS
+=item Modules and Pragmata
 
-=item VOS (Stratus)
+=item Utility Changes
 
-=item VMS
+=over 4
 
-=item Win32
+=item find2perl enhancements
 
-=item XML::Parser not working
+=back
 
-=item z/OS (OS/390)
+=item Performance Enhancements
 
-=item Unicode Support on EBCDIC Still Spotty
+=item Installation and Configuration Improvements
 
-=item Seen In Perl 5.7 But Gone Now
+=item Selected Bug Fixes
 
-=back
+=item New or Changed Diagnostics
+
+=item Changed Internals
+
+=item Known Problems
+
+=item Platform Specific Problems
 
 =item Reporting Bugs
 
 =item SEE ALSO
 
-=item HISTORY
-
 =back
 
-=head2 perl581delta, perldelta - what is new for perl v5.8.1
+=head2 perl586delta - what is new for perl v5.8.6
 
 =over 4
 
@@ -5752,206 +5908,270 @@ B<-V>
 
 =item Incompatible Changes
 
-=over 4
-
-=item Hash Randomisation
+=item Core Enhancements
 
-=item UTF-8 On Filehandles No Longer Activated By Locale
+=item Modules and Pragmata
 
-=item Single-number v-strings are no longer v-strings before "=>"
+=item Utility Changes
 
-=item (Win32) The -C Switch Has Been Repurposed
+=item Performance Enhancements
 
-=item (Win32) The /d Switch Of cmd.exe
+=item Selected Bug Fixes
 
-=back
+=item New or Changed Diagnostics
 
-=item Core Enhancements
+=item Changed Internals
 
-=over 4
+=item New Tests
 
-=item UTF-8 no longer default under UTF-8 locales
+=item Reporting Bugs
 
-=item Unsafe signals again available
+=item SEE ALSO
 
-=item Tied Arrays with Negative Array Indices
+=back
 
-=item local ${$x}
+=head2 perl585delta - what is new for perl v5.8.5
 
-=item Unicode Character Database 4.0.0
+=over 4
 
-=item Deprecation Warnings
+=item DESCRIPTION
 
-=item Miscellaneous Enhancements
+=item Incompatible Changes
 
-=back
+=item Core Enhancements
 
 =item Modules and Pragmata
 
+=item Utility Changes
+
 =over 4
 
-=item Updated Modules And Pragmata
+=item Perl's debugger
 
-base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
-CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
-Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
-PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
-Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
-Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
-Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
-Win32::GetOSVersion
+=item h2ph
 
 =back
 
-=item Utility Changes
-
-=item New Documentation
-
 =item Installation and Configuration Improvements
 
-=over 4
-
-=item Platform-specific enhancements
+=item Selected Bug Fixes
 
-=back
+=item New or Changed Diagnostics
 
-=item Selected Bug Fixes
+=item Changed Internals
 
-=over 4
+=item Known Problems
 
-=item Closures, eval and lexicals
+=item Platform Specific Problems
 
-=item Generic fixes
+=item Reporting Bugs
 
-=item Platform-specific fixes
+=item SEE ALSO
 
 =back
 
-=item New or Changed Diagnostics
+=head2 perl584delta - what is new for perl v5.8.4
 
 =over 4
 
-=item Changed "A thread exited while %d threads were running"
+=item DESCRIPTION
 
-=item Removed "Attempt to clear a restricted hash"
+=item Incompatible Changes
 
-=item New "Illegal declaration of anonymous subroutine"
+=item Core Enhancements
 
-=item Changed "Invalid range "%s" in transliteration operator"
+=over 4
 
-=item New "Missing control char name in \c"
+=item Malloc wrapping
 
-=item New "Newline in left-justified string for %s"
+=item Unicode Character Database 4.0.1
 
-=item New "Possible precedence problem on bitwise %c operator"
+=item suidperl less insecure
 
-=item New "Pseudo-hashes are deprecated"
+=item format
 
-=item New "read() on %s filehandle %s"
+=back
 
-=item New "5.005 threads are deprecated"
+=item Modules and Pragmata
 
-=item New "Tied variable freed while still in use"
+=over 4
 
-=item New "To%s: illegal mapping '%s'"
+=item Updated modules
 
-=item New "Use of freed value in iteration"
+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 Changed Internals
-
-=item New Tests
+=item Performance Enhancements
 
-=item Known Problems
+=item Utility Changes
 
-=over 4
+=item Installation and Configuration Improvements
 
-=item Tied hashes in scalar context
+=item Selected Bug Fixes
 
-=item Net::Ping 450_service and 510_ping_udp failures
+=item New or Changed Diagnostics
 
-=item B::C
+=item Changed Internals
 
-=back
+=item Future Directions
 
 =item Platform Specific Problems
 
-=over 4
+=item Reporting Bugs
 
-=item EBCDIC Platforms
+=item SEE ALSO
 
-=item Cygwin 1.5 problems
+=back
 
-=item HP-UX: HP cc warnings about sendfile and sendpath
+=head2 perl583delta - what is new for perl v5.8.3
 
-=item IRIX: t/uni/tr_7jis.t falsely failing
+=over 4
 
-=item Mac OS X: no usemymalloc
+=item DESCRIPTION
 
-=item Tru64: No threaded builds with GNU cc (gcc)
+=item Incompatible Changes
 
-=item Win32: sysopen, sysread, syswrite
+=item Core Enhancements
 
-=back
+=item Modules and Pragmata
+
+CGI, Cwd, Digest, Digest::MD5, Encode, File::Spec, FindBin, List::Util,
+Math::BigInt, PodParser, Pod::Perldoc, POSIX, Unicode::Collate,
+Unicode::Normalize, Test::Harness, threads::shared
+
+=item Utility Changes
+
+=item New Documentation
+
+=item Installation and Configuration Improvements
+
+=item Selected Bug Fixes
+
+=item New or Changed Diagnostics
+
+=item Changed Internals
+
+=item Configuration and Building
+
+=item Platform Specific Problems
+
+=item Known Problems
 
 =item Future Directions
 
+=item Obituary
+
 =item Reporting Bugs
 
 =item SEE ALSO
 
 =back
 
-=head2 perl573delta - what's new for perl v5.7.3
+=head2 perl582delta - what is new for perl v5.8.2
 
 =over 4
 
 =item DESCRIPTION
 
-=item Changes
+=item Incompatible Changes
+
+=item Core Enhancements
+
+=over 4
+
+=item Hash Randomisation
+
+=item Threading
+
+=back
+
+=item Modules and Pragmata
+
+=over 4
+
+=item Updated Modules And Pragmata
+
+Devel::PPPort, Digest::MD5, I18N::LangTags, libnet, MIME::Base64,
+Pod::Perldoc, strict, Tie::Hash, Time::HiRes, Unicode::Collate,
+Unicode::Normalize, UNIVERSAL
+
+=back
+
+=item Selected Bug Fixes
+
+=item Changed Internals
+
+=item Platform Specific Problems
+
+=item Future Directions
 
 =item Reporting Bugs
 
 =item SEE ALSO
 
-=item HISTORY
-
 =back
 
-=head2 perl572delta - what's new for perl v5.7.2
+=head2 perl581delta - what is new for perl v5.8.1
 
 =over 4
 
 =item DESCRIPTION
 
-=item Security Vulnerability Closed
-
 =item Incompatible Changes
 
 =over 4
 
-=item 64-bit platforms and malloc
+=item Hash Randomisation
 
-=item AIX Dynaloading
+=item UTF-8 On Filehandles No Longer Activated By Locale
 
-=item Socket Extension Dynamic in VMS
+=item Single-number v-strings are no longer v-strings before "=>"
 
-=item Different Definition of the Unicode Character Classes \p{In...}
+=item (Win32) The -C Switch Has Been Repurposed
 
-=item Deprecations
+=item (Win32) The /d Switch Of cmd.exe
 
 =back
 
 =item Core Enhancements
 
+=over 4
+
+=item UTF-8 no longer default under UTF-8 locales
+
+=item Unsafe signals again available
+
+=item Tied Arrays with Negative Array Indices
+
+=item local ${$x}
+
+=item Unicode Character Database 4.0.0
+
+=item Deprecation Warnings
+
+=item Miscellaneous Enhancements
+
+=back
+
 =item Modules and Pragmata
 
 =over 4
 
-=item New Modules and Distributions
+=item Updated Modules And Pragmata
 
-=item Updated And Improved Modules and Pragmata
+base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
+CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
+Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
+PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
+Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
+Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
+Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
+Win32::GetOSVersion
 
 =back
 
@@ -5963,9 +6183,7 @@ Win32::GetOSVersion
 
 =over 4
 
-=item New Or Improved Platforms
-
-=item Generic Improvements
+=item Platform-specific enhancements
 
 =back
 
@@ -5973,153 +6191,173 @@ Win32::GetOSVersion
 
 =over 4
 
-=item Platform Specific Changes and Fixes
+=item Closures, eval and lexicals
+
+=item Generic fixes
+
+=item Platform-specific fixes
 
 =back
 
 =item New or Changed Diagnostics
 
-=item Source Code Enhancements
-
 =over 4
 
-=item MAGIC constants
+=item Changed "A thread exited while %d threads were running"
 
-=item Better commented code
+=item Removed "Attempt to clear a restricted hash"
 
-=item Regex pre-/post-compilation items matched up
+=item New "Illegal declaration of anonymous subroutine"
 
-=item gcc -Wall
+=item Changed "Invalid range "%s" in transliteration operator"
 
-=back
+=item New "Missing control char name in \c"
 
-=item New Tests
+=item New "Newline in left-justified string for %s"
 
-=item Known Problems
+=item New "Possible precedence problem on bitwise %c operator"
 
-=over 4
+=item New "Pseudo-hashes are deprecated"
 
-=item AIX
+=item New "read() on %s filehandle %s"
 
-=item Amiga Perl Invoking Mystery
+=item New "5.005 threads are deprecated"
 
-=item lib/ftmp-security tests warn 'system possibly insecure'
+=item New "Tied variable freed while still in use"
 
-=item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
+=item New "To%s: illegal mapping '%s'"
 
-=item HP-UX lib/io_multihomed Fails When LP64-Configured
+=item New "Use of freed value in iteration"
 
-=item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
+=back
 
-=item Linux With Sfio Fails op/misc Test 48
+=item Changed Internals
 
-=item OS/390
+=item New Tests
 
-=item op/sprintf tests 129 and 130
+=item Known Problems
 
-=item  Failure of Thread tests
+=over 4
 
-=item UNICOS
+=item Tied hashes in scalar context
 
-=item UTS
+=item Net::Ping 450_service and 510_ping_udp failures
 
-=item VMS
+=item B::C
 
-=item Win32
+=back
 
-=item Localising a Tied Variable Leaks Memory
+=item Platform Specific Problems
 
-=item Self-tying of Arrays and Hashes Is Forbidden
+=over 4
 
-=item Variable Attributes are not Currently Usable for Tieing
+=item EBCDIC Platforms
 
-=item Building Extensions Can Fail Because Of Largefiles
+=item Cygwin 1.5 problems
 
-=item The Compiler Suite Is Still Experimental
+=item HP-UX: HP cc warnings about sendfile and sendpath
 
-=item The Long Double Support is Still Experimental
+=item IRIX: t/uni/tr_7jis.t falsely failing
+
+=item Mac OS X: no usemymalloc
+
+=item Tru64: No threaded builds with GNU cc (gcc)
+
+=item Win32: sysopen, sysread, syswrite
 
 =back
 
+=item Future Directions
+
 =item Reporting Bugs
 
 =item SEE ALSO
 
-=item HISTORY
-
 =back
 
-=head2 perl571delta - what's new for perl v5.7.1
+=head2 perl58delta - what is new for perl v5.8.0
 
 =over 4
 
 =item DESCRIPTION
 
-=item Security Vulnerability Closed
+=item Highlights In 5.8.0
 
 =item Incompatible Changes
 
-=item Core Enhancements
-
 =over 4
 
-=item AUTOLOAD Is Now Lvaluable
+=item Binary Incompatibility
 
-=item PerlIO is Now The Default
+=item 64-bit platforms and malloc
 
-=item Signals Are Now Safe
+=item AIX Dynaloading
 
-=back
+=item Attributes for C<my> variables now handled at run-time
 
-=item Modules and Pragmata
+=item Socket Extension Dynamic in VMS
 
-=over 4
+=item IEEE-format Floating Point Default on OpenVMS Alpha
 
-=item New Modules
+=item New Unicode Semantics (no more C<use utf8>, almost)
 
-=item Updated And Improved Modules and Pragmata
+=item New Unicode Properties
 
-=back
+=item REF(...) Instead Of SCALAR(...)
 
-=item Performance Enhancements
+=item pack/unpack D/F recycled
 
-=item Utility Changes
+=item glob() now returns filenames in alphabetical order
 
-=item New Documentation
+=item Deprecations
+
+=back
+
+=item Core Enhancements
 
 =over 4
 
-=item perlclib
+=item Unicode Overhaul
 
-=item perliol
+=item PerlIO is Now The Default
 
-=item README.aix
+=item ithreads
 
-=item README.bs2000
+=item Restricted Hashes
 
-=item README.macos
+=item Safe Signals
 
-=item README.mpeix
+=item Understanding of Numbers
 
-=item README.solaris
+=item Arrays now always interpolate into double-quoted strings [561]
 
-=item README.vos
+=item Miscellaneous Changes
 
-=item Porting/repository.pod
+=back
+
+=item Modules and Pragmata
+
+=over 4
+
+=item New Modules and Pragmata
+
+=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 New Or Improved Platforms
-
 =item Generic Improvements
 
-d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
-need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
-d_strtoq, d_u32align, d_ualarm, d_usleep
+=item New Or Improved Platforms
 
 =back
 
@@ -6135,119 +6373,111 @@ d_strtoq, d_u32align, d_ualarm, d_usleep
 
 =item Changed Internals
 
+=item Security Vulnerability Closed [561]
+
 =item New Tests
 
 =item Known Problems
 
 =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 The Compiler Suite Is Still Very Experimental
 
-=item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
+=item Localising Tied Arrays and Hashes Is Broken
 
-=item lib/b test 19
+=item Building Extensions Can Fail Because Of Largefiles
 
-=item Linux With Sfio Fails op/misc Test 48
+=item Modifying $_ Inside for(..)
 
-=item sigaction test 13 in VMS
+=item mod_perl 1.26 Doesn't Build With Threaded Perl
 
-=item sprintf tests 129 and 130
+=item lib/ftmp-security tests warn 'system possibly insecure'
 
-=item  Failure of Thread tests
+=item libwww-perl (LWP) fails base/date #51
 
-=item Localising a Tied Variable Leaks Memory
+=item PDL failing some tests
 
-=item Self-tying of Arrays and Hashes Is Forbidden
+=item Perl_get_sv
 
-=item Building Extensions Can Fail Because Of Largefiles
+=item Self-tying Problems
 
-=item The Compiler Suite Is Still Experimental
+=item ext/threads/t/libc
 
-=back
+=item Failure of Thread (5.005-style) tests
 
-=item Reporting Bugs
+=item Timing problems
 
-=item SEE ALSO
+=item Tied/Magical Array/Hash Elements Do Not Autovivify
 
-=item HISTORY
+=item Unicode in package/class and subroutine names does not work
 
 =back
 
-=head2 perl570delta - what's new for perl v5.7.0
+=item Platform Specific Problems
 
 =over 4
 
-=item DESCRIPTION
-
-=item Security Vulnerability Closed
-
-=item Incompatible Changes
-
-=item Core Enhancements
+=item AIX
 
-=item Modules and Pragmata
+=item Alpha systems with old gccs fail several tests
 
-=over 4
+=item AmigaOS
 
-=item New Modules
+=item BeOS
 
-=item Updated And Improved Modules and Pragmata
+=item Cygwin "unable to remap"
 
-=back
+=item Cygwin ndbm tests fail on FAT
 
-=item Utility Changes
+=item DJGPP Failures
 
-=item New Documentation
+=item FreeBSD built with ithreads coredumps reading large directories
 
-=item Performance Enhancements
+=item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
 
-=item Installation and Configuration Improvements
+=item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
 
-=over 4
+=item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
 
-=item Generic Improvements
+=item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
 
-=back
+=item Linux With Sfio Fails op/misc Test 48
 
-=item Selected Bug Fixes
+=item Mac OS X
 
-=over 4
+=item Mac OS X dyld undefined symbols
 
-=item Platform Specific Changes and Fixes
+=item OS/2 Test Failures
 
-=back
+=item op/sprintf tests 91, 129, and 130
 
-=item New or Changed Diagnostics
+=item SCO
 
-=item Changed Internals
+=item Solaris 2.5
 
-=item Known Problems
+=item Solaris x86 Fails Tests With -Duse64bitint
 
-=over 4
+=item SUPER-UX (NEC SX)
 
-=item Unicode Support Still Far From Perfect
+=item Term::ReadKey not working on Win32
 
-=item EBCDIC Still A Lost Platform
+=item UNICOS/mk
 
-=item Building Extensions Can Fail Because Of Largefiles
+=item UTS
 
-=item ftmp-security tests warn 'system possibly insecure'
+=item VOS (Stratus)
 
-=item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
+=item VMS
 
-=item Long Doubles Still Don't Work In Solaris
+=item Win32
 
-=item Linux With Sfio Fails op/misc Test 48
+=item XML::Parser not working
 
-=item Storable tests fail in some platforms
+=item z/OS (OS/390)
 
-=item Threads Are Still Experimental
+=item Unicode Support on EBCDIC Still Spotty
 
-=item The Compiler Suite Is Still Experimental
+=item Seen In Perl 5.7 But Gone Now
 
 =back
 
@@ -6259,1276 +6489,3648 @@ d_strtoq, d_u32align, d_ualarm, d_usleep
 
 =back
 
-=head2 perl561delta - what's new for perl v5.6.x
+=head2 perl573delta - what's new for perl v5.7.3
 
 =over 4
 
 =item DESCRIPTION
 
-=item Summary of changes between 5.6.0 and 5.6.1
+=item Changes
 
-=over 4
+=item Reporting Bugs
 
-=item Security Issues
+=item SEE ALSO
 
-=item Core bug fixes
+=item HISTORY
 
-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
+=back
 
-=item Core features
+=head2 perl572delta - what's new for perl v5.7.2
 
-=item Configuration issues
+=over 4
 
-=item Documentation
+=item DESCRIPTION
 
-=item Bundled modules
+=item Security Vulnerability Closed
 
-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 Incompatible Changes
 
-=item Platform-specific improvements
+=over 4
 
-NCR MP-RAS, NonStop-UX
+=item 64-bit platforms and malloc
+
+=item AIX Dynaloading
+
+=item Socket Extension Dynamic in VMS
+
+=item Different Definition of the Unicode Character Classes \p{In...}
+
+=item Deprecations
 
 =back
 
 =item Core Enhancements
 
+=item Modules and Pragmata
+
 =over 4
 
-=item Interpreter cloning, threads, and concurrency
+=item New Modules and Distributions
 
-=item Lexically scoped warning categories
+=item Updated And Improved Modules and Pragmata
 
-=item Unicode and UTF-8 support
+=back
 
-=item Support for interpolating named characters
+=item Utility Changes
 
-=item "our" declarations
+=item New Documentation
 
-=item Support for strings represented as a vector of ordinals
+=item Installation and Configuration Improvements
 
-=item Improved Perl version numbering system
+=over 4
 
-=item New syntax for declaring subroutine attributes
+=item New Or Improved Platforms
 
-=item File and directory handles can be autovivified
+=item Generic Improvements
 
-=item open() with more than two arguments
+=back
 
-=item 64-bit support
+=item Selected Bug Fixes
 
-=item Large file support
+=over 4
 
-=item Long doubles
+=item Platform Specific Changes and Fixes
 
-=item "more bits"
+=back
 
-=item Enhanced support for sort() subroutines
+=item New or Changed Diagnostics
 
-=item C<sort $coderef @foo> allowed
+=item Source Code Enhancements
 
-=item File globbing implemented internally
+=over 4
 
-=item Support for CHECK blocks
+=item MAGIC constants
 
-=item POSIX character class syntax [: :] supported
+=item Better commented code
 
-=item Better pseudo-random number generator
+=item Regex pre-/post-compilation items matched up
 
-=item Improved C<qw//> operator
+=item gcc -Wall
 
-=item Better worst-case behavior of hashes
+=back
 
-=item pack() format 'Z' supported
+=item New Tests
 
-=item pack() format modifier '!' supported
+=item Known Problems
 
-=item pack() and unpack() support counted strings
+=over 4
 
-=item Comments in pack() templates
+=item AIX
 
-=item Weak references
+=item Amiga Perl Invoking Mystery
 
-=item Binary numbers supported
+=item lib/ftmp-security tests warn 'system possibly insecure'
 
-=item Lvalue subroutines
+=item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
 
-=item Some arrows may be omitted in calls through references
+=item HP-UX lib/io_multihomed Fails When LP64-Configured
 
-=item Boolean assignment operators are legal lvalues
+=item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
 
-=item exists() is supported on subroutine names
+=item Linux With Sfio Fails op/misc Test 48
 
-=item exists() and delete() are supported on array elements
+=item OS/390
 
-=item Pseudo-hashes work better
+=item op/sprintf tests 129 and 130
 
-=item Automatic flushing of output buffers
+=item  Failure of Thread tests
 
-=item Better diagnostics on meaningless filehandle operations
+=item UNICOS
 
-=item Where possible, buffered data discarded from duped input filehandle
+=item UTS
 
-=item eof() has the same old magic as <>
+=item VMS
 
-=item binmode() can be used to set :crlf and :raw modes
+=item Win32
 
-=item C<-T> filetest recognizes UTF-8 encoded files as "text"
+=item Localising a Tied Variable Leaks Memory
 
-=item system(), backticks and pipe open now reflect exec() failure
+=item Self-tying of Arrays and Hashes Is Forbidden
 
-=item Improved diagnostics
+=item Variable Attributes are not Currently Usable for Tieing
 
-=item Diagnostics follow STDERR
+=item Building Extensions Can Fail Because Of Largefiles
 
-=item More consistent close-on-exec behavior
+=item The Compiler Suite Is Still Experimental
 
-=item syswrite() ease-of-use
+=item The Long Double Support is Still Experimental
 
-=item Better syntax checks on parenthesized unary operators
+=back
 
-=item Bit operators support full native integer width
+=item Reporting Bugs
 
-=item Improved security features
+=item SEE ALSO
 
-=item More functional bareword prototype (*)
+=item HISTORY
 
-=item C<require> and C<do> may be overridden
+=back
 
-=item $^X variables may now have names longer than one character
+=head2 perl571delta - what's new for perl v5.7.1
 
-=item New variable $^C reflects C<-c> switch
+=over 4
 
-=item New variable $^V contains Perl version as a string
+=item DESCRIPTION
+
+=item Security Vulnerability Closed
+
+=item Incompatible Changes
+
+=item Core Enhancements
+
+=over 4
+
+=item AUTOLOAD Is Now Lvaluable
+
+=item PerlIO is Now The Default
+
+=item Signals Are Now Safe
+
+=back
+
+=item Modules and Pragmata
+
+=over 4
+
+=item New Modules
+
+=item Updated And Improved Modules and Pragmata
+
+=back
+
+=item Performance Enhancements
+
+=item Utility Changes
+
+=item New Documentation
+
+=over 4
+
+=item perlclib
+
+=item perliol
+
+=item README.aix
+
+=item README.bs2000
+
+=item README.macos
+
+=item README.mpeix
+
+=item README.solaris
+
+=item README.vos
+
+=item Porting/repository.pod
+
+=back
+
+=item Installation and Configuration Improvements
+
+=over 4
+
+=item New Or Improved Platforms
+
+=item Generic Improvements
+
+d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
+need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
+d_strtoq, d_u32align, d_ualarm, d_usleep
+
+=back
+
+=item Selected Bug Fixes
+
+=over 4
+
+=item Platform Specific Changes and Fixes
+
+=back
+
+=item New or Changed Diagnostics
+
+=item Changed Internals
+
+=item New Tests
+
+=item Known Problems
+
+=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 Enhanced Installation Directories
+
+=item gcc automatically tried if 'cc' does not seem to be working
+
+=back
+
+=item Platform specific changes
+
+=over 4
+
+=item Supported platforms
+
+=item DOS
+
+=item OS390 (OpenEdition MVS)
+
+=item VMS
+
+=item Win32
+
+=back
+
+=item Significant bug fixes
+
+=over 4
+
+=item <HANDLE> on empty files
+
+=item C<eval '...'> improvements
+
+=item All compilation errors are true errors
+
+=item Implicitly closed filehandles are safer
+
+=item Behavior of list slices is more consistent
+
+=item C<(\$)> prototype and C<$foo{a}>
+
+=item C<goto &sub> and AUTOLOAD
+
+=item C<-bareword> allowed under C<use integer>
+
+=item Failures in DESTROY()
+
+=item Locale bugs fixed
+
+=item Memory leaks
+
+=item Spurious subroutine stubs after failed subroutine calls
+
+=item Taint failures under C<-U>
+
+=item END blocks and the C<-c> switch
+
+=item Potential to leak DATA filehandles
+
+=back
+
+=item New or Changed Diagnostics
+
+"%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 New tests
+
+=item Incompatible Changes
+
+=over 4
+
+=item Perl Source Incompatibilities
+
+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 C Source Incompatibilities
+
+C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
+
+=item Compatible C Source API Changes
+
+C<PATCHLEVEL> is now C<PERL_VERSION>
+
+=item Binary Incompatibilities
+
+=back
+
+=item Known Problems
+
+=over 4
+
+=item Localizing a tied hash element may leak memory
+
+=item Known test failures
+
+=item EBCDIC platforms not fully supported
+
+=item UNICOS/mk CC failures during Configure run
+
+=item Arrow operator and arrays
+
+=item Experimental features
+
+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:
+
+=back
+
+=item Obsolete Diagnostics
+
+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
+
+=item SEE ALSO
+
+=item HISTORY
+
+=back
+
+=head2 perl56delta - what's new for perl v5.6.0
+
+=over 4
+
+=item DESCRIPTION
+
+=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 Enhanced Installation Directories
+
+=back
+
+=item Platform specific changes
+
+=over 4
+
+=item Supported platforms
+
+=item DOS
+
+=item OS390 (OpenEdition MVS)
+
+=item VMS
+
+=item Win32
+
+=back
+
+=item Significant bug fixes
+
+=over 4
+
+=item <HANDLE> on empty files
+
+=item C<eval '...'> improvements
+
+=item All compilation errors are true errors
+
+=item Implicitly closed filehandles are safer
+
+=item Behavior of list slices is more consistent
+
+=item C<(\$)> prototype and C<$foo{a}>
+
+=item C<goto &sub> and AUTOLOAD
+
+=item C<-bareword> allowed under C<use integer>
+
+=item Failures in DESTROY()
+
+=item Locale bugs fixed
+
+=item Memory leaks
+
+=item Spurious subroutine stubs after failed subroutine calls
+
+=item Taint failures under C<-U>
+
+=item END blocks and the C<-c> switch
+
+=item Potential to leak DATA filehandles
+
+=back
+
+=item New or Changed Diagnostics
+
+"%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 New tests
+
+=item Incompatible Changes
+
+=over 4
+
+=item Perl Source Incompatibilities
+
+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 C Source Incompatibilities
+
+C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
+
+=item Compatible C Source API Changes
+
+C<PATCHLEVEL> is now C<PERL_VERSION>
+
+=item Binary Incompatibilities
+
+=back
+
+=item Known Problems
+
+=over 4
+
+=item Thread test failures
+
+=item EBCDIC platforms not supported
+
+=item In 64-bit HP-UX the lib/io_multihomed test may hang
+
+=item NEXTSTEP 3.3 POSIX test failure
+
+=item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
+gcc
+
+=item UNICOS/mk CC failures during Configure run
+
+=item Arrow operator and arrays
+
+=item Experimental features
+
+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:
+
+=back
+
+=item Obsolete Diagnostics
+
+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
+
+=item SEE ALSO
+
+=item HISTORY
+
+=back
+
+=head2 perl5005delta - what's new for perl5.005
+
+=over 4
+
+=item DESCRIPTION
+
+=item About the new versioning system
+
+=item Incompatible Changes
+
+=over 4
+
+=item WARNING: This version is not binary compatible with Perl 5.004.
+
+=item Default installation structure has changed
+
+=item Perl Source Compatibility
+
+=item C Source Compatibility
+
+=item Binary Compatibility
+
+=item Security fixes may affect compatibility
+
+=item Relaxed new mandatory warnings introduced in 5.004
+
+=item Licensing
+
+=back
+
+=item Core Changes
+
+=over 4
+
+=item Threads
+
+=item Compiler
+
+=item Regular Expressions
+
+Many new and improved optimizations, Many bug fixes, New regular expression
+constructs, New operator for precompiled regular expressions, Other
+improvements, Incompatible changes
+
+=item  Improved malloc()
+
+=item Quicksort is internally implemented
+
+=item Reliable signals
+
+=item Reliable stack pointers
+
+=item More generous treatment of carriage returns
+
+=item Memory leaks
+
+=item Better support for multiple interpreters
+
+=item Behavior of local() on array and hash elements is now well-defined
+
+=item C<%!> is transparently tied to the L<Errno> module
+
+=item Pseudo-hashes are supported
+
+=item C<EXPR foreach EXPR> is supported
+
+=item Keywords can be globally overridden
+
+=item C<$^E> is meaningful on Win32
+
+=item C<foreach (1..1000000)> optimized
+
+=item C<Foo::> can be used as implicitly quoted package name
+
+=item C<exists $Foo::{Bar::}> tests existence of a package
+
+=item Better locale support
+
+=item Experimental support for 64-bit platforms
+
+=item prototype() returns useful results on builtins
+
+=item Extended support for exception handling
+
+=item Re-blessing in DESTROY() supported for chaining DESTROY() methods
+
+=item All C<printf> format conversions are handled internally
+
+=item New C<INIT> keyword
+
+=item New C<lock> keyword
+
+=item New C<qr//> operator
+
+=item C<our> is now a reserved word
+
+=item Tied arrays are now fully supported
+
+=item Tied handles support is better
+
+=item 4th argument to substr
+
+=item Negative LENGTH argument to splice
+
+=item Magic lvalues are now more magical
+
+=item <> now reads in records
+
+=back
+
+=item Supported Platforms
+
+=over 4
+
+=item New Platforms
+
+=item Changes in existing support
+
+=back
+
+=item Modules and Pragmata
+
+=over 4
+
+=item New Modules
+
+B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
+ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
+Thread, attrs, fields, re
+
+=item Changes in existing modules
+
+Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
+MakeMaker, CPAN, Cwd
+
+=back
+
+=item Utility Changes
+
+=item Documentation Changes
+
+=item New Diagnostics
+
+Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
+while coercing array into hash, Bareword "%s" refers to nonexistent
+package, Can't call method "%s" on an undefined value, Can't check
+filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
+goto subroutine from an eval-string, Can't localize pseudo-hash element,
+Can't use %%! because Errno.pm is not available, Cannot find an opnumber
+for "%s", Character class syntax [. .] is reserved for future extensions,
+Character class syntax [: :] is reserved for future extensions, Character
+class syntax [= =] is reserved for future extensions, %s: Eval-group in
+insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
+Eval-group not allowed at run time, Explicit blessing to '' (assuming
+package main), Illegal hex digit ignored, No such array field, No such
+field "%s" in variable %s of type %s, Out of memory during ridiculously
+large request, Range iterator outside integer range, Recursive inheritance
+detected while looking for method '%s' %s, Reference found where even-sized
+list expected, Undefined value assigned to typeglob, Use of reserved word
+"%s" is deprecated, perl: warning: Setting locale failed
+
+=item Obsolete Diagnostics
+
+Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
+temporary file, regexp too big
+
+=item Configuration Changes
+
+=item BUGS
+
+=item SEE ALSO
+
+=item HISTORY
+
+=back
+
+=head2 perl5004delta - what's new for perl5.004
+
+=over 4
+
+=item DESCRIPTION
+
+=item Supported Environments
+
+=item Core Changes
+
+=over 4
+
+=item List assignment to %ENV works
+
+=item Change to "Can't locate Foo.pm in @INC" error
+
+=item Compilation option: Binary compatibility with 5.003
+
+=item $PERL5OPT environment variable
+
+=item Limitations on B<-M>, B<-m>, and B<-T> options
+
+=item More precise warnings
+
+=item Deprecated: Inherited C<AUTOLOAD> for non-methods
+
+=item Previously deprecated %OVERLOAD is no longer usable
+
+=item Subroutine arguments created only when they're modified
+
+=item Group vector changeable with C<$)>
+
+=item Fixed parsing of $$<digit>, &$<digit>, etc.
+
+=item Fixed localization of $<digit>, $&, etc.
+
+=item No resetting of $. on implicit close
+
+=item C<wantarray> may return undef
+
+=item C<eval EXPR> determines value of EXPR in scalar context
+
+=item Changes to tainting checks
+
+No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
+spawning if tainted $TERM doesn't look like a terminal name
+
+=item New Opcode module and revised Safe module
+
+=item Embedding improvements
+
+=item Internal change: FileHandle class based on IO::* classes
+
+=item Internal change: PerlIO abstraction interface
+
+=item New and changed syntax
+
+$coderef->(PARAMS)
+
+=item New and changed builtin constants
+
+__PACKAGE__
+
+=item New and changed builtin variables
+
+$^E, $^H, $^M
+
+=item New and changed builtin functions
+
+delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
+Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
+VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
+reset search position on failure, C<m//x> ignores whitespace before ?*+{},
+nested C<sub{}> closures work now, formats work right on changing lexicals
+
+=item New builtin methods
+
+isa(CLASS), can(METHOD), VERSION( [NEED] )
+
+=item TIEHANDLE now supported
+
+TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
+LIST, READLINE this, GETC this, DESTROY this
+
+=item Malloc enhancements
+
+-DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
+
+=item Miscellaneous efficiency enhancements
+
+=back
+
+=item Support for More Operating Systems
+
+=over 4
+
+=item Win32
+
+=item Plan 9
+
+=item QNX
+
+=item AmigaOS
+
+=back
+
+=item Pragmata
+
+use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
+constant NAME => VALUE, use locale, use ops, use vmsish
+
+=item Modules
+
+=over 4
+
+=item Required Updates
+
+=item Installation directories
+
+=item Module information summary
+
+=item Fcntl
+
+=item IO
+
+=item Math::Complex
+
+=item Math::Trig
+
+=item DB_File
+
+=item Net::Ping
+
+=item Object-oriented overrides for builtin operators
+
+=back
+
+=item Utility Changes
+
+=over 4
+
+=item pod2html
+
+Sends converted HTML to standard output
+
+=item xsubpp
+
+C<void> XSUBs now default to returning nothing
+
+=back
+
+=item C Language API Changes
+
+C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
+manipulating hashes
+
+=item Documentation Changes
+
+L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
+L<perlmodlib>, L<perldebug>, L<perlsec>
+
+=item New Diagnostics
+
+"my" variable %s masks earlier declaration in same scope, %s argument is
+not a HASH element or slice, Allocation too large: %lx, Allocation too
+large, Applying %s to %s will act on scalar(%s), Attempt to free
+nonexistent shared string, Attempt to use reference as lvalue in substr,
+Bareword "%s" refers to nonexistent package, Can't redefine active sort
+subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
+use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
+subroutine %s redefined, Constant subroutine %s undefined, Copy method did
+not return a reference, Died, Exiting pseudo-block via %s, Identifier too
+long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
+%s, Integer overflow in hex number, Integer overflow in octal number,
+internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
+in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
+possible typo, Null picture in formline, Offset outside string, Out of
+memory!, Out of memory during request for %s, panic: frexp, Possible
+attempt to put comments in qw() list, Possible attempt to separate words
+with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
+while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
+option, untie attempted while %d inner references still exist, Unrecognized
+character %s, Unsupported function fork, Use of "$$<digit>" to mean
+"${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
+Variable "%s" may be unavailable, Variable "%s" will not stay shared,
+Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
+Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
+long, Process terminated by SIG%s
+
+=item BUGS
+
+=item SEE ALSO
+
+=item HISTORY
+
+=back
+
+=head2 perlartistic - the Perl Artistic License
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item The "Artistic License"
+
+=over 4
+
+=item Preamble
+
+=item Definitions
+
+"Package", "Standard Version", "Copyright Holder", "You", "Reasonable
+copying fee", "Freely Available"
+
+=item Conditions
+
+a), b), c), d), a), b), c), d)
+
+=back
+
+=back
+
+=head2 perlgpl - the GNU General Public License, version 2
+
+=over 4
+
+=item SYNOPSIS
+
+=back
+
+=over 4
+
+=item DESCRIPTION
+
+=item GNU GENERAL PUBLIC LICENSE
+
+=back
+
+=head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item Compiling Perl 5 on AIX
+
+=item OS level
+
+=item Building Dynamic Extensions on AIX
+
+=item The IBM ANSI C Compiler
+
+=item The usenm option
+
+=item Using GNU's gcc for building perl
+
+=item Using Large Files with Perl
+
+=item Threaded Perl
+
+=item 64-bit Perl
+
+=item AIX 4.2 and extensions using C++ with statics
+
+=back
+
+=item AUTHOR
+
+=item DATE
+
+=back
+
+=head2 perlamiga - Perl under Amiga OS
+
+=over 4
+
+=item NOTE
+
+=item SYNOPSIS
+
+=back
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item Prerequisites for Compiling Perl on AmigaOS
+
+B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
+
+=item Starting Perl programs under AmigaOS
+
+=item Shortcomings of Perl under AmigaOS
+
+=back
+
+=item INSTALLATION
+
+=item Accessing documentation
+
+=over 4
+
+=item Manpages for Perl on AmigaOS
+
+=item Perl HTML Documentation on AmigaOS
+
+=item Perl GNU Info Files on AmigaOS
+
+=item Perl LaTeX Documentation on AmigaOS
+
+=back
+
+=item BUILDING PERL ON AMIGAOS
+
+=over 4
+
+=item Build Prerequisites for Perl on AmigaOS
+
+=item Getting the Perl Source for AmigaOS
+
+=item Making Perl on AmigaOS
+
+=item Testing Perl on AmigaOS
+
+=item Installing the built Perl on AmigaOS
+
+=back
+
+=item PERL 5.8.0 BROKEN IN AMIGAOS
+
+=item AUTHORS
+
+=item SEE ALSO
+
+=back
+
+=head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
+
+=over 4
+
+=item DESCRIPTION
+
+=item AUTHOR
+
+=back
+
+=head2 perlbeos, README.beos - Perl version 5.8+ on BeOS
+
+=over 4
+
+=item DESCRIPTION
+
+=item BUILD AND INSTALL
+
+=over 4
+
+=item Requirements
+
+=item Configure
+
+=item Build
+
+=item Install
+
+=back
+
+=item KNOWN PROBLEMS
+
+=item CONTACT
+
+=back
+
+=head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item gzip on BS2000
+
+=item bison on BS2000
+
+=item Unpacking Perl Distribution on BS2000
+
+=item Compiling Perl on BS2000
+
+=item Testing Perl on BS2000
+
+=item Installing Perl on BS2000
+
+=item Using Perl in the Posix-Shell of BS2000
+
+=item Using Perl in "native" BS2000
+
+=item Floating point anomalies on BS2000
+
+=item Using PerlIO and different encodings on ASCII and EBCDIC partitions
+
+=back
+
+=item AUTHORS
+
+=item SEE ALSO
+
+=over 4
+
+=item Mailing list
+
+=back
+
+=item HISTORY
+
+=back
+
+=head2 perlce - Perl for WinCE
+
+=over 4
+
+=item DESCRIPTION
+
+=item BUILD
+
+=over 4
+
+=item Tools & SDK
+
+Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's
+celib-sources, Rainer Keuchel's console-sources
+
+=item Make
+
+go to ./wince subdirectory, edit file compile.bat, run   compile.bat, run 
+  compile.bat dist
+
+=back
+
+=item ACKNOWLEDGEMENTS
+
+=item AUTHORS
+
+=back
+
+=head2 perlcygwin, README.cygwin - Perl for Cygwin
+
+=over 4
+
+=item SYNOPSIS
+
+=item PREREQUISITES FOR COMPILING PERL ON CYGWIN
+
+=over 4
+
+=item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
+
+=item Cygwin Configuration
+
+C<PATH>, I<nroff>, Permissions
+
+=back
+
+=item CONFIGURE PERL ON CYGWIN
+
+=over 4
+
+=item Stripping Perl Binaries on Cygwin
+
+=item Optional Libraries for Perl on Cygwin
+
+C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
+C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
+
+=item Configure-time Options for Perl on Cygwin
+
+C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
+C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
+C<-Dmksymlinks>
+
+=item Suspicious Warnings on Cygwin
+
+I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
+
+=back
+
+=item MAKE ON CYGWIN
+
+=over 4
+
+=item Errors on Cygwin
+
+=item ld2 on Cygwin
+
+=back
+
+=item TEST ON CYGWIN
+
+=over 4
+
+=item File Permissions on Cygwin
+
+=item NDBM_File and ODBM_File do not work on FAT filesystems
+
+=item C<fork()> failures in io_* tests
+
+=back
+
+=item Specific features of the Cygwin port
+
+=over 4
+
+=item Script Portability on Cygwin
+
+Pathnames, Text/Binary, PerlIO, F<.exe>, cygwin vs. windows process ids,
+C<chown()>, Miscellaneous
+
+=item Prebuilt methods:
+
+C<Cwd::cwd>, C<Cygwin::pid_to_winpid>, C<Cygwin::winpid_to_pid>
+
+=back
+
+=item INSTALL PERL ON CYGWIN
+
+=item MANIFEST ON CYGWIN
+
+Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
+Source, Compiled Module Source, Perl Modules/Scripts
+
+=item BUGS ON CYGWIN
+
+=item AUTHORS
+
+=item HISTORY
+
+=back
+
+=head2 perldgux - Perl under DG/UX.
+
+=over 4
+
+=item SYNOPSIS
+
+=back
+
+=over 4
+
+=item DESCRIPTION
+
+=item BUILDING PERL ON DG/UX
+
+=over 4
+
+=item Non-threaded Perl on DG/UX
+
+=item Threaded Perl on DG/UX
+
+=item Testing Perl on DG/UX
+
+=item Installing the built perl on DG/UX
+
+=back
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
+=head2 perldos - Perl under DOS, W31, W95.
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Prerequisites for Compiling Perl on DOS
+
+DJGPP, Pthreads
+
+=item Shortcomings of Perl under DOS
+
+=item Building Perl on DOS
+
+=item Testing Perl on DOS
+
+=item Installation of Perl on DOS
+
+=back
+
+=item BUILDING AND INSTALLING MODULES ON DOS
+
+=over 4
+
+=item Building Prerequisites for Perl on DOS
+
+=item Unpacking CPAN Modules on DOS
+
+=item Building Non-XS Modules on DOS
+
+=item Building XS Modules on DOS
+
+=back
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
+=head2 perlepoc, README.epoc - Perl for EPOC
+
+=over 4
+
+=item SYNOPSIS
+
+=item INTRODUCTION
+
+=item INSTALLING PERL ON EPOC
+
+=item STARTING PERL ON EPOC
+
+=over 4
+
+=item Editors on Epoc
+
+=item Features of Perl on Epoc
+
+=item Restrictions of Perl on Epoc
+
+=item Compiling Perl 5 on the EPOC cross compiling environment
+
+=back
+
+=item SUPPORT STATUS OF PERL ON EPOC
+
+=item AUTHOR
+
+=item LAST UPDATE
+
+=back
+
+=head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item FreeBSD core dumps from readdir_r with ithreads
+
+=item $^X doesn't always contain a full path in FreeBSD
+
+=item Perl will no longer be part of "base FreeBSD"
+
+=back
+
+=item AUTHOR
+
+=back
+
+=head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
+(HP-UX) systems
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item Using perl as shipped with HP-UX
+
+=item Using perl from HP's porting centre
+
+=item Compiling Perl 5 on HP-UX
+
+=item PA-RISC
+
+=item Portability Between PA-RISC Versions
+
+=item PA-RISC 1.0
+
+=item PA-RISC 1.1
+
+=item PA-RISC 2.0
+
+=item Itanium Processor Family and HP-UX
+
+=item Itanium & Itanium 2
+
+=item Building Dynamic Extensions on HP-UX
+
+=item The HP ANSI C Compiler
+
+=item The GNU C Compiler
+
+=item Using Large Files with Perl on HP-UX
+
+=item Threaded Perl on HP-UX
+
+=item 64-bit Perl on HP-UX
+
+=item Oracle on HP-UX
+
+=item GDBM and Threads on HP-UX
+
+=item NFS filesystems and utime(2) on HP-UX
+
+=item perl -P and // and HP-UX
+
+=item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
+
+=back
+
+=item nss_delete core dump from op/pwent or op/grent
+
+=item AUTHOR
+
+=item DATE
+
+=back
+
+=head2 perlhurd, README.hurd - Perl version 5 on Hurd
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item Known Problems with Perl on Hurd 
+
+=back
+
+=item AUTHOR
+
+=back
+
+=head2 perlirix, README.irix - Perl version 5 on Irix systems
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item Building 32-bit Perl in Irix
+
+=item Building 64-bit Perl in Irix
+
+=item About Compiler Versions of Irix
+
+=item Linker Problems in Irix
+
+=item Malloc in Irix
+
+=item Building with threads in Irix
+
+=item Irix 5.3
+
+=back
+
+=item AUTHOR
+
+=back
+
+=head2 perlmachten, README.machten - Perl version 5 on Power MachTen
+systems
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=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
+
+op/lexassign.t, pragma/warnings.t
+
+=item Building external modules on MachTen
+
+=back
+
+=item AUTHOR
+
+=item DATE
+
+=back
+
+=head2 perlmacos, README.macos - Perl under Mac OS (Classic)
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item AUTHOR
+
+=item DATE
+
+=back
+
+=head2 perlmacosx, README.macosx - Perl under Mac OS X
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Installation Prefix
+
+=item libperl and Prebinding
+
+=item Updating Panther
+
+=item Known problems
+
+=item MacPerl
+
+=item Carbon
+
+=item Cocoa
+
+=back
+
+=item Starting From Scratch
+
+=item AUTHOR
+
+=item DATE
+
+=back
+
+=head2 perlmint, README.mint - Perl version 5 on Atari MiNT
+
+=over 4
+
+=item DESCRIPTION
+
+=item Known problems with Perl on MiNT
+
+=item AUTHOR
+
+=back
+
+=head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
+
+=over 4
+
+=item SYNOPSIS
+
+=item NOTE
+
+=item Binary distribution from HP
+
+=item What's New in Perl for MPE/iX
+
+=item Welcome to Perl/iX
+
+=item System Requirements for Perl/iX
+
+=item How to Obtain Perl/iX
+
+=item Perl/iX Distribution Contents Highlights
+
+README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
+public_html/feedback.cgi, src/perl-5.6.0-mpe
+
+=item How to Compile Perl/iX
+
+ 4,  6
+
+=item Getting Started with Perl/iX
+
+=item MPE/iX Implementation Considerations
+
+=item Known Perl/iX Bugs Under Investigation
+
+=item Perl/iX To-Do List
+
+=item Perl/iX Change History
+
+=item AUTHOR
+
+=back
+
+=head2 perlnetware - Perl for NetWare
+
+=over 4
+
+=item DESCRIPTION
+
+=item BUILD
+
+=over 4
+
+=item Tools & SDK
+
+=item Setup
+
+SetNWBld.bat, Buildtype.bat
+
+=item Make
+
+=item Interpreter
+
+=item Extensions
+
+=back
+
+=item INSTALL
+
+=item BUILD NEW EXTENSIONS
+
+=item ACKNOWLEDGEMENTS
+
+=item AUTHORS
+
+=item DATE
+
+=back
+
+=head2 perlopenbsd, README.openbsd - Perl version 5 on OpenBSD systems
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item OpenBSD core dumps from getprotobyname_r and getservbyname_r with
+ithreads
+
+=back
+
+=item AUTHOR
+
+=back
+
+=head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
+
+=over 4
+
+=item SYNOPSIS
+
+=back
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item Target
+
+=item Other OSes
+
+=item Prerequisites
+
+EMX, RSX, HPFS, pdksh
+
+=item Starting Perl programs under OS/2 (and DOS and...)
+
+=item Starting OS/2 (and DOS) programs under Perl
+
+=back
+
+=item Frequently asked questions
+
+=over 4
+
+=item "It does not work"
+
+=item I cannot run external programs
+
+=item I cannot embed perl into my program, or use F<perl.dll> from my
+program. 
+
+Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
+L<ExtUtils::Embed>?
+
+=item C<``> and pipe-C<open> do not work under DOS.
+
+=item Cannot start C<find.exe "pattern" file>
+
+=back
+
+=item INSTALLATION
+
+=over 4
+
+=item Automatic binary installation
+
+C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
+
+=item Manual binary installation
+
+Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
+(statically linked), Executables for Perl utilities, Main Perl library,
+Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
+and utilities, Manpages for Perl modules, Source for Perl documentation,
+Perl manual in F<.INF> format, Pdksh
+
+=item B<Warning>
+
+=back
+
+=item Accessing documentation
+
+=over 4
+
+=item OS/2 F<.INF> file
+
+=item Plain text
+
+=item Manpages
+
+=item HTML
+
+=item GNU C<info> files
+
+=item F<PDF> files
+
+=item C<LaTeX> docs
+
+=back
+
+=item BUILD
+
+=over 4
+
+=item The short story
+
+=item Prerequisites
+
+=item Getting perl source
+
+=item Application of the patches
+
+=item Hand-editing
+
+=item Making
+
+=item Testing
+
+A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
+F<op/stat.t>
+
+=item Installing the built perl
+
+=item C<a.out>-style build
+
+=back
+
+=item Building a binary distribution
+
+=item Building custom F<.EXE> files
+
+=over 4
+
+=item Making executables with a custom collection of statically loaded
+extensions
+
+=item Making executables with a custom search-paths
+
+=back
+
+=item Build FAQ
+
+=over 4
+
+=item Some C</> became C<\> in pdksh.
+
+=item C<'errno'> - unresolved external
+
+=item Problems with tr or sed
+
+=item Some problem (forget which ;-)
+
+=item Library ... not found
+
+=item Segfault in make
+
+=item op/sprintf test failure
+
+=back
+
+=item Specific (mis)features of OS/2 port
+
+=over 4
+
+=item C<setpriority>, C<getpriority>
+
+=item C<system()>
+
+=item C<extproc> on the first line
+
+=item Additional modules:
+
+=item Prebuilt methods:
+
+C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
+ C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>, 
+C<Cwd::sys_is_absolute(name)>, C<Cwd::sys_is_rooted(name)>, 
+C<Cwd::sys_is_relative(name)>, C<Cwd::sys_cwd(name)>, 
+C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>, 
+C<Cwd::extLibpath_set( path [, type ] )>,
+C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
+OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
+C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
+C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
+OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
+C<OS2::DLLname([how [, \&xsub]])>
+
+=item Prebuilt variables:
+
+$OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
+$OS2::nsyserror
+
+=item Misfeatures
+
+=item Modifications
+
+C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
+C<flock>
+
+=item Identifying DLLs
+
+=item Centralized management of resources
+
+C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
+C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
+C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
+C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
+
+=back
+
+=item Perl flavors
+
+=over 4
+
+=item F<perl.exe>
+
+=item F<perl_.exe>
+
+=item F<perl__.exe>
+
+=item F<perl___.exe>
+
+=item Why strange names?
+
+=item Why dynamic linking?
+
+=item Why chimera build?
+
+=back
+
+=item ENVIRONMENT
+
+=over 4
+
+=item C<PERLLIB_PREFIX>
+
+=item C<PERL_BADLANG>
+
+=item C<PERL_BADFREE>
+
+=item C<PERL_SH_DIR>
+
+=item C<USE_PERL_FLOCK>
+
+=item C<TMP> or C<TEMP>
+
+=back
+
+=item Evolution
+
+=over 4
+
+=item Text-mode filehandles
+
+=item Priorities
+
+=item DLL name mangling: pre 5.6.2
+
+=item DLL name mangling: 5.6.2 and beyond
+
+Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
+C<LIBPATH>
+
+=item DLL forwarder generation
+
+=item Threading
+
+=item Calls to external programs
+
+=item Memory allocation
+
+=item Threads
+
+C<COND_WAIT>, F<os2.c>
+
+=back
+
+=item BUGS
+
+=back
+
+=over 4
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
+=head2 perlos390, README.os390 - building and installing Perl for OS/390
+and z/OS
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Tools
+
+=item Unpacking Perl distribution on OS/390
+
+=item Setup and utilities for Perl on OS/390
+
+=item Configure Perl on OS/390
+
+=item Build, Test, Install Perl on OS/390
+
+=item Build Anomalies with Perl on OS/390
+
+=item Testing Anomalies with Perl on OS/390
+
+=item Installation Anomalies with Perl on OS/390
 
-=item Optional Y2K warnings
+=item Usage Hints for Perl on OS/390
 
-=item Arrays now always interpolate into double-quoted strings
+=item Floating Point Anomalies with Perl on OS/390
+
+=item Modules and Extensions for Perl on OS/390
 
 =back
 
-=item Modules and Pragmata
+=item AUTHORS
+
+=item SEE ALSO
 
 =over 4
 
-=item Modules
+=item Mailing list for Perl on OS/390
 
-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
+=back
 
-=item Pragmata
+=item HISTORY
 
 =back
 
-=item Utility Changes
+=head2 perlos400, README.os400 - Perl version 5 on OS/400
 
 =over 4
 
-=item dprofpp
+=item DESCRIPTION
 
-=item find2perl
+=over 4
 
-=item h2xs
+=item Compiling Perl for OS/400 PASE
 
-=item perlcc
+=item Installing Perl in OS/400 PASE
 
-=item perldoc
+=item Using Perl in OS/400 PASE
 
-=item The Perl Debugger
+=item Known Problems
+
+=item Perl on ILE
 
 =back
 
-=item Improved Documentation
+=item AUTHORS
 
-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
+=back
 
-=item Performance enhancements
+=head2 perlplan9 - Plan 9-specific documentation for Perl
 
 =over 4
 
-=item Simple sort() using { $a <=> $b } and the like are optimized
+=item DESCRIPTION
 
-=item Optimized assignments to lexical variables
+=over 4
 
-=item Faster subroutine calls
+=item Invoking Perl
 
-=item delete(), each(), values() and hash iteration are faster
+=item What's in Plan 9 Perl
+
+=item What's not in Plan 9 Perl
+
+=item Perl5 Functions not currently supported in Plan 9 Perl
+
+=item Signals in Plan 9 Perl
 
 =back
 
-=item Installation and Configuration Improvements
+=item COMPILING AND INSTALLING PERL ON PLAN 9
 
 =over 4
 
-=item -Dusethreads means something different
+=item Installing Perl Documentation on Plan 9
 
-=item New Configure flags
+=back
 
-=item Threadedness and 64-bitness now more daring
+=item BUGS
 
-=item Long Doubles
+=item Revision date
 
-=item -Dusemorebits
+=item AUTHOR
 
-=item -Duselargefiles
+=back
 
-=item installusrbinperl
+=head2 perlqnx, README.qnx - Perl version 5 on QNX
 
-=item SOCKS support
+=over 4
 
-=item C<-A> flag
+=item DESCRIPTION
 
-=item Enhanced Installation Directories
+=over 4
 
-=item gcc automatically tried if 'cc' does not seem to be working
+=item Required Software for Compiling Perl on QNX4
+
+/bin/sh, ar, nm, cpp, make
+
+=item Outstanding Issues with Perl on QNX4
+
+=item QNX auxiliary files
+
+qnx/ar, qnx/cpp
+
+=item Outstanding issues with perl under QNX6
 
 =back
 
-=item Platform specific changes
+=item AUTHOR
+
+=back
+
+=head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
 
 =over 4
 
-=item Supported platforms
+=item DESCRIPTION
 
-=item DOS
+=over 4
 
-=item OS390 (OpenEdition MVS)
+=item Solaris Version Numbers.
 
-=item VMS
+=back
 
-=item Win32
+=item RESOURCES
+
+Solaris FAQ, Precompiled Binaries, Solaris Documentation
+
+=item SETTING UP
+
+=over 4
+
+=item File Extraction Problems on Solaris.
+
+=item Compiler and Related Tools on Solaris.
+
+=item Environment for Compiling perl on Solaris
 
 =back
 
-=item Significant bug fixes
+=item RUN CONFIGURE.
 
 =over 4
 
-=item <HANDLE> on empty files
+=item 64-bit perl on Solaris.
 
-=item C<eval '...'> improvements
+=item Threads in perl on Solaris.
 
-=item All compilation errors are true errors
+=item Malloc Issues with perl on Solaris.
 
-=item Implicitly closed filehandles are safer
+=back
 
-=item Behavior of list slices is more consistent
+=item MAKE PROBLEMS.
 
-=item C<(\$)> prototype and C<$foo{a}>
+Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
+relocation error:, dlopen: stub interception failed, #error "No
+DATAMODEL_NATIVE specified", sh: ar: not found
 
-=item C<goto &sub> and AUTOLOAD
+=item MAKE TEST
 
-=item C<-bareword> allowed under C<use integer>
+=over 4
 
-=item Failures in DESTROY()
+=item op/stat.t test 4 in Solaris
 
-=item Locale bugs fixed
+=item nss_delete core dump from op/pwent or op/grent
 
-=item Memory leaks
+=back
 
-=item Spurious subroutine stubs after failed subroutine calls
+=item PREBUILT BINARIES OF PERL FOR SOLARIS.
 
-=item Taint failures under C<-U>
+=item RUNTIME ISSUES FOR PERL ON SOLARIS.
 
-=item END blocks and the C<-c> switch
+=over 4
 
-=item Potential to leak DATA filehandles
+=item Limits on Numbers of Open Files on Solaris.
 
 =back
 
-=item New or Changed Diagnostics
+=item SOLARIS-SPECIFIC MODULES.
 
-"%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 SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
 
-=item New tests
+=over 4
 
-=item Incompatible Changes
+=item Proc::ProcessTable on Solaris
+
+=item BSD::Resource on Solaris
+
+=item Net::SSLeay on Solaris
+
+=back
+
+=item SunOS 4.x
+
+=item AUTHOR
+
+=item LAST MODIFIED
+
+=back
+
+=head2 perlsymbian, README.symbian - Perl version 5 on Symbian OS
 
 =over 4
 
-=item Perl Source Incompatibilities
+=item DESCRIPTION
 
-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
+=over 4
 
-=item C Source Incompatibilities
+=item Compiling Perl on Symbian
 
-C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
+=item Compilation problems
 
-=item Compatible C Source API Changes
+=item PerlApp
 
-C<PATCHLEVEL> is now C<PERL_VERSION>
+=item Using Perl in Symbian
 
-=item Binary Incompatibilities
+=back
+
+=item TO DO
+
+=item WARNING
+
+=item NOTE
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=item LICENSE
+
+=item HISTORY
 
 =back
 
-=item Known Problems
+=head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
+Digital UNIX formerly known as DEC OSF/1) systems
 
 =over 4
 
-=item Localizing a tied hash element may leak memory
+=item DESCRIPTION
 
-=item Known test failures
+=over 4
 
-=item EBCDIC platforms not fully supported
+=item Compiling Perl 5 on Tru64
 
-=item UNICOS/mk CC failures during Configure run
+=item Using Large Files with Perl on Tru64
 
-=item Arrow operator and arrays
+=item Threaded Perl on Tru64
 
-=item Experimental features
+=item Long Doubles on Tru64
 
-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 DB_File tests failing on Tru64
+
+=item 64-bit Perl on Tru64
+
+=item Warnings about floating-point overflow when compiling Perl on Tru64
 
 =back
 
-=item Obsolete Diagnostics
+=item Testing Perl on Tru64
 
-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 ext/ODBM_File/odbm Test Failing With Static Builds
 
-=item Reporting Bugs
+=item Perl Fails Because Of Unresolved Symbol sockatmark
 
-=item SEE ALSO
+=item AUTHOR
 
-=item HISTORY
+=back
+
+=head2 perluts - Perl under UTS
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item BUILDING PERL ON UTS
+
+=item Installing the built perl on UTS
+
+=item AUTHOR
 
 =back
 
-=head2 perl56delta - what's new for perl v5.6.0
+=head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Unpacking Perl Distribution on VM/ESA
+
+=item Setup Perl and utilities on VM/ESA
 
-=over 4
+=item Configure Perl on VM/ESA
 
-=item DESCRIPTION
+=item Testing Anomalies of Perl on VM/ESA
 
-=item Core Enhancements
+=item Usage Hints for Perl on VM/ESA
 
-=over 4
+=back
 
-=item Interpreter cloning, threads, and concurrency
+=item AUTHORS
 
-=item Lexically scoped warning categories
+=item SEE ALSO
 
-=item Unicode and UTF-8 support
+=over 4
 
-=item Support for interpolating named characters
+=item Mailing list for Perl on VM/ESA
 
-=item "our" declarations
+=back
 
-=item Support for strings represented as a vector of ordinals
+=back
 
-=item Improved Perl version numbering system
+=head2 perlvms - VMS-specific documentation for Perl
 
-=item New syntax for declaring subroutine attributes
+=over 4
 
-=item File and directory handles can be autovivified
+=item DESCRIPTION
 
-=item open() with more than two arguments
+=item Installation
 
-=item 64-bit support
+=item Organization of Perl Images
 
-=item Large file support
+=over 4
 
-=item Long doubles
+=item Core Images
 
-=item "more bits"
+=item Perl Extensions
 
-=item Enhanced support for sort() subroutines
+=item Installing static extensions
 
-=item C<sort $coderef @foo> allowed
+=item Installing dynamic extensions
 
-=item File globbing implemented internally
+=back
 
-=item Support for CHECK blocks
+=item File specifications
 
-=item POSIX character class syntax [: :] supported
+=over 4
 
-=item Better pseudo-random number generator
+=item Syntax
 
-=item Improved C<qw//> operator
+=item Wildcard expansion
 
-=item Better worst-case behavior of hashes
+=item Pipes
 
-=item pack() format 'Z' supported
+=back
 
-=item pack() format modifier '!' supported
+=item PERL5LIB and PERLLIB
 
-=item pack() and unpack() support counted strings
+=item Command line
 
-=item Comments in pack() templates
+=over 4
 
-=item Weak references
+=item I/O redirection and backgrounding
 
-=item Binary numbers supported
+=item Command line switches
 
-=item Lvalue subroutines
+-i, -S, -u
 
-=item Some arrows may be omitted in calls through references
+=back
 
-=item Boolean assignment operators are legal lvalues
+=item Perl functions
 
-=item exists() is supported on subroutine names
+File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
+exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
+(system call), stat EXPR, system LIST, time, times, unlink LIST, utime
+LIST, waitpid PID,FLAGS
 
-=item exists() and delete() are supported on array elements
+=item Perl variables
 
-=item Pseudo-hashes work better
+%ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
 
-=item Automatic flushing of output buffers
+=item Standard modules with VMS-specific differences
 
-=item Better diagnostics on meaningless filehandle operations
+=over 4
 
-=item Where possible, buffered data discarded from duped input filehandle
+=item SDBM_File
 
-=item eof() has the same old magic as <>
+=back
 
-=item binmode() can be used to set :crlf and :raw modes
+=item Revision date
 
-=item C<-T> filetest recognizes UTF-8 encoded files as "text"
+=item AUTHOR
 
-=item system(), backticks and pipe open now reflect exec() failure
+=back
 
-=item Improved diagnostics
+=head2 perlvos, README.vos - Perl for Stratus VOS
 
-=item Diagnostics follow STDERR
+=over 4
 
-=item More consistent close-on-exec behavior
+=item SYNOPSIS
 
-=item syswrite() ease-of-use
+=item BUILDING PERL FOR VOS
 
-=item Better syntax checks on parenthesized unary operators
+=item INSTALLING PERL IN VOS
 
-=item Bit operators support full native integer width
+=item USING PERL IN VOS
 
-=item Improved security features
+=over 4
 
-=item More functional bareword prototype (*)
+=item Restrictions of Perl on VOS
 
-=item C<require> and C<do> may be overridden
+=item Handling of underflow and overflow
 
-=item $^X variables may now have names longer than one character
+=back
 
-=item New variable $^C reflects C<-c> switch
+=item TEST STATUS
 
-=item New variable $^V contains Perl version as a string
+=item SUPPORT STATUS
 
-=item Optional Y2K warnings
+=item AUTHOR
 
-=item Arrays now always interpolate into double-quoted strings
+=item LAST UPDATE
 
 =back
 
-=item Modules and Pragmata
+=head2 perlwin32 - Perl under Windows
 
 =over 4
 
-=item Modules
+=item SYNOPSIS
 
-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 DESCRIPTION
 
-=item Pragmata
+=over 4
 
-=back
+=item Setting Up Perl on Win32
 
-=item Utility Changes
+Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Visual
+C++ Toolkit 2003, Microsoft Platform SDK 64-bit Compiler, MinGW release 3
+with gcc, MinGW release 1 with gcc
 
-=over 4
+=item Building
 
-=item dprofpp
+=item Testing Perl on Win32
 
-=item find2perl
+=item Installation of Perl on Win32
 
-=item h2xs
+=item Usage Hints for Perl on Win32
 
-=item perlcc
+Environment Variables, File Globbing, Using perl from the command line,
+Building Extensions, Command-line Wildcard Expansion, Win32 Specific
+Extensions, Notes on 64-bit Windows
 
-=item perldoc
+=item Running Perl Scripts
 
-=item The Perl Debugger
+=item Miscellaneous Things
 
 =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
+=item BUGS AND CAVEATS
 
-=over 4
+=item ACKNOWLEDGEMENTS
 
-=item Simple sort() using { $a <=> $b } and the like are optimized
+=item AUTHORS
 
-=item Optimized assignments to lexical variables
+Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
+E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
+E<lt>nick@ing-simmons.netE<gt>, Jan Dubois E<lt>jand@activestate.comE<gt>,
+Steve Hay E<lt>steve.hay@uk.radan.comE<gt>
 
-=item Faster subroutine calls
+=item SEE ALSO
 
-=item delete(), each(), values() and hash iteration are faster
+=item HISTORY
 
 =back
 
-=item Installation and Configuration Improvements
-
-=over 4
+=head1 PRAGMA DOCUMENTATION
 
-=item -Dusethreads means something different
+=head2 attrs - set/get attributes of a subroutine (deprecated)
 
-=item New Configure flags
+=over 4
 
-=item Threadedness and 64-bitness now more daring
+=item SYNOPSIS
 
-=item Long Doubles
+=item DESCRIPTION
 
-=item -Dusemorebits
+method, locked
 
-=item -Duselargefiles
+=back
 
-=item installusrbinperl
+=head2 re - Perl pragma to alter regular expression behaviour
 
-=item SOCKS support
+=over 4
 
-=item C<-A> flag
+=item SYNOPSIS
 
-=item Enhanced Installation Directories
+=item DESCRIPTION
 
 =back
 
-=item Platform specific changes
+=head2 threadshared::shared, threads::shared - Perl extension for sharing
+data structures between threads
 
 =over 4
 
-=item Supported platforms
-
-=item DOS
+=item SYNOPSIS
 
-=item OS390 (OpenEdition MVS)
+=item DESCRIPTION
 
-=item VMS
+=item EXPORT
 
-=item Win32
+=item FUNCTIONS
 
-=back
+share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
+LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
+ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
 
-=item Significant bug fixes
+=item NOTES
 
-=over 4
+=item BUGS
 
-=item <HANDLE> on empty files
+=item AUTHOR
 
-=item C<eval '...'> improvements
+=item SEE ALSO
 
-=item All compilation errors are true errors
+=back
 
-=item Implicitly closed filehandles are safer
+=head2 threads - Perl extension allowing use of interpreter based threads
+from perl
 
-=item Behavior of list slices is more consistent
+=over 4
 
-=item C<(\$)> prototype and C<$foo{a}>
+=item SYNOPSIS
 
-=item C<goto &sub> and AUTOLOAD
+=item DESCRIPTION
 
-=item C<-bareword> allowed under C<use integer>
+$thread = threads->create(function, LIST), $thread->join, $thread->detach,
+threads->self, $thread->tid, threads->object( tid ), threads->yield();,
+threads->list();, async BLOCK;
 
-=item Failures in DESTROY()
+=item WARNINGS
 
-=item Locale bugs fixed
+A thread exited while %d other threads were still running
 
-=item Memory leaks
+=item TODO
 
-=item Spurious subroutine stubs after failed subroutine calls
+=item BUGS
 
-=item Taint failures under C<-U>
+Parent-Child threads, Returning objects, Creating threads inside BEGIN
+blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
 
-=item END blocks and the C<-c> switch
+=item AUTHOR and COPYRIGHT
 
-=item Potential to leak DATA filehandles
+=item SEE ALSO
 
 =back
 
-=item New or Changed Diagnostics
+=head2 assertions - select assertions in blocks of code
 
-"%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
+=over 4
 
-=item New tests
+=item SYNOPSIS
 
-=item Incompatible Changes
+=item DESCRIPTION
 
 =over 4
 
-=item Perl Source Incompatibilities
+=item Selecting assertions
 
-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 Handling assertions your own way
 
-=item C Source Incompatibilities
+enabled($on), enabled(), seen($on), seen()
 
-C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
+=back
 
-=item Compatible C Source API Changes
+=item COMPATIBILITY
 
-C<PATCHLEVEL> is now C<PERL_VERSION>
+=item SEE ALSO
 
-=item Binary Incompatibilities
+=item AUTHOR
+
+=item COPYRIGHT AND LICENSE
 
 =back
 
-=item Known Problems
+=head2 assertions::activate - activate assertions
 
 =over 4
 
-=item Thread test failures
+=item SYNOPSIS
 
-=item EBCDIC platforms not supported
+=item DESCRIPTION
 
-=item In 64-bit HP-UX the lib/io_multihomed test may hang
+=item SEE ALSO
 
-=item NEXTSTEP 3.3 POSIX test failure
+=item AUTHOR
 
-=item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
-gcc
+=item COPYRIGHT AND LICENSE
 
-=item UNICOS/mk CC failures during Configure run
+=back
 
-=item Arrow operator and arrays
+=head2 assertions::compat - assertions for pre-5.9 versions of perl
 
-=item Experimental features
+=over 4
 
-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 SYNOPSIS
 
-=back
+=item DESCRIPTION
 
-=item Obsolete Diagnostics
+=over 4
 
-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 The C<assertion> attribute handler
 
-=item Reporting Bugs
+=item Assertion execution status as a constant
+
+=back
 
 =item SEE ALSO
 
-=item HISTORY
+=item AUTHOR
+
+=item COPYRIGHT AND LICENSE
 
 =back
 
-=head2 perl5005delta - what's new for perl5.005
+=head2 attributes - get/set subroutine or variable attributes
 
 =over 4
 
-=item DESCRIPTION
-
-=item About the new versioning system
+=item SYNOPSIS
 
-=item Incompatible Changes
+=item DESCRIPTION
 
 =over 4
 
-=item WARNING: This version is not binary compatible with Perl 5.004.
-
-=item Default installation structure has changed
+=item Built-in Attributes
 
-=item Perl Source Compatibility
+locked, method, lvalue
 
-=item C Source Compatibility
+=item Available Subroutines
 
-=item Binary Compatibility
+get, reftype
 
-=item Security fixes may affect compatibility
+=item Package-specific Attribute Handling
 
-=item Relaxed new mandatory warnings introduced in 5.004
+FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
 
-=item Licensing
+=item Syntax of Attribute Lists
 
 =back
 
-=item Core Changes
+=item EXPORTS
 
 =over 4
 
-=item Threads
+=item Default exports
 
-=item Compiler
+=item Available exports
 
-=item Regular Expressions
+=item Export tags defined
 
-Many new and improved optimizations, Many bug fixes, New regular expression
-constructs, New operator for precompiled regular expressions, Other
-improvements, Incompatible changes
+=back
 
-=item  Improved malloc()
+=item EXAMPLES
 
-=item Quicksort is internally implemented
+=item SEE ALSO
 
-=item Reliable signals
+=back
 
-=item Reliable stack pointers
+=head2 autouse - postpone load of modules until a function is used
 
-=item More generous treatment of carriage returns
+=over 4
 
-=item Memory leaks
+=item SYNOPSIS
 
-=item Better support for multiple interpreters
+=item DESCRIPTION
 
-=item Behavior of local() on array and hash elements is now well-defined
+=item WARNING
 
-=item C<%!> is transparently tied to the L<Errno> module
+=item AUTHOR
 
-=item Pseudo-hashes are supported
+=item SEE ALSO
 
-=item C<EXPR foreach EXPR> is supported
+=back
 
-=item Keywords can be globally overridden
+=head2 base - Establish IS-A relationship with base classes at compile time
 
-=item C<$^E> is meaningful on Win32
+=over 4
 
-=item C<foreach (1..1000000)> optimized
+=item SYNOPSIS
 
-=item C<Foo::> can be used as implicitly quoted package name
+=item DESCRIPTION
 
-=item C<exists $Foo::{Bar::}> tests existence of a package
+=item DIAGNOSTICS
 
-=item Better locale support
+Base class package "%s" is empty
 
-=item Experimental support for 64-bit platforms
+=item HISTORY
 
-=item prototype() returns useful results on builtins
+=item CAVEATS
 
-=item Extended support for exception handling
+=item SEE ALSO
 
-=item Re-blessing in DESTROY() supported for chaining DESTROY() methods
+=back
 
-=item All C<printf> format conversions are handled internally
+=head2 bigint - Transparent BigInteger support for Perl
 
-=item New C<INIT> keyword
+=over 4
 
-=item New C<lock> keyword
+=item SYNOPSIS
 
-=item New C<qr//> operator
+=item DESCRIPTION
 
-=item C<our> is now a reserved word
+=over 4
 
-=item Tied arrays are now fully supported
+=item Options
 
-=item Tied handles support is better
+a or accuracy, p or precision, t or trace, l or lib, v or version
 
-=item 4th argument to substr
+=item Math Library
 
-=item Negative LENGTH argument to splice
+=item Internal Format
 
-=item Magic lvalues are now more magical
+=item Sign
 
-=item <> now reads in records
+=item Methods
+
+=item Caveat
 
 =back
 
-=item Supported Platforms
+=item MODULES USED
 
-=over 4
+=item EXAMPLES
 
-=item New Platforms
+=item LICENSE
 
-=item Changes in existing support
+=item SEE ALSO
+
+=item AUTHORS
 
 =back
 
-=item Modules and Pragmata
+=head2 bignum - Transparent BigNumber support for Perl
 
 =over 4
 
-=item New Modules
+=item SYNOPSIS
 
-B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
-ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
-Thread, attrs, fields, re
+=item DESCRIPTION
 
-=item Changes in existing modules
+=over 4
 
-Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
-MakeMaker, CPAN, Cwd
+=item Options
 
-=back
+a or accuracy, p or precision, t or trace, l or lib, v or version
 
-=item Utility Changes
+=item Methods
 
-=item Documentation Changes
+=item Caveat
 
-=item New Diagnostics
+inf(), NaN(), upgrade()
 
-Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
-while coercing array into hash, Bareword "%s" refers to nonexistent
-package, Can't call method "%s" on an undefined value, Can't check
-filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
-goto subroutine from an eval-string, Can't localize pseudo-hash element,
-Can't use %%! because Errno.pm is not available, Cannot find an opnumber
-for "%s", Character class syntax [. .] is reserved for future extensions,
-Character class syntax [: :] is reserved for future extensions, Character
-class syntax [= =] is reserved for future extensions, %s: Eval-group in
-insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
-Eval-group not allowed at run time, Explicit blessing to '' (assuming
-package main), Illegal hex digit ignored, No such array field, No such
-field "%s" in variable %s of type %s, Out of memory during ridiculously
-large request, Range iterator outside integer range, Recursive inheritance
-detected while looking for method '%s' %s, Reference found where even-sized
-list expected, Undefined value assigned to typeglob, Use of reserved word
-"%s" is deprecated, perl: warning: Setting locale failed
+=item MATH LIBRARY
 
-=item Obsolete Diagnostics
+=item INTERNAL FORMAT
 
-Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
-temporary file, regexp too big
+=item SIGN
 
-=item Configuration Changes
+=back
 
-=item BUGS
+=item MODULES USED
+
+=item EXAMPLES
+
+=item LICENSE
 
 =item SEE ALSO
 
-=item HISTORY
+=item AUTHORS
 
 =back
 
-=head2 perl5004delta - what's new for perl5.004
+=head2 bigrat - Transparent BigNumber/BigRational support for Perl
 
 =over 4
 
+=item SYNOPSIS
+
 =item DESCRIPTION
 
-=item Supported Environments
+=over 4
 
-=item Core Changes
+=item Modules Used
 
-=over 4
+=item Math Library
 
-=item List assignment to %ENV works
+=item Sign
 
-=item Change to "Can't locate Foo.pm in @INC" error
+=item Methods
 
-=item Compilation option: Binary compatibility with 5.003
+=item Cavaet
 
-=item $PERL5OPT environment variable
+=item Options
 
-=item Limitations on B<-M>, B<-m>, and B<-T> options
+a or accuracy, p or precision, t or trace, l or lib, v or version
 
-=item More precise warnings
+=back
 
-=item Deprecated: Inherited C<AUTOLOAD> for non-methods
+=item EXAMPLES
 
-=item Previously deprecated %OVERLOAD is no longer usable
+       perl -Mbigrat -le 'print sqrt(33)'
+       perl -Mbigrat -le 'print 2*255'
+       perl -Mbigrat -le 'print 4.5+2*255'
+       perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'       
+       perl -Mbigrat -le 'print 12->is_odd()';
 
-=item Subroutine arguments created only when they're modified
+=item LICENSE
 
-=item Group vector changeable with C<$)>
+=item SEE ALSO
 
-=item Fixed parsing of $$<digit>, &$<digit>, etc.
+=item AUTHORS
 
-=item Fixed localization of $<digit>, $&, etc.
+=back
 
-=item No resetting of $. on implicit close
+=head2 blib - Use MakeMaker's uninstalled version of a package
 
-=item C<wantarray> may return undef
+=over 4
 
-=item C<eval EXPR> determines value of EXPR in scalar context
+=item SYNOPSIS
 
-=item Changes to tainting checks
+=item DESCRIPTION
 
-No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
-spawning if tainted $TERM doesn't look like a terminal name
+=item BUGS
 
-=item New Opcode module and revised Safe module
+=item AUTHOR
 
-=item Embedding improvements
+=back
 
-=item Internal change: FileHandle class based on IO::* classes
+=head2 bytes - Perl pragma to force byte semantics rather than character
+semantics
 
-=item Internal change: PerlIO abstraction interface
+=over 4
 
-=item New and changed syntax
+=item SYNOPSIS
 
-$coderef->(PARAMS)
+=item DESCRIPTION
 
-=item New and changed builtin constants
+=item LIMITATIONS
 
-__PACKAGE__
+=item SEE ALSO
 
-=item New and changed builtin variables
+=back
 
-$^E, $^H, $^M
+=head2 charnames - define character names for C<\N{named}> string literal
+escapes
 
-=item New and changed builtin functions
+=over 4
 
-delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
-Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
-VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
-reset search position on failure, C<m//x> ignores whitespace before ?*+{},
-nested C<sub{}> closures work now, formats work right on changing lexicals
+=item SYNOPSIS
 
-=item New builtin methods
+=item DESCRIPTION
 
-isa(CLASS), can(METHOD), VERSION( [NEED] )
+=item CUSTOM TRANSLATORS
 
-=item TIEHANDLE now supported
+=item CUSTOM ALIASES
 
-TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
-LIST, READLINE this, GETC this, DESTROY this
+=over 4
 
-=item Malloc enhancements
+=item Anonymous hashes
 
--DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
+=item Alias file
 
-=item Miscellaneous efficiency enhancements
+=item Alias shortcut
 
 =back
 
-=item Support for More Operating Systems
-
-=over 4
+=item charnames::viacode(code)
 
-=item Win32
+=item charnames::vianame(name)
 
-=item Plan 9
+=item ALIASES
 
-=item QNX
+=item ILLEGAL CHARACTERS
 
-=item AmigaOS
+=item BUGS
 
 =back
 
-=item Pragmata
+=head2 constant - Perl pragma to declare constants
 
-use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
-constant NAME => VALUE, use locale, use ops, use vmsish
+=over 4
 
-=item Modules
+=item SYNOPSIS
 
-=over 4
+=item DESCRIPTION
 
-=item Required Updates
+=item NOTES
 
-=item Installation directories
+=over 4
 
-=item Module information summary
+=item List constants
 
-=item Fcntl
+=item Defining multiple constants at once
 
-=item IO
+=item Magic constants
 
-=item Math::Complex
+=back
 
-=item Math::Trig
+=item TECHNICAL NOTES
 
-=item DB_File
+=item BUGS
 
-=item Net::Ping
+=item AUTHOR
 
-=item Object-oriented overrides for builtin operators
+=item COPYRIGHT
 
 =back
 
-=item Utility Changes
+=head2 diagnostics, splain - produce verbose warning diagnostics
 
 =over 4
 
-=item pod2html
-
-Sends converted HTML to standard output
-
-=item xsubpp
-
-C<void> XSUBs now default to returning nothing
+=item SYNOPSIS
 
-=back
+=item DESCRIPTION
 
-=item C Language API Changes
+=over 4
 
-C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
-manipulating hashes
+=item The C<diagnostics> Pragma
 
-=item Documentation Changes
+=item The I<splain> Program
 
-L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
-L<perlmodlib>, L<perldebug>, L<perlsec>
+=back
 
-=item New Diagnostics
+=item EXAMPLES
 
-"my" variable %s masks earlier declaration in same scope, %s argument is
-not a HASH element or slice, Allocation too large: %lx, Allocation too
-large, Applying %s to %s will act on scalar(%s), Attempt to free
-nonexistent shared string, Attempt to use reference as lvalue in substr,
-Bareword "%s" refers to nonexistent package, Can't redefine active sort
-subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
-use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
-subroutine %s redefined, Constant subroutine %s undefined, Copy method did
-not return a reference, Died, Exiting pseudo-block via %s, Identifier too
-long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
-%s, Integer overflow in hex number, Integer overflow in octal number,
-internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
-in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
-possible typo, Null picture in formline, Offset outside string, Out of
-memory!, Out of memory during request for %s, panic: frexp, Possible
-attempt to put comments in qw() list, Possible attempt to separate words
-with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
-while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
-option, untie attempted while %d inner references still exist, Unrecognized
-character %s, Unsupported function fork, Use of "$$<digit>" to mean
-"${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
-Variable "%s" may be unavailable, Variable "%s" will not stay shared,
-Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
-Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
-long, Process terminated by SIG%s
+=item INTERNALS
 
 =item BUGS
 
-=item SEE ALSO
-
-=item HISTORY
+=item AUTHOR
 
 =back
 
-=head2 perlartistic - the Perl Artistic License
+=head2 encoding - allows you to write your script in non-ascii or non-utf8
 
 =over 4
 
 =item SYNOPSIS
 
-=item DESCRIPTION
-
-=item The "Artistic License"
+=item ABSTRACT
 
 =over 4
 
-=item Preamble
+=item Literal Conversions
 
-=item Definitions
+=item PerlIO layers for C<STD(IN|OUT)>
 
-"Package", "Standard Version", "Copyright Holder", "You", "Reasonable
-copying fee", "Freely Available"
+=item Implicit upgrading for byte strings
 
-=item Conditions
+=back
 
-a), b), c), d), a), b), c), d)
+=item FEATURES THAT REQUIRE 5.8.1
 
-=back
+"NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
 
-=back
+=item USAGE
 
-=head2 perlgpl - the GNU General Public License, version 2
+use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
+I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
+
+=item The Filter Option
 
 =over 4
 
-=item SYNOPSIS
+=item Filter-related changes at Encode version 1.87
 
 =back
 
+=item CAVEATS
+
 =over 4
 
-=item DESCRIPTION
+=item NOT SCOPED
 
-=item GNU GENERAL PUBLIC LICENSE
+=item DO NOT MIX MULTIPLE ENCODINGS
+
+=item tr/// with ranges
+
+Legend of characters above
 
 =back
 
-=head1 PRAGMA DOCUMENTATION
+=item EXAMPLE - Greekperl
 
-=head2 attrs - set/get attributes of a subroutine (deprecated)
+=item KNOWN PROBLEMS
+
+literals in regex that are longer than 127 bytes, EBCDIC, format
 
 =over 4
 
-=item SYNOPSIS
+=item The Logic of :locale
 
-=item DESCRIPTION
+=back
 
-method, locked
+=item HISTORY
+
+=item SEE ALSO
 
 =back
 
-=head2 re - Perl pragma to alter regular expression behaviour
+=head2 encoding::warnings - Warn on implicit encoding conversions
 
 =over 4
 
+=item VERSION
+
 =item SYNOPSIS
 
 =item DESCRIPTION
 
-=back
-
-=head2 threadshared::shared, threads::shared - Perl extension for sharing
-data structures between threads
-
 =over 4
 
-=item SYNOPSIS
+=item Overview of the problem
 
-=item DESCRIPTION
+=item Detecting the problem
 
-=item EXPORT
+=item Solving the problem
 
-=item FUNCTIONS
+Upgrade both sides to unicode-strings, Downgrade both sides to
+byte-strings, Specify the encoding for implicit byte-string upgrading,
+PerlIO layers for B<STDIN> and B<STDOUT>, Literal conversions, Implicit
+upgrading for byte-strings
 
-share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
-cond_broadcast VARIABLE
+=back
 
-=item NOTES
+=item CAVEATS
 
-=item BUGS
+=back
 
-=item AUTHOR
+=over 4
 
 =item SEE ALSO
 
+=item AUTHORS
+
+=item COPYRIGHT
+
 =back
 
-=head2 threads - Perl extension allowing use of interpreter based threads
-from perl
+=head2 fields - compile-time class fields
 
 =over 4
 
@@ -7536,28 +10138,29 @@ from perl
 
 =item DESCRIPTION
 
-$thread = threads->create(function, LIST), $thread->join, $thread->detach,
-threads->self, $thread->tid, threads->object( tid ), threads->yield();,
-threads->list();, async BLOCK;
+new, phash
 
-=item WARNINGS
+=item SEE ALSO
 
-A thread exited while %d other threads were still running
+=back
 
-=item TODO
+=head2 filetest - Perl pragma to control the filetest permission operators
 
-=item BUGS
+=over 4
 
-Parent-Child threads, Returning objects, Creating threads inside BEGIN
-blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
+=item SYNOPSIS
 
-=item AUTHOR and COPYRIGHT
+=item DESCRIPTION
 
-=item SEE ALSO
+=over 4
+
+=item subpragma access
 
 =back
 
-=head2 assertions - select assertions in blocks of code
+=back
+
+=head2 if - C<use> a Perl module if a condition holds
 
 =over 4
 
@@ -7565,15 +10168,14 @@ blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
 
 =item DESCRIPTION
 
-=item SEE ALSO
+=item BUGS
 
 =item AUTHOR
 
-=item COPYRIGHT AND LICENSE
-
 =back
 
-=head2 assertions::activate - activate assertions
+=head2 integer - Perl pragma to use integer arithmetic instead of floating
+point
 
 =over 4
 
@@ -7581,15 +10183,19 @@ blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
 
 =item DESCRIPTION
 
-=item SEE ALSO
+=back
+
+=head2 less - perl pragma to request less of something from the compiler
+
+=over 4
 
-=item AUTHOR
+=item SYNOPSIS
 
-=item COPYRIGHT AND LICENSE
+=item DESCRIPTION
 
 =back
 
-=head2 attributes - get/set subroutine or variable attributes
+=head2 lib - manipulate @INC at compile time
 
 =over 4
 
@@ -7599,41 +10205,36 @@ blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
 
 =over 4
 
-=item Built-in Attributes
+=item Adding directories to @INC
 
-locked, method, lvalue
+=item Deleting directories from @INC
 
-=item Available Subroutines
+=item Restoring original @INC
 
-get, reftype
+=back
 
-=item Package-specific Attribute Handling
+=item CAVEATS
 
-FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
+=item NOTES
 
-=item Syntax of Attribute Lists
+=item SEE ALSO
+
+=item AUTHOR
 
 =back
 
-=item EXPORTS
+=head2 locale - Perl pragma to use and avoid POSIX locales for built-in
+operations
 
 =over 4
 
-=item Default exports
-
-=item Available exports
-
-=item Export tags defined
-
-=back
-
-=item EXAMPLES
+=item SYNOPSIS
 
-=item SEE ALSO
+=item DESCRIPTION
 
 =back
 
-=head2 autouse - postpone load of modules until a function is used
+=head2 open - perl pragma to set default PerlIO layers for input and output
 
 =over 4
 
@@ -7641,31 +10242,27 @@ FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
 
 =item DESCRIPTION
 
-=item WARNING
+=item NONPERLIO FUNCTIONALITY
 
-=item AUTHOR
+=item IMPLEMENTATION DETAILS
 
 =item SEE ALSO
 
 =back
 
-=head2 base - Establish IS-A relationship with base class at compile time
+=head2 ops - Perl pragma to restrict unsafe operations when compiling
 
 =over 4
 
-=item SYNOPSIS
+=item SYNOPSIS 
 
 =item DESCRIPTION
 
-=item HISTORY
-
-=item CAVEATS
-
 =item SEE ALSO
 
 =back
 
-=head2 bigint - Transparent BigInteger support for Perl
+=head2 overload - Package for overloading perl operations
 
 =over 4
 
@@ -7675,75 +10272,96 @@ FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
 
 =over 4
 
-=item OPTIONS
+=item Declaration of overloaded functions
 
-a or accuracy, p or precision, t or trace, l or lib, v or version
+=item Calling Conventions for Binary Operations
 
-=item MATH LIBRARY
+FALSE, TRUE, C<undef>
 
-=item INTERNAL FORMAT
+=item Calling Conventions for Unary Operations
 
-=item SIGN
+=item Calling Conventions for Mutators
 
-=item METHODS
+C<++> and C<-->, C<x=> and other assignment versions
 
-=item CAVEAT
+=item Overloadable Operations
+
+I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
+I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
+and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
+
+=item Inheritance and overloading
+
+Strings as values of C<use overload> directive, Overloading of an operation
+is inherited by derived classes
 
 =back
 
-=item MODULES USED
+=item SPECIAL SYMBOLS FOR C<use overload>
 
-=item EXAMPLES
+=over 4
 
-=item LICENSE
+=item Last Resort
 
-=item SEE ALSO
+=item Fallback
 
-=item AUTHORS
+C<undef>, TRUE, defined, but FALSE
+
+=item Copy Constructor
+
+B<Example>
 
 =back
 
-=head2 bignum - Transparent BigNumber support for Perl
+=item MAGIC AUTOGENERATION
 
-=over 4
+I<Assignment forms of arithmetic operations>, I<Conversion operations>,
+I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
+I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
+I<Copy operator>
 
-=item SYNOPSIS
+=item Losing overloading
 
-=item DESCRIPTION
+=item Run-time Overloading
 
-=over 4
+=item Public functions
 
-=item OPTIONS
+overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
 
-a or accuracy, p or precision, t or trace, l or lib, v or version
+=item Overloading constants
 
-=item METHODS
+integer, float, binary, q, qr
 
-=item CAVEAT
+=item IMPLEMENTATION
 
-inf(), NaN(), upgrade()
+=item Metaphor clash
 
-=item MATH LIBRARY
+=item Cookbook
 
-=item INTERNAL FORMAT
+=over 4
 
-=item SIGN
+=item Two-face scalars
 
-=back
+=item Two-face references
 
-=item MODULES USED
+=item Symbolic calculator
 
-=item EXAMPLES
+=item I<Really> symbolic calculator
 
-=item LICENSE
+=back
 
-=item SEE ALSO
+=item AUTHOR
 
-=item AUTHORS
+=item DIAGNOSTICS
+
+Odd number of arguments for overload::constant, `%s' is not an overloadable
+type, `%s' is not a code reference
+
+=item BUGS
 
 =back
 
-=head2 bigrat - Transparent BigNumber/BigRational support for Perl
+=head2 sigtrap - Perl pragma to enable simple signal handling
 
 =over 4
 
@@ -7751,37 +10369,29 @@ inf(), NaN(), upgrade()
 
 =item DESCRIPTION
 
+=item OPTIONS
+
 =over 4
 
-=item MODULES USED
+=item SIGNAL HANDLERS
 
-=item MATH LIBRARY
+B<stack-trace>, B<die>, B<handler> I<your-handler>
 
-=item SIGN
+=item SIGNAL LISTS
 
-=item METHODS
+B<normal-signals>, B<error-signals>, B<old-interface-signals>
 
-=item CAVEAT
+=item OTHER
+
+B<untrapped>, B<any>, I<signal>, I<number>
 
 =back
 
 =item EXAMPLES
 
-       perl -Mbigrat -le 'print sqrt(33)'
-       perl -Mbigrat -le 'print 2*255'
-       perl -Mbigrat -le 'print 4.5+2*255'
-       perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'       
-       perl -Mbigrat -le 'print 12->is_odd()';
-
-=item LICENSE
-
-=item SEE ALSO
-
-=item AUTHORS
-
 =back
 
-=head2 blib - Use MakeMaker's uninstalled version of a package
+=head2 sort - perl pragma to control sort() behaviour
 
 =over 4
 
@@ -7789,14 +10399,11 @@ inf(), NaN(), upgrade()
 
 =item DESCRIPTION
 
-=item BUGS
-
-=item AUTHOR
+=item CAVEATS
 
 =back
 
-=head2 bytes - Perl pragma to force byte semantics rather than character
-semantics
+=head2 strict - Perl pragma to restrict unsafe constructs
 
 =over 4
 
@@ -7804,14 +10411,13 @@ semantics
 
 =item DESCRIPTION
 
-=item LIMITATIONS
+C<strict refs>, C<strict vars>, C<strict subs>
 
-=item SEE ALSO
+=item HISTORY
 
 =back
 
-=head2 charnames - define character names for C<\N{named}> string literal
-escapes
+=head2 subs - Perl pragma to predeclare sub names
 
 =over 4
 
@@ -7819,33 +10425,10 @@ escapes
 
 =item DESCRIPTION
 
-=item CUSTOM TRANSLATORS
-
-=item CUSTOM ALIASES
-
-=over 4
-
-=item Anonymous hashes
-
-=item Alias file
-
-=item Alias shortcut
-
-=back
-
-=item charnames::viacode(code)
-
-=item charnames::vianame(name)
-
-=item ALIASES
-
-=item ILLEGAL CHARACTERS
-
-=item BUGS
-
 =back
 
-=head2 constant - Perl pragma to declare constants
+=head2 threadshared, threads::shared - Perl extension for sharing data
+structures between threads
 
 =over 4
 
@@ -7853,30 +10436,26 @@ escapes
 
 =item DESCRIPTION
 
-=item NOTES
-
-=over 4
-
-=item List constants
-
-=item Defining multiple constants at once
+=item EXPORT
 
-=item Magic constants
+=item FUNCTIONS
 
-=back
+share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
+LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
+ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
 
-=item TECHNICAL NOTES
+=item NOTES
 
 =item BUGS
 
 =item AUTHOR
 
-=item COPYRIGHT
+=item SEE ALSO
 
 =back
 
-=head2 diagnostics - Perl compiler pragma to force verbose warning
-diagnostics
+=head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
+code
 
 =over 4
 
@@ -7886,23 +10465,21 @@ diagnostics
 
 =over 4
 
-=item The C<diagnostics> Pragma
+=item Utility functions
 
-=item The I<splain> Program
+$num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[,
+FAIL_OK]), utf8::encode($string), utf8::decode($string), $flag =
+utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
 
 =back
 
-=item EXAMPLES
-
-=item INTERNALS
-
 =item BUGS
 
-=item AUTHOR
+=item SEE ALSO
 
 =back
 
-=head2 fields - compile-time class fields
+=head2 vars - Perl pragma to predeclare global variable names (obsolete)
 
 =over 4
 
@@ -7910,13 +10487,9 @@ diagnostics
 
 =item DESCRIPTION
 
-new, phash
-
-=item SEE ALSO
-
 =back
 
-=head2 filetest - Perl pragma to control the filetest permission operators
+=head2 version - Perl extension for Version Objects
 
 =over 4
 
@@ -7926,28 +10499,42 @@ new, phash
 
 =over 4
 
-=item subpragma access
+=item What IS a version
 
-=back
+Numeric Versions, Quoted Versions
 
-=back
+=item What about v-strings?
 
-=head2 if - C<use> a Perl module if a condition holds
+=item Numeric Versions
 
-=over 4
+=item Quoted Versions
 
-=item SYNOPSIS
+=item Numeric Alpha Versions
 
-=item DESCRIPTION
+=item Object Methods
+
+New Operator, qv(), Normal Form, Numification, Stringification, Comparison
+operators, Logical Operators
+
+=item Quoting
+
+=item Types of Versions Objects
+
+Ordinary versions, Alpha Versions
+
+=item Replacement UNIVERSAL::VERSION
+
+=back
 
-=item BUGS
+=item EXPORT
 
 =item AUTHOR
 
+=item SEE ALSO
+
 =back
 
-=head2 integer - Perl pragma to use integer arithmetic instead of floating
-point
+=head2 vmsish - Perl pragma to control VMS-specific language features
 
 =over 4
 
@@ -7955,9 +10542,11 @@ point
 
 =item DESCRIPTION
 
+C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
+
 =back
 
-=head2 less - perl pragma to request less of something from the compiler
+=head2 warnings - Perl pragma to control optional warnings
 
 =over 4
 
@@ -7965,10 +10554,15 @@ point
 
 =item DESCRIPTION
 
+use warnings::register, warnings::enabled(), warnings::enabled($category),
+warnings::enabled($object), warnings::warn($message),
+warnings::warn($category, $message), warnings::warn($object, $message),
+warnings::warnif($message), warnings::warnif($category, $message),
+warnings::warnif($object, $message)
+
 =back
 
-=head2 locale - Perl pragma to use and avoid POSIX locales for built-in
-operations
+=head2 warnings::register - warnings import function
 
 =over 4
 
@@ -7978,7 +10572,9 @@ operations
 
 =back
 
-=head2 open - perl pragma to set default PerlIO layers for input and output
+=head1 MODULE DOCUMENTATION
+
+=head2 AnyDBM_File - provide framework for multiple DBMs
 
 =over 4
 
@@ -7986,15 +10582,19 @@ operations
 
 =item DESCRIPTION
 
-=item NONPERLIO FUNCTIONALITY
+=over 4
 
-=item IMPLEMENTATION DETAILS
+=item DBM Comparisons
+
+[0], [1], [2], [3]
+
+=back
 
 =item SEE ALSO
 
 =back
 
-=head2 overload - Package for overloading perl operations
+=head2 Archive::Tar - module for manipulations of tar archives
 
 =over 4
 
@@ -8002,199 +10602,197 @@ operations
 
 =item DESCRIPTION
 
-=over 4
+=item Object Methods
 
-=item Declaration of overloaded functions
+=over 4
 
-=item Calling Conventions for Binary Operations
+=item Archive::Tar->new( [$file, $compressed] )
 
-FALSE, TRUE, C<undef>
+=back
 
-=item Calling Conventions for Unary Operations
+=back
 
-=item Calling Conventions for Mutators
+=over 4
 
-C<++> and C<-->, C<x=> and other assignment versions
+=item $tar->read ( $filename|$handle, $compressed, {opt => 'val'} )
 
-=item Overloadable Operations
+limit, extract
 
-I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
-I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
-and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
+=back
 
-=item Inheritance and overloading
+=over 4
 
-Strings as values of C<use overload> directive, Overloading of an operation
-is inherited by derived classes
+=item $tar->contains_file( $filename )
 
 =back
 
-=item SPECIAL SYMBOLS FOR C<use overload>
-
 =over 4
 
-=item Last Resort
-
-=item Fallback
+=item $tar->extract( [@filenames] )
 
-C<undef>, TRUE, defined, but FALSE
+=back
 
-=item Copy Constructor
+=over 4
 
-B<Example>
+=item $tar->extract_file( $file, [$extract_path] )
 
 =back
 
-=item MAGIC AUTOGENERATION
+=over 4
 
-I<Assignment forms of arithmetic operations>, I<Conversion operations>,
-I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
-I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
-I<Copy operator>
+=item $tar->list_files( [\@properties] )
 
-=item Losing overloading
+=back
 
-=item Run-time Overloading
+=over 4
 
-=item Public functions
+=item $tar->get_files( [@filenames] )
 
-overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
+=back
 
-=item Overloading constants
+=over 4
 
-integer, float, binary, q, qr
+=item $tar->get_content( $file )
 
-=item IMPLEMENTATION
+=back
 
-=item Metaphor clash
+=over 4
 
-=item Cookbook
+=item $tar->replace_content( $file, $content )
+
+=back
 
 =over 4
 
-=item Two-face scalars
+=item $tar->rename( $file, $new_name )
 
-=item Two-face references
+=back
 
-=item Symbolic calculator
+=over 4
 
-=item I<Really> symbolic calculator
+=item $tar->remove (@filenamelist)
 
 =back
 
-=item AUTHOR
+=over 4
 
-=item DIAGNOSTICS
+=item $tar->clear
 
-Odd number of arguments for overload::constant, `%s' is not an overloadable
-type, `%s' is not a code reference
+=back
 
-=item BUGS
+=over 4
 
-=back
+=item $tar->write ( [$file, $compressed, $prefix] )
 
-=head2 sigtrap - Perl pragma to enable simple signal handling
+=back
 
 =over 4
 
-=item SYNOPSIS
-
-=item DESCRIPTION
+=item $tar->add_files( @filenamelist )
 
-=item OPTIONS
+=back
 
 =over 4
 
-=item SIGNAL HANDLERS
+=item $tar->add_data ( $filename, $data, [$opthashref] )
 
-B<stack-trace>, B<die>, B<handler> I<your-handler>
+=back
 
-=item SIGNAL LISTS
+=over 4
 
-B<normal-signals>, B<error-signals>, B<old-interface-signals>
+=item $tar->error( [$BOOL] )
 
-=item OTHER
+=back
 
-B<untrapped>, B<any>, I<signal>, I<number>
+=over 4
+
+=item $bool = $tar->has_io_string
 
 =back
 
-=item EXAMPLES
+=over 4
 
-=back
+=item $bool = $tar->has_perlio
 
-=head2 sort - perl pragma to control sort() behaviour
+=back
 
 =over 4
 
-=item SYNOPSIS
+=item Class Methods
 
-=item DESCRIPTION
+=over 4
 
-=item CAVEATS
+=item Archive::Tar->create_archive($file, $compression, @filelist)
 
 =back
 
-=head2 strict - Perl pragma to restrict unsafe constructs
+=back
 
 =over 4
 
-=item SYNOPSIS
+=item Archive::Tar->list_archive ($file, $compressed, [\@properties])
 
-=item DESCRIPTION
+=back
 
-C<strict refs>, C<strict vars>, C<strict subs>
+=over 4
 
-=item HISTORY
+=item Archive::Tar->extract_archive ($file, $gzip)
 
 =back
 
-=head2 subs - Perl pragma to predeclare sub names
-
 =over 4
 
-=item SYNOPSIS
-
-=item DESCRIPTION
+=item Archive::Tar->can_handle_compressed_files
 
 =back
 
-=head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
-code
+=over 4
+
+=item GLOBAL VARIABLES
 
 =over 4
 
-=item SYNOPSIS
+=item $Archive::Tar::FOLLOW_SYMLINK
 
-=item DESCRIPTION
+=item $Archive::Tar::CHOWN
 
-=over 4
+=item $Archive::Tar::CHMOD
 
-=item Utility functions
+=item $Archive::Tar::DO_NOT_USE_PREFIX
 
-$num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[,
-FAIL_OK]), utf8::encode($string), utf8::decode($string), $flag =
-utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
+=item $Archive::Tar::DEBUG
 
-=back
+=item $Archive::Tar::WARN
 
-=item BUGS
+=item $Archive::Tar::error
 
-=item SEE ALSO
+=item $Archive::Tar::HAS_PERLIO
+
+=item $Archive::Tar::HAS_IO_STRING
 
 =back
 
-=head2 vars - Perl pragma to predeclare global variable names (obsolete)
+=item FAQ
 
-=over 4
+What's the minimum perl version required to run Archive::Tar?, Isn't
+Archive::Tar slow?, Isn't Archive::Tar heavier on memory than /bin/tar?,
+Can't you lazy-load data instead?, How much memory will an X kb tar file
+need?, What do you do with unsupported filetypes in an archive?
 
-=item SYNOPSIS
+=item TODO
 
-=item DESCRIPTION
+Check if passed in handles are open for read/write
+
+=item AUTHOR
+
+=item ACKNOWLEDGEMENTS
+
+=item COPYRIGHT
 
 =back
 
-=head2 version - Perl extension for Version Objects
+=head2 Archive::Tar::File - a subclass for in-memory extracted file from
+Archive::Tar
 
 =over 4
 
@@ -8204,94 +10802,75 @@ utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
 
 =over 4
 
-=item What IS a version
-
-Numeric Versions, V-String Versions
-
-=item Numeric Versions
+=item Accessors
 
-=item V-String Versions
+name, mode, uid, gid, size, mtime, chksum, type, linkname, magic, version,
+uname, gname, devmajor, devminor, prefix, raw
 
-=item Object Methods
+=back
 
-New Operator, Stringification, Numification, Comparison operators, Logical
-Operators
+=item Methods
 
-=item Quoting
+=over 4
 
-=item Types of Versions Objects
+=item new( file => $path )
 
-Ordinary versions, alpha versions
+=item new( data => $path, $data, $opt )
 
-=item Replacement UNIVERSAL::VERSION
+=item new( chunk => $chunk )
 
 =back
 
-=item EXPORT
+=back
 
-=item AUTHOR
+=over 4
 
-=item SEE ALSO
+=item full_path
 
 =back
 
-=head2 vmsish - Perl pragma to control VMS-specific language features
-
 =over 4
 
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
+=item validate
 
 =back
 
-=head2 warnings - Perl pragma to control optional warnings
-
 =over 4
 
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-use warnings::register, warnings::enabled(), warnings::enabled($category),
-warnings::enabled($object), warnings::warn($message),
-warnings::warn($category, $message), warnings::warn($object, $message),
-warnings::warnif($message), warnings::warnif($category, $message),
-warnings::warnif($object, $message)
+=item has_content
 
 =back
 
-=head2 warnings::register - warnings import function
-
 =over 4
 
-=item SYNOPSIS
-
-=item DESCRIPTION
+=item get_content
 
 =back
 
-=head1 MODULE DOCUMENTATION
+=over 4
 
-=head2 AnyDBM_File - provide framework for multiple DBMs
+=item get_content_by_ref
+
+=back
 
 =over 4
 
-=item SYNOPSIS
+=item replace_content( $content )
 
-=item DESCRIPTION
+=back
 
 =over 4
 
-=item DBM Comparisons
-
-[0], [1], [2], [3]
+=item rename( $new_name )
 
 =back
 
-=item SEE ALSO
+=over 4
+
+=item Convenience methods
+
+is_file, is_dir, is_hardlink, is_symlink, is_chardev, is_blockdev, is_fifo,
+is_socket, is_longlink, is_label, is_unknown
 
 =back
 
@@ -8478,7 +11057,7 @@ BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
 
 =item B::AV Methods
 
-FILL, MAX, OFF, ARRAY, ARRAYelt, AvFLAGS
+FILL, MAX, ARRAY, ARRAYelt
 
 =item B::CV Methods
 
@@ -8487,13 +11066,14 @@ XSUBANY, CvFLAGS, const_sv
 
 =item B::HV Methods
 
-FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
+FILL, MAX, KEYS, RITER, NAME, ARRAY
 
 =item OP-RELATED CLASSES
 
 =item B::OP Methods
 
-next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
+next, sibling, name, ppaddr, desc, targ, type, opt, static, flags, private,
+spare
 
 =item B::UNOP METHOD
 
@@ -8662,52 +11242,104 @@ B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
 
 =item Arithmetic
 
-=item Deprecated features
+=item Deprecated features
+
+=back
+
+=item AUTHOR
+
+=back
+
+=head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item EXAMPLE
+
+=item OPTIONS
+
+=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
 
-=back
+B<-main>, B<-nomain>, B<-nobanner>, B<-banner>, B<-banneris> => subref
 
-=item AUTHOR
+=item Option Stickiness
 
 =back
 
-=head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
+=item ABBREVIATIONS
 
 =over 4
 
-=item SYNOPSIS
+=item OP class abbreviations
 
-=item DESCRIPTION
+=item OP flags abbreviations
 
-=item EXAMPLE
+=back
 
-=item OPTIONS
+=item FORMATTING SPECIFICATIONS
 
-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 FORMATTING SPECIFICATIONS
+=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<#seqnum>, 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
 
@@ -8824,6 +11456,18 @@ B<-u Package>
 
 =item DESCRIPTION
 
+=item EXAMPLES
+
+=over 4
+
+=item OPTIONS
+
+=back
+
+=item SEE ALSO
+
+=item TODO
+
 =item AUTHOR
 
 =back
@@ -8872,6 +11516,26 @@ C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
 
 =back
 
+=head2 Bblock, B::Bblock - Walk basic blocks
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Functions
+
+B<find_leaders>
+
+=back
+
+=item AUTHOR
+
+=back
+
 =head2 Benchmark - benchmark running times of Perl code
 
 =over 4
@@ -8932,6 +11596,28 @@ disablecache ( ), enablecache ( ), timesum ( T1, T2 )
 
 =back
 
+=head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item EXAMPLE
+
+=item OPTIONS
+
+B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
+
+=item KNOWN BUGS
+
+=item NOTICE
+
+=item AUTHORS
+
+=back
+
 =head2 CGI - Simple Common Gateway Interface Class
 
 =over 4
@@ -9051,6 +11737,12 @@ charset([$charset]);, $flag = autoEscape([$flag]);
 
 B<application/x-www-form-urlencoded>, B<multipart/form-data>
 
+=item FORM ELEMENTS
+
+B<-name>, B<-value>, B<-values>, B<-tabindex>, B<-id>, B<-override>,
+B<-onChange>, B<-onFocus>, B<-onBlur>, B<-onMouseOver>, B<-onMouseOut>,
+B<-onSelect>
+
 =item CREATING A TEXT FIELD
 
 B<Parameters>
@@ -9115,6 +11807,11 @@ B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
 document in the HTTP header, 3. Specify the destination for the document in
 the <form> tag
 
+=item SUPPORT FOR JAVASCRIPT
+
+B<onLoad>, B<onUnload>, B<onSubmit>, B<onClick>, B<onChange>, B<onFocus>,
+B<onBlur>, B<onSelect>, B<onMouseOver>, B<onMouseOut>
+
 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
 
 =item DEBUGGING
@@ -9131,8 +11828,8 @@ B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
 B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
 name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
 ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
-B<server_software ()>, B<remote_user ()>, B<user_name ()>,
-B<request_method()>, B<content_type()>, B<http()>, B<https()>
+B<virtual_port ()>, B<server_software ()>, B<remote_user ()>, B<user_name
+()>, B<request_method()>, B<content_type()>, B<http()>, B<https()>
 
 =item USING NPH SCRIPTS
 
@@ -9529,11 +12226,27 @@ module
 
 =back
 
+=item GLOBAL VARIABLES
+
+=over 4
+
+=item $Carp::CarpLevel
+
+=item $Carp::MaxEvalLen
+
+=item $Carp::MaxArgLen
+
+=item $Carp::MaxArgNums
+
+=item $Carp::Verbose
+
+=back
+
 =item BUGS
 
 =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
 
@@ -9588,6 +12301,451 @@ Example 1, Example 2, Example 3
 
 =back
 
+=head2 Compress::Zlib - Interface to zlib compression library
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item DEFLATE 
+
+=over 4
+
+=item B<($d, $status) = deflateInit( [OPT] )>
+
+B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>,
+B<-Dictionary>, B<-Bufsize>
+
+=item B<($out, $status) = $d-E<gt>deflate($buffer)>
+
+=item B<($out, $status) = $d-E<gt>flush([flush_type])>
+
+=item B<$status = $d-E<gt>deflateParams([OPT])>
+
+B<-Level>, B<-Strategy>
+
+=item B<$d-E<gt>dict_adler()>
+
+=item B<$d-E<gt>msg()>
+
+=item B<$d-E<gt>total_in()>
+
+=item B<$d-E<gt>total_out()>
+
+=item Example
+
+=back
+
+=item INFLATE
+
+=over 4
+
+=item B<($i, $status) = inflateInit()>
+
+B<-WindowBits>, B<-Bufsize>, B<-Dictionary>
+
+=item B<($out, $status) = $i-E<gt>inflate($buffer)>
+
+=item B<$status = $i-E<gt>inflateSync($buffer)>
+
+=item B<$i-E<gt>dict_adler()>
+
+=item B<$i-E<gt>msg()>
+
+=item B<$i-E<gt>total_in()>
+
+=item B<$i-E<gt>total_out()>
+
+=item Example
+
+=back
+
+=item COMPRESS/UNCOMPRESS
+
+B<$dest = compress($source [, $level] ) ;>, B<$dest = uncompress($source)
+;>
+
+=item GZIP INTERFACE
+
+B<$gz = gzopen(filename or filehandle, mode)>, B<$bytesread =
+$gz-E<gt>gzread($buffer [, $size]) ;>, B<$bytesread =
+$gz-E<gt>gzreadline($line) ;>, B<$byteswritten = $gz-E<gt>gzwrite($buffer)
+;>, B<$status = $gz-E<gt>gzflush($flush) ;>, B<$status = $gz-E<gt>gzeof()
+;>, B<$gz-E<gt>gzclose>, B<$gz-E<gt>gzsetparams($level, $strategy>,
+B<$level>, B<$strategy>, B<$gz-E<gt>gzerror>, B<$gzerrno>
+
+=over 4
+
+=item Examples
+
+=item Compress::Zlib::memGzip
+
+=item Compress::Zlib::memGunzip
+
+=back
+
+=item CHECKSUM FUNCTIONS
+
+=item ACCESSING ZIP FILES
+
+=item CONSTANTS
+
+=item AUTHOR
+
+=item MODIFICATION HISTORY
+
+=back
+
+=head2 Config - access Perl configuration information
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+myconfig(), config_sh(), config_re($regex), config_vars(@names)
+
+=item EXAMPLE
+
+=item WARNING
+
+=item GLOSSARY
+
+=over 4
+
+=item _
+
+C<_a>, C<_exe>, C<_o>
+
+=item a
+
+C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
+C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
+C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
+C<asctime_r_proto>, C<awk>
+
+=item b
+
+C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
+
+=item c
+
+C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
+C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
+C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
+C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
+C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
+C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
+C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
+
+=item d
+
+C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>,
+C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>,
+C<d_attribute_format>, C<d_attribute_malloc>, C<d_attribute_nonnull>,
+C<d_attribute_noreturn>, C<d_attribute_pure>, C<d_attribute_unused>,
+C<d_attribute_warn_unused_result>, C<d_bcmp>, C<d_bcopy>, C<d_bsd>,
+C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>, C<d_casti32>, C<d_castneg>,
+C<d_charvspr>, C<d_chown>, C<d_chroot>, C<d_chsize>, C<d_class>,
+C<d_closedir>, C<d_cmsghdr_s>, C<d_const>, C<d_copysignl>, C<d_crypt>,
+C<d_crypt_r>, C<d_csh>, C<d_ctermid_r>, C<d_ctime_r>, C<d_cuserid>,
+C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>, C<d_dirnamlen>,
+C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, C<d_drand48_r>,
+C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endgrent_r>,
+C<d_endhent>, C<d_endhostent_r>, C<d_endnent>, C<d_endnetent_r>,
+C<d_endpent>, C<d_endprotoent_r>, C<d_endpwent>, C<d_endpwent_r>,
+C<d_endsent>, C<d_endservent_r>, C<d_eofnblk>, C<d_eunice>, C<d_faststdio>,
+C<d_fchdir>, C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>,
+C<d_fd_macros>, C<d_fd_set>, C<d_fds_bits>, C<d_fgetpos>, C<d_finite>,
+C<d_finitel>, C<d_flexfnam>, C<d_flock>, C<d_flockproto>, C<d_fork>,
+C<d_fp_class>, C<d_fpathconf>, C<d_fpclass>, C<d_fpclassify>,
+C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>,
+C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>,
+C<d_ftime>, C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>,
+C<d_getgrent>, C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>,
+C<d_getgrps>, C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>,
+C<d_gethname>, C<d_gethostbyaddr_r>, C<d_gethostbyname_r>,
+C<d_gethostent_r>, C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>,
+C<d_getlogin_r>, C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>,
+C<d_getnbyname>, C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>,
+C<d_getnetent_r>, C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>,
+C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>,
+C<d_getppid>, C<d_getprior>, C<d_getprotobyname_r>,
+C<d_getprotobynumber_r>, C<d_getprotoent_r>, C<d_getprotoprotos>,
+C<d_getprpwnam>, C<d_getpwent>, C<d_getpwent_r>, C<d_getpwnam_r>,
+C<d_getpwuid_r>, C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>,
+C<d_getservbyname_r>, C<d_getservbyport_r>, C<d_getservent_r>,
+C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, C<d_gettimeod>,
+C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>,
+C<d_ilogbl>, C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>,
+C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>, C<d_killpg>,
+C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>, C<d_locconv>,
+C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>,
+C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>,
+C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>,
+C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>,
+C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>,
+C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>,
+C<d_msg_peek>, C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>,
+C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>,
+C<d_nice>, C<d_nl_langinfo>, C<d_nv_preserves_uv>,
+C<d_nv_zero_is_allbits_zero>, C<d_off64_t>,
+C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
+C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
+C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
+C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
+C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>,
+C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, C<d_pthread_atfork>,
+C<d_pthread_attr_setscope>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
+C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
+C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
+C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
+C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
+C<d_sanemcmp>, C<d_sbrkproto>, C<d_scalbnl>, C<d_sched_yield>,
+C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>,
+C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>,
+C<d_semop>, C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>,
+C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>,
+C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>,
+C<d_setnent>, C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>,
+C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>,
+C<d_setpwent>, C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>,
+C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>,
+C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>,
+C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>,
+C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>,
+C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>,
+C<d_socks5_init>, C<d_sqrtl>, C<d_srand48_r>, C<d_srandom_r>,
+C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>,
+C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
+C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>,
+C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>,
+C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strerror_r>,
+C<d_strftime>, C<d_strlcat>, C<d_strlcpy>, C<d_strtod>, C<d_strtol>,
+C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>,
+C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>,
+C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
+C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
+C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>,
+C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>,
+C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
+C<d_unordered>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>,
+C<d_vendorbin>, C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>,
+C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>, C<d_volatile>,
+C<d_vprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>,
+C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>, C<db_prefixtype>,
+C<db_version_major>, C<db_version_minor>, C<db_version_patch>,
+C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>, C<doublesize>,
+C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
+
+=item e
+
+C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
+C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
+C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
+C<expr>, C<extensions>, C<extras>
+
+=item f
+
+C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
+C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
+C<full_sed>
+
+=item g
+
+C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>,
+C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>,
+C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>,
+C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>,
+C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>,
+C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>,
+C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>,
+C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>,
+C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>,
+C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
+
+=item h
+
+C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>,
+C<html3dir>, C<html3direxp>
+
+=item i
+
+C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
+C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
+C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
+C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
+C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
+C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
+C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
+C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
+C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
+C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
+C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
+C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
+C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
+C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
+C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
+C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
+C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
+C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
+C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installhtml1dir>,
+C<installhtml3dir>, C<installman1dir>, C<installman3dir>, C<installprefix>,
+C<installprefixexp>, C<installprivlib>, C<installscript>,
+C<installsitearch>, C<installsitebin>, C<installsitehtml1dir>,
+C<installsitehtml3dir>, C<installsitelib>, C<installsiteman1dir>,
+C<installsiteman3dir>, C<installsitescript>, C<installstyle>,
+C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>,
+C<installvendorhtml1dir>, C<installvendorhtml3dir>, C<installvendorlib>,
+C<installvendorman1dir>, C<installvendorman3dir>, C<installvendorscript>,
+C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
+
+=item k
+
+C<known_extensions>, C<ksh>
+
+=item l
+
+C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
+C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
+C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
+C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
+C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
+C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
+C<lseektype>
+
+=item m
+
+C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
+C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
+C<man3direxp>, C<man3ext>
+
+=item M
+
+C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>,
+C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>,
+C<myuname>
+
+=item n
+
+C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
+C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
+C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
+C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
+C<nvsize>, C<nvtype>
+
+=item o
+
+C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
+C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
+
+=item p
+
+C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
+C<perl>, C<perl_patchlevel>
+
+=item P
+
+C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
+C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
+C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>,
+C<procselfexe>, C<prototype>, C<ptrsize>
+
+=item q
+
+C<quadkind>, C<quadtype>
+
+=item r
+
+C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
+C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
+C<rmail>, C<run>, C<runnm>
+
+=item s
+
+C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
+C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
+C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
+C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
+C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
+C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
+C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
+C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>,
+C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>,
+C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>,
+C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>,
+C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>,
+C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>,
+C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>,
+C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>,
+C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>,
+C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>,
+C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>,
+C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>,
+C<submit>, C<subversion>, C<sysman>
+
+=item t
+
+C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
+C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
+C<ttyname_r_proto>
+
+=item u
+
+C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
+C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
+C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
+C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>,
+C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemallocwrap>,
+C<usemorebits>, C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>,
+C<useperlio>, C<useposix>, C<usereentrant>, C<userelocatableinc>,
+C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>, C<usevendorprefix>,
+C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>, C<uvsize>, C<uvtype>,
+C<uvuformat>, C<uvxformat>, C<uvXUformat>
+
+=item v
+
+C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
+C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>,
+C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>,
+C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>,
+C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>,
+C<vendorscriptexp>, C<version>, C<version_patchlevel_string>,
+C<versiononly>, C<vi>, C<voidflags>
+
+=item x
+
+C<xlibpth>
+
+=item y
+
+C<yacc>, C<yaccflags>
+
+=item z
+
+C<zcat>, C<zip>
+
+=back
+
+=item NOTE
+
+=back
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+dynamic, nonxs, static
+
+=item AUTHOR
+
+=back
+
 =head2 Cwd - get pathname of current working directory
 
 =over 4
@@ -9600,7 +12758,7 @@ Example 1, Example 2, Example 3
 
 =item getcwd and friends
 
-getcwd, cwd, fastcwd, fastgetcwd
+getcwd, cwd, fastcwd, fastgetcwd, getdcwd
 
 =item abs_path and friends
 
@@ -9612,6 +12770,10 @@ abs_path, realpath, fast_abs_path
 
 =item NOTES
 
+=item AUTHOR
+
+=item COPYRIGHT
+
 =item SEE ALSO
 
 =back
@@ -9639,15 +12801,83 @@ $DB::lineno
 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
 
-=item Client Callback Methods
+=item Client Callback Methods
+
+CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
+CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
+CLIENT->output(LIST)
+
+=back
+
+=item BUGS
+
+=item AUTHOR
+
+=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
 
-CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
-CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
-CLIENT->output(LIST)
+=item Don't mix filtered & non-filtered data in the same database file. 
 
 =back
 
-=item BUGS
+=item EXAMPLE
+
+=item SEE ALSO
 
 =item AUTHOR
 
@@ -9867,13 +13097,45 @@ Dumper
 
 =over 4
 
+=item Why use ppport.h?
+
+You should use F<ppport.h> in modern code so that your code will work
+with the widest range of Perl interpreters possible, without significant
+additional work.
+
+=item How to use ppport.h
+
+=item Running ppport.h
+
+=back
+
+=item FUNCTIONS
+
+=over 4
+
 =item WriteFile
 
 =back
 
-=item ppport.h
+=item COMPATIBILITY
+
+=over 4
+
+=item Provided Perl compatibility API
 
-=item AUTHOR
+=item Perl API not supported by ppport.h
+
+perl 5.9.2, perl 5.9.1, perl 5.9.0, perl 5.8.3, perl 5.8.1, perl 5.8.0,
+perl 5.7.3, perl 5.7.2, perl 5.7.1, perl 5.6.1, perl 5.6.0, perl 5.005_03,
+perl 5.005, perl 5.004_05, perl 5.004_04, perl 5.004
+
+=back
+
+=item BUGS
+
+=item AUTHORS
+
+=item COPYRIGHT
 
 =item SEE ALSO
 
@@ -9939,7 +13201,7 @@ Dumper
 
 =back
 
-=head2 Digest:: - Modules that calculate message digests
+=head2 Digest - Modules that calculate message digests
 
 =over 4
 
@@ -9953,9 +13215,12 @@ I<binary>, I<hex>, I<base64>
 
 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
 Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset,
-$ctx->add($data,...), $ctx->addfile($io_handle), $ctx->digest,
+$ctx->add( $data, ... ), $ctx->addfile( $io_handle ), $ctx->add_bits(
+$data, $nbits ), $ctx->add_bits( $bitstring ), $ctx->digest,
 $ctx->hexdigest, $ctx->b64digest
 
+=item Digest speed
+
 =item SEE ALSO
 
 =item AUTHOR
@@ -9977,7 +13242,8 @@ md5($data,...), md5_hex($data,...), md5_base64($data,...)
 =item METHODS
 
 $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...),
-$md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
+$md5->addfile($io_handle), $md5->add_bits($data, $nbits),
+$md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest
 
 =item EXAMPLES
 
@@ -9989,6 +13255,34 @@ $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
 
 =back
 
+=head2 Digest::base - Digest base class
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=back
+
+=head2 Digest::file - Calculate digests of files
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+digest_file( $file, $algorithm, [$arg,...] ), digest_file_hex( $file,
+$algorithm, [$arg,...] ), digest_file_base64( $file, $algorithm, [$arg,...]
+)
+
+=item SEE ALSO
+
+=back
+
 =head2 DirHandle - supply object methods for directory handles
 
 =over 4
@@ -10027,6 +13321,55 @@ compactDump, veryCompact, set, get
 
 =back
 
+=head2 DynaLoader - Dynamically load C libraries into Perl code
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+@dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
+@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
+
+=back
+
+=head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
+Perl code
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Migration from C<DynaLoader>
+
+=item Backward compatible boilerplate
+
+=back
+
+=item Order of initialization: early load()
+
+=over 4
+
+=item The most hairy case
+
+=back
+
+=item LIMITATIONS
+
+=item AUTHOR
+
+=back
+
 =head2 Encode - character encodings
 
 =over 4
@@ -10066,39 +13409,210 @@ CHECK]);
 
 =item Handling Malformed Data
 
-I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
-I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
-(I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
-Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
-bitmask
+B<NOTE:> Not all encoding support this feature, I<CHECK> =
+Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1), I<CHECK> =
+Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode (I<CHECK> =
+Encode::FB_PERLQQ), HTML charref mode (I<CHECK> = Encode::FB_HTMLCREF), XML
+charref mode (I<CHECK> = Encode::FB_XMLCREF), The bitmask
+
+=over 4
+
+=item Unimplemented fallback schemes
+
+=back
+
+=item Defining Encodings
+
+=item The UTF-8 flag
+
+Goal #1:, Goal #2:, Goal #3:, Goal #4:
+
+=over 4
+
+=item Messing with Perl's Internals
+
+is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
+
+=back
+
+=item UTF-8 vs. utf8
+
+=item SEE ALSO
+
+=item MAINTAINER
+
+=back
+
+=head2 Encode::Alias - alias definitions to encodings
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+As a simple string, As a qr// compiled regular expression, e.g.:, As a code
+reference, e.g.:
+
+=over 4
+
+=item Alias overloading
+
+=back
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::Byte - Single Byte Encodings
+
+=over 4
+
+=item SYNOPSIS
+
+=item ABSTRACT
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
+
+=head2 Encode::CN - China-based Chinese Encodings
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item NOTES
+
+=item BUGS
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::CN::HZ -- internally used by Encode::CN
+
+=head2 Encode::Config -- internally used by Encode
+
+=head2 Encode::EBCDIC - EBCDIC Encodings
+
+=over 4
+
+=item SYNOPSIS
+
+=item ABSTRACT
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::Encoding - Encode Implementation Base Class
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Methods you should implement
+
+-E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
+-E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
+
+=item Other methods defined in Encode::Encodings
+
+-E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(),
+-E<gt>needs_lines()
+
+=item Example: Encode::ROT13
+
+=back
+
+=item Why the heck Encode API is different?
+
+=over 4
+
+=item Compiled Encodings
+
+=back
+
+=item SEE ALSO
+
+Scheme 1, Scheme 2, Other Schemes
+
+=back
+
+=head2 Encode::Guess -- Guesses encoding from data
+
+=over 4
+
+=item SYNOPSIS
+
+=item ABSTRACT
+
+=item DESCRIPTION
+
+Encode::Guess->set_suspects, Encode::Guess->add_suspects,
+Encode::decode("Guess" ...), Encode::Guess->guess($data),
+guess_encoding($data, [, I<list of suspects>])
+
+=item CAVEATS
+
+=item TO DO
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::JP - Japanese Encodings
+
+=over 4
+
+=item SYNOPSIS
+
+=item ABSTRACT
+
+=item DESCRIPTION
+
+=item Note on ISO-2022-JP(-1)?
 
-=over 4
+=item BUGS
 
-=item Unimplemented fallback schemes
+=item SEE ALSO
 
 =back
 
-=item Defining Encodings
+=head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
 
-=item The UTF-8 flag
+=head2 Encode::JP::JIS7 -- internally used by Encode::JP
 
-Goal #1:, Goal #2:, Goal #3:, Goal #4:
+=head2 Encode::KR - Korean Encodings
 
 =over 4
 
-=item Messing with Perl's Internals
+=item SYNOPSIS
 
-is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
+=item DESCRIPTION
 
-=back
+=item BUGS
 
 =item SEE ALSO
 
-=item MAINTAINER
-
 =back
 
-=head2 Encode::Byte - Single Byte Encodings
+=head2 Encode::KR::2022_KR -- internally used by Encode::KR
+
+=head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
 
 =over 4
 
@@ -10108,69 +13622,113 @@ is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
 
 =item DESCRIPTION
 
+=item BUGS
+
 =item SEE ALSO
 
 =back
 
-=head2 Encode::CN - China-based Chinese Encodings
+=head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
 
 =over 4
 
-=item SYNOPSIS
+=item Overview
 
-=item DESCRIPTION
+=item How does it work?
 
-=item NOTES
+=item Line Buffering
 
-=item BUGS
+=over 4
 
-=item SEE ALSO
+=item How can I tell whether my encoding fully supports PerlIO ?
 
 =back
 
-=head2 Encode::EBCDIC - EBCDIC Encodings
+=item SEE ALSO
 
-=over 4
+=back
 
-=item SYNOPSIS
+=head2 Encode::Supported -- Encodings supported by Encode
 
-=item ABSTRACT
+=over 4
 
 =item DESCRIPTION
 
-=item SEE ALSO
+=over 4
+
+=item Encoding Names
 
 =back
 
-=head2 Encode::JP - Japanese Encodings
+=item Supported Encodings
 
 =over 4
 
-=item SYNOPSIS
+=item Built-in Encodings
 
-=item ABSTRACT
+=item Encode::Unicode -- other Unicode encodings
 
-=item DESCRIPTION
+=item Encode::Byte -- Extended ASCII
 
-=item Note on ISO-2022-JP(-1)?
+ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
+the Cyrillic world, gsm0338 - Hentai Latin 1
 
-=item BUGS
+=item CJK: Chinese, Japanese, Korean (Multibyte)
 
-=item SEE ALSO
+Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
+Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
+Encode::JIS2K -- JIS X 0213 encodings via CPAN
+
+=item Miscellaneous encodings
+
+Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
 
 =back
 
-=head2 Encode::KR - Korean Encodings
+=item Unsupported encodings
+
+  ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
+Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
+System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
+Various Mac encodings, (Mac) Indic encodings
+
+=item Encoding vs. Charset -- terminology
+
+=item Encoding Classification (by Anton Tagunov and Dan Kogai)
 
 =over 4
 
-=item SYNOPSIS
+=item Microsoft-related naming mess
 
-=item DESCRIPTION
+KS_C_5601-1987, GB2312, Big5, Shift_JIS
 
-=item BUGS
+=back
 
-=item SEE ALSO
+=item Glossary
+
+character repertoire, coded character set (CCS), character encoding scheme
+(CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
+UTF-16
+
+=item See Also
+
+=item References
+
+ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
+RFC, UC, Unicode Glossary
+
+=over 4
+
+=item Other Notable Sites
+
+czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
+"Introduction to i18n"
+
+=item Offline sources
+
+C<CJKV Information Processing> by Ken Lunde
+
+=back
 
 =back
 
@@ -10228,6 +13786,22 @@ BOM as integer when fetched in network byte order
 
 =item Surrogate Pairs
 
+=item Error Checking
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::Unicode::UTF7 -- UTF-7 encoding
+
+=over 4
+
+=item SYNOPSIS
+
+=item ABSTRACT
+
+=item In Practice
+
 =item SEE ALSO
 
 =back
@@ -10281,7 +13855,8 @@ Implementation Base Class
 
 =item Other methods defined in Encode::Encodings
 
--E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
+-E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(),
+-E<gt>needs_lines()
 
 =item Example: Encode::ROT13
 
@@ -10514,6 +14089,8 @@ non-ascii or non-utf8
 
 =item PerlIO layers for C<STD(IN|OUT)>
 
+=item Implicit upgrading for byte strings
+
 =back
 
 =item FEATURES THAT REQUIRE 5.8.1
@@ -10553,12 +14130,46 @@ Legend of characters above
 
 literals in regex that are longer than 127 bytes, EBCDIC, format
 
+=over 4
+
+=item The Logic of :locale
+
+=back
+
 =item HISTORY
 
 =item SEE ALSO
 
 =back
 
+=head2 Encoder, Encode::Encoder -- Object Oriented Encoder
+
+=over 4
+
+=item SYNOPSIS
+
+=item ABSTRACT
+
+=item Description
+
+=over 4
+
+=item Predefined Methods
+
+$e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
+$e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
+$e-E<gt>bytes([$encoding])
+
+=item Example: base64 transcoder
+
+=item Operator Overloading
+
+=back
+
+=item SEE ALSO
+
+=back
+
 =head2 English - use nice English (or awk) names for ugly punctuation
 variables
 
@@ -10587,6 +14198,22 @@ arrays
 
 =back
 
+=head2 Errno - System errno constants
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CAVEATS
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
 =head2 Exporter - Implements default import method for modules
 
 =over 4
@@ -10615,6 +14242,8 @@ C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
 
 =item Exporting without using Exporter's import method
 
+=item Exporting without inheriting from Exporter
+
 =item Module Version Checking
 
 =item Managing Unknown Symbols
@@ -10639,6 +14268,46 @@ C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
 
 =back
 
+=head2 ExtUtils::CBuilder - Compile and link C code for Perl modules
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item METHODS
+
+new, have_compiler, compile, C<object_file>, C<include_dirs>,
+C<extra_compiler_flags>, link, lib_file, module_name, extra_linker_flags,
+link_executable, exe_file, object_file, lib_file, exe_file, prelink,
+need_prelink
+
+=item TO DO
+
+=item HISTORY
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=item SEE ALSO
+
+=back
+
+=head2 ExtUtils::CBuilder::Platform::Windows - Builder class for Windows
+platforms
+
+=over 4
+
+=item DESCRIPTION
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
 Makefiles etc.
 
@@ -10652,35 +14321,88 @@ Makefiles etc.
 
 cat
 
-eqtime src dst
+eqtime
 
-rm_rf files...
+rm_rf
 
-rm_f files...
+rm_f
 
-touch files ..
+touch
 
-mv source... destination
+mv
 
-cp source... destination
+cp
 
-chmod mode files..
+chmod
 
-mkpath directory..
+mkpath
 
-test_f file
+test_f
+
+dos2unix
 
 =over 4
 
-=item BUGS
+=item SEE ALSO 
+
+=item AUTHOR
+
+=back
+
+=head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+B<test_harness>
+
+=back
+
+B<pod2man>
+
+B<warn_if_old_packlist>
+
+B<perllocal_install>
+
+B<uninstall>
+
+=head2 ExtUtils::Constant - generate XS code to import C header constants
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item USAGE
+
+IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
+
+=item FUNCTIONS
+
+=back
+
+constant_types
+
+XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
+
+autoload PACKAGE, VERSION, AUTOLOADER
+
+WriteMakefileSnippet
+
+WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
+BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
 
-=item SEE ALSO 
+=over 4
 
 =item AUTHOR
 
 =back
 
-=head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
+=head2 ExtUtils::Constant::Base - base class for ExtUtils::Constant objects
 
 =over 4
 
@@ -10688,67 +14410,69 @@ test_f file
 
 =item DESCRIPTION
 
-B<test_harness>
+=item USAGE
 
 =back
 
-B<pod2man>
+header
 
-B<warn_if_old_packlist>
+memEQ_clause args_hashref
 
-B<perllocal_install>
+dump_names arg_hashref, ITEM..
 
-B<uninstall>
+assign arg_hashref, VALUE..
 
-=head2 ExtUtils::Constant - generate XS code to import C header constants
+return_clause arg_hashref, ITEM
 
-=over 4
+switch_clause arg_hashref, NAMELEN, ITEMHASH, ITEM..
 
-=item SYNOPSIS
+params WHAT
 
-=item DESCRIPTION
+dogfood arg_hashref, ITEM..
 
-=item USAGE
+C_constant arg_hashref, ITEM.., name, type, value, macro, default, pre,
+post, def_pre, def_post, utf8, weight
 
-IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
+=over 4
 
-=item FUNCTIONS
+=item BUGS
+
+=item AUTHOR
 
 =back
 
-C_stringify NAME
+=head2 ExtUtils::Constant::Utils - helper functions for ExtUtils::Constant
 
-perl_stringify NAME
+=over 4
 
-constant_types
+=item SYNOPSIS
 
-memEQ_clause NAME, CHECKED_AT, INDENT
+=item DESCRIPTION
 
-assign INDENT, TYPE, PRE, POST, VALUE..
+=item USAGE
 
-return_clause
+C_stringify NAME
 
-switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
+=back
 
-params WHAT
+perl_stringify NAME
 
-dump_names
+=over 4
 
-dogfood
+=item AUTHOR
 
-C_constant, name, type, value, macro, default, pre, post, def_pre =item
-def_post, utf8
+=back
 
-XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
+=head2 ExtUtils::Constant::XS, ExtUtils::Constant::Base - base class for
+ExtUtils::Constant objects
 
-autoload PACKAGE, VERSION, AUTOLOADER
+=over 4
 
-WriteMakefileSnippet
+=item SYNOPSIS
 
-WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
-BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
+=item DESCRIPTION
 
-=over 4
+=item BUGS
 
 =item AUTHOR
 
@@ -10881,7 +14605,7 @@ dynamic extensions at load time
 
 =back
 
-=head2 ExtUtils::MM_Any - Platform-agnostic MM methods
+=head2 ExtUtils::MM_AIX - AIX specific subclass of ExtUtils::MM_Unix
 
 =over 4
 
@@ -10889,72 +14613,70 @@ dynamic extensions at load time
 
 =item DESCRIPTION
 
-=item Inherently Cross-Platform Methods
+=over 4
 
-installvars
+=item Overridden methods
 
 =back
 
-os_flavor_is
+=back
 
 =over 4
 
-=item File::Spec wrappers
+=item AUTHOR
 
-catfile
+=item SEE ALSO
 
 =back
 
+=head2 ExtUtils::MM_Any - Platform-agnostic MM methods
+
 =over 4
 
-=item Thought To Be Cross-Platform Methods
+=item SYNOPSIS
+
+=item DESCRIPTION
 
-B<split_command>
+=item METHODS
 
-=back
+=over 4
 
-B<echo>
+=item Cross-platform helper methods
 
-init_VERSION
+=back
 
-wraplist
+=back
 
-manifypods
+=over 4
 
-manifypods_target
+=item Targets
 
-makemakerdflt_target
+=back
 
-special_targets
+=over 4
 
-POD2MAN_macro
+=item Init methods
 
-test_via_harness
+=back
 
-test_via_script
+=over 4
 
-libscan
+=item Tools
 
-tool_autosplit
+=back
 
-all_target
+=over 4
 
-metafile_target
+=item File::Spec wrappers
 
-metafile_addtomanifest_target
+=back
 
 =over 4
 
-=item Abstract methods
-
-oneliner, B<quote_literal>, B<escape_newlines>, max_exec_len,
-B<init_others>, init_DIRFILESEP, init_linker, init_platform,
-platform_constants
+=item Misc
 
 =back
 
-os_flavor
-
 =over 4
 
 =item AUTHOR
@@ -10972,7 +14694,7 @@ ExtUtils::MakeMaker
 
 =back
 
-os_flavor (o)
+os_flavor
 
 init_linker
 
@@ -10985,13 +14707,13 @@ ExtUtils::MakeMaker
 
 =item DESCRIPTION
 
-os_flavor (o)
+os_flavor
 
 =back
 
-cflags (o)
+cflags
 
-replace_manpage_separator (o)
+replace_manpage_separator
 
 init_linker
 
@@ -11023,8 +14745,7 @@ B<replace_manpage_separator>
 
 =back
 
-=head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
-ExtUtils::MakeMaker
+=head2 ExtUtils::MM_MacOS - once produced Makefiles for MacOS Classic
 
 =over 4
 
@@ -11034,48 +14755,47 @@ ExtUtils::MakeMaker
 
 =back
 
-maybe_command
+=head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
+ExtUtils::MakeMaker
 
-guess_name
+=over 4
 
-macify
+=item SYNOPSIS
 
-patternify
+=item DESCRIPTION
 
-init_main
+=back
 
-init_others
+os_flavor
 
 init_platform, platform_constants
 
-init_dirscan
-
-init_VERSION (o)
+const_cccmd
 
-special_targets (o)
+static_lib
 
-static (o)
+dynamic_lib
 
-dlsyms (o)
+=head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
+ExtUtils::MakeMaker
 
-dynamic (o)
+=over 4
 
-clean (o)
+=item SYNOPSIS
 
-clean_subdirs_target
+=item DESCRIPTION
 
-realclean (o)
+=item METHODS
 
-realclean_subdirs_target
+init_dist
 
-rulez (o)
+=back
 
-processPL (o)
+init_linker
 
 os_flavor
 
-=head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
-ExtUtils::MakeMaker
+=head2 ExtUtils::MM_QNX - QNX specific subclass of ExtUtils::MM_Unix
 
 =over 4
 
@@ -11083,37 +14803,22 @@ ExtUtils::MakeMaker
 
 =item DESCRIPTION
 
-=back
-
-os_flavor
-
-init_platform (o), platform_constants
-
-const_cccmd (o)
+=over 4
 
-static_lib (o)
+=item Overridden methods
 
-dynamic_lib (o)
+=back
 
-=head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
-ExtUtils::MakeMaker
+=back
 
 =over 4
 
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item METHODS
+=item AUTHOR
 
-init_dist (o)
+=item SEE ALSO
 
 =back
 
-init_linker
-
-os_flavor
-
 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
 
 =over 4
@@ -11158,7 +14863,7 @@ B<replace_manpage_separator>
 
 =item Methods
 
-os_flavor (o)
+os_flavor
 
 =back
 
@@ -11166,10 +14871,6 @@ c_o (o)
 
 cflags (o)
 
-clean (o)
-
-clean_subdirs_target
-
 const_cccmd (o)
 
 const_config (o)
@@ -11180,8 +14881,6 @@ constants (o)
 
 depend (o)
 
-dir_target (o)
-
 init_DEST
 
 init_dist
@@ -11208,14 +14907,8 @@ uutardist_target
 
 shdist_target
 
-distdir
-
-dist_test
-
 dlsyms (o)
 
-dynamic (o)
-
 dynamic_bs (o)
 
 dynamic_lib (o)
@@ -11226,16 +14919,8 @@ extliblist
 
 find_perl
 
-find_tests
-
-=over 4
-
-=item Methods to actually produce chunks of text for the Makefile
-
 fixin
 
-=back
-
 force (o)
 
 guess_name
@@ -11250,17 +14935,13 @@ init_main
 
 init_others
 
-init_INST
-
-init_INSTALL
-
 init_linker
 
 init_lib2arch
 
 init_PERL
 
-init_platform (o), platform_constants (o)
+init_platform, platform_constants
 
 init_PERM
 
@@ -11316,13 +14997,11 @@ processPL (o)
 
 quote_paren
 
-realclean (o)
-
-realclean_subdirs_target
-
 replace_manpage_separator
 
-oneliner (o)
+cd
+
+oneliner
 
 quote_literal
 
@@ -11399,6 +15078,10 @@ find_perl (override)
 
 maybe_command (override)
 
+pasthru (override)
+
+pm_to_blib (override)
+
 perl_script (override)
 
 replace_manpage_separator
@@ -11425,8 +15108,6 @@ cflags (override)
 
 const_cccmd (override)
 
-tool_sxubpp (override)
-
 tools_other (override)
 
 init_dist (override)
@@ -11441,45 +15122,27 @@ dlsyms (override)
 
 dynamic_lib (override)
 
-dynamic_bs (override)
-
 static_lib (override)
 
-processPL (override)
+extra_clean_files
 
-installbin (override)
-
-subdir_x (override)
-
-clean (override)
-
-clean_subdirs_target
-
-realclean (override)
-
-zipfile_target (o), tarfile_target (o), shdist_target (o)
-
-dist_test (override)
+zipfile_target, tarfile_target, shdist_target
 
 install (override)
 
 perldepend (override)
 
-makefile (override)
-
-find_tests (override)
-
-test (override)
-
 makeaperl (override)
 
 nicetext (override)
 
 prefixify (override)
 
-oneliner (o)
+cd
+
+oneliner
 
-B<echo> (o)
+B<echo>
 
 quote_literal
 
@@ -11487,7 +15150,7 @@ escape_newlines
 
 max_exec_len
 
-init_linker (o)
+init_linker
 
 eliminate_macros
 
@@ -11495,6 +15158,36 @@ fixpath
 
 os_flavor
 
+=over 4
+
+=item AUTHOR
+
+=back
+
+=head2 ExtUtils::MM_VOS - VOS specific subclass of ExtUtils::MM_Unix
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Overridden methods
+
+=back
+
+=back
+
+=over 4
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
 ExtUtils::MakeMaker
 
@@ -11518,31 +15211,31 @@ replace_manpage_separator
 
 B<maybe_command>
 
-B<find_tests>
-
 B<init_DIRFILESEP>
 
 B<init_others>
 
-init_platform (o), platform_constants (o)
+init_platform, platform_constants
 
-special_targets (o)
+special_targets
 
-static_lib (o)
+static_lib
 
-dynamic_lib (o)
+dynamic_lib
 
-clean
+extra_clean_files
 
 init_linker
 
 perl_script
 
-xs_o (o)
+xs_o
 
-pasthru (o)
+pasthru
+
+oneliner
 
-oneliner (o)
+cd
 
 max_exec_len
 
@@ -11558,25 +15251,19 @@ os_flavor
 
 =over 4
 
-=item Overriden methods
+=item Overridden methods
 
-dist_test
+xs_c
 
 =back
 
 =back
 
-subdir_x
-
-xs_c
-
 xs_cpp
 
 xs_o
 
-clean_subdirs_target
-
-realclean_subdirs_target
+max_exec_len
 
 os_flavor
 
@@ -11644,8 +15331,8 @@ OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB,
 PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW,
 PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT,
-PRINT_PREREQ, SITEPREFIX, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION,
-VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION
+PRINT_PREREQ, SITEPREFIX, SIGN, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST,
+VERSION, VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION
 
 =item Additional lowercase attributes
 
@@ -11656,7 +15343,7 @@ test, tool_autosplit
 
 =item The End Of Cargo Cult Programming
 
-C<<MAN3PODS => ' '>>
+C<< MAN3PODS => ' ' >>
 
 =item Hintsfile support
 
@@ -11678,7 +15365,7 @@ prompt
 
 =item ENVIRONMENT
 
-PERL_MM_OPT, PERL_MM_USE_DEFAULT
+PERL_MM_OPT, PERL_MM_USE_DEFAULT, PERL_CORE
 
 =item SEE ALSO
 
@@ -11688,6 +15375,16 @@ PERL_MM_OPT, PERL_MM_USE_DEFAULT
 
 =back
 
+=head2 ExtUtils::MakeMaker::Config - Wrapper around Config.pm
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
 =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About
 MakeMaker
 
@@ -11697,9 +15394,14 @@ MakeMaker
 
 =over 4
 
+=item Module Installation
+
+How do I keep from installing man pages?, How do I use a module without
+installing it?
+
 =item Philosophy and History
 
-Why not just use <insert other build config tool here>?, What's
+Why not just use <insert other build config tool here>?, What is
 Module::Build and how does it relate to MakeMaker?, pure perl. no make, no
 shell commands, easier to customize, cleaner internals, less cruft
 
@@ -11747,7 +15449,7 @@ bin/
 
 =back
 
-=head2 ExtUtils::MakeMaker::bytes - Version agnostic bytes.pm
+=head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm
 
 =over 4
 
@@ -11757,7 +15459,7 @@ bin/
 
 =back
 
-=head2 ExtUtils::MakeMaker::vmsish - Platform agnostic vmsish.pm
+=head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm
 
 =over 4
 
@@ -11830,6 +15532,18 @@ B<PERL_MM_MANIFEST_DEBUG>
 
 =back
 
+=head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=back
+
 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
 
 =over 4
@@ -11865,16 +15579,38 @@ DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
 
 =item DESCRIPTION
 
-=item USAGE
+=item USAGE
+
+=item FUNCTIONS
+
+new(), read(), write(), validate(), packlist_file()
+
+=item EXAMPLE
+
+=item AUTHOR
+
+=back
+
+=head2 ExtUtils::ParseXS - converts Perl XS code into C code
+
+=over 4
+
+=item SYNOPSIS
+
+=item EXPORT
 
 =item FUNCTIONS
 
-new(), read(), write(), validate(), packlist_file()
-
-=item EXAMPLE
+process_xs(), B<C++>, B<hiertype>, B<except>, B<typemap>, B<prototypes>,
+B<versioncheck>, B<linenumbers>, B<optimize>, B<inout>, B<argtypes>, B<s>,
+errors()
 
 =item AUTHOR
 
+=item COPYRIGHT
+
+=item SEE ALSO
+
 =back
 
 =head2 ExtUtils::testlib - add blib/* directories to @INC
@@ -12037,6 +15773,8 @@ $dont_use_nlink, symlinks
 
 =item NOTES
 
+=item BUGS AND CAVEATS
+
 =item HISTORY
 
 =back
@@ -12049,16 +15787,26 @@ $dont_use_nlink, symlinks
 
 =item DESCRIPTION
 
+=over 4
+
+=item META CHARACTERS
+
+=item POSIX FLAGS
+
 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
 
+=back
+
 =item DIAGNOSTICS
 
 C<GLOB_NOSPACE>, C<GLOB_ABEND>
 
 =item NOTES
 
+=item SEE ALSO
+
 =item AUTHOR
 
 =back
@@ -12093,7 +15841,9 @@ splitdir, catpath(), abs2rel, rel2abs()
 
 =item SEE ALSO
 
-=item AUTHORS
+=item AUTHOR
+
+=item COPYRIGHT
 
 =back
 
@@ -12113,6 +15863,12 @@ file_name_is_absolute
 
 tmpdir (override)
 
+=over 4
+
+=item COPYRIGHT
+
+=back
+
 =head2 File::Spec::Epoc - methods for Epoc file specs
 
 =over 4
@@ -12121,14 +15877,16 @@ tmpdir (override)
 
 =item DESCRIPTION
 
-=item AUTHORS
-
 =back
 
 canonpath()
 
 =over 4
 
+=item AUTHOR
+
+=item COPYRIGHT
+
 =item SEE ALSO
 
 =back
@@ -12147,6 +15905,8 @@ canonpath()
 
 =back
 
+=item COPYRIGHT
+
 =item SEE ALSO
 
 =back
@@ -12197,6 +15957,8 @@ rel2abs
 
 =item AUTHORS
 
+=item COPYRIGHT
+
 =item SEE ALSO
 
 =back
@@ -12211,6 +15973,8 @@ rel2abs
 
 tmpdir, splitpath
 
+=item COPYRIGHT
+
 =back
 
 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
@@ -12264,6 +16028,8 @@ rel2abs()
 
 =over 4
 
+=item COPYRIGHT
+
 =item SEE ALSO
 
 =back
@@ -12322,6 +16088,8 @@ rel2abs (override)
 
 =over 4
 
+=item COPYRIGHT
+
 =item SEE ALSO
 
 =back
@@ -12358,6 +16126,8 @@ catpath
 
 =over 4
 
+=item COPYRIGHT
+
 =item SEE ALSO
 
 =back
@@ -12376,7 +16146,7 @@ catpath
 
 =over 4
 
-=item OO INTERFACE
+=item OBJECT-ORIENTED INTERFACE
 
 B<new>
 
@@ -12384,6 +16154,8 @@ B<new>
 
 B<filename>
 
+B<unlink_on_destroy>
+
 B<DESTROY>
 
 =over 4
@@ -12440,6 +16212,8 @@ B<cmpstat>
 
 B<unlink1>
 
+B<cleanup>
+
 =over 4
 
 =item PACKAGE VARIABLES
@@ -12450,6 +16224,8 @@ B<safe_level>, STANDARD, MEDIUM, HIGH
 
 TopSystemUID
 
+B<$KEEP_ALL>, B<$DEBUG>
+
 =over 4
 
 =item WARNING
@@ -12458,6 +16234,10 @@ TopSystemUID
 
 =item Temporary files and NFS
 
+=item Forking
+
+=item BINMODE
+
 =back
 
 =item HISTORY
@@ -12498,8 +16278,6 @@ cacheout EXPR, cacheout MODE, EXPR
 
 =item BUGS
 
-=item NOTES
-
 =back
 
 =head2 FileHandle - supply object methods for filehandles
@@ -12536,16 +16314,16 @@ $fh->print, $fh->printf, $fh->getline, $fh->getlines
 
 =item Filtering only specific components of source code
 
-C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
+C<"code">, C<"code_no_comments">, C<"executable">,
+C<"executable_no_comments">, C<"quotelike">, C<"string">, C<"regex">,
 C<"all">
 
 =item Filtering only the code parts of source code
 
 Most source code ceases to be grammatically correct when it is broken up
 into the pieces between string literals and regexes. So the C<'code'>
-component filter behaves slightly differently from the other partial
-filters
-described in the previous section.
+and C<'code_no_comments'> component filter behave slightly differently
+from the other partial filters described in the previous section.
 
 =item Using Filter::Simple with an explicit C<import> subroutine
 
@@ -12746,8 +16524,8 @@ supplied
 
 =back
 
-=head2 Getopt::Std, getopt - Process single-character switches with switch
-clustering
+=head2 Getopt::Std, getopt, getopts - Process single-character switches
+with switch clustering
 
 =over 4
 
@@ -12835,6 +16613,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
@@ -12849,6 +16630,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
@@ -12989,15 +16790,211 @@ Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
 : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu,
 {zun} : Zuni
 
-=item SEE ALSO
+=item SEE ALSO
+
+=item COPYRIGHT AND DISCLAIMER
+
+=item AUTHOR
+
+=back
+
+=head2 I18N::Langinfo - query locale information
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item EXPORT
+
+=back
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT AND LICENSE
+
+=back
+
+=head2 IO - load various IO modules
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item DEPRECATED
+
+=back
+
+=head2 IO::Dir - supply object methods for directory handles
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
+rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
+=head2 IO::File - supply object methods for filehandles
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONSTRUCTOR
+
+new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
+
+=item METHODS
+
+open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode(
+[LAYER] )
+
+=item NOTE
+
+=item SEE ALSO
+
+=item HISTORY
+
+=back
+
+=head2 IO::Handle - supply object methods for I/O handles
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONSTRUCTOR
+
+new (), new_from_fd ( FD, MODE )
+
+=item METHODS
+
+$io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
+$io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
+$io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
+$io->blocking ( [ BOOL ] ), $io->untaint
+
+=item NOTE
+
+=item SEE ALSO
+
+=item BUGS
+
+=item HISTORY
+
+=back
+
+=head2 IO::Pipe - supply object methods for pipes
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONSTRUCTOR
+
+new ( [READER, WRITER] )
+
+=item METHODS
+
+reader ([ARGS]), writer ([ARGS]), handles ()
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
+=head2 IO::Poll - Object interface to system poll call
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item METHODS
+
+mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
+IO ), handles( [ EVENT_MASK ] )
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
+=head2 IO::Seekable - supply seek based methods for I/O objects
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+$io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
+WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
+$io->tell
+
+=item SEE ALSO
+
+=item HISTORY
+
+=back
+
+=head2 IO::Select - OO interface to the select system call
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONSTRUCTOR
+
+new ( [ HANDLES ] )
+
+=item METHODS
+
+add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
+[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
+count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
 
-=item COPYRIGHT AND DISCLAIMER
+=item EXAMPLE
 
 =item AUTHOR
 
+=item COPYRIGHT
+
 =back
 
-=head2 I18N::Langinfo - query locale information
+=head2 IO::Socket - Object interface to socket communications
 
 =over 4
 
@@ -13005,9 +17002,41 @@ Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
 
 =item DESCRIPTION
 
+=item CONSTRUCTOR
+
+new ( [ARGS] )
+
+=item METHODS
+
+accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
+protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
+=head2 IO::Socket::INET - Object interface for AF_INET domain sockets
+
 =over 4
 
-=item EXPORT
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONSTRUCTOR
+
+new ( [ARGS] )
+
+=over 4
+
+=item METHODS
+
+sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
+()
 
 =back
 
@@ -13015,11 +17044,11 @@ Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
 
 =item AUTHOR
 
-=item COPYRIGHT AND LICENSE
+=item COPYRIGHT
 
 =back
 
-=head2 IO - load various IO modules
+=head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
 
 =over 4
 
@@ -13027,7 +17056,65 @@ Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
 
 =item DESCRIPTION
 
-=item DEPRECATED
+=item CONSTRUCTOR
+
+new ( [ARGS] )
+
+=item METHODS
+
+hostpath(), peerpath()
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
+=head2 IO::Zlib - IO:: style interface to L<Compress::Zlib>
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONSTRUCTOR
+
+new ( [ARGS] )
+
+=item OBJECT METHODS
+
+open ( FILENAME, MODE ), opened, close, getc, getline, getlines, print (
+ARGS... ), read ( BUF, NBYTES, [OFFSET] ), eof, seek ( OFFSET, WHENCE ),
+tell, setpos ( POS ), getpos ( POS )
+
+=item USING THE EXTERNAL GZIP
+
+=item CLASS METHODS
+
+has_Compress_Zlib, gzip_external, gzip_used, gzip_read_open,
+gzip_write_open
+
+=item DIAGNOSTICS
+
+IO::Zlib::getlines: must be called in list context,
+IO::Zlib::gzopen_external: mode '...' is illegal, IO::Zlib::import: '...'
+is illegal, IO::Zlib::import: ':gzip_external' requires an argument,
+IO::Zlib::import: 'gzip_read_open' requires an argument, IO::Zlib::import:
+'gzip_read' '...' is illegal, IO::Zlib::import: 'gzip_write_open' requires
+an argument, IO::Zlib::import: 'gzip_write_open' '...' is illegal,
+IO::Zlib::import: no Compress::Zlib and no external gzip, IO::Zlib::open:
+needs a filename, IO::Zlib::READ: NBYTES must be specified, IO::Zlib::READ:
+OFFSET is not supported, IO::Zlib::WRITE: too long LENGTH, IO::Zlib::WRITE:
+OFFSET is not supported
+
+=item SEE ALSO
+
+=item HISTORY
+
+=item COPYRIGHT
 
 =back
 
@@ -13065,7 +17152,10 @@ new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
 
 =item METHODS
 
-open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
+open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode(
+[LAYER] )
+
+=item NOTE
 
 =item SEE ALSO
 
@@ -13275,6 +17365,28 @@ hostpath(), peerpath()
 
 =back
 
+=head2 IPC::Msg - SysV Msg IPC object class
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item METHODS
+
+new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
+( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
+FLAGS ] ), stat
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
 =head2 IPC::Open2, open2 - open a process for both reading and writing
 
 =over 4
@@ -13302,6 +17414,29 @@ handling
 
 =back
 
+=head2 IPC::Semaphore - SysV Semaphore IPC object class
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item METHODS
+
+new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
+getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
+set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
+, VALUE ), stat
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
 =head2 IPC::SysV - SysV IPC constants
 
 =over 4
@@ -13366,6 +17501,25 @@ set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
 
 =back
 
+=head2 List::Util - A selection of general-utility list subroutines
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+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
+
+=back
+
 =head2 List::Utilib::List::Util, List::Util - A selection of
 general-utility list subroutines
 
@@ -13688,6 +17842,8 @@ Premature end of base64 data, Premature padding of base64 data
 
 =item COPYRIGHT
 
+=item SEE ALSO
+
 =back
 
 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
@@ -13699,10 +17855,31 @@ of quoted-printable strings
 
 =item DESCRIPTION
 
-encode_qp($str), encode_qp($str, $eol), decode_qp($str);
+encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode),
+decode_qp($str);
+
+=item COPYRIGHT
+
+=item SEE ALSO
+
+=back
+
+=head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
+strings
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode),
+decode_qp($str);
 
 =item COPYRIGHT
 
+=item SEE ALSO
+
 =back
 
 =head2 Math::BigFloat - Arbitrary size floating point math package
@@ -13730,9 +17907,15 @@ ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
 
 =back
 
-=item EXAMPLES
+=item METHODS
+
+=over 4
+
+=item accuracy
 
-  # not ready yet
+=item precision()
+
+=back
 
 =item Autocreating constants
 
@@ -13748,7 +17931,7 @@ ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
 
 =item CAVEATS
 
-stringify, bstr(), bdiv, Modifying and =, bpow
+stringify, bstr(), bdiv, Modifying and =, bpow, precision() vs. accuracy()
 
 =item SEE ALSO
 
@@ -13758,7 +17941,7 @@ stringify, bstr(), bdiv, Modifying and =, bpow
 
 =back
 
-=head2 Math::BigInt - Arbitrary size integer math package
+=head2 Math::BigInt - Arbitrary size integer/float math package
 
 =over 4
 
@@ -13792,10 +17975,10 @@ Input, Output
 
 =item is_one()/is_zero()/is_nan()/is_inf()
 
-=item is_positive()/is_negative()
+=item is_pos()/is_neg()
 
-       $x->is_positive();              # true if >= 0
-       $x->is_negative();              # true if <  0
+       $x->is_pos();                   # true if > 0
+       $x->is_neg();                   # true if < 0
 
 =item is_odd()/is_even()/is_int()
 
@@ -13805,7 +17988,7 @@ Input, Output
 
 =item sign
 
-=item bcmp
+=item digit
 
 =item bneg
 
@@ -13873,7 +18056,7 @@ Input, Output
 
 =item copy
 
-=item as_number
+=item as_int
 
 =item bsstr
 
@@ -13902,6 +18085,10 @@ Remarks
 
 =back
 
+=item Infinity and Not a Number
+
+oct()/hex(), log(-inf), exp(), cos(), sin(), atan2()
+
 =item INTERNALS
 
 =over 4
@@ -13949,9 +18136,9 @@ broot() does not work, Out of Memory!, Fails to load Calc on Perl prior
 
 =item CAVEATS
 
-stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
-handling, Modifying and =, bpow, Overloading -$x, Mixing different object
-types, bsqrt(), brsft()
+bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling,
+Modifying and =, bpow, Overloading -$x, Mixing different object types,
+bsqrt(), brsft()
 
 =item LICENSE
 
@@ -13987,8 +18174,7 @@ the same terms as Perl itself.
 
 =back
 
-=head2 Math::BigInt::Scalar - Pure Perl module to test Math::BigInt with
-scalars
+=head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code
 
 =over 4
 
@@ -13996,19 +18182,56 @@ scalars
 
 =item DESCRIPTION
 
+=item METHODS
+
+=over 4
+
+=item __emu_bxor
+
+=item __emu_band
+
+=item __emu_bior
+
+=back
+
 =item LICENSE
 
 This program is free software; you may redistribute it and/or modify it
 under
 the same terms as Perl itself. 
 
-=item AUTHOR
+=item AUTHORS
+
+=item SEE ALSO
+
+=back
+
+=head2 Math::BigInt::FastCalc - Math::BigInt::Calc with some XS for more
+speed
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item STORAGE
+
+=item METHODS
+
+=item LICENSE
+
+This program is free software; you may redistribute it and/or modify it
+under
+the same terms as Perl itself. 
+
+=item AUTHORS
 
 =item SEE ALSO
 
 =back
 
-=head2 Math::BigRat - arbitrarily big rationals
+=head2 Math::BigRat - Arbitrary big rational numbers
 
 =over 4
 
@@ -14036,7 +18259,11 @@ the same terms as Perl itself.
 
 =item parts()
 
-=item as_number()
+=item as_int()
+
+=item as_hex()
+
+=item as_bin()
 
 =item bfac()
 
@@ -14050,9 +18277,9 @@ the same terms as Perl itself.
 
 =item is_zero()
 
-=item is_positive()
+=item is_pos()
 
-=item is_negative()
+=item is_neg()
 
 =item is_int()
 
@@ -14066,6 +18293,10 @@ the same terms as Perl itself.
 
        $x->bfloor();
 
+=item bsqrt()
+
+       $x->bsqrt();
+
 =item config
 
 =back
@@ -14073,7 +18304,8 @@ the same terms as Perl itself.
 =item BUGS
 
 inf handling (partial), NaN handling (partial), rounding (not implemented
-except for bceil/bfloor), $x ** $y where $y is not an integer
+except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(),
+blog(), bmodinv() and bmodpow() (partial)
 
 =item LICENSE
 
@@ -14293,6 +18525,26 @@ Storable use
 
 =back
 
+=head2 Module::CoreList - what modules shipped with versions of perl
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CAVEATS
+
+=item HISTORY
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=item SEE ALSO
+
+=back
+
 =head2 NDBM_File - Tied access to ndbm files
 
 =over 4
@@ -14420,23 +18672,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
 
@@ -14529,14 +18781,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
 
@@ -14593,17 +18846,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
 
@@ -14820,11 +19073,29 @@ lookup ( MACHINE [, LOGIN ])
 
 login (), password (), account (), lpa ()
 
-=item AUTHOR
+=item AUTHOR
+
+=item SEE ALSO
+
+=item COPYRIGHT
+
+=back
+
+=head2 O - Generic interface to Perl Compiler backends
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONVENTIONS
+
+=item IMPLEMENTATION
 
-=item SEE ALSO
+=item BUGS
 
-=item COPYRIGHT
+=item AUTHOR
 
 =back
 
@@ -15081,7 +19352,7 @@ name space
 
 =item DESCRIPTION
 
-unix, stdio, perlio, crlf, utf8, bytes, raw, pop
+:unix, :stdio, :perlio, :crlf, :mmap, :utf8, :bytes, :raw, :pop, :win32
 
 =over 4
 
@@ -15164,6 +19435,8 @@ $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
 
 =item DESCRIPTION
 
+=item REQUIRED MODULES
+
 =item SEE ALSO
 
 =item ACKNOWLEDGEMENTS
@@ -15312,9 +19585,9 @@ C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
 
 =item ARGUMENTS
 
-backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
-infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
-title, verbose
+backlink, cachedir, css, flush, header, help, hiddendirs, htmldir,
+htmlroot, index, infile, libpods, netscape, outfile, podpath, podroot,
+quiet, recurse, title, verbose
 
 =item EXAMPLE
 
@@ -16447,8 +20720,8 @@ documentation
 
 =item ARGUMENTS
 
-C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
-C<-pathlist>
+C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-section>, C<-output>,
+C<-input>, C<-pathlist>
 
 =item DESCRIPTION
 
@@ -16490,6 +20763,59 @@ C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
 
 =back
 
+=head2 Safe - Compile and execute code in restricted compartments
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+a new namespace, an operator mask
+
+=item WARNING
+
+=over 4
+
+=item RECENT CHANGES
+
+=item Methods in class Safe
+
+permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
+...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
+(PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
+root (NAMESPACE), mask (MASK)
+
+=item Some Safety Issues
+
+Memory, CPU, Snooping, Signals, State Changes
+
+=item AUTHOR
+
+=back
+
+=back
+
+=head2 Scalar::Util - A selection of general-utility scalar subroutines
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
+looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
+set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
+
+=item KNOWN BUGS
+
+=item COPYRIGHT
+
+=item BLATANT PLUG
+
+=back
+
 =head2 Search::Dict, look - search for key in dictionary file
 
 =over 4
@@ -16548,10 +20874,16 @@ C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
 
 =over 4
 
-=item OBJECT ORIENTED SYNTAX
+=item Caveats
+
+=item Escaping Magic Characters
+
+=item Configuration
 
 =back
 
+=item BUGS
+
 =item AUTHOR
 
 =back
@@ -16604,7 +20936,7 @@ utf8 data, restricted hashes, files from future versions of Storable
 =item Hooks
 
 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
-I<serialized>, ..
+I<serialized>, .., C<STORABLE_attach> I<class>, I<cloning>, I<serialized>
 
 =item Predicates
 
@@ -16669,7 +21001,7 @@ C<Storable::is_retrieving>
 
 =item BUGS
 
-=item LIMITATION
+=item LIMITATIONS
 
 =item COPYRIGHT
 
@@ -16699,6 +21031,27 @@ C<Storable::is_retrieving>
 
 =back
 
+=head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
+interface to the UNIX syslog(3) calls
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
+setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
+in 5.004_02), closelog
+
+=item EXAMPLES
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=back
+
 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
 Perl interface to the UNIX syslog(3) calls
 
@@ -16869,6 +21222,8 @@ NORMAL TESTS, SKIPPED TESTS, TODO TESTS
 
 =item BUGS and CAVEATS
 
+=item ENVIRONMENT
+
 =item NOTE
 
 =item SEE ALSO
@@ -16895,6 +21250,10 @@ B<new>
 
 =back
 
+B<create>
+
+B<reset>
+
 =over 4
 
 =item Setting up tests
@@ -16961,6 +21320,8 @@ B<diag>
 
 B<_print>
 
+B<_print_diag>
+
 B<output>, B<failure_output>, B<todo_output>
 
 =over 4
@@ -16987,6 +21348,8 @@ B<_my_exit>
 
 =over 4
 
+=item EXIT CODES
+
 =item THREADS
 
 =item EXAMPLES
@@ -16999,27 +21362,28 @@ B<_my_exit>
 
 =back
 
-=head2 Test::Harness - run perl standard test scripts with statistics
+=head2 Test::Harness - Run Perl standard test scripts with statistics
 
 =over 4
 
-=item SYNOPSIS
+=item VERSION
 
-=item DESCRIPTION
+=back
 
 =over 4
 
-=item The test script output
+=item SYNOPSIS
+
+=item DESCRIPTION
 
-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>
+=over 4
 
 =item Taint mode
 
 =item Configuration variables.
 
-B<$Test::Harness::verbose>, B<$Test::Harness::switches>
+C<$Test::Harness::Verbose>, C<$Test::Harness::switches>,
+C<$Test::Harness::Timer>
 
 =item Failure
 
@@ -17055,24 +21419,28 @@ C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
 %s>, C<FAILED--Further testing stopped: %s>
 
-=item ENVIRONMENT
+=item ENVIRONMENT VARIABLES THAT TEST::HARNESS SETS
+
+C<HARNESS_ACTIVE>, C<HARNESS_VERSION>
 
-C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
+=item ENVIRONMENT VARIABLES THAT AFFECT TEST::HARNESS
+
+C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>, C<HARNESS_DEBUG>,
 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
-C<HARNESS_OK_SLOW>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
+C<HARNESS_PERL>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
 
 =item EXAMPLE
 
 =item SEE ALSO
 
-=item AUTHORS
-
-=item LICENSE
-
 =item TODO
 
 =item BUGS
 
+=item AUTHORS
+
+=item COPYRIGHT
+
 =back
 
 =head2 Test::Harness::Assert - simple assert
@@ -17083,11 +21451,11 @@ C<HARNESS_OK_SLOW>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
 
 =item DESCRIPTION
 
-=over 4
+=item FUNCTIONS
 
-=item Functions
+=over 4
 
-B<assert>
+=item C<assert()>
 
 =back
 
@@ -17109,6 +21477,44 @@ B<assert>
 
 =item DESCRIPTION
 
+=over 4
+
+=item new()
+
+=item next()
+
+=back
+
+=back
+
+=head2 Test::Harness::Point - object for tracking a single test point
+
+=over 4
+
+=item SYNOPSIS
+
+=item CONSTRUCTION
+
+=over 4
+
+=item new()
+
+=back
+
+=back
+
+=over 4
+
+=item from_test_line( $line )
+
+=back
+
+=over 4
+
+=item ACCESSORS
+
+ok, number
+
 =back
 
 =head2 Test::Harness::Straps - detailed analysis of test results
@@ -17119,11 +21525,11 @@ B<assert>
 
 =item DESCRIPTION
 
-=item Construction
+=item CONSTRUCTION
 
 =over 4
 
-=item C<new>
+=item new()
 
 =back
 
@@ -17131,17 +21537,17 @@ B<assert>
 
 =over 4
 
-=item C<_init>
+=item $strap->_init
 
 =back
 
 =over 4
 
-=item Analysis
+=item ANALYSIS
 
 =over 4
 
-=item C<analyze>
+=item $strap->analyze( $name, \@output_lines )
 
 =back
 
@@ -17149,61 +21555,73 @@ B<assert>
 
 =over 4
 
-=item C<analyze_fh>
+=item $strap->analyze_fh( $name, $test_filehandle )
 
 =back
 
 =over 4
 
-=item C<analyze_file>
+=item $strap->analyze_file( $test_file )
 
 =back
 
 =over 4
 
-=item C<_switches>
+=item $strap->_command_line( $file )
 
 =back
 
 =over 4
 
-=item C<_INC2PERL5LIB>
+=item $strap->_command()
 
 =back
 
 =over 4
 
-=item C<_filtered_INC>
+=item $strap->_switches( $file )
 
 =back
 
 =over 4
 
-=item C<_restore_PERL5LIB>
+=item $strap->_cleaned_switches( @switches_from_user )
 
 =back
 
 =over 4
 
-=item Parsing
+=item $strap->_INC2PERL5LIB
+
+=back
 
 =over 4
 
-=item C<_is_comment>
+=item $strap->_filtered_INC()
 
 =back
 
+=over 4
+
+=item $strap->_restore_PERL5LIB()
+
 =back
 
 =over 4
 
-=item C<_is_header>
+=item Parsing
+
+=over 4
+
+=item C<_is_diagnostic>
+
+=back
 
 =back
 
 =over 4
 
-=item C<_is_test>
+=item C<_is_header>
 
 =back
 
@@ -17223,21 +21641,87 @@ B<assert>
 
 =item Results
 
+=item EXAMPLES
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
+=head2 Test::Harness::TAP - Documentation for the TAP format
+
+=over 4
+
+=item SYNOPSIS
+
+=item TODO
+
+=item THE TAP FORMAT
+
+=item HARNESS BEHAVIOR
+
+=item TESTS LINES AND THE PLAN
+
 =over 4
 
-=item C<_detailize>
+=item The plan
+
+=item The test line
+
+C<ok> or C<not ok>, Test number, Description, Directive, ok/not ok
+(required), Test number (recommended), Description (recommended), Directive
+(only when necessary)
 
 =back
 
+=item DIRECTIVES
+
+=over 4
+
+=item TODO tests
+
+=item Skipping tests
+
 =back
 
+=item OTHER LINES
+
 =over 4
 
+=item Bail out!
+
+=item Diagnostics
+
+=item Anything else
+
+=back
+
 =item EXAMPLES
 
-=item AUTHOR
+=over 4
 
-=item SEE ALSO
+=item Common with explanation
+
+=item Unknown amount and failures
+
+=item Giving up
+
+=item Skipping a few
+
+=item Skipping everything
+
+=item Got spare tuits?
+
+=item Creative liberties
+
+=back
+
+=item AUTHORS
+
+=item ACKNOWLEDGEMENTS
+
+=item COPYRIGHT
 
 =back
 
@@ -17313,14 +21797,20 @@ When do I use SKIP vs. TODO?
 
 =over 4
 
-=item Comparison functions
+=item Complex data structures
 
 B<is_deeply>
 
 =back
 
+=over 4
+
+=item Discouraged comparison functions
+
 B<eq_array>
 
+=back
+
 B<eq_hash>
 
 B<eq_set>
@@ -17335,12 +21825,11 @@ B<builder>
 
 =over 4
 
-=item NOTES
+=item EXIT CODES
 
-=item BUGS and CAVEATS
+=item CAVEATS and NOTES
 
-Making your own ok(), The eq_* family has some caveats, Test::Harness
-upgrades
+Backwards compatibility, Overloaded objects, Threads, Test::Harness upgrade
 
 =item HISTORY
 
@@ -17348,6 +21837,8 @@ upgrades
 
 =item AUTHORS
 
+=item BUGS
+
 =item COPYRIGHT
 
 =back
@@ -17769,13 +22260,14 @@ tied hashes
 =item DESCRIPTION
 
 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
-this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
+this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR
+this, SCALAR this
 
 =item Inheriting from B<Tie::StdHash>
 
 =item Inheriting from B<Tie::ExtraHash>
 
-=item C<UNTIE> and C<DESTROY>
+=item C<SCALAR>, C<UNTIE> and C<DESTROY>
 
 =item MORE INFORMATION
 
@@ -17853,11 +22345,11 @@ timers
 
 =item DESCRIPTION
 
-gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
-$interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
-alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer (
-$which, $floating_seconds [, $interval_floating_seconds ] ), getitimer (
-$which )
+gettimeofday (), usleep ( $useconds ), nanosleep ( $nanoseconds ), ualarm (
+$useconds [, $interval_useconds ] ), tv_interval, time (), sleep (
+$floating_seconds ), alarm ( $floating_seconds [,
+$interval_floating_seconds ] ), setitimer ( $which, $floating_seconds [,
+$interval_floating_seconds ] ), getitimer ( $which )
 
 =item EXAMPLES
 
@@ -17875,6 +22367,8 @@ $which )
 
 =item CAVEATS
 
+=item SEE ALSO
+
 =item AUTHORS
 
 =item COPYRIGHT AND LICENSE
@@ -17889,6 +22383,16 @@ $which )
 
 =item DESCRIPTION
 
+=over 4
+
+=item Ambiguous Local Times (DST)
+
+=item Non-Existent Local Times (DST)
+
+=item Negative Epoch Values
+
+=back
+
 =item IMPLEMENTATION
 
 =item BUGS
@@ -17969,9 +22473,10 @@ CLASS->can( METHOD ) >>, C<can( VAL, METHOD )>, C<VERSION ( [ REQUIRE ] )>
 
 =item Constructor and Tailoring
 
-UCA_Version, alternate, backwards, entry, ignoreName, ignoreChar, level,
-normalization, overrideCJK, overrideHangul, preprocess, rearrange, table,
-undefName, undefChar, katakana_before_hiragana, upper_before_lower
+UCA_Version, alternate, backwards, entry, hangul_terminator, ignoreChar,
+ignoreName, katakana_before_hiragana, level, normalization, overrideCJK,
+overrideHangul, preprocess, rearrange, table, undefChar, undefName,
+upper_before_lower, variable
 
 =item Methods for Collation
 
@@ -17995,26 +22500,26 @@ $Collator-E<gt>gsubst($string, $substring, $replacement)>
 
 =item Other Methods
 
-C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, UCA_Version,
-Base_Unicode_Version
+C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, C<$version =
+$Collator-E<gt>version()>, C<UCA_Version()>, C<Base_Unicode_Version()>
+
+=back
 
 =item EXPORT
 
-=item CAVEAT
+=item INSTALL
 
-=item Conformance Test
+=item CAVEATS
 
-=back
+Normalization, Conformance Test
 
-=item AUTHOR
+=item AUTHOR, COPYRIGHT AND LICENSE
 
 =item SEE ALSO
 
-http://www.unicode.org/reports/tr10/,
-http://www.unicode.org/reports/tr10/allkeys.txt,
-http://www.unicode.org/reports/tr10/CollationTest.html
-http://www.unicode.org/reports/tr10/CollationTest.zip,
-http://www.unicode.org/reports/tr15/, L<Unicode::Normalize>
+Unicode Collation Algorithm - UTS #10, The Default Unicode Collation
+Element Table (DUCET), The conformance test for the UCA, Hangul Syllable
+Type, Unicode Normalization Forms - UAX #15
 
 =back
 
@@ -18032,6 +22537,7 @@ http://www.unicode.org/reports/tr15/, L<Unicode::Normalize>
 
 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
+C<$FCD_string = FCD($string)>, C<$FCC_string = FCC($string)>,
 C<$normalized_string = normalize($form_name, $string)>
 
 =item Decomposition and Composition
@@ -18044,6 +22550,7 @@ reorder($string)>, C<$composed_string   = compose($string)>
 
 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
+checkFCD($string)>, C<$result = checkFCC($string)>, C<$result =
 check($form_name, $string)>
 
 =item Character Data
@@ -18056,16 +22563,23 @@ isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
 C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>,
 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
 
+=back
+
 =item EXPORT
 
-=back
+=item CAVEATS
+
+Perl's version vs. Unicode version, Correction of decomposition mapping,
+Revised definition of canonical composition
 
 =item AUTHOR
 
 =item SEE ALSO
 
-http://www.unicode.org/unicode/reports/tr15/,
-http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt
+http://www.unicode.org/reports/tr15/,
+http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt,
+http://www.unicode.org/Public/UNIDATA/NormalizationCorrections.txt,
+http://www.unicode.org/review/pr-29.html, http://www.unicode.org/notes/tn5/
 
 =back
 
@@ -18141,6 +22655,12 @@ http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt
 
 =over 4
 
+=item namedseq()
+
+=back
+
+=over 4
+
 =item Unicode::UCD::UnicodeVersion
 
 =back
@@ -18199,37 +22719,34 @@ March 18th, 2000
 
 =back
 
-=head2 Win32 - Interfaces to some Win32 API Functions
+=head2 XSLoader - Dynamically load C libraries into Perl code
 
 =over 4
 
+=item SYNOPSIS
+
 =item DESCRIPTION
 
 =over 4
 
-=item Alphabetical Listing of Win32 Functions
+=item Migration from C<DynaLoader>
+
+=item Backward compatible boilerplate
+
+=back
+
+=item Order of initialization: early load()
+
+=over 4
 
-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)
+=item The most hairy case
 
 =back
 
+=item LIMITATIONS
+
+=item AUTHOR
+
 =back
 
 =head1 AUXILIARY DOCUMENTATION