Re: [PATCH] Re: INSTALLSCRIPT versus INSTALLDIRS
[p5sagit/p5-mst-13.2.git] / pod / perltoc.pod
index c2ac02d..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.14 $, $Date:
-2003/11/23 08:02:29 $)
+=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.25 $,
-$Date: 2003/10/16 04:57:38 $)
+=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.37 $, $Date: 2003/11/24
-19:55:50 $)
+=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.54 $, $Date: 2003/11/30
-00:50:08 $)
+=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.30 $, $Date: 2003/11/23
-08:07: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
@@ -1836,6 +1867,8 @@ regular expressions
 
 =item Constant Folding
 
+=item No-ops
+
 =item Bitwise String Operators
 
 =item Integer Arithmetic
@@ -1943,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,
@@ -2091,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
@@ -2131,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
@@ -2248,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
 
@@ -2263,7 +2302,8 @@ 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,
+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)
@@ -2402,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
 
@@ -3127,9 +3168,6 @@ portable
 
 =item CPAN Testers
 
-Mailing list: cpan-testers@perl.org, Testing results:
-http://testers.cpan.org/
-
 =item PLATFORMS
 
 =over 4
@@ -3158,42 +3196,21 @@ http://testers.cpan.org/
 
 =item Alphabetical Listing of Perl Functions
 
--I<X> FILEHANDLE, -I<X> EXPR, -I<X>, 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
 
@@ -3360,8 +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, C<use encoding> needed to upgrade
-non-Latin-1 byte strings
+enable UTF-8/UTF-EBCDIC in scripts, BOM-marked scripts and UTF-16 scripts
+autodetected, C<use encoding> needed to upgrade non-Latin-1 byte strings
 
 =item Byte and Character Semantics
 
@@ -3605,56 +3622,63 @@ 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,
-Digest::base, DirHandle, Dumpvalue, DynaLoader, Encode, Encode::Alias,
-Encode::Byte, Encode::CJKConstants, Encode::CN, Encode::CN::HZ,
-Encode::Config, Encode::EBCDIC, Encode::Encoder, Encode::Encoding,
-Encode::Guess, Encode::JP, Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR,
-Encode::KR::2022_KR, Encode::MIME::Header, Encode::PerlIO,
-Encode::Supported, Encode::Symbol, Encode::TW, Encode::Unicode,
-Encode::Unicode::UTF7, English, Env, Errno, Exporter, Exporter::Heavy,
+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::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,
+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,
@@ -3669,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
 
@@ -3892,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
 
@@ -4025,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
@@ -4242,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
@@ -4501,8 +4621,12 @@ A, p, d, s, n, r, f, M, o, x, m, X, E, b
 
 =item Pointer-To-Integer and Integer-To-Pointer
 
+=item Exception Handling
+
 =item Source Documentation
 
+=item Backwards compatibility
+
 =back
 
 =item Unicode Support
@@ -4631,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
 
@@ -4648,7 +4772,7 @@ perl_clone
 
 =item CV Manipulation Functions
 
-CvSTASH, get_cv, Nullcv
+CvSTASH, get_cv
 
 =item Embedding Functions
 
@@ -4666,37 +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_assert, hv_clear, hv_clear_placeholders, hv_delete,
-hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
+get_hv, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force,
+HeSVKEY_set, HeVAL, HvNAME, hv_assert, hv_clear, hv_clear_placeholders,
+hv_delete, hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
 hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv,
 hv_iternext_flags, hv_iterval, hv_magic, hv_scalar, hv_store, hv_store_ent,
-hv_undef, newHV, Nullhv
+hv_undef, newHV
 
 =item Magical Functions
 
 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
-SvSetSV, SvSetSV_nosteal, SvSHARE
+SvSetSV, SvSetSV_nosteal, SvSHARE, SvUNLOCK
 
 =item Memory Management
 
-Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree,
-savepv, savepvn, savesharedpv, StructCopy, Zero
+Copy, CopyD, Move, MoveD, New, Newc, Newz, Poison, Renew, Renewc, Safefree,
+savepv, savepvn, savesharedpv, 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
 
@@ -4711,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
 
@@ -4726,53 +4856,57 @@ 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, SvIV_nomg, SvLEN, SvNIOK, SvNIOKp,
-SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX,
-SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only,
-SvPOK_only_UTF8, SvPV, SvPVbyte, SvPVbytex, SvPVbytex_force,
-SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, SvPVutf8x, SvPVutf8x_force,
-SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX, SvPV_force, SvPV_force_nomg,
-SvPV_nolen, SvPV_nomg, 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, SvUV_nomg, SvVOK, sv_2bool,
+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_catpv_mg, sv_catsv,
-sv_catsv_flags, sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale,
-sv_collxfrm, sv_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal,
-sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, sv_insert,
-sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, sv_magicext,
-sv_mortalcopy, sv_newmortal, sv_newref, sv_nv, sv_pos_b2u, sv_pos_u2b,
-sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force,
-sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype,
-sv_replace, sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg,
-sv_setnv, sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv,
-sv_setpviv_mg, sv_setpvn, sv_setpvn_mg, sv_setpv_mg, sv_setref_iv,
-sv_setref_nv, sv_setref_pv, sv_setref_pvn, sv_setref_uv, sv_setsv,
-sv_setsv_flags, sv_setsv_mg, sv_setuv, sv_setuv_mg, sv_taint, sv_tainted,
-sv_true, sv_unmagic, sv_unref, 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_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,
+sv_magic, sv_magicext, sv_mortalcopy, sv_newmortal, sv_newref, sv_nv,
+sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force,
+sv_pvn, sv_pvn_force, sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n,
+sv_pvutf8n_force, sv_reftype, sv_replace, sv_report_used, sv_reset,
+sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv,
+sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn,
+sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv,
+sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg,
+sv_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
 
@@ -4798,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_SET_CUR_NOSAVE, 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
 
@@ -4814,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,
@@ -4833,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
 
@@ -4973,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
@@ -4986,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
 
@@ -5028,11 +5170,12 @@ t/cmd t/run t/io t/op, t/lib ext lib
 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, test_harness
+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
 
@@ -5095,424 +5238,385 @@ 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
-
-=over 4
-
-=item PUMPKIN?
-
-=back
-
-=item THE RECORDS
+=item Incompatible Changes
 
 =over 4
 
-=item SELECTED RELEASE SIZES
-
-=item SELECTED PATCH SIZES
-
-=back
+=item substr() lvalues are no longer fixed-length
 
-=item THE KEEPERS OF THE RECORDS
+=item The C<:unique> attribute is only meaningful for globals
 
 =back
 
-=head2 perl591delta, perldelta - what is new for perl v5.9.1
-
-=over 4
-
-=item DESCRIPTION
-
-=item Incompatible Changes
-
 =item Core Enhancements
 
 =over 4
@@ -5523,15 +5627,13 @@ B<-V>
 
 =item Formats
 
-=item The C<:unique> attribute is only meaningful for globals
-
 =item Stacked filetest operators
 
 =back
 
 =item Modules and Pragmata
 
-Carp, Exporter, FindBin, List::Util, threads::shared
+Benchmark, Carp, Exporter, FindBin, List::Util, threads::shared
 
 =item Utility Changes
 
@@ -5539,13 +5641,11 @@ Carp, Exporter, FindBin, List::Util, threads::shared
 
 =item Performance Enhancements
 
-=item Installation and Configuration Improvements
-
 =item Selected Bug Fixes
 
 =over 4
 
-=item UTF8 bugs
+=item UTF-8 bugs
 
 =item Threading bugs
 
@@ -5557,14 +5657,30 @@ Carp, Exporter, FindBin, List::Util, threads::shared
 
 =item Changed Internals
 
-=item Configuration and Building
+=over 4
 
-=item New Tests
+=item Reordering of SVt_* constants
+
+=item Removal of CPP symbols
+
+=item Less space is used by ops
+
+=item New parser
+
+=back
+
+=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
@@ -5732,7 +5848,7 @@ Win32::GetOSVersion
 
 =back
 
-=head2 perl583delta - what is new for perl v5.8.3
+=head2 perl587delta, perldelta - what is new for perl v5.8.7
 
 =over 4
 
@@ -5742,15 +5858,29 @@ Win32::GetOSVersion
 
 =item Core Enhancements
 
-=item Modules and Pragmata
+=over 4
 
-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 Unicode Character Database 4.1.0
+
+=item suidperl less insecure
+
+=item Optional site customization script
+
+=item C<Config.pm> is now much smaller.
+
+=back
+
+=item Modules and Pragmata
 
 =item Utility Changes
 
-=item New Documentation
+=over 4
+
+=item find2perl enhancements
+
+=back
+
+=item Performance Enhancements
 
 =item Installation and Configuration Improvements
 
@@ -5760,15 +5890,9 @@ Unicode::Normalize, Test::Harness, threads::shared
 
 =item Changed Internals
 
-=item Configuration and Building
-
-=item Platform Specific Problems
-
 =item Known Problems
 
-=item Future Directions
-
-=item Obituary
+=item Platform Specific Problems
 
 =item Reporting Bugs
 
@@ -5776,7 +5900,7 @@ Unicode::Normalize, Test::Harness, threads::shared
 
 =back
 
-=head2 perl582delta - what is new for perl v5.8.2
+=head2 perl586delta - what is new for perl v5.8.6
 
 =over 4
 
@@ -5786,11 +5910,183 @@ Unicode::Normalize, Test::Harness, threads::shared
 
 =item Core Enhancements
 
-=over 4
+=item Modules and Pragmata
 
-=item Hash Randomisation
+=item Utility Changes
 
-=item Threading
+=item Performance Enhancements
+
+=item Selected Bug Fixes
+
+=item New or Changed Diagnostics
+
+=item Changed Internals
+
+=item New Tests
+
+=item Reporting Bugs
+
+=item SEE ALSO
+
+=back
+
+=head2 perl585delta - what is new for perl v5.8.5
+
+=over 4
+
+=item DESCRIPTION
+
+=item Incompatible Changes
+
+=item Core Enhancements
+
+=item Modules and Pragmata
+
+=item Utility Changes
+
+=over 4
+
+=item Perl's debugger
+
+=item h2ph
+
+=back
+
+=item Installation and Configuration Improvements
+
+=item Selected Bug Fixes
+
+=item New or Changed Diagnostics
+
+=item Changed Internals
+
+=item Known Problems
+
+=item Platform Specific Problems
+
+=item Reporting Bugs
+
+=item SEE ALSO
+
+=back
+
+=head2 perl584delta - what is new for perl v5.8.4
+
+=over 4
+
+=item DESCRIPTION
+
+=item Incompatible Changes
+
+=item Core Enhancements
+
+=over 4
+
+=item Malloc wrapping
+
+=item Unicode Character Database 4.0.1
+
+=item suidperl less insecure
+
+=item format
+
+=back
+
+=item Modules and Pragmata
+
+=over 4
+
+=item Updated modules
+
+Attribute::Handlers, B, Benchmark, CGI, Carp, Cwd, Exporter, File::Find,
+IO, IPC::Open3, Local::Maketext, Math::BigFloat, Math::BigInt,
+Math::BigRat, MIME::Base64, ODBM_File, POSIX, Shell, Socket, Storable,
+Switch, Sys::Syslog, Term::ANSIColor, Time::HiRes, Unicode::UCD, Win32,
+base, open, threads, utf8
+
+=back
+
+=item Performance Enhancements
+
+=item Utility Changes
+
+=item Installation and Configuration Improvements
+
+=item Selected Bug Fixes
+
+=item New or Changed Diagnostics
+
+=item Changed Internals
+
+=item Future Directions
+
+=item Platform Specific Problems
+
+=item Reporting Bugs
+
+=item SEE ALSO
+
+=back
+
+=head2 perl583delta - what is new for perl v5.8.3
+
+=over 4
+
+=item DESCRIPTION
+
+=item Incompatible Changes
+
+=item Core Enhancements
+
+=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 perl582delta - what is new for perl v5.8.2
+
+=over 4
+
+=item DESCRIPTION
+
+=item Incompatible Changes
+
+=item Core Enhancements
+
+=over 4
+
+=item Hash Randomisation
+
+=item Threading
 
 =back
 
@@ -7767,164 +8063,145 @@ a), b), c), d), a), b), c), d)
 
 =back
 
-=head1 PRAGMA DOCUMENTATION
-
-=head2 attrs - set/get attributes of a subroutine (deprecated)
+=head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
 
 =over 4
 
-=item SYNOPSIS
-
 =item DESCRIPTION
 
-method, locked
-
-=back
-
-=head2 re - Perl pragma to alter regular expression behaviour
-
 =over 4
 
-=item SYNOPSIS
-
-=item DESCRIPTION
+=item Compiling Perl 5 on AIX
 
-=back
+=item OS level
 
-=head2 threadshared::shared, threads::shared - Perl extension for sharing
-data structures between threads
+=item Building Dynamic Extensions on AIX
 
-=over 4
+=item The IBM ANSI C Compiler
 
-=item SYNOPSIS
+=item The usenm option
 
-=item DESCRIPTION
+=item Using GNU's gcc for building perl
 
-=item EXPORT
+=item Using Large Files with Perl
 
-=item FUNCTIONS
+=item Threaded Perl
 
-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 64-bit Perl
 
-=item NOTES
+=item AIX 4.2 and extensions using C++ with statics
 
-=item BUGS
+=back
 
 =item AUTHOR
 
-=item SEE ALSO
+=item DATE
 
 =back
 
-=head2 threads - Perl extension allowing use of interpreter based threads
-from perl
+=head2 perlamiga - Perl under Amiga OS
 
 =over 4
 
-=item SYNOPSIS
+=item NOTE
 
-=item DESCRIPTION
+=item SYNOPSIS
 
-$thread = threads->create(function, LIST), $thread->join, $thread->detach,
-threads->self, $thread->tid, threads->object( tid ), threads->yield();,
-threads->list();, async BLOCK;
+=back
 
-=item WARNINGS
+=over 4
 
-A thread exited while %d other threads were still running
+=item DESCRIPTION
 
-=item TODO
+=over 4
 
-=item BUGS
+=item Prerequisites for Compiling Perl on AmigaOS
 
-Parent-Child threads, Returning objects, Creating threads inside BEGIN
-blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
+B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
 
-=item AUTHOR and COPYRIGHT
+=item Starting Perl programs under AmigaOS
 
-=item SEE ALSO
+=item Shortcomings of Perl under AmigaOS
 
 =back
 
-=head2 assertions - select assertions in blocks of code
+=item INSTALLATION
 
-=over 4
+=item Accessing documentation
 
-=item SYNOPSIS
+=over 4
 
-=item DESCRIPTION
+=item Manpages for Perl on AmigaOS
 
-=item SEE ALSO
+=item Perl HTML Documentation on AmigaOS
 
-=item AUTHOR
+=item Perl GNU Info Files on AmigaOS
 
-=item COPYRIGHT AND LICENSE
+=item Perl LaTeX Documentation on AmigaOS
 
 =back
 
-=head2 assertions::activate - activate assertions
+=item BUILDING PERL ON AMIGAOS
 
 =over 4
 
-=item SYNOPSIS
+=item Build Prerequisites for Perl on AmigaOS
 
-=item DESCRIPTION
+=item Getting the Perl Source for AmigaOS
 
-=item SEE ALSO
+=item Making Perl on AmigaOS
 
-=item AUTHOR
+=item Testing Perl on AmigaOS
 
-=item COPYRIGHT AND LICENSE
+=item Installing the built Perl on AmigaOS
 
 =back
 
-=head2 attributes - get/set subroutine or variable attributes
-
-=over 4
+=item PERL 5.8.0 BROKEN IN AMIGAOS
 
-=item SYNOPSIS
+=item AUTHORS
 
-=item DESCRIPTION
+=item SEE ALSO
 
-=over 4
+=back
 
-=item Built-in Attributes
+=head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
 
-locked, method, lvalue
+=over 4
 
-=item Available Subroutines
+=item DESCRIPTION
 
-get, reftype
+=item AUTHOR
 
-=item Package-specific Attribute Handling
+=back
 
-FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
+=head2 perlbeos, README.beos - Perl version 5.8+ on BeOS
 
-=item Syntax of Attribute Lists
+=over 4
 
-=back
+=item DESCRIPTION
 
-=item EXPORTS
+=item BUILD AND INSTALL
 
 =over 4
 
-=item Default exports
+=item Requirements
 
-=item Available exports
+=item Configure
 
-=item Export tags defined
+=item Build
+
+=item Install
 
 =back
 
-=item EXAMPLES
+=item KNOWN PROBLEMS
 
-=item SEE ALSO
+=item CONTACT
 
 =back
 
-=head2 autouse - postpone load of modules until a function is used
+=head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
 
 =over 4
 
@@ -7932,177 +8209,198 @@ FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
 
 =item DESCRIPTION
 
-=item WARNING
+=over 4
 
-=item AUTHOR
+=item gzip on BS2000
 
-=item SEE ALSO
+=item bison on BS2000
 
-=back
+=item Unpacking Perl Distribution on BS2000
 
-=head2 base - Establish IS-A relationship with base classes at compile time
+=item Compiling Perl on BS2000
 
-=over 4
+=item Testing Perl on BS2000
 
-=item SYNOPSIS
+=item Installing Perl on BS2000
 
-=item DESCRIPTION
+=item Using Perl in the Posix-Shell of BS2000
 
-=item HISTORY
+=item Using Perl in "native" BS2000
 
-=item CAVEATS
+=item Floating point anomalies on BS2000
 
-=item SEE ALSO
+=item Using PerlIO and different encodings on ASCII and EBCDIC partitions
 
 =back
 
-=head2 bigint - Transparent BigInteger support for Perl
+=item AUTHORS
+
+=item SEE ALSO
 
 =over 4
 
-=item SYNOPSIS
+=item Mailing list
 
-=item DESCRIPTION
+=back
 
-=over 4
+=item HISTORY
 
-=item OPTIONS
+=back
 
-a or accuracy, p or precision, t or trace, l or lib, v or version
+=head2 perlce - Perl for WinCE
 
-=item MATH LIBRARY
+=over 4
 
-=item INTERNAL FORMAT
+=item DESCRIPTION
 
-=item SIGN
+=item BUILD
 
-=item METHODS
+=over 4
 
-=item CAVEAT
+=item Tools & SDK
 
-=back
+Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's
+celib-sources, Rainer Keuchel's console-sources
 
-=item MODULES USED
+=item Make
 
-=item EXAMPLES
+go to ./wince subdirectory, edit file compile.bat, run   compile.bat, run 
+  compile.bat dist
 
-=item LICENSE
+=back
 
-=item SEE ALSO
+=item ACKNOWLEDGEMENTS
 
 =item AUTHORS
 
 =back
 
-=head2 bignum - Transparent BigNumber support for Perl
+=head2 perlcygwin, README.cygwin - Perl for Cygwin
 
 =over 4
 
 =item SYNOPSIS
 
-=item DESCRIPTION
+=item PREREQUISITES FOR COMPILING PERL ON CYGWIN
 
 =over 4
 
-=item OPTIONS
-
-a or accuracy, p or precision, t or trace, l or lib, v or version
+=item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
 
-=item METHODS
+=item Cygwin Configuration
 
-=item CAVEAT
+C<PATH>, I<nroff>, Permissions
 
-inf(), NaN(), upgrade()
+=back
 
-=item MATH LIBRARY
+=item CONFIGURE PERL ON CYGWIN
 
-=item INTERNAL FORMAT
+=over 4
 
-=item SIGN
+=item Stripping Perl Binaries on Cygwin
 
-=back
+=item Optional Libraries for Perl on Cygwin
 
-=item MODULES USED
+C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
+C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
 
-=item EXAMPLES
+=item Configure-time Options for Perl on Cygwin
 
-=item LICENSE
+C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
+C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
+C<-Dmksymlinks>
 
-=item SEE ALSO
+=item Suspicious Warnings on Cygwin
 
-=item AUTHORS
+I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
 
 =back
 
-=head2 bigrat - Transparent BigNumber/BigRational support for Perl
+=item MAKE ON CYGWIN
 
 =over 4
 
-=item SYNOPSIS
+=item Errors on Cygwin
 
-=item DESCRIPTION
+=item ld2 on Cygwin
+
+=back
+
+=item TEST ON CYGWIN
 
 =over 4
 
-=item MODULES USED
+=item File Permissions on Cygwin
 
-=item MATH LIBRARY
+=item NDBM_File and ODBM_File do not work on FAT filesystems
 
-=item SIGN
+=item C<fork()> failures in io_* tests
 
-=item METHODS
+=back
 
-=item CAVEAT
+=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 EXAMPLES
+=item INSTALL PERL ON CYGWIN
 
-       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 MANIFEST ON CYGWIN
 
-=item LICENSE
+Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
+Source, Compiled Module Source, Perl Modules/Scripts
 
-=item SEE ALSO
+=item BUGS ON CYGWIN
 
 =item AUTHORS
 
+=item HISTORY
+
 =back
 
-=head2 blib - Use MakeMaker's uninstalled version of a package
+=head2 perldgux - Perl under DG/UX.
 
 =over 4
 
 =item SYNOPSIS
 
+=back
+
+=over 4
+
 =item DESCRIPTION
 
-=item BUGS
+=item BUILDING PERL ON DG/UX
 
-=item AUTHOR
+=over 4
 
-=back
+=item Non-threaded Perl on DG/UX
 
-=head2 bytes - Perl pragma to force byte semantics rather than character
-semantics
+=item Threaded Perl on DG/UX
 
-=over 4
+=item Testing Perl on DG/UX
 
-=item SYNOPSIS
+=item Installing the built perl on DG/UX
 
-=item DESCRIPTION
+=back
 
-=item LIMITATIONS
+=item AUTHOR
 
 =item SEE ALSO
 
 =back
 
-=head2 charnames - define character names for C<\N{named}> string literal
-escapes
+=head2 perldos - Perl under DOS, W31, W95.
 
 =over 4
 
@@ -8110,205 +8408,227 @@ escapes
 
 =item DESCRIPTION
 
-=item CUSTOM TRANSLATORS
+=over 4
 
-=item CUSTOM ALIASES
+=item Prerequisites for Compiling Perl on DOS
 
-=over 4
+DJGPP, Pthreads
 
-=item Anonymous hashes
+=item Shortcomings of Perl under DOS
 
-=item Alias file
+=item Building Perl on DOS
 
-=item Alias shortcut
+=item Testing Perl on DOS
+
+=item Installation of Perl on DOS
 
 =back
 
-=item charnames::viacode(code)
+=item BUILDING AND INSTALLING MODULES ON DOS
 
-=item charnames::vianame(name)
+=over 4
 
-=item ALIASES
+=item Building Prerequisites for Perl on DOS
 
-=item ILLEGAL CHARACTERS
+=item Unpacking CPAN Modules on DOS
 
-=item BUGS
+=item Building Non-XS Modules on DOS
+
+=item Building XS Modules on DOS
 
 =back
 
-=head2 constant - Perl pragma to declare constants
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
+=head2 perlepoc, README.epoc - Perl for EPOC
 
 =over 4
 
 =item SYNOPSIS
 
-=item DESCRIPTION
+=item INTRODUCTION
 
-=item NOTES
+=item INSTALLING PERL ON EPOC
+
+=item STARTING PERL ON EPOC
 
 =over 4
 
-=item List constants
+=item Editors on Epoc
 
-=item Defining multiple constants at once
+=item Features of Perl on Epoc
 
-=item Magic constants
+=item Restrictions of Perl on Epoc
 
-=back
+=item Compiling Perl 5 on the EPOC cross compiling environment
 
-=item TECHNICAL NOTES
+=back
 
-=item BUGS
+=item SUPPORT STATUS OF PERL ON EPOC
 
 =item AUTHOR
 
-=item COPYRIGHT
+=item LAST UPDATE
 
 =back
 
-=head2 diagnostics, splain - produce verbose warning diagnostics
+=head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
 
 =over 4
 
-=item SYNOPSIS
-
 =item DESCRIPTION
 
 =over 4
 
-=item The C<diagnostics> Pragma
-
-=item The I<splain> Program
-
-=back
+=item FreeBSD core dumps from readdir_r with ithreads
 
-=item EXAMPLES
+=item $^X doesn't always contain a full path in FreeBSD
 
-=item INTERNALS
+=item Perl will no longer be part of "base FreeBSD"
 
-=item BUGS
+=back
 
 =item AUTHOR
 
 =back
 
-=head2 encoding - allows you to write your script in non-ascii or non-utf8
+=head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
+(HP-UX) systems
 
 =over 4
 
-=item SYNOPSIS
-
-=item ABSTRACT
+=item DESCRIPTION
 
 =over 4
 
-=item Literal Conversions
+=item Using perl as shipped with HP-UX
 
-=item PerlIO layers for C<STD(IN|OUT)>
+=item Using perl from HP's porting centre
 
-=item Implicit upgrading for byte strings
+=item Compiling Perl 5 on HP-UX
 
-=back
+=item PA-RISC
 
-=item FEATURES THAT REQUIRE 5.8.1
+=item Portability Between PA-RISC Versions
 
-"NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
+=item PA-RISC 1.0
 
-=item USAGE
+=item PA-RISC 1.1
 
-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 PA-RISC 2.0
 
-=item The Filter Option
+=item Itanium Processor Family and HP-UX
 
-=over 4
+=item Itanium & Itanium 2
 
-=item Filter-related changes at Encode version 1.87
+=item Building Dynamic Extensions on HP-UX
 
-=back
+=item The HP ANSI C Compiler
 
-=item CAVEATS
+=item The GNU C Compiler
 
-=over 4
+=item Using Large Files with Perl on HP-UX
 
-=item NOT SCOPED
+=item Threaded Perl on HP-UX
 
-=item DO NOT MIX MULTIPLE ENCODINGS
+=item 64-bit Perl on HP-UX
 
-=item tr/// with ranges
+=item Oracle on HP-UX
 
-Legend of characters above
+=item GDBM and Threads on HP-UX
 
-=back
+=item NFS filesystems and utime(2) on HP-UX
 
-=item EXAMPLE - Greekperl
+=item perl -P and // and HP-UX
 
-=item KNOWN PROBLEMS
+=item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
 
-literals in regex that are longer than 127 bytes, EBCDIC, format
+=back
 
-=item HISTORY
+=item nss_delete core dump from op/pwent or op/grent
 
-=item SEE ALSO
+=item AUTHOR
+
+=item DATE
 
 =back
 
-=head2 fields - compile-time class fields
+=head2 perlhurd, README.hurd - Perl version 5 on Hurd
 
 =over 4
 
-=item SYNOPSIS
-
 =item DESCRIPTION
 
-new, phash
+=over 4
 
-=item SEE ALSO
+=item Known Problems with Perl on Hurd 
 
 =back
 
-=head2 filetest - Perl pragma to control the filetest permission operators
+=item AUTHOR
 
-=over 4
+=back
 
-=item SYNOPSIS
+=head2 perlirix, README.irix - Perl version 5 on Irix systems
+
+=over 4
 
 =item DESCRIPTION
 
 =over 4
 
-=item subpragma access
+=item Building 32-bit Perl in Irix
 
-=back
+=item Building 64-bit Perl in Irix
 
-=back
+=item About Compiler Versions of Irix
 
-=head2 if - C<use> a Perl module if a condition holds
+=item Linker Problems in Irix
 
-=over 4
+=item Malloc in Irix
 
-=item SYNOPSIS
+=item Building with threads in Irix
 
-=item DESCRIPTION
+=item Irix 5.3
 
-=item BUGS
+=back
 
 =item AUTHOR
 
 =back
 
-=head2 integer - Perl pragma to use integer arithmetic instead of floating
-point
+=head2 perlmachten, README.machten - Perl version 5 on Power MachTen
+systems
 
 =over 4
 
-=item SYNOPSIS
-
 =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
 
-=head2 less - perl pragma to request less of something from the compiler
+=item AUTHOR
+
+=item DATE
+
+=back
+
+=head2 perlmacos, README.macos - Perl under Mac OS (Classic)
 
 =over 4
 
@@ -8316,9 +8636,13 @@ point
 
 =item DESCRIPTION
 
+=item AUTHOR
+
+=item DATE
+
 =back
 
-=head2 lib - manipulate @INC at compile time
+=head2 perlmacosx, README.macosx - Perl under Mac OS X
 
 =over 4
 
@@ -8328,64 +8652,1949 @@ point
 
 =over 4
 
-=item Adding directories to @INC
+=item Installation Prefix
 
-=item Deleting directories from @INC
+=item libperl and Prebinding
 
-=item Restoring original @INC
+=item Updating Panther
 
-=back
+=item Known problems
 
-=item CAVEATS
+=item MacPerl
 
-=item NOTES
+=item Carbon
 
-=item SEE ALSO
+=item Cocoa
+
+=back
+
+=item Starting From Scratch
 
 =item AUTHOR
 
+=item DATE
+
 =back
 
-=head2 locale - Perl pragma to use and avoid POSIX locales for built-in
-operations
+=head2 perlmint, README.mint - Perl version 5 on Atari MiNT
 
 =over 4
 
-=item SYNOPSIS
-
 =item DESCRIPTION
 
+=item Known problems with Perl on MiNT
+
+=item AUTHOR
+
 =back
 
-=head2 open - perl pragma to set default PerlIO layers for input and output
+=head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
 
 =over 4
 
 =item SYNOPSIS
 
-=item DESCRIPTION
+=item NOTE
 
-=item NONPERLIO FUNCTIONALITY
+=item Binary distribution from HP
 
-=item IMPLEMENTATION DETAILS
+=item What's New in Perl for MPE/iX
 
-=item SEE ALSO
+=item Welcome to Perl/iX
 
-=back
+=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 Usage Hints for Perl on OS/390
+
+=item Floating Point Anomalies with Perl on OS/390
+
+=item Modules and Extensions for Perl on OS/390
+
+=back
+
+=item AUTHORS
+
+=item SEE ALSO
+
+=over 4
+
+=item Mailing list for Perl on OS/390
+
+=back
+
+=item HISTORY
+
+=back
+
+=head2 perlos400, README.os400 - Perl version 5 on OS/400
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item Compiling Perl for OS/400 PASE
+
+=item Installing Perl in OS/400 PASE
+
+=item Using Perl in OS/400 PASE
+
+=item Known Problems
+
+=item Perl on ILE
+
+=back
+
+=item AUTHORS
+
+=back
+
+=head2 perlplan9 - Plan 9-specific documentation for Perl
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item Invoking Perl
+
+=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 COMPILING AND INSTALLING PERL ON PLAN 9
+
+=over 4
+
+=item Installing Perl Documentation on Plan 9
+
+=back
+
+=item BUGS
+
+=item Revision date
+
+=item AUTHOR
+
+=back
+
+=head2 perlqnx, README.qnx - Perl version 5 on QNX
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=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 AUTHOR
+
+=back
+
+=head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item Solaris Version Numbers.
+
+=back
+
+=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 RUN CONFIGURE.
+
+=over 4
+
+=item 64-bit perl on Solaris.
+
+=item Threads in perl on Solaris.
+
+=item Malloc Issues with perl on Solaris.
+
+=back
+
+=item MAKE PROBLEMS.
+
+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 MAKE TEST
+
+=over 4
+
+=item op/stat.t test 4 in Solaris
+
+=item nss_delete core dump from op/pwent or op/grent
+
+=back
+
+=item PREBUILT BINARIES OF PERL FOR SOLARIS.
+
+=item RUNTIME ISSUES FOR PERL ON SOLARIS.
+
+=over 4
+
+=item Limits on Numbers of Open Files on Solaris.
+
+=back
+
+=item SOLARIS-SPECIFIC MODULES.
+
+=item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
+
+=over 4
+
+=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 DESCRIPTION
+
+=over 4
+
+=item Compiling Perl on Symbian
+
+=item Compilation problems
+
+=item PerlApp
+
+=item Using Perl in Symbian
+
+=back
+
+=item TO DO
+
+=item WARNING
+
+=item NOTE
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=item LICENSE
+
+=item HISTORY
+
+=back
+
+=head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
+Digital UNIX formerly known as DEC OSF/1) systems
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item Compiling Perl 5 on Tru64
+
+=item Using Large Files with Perl on Tru64
+
+=item Threaded Perl on Tru64
+
+=item Long Doubles on Tru64
+
+=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 Testing Perl on Tru64
+
+=item ext/ODBM_File/odbm Test Failing With Static Builds
+
+=item Perl Fails Because Of Unresolved Symbol sockatmark
+
+=item AUTHOR
+
+=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 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
+
+=item Configure Perl on VM/ESA
+
+=item Testing Anomalies of Perl on VM/ESA
+
+=item Usage Hints for Perl on VM/ESA
+
+=back
+
+=item AUTHORS
+
+=item SEE ALSO
+
+=over 4
+
+=item Mailing list for Perl on VM/ESA
+
+=back
+
+=back
+
+=head2 perlvms - VMS-specific documentation for Perl
+
+=over 4
+
+=item DESCRIPTION
+
+=item Installation
+
+=item Organization of Perl Images
+
+=over 4
+
+=item Core Images
+
+=item Perl Extensions
+
+=item Installing static extensions
+
+=item Installing dynamic extensions
+
+=back
+
+=item File specifications
+
+=over 4
+
+=item Syntax
+
+=item Wildcard expansion
+
+=item Pipes
+
+=back
+
+=item PERL5LIB and PERLLIB
+
+=item Command line
+
+=over 4
+
+=item I/O redirection and backgrounding
+
+=item Command line switches
+
+-i, -S, -u
+
+=back
+
+=item Perl functions
+
+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 Perl variables
+
+%ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
+
+=item Standard modules with VMS-specific differences
+
+=over 4
+
+=item SDBM_File
+
+=back
+
+=item Revision date
+
+=item AUTHOR
+
+=back
+
+=head2 perlvos, README.vos - Perl for Stratus VOS
+
+=over 4
+
+=item SYNOPSIS
+
+=item BUILDING PERL FOR VOS
+
+=item INSTALLING PERL IN VOS
+
+=item USING PERL IN VOS
+
+=over 4
+
+=item Restrictions of Perl on VOS
+
+=item Handling of underflow and overflow
+
+=back
+
+=item TEST STATUS
+
+=item SUPPORT STATUS
+
+=item AUTHOR
+
+=item LAST UPDATE
+
+=back
+
+=head2 perlwin32 - Perl under Windows
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Setting Up Perl on Win32
+
+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
+
+=item Building
+
+=item Testing Perl on Win32
+
+=item Installation of Perl on Win32
+
+=item Usage Hints for Perl on Win32
+
+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 Running Perl Scripts
+
+=item Miscellaneous Things
+
+=back
+
+=item BUGS AND CAVEATS
+
+=item ACKNOWLEDGEMENTS
+
+=item AUTHORS
+
+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 SEE ALSO
+
+=item HISTORY
+
+=back
+
+=head1 PRAGMA DOCUMENTATION
+
+=head2 attrs - set/get attributes of a subroutine (deprecated)
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+method, locked
+
+=back
+
+=head2 re - Perl pragma to alter regular expression behaviour
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
+=head2 threadshared::shared, threads::shared - Perl extension for sharing
+data structures between threads
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item EXPORT
+
+=item FUNCTIONS
+
+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 NOTES
+
+=item BUGS
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
+=head2 threads - Perl extension allowing use of interpreter based threads
+from perl
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+$thread = threads->create(function, LIST), $thread->join, $thread->detach,
+threads->self, $thread->tid, threads->object( tid ), threads->yield();,
+threads->list();, async BLOCK;
+
+=item WARNINGS
+
+A thread exited while %d other threads were still running
+
+=item TODO
+
+=item BUGS
+
+Parent-Child threads, Returning objects, Creating threads inside BEGIN
+blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
+
+=item AUTHOR and COPYRIGHT
+
+=item SEE ALSO
+
+=back
+
+=head2 assertions - select assertions in blocks of code
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Selecting assertions
+
+=item Handling assertions your own way
+
+enabled($on), enabled(), seen($on), seen()
+
+=back
+
+=item COMPATIBILITY
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT AND LICENSE
+
+=back
+
+=head2 assertions::activate - activate assertions
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT AND LICENSE
+
+=back
+
+=head2 assertions::compat - assertions for pre-5.9 versions of perl
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item The C<assertion> attribute handler
+
+=item Assertion execution status as a constant
+
+=back
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT AND LICENSE
+
+=back
+
+=head2 attributes - get/set subroutine or variable attributes
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Built-in Attributes
+
+locked, method, lvalue
+
+=item Available Subroutines
+
+get, reftype
+
+=item Package-specific Attribute Handling
+
+FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
+
+=item Syntax of Attribute Lists
+
+=back
+
+=item EXPORTS
+
+=over 4
+
+=item Default exports
+
+=item Available exports
+
+=item Export tags defined
+
+=back
+
+=item EXAMPLES
+
+=item SEE ALSO
+
+=back
+
+=head2 autouse - postpone load of modules until a function is used
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item WARNING
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
+=head2 base - Establish IS-A relationship with base classes at compile time
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item DIAGNOSTICS
+
+Base class package "%s" is empty
+
+=item HISTORY
+
+=item CAVEATS
+
+=item SEE ALSO
+
+=back
+
+=head2 bigint - Transparent BigInteger support for Perl
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Options
+
+a or accuracy, p or precision, t or trace, l or lib, v or version
+
+=item Math Library
+
+=item Internal Format
+
+=item Sign
+
+=item Methods
+
+=item Caveat
+
+=back
+
+=item MODULES USED
+
+=item EXAMPLES
+
+=item LICENSE
+
+=item SEE ALSO
+
+=item AUTHORS
+
+=back
+
+=head2 bignum - Transparent BigNumber support for Perl
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Options
+
+a or accuracy, p or precision, t or trace, l or lib, v or version
+
+=item Methods
+
+=item Caveat
+
+inf(), NaN(), upgrade()
+
+=item MATH LIBRARY
+
+=item INTERNAL FORMAT
+
+=item SIGN
+
+=back
+
+=item MODULES USED
+
+=item EXAMPLES
+
+=item LICENSE
+
+=item SEE ALSO
+
+=item AUTHORS
+
+=back
+
+=head2 bigrat - Transparent BigNumber/BigRational support for Perl
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Modules Used
+
+=item Math Library
+
+=item Sign
+
+=item Methods
+
+=item Cavaet
+
+=item Options
+
+a or accuracy, p or precision, t or trace, l or lib, v or version
+
+=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
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item BUGS
+
+=item AUTHOR
+
+=back
+
+=head2 bytes - Perl pragma to force byte semantics rather than character
+semantics
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item LIMITATIONS
+
+=item SEE ALSO
+
+=back
+
+=head2 charnames - define character names for C<\N{named}> string literal
+escapes
+
+=over 4
+
+=item SYNOPSIS
+
+=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
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item NOTES
+
+=over 4
+
+=item List constants
+
+=item Defining multiple constants at once
+
+=item Magic constants
+
+=back
+
+=item TECHNICAL NOTES
+
+=item BUGS
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
+=head2 diagnostics, splain - produce verbose warning diagnostics
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item The C<diagnostics> Pragma
+
+=item The I<splain> Program
+
+=back
+
+=item EXAMPLES
+
+=item INTERNALS
+
+=item BUGS
+
+=item AUTHOR
+
+=back
+
+=head2 encoding - allows you to write your script in non-ascii or non-utf8
+
+=over 4
+
+=item SYNOPSIS
+
+=item ABSTRACT
+
+=over 4
+
+=item Literal Conversions
+
+=item PerlIO layers for C<STD(IN|OUT)>
+
+=item Implicit upgrading for byte strings
+
+=back
+
+=item FEATURES THAT REQUIRE 5.8.1
+
+"NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
+
+=item USAGE
+
+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 Filter-related changes at Encode version 1.87
+
+=back
+
+=item CAVEATS
+
+=over 4
+
+=item NOT SCOPED
+
+=item DO NOT MIX MULTIPLE ENCODINGS
+
+=item tr/// with ranges
+
+Legend of characters above
+
+=back
+
+=item EXAMPLE - Greekperl
+
+=item KNOWN PROBLEMS
+
+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 encoding::warnings - Warn on implicit encoding conversions
+
+=over 4
+
+=item VERSION
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Overview of the problem
+
+=item Detecting the problem
+
+=item Solving the problem
+
+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
+
+=back
+
+=item CAVEATS
+
+=back
+
+=over 4
+
+=item SEE ALSO
+
+=item AUTHORS
+
+=item COPYRIGHT
+
+=back
+
+=head2 fields - compile-time class fields
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+new, phash
+
+=item SEE ALSO
+
+=back
+
+=head2 filetest - Perl pragma to control the filetest permission operators
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item subpragma access
+
+=back
+
+=back
+
+=head2 if - C<use> a Perl module if a condition holds
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item BUGS
+
+=item AUTHOR
+
+=back
+
+=head2 integer - Perl pragma to use integer arithmetic instead of floating
+point
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
+=head2 less - perl pragma to request less of something from the compiler
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
+=head2 lib - manipulate @INC at compile time
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Adding directories to @INC
+
+=item Deleting directories from @INC
+
+=item Restoring original @INC
+
+=back
+
+=item CAVEATS
+
+=item NOTES
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=back
+
+=head2 locale - Perl pragma to use and avoid POSIX locales for built-in
+operations
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
+=head2 open - perl pragma to set default PerlIO layers for input and output
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item NONPERLIO FUNCTIONALITY
+
+=item IMPLEMENTATION DETAILS
+
+=item SEE ALSO
+
+=back
 
 =head2 ops - Perl pragma to restrict unsafe operations when compiling
 
 =over 4
 
-=item SYNOPSIS 
+=item SYNOPSIS 
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=back
+
+=head2 overload - Package for overloading perl operations
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Declaration of overloaded functions
+
+=item Calling Conventions for Binary Operations
+
+FALSE, TRUE, C<undef>
+
+=item Calling Conventions for Unary Operations
+
+=item Calling Conventions for Mutators
+
+C<++> and C<-->, C<x=> and other assignment versions
+
+=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 SPECIAL SYMBOLS FOR C<use overload>
+
+=over 4
+
+=item Last Resort
+
+=item Fallback
+
+C<undef>, TRUE, defined, but FALSE
+
+=item Copy Constructor
+
+B<Example>
+
+=back
+
+=item MAGIC AUTOGENERATION
+
+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 Losing overloading
+
+=item Run-time Overloading
+
+=item Public functions
+
+overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
+
+=item Overloading constants
+
+integer, float, binary, q, qr
+
+=item IMPLEMENTATION
+
+=item Metaphor clash
+
+=item Cookbook
+
+=over 4
+
+=item Two-face scalars
+
+=item Two-face references
+
+=item Symbolic calculator
+
+=item I<Really> symbolic calculator
+
+=back
+
+=item AUTHOR
+
+=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 sigtrap - Perl pragma to enable simple signal handling
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item OPTIONS
+
+=over 4
+
+=item SIGNAL HANDLERS
+
+B<stack-trace>, B<die>, B<handler> I<your-handler>
+
+=item SIGNAL LISTS
+
+B<normal-signals>, B<error-signals>, B<old-interface-signals>
+
+=item OTHER
+
+B<untrapped>, B<any>, I<signal>, I<number>
+
+=back
+
+=item EXAMPLES
+
+=back
+
+=head2 sort - perl pragma to control sort() behaviour
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CAVEATS
+
+=back
+
+=head2 strict - Perl pragma to restrict unsafe constructs
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+C<strict refs>, C<strict vars>, C<strict subs>
+
+=item HISTORY
+
+=back
+
+=head2 subs - Perl pragma to predeclare sub names
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
+=head2 threadshared, threads::shared - Perl extension for sharing data
+structures between threads
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item EXPORT
+
+=item FUNCTIONS
+
+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 NOTES
+
+=item BUGS
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
+=head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
+code
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Utility functions
+
+$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 BUGS
+
+=item SEE ALSO
+
+=back
+
+=head2 vars - Perl pragma to predeclare global variable names (obsolete)
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
+=head2 version - Perl extension for Version Objects
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item What IS a version
+
+Numeric Versions, Quoted Versions
+
+=item What about v-strings?
+
+=item Numeric Versions
+
+=item Quoted Versions
+
+=item Numeric Alpha Versions
+
+=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 EXPORT
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=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>
+
+=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)
+
+=back
+
+=head2 warnings::register - warnings import function
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
+=head1 MODULE DOCUMENTATION
+
+=head2 AnyDBM_File - provide framework for multiple DBMs
+
+=over 4
+
+=item SYNOPSIS
 
 =item DESCRIPTION
 
+=over 4
+
+=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
 
@@ -8393,226 +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
-
-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 Losing overloading
+=over 4
 
-=item Run-time Overloading
+=item $tar->list_files( [\@properties] )
 
-=item Public functions
+=back
 
-overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
+=over 4
 
-=item Overloading constants
+=item $tar->get_files( [@filenames] )
 
-integer, float, binary, q, qr
+=back
 
-=item IMPLEMENTATION
+=over 4
 
-=item Metaphor clash
+=item $tar->get_content( $file )
 
-=item Cookbook
+=back
 
 =over 4
 
-=item Two-face scalars
+=item $tar->replace_content( $file, $content )
 
-=item Two-face references
+=back
 
-=item Symbolic calculator
+=over 4
 
-=item I<Really> symbolic calculator
+=item $tar->rename( $file, $new_name )
 
 =back
 
-=item AUTHOR
-
-=item DIAGNOSTICS
-
-Odd number of arguments for overload::constant, `%s' is not an overloadable
-type, `%s' is not a code reference
+=over 4
 
-=item BUGS
+=item $tar->remove (@filenamelist)
 
 =back
 
-=head2 sigtrap - Perl pragma to enable simple signal handling
-
 =over 4
 
-=item SYNOPSIS
-
-=item DESCRIPTION
+=item $tar->clear
 
-=item OPTIONS
+=back
 
 =over 4
 
-=item SIGNAL HANDLERS
+=item $tar->write ( [$file, $compressed, $prefix] )
 
-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->add_files( @filenamelist )
 
-=item OTHER
+=back
 
-B<untrapped>, B<any>, I<signal>, I<number>
+=over 4
+
+=item $tar->add_data ( $filename, $data, [$opthashref] )
 
 =back
 
-=item EXAMPLES
+=over 4
 
-=back
+=item $tar->error( [$BOOL] )
 
-=head2 sort - perl pragma to control sort() behaviour
+=back
 
 =over 4
 
-=item SYNOPSIS
+=item $bool = $tar->has_io_string
 
-=item DESCRIPTION
+=back
 
-=item CAVEATS
+=over 4
 
-=back
+=item $bool = $tar->has_perlio
 
-=head2 strict - Perl pragma to restrict unsafe constructs
+=back
 
 =over 4
 
-=item SYNOPSIS
-
-=item DESCRIPTION
+=item Class Methods
 
-C<strict refs>, C<strict vars>, C<strict subs>
+=over 4
 
-=item HISTORY
+=item Archive::Tar->create_archive($file, $compression, @filelist)
 
 =back
 
-=head2 subs - Perl pragma to predeclare sub names
+=back
 
 =over 4
 
-=item SYNOPSIS
-
-=item DESCRIPTION
+=item Archive::Tar->list_archive ($file, $compressed, [\@properties])
 
 =back
 
-=head2 threadshared, threads::shared - Perl extension for sharing data
-structures between threads
-
 =over 4
 
-=item SYNOPSIS
+=item Archive::Tar->extract_archive ($file, $gzip)
 
-=item DESCRIPTION
+=back
 
-=item EXPORT
+=over 4
 
-=item FUNCTIONS
+=item Archive::Tar->can_handle_compressed_files
 
-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
+=back
 
-=item NOTES
+=over 4
 
-=item BUGS
+=item GLOBAL VARIABLES
 
-=item AUTHOR
+=over 4
 
-=item SEE ALSO
+=item $Archive::Tar::FOLLOW_SYMLINK
 
-=back
+=item $Archive::Tar::CHOWN
 
-=head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
-code
+=item $Archive::Tar::CHMOD
 
-=over 4
+=item $Archive::Tar::DO_NOT_USE_PREFIX
 
-=item SYNOPSIS
+=item $Archive::Tar::DEBUG
 
-=item DESCRIPTION
+=item $Archive::Tar::WARN
 
-=over 4
+=item $Archive::Tar::error
 
-=item Utility functions
+=item $Archive::Tar::HAS_PERLIO
 
-$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::HAS_IO_STRING
 
 =back
 
-=item BUGS
+=item FAQ
 
-=item SEE ALSO
+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?
 
-=back
+=item TODO
 
-=head2 vars - Perl pragma to predeclare global variable names (obsolete)
+Check if passed in handles are open for read/write
 
-=over 4
+=item AUTHOR
 
-=item SYNOPSIS
+=item ACKNOWLEDGEMENTS
 
-=item DESCRIPTION
+=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
 
@@ -8622,96 +10802,75 @@ utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
 
 =over 4
 
-=item What IS a version
-
-Numeric Versions, Quoted Versions
-
-=item What about v-strings?
-
-=item Numeric Versions
+=item Accessors
 
-=item Quoted Versions
+name, mode, uid, gid, size, mtime, chksum, type, linkname, magic, version,
+uname, gname, devmajor, devminor, prefix, raw
 
-=item Object Methods
+=back
 
-New Operator, qv(), 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
 
@@ -8898,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
 
@@ -8907,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
 
@@ -9102,33 +11262,85 @@ B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
 
 =item OPTIONS
 
-B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
-B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
-B<-terse>, B<-linenoise>, B<-debug>, B<-env>
+=over 4
+
+=item Options for Opcode Ordering
+
+B<-basic>, B<-exec>, B<-tree>
+
+=item Options for Line-Style
+
+B<-concise>, B<-terse>, B<-linenoise>, B<-debug>, B<-env>
+
+=item Options for tree-specific formatting
+
+B<-compact>, B<-loose>, B<-vt>, B<-ascii>
+
+=item Options controlling sequence numbering
+
+B<-base>I<n>, B<-bigendian>, B<-littleendian>
+
+=item Other options
+
+B<-main>, B<-nomain>, B<-nobanner>, B<-banner>, B<-banneris> => subref
+
+=item Option Stickiness
+
+=back
+
+=item ABBREVIATIONS
+
+=over 4
+
+=item OP class abbreviations
+
+=item OP flags abbreviations
+
+=back
 
 =item FORMATTING SPECIFICATIONS
 
-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<#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>
+=over 4
+
+=item Special Patterns
+
+B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
+B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
+B<~>
+
+=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<#opt>, B<#static>, B<#sibaddr>, B<#svaddr>,
+B<#svclass>, B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
+
+=back
+
+=item Using B::Concise outside of the O framework
+
+=over 4
+
+=item Example: Altering Concise Renderings
+
+=item set_style()
+
+=item set_style_standard($name)
+
+=item add_style()
 
-=item ABBREVIATIONS
+=item add_callback()
 
-=over 4
+=item Running B::Concise::compile()
 
-=item OP flags abbreviations
+=item B::Concise::reset_sequence()
 
-=item OP class abbreviations
+=item Errors
 
 =back
 
-=item Using B::Concise outside of the O framework
-
 =item AUTHOR
 
 =back
@@ -9244,6 +11456,18 @@ B<-u Package>
 
 =item DESCRIPTION
 
+=item EXAMPLES
+
+=over 4
+
+=item OPTIONS
+
+=back
+
+=item SEE ALSO
+
+=item TODO
+
 =item AUTHOR
 
 =back
@@ -9513,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>
@@ -9577,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
@@ -9991,6 +12226,22 @@ 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
@@ -10050,6 +12301,103 @@ 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
@@ -10096,51 +12444,55 @@ 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_attribut>,
-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_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_off64_t>,
+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>,
@@ -10172,21 +12524,22 @@ 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_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>
+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
 
@@ -10298,8 +12651,8 @@ C<perl>, C<perl_patchlevel>
 
 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
-C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
-C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
+C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>,
+C<procselfexe>, C<prototype>, C<ptrsize>
 
 =item q
 
@@ -10346,12 +12699,12 @@ 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<usemorebits>,
-C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>,
-C<useposix>, C<usereentrant>, 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>
+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
 
@@ -10365,7 +12718,7 @@ C<versiononly>, C<vi>, C<voidflags>
 
 =item x
 
-C<xlibpth>, C<xs_apiversion>
+C<xlibpth>
 
 =item y
 
@@ -10381,6 +12734,18 @@ C<zcat>, C<zip>
 
 =back
 
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+dynamic, nonxs, static
+
+=item AUTHOR
+
+=back
+
 =head2 Cwd - get pathname of current working directory
 
 =over 4
@@ -10393,7 +12758,7 @@ C<zcat>, C<zip>
 
 =item getcwd and friends
 
-getcwd, cwd, fastcwd, fastgetcwd
+getcwd, cwd, fastcwd, fastgetcwd, getdcwd
 
 =item abs_path and friends
 
@@ -10405,6 +12770,10 @@ abs_path, realpath, fast_abs_path
 
 =item NOTES
 
+=item AUTHOR
+
+=item COPYRIGHT
+
 =item SEE ALSO
 
 =back
@@ -10728,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
 
-=item AUTHOR
+=over 4
+
+=item Provided Perl compatibility API
+
+=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
 
@@ -10858,10 +13259,26 @@ $md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest
 
 =over 4
 
-=item SYNPOSIS
+=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
@@ -10992,11 +13409,11 @@ 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
 
@@ -11018,6 +13435,8 @@ is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
 
 =back
 
+=item UTF-8 vs. utf8
+
 =item SEE ALSO
 
 =item MAINTAINER
@@ -11112,7 +13531,8 @@ reference, e.g.:
 
 =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
 
@@ -11366,6 +13786,8 @@ BOM as integer when fetched in network byte order
 
 =item Surrogate Pairs
 
+=item Error Checking
+
 =item SEE ALSO
 
 =back
@@ -11433,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
 
@@ -11707,6 +14130,12 @@ 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
@@ -11839,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.
 
@@ -11852,30 +14321,28 @@ 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
@@ -11918,39 +14385,94 @@ IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
 
 =back
 
-C_stringify NAME
+constant_types
 
-perl_stringify NAME
+XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
 
-constant_types
+autoload PACKAGE, VERSION, AUTOLOADER
+
+WriteMakefileSnippet
+
+WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
+BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
+
+=over 4
+
+=item AUTHOR
+
+=back
+
+=head2 ExtUtils::Constant::Base - base class for ExtUtils::Constant objects
 
-memEQ_clause NAME, CHECKED_AT, INDENT
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item USAGE
+
+=back
+
+header
+
+memEQ_clause args_hashref
+
+dump_names arg_hashref, ITEM..
 
-assign INDENT, TYPE, PRE, POST, VALUE..
+assign arg_hashref, VALUE..
 
-return_clause
+return_clause arg_hashref, ITEM
 
-switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
+switch_clause arg_hashref, NAMELEN, ITEMHASH, ITEM..
 
 params WHAT
 
-dump_names
+dogfood arg_hashref, ITEM..
 
-dogfood
+C_constant arg_hashref, ITEM.., name, type, value, macro, default, pre,
+post, def_pre, def_post, utf8, weight
 
-C_constant, name, type, value, macro, default, pre, post, def_pre =item
-def_post, utf8
+=over 4
 
-XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
+=item BUGS
 
-autoload PACKAGE, VERSION, AUTOLOADER
+=item AUTHOR
 
-WriteMakefileSnippet
+=back
 
-WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
-BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
+=head2 ExtUtils::Constant::Utils - helper functions for ExtUtils::Constant
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item USAGE
+
+C_stringify NAME
+
+=back
+
+perl_stringify NAME
+
+=over 4
+
+=item AUTHOR
+
+=back
+
+=head2 ExtUtils::Constant::XS, ExtUtils::Constant::Base - base class for
+ExtUtils::Constant objects
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
 
-=over 4
+=item BUGS
 
 =item AUTHOR
 
@@ -12083,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
 
@@ -12091,78 +14613,70 @@ dynamic extensions at load time
 
 =item DESCRIPTION
 
-=item Inherently Cross-Platform Methods
+=over 4
 
-installvars
+=item Overridden methods
 
 =back
 
-os_flavor_is
-
-blibdirs_target (o)
+=back
 
 =over 4
 
-=item File::Spec wrappers
+=item AUTHOR
 
-catfile
+=item SEE ALSO
 
 =back
 
-=over 4
+=head2 ExtUtils::MM_Any - Platform-agnostic MM methods
 
-=item Thought To Be Cross-Platform Methods
+=over 4
 
-B<split_command>
+=item SYNOPSIS
 
-=back
+=item DESCRIPTION
 
-B<echo>
+=item METHODS
 
-init_VERSION
+=over 4
 
-wraplist
+=item Cross-platform helper methods
 
-manifypods
+=back
 
-manifypods_target
+=back
 
-makemakerdflt_target
+=over 4
 
-special_targets
+=item Targets
 
-POD2MAN_macro
+=back
 
-test_via_harness
+=over 4
 
-test_via_script
+=item Init methods
 
-libscan
+=back
 
-tool_autosplit
+=over 4
 
-all_target
+=item Tools
 
-metafile_target
+=back
 
-signature_target
+=over 4
 
-metafile_addtomanifest_target
+=item File::Spec wrappers
 
-signature_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
@@ -12180,7 +14694,7 @@ ExtUtils::MakeMaker
 
 =back
 
-os_flavor (o)
+os_flavor
 
 init_linker
 
@@ -12193,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
 
@@ -12231,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
 
@@ -12242,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
 
@@ -12291,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
@@ -12366,7 +14863,7 @@ B<replace_manpage_separator>
 
 =item Methods
 
-os_flavor (o)
+os_flavor
 
 =back
 
@@ -12374,10 +14871,6 @@ c_o (o)
 
 cflags (o)
 
-clean (o)
-
-clean_subdirs_target
-
 const_cccmd (o)
 
 const_config (o)
@@ -12388,8 +14881,6 @@ constants (o)
 
 depend (o)
 
-dir_target B<DEPRECATED>
-
 init_DEST
 
 init_dist
@@ -12416,14 +14907,8 @@ uutardist_target
 
 shdist_target
 
-distdir
-
-dist_test
-
 dlsyms (o)
 
-dynamic (o)
-
 dynamic_bs (o)
 
 dynamic_lib (o)
@@ -12434,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
@@ -12458,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
 
@@ -12524,13 +14997,11 @@ processPL (o)
 
 quote_paren
 
-realclean (o)
-
-realclean_subdirs_target
-
 replace_manpage_separator
 
-oneliner (o)
+cd
+
+oneliner
 
 quote_literal
 
@@ -12607,6 +15078,10 @@ find_perl (override)
 
 maybe_command (override)
 
+pasthru (override)
+
+pm_to_blib (override)
+
 perl_script (override)
 
 replace_manpage_separator
@@ -12633,8 +15108,6 @@ cflags (override)
 
 const_cccmd (override)
 
-tool_sxubpp (override)
-
 tools_other (override)
 
 init_dist (override)
@@ -12649,45 +15122,27 @@ dlsyms (override)
 
 dynamic_lib (override)
 
-dynamic_bs (override)
-
 static_lib (override)
 
-processPL (override)
-
-installbin (override)
-
-subdir_x (override)
+extra_clean_files
 
-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
 
@@ -12695,7 +15150,7 @@ escape_newlines
 
 max_exec_len
 
-init_linker (o)
+init_linker
 
 eliminate_macros
 
@@ -12703,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
 
@@ -12726,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
 
@@ -12766,26 +15251,18 @@ 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
@@ -12866,7 +15343,7 @@ test, tool_autosplit
 
 =item The End Of Cargo Cult Programming
 
-C<<MAN3PODS => ' '>>
+C<< MAN3PODS => ' ' >>
 
 =item Hintsfile support
 
@@ -12888,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
 
@@ -12898,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
 
@@ -13045,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
@@ -13092,6 +15591,28 @@ new(), read(), write(), validate(), packlist_file()
 
 =back
 
+=head2 ExtUtils::ParseXS - converts Perl XS code into C code
+
+=over 4
+
+=item SYNOPSIS
+
+=item EXPORT
+
+=item FUNCTIONS
+
+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
 
 =over 4
@@ -13266,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
@@ -13310,7 +15841,9 @@ splitdir, catpath(), abs2rel, rel2abs()
 
 =item SEE ALSO
 
-=item AUTHORS
+=item AUTHOR
+
+=item COPYRIGHT
 
 =back
 
@@ -13330,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
@@ -13338,14 +15877,16 @@ tmpdir (override)
 
 =item DESCRIPTION
 
-=item AUTHORS
-
 =back
 
 canonpath()
 
 =over 4
 
+=item AUTHOR
+
+=item COPYRIGHT
+
 =item SEE ALSO
 
 =back
@@ -13364,6 +15905,8 @@ canonpath()
 
 =back
 
+=item COPYRIGHT
+
 =item SEE ALSO
 
 =back
@@ -13414,6 +15957,8 @@ rel2abs
 
 =item AUTHORS
 
+=item COPYRIGHT
+
 =item SEE ALSO
 
 =back
@@ -13428,6 +15973,8 @@ rel2abs
 
 tmpdir, splitpath
 
+=item COPYRIGHT
+
 =back
 
 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
@@ -13481,6 +16028,8 @@ rel2abs()
 
 =over 4
 
+=item COPYRIGHT
+
 =item SEE ALSO
 
 =back
@@ -13539,6 +16088,8 @@ rel2abs (override)
 
 =over 4
 
+=item COPYRIGHT
+
 =item SEE ALSO
 
 =back
@@ -13575,6 +16126,8 @@ catpath
 
 =over 4
 
+=item COPYRIGHT
+
 =item SEE ALSO
 
 =back
@@ -13593,7 +16146,7 @@ catpath
 
 =over 4
 
-=item OO INTERFACE
+=item OBJECT-ORIENTED INTERFACE
 
 B<new>
 
@@ -13601,6 +16154,8 @@ B<new>
 
 B<filename>
 
+B<unlink_on_destroy>
+
 B<DESTROY>
 
 =over 4
@@ -13657,6 +16212,8 @@ B<cmpstat>
 
 B<unlink1>
 
+B<cleanup>
+
 =over 4
 
 =item PACKAGE VARIABLES
@@ -13667,13 +16224,19 @@ B<safe_level>, STANDARD, MEDIUM, HIGH
 
 TopSystemUID
 
+B<$KEEP_ALL>, B<$DEBUG>
+
 =over 4
 
 =item WARNING
 
 =over 4
 
-=item Temporary files and NFS
+=item Temporary files and NFS
+
+=item Forking
+
+=item BINMODE
 
 =back
 
@@ -13715,8 +16278,6 @@ cacheout EXPR, cacheout MODE, EXPR
 
 =item BUGS
 
-=item NOTES
-
 =back
 
 =head2 FileHandle - supply object methods for filehandles
@@ -13753,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
 
@@ -14052,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
@@ -14066,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
@@ -14281,7 +16865,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
 
@@ -14485,6 +17072,52 @@ hostpath(), peerpath()
 
 =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
+
 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
 handles
 
@@ -14519,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
 
@@ -15219,7 +17855,8 @@ 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
 
@@ -15236,7 +17873,8 @@ 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
 
@@ -15269,9 +17907,15 @@ ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
 
 =back
 
-=item EXAMPLES
+=item METHODS
+
+=over 4
 
-  # not ready yet
+=item accuracy
+
+=item precision()
+
+=back
 
 =item Autocreating constants
 
@@ -15287,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
 
@@ -15297,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
 
@@ -15333,8 +17977,8 @@ Input, Output
 
 =item is_pos()/is_neg()
 
-       $x->is_pos();                   # true if >= 0
-       $x->is_neg();                   # true if <  0
+       $x->is_pos();                   # true if > 0
+       $x->is_neg();                   # true if < 0
 
 =item is_odd()/is_even()/is_int()
 
@@ -15441,6 +18085,10 @@ Remarks
 
 =back
 
+=item Infinity and Not a Number
+
+oct()/hex(), log(-inf), exp(), cos(), sin(), atan2()
+
 =item INTERNALS
 
 =over 4
@@ -15536,6 +18184,41 @@ the same terms as Perl itself.
 
 =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 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
@@ -15548,7 +18231,7 @@ the same terms as Perl itself.
 
 =back
 
-=head2 Math::BigRat - arbitrarily big rational numbers
+=head2 Math::BigRat - Arbitrary big rational numbers
 
 =over 4
 
@@ -15576,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()
 
@@ -15590,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()
 
@@ -15838,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
@@ -15965,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
 
@@ -16074,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
 
@@ -16138,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
 
@@ -18012,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
 
@@ -18166,10 +20874,16 @@ set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
 
 =over 4
 
-=item OBJECT ORIENTED SYNTAX
+=item Caveats
+
+=item Escaping Magic Characters
+
+=item Configuration
 
 =back
 
+=item BUGS
+
 =item AUTHOR
 
 =back
@@ -18222,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
 
@@ -18508,6 +21222,8 @@ NORMAL TESTS, SKIPPED TESTS, TODO TESTS
 
 =item BUGS and CAVEATS
 
+=item ENVIRONMENT
+
 =item NOTE
 
 =item SEE ALSO
@@ -18534,6 +21250,10 @@ B<new>
 
 =back
 
+B<create>
+
+B<reset>
+
 =over 4
 
 =item Setting up tests
@@ -18600,6 +21320,8 @@ B<diag>
 
 B<_print>
 
+B<_print_diag>
+
 B<output>, B<failure_output>, B<todo_output>
 
 =over 4
@@ -18626,6 +21348,8 @@ B<_my_exit>
 
 =over 4
 
+=item EXIT CODES
+
 =item THREADS
 
 =item EXAMPLES
@@ -18654,17 +21378,12 @@ B<_my_exit>
 
 =over 4
 
-=item The test script output
-
-B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
-B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
-else>
-
 =item Taint mode
 
 =item Configuration variables.
 
-B<$Test::Harness::Verbose>, B<$Test::Harness::switches>
+C<$Test::Harness::Verbose>, C<$Test::Harness::switches>,
+C<$Test::Harness::Timer>
 
 =item Failure
 
@@ -18700,20 +21419,19 @@ 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_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>,
-C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
+C<HARNESS_ACTIVE>, C<HARNESS_VERSION>
 
-=item EXAMPLE
+=item ENVIRONMENT VARIABLES THAT AFFECT TEST::HARNESS
 
-=item SEE ALSO
+C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>, C<HARNESS_DEBUG>,
+C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
+C<HARNESS_PERL>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
 
-=item AUTHORS
+=item EXAMPLE
 
-=item LICENSE
+=item SEE ALSO
 
 =item TODO
 
@@ -18769,6 +21487,36 @@ C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
 
 =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
 
 =over 4
@@ -18777,11 +21525,11 @@ C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
 
 =item DESCRIPTION
 
-=item Construction
+=item CONSTRUCTION
 
 =over 4
 
-=item C<new>
+=item new()
 
 =back
 
@@ -18789,17 +21537,17 @@ C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
 
 =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
 
@@ -18807,55 +21555,55 @@ C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
 
 =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<_command_line( $file )>
+=item $strap->_command_line( $file )
 
 =back
 
 =over 4
 
-=item C<_command>
+=item $strap->_command()
 
 =back
 
 =over 4
 
-=item C<_switches>
+=item $strap->_switches( $file )
 
 =back
 
 =over 4
 
-=item C<_cleaned_switches>
+=item $strap->_cleaned_switches( @switches_from_user )
 
 =back
 
 =over 4
 
-=item C<_INC2PERL5LIB>
+=item $strap->_INC2PERL5LIB
 
 =back
 
 =over 4
 
-=item C<_filtered_INC>
+=item $strap->_filtered_INC()
 
 =back
 
 =over 4
 
-=item C<_restore_PERL5LIB>
+=item $strap->_restore_PERL5LIB()
 
 =back
 
@@ -18865,7 +21613,7 @@ C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
 
 =over 4
 
-=item C<_is_comment>
+=item C<_is_diagnostic>
 
 =back
 
@@ -18879,41 +21627,101 @@ C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
 
 =over 4
 
-=item C<_is_test>
+=item C<_is_bail_out>
 
 =back
 
 =over 4
 
-=item C<_is_bail_out>
+=item C<_reset_file_state>
 
 =back
 
 =over 4
 
-=item C<_reset_file_state>
+=item Results
+
+=item EXAMPLES
+
+=item AUTHOR
+
+=item SEE ALSO
 
 =back
 
+=head2 Test::Harness::TAP - Documentation for the TAP format
+
 =over 4
 
-=item Results
+=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
 
@@ -18989,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>
@@ -19011,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
 
@@ -19024,6 +21837,8 @@ upgrades
 
 =item AUTHORS
 
+=item BUGS
+
 =item COPYRIGHT
 
 =back
@@ -19530,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
 
@@ -19552,6 +22367,8 @@ $which )
 
 =item CAVEATS
 
+=item SEE ALSO
+
 =item AUTHORS
 
 =item COPYRIGHT AND LICENSE
@@ -19570,6 +22387,8 @@ $which )
 
 =item Ambiguous Local Times (DST)
 
+=item Non-Existent Local Times (DST)
+
 =item Negative Epoch Values
 
 =back
@@ -19654,10 +22473,10 @@ CLASS->can( METHOD ) >>, C<can( VAL, METHOD )>, C<VERSION ( [ REQUIRE ] )>
 
 =item Constructor and Tailoring
 
-UCA_Version, backwards, entry, hangul_terminator, ignoreName, ignoreChar,
-level, normalization, overrideCJK, overrideHangul, preprocess, rearrange,
-table, undefName, undefChar, katakana_before_hiragana, upper_before_lower,
-variable, alternate
+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
 
@@ -19684,21 +22503,23 @@ $Collator-E<gt>gsubst($string, $substring, $replacement)>
 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
 
 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, L<Unicode::Normalize>
+Type, Unicode Normalization Forms - UAX #15
 
 =back
 
@@ -19742,9 +22563,14 @@ 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
 
@@ -19752,7 +22578,8 @@ C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
 
 http://www.unicode.org/reports/tr15/,
 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt,
-http://www.unicode.org/notes/tn5/
+http://www.unicode.org/Public/UNIDATA/NormalizationCorrections.txt,
+http://www.unicode.org/review/pr-29.html, http://www.unicode.org/notes/tn5/
 
 =back
 
@@ -19828,6 +22655,12 @@ http://www.unicode.org/notes/tn5/
 
 =over 4
 
+=item namedseq()
+
+=back
+
+=over 4
+
 =item Unicode::UCD::UnicodeVersion
 
 =back
@@ -19886,39 +22719,6 @@ March 18th, 2000
 
 =back
 
-=head2 Win32 - Interfaces to some Win32 API Functions
-
-=over 4
-
-=item DESCRIPTION
-
-=over 4
-
-=item Alphabetical Listing of Win32 Functions
-
-Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
-Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
-Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
-Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
-Win32::GetChipName(), Win32::GetCwd(), Win32::GetFolderPath(FOLDER [,
-CREATE]), Win32::GetFullPathName(FILENAME), Win32::GetLastError(),
-Win32::GetLongPathName(PATHNAME), Win32::GetNextAvailDrive(),
-Win32::GetOSVersion(), Win32::GetOSName(),
-Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
-PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
-Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
-Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
-SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
-Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
-Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
-Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
-Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
-Win32::UnregisterServer(LIBRARYNAME)
-
-=back
-
-=back
-
 =head2 XSLoader - Dynamically load C libraries into Perl code
 
 =over 4