X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperltoc.pod;h=4a9495771fc29bc14d96cc73448a33653b6ec6f5;hb=888aee597441568824c1835285c8012bab253529;hp=b30b25fbfc2204b15cd60b9e02077a61e5382c6e;hpb=bd28ded57c7fdc2cd2d243780d59f02e1e670e33;p=p5sagit%2Fp5-mst-13.2.git

diff --git a/pod/perltoc.pod b/pod/perltoc.pod
index b30b25f..4a94957 100644
--- a/pod/perltoc.pod
+++ b/pod/perltoc.pod
@@ -17,6 +17,22 @@ through to locate the proper section you're looking for.
 
 =item SYNOPSIS
 
+=over 4
+
+=item Overview
+
+=item Tutorials
+
+=item Reference Manual
+
+=item Internals and C Language Interface
+
+=item Miscellaneous
+
+=item Platform-Specific
+
+=back
+
 =item DESCRIPTION
 
 =item AVAILABILITY
@@ -37,8 +53,56 @@ through to locate the proper section you're looking for.
 
 =back
 
-=head2 perlfaq - frequently asked questions about Perl ($Date: 1999/05/23
-20:38:02 $)
+=head2 perlintro -- a brief introduction and overview of Perl
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item What is Perl?
+
+=item Running Perl programs
+
+=item Basic syntax overview
+
+=item Perl variable types
+
+Scalars, Arrays, Hashes
+
+=item Variable scoping
+
+=item Conditional and looping constructs
+
+if, while, for, foreach
+
+=item Builtin operators and functions
+
+Arithmetic, Numeric comparison, String comparison, Boolean logic,
+Miscellaneous
+
+=item Files and I/O
+
+=item Regular expressions
+
+Simple matching, Simple substitution, More complex regular expressions,
+Parentheses for capturing, Other regexp features
+
+=item Writing subroutines
+
+=item OO Perl
+
+=item Using Perl modules
+
+=back
+
+=item AUTHOR
+
+=back
+
+=head2 perlfaq - frequently asked questions about Perl ($Date: 2001/10/16
+13:27:22 $)
 
 =over 4
 
@@ -238,7 +302,7 @@ unary &, unary *, (TYPE)
 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
-y/SEARCHLIST/REPLACEMENTLIST/cds
+y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF
 
 =item Gory details of parsing quoted constructs
 
@@ -334,48 +398,50 @@ I<-X> FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept
 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
 binmode FILEHANDLE, DISCIPLINE, binmode FILEHANDLE, bless REF,CLASSNAME,
 bless REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE,
-chomp LIST, chomp, chop VARIABLE, chop LIST, chop, chown LIST, chr NUMBER,
-chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE,
-connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT,
-dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete
-EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump,
-each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST,
-exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl
-FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION,
-fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin,
-getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam
-NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname
-NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr
-ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
-getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
-getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent
-STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
-endhostent, endnetent, endprotoent, endservent, getsockname SOCKET,
-getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL,
-goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex,
-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, 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 EXPR :
-ATTRIBUTES, next LABEL, next, no Module LIST, oct EXPR, oct, open
-FILEHANDLE,MODE,LIST, open FILEHANDLE,EXPR, open FILEHANDLE, opendir
-DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, 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
+chomp( LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr
+NUMBER, chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir
+DIRHANDLE, connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt
+PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR,
+defined, delete EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR,
+dump LABEL, dump, each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval
+BLOCK, exec LIST, exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp,
+fcntl FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock
+FILEHANDLE,OPERATION, fork, format, formline PICTURE,LIST, getc FILEHANDLE,
+getc, getlogin, getpeername SOCKET, getpgrp PID, getppid, getpriority
+WHICH,WHO, getpwnam NAME, getgrnam NAME, gethostbyname NAME, getnetbyname
+NAME, getprotobyname NAME, getpwuid UID, getgrgid GID, getservbyname
+NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE,
+getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, getgrent,
+gethostent, getnetent, getprotoent, getservent, setpwent, setgrent,
+sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent
+STAYOPEN, endpwent, endgrent, endhostent, endnetent, endprotoent,
+endservent, getsockname SOCKET, getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR,
+glob, gmtime EXPR, goto LABEL, goto EXPR, goto &NAME, grep BLOCK LIST, grep
+EXPR,LIST, hex EXPR, hex, 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, 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 EXPR : ATTRIBUTES,
+next LABEL, next, no Module LIST, oct EXPR, oct, open FILEHANDLE,EXPR, open
+FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE,
+opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR : ATTRIBUTES,
+pack TEMPLATE,LIST, package NAMESPACE, package, pipe
+READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos, print FILEHANDLE
+LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST, printf FORMAT,
+LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/, qq/STRING/,
+qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta, rand EXPR,
+rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read FILEHANDLE,SCALAR,LENGTH,
+readdir DIRHANDLE, readline EXPR, readlink EXPR, readlink, readpipe EXPR,
+recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, ref EXPR, ref, rename
+OLDNAME,NEWNAME, require VERSION, require EXPR, require, reset EXPR, reset,
+return EXPR, return, reverse LIST, rewinddir DIRHANDLE, rindex
+STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, rmdir, s///, scalar
+EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir DIRHANDLE,POS, select
+FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, semctl
+ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
 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,
@@ -471,11 +537,11 @@ more elaborate constructs
 
 =over 4
 
-=item Declaration of a ARRAY OF ARRAYS
+=item Declaration of an ARRAY OF ARRAYS
 
-=item Generation of a ARRAY OF ARRAYS
+=item Generation of an ARRAY OF ARRAYS
 
-=item Access and Printing of a ARRAY OF ARRAYS
+=item Access and Printing of an ARRAY OF ARRAYS
 
 =back
 
@@ -495,11 +561,11 @@ more elaborate constructs
 
 =over 4
 
-=item Declaration of a ARRAY OF HASHES
+=item Declaration of an ARRAY OF HASHES
 
-=item Generation of a ARRAY OF HASHES
+=item Generation of an ARRAY OF HASHES
 
-=item Access and Printing of a ARRAY OF HASHES
+=item Access and Printing of an ARRAY OF HASHES
 
 =back
 
@@ -579,7 +645,7 @@ more elaborate constructs
 
 =back
 
-=head2 perlpod - plain old documentation
+=head2 perlpod - the Plain Old Documentation format
 
 =over 4
 
@@ -587,20 +653,73 @@ more elaborate constructs
 
 =over 4
 
+=item Ordinary Paragraph
+
 =item Verbatim Paragraph
 
 =item Command Paragraph
 
-=item Ordinary Block of Text
+C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
+Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item
+I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end
+I<formatname>>, C<=for I<formatname> I<text...>>
+
+=item Formatting Codes
+
+C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
+C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink,
+C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used
+for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces,
+C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null
+(zero-effect) formatting code
 
 =item The Intent
 
 =item Embedding Pods in Perl Modules
 
-=item Common Pod Pitfalls
+=item Hints for Writing Pod
+
+=back
+
+=item SEE ALSO
+
+=item AUTHOR
 
 =back
 
+=head2 perlpodspec - Plain Old Documentation: format specification and
+notes
+
+=over 4
+
+=item DESCRIPTION
+
+=item Pod Definitions
+
+=item Pod Commands
+
+"=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
+"=back", "=begin formatname", "=end formatname", "=for formatname text..."
+
+=item Pod Formatting Codes
+
+C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
+C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
+filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
+null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
+C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
+contains non-breaking spaces
+
+=item Notes on Implementing Pod Processors
+
+=item About LE<lt>...E<gt> Codes
+
+First:, Second:, Third:, Fourth:, Fifth:, Sixth:
+
+=item About =over...=back Regions
+
+=item About Data Paragraphs and "=begin/=end" Regions
+
 =item SEE ALSO
 
 =item AUTHOR
@@ -648,7 +767,7 @@ Discontinuance, Deprecation, Discontinuance, Discontinuance
 
 =item Parsing Traps
 
-Parsing, Parsing, Parsing, Parsing
+Parsing, Parsing, Parsing, Parsing, Parsing
 
 =item Numerical Traps
 
@@ -732,7 +851,8 @@ B<-x> I<directory>
 
 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLLIB, PERL5DB, PERL5SHELL
 (specific to the Win32 port), PERL_DEBUG_MSTATS, PERL_DESTRUCT_LEVEL,
-PERL_ROOT (specific to the VMS port), SYS$LOGIN (specific to the VMS port)
+PERL_ENCODING, PERL_ROOT (specific to the VMS port), SYS$LOGIN (specific to
+the VMS port)
 
 =back
 
@@ -832,16 +952,17 @@ b [line] [condition], b subname [condition], b postpone subname
 command, a [line], A, W expr, W, O booloption .., O anyoption? .., O
 option=value .., < ?, < [ command ], << command, > ?, > command, >>
 command, { ?, { [ command ], {{ command, ! number, ! -number, ! pattern, !!
-cmd, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, man [manpage]
+cmd, @ file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, man
+[manpage]
 
 =item Configurable Options
 
 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
-C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<arrayDepth>,
-C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>, C<DumpDBFiles>,
-C<DumpPackages>, C<DumpReused>, C<quote>, C<HighBit>, C<undefPrint>,
-C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>, C<NonStop>
+C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
+C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
+C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>, C<HighBit>,
+C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>, C<NonStop>
 
 =item Debugger input/output
 
@@ -880,35 +1001,36 @@ listing
 
 =item Predefined Names
 
-$ARG, $_, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
-$LAST_PAREN_MATCH, $+, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*,
-input_line_number HANDLE EXPR, $INPUT_LINE_NUMBER, $NR, $,
-input_record_separator HANDLE EXPR, $INPUT_RECORD_SEPARATOR, $RS, $/,
-autoflush HANDLE EXPR, $OUTPUT_AUTOFLUSH, $|, output_field_separator HANDLE
-EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,, output_record_separator HANDLE
-EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS, $\, $LIST_SEPARATOR, $",
-$SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#, format_page_number HANDLE
-EXPR, $FORMAT_PAGE_NUMBER, $%, format_lines_per_page HANDLE EXPR,
-$FORMAT_LINES_PER_PAGE, $=, format_lines_left HANDLE EXPR,
-$FORMAT_LINES_LEFT, $-, @LAST_MATCH_START, @-, C<$`> is the same as
-C<substr($var, 0, $-[0])>, C<$&> is the same as C<substr($var, $-[0], $+[0]
-- $-[0])>, C<$'> is the same as C<substr($var, $+[0])>, C<$1> is the same
-as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2> is the same as
-C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as C<substr $var,
-$-[3], $+[3] - $-[3])>, format_name HANDLE EXPR, $FORMAT_NAME, $~,
-format_top_name HANDLE EXPR, $FORMAT_TOP_NAME, $^,
-format_line_break_characters HANDLE EXPR, $FORMAT_LINE_BREAK_CHARACTERS,
-$:, format_formfeed HANDLE EXPR, $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A,
-$CHILD_ERROR, $?, $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, $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M,
-$OSNAME, $^O, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
-0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S,
-$BASETIME, $^T, $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS},
-${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @INC, @_, %INC,
-%ENV, $ENV{expr}, %SIG, $SIG{expr}
+$ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
+$LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*,
+HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
+IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
+HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
+IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
+IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
+$\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#,
+HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
+HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
+HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
+@-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
+C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
+$+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
+is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
+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,
+$SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
+$PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80, 0x100, 0x200,
+$LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME,
+$^T, ${^TAINT}, $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS},
+${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, ARGV, $ARGV, @ARGV, @F, @INC,
+@_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
 
 =item Error Indicators
 
@@ -1340,7 +1462,7 @@ C<(?(condition)yes-pattern|no-pattern)>
 
 =back
 
-=head2 perltootc - Tom's OO Tutorial for Class Data in Perl
+=head2 perltooc - Tom's OO Tutorial for Class Data in Perl
 
 =over 4
 
@@ -1655,6 +1777,14 @@ string
 
 =item DESCRIPTION
 
+=back
+
+=head2 perlothrtut - old tutorial on threads in Perl
+
+=over 4
+
+=item DESCRIPTION
+
 =item What Is A Thread Anyway?
 
 =item Threaded Program Models
@@ -1842,19 +1972,20 @@ http://testers.cpan.org/
 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
 FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
-LIST, 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, gethostent, getnetent, getprotoent, getservent, setpwent,
-setgrent, 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
+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, gethostent, getnetent,
+getprotoent, getservent, setpwent, setgrent, 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,
@@ -1917,6 +2048,8 @@ localization)
 
 =item The localeconv function
 
+=item I18N::Langinfo
+
 =back
 
 =item LOCALE CATEGORIES
@@ -1978,6 +2111,56 @@ LC_NUMERIC, LC_TIME, LANG
 
 =back
 
+=head2 perluniintro - Perl Unicode introduction
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item Unicode
+
+=item Perl's Unicode Support
+
+=item Perl's Unicode Model
+
+=item Creating Unicode
+
+=item Handling Unicode
+
+=item Legacy Encodings
+
+=item Unicode I/O
+
+=item Special Cases
+
+=item Advanced Topics
+
+=item Miscellaneous
+
+=item Questions With Answers
+
+Will My Old Scripts Break?, How Do I Make My Scripts Work With Unicode?,
+How Do I Know Whether My String Is In Unicode?, How Do I Detect Invalid
+UTF-8?, How Do I Convert Data Into UTF-8?  Or Vice Versa?, How Do I Display
+Unicode?  How Do I Input Unicode?, How Does Unicode Work With Traditional
+Locales?
+
+=item Hexadecimal Notation
+
+=item Further Resources
+
+=back
+
+=item SEE ALSO
+
+=item ACKNOWLEDGEMENTS
+
+=item AUTHOR, COPYRIGHT, AND LICENSE
+
+=back
+
 =head2 perlunicode - Unicode support in Perl
 
 =over 4
@@ -1989,18 +2172,37 @@ LC_NUMERIC, LC_TIME, LANG
 =item Important Caveats
 
 Input and Output Disciplines, Regular Expressions, C<use utf8> still needed
-to enable a few features
+to enable UTF-8/UTF-EBCDIC in scripts
 
 =item Byte and Character semantics
 
 =item Effects of character semantics
 
+=item Scripts
+
+=item Blocks
+
 =item Character encodings for input and output
 
 =back
 
 =item CAVEATS
 
+=item UNICODE REGULAR EXPRESSION SUPPORT LEVEL
+
+=over 4
+
+=item Unicode Encodings
+
+UTF-8, UTF-16, UTF-16BE, UTF16-LE, Surrogates, and BOMs (Byte Order Marks),
+UTF-32, UTF-32BE, UTF32-LE, UCS-2, UCS-4, UTF-7
+
+=item Security Implications of Malformed UTF-8
+
+=item Unicode in Perl on EBCDIC
+
+=back
+
 =item SEE ALSO
 
 =back
@@ -2031,11 +2233,13 @@ to enable a few features
 
 =item POSIX-BC
 
+=item Unicode and UTF
+
 =back
 
 =item SINGLE OCTET TABLES
 
-recipe 0, recipe 1, recipe 2, recipe 3, recipe 4
+recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
 
 =item IDENTIFYING CHARACTER CODE SETS
 
@@ -2075,7 +2279,7 @@ chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
 
 =back
 
-=item TRANFORMATION FORMATS
+=item TRANSFORMATION FORMATS
 
 =over 4
 
@@ -2085,7 +2289,7 @@ chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
 
 =item Quoted-Printable encoding and decoding
 
-=item Caesarian cyphers
+=item Caesarian ciphers
 
 =back
 
@@ -2103,9 +2307,9 @@ chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
 
 IFS access
 
-=item OS/390 
+=item OS/390, z/OS
 
-chcp, dataset access, OS/390 iconv, locales
+chcp, dataset access, OS/390, z/OS iconv, locales
 
 =item VM/ESA?
 
@@ -2119,6 +2323,8 @@ chcp, dataset access, OS/390 iconv, locales
 
 =item REFERENCES
 
+=item HISTORY
+
 =item AUTHOR
 
 =back
@@ -2165,12 +2371,39 @@ chcp, dataset access, OS/390 iconv, locales
 
 =item Perl Modules
 
+=item Making your module threadsafe
+
 =back
 
 =item SEE ALSO
 
 =back
 
+=head2 perlmodinstall - Installing CPAN Modules
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item PREAMBLE
+
+B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
+module (sometimes unnecessary), B<INSTALL> the module
+
+=back
+
+=item PORTABILITY
+
+=item HEY
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
 =head2 perlmodlib - constructing new Perl modules and finding existing ones
 
 =over 4
@@ -2185,43 +2418,52 @@ chcp, dataset access, OS/390 iconv, locales
 
 attributes, attrs, autouse, base, blib, bytes, charnames, constant,
 diagnostics, fields, filetest, integer, less, locale, open, ops, overload,
-re, sigtrap, strict, subs, unicode::distinct, utf8, vars, warnings,
+re, sigtrap, strict, subs, threads, utf8, vars, warnings,
 warnings::register
 
 =item Standard Modules
 
-AnyDBM_File, AutoLoader, AutoSplit, B, B::Asmdata, B::Assembler, B::Bblock,
-B::Bytecode, B::C, B::CC, B::Concise, B::Debug, B::Deparse,
-B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash, B::Terse,
-B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp, CGI::Cookie,
-CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util, CPAN,
-CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA, Class::Struct,
-Cwd, DB, DB_File, Devel::SelfStubber, Digest, DirHandle, Dumpvalue, Encode,
-Encode::EncodeFormat, Encode::Tcl, English, Env, Exporter, Exporter::Heavy,
-ExtUtils::Command, ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed,
-ExtUtils::Liblist, ExtUtils::MM_Cygwin, ExtUtils::MM_OS2,
-ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
-ExtUtils::MakeMaker, ExtUtils::Manifest, ExtUtils::Mkbootstrap,
-ExtUtils::Mksymlists, ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl,
-File::Basename, File::CheckTree, File::Compare, File::Copy, File::DosGlob,
-File::Find, File::Path, File::Spec, File::Spec::Epoc,
-File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix,
-File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache,
-FileHandle, Filter::Simple, FindBin, Getopt::Long, Getopt::Std,
-I18N::Collate, IO, IPC::Open2, IPC::Open3, Locale::Constants,
-Locale::Country, Locale::Currency, Locale::Language, Math::BigFloat,
-Math::BigInt, Math::Complex, Math::Trig, NDBM_File, Net::Ping,
-Net::hostent, Net::netent, Net::protoent, Net::servent, O, ODBM_File,
-Opcode, POSIX, PerlIO, Pod::Checker, Pod::Find, Pod::Html,
-Pod::InputObjects, Pod::LaTeX, Pod::Man, Pod::ParseUtils, Pod::Parser,
-Pod::Plainer, Pod::Select, Pod::Text, Pod::Text::Color,
-Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe,
-Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch,
-Symbol, Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine, Test,
-Test::Harness, Text::Abbrev, Text::Balanced, Text::ParseWords,
-Text::Soundex, Text::Tabs, Text::Wrap, Tie::Array, Tie::Handle, Tie::Hash,
-Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::Local, Time::gmtime,
-Time::localtime, Time::tm, UNIVERSAL, User::grent, User::pwent, Win32
+AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
+B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
+B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
+B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
+CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
+CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
+Class::Struct, Cwd, DB, DB_File, Devel::SelfStubber, Digest, DirHandle,
+Dumpvalue, Encode, Encode::EncodeFormat, Encode::Tcl, English, Env,
+Exporter, Exporter::Heavy, ExtUtils::Command, ExtUtils::Constant,
+ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
+ExtUtils::MM_Cygwin, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_Unix,
+ExtUtils::MM_VMS, ExtUtils::MM_Win32, ExtUtils::MakeMaker,
+ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists,
+ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename,
+File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find,
+File::Path, File::Spec, File::Spec::Epoc, File::Spec::Functions,
+File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, File::Spec::VMS,
+File::Spec::Win32, File::Temp, File::stat, FileCache, FileHandle,
+Filter::Simple, FindBin, Getopt::Long, Getopt::Std, I18N::Collate,
+I18N::LangTags, I18N::LangTags::List, IO, IPC::Open2, IPC::Open3,
+Lingua::KO::Hangul::Util, Locale::Constants, Locale::Country,
+Locale::Currency, Locale::Language, Locale::Maketext,
+Locale::Maketext::TPJ13, Math::BigFloat, Math::BigInt, Math::BigInt::Calc,
+Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire,
+Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File,
+Memoize::SDBM_File, Memoize::Saves, Memoize::Storable, NDBM_File, NEXT,
+Net::Cmd, Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc,
+Net::POP3, Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ,
+Net::netent, Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX,
+PerlIO, Pod::Checker, Pod::Find, Pod::Html, Pod::InputObjects, Pod::LaTeX,
+Pod::Man, Pod::ParseUtils, Pod::Parser, Pod::Plainer, Pod::Select,
+Pod::Text, Pod::Text::Color, Pod::Text::Overstrike, Pod::Text::Termcap,
+Pod::Usage, SDBM_File, Safe, Search::Dict, SelectSaver, SelfLoader, Shell,
+Socket, Storable, Switch, Symbol, Term::ANSIColor, Term::Cap,
+Term::Complete, Term::ReadLine, Test, Test::Harness, Test::More,
+Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced,
+Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Tie::Array,
+Tie::Handle, Tie::Hash, Tie::RefHash, Tie::Scalar, Tie::SubstrHash,
+Time::Local, Time::gmtime, Time::localtime, Time::tm, UNIVERSAL,
+Unicode::Collate, Unicode::Normalize, Unicode::UCD, User::grent,
+User::pwent, Win32
 
 =item Extension Modules
 
@@ -2265,28 +2507,104 @@ Adding a Copyright Notice
 
 =back
 
-=head2 perlmodinstall - Installing CPAN Modules
+=head2 perlmodstyle - Perl module style guide
 
 =over 4
 
-=item DESCRIPTION
+=item INTRODUCTION
+
+=item QUICK CHECKLIST
 
 =over 4
 
-=item PREAMBLE
+=item Before you start
 
-B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
-module (sometimes unnecessary), B<INSTALL> the module
+=item The API
+
+=item Stability
+
+=item Documentation
+
+=item Release considerations
 
 =back
 
-=item PORTABILITY
+=item BEFORE YOU START WRITING A MODULE
 
-=item HEY
+=over 4
 
-=item AUTHOR
+=item Has it been done before?
 
-=item COPYRIGHT
+=item Do one thing and do it well
+
+=item What's in a name?
+
+=back
+
+=item DESIGNING AND WRITING YOUR MODULE
+
+=over 4
+
+=item To OO or not to OO?
+
+=item Designing your API
+
+Write simple routines to do simple things, Separate functionality from
+output, Provide sensible shortcuts and defaults, Naming conventions,
+Parameter passing
+
+=item Strictness and warnings
+
+=item Backwards compatibility
+
+=item Error handling and messages
+
+=back
+
+=item DOCUMENTING YOUR MODULE
+
+=over 4
+
+=item POD
+
+=item README, INSTALL, release notes, changelogs
+
+=back
+
+=item RELEASE CONSIDERATIONS
+
+=over 4
+
+=item Version numbering
+
+=item Pre-requisites
+
+=item Testing
+
+=item Packaging
+
+=item Licensing
+
+=back
+
+=item COMMON PITFALLS
+
+=over 4
+
+=item Reinventing the wheel
+
+=item Trying to do too much
+
+=item Inappropriate documentation
+
+=back
+
+=item SEE ALSO
+
+L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Testing tools,
+http://pause.perl.org/, Any good book on software engineering
+
+=item AUTHOR
 
 =back
 
@@ -2325,8 +2643,8 @@ tarball, Announce to the modules list, Announce to clpa, Fix bugs!
 
 =back
 
-=head2 perlfaq1 - General Questions About Perl ($Revision: 1.23 $, $Date:
-1999/05/23 16:08:30 $)
+=head2 perlfaq1 - General Questions About Perl ($Revision: 1.2 $, $Date:
+2001/11/09 08:06:04 $)
 
 =over 4
 
@@ -2372,8 +2690,8 @@ Scheme, or Tcl?
 
 =back
 
-=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.32 $,
-$Date: 1999/10/14 18:46:09 $)
+=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.3 $,
+$Date: 2001/11/09 08:06:04 $)
 
 =over 4
 
@@ -2428,8 +2746,8 @@ References, Tutorials, Task-Oriented, Special Topics
 
 =back
 
-=head2 perlfaq3 - Programming Tools ($Revision: 1.38 $, $Date: 1999/05/23
-16:08:30 $)
+=head2 perlfaq3 - Programming Tools ($Revision: 1.9 $, $Date: 2001/11/09
+08:06:04 $)
 
 =over 4
 
@@ -2455,8 +2773,8 @@ References, Tutorials, Task-Oriented, Special Topics
 
 =item Is there an IDE or Windows Perl Editor?
 
-CodeMagicCD, Komodo, The Object System, PerlBuilder, Perl code magic,
-visiPerl+, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright,
+Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+,
+CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright,
 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
 
 =item Where can I get Perl macros for vi?
@@ -2475,6 +2793,9 @@ MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
 
 =item How can I make my Perl program take less memory?
 
+Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
+stringification, Pass by reference, Tie large variables to disk
+
 =item Is it unsafe to return a pointer to local data?
 
 =item How can I free an array or hash so my program shrinks?
@@ -2513,8 +2834,8 @@ mean?
 
 =back
 
-=head2 perlfaq4 - Data Manipulation ($Revision: 1.49 $, $Date: 1999/05/23
-20:37:49 $)
+=head2 perlfaq4 - Data Manipulation ($Revision: 1.8 $, $Date: 2001/11/09
+08:06:04 $)
 
 =over 4
 
@@ -2532,7 +2853,12 @@ numbers I should be getting (eg, 19.95)?
 =item Does Perl have a round() function?  What about ceil() and floor()? 
 Trig functions?
 
-=item How do I convert bits into ints?
+=item How do I convert between numeric representations:
+
+B<How do I convert Hexadecimal into decimal:>, B<How do I convert from
+decimal to hexadecimal:>, B<How do I convert from octal to decimal:>, B<How
+do I convert from decimal to octal:>, B<How do I convert from binary to
+decimal:>, B<How do I convert from decimal to binary:>
 
 =item Why doesn't & work the way I want it to?
 
@@ -2630,7 +2956,8 @@ the tag
 
 a), b), c), d), e)
 
-=item How can I tell whether a list or array contains a certain element?
+=item How can I tell whether a certain element is contained in a list or
+array?
 
 =item How do I compute the difference of two arrays?  How do I compute the
 intersection of two arrays?
@@ -2722,8 +3049,8 @@ array of hashes or arrays?
 
 =back
 
-=head2 perlfaq5 - Files and Formats ($Revision: 1.38 $, $Date: 1999/05/23
-16:08:30 $)
+=head2 perlfaq5 - Files and Formats ($Revision: 1.4 $, $Date: 2001/11/09
+08:06:04 $)
 
 =over 4
 
@@ -2772,6 +3099,9 @@ filehandles between subroutines?  How do I make an array of filehandles?
 =item I still don't get locking.  I just want to increment the number in
 the file.  How can I do this?
 
+=item All I want to do is append a small amount of text to the end of a
+file.  Do I still have to use locking?
+
 =item How do I randomly update a binary file?
 
 =item How do I get a file's timestamp in perl?
@@ -2812,7 +3142,7 @@ protected files?  Isn't this a bug in Perl?
 
 =back
 
-=head2 perlfaq6 - Regexes ($Revision: 1.27 $, $Date: 1999/05/23 16:08:30 $)
+=head2 perlfaq6 - Regexes ($Revision: 1.4 $, $Date: 2001/11/09 08:06:04 $)
 
 =over 4
 
@@ -2878,8 +3208,8 @@ file?
 
 =back
 
-=head2 perlfaq7 - Perl Language Issues ($Revision: 1.28 $, $Date:
-1999/05/23 20:36:18 $)
+=head2 perlfaq7 - Perl Language Issues ($Revision: 1.4 $, $Date: 2001/11/07
+02:27:50 $)
 
 =over 4
 
@@ -2957,8 +3287,8 @@ is in scope?
 
 =back
 
-=head2 perlfaq8 - System Interaction ($Revision: 1.39 $, $Date: 1999/05/23
-18:37:57 $)
+=head2 perlfaq8 - System Interaction ($Revision: 1.4 $, $Date: 2001/11/09
+08:06:04 $)
 
 =over 4
 
@@ -3085,7 +3415,7 @@ search path?
 
 =back
 
-=head2 perlfaq9 - Networking ($Revision: 1.26 $, $Date: 1999/05/23 16:08:30
+=head2 perlfaq9 - Networking ($Revision: 1.5 $, $Date: 2001/11/09 08:06:04
 $)
 
 =over 4
@@ -3094,6 +3424,8 @@ $)
 
 =over 4
 
+=item What is the correct form of response from a CGI script?
+
 =item My CGI script runs from the command line but not the browser.  (500
 Server Error)
 
@@ -3226,6 +3558,8 @@ Perl?>, B<Use C from C?>, B<Use Perl from C?>
 
 =item Maintaining a persistent interpreter
 
+=item Execution of END blocks
+
 =item Maintaining multiple interpreter instances
 
 =item Using Perl modules, which themselves use C libraries, from your C
@@ -3450,7 +3784,7 @@ C<!!!>, C<!!>, C<!>
 
 =item The CLEANUP: Keyword
 
-=item The POST_CALL: Keyword
+=item The POSTCALL: Keyword
 
 =item The BOOT: Keyword
 
@@ -3482,6 +3816,10 @@ C<!!!>, C<!!>, C<!>
 
 =item The Typemap
 
+=item Safely Storing Static Data in XS
+
+MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
+
 =back
 
 =item EXAMPLES
@@ -3623,6 +3961,8 @@ save_hptr(HV **hptr)>
 
 =item Compile pass 3: peephole optimization
 
+=item Pluggable runops
+
 =back
 
 =item Examining internal data structures with the C<dump> functions
@@ -3675,6 +4015,8 @@ A, p, d, s, n, r, f, M, o, j, x
 
 =back
 
+=item Custom Operators
+
 =item AUTHORS
 
 =item SEE ALSO
@@ -3786,6 +4128,10 @@ L<roffitall|roffitall>
 
 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
 
+=item Administration
+
+L<libnetcfg|libnetcfg>
+
 =item Development
 
 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
@@ -3864,55 +4210,71 @@ B<filter_fetch_value>
 
 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,
-bytes_from_utf8, bytes_to_utf8, call_argv, call_method, call_pv, call_sv,
-CLASS, Copy, croak, CvSTASH, cv_const_sv, dMARK, dORIGMARK, dSP, dXSARGS,
-dXSI32, ENTER, eval_pv, eval_sv, EXTEND, fbm_compile, fbm_instr, FREETMPS,
-get_av, get_cv, get_hv, get_sv, GIMME, GIMME_V, GvSV, gv_fetchmeth,
-gv_fetchmethod, gv_fetchmethod_autoload, gv_stashpv, gv_stashsv, G_ARRAY,
-G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID, HEf_SVKEY, HeHASH, HeKEY,
-HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set, HeVAL, HvNAME, hv_clear,
-hv_delete, hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
+ax, bytes_from_utf8, bytes_to_utf8, call_argv, call_method, call_pv,
+call_sv, CLASS, Copy, croak, CvSTASH, cv_const_sv, dAX, dITEMS, dMARK,
+dORIGMARK, dSP, dXSARGS, dXSI32, ENTER, eval_pv, eval_sv, EXTEND,
+fbm_compile, fbm_instr, FREETMPS, getcwd_sv, get_av, get_cv, get_hv,
+get_sv, GIMME, GIMME_V, grok_bin, grok_hex, grok_number,
+grok_numeric_radix, grok_oct, GvSV, gv_fetchmeth, gv_fetchmethod,
+gv_fetchmethod_autoload, gv_stashpv, gv_stashsv, G_ARRAY, G_DISCARD,
+G_EVAL, G_NOARGS, G_SCALAR, G_VOID, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV,
+HeSVKEY, HeSVKEY_force, HeSVKEY_set, HeVAL, HvNAME, hv_clear, hv_delete,
+hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
 hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv,
 hv_iterval, hv_magic, hv_store, hv_store_ent, hv_undef, isALNUM, isALPHA,
 isDIGIT, isLOWER, isSPACE, isUPPER, is_utf8_char, is_utf8_string, items,
 ix, LEAVE, load_module, looks_like_number, MARK, mg_clear, mg_copy,
 mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set, Move, New, newAV,
-Newc, newCONSTSUB, newHV, newRV_inc, newRV_noinc, NEWSV, newSViv, newSVnv,
-newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
-newXS, newXSproto, Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv, ORIGMARK,
-perl_alloc, perl_construct, perl_destruct, perl_free, perl_parse, perl_run,
-PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, POPl, POPn,
-POPp, POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
-PUTBACK, Renew, Renewc, require_pv, RETVAL, Safefree, savepv, savepvn,
-SAVETMPS, SP, SPAGAIN, ST, strEQ, strGE, strGT, strLE, strLT, strNE,
-strnEQ, strnNE, StructCopy, SvCUR, SvCUR_set, SvEND, SvGETMAGIC, SvGROW,
-SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV,
-SvIOK_UV, SvIV, SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp,
-SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX, SvOK, SvOOK, SvPOK, SvPOKp,
-SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVX, SvPV_force,
-SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off,
-SvROK_on, SvRV, SvSETMAGIC, SvSetSV, SvSetSV_nosteal, SvSTASH, SvTAINT,
-SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, svtype, SVt_IV,
-SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUOK, SvUPGRADE,
-SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, sv_2mortal, sv_bless, sv_catpv,
-sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_mg, sv_catpv_mg, sv_catsv,
-sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_dec,
-sv_derived_from, sv_eq, sv_free, sv_gets, sv_grow, sv_inc, sv_insert,
-sv_isa, sv_isobject, sv_len, sv_len_utf8, sv_magic, sv_mortalcopy,
-sv_newmortal, sv_pvn_force, sv_pvutf8n_force, sv_reftype, sv_replace,
-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_mg, sv_setuv, sv_setuv_mg,
-sv_true, sv_unmagic, sv_unref, sv_unref_flags, sv_upgrade, sv_usepvn,
+Newc, newCONSTSUB, newHV, newRV_inc, newRV_noinc, NEWSV, newSV, newSViv,
+newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv,
+newSVuv, newXS, newXSproto, Newz, new_vstring, Nullav, Nullch, Nullcv,
+Nullhv, Nullsv, ORIGMARK, perl_alloc, perl_clone, perl_construct,
+perl_destruct, perl_free, perl_parse, perl_run, PL_modglobal, PL_na,
+PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, POPl, POPn, POPp, POPpbytex, POPpx,
+POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew, Renewc,
+require_pv, RETVAL, Safefree, savepv, savepvn, SAVETMPS, scan_bin,
+scan_hex, scan_oct, sharedsv_find, sharedsv_init, sharedsv_lock,
+sharedsv_new, sharedsv_thrcnt_dec, sharedsv_thrcnt_inc, sharedsv_unlock,
+sortsv, SP, SPAGAIN, ST, strEQ, strGE, strGT, strLE, strLT, strNE, strnEQ,
+strnNE, StructCopy, SvCUR, SvCUR_set, SvEND, SvGETMAGIC, SvGROW, SvIOK,
+SvIOKp, SvIOK_notUV, SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV,
+SvIOK_UV, SvIV, SvIVX, SvIVx, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK,
+SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVx, SvNVX, SvOK, SvOOK,
+SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV,
+SvPVbyte, SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen,
+SvPVutf8, SvPVutf8x, SvPVutf8x_force, SvPVutf8_force, SvPVutf8_nolen,
+SvPVX, SvPVx, SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT,
+SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSETMAGIC,
+SvSetMagicSV, SvSetMagicSV_nosteal, SvSetSV, SvSetSV_nosteal, SvSTASH,
+SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, svtype, SvTYPE,
+SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUOK,
+SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVx, SvUVX, sv_2bool,
+sv_2cv, sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen,
+sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv,
+sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn,
+sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags,
+sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm, sv_dec,
+sv_derived_from, sv_eq, sv_force_normal, sv_force_normal_flags, sv_free,
+sv_gets, sv_grow, sv_inc, sv_insert, sv_isa, sv_isobject, sv_iv, sv_len,
+sv_len_utf8, sv_magic, sv_mortalcopy, sv_newmortal, sv_newref, sv_nv,
+sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force,
+sv_pvn, sv_pvn_force, sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n,
+sv_pvutf8n_force, sv_recode_to_utf8, sv_reftype, sv_replace,
+sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv,
+sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg,
+sv_setpvn, sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv,
+sv_setref_pv, sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_flags,
+sv_setsv_mg, sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true,
+sv_unmagic, sv_unref, sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn,
 sv_usepvn_mg, sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode,
-sv_utf8_upgrade, sv_vcatpvfn, sv_vsetpvfn, THIS, toLOWER, toUPPER,
-utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length,
-utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8,
-warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XS, XSRETURN, XSRETURN_EMPTY,
-XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
-XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES,
-XS_VERSION, XS_VERSION_BOOTCHECK, Zero
+sv_utf8_upgrade, sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn,
+THIS, toLOWER, toUPPER, to_utf8_case, utf8n_to_uvchr, utf8n_to_uvuni,
+utf8_distance, utf8_hop, utf8_length, utf8_to_bytes, utf8_to_uvchr,
+utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8, warn, XPUSHi, XPUSHn, XPUSHp,
+XPUSHs, XPUSHu, XS, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO,
+XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNO,
+XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK,
+Zero
 
 =item AUTHORS
 
@@ -3928,7 +4290,8 @@ XS_VERSION, XS_VERSION_BOOTCHECK, Zero
 =item DESCRIPTION
 
 djSP, is_gv_magical, LVRET, PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn,
-PL_last_in_gv, PL_ofs_sv, PL_rs, start_glob
+PL_last_in_gv, PL_ofs_sv, PL_rs, report_uninit, start_glob, sv_add_arena,
+sv_clean_all, sv_clean_objs, sv_free_arenas
 
 =item AUTHORS
 
@@ -3952,9 +4315,6 @@ PL_last_in_gv, PL_ofs_sv, PL_rs, start_glob
 
 =item Data Structures
 
-1. The functions and attributes of the "layer class", 2. The per-instance
-data for a particular handle
-
 =item Functions and Attributes
 
 =item Per-instance Data
@@ -4046,301 +4406,347 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item DESCRIPTION
 
-=item Infrastructure
+=item To do during 5.6.x
 
 =over 4
 
-=item Mailing list archives
+=item Support for I/O disciplines
 
-=item Bug tracking system
+=item Autoload bytes.pm
 
-=item Regression Tests
+=item Make "\u{XXXX}" et al work
 
-Coverage, Regression, __DIE__, suidperl, The 25% slowdown from perl4 to
-perl5
+=item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
 
-=back
+=item Overloadable regex assertions
 
-=item Configure
+=item Unicode
 
-=over 4
+=item use Thread for iThreads
 
-=item Install HTML
+=item make perl_clone optionally clone ops
 
-=back
+=item Work out exit/die semantics for threads
 
-=item Perl Language
+=item Typed lexicals for compiler
 
-=over 4
+=item Compiler workarounds for Win32
 
-=item 64-bit Perl
+=item AUTOLOADing in the compiler
 
-=item Prototypes
+=item Fixing comppadlist when compiling
 
-Named prototypes, Indirect objects, Method calls, Context, Scoped subs
+=item Cleaning up exported namespace
 
-=back
+=item Complete signal handling
 
-=item Perl Internals
+=item Out-of-source builds
 
-=over 4
+=item POSIX realtime support
 
-=item magic_setisa
+=item UNIX98 support
 
-=item Garbage Collection
+=item IPv6 Support
 
-=item Reliable signals
+=item Long double conversion
 
-Alternate runops() for signal despatch, Figure out how to die() in delayed
-sighandler, Add tests for Thread::Signal, Automatic tests against CPAN
+=item Locales
 
-=item Interpolated regex performance bugs
+=item Thread-safe regexes
 
-=item Memory leaks from failed eval/regcomp
+=item Arithmetic on non-Arabic numerals
 
-=item Make XS easier to use
+=item POSIX Unicode character classes
 
-=item Make embedded Perl easier to use
+=item Factoring out common suffices/prefices in regexps (trie optimization)
 
-=item Namespace cleanup
+=item Security audit shipped utilities
 
-=item MULTIPLICITY
+=item Custom opcodes
 
-=item MacPerl
+=item DLL Versioning
 
-=back
+=item Introduce @( and @)
 
-=item Documentation
+=item Floating point handling
 
-=over 4
+=item IV/UV preservation
 
-=item A clear division into tutorial and reference
+=item Replace pod2html with something using Pod::Parser
 
-=item Remove the artificial distinction between operators and functions
+=item Automate module testing on CPAN
 
-=item More tutorials
+=item sendmsg and recvmsg
 
-Regular expressions, I/O, pack/unpack, Debugging
+=item Rewrite perlre documentation
 
-=item Include a search tool
+=item Convert example code to IO::Handle filehandles
 
-=item Include a locate tool
+=item Document Win32 choices
 
-=item Separate function manpages by default
+=item Check new modules
 
-=item Users can't find the manpages
+=item Make roffitall find pods and libs itself
 
-=item Install ALL Documentation
+=back
 
-=item Outstanding issues to be documented
+=item To do at some point
 
-=item Adapt www.linuxhq.com for Perl
+=over 4
 
-=item Replace man with a perl program
+=item Remove regular expression recursion
 
-=item Unicode tutorial
+=item Memory leaks after failed eval
 
-=back
+=item pack "(stuff)*"
 
-=item Modules
+=item bitfields in pack
 
-=over 4
+=item Cross compilation
 
-=item Update the POSIX extension to conform with the POSIX 1003.1 Edition 2
+=item Perl preprocessor / macros
 
-=item Module versions
+=item Perl lexer in Perl
 
-=item New modules
+=item Using POSIX calls internally
 
-=item Profiler
+=item -i rename file when changed
 
-=item Tie Modules
+=item All ARGV input should act like E<lt>E<gt>
 
-VecArray, SubstrArray, VirtualArray, ShiftSplice
+=item Support for rerunning debugger
 
-=item Procedural options
+=item Test Suite for the Debugger
 
-=item RPC
+=item my sub foo { }
 
-=item y2k localtime/gmtime
+=item One-pass global destruction
 
-=item Export File::Find variables
+=item Rewrite regexp parser
 
-=item Ioctl
+=item Cache recently used regexps
 
-=item Debugger attach/detach
+=item Re-entrant functions
 
-=item Regular Expression debugger
+=item Cross-compilation support
 
-=item Alternative RE Syntax
+=item Bit-shifting bitvectors
 
-=item Bundled modules
+=item debugger pragma
 
-=item Expect
+=item use less pragma
 
-=item GUI::Native
+=item switch structures
 
-=item Update semibroken auxiliary tools; h2ph, a2p, etc.
+=item Cache eval tree
 
-=item pod2html
+=item rcatmaybe
 
-=item Podchecker
+=item Shrink opcode tables
 
-=back
+=item Optimize away @_
 
-=item Tom's Wishes
+=item Prototypes versus indirect objects
 
-=over 4
+=item Install HTML
 
-=item Webperl
+=item Prototype method calls
 
-=item Mobile agents
+=item Return context prototype declarations
 
-=item POSIX on non-POSIX
+=item magic_setisa
 
-=item Portable installations
+=item Garbage collection
 
-=back
+=item IO tutorial
 
-=item Win32 Stuff
+=item pack/unpack tutorial
 
-=over 4
+=item Rewrite perldoc
 
-=item Rename new headers to be consistent with the rest
+=item Install .3p manpages
 
-=item Sort out the spawnvp() mess
+=item Unicode tutorial
 
-=item Work out DLL versioning
+=item Update POSIX.pm for 1003.1-2
 
-=item Style-check
+=item Retargetable installation
 
-=back
+=item POSIX emulation on non-POSIX systems
 
-=item Would be nice to have
+=item Rename Win32 headers
 
-C<pack "(stuff)*">, Contiguous bitfields in pack/unpack, lexperl, Bundled
-perl preprocessor, Use posix calls internally where possible, format
-BOTTOM, -i rename file only when successfully changed, All ARGV input
-should act like <>, report HANDLE [formats], support in perlmain to rerun
-debugger, lvalue functions
+=item Finish off lvalue functions
 
-=item Possible pragmas
+=item Update sprintf documentation
 
-=over 4
+=item Use fchown/fchmod internally
 
-=item 'less'
+=item Make v-strings overloaded objects
 
 =back
 
-=item Optimizations
+=item Vague ideas
 
 =over 4
 
-=item constant function cache
+=item ref() in list context
 
-=item foreach(reverse...)
+=item Make tr/// return histogram of characters in list context
 
-=item Cache eval tree
+=item Compile to real threaded code
 
-=item rcatmaybe
+=item Structured types
 
-=item Shrink opcode tables
+=item Modifiable $1 et al.
 
-=item Cache hash value
+=item Procedural interfaces for IO::*, etc.
 
-=item Optimize away @_ where possible
+=item RPC modules
 
-=item Optimize sort by { $a <=> $b }
+=item Attach/detach debugger from running program
 
-=item Rewrite regexp parser for better integrated optimization
+=item Alternative RE syntax module
 
-=back
+=item GUI::Native
 
-=item Vague possibilities
+=item foreach(reverse ...)
 
-ref function in list context, make tr/// return histogram in list context?,
-Loop control on do{} et al, Explicit switch statements, compile to real
-threaded code, structured types, Modifiable $1 et al
+=item Constant function cache
 
-=item To Do Or Not To Do
+=item Approximate regular expression matching
 
-=over 4
+=back
+
+=item Ongoing
 
-=item Making my() work on "package" variables
+=over 4
 
-=item "or" testing defined not truth
+=item Update guts documentation
 
-=item "dynamic" lexicals
+=item Add more tests
 
-=item "class"-based, rather than package-based "lexicals"
+=item Update auxiliary tools
 
 =back
 
-=item Threading
+=item Recently done things
 
 =over 4
 
-=item Modules
+=item Safe signal handling
 
-=item Testing
+=item Tie Modules
 
-=item $AUTOLOAD
+=item gettimeofday
 
-=item exit/die
+=item setitimer and getimiter
 
-=item External threads
+=item Testing __DIE__ hook
 
-=item Thread::Pool
+=item CPP equivalent in Perl
 
-=item thread-safety
+=item Explicit switch statements
 
-=item Per-thread GVs
+=item autocroak
 
-=back
+=item UTF/EBCDIC
 
-=item Compiler
+=item UTF Regexes
 
-=over 4
+=item perlcc to produce executable
 
-=item Optimization
+=item END blocks saved in compiled output
 
-=item Byteperl
+=item Secure temporary file module
 
-=item Precompiled modules
+=item Integrate Time::HiRes
 
-=item Executables
+=item Turn Cwd into XS
 
-=item Typed lexicals
+=item Mmap for input
 
-=item Win32
+=item Byte to/from UTF8 and UTF8 to/from local conversion
+
+=item Add sockatmark support
+
+=item Mailing list archives
+
+=item Bug tracking
+
+=item Integrate MacPerl
+
+=item Web "nerve center" for Perl
+
+=item Regular expression tutorial
+
+=item Debugging Tutorial
+
+=item Integrate new modules
 
-=item END blocks
+=item Integrate profiler
 
-=item _AUTOLOAD
+=item Y2K error detection
 
-=item comppadlist
+=item Regular expression debugger
 
-=item Cached compilation
+=item POD checker
+
+=item "Dynamic" lexicals
+
+=item Cache precompiled modules
 
 =back
 
-=item Recently Finished Tasks
+=item Deprecated Wishes
 
 =over 4
 
-=item Figure a way out of $^(capital letter)
+=item Loop control on do{}
 
-=item Filenames
+=item Lexically scoped typeglobs
 
-=item Foreign lines
+=item format BOTTOM
 
-=item Namespace cleanup
+=item report HANDLE
 
-=item ISA.pm
+=item Generalised want()/caller())
 
-=item gettimeofday
+=item Named prototypes
+
+=item Built-in globbing
+
+=item Regression tests for suidperl
+
+=item Cached hash values
+
+=item Add compression modules
+
+=item Reorganise documentation into tutorials/references
+
+=item Remove distinction between functions and operators
+
+=item Make XS easier to use
+
+=item Make embedding easier to use
+
+=item man for perl
+
+=item my $Package::variable
+
+=item "or" tests defined, not truth
+
+=item "class"-based lexicals
 
-=item autocroak?
+=item byteperl
+
+=item Lazy evaluation / tail recursion removal
+
+=item Make "use utf8" the default
+
+=item Unicode collation and normalization
+
+=item Create debugging macros
 
 =back
 
@@ -4365,9 +4771,21 @@ work?, Patches speak louder than words
 =item Keeping in sync
 
 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
-NFS, rsync'ing the patches, It's easier, It's more recent, It's more
-reliable, It's easier, It's a good reference, Finding a start point,
-Finding how to fix a bug, Finding the source of misbehaviour
+NFS, rsync'ing the patches
+
+=item Why rsync the source tree
+
+It's easier to rsync the source tree, It's more recent, It's more reliable
+
+=item Why rsync the patches
+
+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 Perlbug remote interface
+
+1 http://bugs.perl.org, 2 bugdb@perl.org, 3
+commands_and_bugdids@bugs.perl.org, notes, patches, tests
 
 =item Submitting patches
 
@@ -4376,7 +4794,7 @@ F<Porting/pumpkin.pod>, The perl5-porters FAQ
 
 =item Finding Your Way Around
 
-Core modules, Documentation, Configure, Interpreter
+Core modules, Tests, Documentation, Configure, Interpreter
 
 =item Elements of the interpreter
 
@@ -4403,6 +4821,15 @@ finish, 'enter', print
 
 =item Patching
 
+=item Patching a core module
+
+=item Adding a new function to the core
+
+=item Writing a test
+
+F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
+F<t/pod/>, F<t/run/>, t/base t/comp, t/cmd t/run t/io t/op, t/lib ext lib
+
 =back
 
 =item EXTERNAL TOOLS FOR DEBUGGING PERL
@@ -4423,9 +4850,18 @@ DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
 
 =item PERL_DESTRUCT_LEVEL
 
+=item Profiling
+
+=item Gprof Profiling
+
+-a, -b, -e routine, -f routine, -s, -z
+
+=item GCC gcov Profiling
+
 =item Pixie Profiling
 
--h, -l, -p, -h, -i, -l, -testcoverage, -zero
+-h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
+-z[ero]
 
 =item CONCLUSION
 
@@ -4481,6 +4917,136 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =back
 
+=head2 perl572delta - what's new for perl v5.7.2
+
+=over 4
+
+=item DESCRIPTION
+
+=item Security Vulnerability Closed
+
+=item Incompatible Changes
+
+=over 4
+
+=item 64-bit platforms and malloc
+
+=item AIX Dynaloading
+
+=item Socket Extension Dynamic in VMS
+
+=item Different Definition of the Unicode Character Classes \p{In...}
+
+=item Deprecations
+
+=back
+
+=item Core Enhancements
+
+=item Modules and Pragmata
+
+=over 4
+
+=item New Modules and Distributions
+
+=item Updated And Improved Modules and Pragmata
+
+=back
+
+=item Utility Changes
+
+=item New Documentation
+
+=item Installation and Configuration Improvements
+
+=over 4
+
+=item New Or Improved Platforms
+
+=item Generic Improvements
+
+=back
+
+=item Selected Bug Fixes
+
+=over 4
+
+=item Platform Specific Changes and Fixes
+
+=back
+
+=item New or Changed Diagnostics
+
+=item Source Code Enhancements
+
+=over 4
+
+=item MAGIC constants
+
+=item Better commented code
+
+=item Regex pre-/post-compilation items matched up
+
+=item gcc -Wall
+
+=back
+
+=item New Tests
+
+=item Known Problems
+
+=over 4
+
+=item AIX
+
+=item Amiga Perl Invoking Mystery
+
+=item lib/ftmp-security tests warn 'system possibly insecure'
+
+=item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
+
+=item HP-UX lib/io_multihomed Fails When LP64-Configured
+
+=item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
+
+=item Linux With Sfio Fails op/misc Test 48
+
+=item OS/390
+
+=item op/sprintf tests 129 and 130
+
+=item  Failure of Thread tests
+
+=item UNICOS
+
+=item UTS
+
+=item VMS
+
+=item Win32
+
+=item Localising a Tied Variable Leaks Memory
+
+=item Self-tying of Arrays and Hashes Is Forbidden
+
+=item Variable Attributes are not Currently Usable for Tieing
+
+=item Building Extensions Can Fail Because Of Largefiles
+
+=item The Compiler Suite Is Still Experimental
+
+=item The Long Double Support is Still Experimental
+
+=back
+
+=item Reporting Bugs
+
+=item SEE ALSO
+
+=item HISTORY
+
+=back
+
 =head2 perl571delta - what's new for perl v5.7.1
 
 =over 4
@@ -4493,6 +5059,16 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item Core Enhancements
 
+=over 4
+
+=item AUTOLOAD Is Now Lvaluable
+
+=item PerlIO is Now The Default
+
+=item Signals Are Now Safe
+
+=back
+
 =item Modules and Pragmata
 
 =over 4
@@ -5463,9 +6039,7 @@ long, Process terminated by SIG%s
 
 =item 64-bit Perl
 
-=item GDBM and Threads
-
-=item NFS filesystems and utime(2)
+=item AIX 4.2 and extensions using C++ with statics
 
 =back
 
@@ -5475,6 +6049,16 @@ long, Process terminated by SIG%s
 
 =back
 
+=head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
+
+=over 4
+
+=item DESCRIPTION
+
+=item AUTHOR
+
+=back
+
 =head2 perlamiga - Perl under Amiga OS
 
 =over 4
@@ -5489,7 +6073,7 @@ long, Process terminated by SIG%s
 
 =over 4
 
-=item Prerequisites
+=item Prerequisites for Compiling Perl on AmigaOS
 
 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
 
@@ -5505,31 +6089,29 @@ B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
 
 =over 4
 
-=item Manpages
+=item Manpages for Perl on AmigaOS
 
-=item B<HTML>
+=item Perl HTML Documentation on AmigaOS
 
-=item B<GNU> C<info> files
+=item Perl GNU Info Files on AmigaOS
 
-=item C<LaTeX> docs
+=item Perl LaTeX Documentation on AmigaOS
 
 =back
 
-=item BUILD
+=item BUILDING PERL ON AMIGAOS
 
 =over 4
 
-=item Prerequisites
-
-=item Getting the perl source
+=item Build Prerequisites for Perl on AmigaOS
 
-=item Making
+=item Getting the Perl Source for AmigaOS
 
-sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib
+=item Making Perl on AmigaOS
 
-=item Testing
+=item Testing Perl on AmigaOS
 
-=item Installing the built perl
+=item Installing the built Perl on AmigaOS
 
 =back
 
@@ -5539,6 +6121,26 @@ sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib
 
 =back
 
+=head2 perlbeos, README.beos - Perl version 5 on BeOS
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item General Issues with Perl on BeOS
+
+=item BeOS Release-specific Notes
+
+R4 x86, R4 PPC
+
+=item Contact Information
+
+=back
+
+=back
+
 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
 
 =over 4
@@ -5549,23 +6151,23 @@ sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib
 
 =over 4
 
-=item gzip
+=item gzip on BS2000
 
-=item bison
+=item bison on BS2000
 
-=item Unpacking
+=item Unpacking Perl Distribution on BS2000
 
-=item Compiling
+=item Compiling Perl on BS2000
 
-=item Testing
+=item Testing Perl on BS2000
 
-=item Install
+=item Installing Perl on BS2000
 
-=item Using Perl in the Posix-Shell
+=item Using Perl in the Posix-Shell of BS2000
 
 =item Using Perl in "native" BS2000
 
-=item Floating point anomalies
+=item Floating point anomalies on BS2000
 
 =back
 
@@ -5583,13 +6185,35 @@ sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib
 
 =back
 
+=over 4
+
+=item Name
+
+=item Description
+
+=item Build
+
+=over 4
+
+=item Tools & SDK
+
+=item Make
+
+=back
+
+=item Acknowledgements
+
+=item Author
+
+=back
+
 =head2 perlcygwin, README.cygwin - Perl for Cygwin
 
 =over 4
 
 =item SYNOPSIS
 
-=item PREREQUISITES
+=item PREREQUISITES FOR COMPILING PERL ON CYGWIN
 
 =over 4
 
@@ -5601,66 +6225,66 @@ C<PATH>, I<nroff>, Permissions
 
 =back
 
-=item CONFIGURE
+=item CONFIGURE PERL ON CYGWIN
 
 =over 4
 
-=item Strip Binaries
+=item Stripping Perl Binaries on Cygwin
 
-=item Optional Libraries
+=item Optional Libraries for Perl on Cygwin
 
 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
 C<-lcygipc> (C<use IPC::SysV>)
 
-=item Configure-time Options
+=item Configure-time Options for Perl on Cygwin
 
 C<-Uusedl>, C<-Uusemymalloc>, C<-Dusemultiplicity>, C<-Duseperlio>,
 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>
 
-=item Suspicious Warnings
+=item Suspicious Warnings on Cygwin
 
 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
 
 =back
 
-=item MAKE
+=item MAKE ON CYGWIN
 
 =over 4
 
-=item Warnings
+=item Warnings on Cygwin
 
-=item ld2
+=item ld2 on Cygwin
 
 =back
 
-=item TEST
+=item TEST ON CYGWIN
 
 =over 4
 
-=item File Permissions
+=item File Permissions on Cygwin
 
-=item Hard Links
+=item Hard Links on Cygwin
 
-=item Filetime Granularity
+=item Filetime Granularity on Cygwin
 
-=item Tainting Checks
+=item Tainting Checks on Cygwin
 
-=item /etc/group
+=item /etc/group on Cygwin
 
-=item Script Portability
+=item Script Portability on Cygwin
 
 Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous
 
 =back
 
-=item INSTALL
+=item INSTALL PERL ON CYGWIN
 
-=item MANIFEST
+=item MANIFEST ON CYGWIN
 
 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
 Source, Compiled Module Source, Perl Modules/Scripts
 
-=item BUGS
+=item BUGS ON CYGWIN
 
 =item AUTHORS
 
@@ -5668,48 +6292,124 @@ Source, Compiled Module Source, Perl Modules/Scripts
 
 =back
 
-=head2 perlepoc, README.epoc - Perl for EPOC
+=head2 perldgux - Perl under DG/UX.
 
 =over 4
 
 =item SYNOPSIS
 
-=item INTRODUCTION
-
-=item INSTALLING PERL ON EPOC
+=back
 
-=item STARTING PERL ON EPOC
+=over 4
 
-=item STOPPING PERL ON EPOC
+=item DESCRIPTION
 
-=item USING PERL ON EPOC
+=item BUILDING PERL ON DG/UX
 
 =over 4
 
-=item I/O Redirection
-
-=item PATH Names
+=item Non-threaded Perl on DG/UX
 
-=item Editors
+=item Threaded Perl on DG/UX
 
-=item Features
+=item Testing Perl on DG/UX
 
-=item Restrictions
-
-=item Compiling Perl 5 on the EPOC cross compiling environment
+=item Installing the built perl on DG/UX
 
 =back
 
-=item SUPPORT STATUS
-
 =item AUTHOR
 
-=item LAST UPDATE
+=item SEE ALSO
 
 =back
 
-=head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
-(HP-UX) systems
+=head2 perldos - Perl under DOS, W31, W95.
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Prerequisites for Compiling Perl on DOS
+
+DJGPP, Pthreads
+
+=item Shortcomings of Perl under DOS
+
+=item Building Perl on DOS
+
+=item Testing Perl on DOS
+
+=item Installation of Perl on DOS
+
+=back
+
+=item BUILDING AND INSTALLING MODULES ON DOS
+
+=over 4
+
+=item Building Prerequisites for Perl on DOS
+
+=item Unpacking CPAN Modules on DOS
+
+=item Building Non-XS Modules on DOS
+
+=item Building XS Modules on DOS
+
+=back
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
+=head2 perlepoc, README.epoc - Perl for EPOC
+
+=over 4
+
+=item SYNOPSIS
+
+=item INTRODUCTION
+
+=item INSTALLING PERL ON EPOC
+
+=item STARTING PERL ON EPOC
+
+=item STOPPING PERL ON EPOC
+
+=item USING PERL ON EPOC
+
+=over 4
+
+=item I/O Redirection on Epoc
+
+=item PATH Names on Epoc
+
+=item Editors on Epoc
+
+=item Features of Perl on Epoc
+
+=item Restrictions of Perl on Epoc
+
+=item Compiling Perl 5 on the EPOC cross compiling environment
+
+=back
+
+=item SUPPORT STATUS OF PERL ON EPOC
+
+=item AUTHOR
+
+=item LAST UPDATE
+
+=back
+
+=head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
+(HP-UX) systems
 
 =over 4
 
@@ -5717,6 +6417,8 @@ Source, Compiled Module Source, Perl Modules/Scripts
 
 =over 4
 
+=item Using perl as shipped with HP-UX
+
 =item Compiling Perl 5 on HP-UX
 
 =item PA-RISC
@@ -5727,32 +6429,56 @@ Source, Compiled Module Source, Perl Modules/Scripts
 
 =item PA-RISC 2.0
 
+=item Itanium
+
 =item Portability Between PA-RISC Versions
 
+=item Itanium Processor Family and HP-UX
+
 =item Building Dynamic Extensions on HP-UX
 
 =item The HP ANSI C Compiler
 
-=item Using Large Files with Perl
+=item Using Large Files with Perl on HP-UX
 
-=item Threaded Perl
+=item Threaded Perl on HP-UX
 
-=item 64-bit Perl
+=item 64-bit Perl on HP-UX
 
-=item GDBM and Threads
+=item GDBM and Threads on HP-UX
 
-=item NFS filesystems and utime(2)
+=item NFS filesystems and utime(2) on HP-UX
 
-=item perl -P and //
+=item perl -P and // and HP-UX
+
+=item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
 
 =back
 
+=item nss_delete core dump from op/pwent or op/grent
+
 =item AUTHOR
 
 =item DATE
 
 =back
 
+=head2 perlhurd, README.hurd - Perl version 5 on Hurd
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item Known Problems with Perl on Hurd 
+
+=back
+
+=item AUTHOR
+
+=back
+
 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
 systems
 
@@ -5764,11 +6490,11 @@ systems
 
 =item Compiling Perl 5 on MachTen
 
-=item Failures during C<make test>
+=item Failures during C<make test> on MachTen
 
 op/lexassign.t, pragma/warnings.t
 
-=item Building external modules
+=item Building external modules on MachTen
 
 =back
 
@@ -5792,27 +6518,88 @@ op/lexassign.t, pragma/warnings.t
 
 =back
 
-=head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
+=head2 perlmint, README.mint - Perl version 5 on Atari MiNT
+
+=over 4
+
+=item DESCRIPTION
+
+=item Known problems with Perl on MiNT
 
-=head1 SYNOPSIS
+=item AUTHOR
+
+=back
+
+=head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
 
 =over 4
 
-=item What's New
+=item SYNOPSIS
+
+=item NOTE
+
+=item What's New in Perl for MPE/iX
+
+=item Welcome to Perl/iX
 
-=item System Requirements
+=item System Requirements for Perl/iX
 
 =item How to Obtain Perl/iX
 
-=item Distribution Contents Highlights
+=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
 
-README, public_html/feedback.cgi,  4,  6
+ 4,  6
 
 =item Getting Started with Perl/iX
 
 =item MPE/iX Implementation Considerations
 
-=item Change History
+=item Known Perl/iX Bugs Under Investigation
+
+=item Perl/iX To-Do List
+
+=item Perl/iX Change History
+
+=item AUTHOR
+
+=item Name
+
+=item Description
+
+=item Build
+
+=over 4
+
+=item Tools & SDK
+
+=item Setup
+
+Buildtype.bat, SetNWBld.bat, MPKBuild.bat
+
+=item Make
+
+=item Interpreter
+
+=item Extensions
+
+=back
+
+=item Install
+
+=item Build new extensions
+
+=item Known Issues
+
+=item Acknowledgements
+
+=item Authors
+
+=item Date
 
 =back
 
@@ -6040,7 +6827,14 @@ C<HAB>, C<HMQ>
 
 =item Priorities
 
-=item DLL name mangling
+=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
 
@@ -6054,6 +6848,8 @@ C<COND_WAIT>, F<os2.c>
 
 =back
 
+=item BUGS
+
 =back
 
 =over 4
@@ -6074,25 +6870,25 @@ C<COND_WAIT>, F<os2.c>
 
 =over 4
 
-=item Unpacking
+=item Unpacking Perl distribution on OS/390
 
-=item Setup and utilities
+=item Setup and utilities for Perl on OS/390
 
-=item Configure
+=item Configure Perl on OS/390
 
-=item Build, test, install
+=item Build, Test, Install Perl on OS/390
 
-=item build anomalies
+=item Build Anomalies with Perl on OS/390
 
-=item testing anomalies
+=item Testing Anomalies with Perl on OS/390
 
-=item installation anomalies
+=item Installation Anomalies with Perl on OS/390
 
-=item Usage Hints
+=item Usage Hints for Perl on OS/390
 
-=item Floating point anomalies
+=item Floating Point Anomalies with Perl on OS/390
 
-=item Modules and Extensions
+=item Modules and Extensions for Perl on OS/390
 
 =back
 
@@ -6102,7 +6898,7 @@ C<COND_WAIT>, F<os2.c>
 
 =over 4
 
-=item Mailing list
+=item Mailing list for Perl on OS/390
 
 =back
 
@@ -6110,6 +6906,68 @@ C<COND_WAIT>, F<os2.c>
 
 =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 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 perlsolaris, README.solaris - Perl version 5 on Solaris systems
 
 =over 4
@@ -6130,11 +6988,11 @@ Solaris FAQ, Precompiled Binaries, Solaris Documentation
 
 =over 4
 
-=item File Extraction Problems.
+=item File Extraction Problems on Solaris.
 
-=item Compiler and Related Tools.
+=item Compiler and Related Tools on Solaris.
 
-=item Environment
+=item Environment for Compiling Perl on Solaris
 
 =back
 
@@ -6142,11 +7000,11 @@ Solaris FAQ, Precompiled Binaries, Solaris Documentation
 
 =over 4
 
-=item 64-bit Issues.
+=item 64-bit Issues with Perl on Solaris.
 
-=item Threads.
+=item Threads in Perl on Solaris.
 
-=item Malloc Issues.
+=item Malloc Issues with Perl on Solaris.
 
 =back
 
@@ -6160,17 +7018,19 @@ DATAMODEL_NATIVE specified", sh: ar: not found
 
 =over 4
 
-=item op/stat.t test 4
+=item op/stat.t test 4 in Solaris
+
+=item nss_delete core dump from op/pwent or op/grent
 
 =back
 
-=item PREBUILT BINARIES.
+=item PREBUILT BINARIES OF PERL FOR SOLARIS.
 
-=item RUNTIME ISSUES.
+=item RUNTIME ISSUES FOR PERL ON SOLARIS.
 
 =over 4
 
-=item Limits on Numbers of Open Files.
+=item Limits on Numbers of Open Files on Solaris.
 
 =back
 
@@ -6180,11 +7040,11 @@ DATAMODEL_NATIVE specified", sh: ar: not found
 
 =over 4
 
-=item Proc::ProcessTable
+=item Proc::ProcessTable on Solaris
 
-=item BSD::Resource
+=item BSD::Resource on Solaris
 
-=item Net::SSLeay
+=item Net::SSLeay on Solaris
 
 =back
 
@@ -6194,7 +7054,36 @@ DATAMODEL_NATIVE specified", sh: ar: not found
 
 =back
 
-=head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
+=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 64-bit Perl on Tru64
+
+=item Warnings about floating-point overflow when compiling Perl on Tru64
+
+=back
+
+=item Testing Perl on Tru64
+
+=item AUTHOR
+
+=back
+
+=head2 perluts - Perl under UTS
 
 =over 4
 
@@ -6202,28 +7091,33 @@ DATAMODEL_NATIVE specified", sh: ar: not found
 
 =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 Unpacking
+=item SYNOPSIS
+
+=item DESCRIPTION
 
-=item Setup and utilities
+=over 4
 
-=item Configure
+=item Unpacking Perl Distribution on VM/ESA
 
-Don't turn on the compiler optimization flag "-O".  There's a bug in the
-compiler (APAR PQ18812) that generates some bad code the optimizer is on,
-As VM/ESA doesn't fully support the fork() API programs relying on this
-call will not work. I've replaced fork()/exec() with spawn() and the
-standalone exec() with spawn(). This has a side effect when opening unnamed
-pipes in a shell script: there is no child process generated under
+=item Setup Perl and utilities on VM/ESA
 
-=item testing anomalies
+=item Configure Perl on VM/ESA
 
-=item Usage Hints
+=item Testing Anomalies of Perl on VM/ESA
 
-When using perl on VM/ESA please keep in mind that the EBCDIC and ASCII
-character sets are different.  Perl builtin functions that may behave
-differently under EBCDIC are mentioned in the perlport.pod document.
+=item Usage Hints for Perl on VM/ESA
 
 =back
 
@@ -6233,7 +7127,7 @@ differently under EBCDIC are mentioned in the perlport.pod document.
 
 =over 4
 
-=item Mailing list
+=item Mailing list for Perl on VM/ESA
 
 =back
 
@@ -6296,7 +7190,7 @@ LIST, waitpid PID,FLAGS
 
 =item Perl variables
 
-%ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $^S, $|
+%ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
 
 =item Standard modules with VMS-specific differences
 
@@ -6338,9 +7232,9 @@ LIST, waitpid PID,FLAGS
 
 =over 4
 
-=item Unimplemented Features
+=item Unimplemented Features of Perl on VOS
 
-=item Restrictions
+=item Restrictions of Perl on VOS
 
 =back
 
@@ -6352,6 +7246,48 @@ LIST, waitpid PID,FLAGS
 
 =back
 
+=head2 perlwin32 - Perl under Win32
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Setting Up Perl on Win32
+
+Make, Command Shell, Borland C++, Microsoft Visual C++, Mingw32 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, Running Perl Scripts, Miscellaneous Things
+
+=back
+
+=item BUGS AND CAVEATS
+
+=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>
+
+=item SEE ALSO
+
+=item HISTORY
+
+=back
+
 =head1 PRAGMA DOCUMENTATION
 
 =head2 attrs - set/get attributes of a subroutine (deprecated)
@@ -6376,7 +7312,8 @@ method, locked
 
 =back
 
-=head2 attributes - get/set subroutine or variable attributes
+=head2 threadshared::shared, threads::shared - Perl extension for sharing
+data structures between threads
 
 =over 4
 
@@ -6384,11 +7321,62 @@ method, locked
 
 =item DESCRIPTION
 
-=over 4
+=item EXPORT
 
-=item Built-in Attributes
+=item FUNCTIONS
 
-locked, method, lvalue
+share VARIABLE, lock VARIABLE, unlock VARIABLE, cond_wait VARIABLE,
+cond_signal VARIABLE, cond_broadcast VARIABLE
+
+=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 = new(function, LIST), $thread->join, $thread->detach,
+threads->self, $thread->tid
+
+=item TODO
+
+Fix so the return value is returned when you join, Add join_all, Fix memory
+leaks!
+
+=item AUTHOR and COPYRIGHT
+
+=item BUGS
+
+creating a thread from within a thread is unsafe under win32,
+PERL_OLD_SIGNALS are not threadsafe, will not be
+
+=item SEE ALSO
+
+=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
 
@@ -6490,7 +7478,7 @@ semantics
 =back
 
 =head2 charnames - define character names for C<\N{named}> string literal
-escape.
+escapes.
 
 =over 4
 
@@ -6500,6 +7488,8 @@ escape.
 
 =item CUSTOM TRANSLATORS
 
+=item charnames::viacode(code)
+
 =item BUGS
 
 =back
@@ -6514,7 +7504,17 @@ escape.
 
 =item NOTES
 
-=item TECHNICAL NOTE
+=over 4
+
+=item List constants
+
+=item Defining multiple constants at once
+
+=item Magic constants
+
+=back
+
+=item TECHNICAL NOTES
 
 =item BUGS
 
@@ -6551,6 +7551,21 @@ diagnostics
 
 =back
 
+=head2 encoding - pragma to control the conversion of legacy data into
+Unicode
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item KNOWN PROBLEMS
+
+=item SEE ALSO
+
+=back
+
 =head2 fields - compile-time class fields
 
 =over 4
@@ -6826,8 +7841,36 @@ C<strict refs>, C<strict vars>, C<strict subs>
 
 =back
 
-=head2 unicode::distinct - Perl pragma to strictly distinguish UTF8 data
-and non-UTF data.
+=head2 threads - Perl extension allowing use of interpreter based threads
+from perl
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+$thread = new(function, LIST), $thread->join, $thread->detach,
+threads->self, $thread->tid
+
+=item TODO
+
+Fix so the return value is returned when you join, Add join_all, Fix memory
+leaks!
+
+=item AUTHOR and COPYRIGHT
+
+=item BUGS
+
+creating a thread from within a thread is unsafe under win32,
+PERL_OLD_SIGNALS are not threadsafe, will not be
+
+=item SEE ALSO
+
+=back
+
+=head2 threadshared, threads::shared - Perl extension for sharing data
+structures between threads
 
 =over 4
 
@@ -6835,6 +7878,17 @@ and non-UTF data.
 
 =item DESCRIPTION
 
+=item EXPORT
+
+=item FUNCTIONS
+
+share VARIABLE, lock VARIABLE, unlock VARIABLE, cond_wait VARIABLE,
+cond_signal VARIABLE, cond_broadcast VARIABLE
+
+=item BUGS
+
+=item AUTHOR
+
 =item SEE ALSO
 
 =back
@@ -6871,6 +7925,18 @@ utf8::encode($string), $flag = utf8::decode($string)
 
 =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
@@ -6889,6 +7955,14 @@ warnings::warnif($object, $message)
 
 =head2 warnings::register - warnings import function
 
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
 =head1 MODULE DOCUMENTATION
 
 =head2 AnyDBM_File - provide framework for multiple DBMs
@@ -6911,6 +7985,49 @@ warnings::warnif($object, $message)
 
 =back
 
+=head2 Attribute::Handlers - Simpler definition of attribute handlers
+
+=over 4
+
+=item VERSION
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+[0], [1], [2], [3], [4], [5]
+
+=over 4
+
+=item Typed lexicals
+
+=item Type-specific attribute handlers
+
+=item Non-interpretive attribute handlers
+
+=item Phase-specific attribute handlers
+
+=item Attributes as C<tie> interfaces
+
+=back
+
+=item EXAMPLES
+
+=item DIAGNOSTICS
+
+C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
+attributes>, C<Declaration of %s attribute in package %s may clash with
+future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
+C<Can't autotie a %s>, C<Internal error: %s symbol went missing>
+
+=item AUTHOR
+
+=item BUGS
+
+=item COPYRIGHT
+
+=back
+
 =head2 AutoLoader - load subroutines only on demand
 
 =over 4
@@ -7086,8 +8203,9 @@ label, stash, file, cop_seq, arybase, line
 
 main_cv, init_av, main_root, main_start, comppadlist, sv_undef, sv_yes,
 sv_no, amagic_generation, walkoptree(OP, METHOD), walkoptree_debug(DEBUG),
-walksymtable(SYMREF, METHOD, RECURSE), svref_2object(SV), ppname(OPNUM),
-hash(STR), cast_I32(I), minus_c, cstring(STR), class(OBJ), threadsv_names
+walksymtable(SYMREF, METHOD, RECURSE, PREFIX), svref_2object(SV),
+ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR), class(OBJ),
+threadsv_names
 
 =item AUTHOR
 
@@ -7244,6 +8362,8 @@ B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
 
 =back
 
+=item Using B::Concise outside of the O framework
+
 =item AUTHOR
 
 =back
@@ -7270,7 +8390,7 @@ B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
 
 =item OPTIONS
 
-B<-l>, B<-p>, B<-q>, B<-u>I<PACKAGE>, B<-s>I<LETTERS>, B<C>, B<i>I<NUMBER>,
+B<-l>, B<-p>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>, B<i>I<NUMBER>,
 B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
 
 =item USING B::Deparse AS A MODULE
@@ -7283,6 +8403,10 @@ B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
 
 =item new
 
+=item ambient_pragmas
+
+strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
+
 =item coderef2text
 
 =back
@@ -7435,8 +8559,8 @@ TIMEDIFF, [ STYLE, [ FORMAT ] ] )
 =item Optional Exports
 
 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUT, CODEHASHREF, [
-STYLE ] ), cmpthese ( RESULTSHASHREF ), countit(TIME, CODE), disablecache (
-), enablecache ( ), timesum ( T1, T2 )
+STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
+disablecache ( ), enablecache ( ), timesum ( T1, T2 )
 
 =back
 
@@ -7655,7 +8779,8 @@ B<Parameters:>
 
 =item CREATING A CLICKABLE IMAGE BUTTON
 
-B<Parameters:>
+B<Parameters:>, 3. The third option (-align, optional) is an alignment
+type, and may be TOP, BOTTOM or MIDDLE
 
 =item CREATING A JAVASCRIPT ACTION BUTTON
 
@@ -7685,8 +8810,9 @@ the <FORM> tag
 =item FETCHING ENVIRONMENT VARIABLES
 
 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
-B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>,
-B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
+B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
+name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
+()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
 B<request_method()>, B<content_type()>, B<http()>, B<https()>
 
@@ -7828,6 +8954,10 @@ B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
 
 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
 
+=item EXTERNAL FASTCGI SERVER INVOCATION
+
+FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
+
 =item CAVEATS
 
 =item AUTHOR INFORMATION
@@ -8162,9 +9292,10 @@ C<_a>, C<_exe>, C<_o>
 
 =item a
 
-C<afs>, C<alignbytes>, C<ansi2knr>, C<aphostname>, C<api_revision>,
-C<api_subversion>, C<api_version>, C<api_versionstring>, C<ar>, C<archlib>,
-C<archlibexp>, C<archname64>, C<archname>, C<archobjs>, C<awk>
+C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
+C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
+C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
+C<awk>
 
 =item b
 
@@ -8176,13 +9307,9 @@ C<byacc>, C<byteorder>
 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
-C<clocktype>, C<comm>, C<compress>
-
-=item C
-
-C<CONFIGDOTSH>, C<contains>, C<cp>, C<cpio>, C<cpp>, C<cpp_stuff>,
-C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>, C<cpprun>,
-C<cppstdin>, C<cppsymbols>, C<crosscompile>, C<cryptlib>, C<csh>
+C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
+C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
+C<cpprun>, C<cppstdin>, C<cppsymbols>, C<cryptlib>, C<csh>
 
 =item d
 
@@ -8190,48 +9317,51 @@ C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>,
 C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>, C<d_bcopy>,
 C<d_bincompat5005>, 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_closedir>, C<d_cmsghdr_s>, C<d_const>, C<d_crypt>,
-C<d_csh>, C<d_cuserid>, C<d_dbl_dig>, C<d_difftime>, C<d_dirnamlen>,
-C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, C<d_drand48proto>,
-C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endhent>, C<d_endnent>,
-C<d_endpent>, C<d_endpwent>, C<d_endsent>, C<d_eofnblk>, C<d_eunice>,
-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_flexfnam>, C<d_flock>,
-C<d_fork>, C<d_fpathconf>, C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>,
-C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>,
-C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>,
-C<d_getfsstat>, C<d_getgrent>, C<d_getgrps>, C<d_gethbyaddr>,
-C<d_gethbyname>, C<d_gethent>, C<d_gethname>, C<d_gethostprotos>,
-C<d_getitimer>, C<d_getlogin>, C<d_getmnt>, C<d_getmntent>,
-C<d_getnbyaddr>, C<d_getnbyname>, C<d_getnent>, 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_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>, C<d_getsbyname>,
-C<d_getsbyport>, C<d_getsent>, C<d_getservprotos>, C<d_getspnam>,
-C<d_gettimeod>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>,
-C<d_iconv>, C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>,
-C<d_isnan>, C<d_isnanl>, C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>,
-C<d_link>, C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>,
-C<d_lseekproto>, C<d_lstat>, C<d_madvise>, C<d_mblen>, C<d_mbstowcs>,
-C<d_mbtowc>, C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>,
-C<d_memset>, C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>,
-C<d_mkstemps>, C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_mprotect>, C<d_msg>,
-C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>,
-C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>,
-C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>,
+C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>,
+C<d_crypt>, C<d_csh>, C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>,
+C<d_difftime>, C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>,
+C<d_dosuid>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>,
+C<d_endhent>, C<d_endnent>, C<d_endpent>, C<d_endpwent>, C<d_endsent>,
+C<d_eofnblk>, C<d_eunice>, 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_getgrps>,
+C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
+C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getmnt>,
+C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>, C<d_getnent>,
+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_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
+C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>, C<d_getservprotos>,
+C<d_getspnam>, C<d_gettimeod>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
+C<d_htonl>, C<d_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_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_mprotect>, C<d_msg>, C<d_msg_ctrunc>,
+C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>,
+C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, C<d_msgsnd>,
+C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nl_langinfo>,
 C<d_nv_preserves_uv>, C<d_nv_preserves_uv_bits>, C<d_off64_t>,
 C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
 C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
 C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
 C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
 C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>,
-C<d_PRIx64>, C<d_PRIXU64>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
-C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
-C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_readdir>, C<d_readlink>,
-C<d_readv>, C<d_recvmsg>, C<d_rename>, C<d_rewinddir>, C<d_rmdir>,
-C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>, C<d_sbrkproto>,
-C<d_sched_yield>, C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>,
-C<d_select>, C<d_sem>, C<d_semctl>, C<d_semctl_semid_ds>,
+C<d_PRIx64>, C<d_PRIXU64>, C<d_pthread_atfork>, C<d_pthread_yield>,
+C<d_pwage>, C<d_pwchange>, C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>,
+C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>, C<d_qgcvt>, C<d_quad>,
+C<d_readdir>, C<d_readlink>, C<d_readv>, C<d_recvmsg>, C<d_rename>,
+C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>,
+C<d_sbrkproto>, C<d_sched_yield>, C<d_scm_rights>, C<d_SCNfldbl>,
+C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>, C<d_semctl_semid_ds>,
 C<d_semctl_semun>, C<d_semget>, C<d_semop>, C<d_sendmsg>, C<d_setegid>,
 C<d_seteuid>, C<d_setgrent>, C<d_setgrps>, C<d_sethent>, C<d_setitimer>,
 C<d_setlinebuf>, C<d_setlocale>, C<d_setnent>, C<d_setpent>, C<d_setpgid>,
@@ -8240,34 +9370,38 @@ C<d_setpwent>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>,
 C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setsid>,
 C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>, C<d_shmatprototype>,
 C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>, C<d_sigprocmask>,
-C<d_sigsetjmp>, C<d_sockatmark>, C<d_socket>, C<d_socklen_t>,
-C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>, C<d_statblks>,
-C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>,
-C<d_stdio_ptr_lval>, C<d_stdio_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_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_sysconf>, C<d_sysernlst>,
-C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
-C<d_telldirproto>, C<d_time>, C<d_times>, C<d_truncate>, C<d_tzname>,
-C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
-C<d_usleep>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>, C<d_vendorlib>,
-C<d_vfork>, C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>, C<d_volatile>,
-C<d_vprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>,
-C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>, C<db_prefixtype>,
-C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>, C<doublesize>,
-C<drand01>, C<dynamic_ext>
+C<d_sigsetjmp>, C<d_sockatmark>, C<d_sockatmarkproto>, C<d_socket>,
+C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>,
+C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>,
+C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
+C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>,
+C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>,
+C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_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_truncate>, 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_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<dynamic_ext>
 
 =item e
 
 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<eunicefix>,
-C<exe_ext>, C<expr>, C<extensions>
+C<exe_ext>, C<expr>, C<extensions>, C<extras>
 
 =item f
 
 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
-C<fpossize>, C<fpostype>, C<freetype>, C<full_ar>, C<full_csh>, C<full_sed>
+C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
+C<full_sed>
 
 =item g
 
@@ -8282,28 +9416,28 @@ C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>
 
 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_db>, C<i_dbm>,
-C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>, C<i_gdbm>,
-C<i_grp>, C<i_iconv>, C<i_ieeefp>, C<i_inttypes>, C<i_libutil>,
-C<i_limits>, C<i_locale>, C<i_machcthr>, C<i_malloc>, C<i_math>,
-C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>, C<i_neterrno>,
-C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>, C<i_pthread>, C<i_pwd>,
-C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>, C<i_socks>,
-C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>, C<i_sunmath>,
-C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>, C<i_sysin>,
-C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>, C<i_sysmount>,
-C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>, C<i_sysselct>,
-C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>, C<i_sysstatvfs>,
-C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>, C<i_sysuio>,
-C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>, C<i_termio>,
-C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>, C<i_values>,
-C<i_varargs>, C<i_varhdr>, C<i_vfork>, C<ignore_versioned_solibs>,
-C<inc_version_list>, C<inc_version_list_init>, C<incpath>, C<inews>,
-C<installarchlib>, C<installbin>, C<installman1dir>, C<installman3dir>,
-C<installprefix>, C<installprefixexp>, C<installprivlib>, C<installscript>,
-C<installsitearch>, C<installsitebin>, C<installsitelib>, C<installstyle>,
-C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>,
-C<installvendorlib>, C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>,
-C<ivtype>
+C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>, C<i_fp>,
+C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
+C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
+C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
+C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
+C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
+C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
+C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
+C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
+C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
+C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
+C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
+C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
+C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
+C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
+C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
+C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>,
+C<installman3dir>, C<installprefix>, C<installprefixexp>,
+C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>,
+C<installsitelib>, C<installstyle>, C<installusrbinperl>,
+C<installvendorarch>, C<installvendorbin>, C<installvendorlib>, C<intsize>,
+C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
 
 =item k
 
@@ -8344,7 +9478,7 @@ C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
 =item p
 
 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
-C<perl>
+C<perl>, C<perl_patchlevel>
 
 =item P
 
@@ -8360,7 +9494,7 @@ C<quadkind>, C<quadtype>
 =item r
 
 C<randbits>, C<randfunc>, C<randseedtype>, C<ranlib>, C<rd_nodata>,
-C<revision>, C<rm>, C<rmail>, C<runnm>
+C<revision>, C<rm>, C<rmail>, C<run>, C<runnm>
 
 =item s
 
@@ -8381,26 +9515,27 @@ C<stdio_stream_array>, C<strings>, C<submit>, C<subversion>, C<sysman>
 
 =item t
 
-C<tail>, C<tar>, C<tbl>, C<tee>, C<test>, C<timeincl>, C<timetype>,
-C<touch>, C<tr>, C<trnl>, C<troff>
+C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
+C<timetype>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>
 
 =item u
 
 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
-C<use64bitint>, C<usedl>, C<useithreads>, C<uselargefiles>,
-C<uselongdouble>, C<usemorebits>, C<usemultiplicity>, C<usemymalloc>,
-C<usenm>, C<useopcode>, C<useperlio>, C<useposix>, 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<use64bitint>, C<usecrosscompile>, C<usedl>, 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>
 
 =item v
 
 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
 C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>,
-C<vendorprefixexp>, C<version>, C<versiononly>, C<vi>, C<voidflags>
+C<vendorprefixexp>, C<version>, C<version_patchlevel_string>,
+C<versiononly>, C<vi>, C<voidflags>
 
 =item x
 
@@ -8428,6 +9563,24 @@ C<zcat>, C<zip>
 
 =item DESCRIPTION
 
+=over 4
+
+=item getcwd and friends
+
+getcwd, cwd, fastcwd, fastgetcwd
+
+=item abs_path and friends
+
+abs_path, realpath, fast_abs_path
+
+=item $ENV{PWD}
+
+=back
+
+=item NOTES
+
+=item SEE ALSO
+
 =back
 
 =head2 DB - programmatic interface to the Perl debugging API (draft,
@@ -8479,7 +9632,7 @@ B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
 
 =over 4
 
-=item Using DB_File with Berkeley DB version 2 or 3
+=item Using DB_File with Berkeley DB version 2 or greater
 
 =item Interface to Berkeley DB
 
@@ -8528,7 +9681,8 @@ B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
 =item Extra RECNO Methods
 
 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
-B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>
+B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
+length, elements);>
 
 =item Another Example
 
@@ -8637,7 +9791,10 @@ $Data::Dumper::Toaster	I<or>  $I<OBJ>->Toaster(I<[NEWVAL]>),
 $Data::Dumper::Deepcopy  I<or>	$I<OBJ>->Deepcopy(I<[NEWVAL]>),
 $Data::Dumper::Quotekeys  I<or>  $I<OBJ>->Quotekeys(I<[NEWVAL]>),
 $Data::Dumper::Bless  I<or>  $I<OBJ>->Bless(I<[NEWVAL]>),
-$Data::Dumper::Maxdepth  I<or>	$I<OBJ>->Maxdepth(I<[NEWVAL]>)
+$Data::Dumper::Maxdepth  I<or>	$I<OBJ>->Maxdepth(I<[NEWVAL]>),
+$Data::Dumper::Useperl	I<or>  $I<OBJ>->Useperl(I<[NEWVAL]>),
+$Data::Dumper::Sortkeys  I<or>	$I<OBJ>->Sortkeys(I<[NEWVAL]>),
+$Data::Dumper::Deparse	I<or>  $I<OBJ>->Deparse(I<[NEWVAL]>)
 
 =item Exports
 
@@ -8687,6 +9844,8 @@ Dumper
 
 =over 4
 
+=item Runtime debugging
+
 =item Memory footprint debugging
 
 =back
@@ -8792,6 +9951,8 @@ $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
 
 =item DESCRIPTION
 
+=item NOTES
+
 =back
 
 =head2 Dumpvalue - provides screen dump of Perl data.
@@ -8807,8 +9968,8 @@ $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
 =item Creation
 
 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
-C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<tick>, C<HighBit>,
-C<printUndef>, C<UsageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
+C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
+C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
 stopDbSignal
 
 =item Methods
@@ -8882,8 +10043,8 @@ Fixed length 32-bit encodings, Multi-byte encodings, "Escape" encodings
 
 =item Encoding Names
 
-The MIME name as defined in IETF RFC-XXXX, The name in the IANA registry,
-The name used by the the organization that defined it
+The MIME name as defined in IETF RFCs, The name in the IANA registry, The
+name used by the organization that defined it
 
 =back
 
@@ -8917,7 +10078,7 @@ reference, e.g.:
 =item Encoding How to ...
 
 IO with mixed content (faking iso-2020-*), MIME's Content-Length:, UTF-8
-strings in binary data, perl/Encode wrappers on non-Unicode XS modules
+strings in binary data, Perl/Encode wrappers on non-Unicode XS modules
 
 =item Messing with Perl's Internals
 
@@ -9069,7 +10230,7 @@ cat
 
 eqtime src dst
 
-rm_f files...
+rm_rf files...
 
 rm_f files...
 
@@ -9095,6 +10256,58 @@ test_f file
 
 =back
 
+=head2 ExtUtils::Constant - generate XS code to import C header constants
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item USAGE
+
+IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
+
+=item FUNCTIONS
+
+=back
+
+C_stringify NAME
+
+constant_types
+
+memEQ_clause NAME, CHECKED_AT, INDENT
+
+assign INDENT, TYPE, PRE, POST, VALUE..
+
+return_clause
+
+switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
+
+params WHAT
+
+dump_names
+
+dogfood
+
+C_constant, name, type, value, macro, default, pre, post, def_pre =item
+def_post
+
+XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
+
+autoload PACKAGE, VERSION, AUTOLOADER
+
+WriteMakefileSnippet
+
+WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
+BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
+
+=over 4
+
+=item AUTHOR
+
+=back
+
 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
 
 =over 4
@@ -9196,6 +10409,53 @@ canonpath, cflags, manifypods, perl_archive
 
 =back
 
+=head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
+ExtUtils::MakeMaker
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
+catfile
+
+constants (o)
+
+static_lib (o)
+
+dynamic_bs (o)
+
+dynamic_lib (o)
+
+canonpath
+
+perl_script
+
+pm_to_blib
+
+test_via_harness (o)
+
+tool_autosplit (override)
+
+tools_other (o)
+
+xs_o (o)
+
+top_targets (o)
+
+htmlifypods (o)
+
+manifypods (o)
+
+dist_ci (o)
+
+dist_core (o)
+
+pasthru (o)
+
 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
 ExtUtils::MakeMaker
 
@@ -9371,6 +10631,8 @@ prefixify
 
 processPL (o)
 
+quote_paren
+
 realclean (o)
 
 replace_manpage_separator
@@ -9613,7 +10875,7 @@ pasthru (o)
 
 =item Using Attributes and Parameters
 
-ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CAPI, CCFLAGS, CONFIG,
+ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
 CONFIGURE, DEFINE, DIR, DISTNAME, DL_FUNCS, DL_VARS, EXCLUDE_EXT,
 EXE_FILES, FIRST_MAKEFILE, FULLPERL, FUNCLIST, H, HTMLLIBPODS,
 HTMLSCRIPTPODS, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
@@ -9623,11 +10885,12 @@ INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITELIB, INST_ARCHLIB, INST_BIN,
 INST_EXE, INST_HTMLLIBDIR, INST_HTMLSCRIPTDIR, INST_LIB, INST_MAN1DIR,
 INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE,
 MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME,
-NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERLMAINCC,
-PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERL_SRC, PERM_RW, PERM_RWX,
-PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
-PPM_INSTALL_SCRIPT, PREFIX, PREREQ_PM, SKIP, TYPEMAPS, VERSION,
-VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION
+NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERL_CORE,
+PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLRUN, PERM_RW,
+PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
+PPM_INSTALL_SCRIPT, PREFIX, PREREQ_PM, PREREQ_FATAL, PREREQ_PRINT,
+PRINT_PREREQ, SKIP, TEST_LIBS, VERSION, VERSION_FROM, XS, XSOPT,
+XSPROTOARG, XS_VERSION
 
 =item Additional lowercase attributes
 
@@ -9650,7 +10913,7 @@ shdist,    make zipdist,    make ci
 
 =item ENVIRONMENT
 
-PERL_MM_OPT
+PERL_MM_OPT, PERL_MM_USE_DEFAULT
 
 =item SEE ALSO
 
@@ -9840,6 +11103,8 @@ rmscopy($from,$to[,$date_flag])
 
 =item RETURN
 
+=item NOTES
+
 =item AUTHOR
 
 =back
@@ -9852,6 +11117,8 @@ rmscopy($from,$to[,$date_flag])
 
 =item DESCRIPTION
 
+=item NOTES
+
 =item EXPORTS (by request only)
 
 =item BUGS
@@ -9873,11 +11140,19 @@ rmscopy($from,$to[,$date_flag])
 =item DESCRIPTION
 
 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
-C<follow_fast>, C<follow_skip>, C<no_chdir>, C<untaint>,
-C<untaint_pattern>, C<untaint_skip>
+C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
+C<untaint>, C<untaint_pattern>, C<untaint_skip>
+
+=item WARNINGS
 
 =item CAVEAT
 
+$dont_use_nlink, symlinks
+
+=item NOTES
+
+=item HISTORY
+
 =back
 
 =head2 File::Glob - Perl extension for BSD glob routine
@@ -9888,9 +11163,9 @@ C<untaint_pattern>, C<untaint_skip>
 
 =item DESCRIPTION
 
-C<GLOB_ERR>, 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>
+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>
 
 =item DIAGNOSTICS
 
@@ -9922,6 +11197,12 @@ C<GLOB_NOSPACE>, C<GLOB_ABEND>
 
 =item DESCRIPTION
 
+=item METHODS
+
+canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
+no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
+splitdir, catpath(), abs2rel, rel2abs()
+
 =item SEE ALSO
 
 =item AUTHORS
@@ -9944,7 +11225,7 @@ tmpdir
 
 path
 
-canonpath
+canonpath()
 
 splitpath
 
@@ -9954,7 +11235,7 @@ catpath
 
 abs2rel
 
-rel2abs
+rel2abs()
 
 =over 4
 
@@ -9980,7 +11261,7 @@ rel2abs
 
 =back
 
-=head2 File::Spec::Mac - File::Spec for MacOS
+=head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
 
 =over 4
 
@@ -9994,7 +11275,7 @@ canonpath
 
 =back
 
-catdir
+catdir()
 
 catfile
 
@@ -10024,6 +11305,8 @@ rel2abs
 
 =over 4
 
+=item AUTHORS
+
 =item SEE ALSO
 
 =back
@@ -10038,7 +11321,8 @@ rel2abs
 
 =back
 
-=head2 File::Spec::Unix - methods used by File::Spec
+=head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
+modules
 
 =over 4
 
@@ -10048,11 +11332,11 @@ rel2abs
 
 =item METHODS
 
-canonpath
+canonpath()
 
 =back
 
-catdir
+catdir()
 
 catfile
 
@@ -10080,11 +11364,11 @@ splitpath
 
 splitdir
 
-catpath
+catpath()
 
 abs2rel
 
-rel2abs
+rel2abs()
 
 =over 4
 
@@ -10324,6 +11608,25 @@ $fh->print, $fh->printf, $fh->getline, $fh->getlines
 
 =item A Solution
 
+=item Disabling or changing <no> behaviour
+
+=item All-in-one interface
+
+=item Filtering only specific components of source code
+
+C<"code">, C<"executable">, 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.
+
+=item Using Filter::Simple and Exporter together
+
 =item How it works
 
 =back
@@ -10386,6 +11689,8 @@ B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
 
 =item EXPORTABLE VARIABLES
 
+=item KNOWN ISSUES
+
 =item KNOWN BUGS
 
 =item AUTHORS
@@ -10444,7 +11749,7 @@ B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
 
 =item Summary of Option Specifications
 
-!, +, s, i, f, : I<type> [ I<desttype> ]
+!, +, s, i, o, f, : I<type> [ I<desttype> ]
 
 =back
 
@@ -10462,7 +11767,7 @@ B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
 
 =item The lonesome dash
 
-=item Argument call-back
+=item Argument callback
 
 =back
 
@@ -10497,6 +11802,10 @@ prefix_pattern, debug (default: disabled)
 =item GetOptions does not return a false result when an option is not
 supplied
 
+=item GetOptions does not split the command line correctly
+
+=item How do I put a "-?" option into a Getopt::Long?
+
 =back
 
 =item AUTHOR
@@ -10527,6 +11836,213 @@ locale
 
 =back
 
+=head2 I18N::LangTags - functions for dealing with RFC3066-style language
+tags
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
+the function is_language_tag($lang1)
+
+the function extract_language_tags($whatever)
+
+the function same_language_tag($lang1, $lang2)
+
+the function similarity_language_tag($lang1, $lang2)
+
+the function is_dialect_of($lang1, $lang2)
+
+the function super_languages($lang1)
+
+the function locale2language_tag($locale_identifier)
+
+the function encode_language_tag($lang1)
+
+the function alternate_language_tags($lang1)
+
+the function @langs = panic_languages(@accept_languages)
+
+=over 4
+
+=item ABOUT LOWERCASING
+
+=item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
+
+=item SEE ALSO
+
+=item COPYRIGHT
+
+=item AUTHOR
+
+=back
+
+=head2 I18N::LangTags::List -- tags and names for human languages
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item ABOUT LANGUAGE TAGS
+
+=item LIST OF LANGUAGES
+
+{ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {aa} :
+Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : Afro-Asiatic (Other)],
+{aka} : Akan, {akk} : Akkadian, {sq} : Albanian, {ale} : Aleut, [{alg} :
+Algonquian languages], [{tut} : Altaic (Other)], {am} : Amharic, {i-ami} :
+Ami, [{apa} : Apache languages], {ar} : Arabic, {arc} : Aramaic, {arp} :
+Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} : Armenian, [{art} :
+Artificial (Other)], {as} : Assamese, [{ath} : Athapascan languages],
+[{aus} : Australian languages], [{map} : Austronesian (Other)], {ava} :
+Avaric, {ae} : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani,
+{ban} : Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bam} :
+Bambara, [{bai} : Bamileke languages], {bad} : Banda, [{bnt} : Bantu
+(Other)], {bas} : Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak
+(Indonesia), {bej} : Beja, {be} : Belarusian, {bem} : Bemba, {bn} :
+Bengali, [{ber} : Berber (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} :
+Bikol, {bin} : Bini, {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} :
+Breton, {bug} : Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} :
+Buriat, {my} : Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan,
+[{cau} : Caucasian (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)],
+[{cai} : Central American Indian (Other)], {chg} : Chagatai, [{cmc} :
+Chamic languages], {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy}
+: Cheyenne, {chb} : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} :
+Chinook Jargon, {chp} : Chipewyan, {cho} : Choctaw, {cu} : Church Slavic,
+{chk} : Chuukese, {cv} : Chuvash, {cop} : Coptic, {kw} : Cornish, {co} :
+Corsican, {cre} : Cree, {mus} : Creek, [{cpe} : English-based Creoles and
+pidgins (Other)], [{cpf} : French-based Creoles and pidgins (Other)],
+[{cpp} : Portuguese-based Creoles and pidgins (Other)], [{crp} : Creoles
+and pidgins (Other)], {hr} : Croatian, [{cus} : Cushitic (Other)], {cs} :
+Czech, {dak} : Dakota, {da} : Danish, {day} : Dayak, {i-default} : Default
+(Fallthru) Language, {del} : Delaware, {din} : Dinka, {div} : Divehi, {doi}
+: Dogri, {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} :
+Dutch, {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha,
+{efi} : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite,
+{en} : English, {enm} : Old English (1100-1500), {ang} : Old English
+(ca.450-1100), {eo} : Esperanto, {et} : Estonian, {ewe} : Ewe, {ewo} :
+Ewondo, {fan} : Fang, {fat} : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} :
+Finnish, [{fiu} : Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm}
+: Middle French (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} :
+Frisian, {fur} : Friulian, {ful} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic,
+{gl} : Gallegan, {lug} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez,
+{ka} : Georgian, {de} : German, {gmh} : Middle High German (ca.1050-1500),
+{goh} : Old High German (ca.750-1050), [{gem} : Germanic (Other)], {gil} :
+Gilbertese, {gon} : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} :
+Grebo, {grc} : Ancient Greek, {el} : Modern Greek, {gn} : Guarani, {gu} :
+Gujarati, {gwi} : Gwich'in, {hai} : Haida, {ha} : Hausa, {haw} : Hawaiian,
+{he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
+Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
+{hup} : Hupa, {iba} : Iban, {is} : Icelandic, {ibo} : Igbo, {ijo} : Ijo,
+{ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European (Other)],
+{id} : Indonesian, {ia} : Interlingua (International Auxiliary Language
+Association), {ie} : Interlingue, {iu} : Inuktitut, {ik} : Inupiaq, [{ira}
+: Iranian (Other)], {ga} : Irish, {mga} : Middle Irish (900-1200), {sga} :
+Old Irish (to 900), [{iro} : Iroquoian languages], {it} : Italian, {ja} :
+Japanese, {jw} : Javanese, {jrb} : Judeo-Arabic, {jpr} : Judeo-Persian,
+{kab} : Kabyle, {kac} : Kachin, {kl} : Kalaallisut, {kam} : Kamba, {kn} :
+Kannada, {kau} : Kanuri, {kaa} : Kara-Kalpak, {kar} : Karen, {ks} :
+Kashmiri, {kaw} : Kawi, {kk} : Kazakh, {kha} : Khasi, {km} : Khmer, [{khi}
+: Khoisan (Other)], {kho} : Khotanese, {ki} : Kikuyu, {kmb} : Kimbundu,
+{rw} : Kinyarwanda, {ky} : Kirghiz, {i-klingon} : Klingon, {kv} : Komi,
+{kon} : Kongo, {kok} : Konkani, {ko} : Korean, {kos} : Kosraean, {kpe} :
+Kpelle, {kro} : Kru, {kj} : Kuanyama, {kum} : Kumyk, {ku} : Kurdish, {kru}
+: Kurukh, {kut} : Kutenai, {lad} : Ladino, {lah} : Lahnda, {lam} : Lamba,
+{lo} : Lao, {la} : Latin, {lv} : Latvian, {lb} : Letzeburgesch, {lez} :
+Lezghian, {ln} : Lingala, {lt} : Lithuanian, {nds} : Low German, {loz} :
+Lozi, {lub} : Luba-Katanga, {lua} : Luba-Lulua, {lui} : Luiseno, {lun} :
+Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, {mk} : Macedonian,
+{mad} : Madurese, {mag} : Magahi, {mai} : Maithili, {mak} : Makasar, {mg} :
+Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : Maltese, {mnc} : Manchu,
+{mdr} : Mandar, {man} : Mandingo, {mni} : Manipuri, [{mno} : Manobo
+languages], {gv} : Manx, {mi} : Maori, {mr} : Marathi, {chm} : Mari, {mh} :
+Marshall, {mwr} : Marwari, {mas} : Masai, [{myn} : Mayan languages], {men}
+: Mende, {mic} : Micmac, {min} : Minangkabau, {i-mingo} : Mingo, [{mis} :
+Miscellaneous languages], {moh} : Mohawk, {mo} : Moldavian, [{mkh} :
+Mon-Khmer (Other)], {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul}
+: Multiple languages], [{mun} : Munda languages], {nah} : Nahuatl, {na} :
+Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, {ng} :
+Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
+Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
+{non} : Old Norse, [{nai} : North American Indian], {se} : Northern Sami,
+{no} : Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub}
+: Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro,
+{nzi} : Nzima, {oc} : Occitan (post 1500), {oji} : Ojibwa, {or} : Oriya,
+{om} : Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
+languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
+Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
+Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
+(ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
+: Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
+{pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
+Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
+[{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
+Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
+languages], {sam} : Samaritan Aramaic, [{smi} : Sami languages (Other)],
+{sm} : Samoan, {sad} : Sandawe, {sg} : Sango, {sa} : Sanskrit, {sat} :
+Santali, {sc} : Sardinian, {sas} : Sasak, {sco} : Scots, {sel} : Selkup,
+[{sem} : Semitic (Other)], {sr} : Serbian, {srr} : Serer, {shn} : Shan,
+{sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign Languages, {bla} : Siksika,
+{sd} : Sindhi, {si} : Sinhalese, [{sit} : Sino-Tibetan (Other)], [{sio} :
+Siouan languages], {den} : Slave (Athapascan), [{sla} : Slavic (Other)],
+{sk} : Slovak, {sl} : Slovenian, {sog} : Sogdian, {so} : Somali, {son} :
+Songhai, {snk} : Soninke, {wen} : Sorbian languages, {nso} : Northern
+Sotho, {st} : Southern Sotho, [{sai} : South American Indian (Other)], {es}
+: Spanish, {suk} : Sukuma, {sux} : Sumerian, {su} : Sundanese, {sus} :
+Susu, {sw} : Swahili, {ss} : Swati, {sv} : Swedish, {syr} : Syriac, {tl} :
+Tagalog, {ty} : Tahitian, [{tai} : Tai (Other)], {tg} : Tajik, {tmh} :
+Tamashek, {ta} : Tamil, {i-tao} : Tao, {tt} : Tatar, {i-tay} : Tayal, {te}
+: Telugu, {ter} : Tereno, {tet} : Tetum, {th} : Thai, {bo} : Tibetan, {tig}
+: Tigre, {ti} : Tigrinya, {tem} : Timne, {tiv} : Tiv, {tli} : Tlingit,
+{tpi} : Tok Pisin, {tkl} : Tokelau, {tog} : Tonga (Nyasa), {to} : Tonga
+(Tonga Islands), {tsi} : Tsimshian, {ts} : Tsonga, {i-tsu} : Tsou, {tn} :
+Tswana, {tum} : Tumbuka, {tr} : Turkish, {ota} : Ottoman Turkish
+(1500-1928), {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : Twi,
+{uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, {umb} : Umbundu, {und} :
+Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : Vai, {ven} : Venda, {vi} :
+Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} : Wakashan languages],
+{wal} : Walamo, {war} : Waray, {was} : Washo, {cy} : Welsh, {wo} : Wolof,
+{x-...} : Unregistered (Semi-Private Use), {xh} : Xhosa, {sah} : Yakut,
+{yao} : Yao, {yap} : Yapese, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik
+languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} :
+Zhuang, {zu} : Zulu, {zun} : Zuni
+
+=item SEE ALSO
+
+=item COPYRIGHT AND DISCLAIMER
+
+=item AUTHOR
+
+=back
+
+=head2 I18N::Langinfo - query locale information
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item EXPORT
+
+=back
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT AND LICENSE
+
+=back
+
 =head2 IO - load various IO modules
 
 =over 4
@@ -10660,8 +12176,8 @@ IO ), handles( [ EVENT_MASK ] )
 
 =item DESCRIPTION
 
-$io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
-WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ),
+$io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
+WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
 $io->tell
 
 =item SEE ALSO
@@ -10900,8 +12416,8 @@ I/O objects
 
 =item DESCRIPTION
 
-$io->getpos, $io->setpos, $io->setpos ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
-WHENCE=1 (SEEK_CUR), WHENCE=1 (SEEK_END), $io->sysseek( POS, WHENCE ),
+$io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
+WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
 $io->tell
 
 =item SEE ALSO
@@ -11154,6 +12670,59 @@ set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
 
 =back
 
+=head2 List::Util - A selection of general-utility list subroutines
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
+BLOCK LIST, shuffle LIST, sum LIST
+
+=item SUGGESTED ADDITIONS
+
+=item COPYRIGHT
+
+=back
+
+=head2 List::Utilib::List::Util, List::Util - A selection of
+general-utility list subroutines
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
+BLOCK LIST, shuffle LIST, sum LIST
+
+=item SUGGESTED ADDITIONS
+
+=item COPYRIGHT
+
+=back
+
+=head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
+general-utility scalar subroutines
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+blessed EXPR, dualvar NUM, STRING, isweak EXPR, readonly SCALAR, reftype
+EXPR, tainted EXPR, weaken REF
+
+=item COPYRIGHT
+
+=item BLATANT PLUG
+
+=back
+
 =head2 Locale::Constants - constants for Locale codes
 
 =over 4
@@ -11331,7 +12900,7 @@ http://lcweb.loc.gov/standards/iso639-2/langhome.html
 
 =back
 
-=head2 MIME::Base64 - Encoding and decoding of base64 strings
+=head2 Locale::Maketext -- framework for localization
 
 =over 4
 
@@ -11339,49 +12908,50 @@ http://lcweb.loc.gov/standards/iso639-2/langhome.html
 
 =item DESCRIPTION
 
-encode_base64($str, [$eol]), decode_base64($str)
+=item QUICK OVERVIEW
 
-=item DIAGNOSTICS
+=item METHODS
 
-Premature end of base64 data, Premature padding of base64 data
+=over 4
 
-=item EXAMPLES
+=item Construction Methods
 
-=item COPYRIGHT
+=item The "maketext" Method
 
-=back
+$lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
 
-=head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
-of quoted-printable strings
+=item Utility Methods
 
-=over 4
+$language->quant($number, $singular), $language->quant($number, $singular,
+$plural), $language->quant($number, $singular, $plural, $negative),
+$language->numf($number), $language->sprintf($format, @items),
+$language->language_tag(), $language->encoding()
 
-=item SYNOPSIS
+=item Language Handle Attributes and Internals
 
-=item DESCRIPTION
+=back
 
-encode_qp($str), decode_qp($str);
+=item LANGUAGE CLASS HIERARCHIES
 
-=item COPYRIGHT
+=item ENTRIES IN EACH LEXICON
 
-=back
+=item BRACKET NOTATION
 
-=head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
-strings
+=item AUTO LEXICONS
 
-=over 4
+=item CONTROLLING LOOKUP FAILURE
 
-=item SYNOPSIS
+=item HOW TO USE MAKETEXT
 
-=item DESCRIPTION
+=item SEE ALSO
 
-encode_qp($str), decode_qp($str);
+=item COPYRIGHT AND DISCLAIMER
 
-=item COPYRIGHT
+=item AUTHOR
 
 =back
 
-=head2 Math::BigFloat - Arbitrary length float math package
+=head2 Locale::Maketext::TPJ13 -- article about software localization
 
 =over 4
 
@@ -11389,37 +12959,37 @@ encode_qp($str), decode_qp($str);
 
 =item DESCRIPTION
 
-number format, Error returns 'NaN', Division is computed to, Rounding is
-performed
+=item Localization and Perl: gettext breaks, Maketext fixes
 
-=item BUGS
+=over 4
 
-=item AUTHOR
+=item A Localization Horror Story: It Could Happen To You
 
-=back
+=item The Linguistic View
 
-=head2 Math::BigInt - Arbitrary size integer math package
+=item Breaking gettext
 
-=over 4
+=item Replacing gettext
 
-=item SYNOPSIS
+=item Buzzwords: Abstraction and Encapsulation
 
-=item DESCRIPTION
+=item Buzzword: Isomorphism
 
-Canonical notation, Input, Output
+=item Buzzword: Inheritance
 
-=item EXAMPLES
+=item Buzzword: Concision
 
-=item Autocreating constants
+=item The Devil in the Details
 
-=item BUGS
+=item The Proof in the Pudding: Localizing Web Sites
 
-=item AUTHOR
+=item References
 
 =back
 
-=head2 Math::Complex - complex numbers and associated mathematical
-functions
+=back
+
+=head2 MIME::Base64 - Encoding and decoding of base64 strings
 
 =over 4
 
@@ -11427,31 +12997,35 @@ functions
 
 =item DESCRIPTION
 
-=item OPERATIONS
+encode_base64($str, [$eol]), decode_base64($str)
 
-=item CREATION
+=item DIAGNOSTICS
 
-=item STRINGIFICATION
+Premature end of base64 data, Premature padding of base64 data
 
-=over 4
+=item EXAMPLES
 
-=item CHANGED IN PERL 5.6
+=item COPYRIGHT
 
 =back
 
-=item USAGE
+=head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
+of quoted-printable strings
 
-=item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
+=over 4
 
-=item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
+=item SYNOPSIS
 
-=item BUGS
+=item DESCRIPTION
 
-=item AUTHORS
+encode_qp($str), decode_qp($str);
+
+=item COPYRIGHT
 
 =back
 
-=head2 Math::Trig - trigonometric functions
+=head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
+strings
 
 =over 4
 
@@ -11459,50 +13033,56 @@ functions
 
 =item DESCRIPTION
 
-=item TRIGONOMETRIC FUNCTIONS
+encode_qp($str), decode_qp($str);
 
-B<tan>
+=item COPYRIGHT
+
+=back
+
+=head2 Math::BigFloat - Arbitrary size floating point math package
 
 =over 4
 
-=item ERRORS DUE TO DIVISION BY ZERO
+=item SYNOPSIS
 
-=item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
+=item DESCRIPTION
 
-=back
+=over 4
 
-=item PLANE ANGLE CONVERSIONS
+=item Canonical notation
 
-=item RADIAL COORDINATE CONVERSIONS
+=item Output
 
-=over 4
+=item C<mantissa()>, C<exponent()> and C<parts()>
 
-=item COORDINATE SYSTEMS
+=item Accuracy vs. Precision
 
-=item 3-D ANGLE CONVERSIONS
+=item Rounding
 
-cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
-cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
+ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
+), fround  ( -$scale ) and fround ( 0 )
 
 =back
 
-=item GREAT CIRCLE DISTANCES AND DIRECTIONS
-
 =item EXAMPLES
 
-=over 4
-
-=item CAVEAT FOR GREAT CIRCLE FORMULAS
+  # not ready yet
 
-=back
+=item Autocreating constants
 
 =item BUGS
 
+=item CAVEAT
+
+stringify, bstr(), bdiv, Modifying and =, bpow
+
+=item LICENSE
+
 =item AUTHORS
 
 =back
 
-=head2 NDBM_File - Tied access to ndbm files
+=head2 Math::BigInt - Arbitrary size integer math package
 
 =over 4
 
@@ -11510,77 +13090,72 @@ cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
 
 =item DESCRIPTION
 
-C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
+Canonical notation, Input, Output
 
-=item DIAGNOSTICS
+=item ACCURACY and PRECISION
 
 =over 4
 
-=item C<ndbm store returned -1, errno 22, key "..." at ...>
-
-=back
+=item Precision P
 
-=item BUGS AND WARNINGS
+=item Accuracy A
 
-=back
+=item Fallback F
 
-=head2 Net::Ping - check a remote host for reachability
+=item Rounding mode R
 
-=over 4
+'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
+(significant digits), Setting/Accessing, Creating numbers, Usage,
+Precedence, Overriding globals, Local settings, Rounding, Default values,
+Remarks
 
-=item SYNOPSIS
+=back
 
-=item DESCRIPTION
+=item INTERNALS
 
 =over 4
 
-=item Functions
-
-Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [,
-$timeout]);, $p->close();, pingecho($host [, $timeout]);
+=item MATH LIBRARY
 
-=back
+=item SIGN
 
-=item NOTES
+=item mantissa(), exponent() and parts()
 
 =back
 
-=head2 Net::hostent - by-name interface to Perl's built-in gethost*()
-functions
+=item EXAMPLES
 
-=over 4
+  use Math::BigInt qw(bstr);
 
-=item SYNOPSIS
-
-=item DESCRIPTION
+=item Autocreating constants
 
-=item EXAMPLES
+=item PERFORMANCE
 
-=item NOTE
+=over 4
 
-=item AUTHOR
+=item Alternative math libraries
 
 =back
 
-=head2 Net::netent - by-name interface to Perl's built-in getnet*()
-functions
+=item BUGS
 
-=over 4
+Out of Memory!, Fails to load Calc on Perl prior 5.6.0
 
-=item SYNOPSIS
+=item CAVEATS
 
-=item DESCRIPTION
+stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
+handling, Modifying and =, bpow, Overloading -$x, Mixing different object
+types, bsqrt()
 
-=item EXAMPLES
+=item LICENSE
 
-=item NOTE
+=item SEE ALSO
 
-=item AUTHOR
+=item AUTHORS
 
 =back
 
-=head2 Net::protoent - by-name interface to Perl's built-in getproto*()
-functions
+=head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
 
 =over 4
 
@@ -11588,13 +13163,23 @@ functions
 
 =item DESCRIPTION
 
-=item NOTE
+=item EXPORT
 
-=item AUTHOR
+=item WRAP YOUR OWN
+
+=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 Net::servent - by-name interface to Perl's built-in getserv*()
+=head2 Math::Complex - complex numbers and associated mathematical
 functions
 
 =over 4
@@ -11603,31 +13188,31 @@ functions
 
 =item DESCRIPTION
 
-=item EXAMPLES
+=item OPERATIONS
 
-=item NOTE
+=item CREATION
 
-=item AUTHOR
+=item STRINGIFICATION
 
-=back
+=over 4
 
-=head2 O - Generic interface to Perl Compiler backends
+=item CHANGED IN PERL 5.6
 
-=over 4
+=back
 
-=item SYNOPSIS
+=item USAGE
 
-=item DESCRIPTION
+=item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
 
-=item CONVENTIONS
+=item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
 
-=item IMPLEMENTATION
+=item BUGS
 
-=item AUTHOR
+=item AUTHORS
 
 =back
 
-=head2 ODBM_File - Tied access to odbm files
+=head2 Math::Trig - trigonometric functions
 
 =over 4
 
@@ -11635,67 +13220,50 @@ functions
 
 =item DESCRIPTION
 
-C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
+=item TRIGONOMETRIC FUNCTIONS
 
-=item DIAGNOSTICS
+B<tan>
 
 =over 4
 
-=item C<odbm store returned -1, errno 22, key "..." at ...>
-
-=back
+=item ERRORS DUE TO DIVISION BY ZERO
 
-=item BUGS AND WARNINGS
+=item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
 
 =back
 
-=head2 Opcode - Disable named opcodes when compiling perl code
-
-=over 4
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item NOTE
+=item PLANE ANGLE CONVERSIONS
 
-=item WARNING
+=item RADIAL COORDINATE CONVERSIONS
 
-=item Operator Names and Operator Lists
+=over 4
 
-an operator name (opname), an operator tag name (optag), a negated opname
-or optag, an operator set (opset)
+=item COORDINATE SYSTEMS
 
-=item Opcode Functions
+=item 3-D ANGLE CONVERSIONS
 
-opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
-full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
-define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
-opdump (PAT)
+cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
+cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
 
-=item Manipulating Opsets
+=back
 
-=item TO DO (maybe)
+=item GREAT CIRCLE DISTANCES AND DIRECTIONS
 
-=back
+=item EXAMPLES
 
 =over 4
 
-=item Predefined Opcode Tags
+=item CAVEAT FOR GREAT CIRCLE FORMULAS
 
-:base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
-:base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
-:filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
-:dangerous
+=back
 
-=item SEE ALSO
+=item BUGS
 
 =item AUTHORS
 
 =back
 
-=head2 Opcode::Safe, Safe - Compile and execute code in restricted
-compartments
+=head2 Memoize - Make your functions faster by trading space for time
 
 =over 4
 
@@ -11703,175 +13271,142 @@ compartments
 
 =item DESCRIPTION
 
-a new namespace, an operator mask
+=item DETAILS
 
-=item WARNING
+=item OPTIONS
 
 =over 4
 
-=item RECENT CHANGES
-
-=item Methods in class Safe
-
-permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
-...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
-(PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
-root (NAMESPACE), mask (MASK)
-
-=item Some Safety Issues
+=item INSTALL
 
-Memory, CPU, Snooping, Signals, State Changes
+=item NORMALIZER
 
-=item AUTHOR
+=item C<SCALAR_CACHE>, C<LIST_CACHE>
 
-=back
+C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
 
 =back
 
-=head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
-compiling
+=item OTHER FACILITIES
 
 =over 4
 
-=item SYNOPSIS	
-
-=item DESCRIPTION
+=item C<unmemoize>
 
-=item SEE ALSO
+=item C<flush_cache>
 
 =back
 
-=head2 POSIX - Perl interface to IEEE Std 1003.1
+=item CAVEATS
 
-=over 4
+=item PERSISTENT CACHE SUPPORT
 
-=item SYNOPSIS
+=item EXPIRATION SUPPORT
 
-=item DESCRIPTION
+=item BUGS
 
-=item NOTE
+=item MAILING LIST
 
-=item CAVEATS 
+=item AUTHOR
 
-=item FUNCTIONS
+=item COPYRIGHT AND LICENSE
 
-_exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
-atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
-clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
-cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
-execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
-fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
-fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
-fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
-getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
-getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
-iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
-isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
-longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
-memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
-opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
-qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
-rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
-setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
-sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
-strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
-strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
-strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
-tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
-tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
-unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
-wctomb, write
+=item THANK YOU
 
-=item CLASSES
+=back
+
+=head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
+Storable use
 
 =over 4
 
-=item POSIX::SigAction
+=item DESCRIPTION
 
-new
+=back
 
-=item POSIX::SigSet
+=head2 Memoize::Expire - Plug-in module for automatic expiration of
+memoized values
 
-new, addset, delset, emptyset, fillset, ismember
+=over 4
 
-=item POSIX::Termios
+=item SYNOPSIS
 
-new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
-getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
-setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
-field values, c_cflag field values, c_iflag field values, c_lflag field
-values, c_oflag field values
+=item DESCRIPTION
 
-=back
+=item INTERFACE
 
-=item PATHNAME CONSTANTS
+ TIEHASH,  EXISTS,  STORE
 
-Constants
+=item ALTERNATIVES
 
-=item POSIX CONSTANTS
+=item CAVEATS
 
-Constants
+=item AUTHOR
 
-=item SYSTEM CONFIGURATION
+=item SEE ALSO
 
-Constants
+=back
 
-=item ERRNO
+=head2 Memoize::ExpireFile - test for Memoize expiration semantics
 
-Constants
+=over 4
 
-=item FCNTL
+=item DESCRIPTION
 
-Constants
+=back
 
-=item FLOAT
+=head2 Memoize::ExpireTest - test for Memoize expiration semantics
 
-Constants
+=over 4
 
-=item LIMITS
+=item DESCRIPTION
 
-Constants
+=back
 
-=item LOCALE
+=head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
+Storable use
 
-Constants
+=over 4
 
-=item MATH
+=item DESCRIPTION
 
-Constants
+=back
 
-=item SIGNAL
+=head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
+Storable use
 
-Constants
+=over 4
 
-=item STAT
+=item DESCRIPTION
 
-Constants, Macros
+=back
 
-=item STDLIB
+=head2 Memoize::Saves - Plug-in module to specify which return values
+should be memoized
 
-Constants
+=over 4
 
-=item STDIO
+=item SYNOPSIS
 
-Constants
+=item DESCRIPTION
 
-=item TIME
+=item CAVEATS
 
-Constants
+=item AUTHOR
 
-=item UNISTD
+=item SEE ALSO
 
-Constants
+=back
 
-=item WAIT
+=head2 Memoize::Storable - store Memoized data in Storable database
 
-Constants, Macros
+=over 4
+
+=item DESCRIPTION
 
 =back
 
-=head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
-name space
+=head2 NDBM_File - Tied access to ndbm files
 
 =over 4
 
@@ -11879,31 +13414,1202 @@ name space
 
 =item DESCRIPTION
 
-unix, stdio, perlio, crlf, utf8, raw
+C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
+
+=item DIAGNOSTICS
 
 =over 4
 
-=item Defaults and how to override them
+=item C<ndbm store returned -1, errno 22, key "..." at ...>
+
+=back
+
+=item BUGS AND WARNINGS
+
+=back
+
+=head2 NEXT - Provide a pseudo-class NEXT that allows method redispatch
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item AUTHOR
+
+=item BUGS AND IRRITATIONS
+
+=item COPYRIGHT
+
+=back
+
+=head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item USER METHODS
+
+debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
+dataend ()
+
+=item CLASS METHODS
+
+debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
+]), unsupported (), response (), parse_response ( TEXT ), getline (),
+ungetline ( TEXT ), read_until_dot ()
+
+=item EXPORTS
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
+=head2 Net::Config - Local configuration data for libnet
+
+=over 4
+
+=item SYNOPSYS
+
+=item DESCRIPTION
+
+=item METHODS
+
+requires_firewall HOST
+
+=item NetConfig VALUES
+
+nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
+time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
+ftp_int_pasive, local_netmask, test_hosts, test_exists
+
+=back
+
+=head2 Net::Domain - Attempt to evaluate the current host's internet name
+and domain
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+hostfqdn (), hostname (), hostdomain ()
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
+=head2 Net::FTP - FTP Client class
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item OVERVIEW
+
+=item CONSTRUCTOR
+
+new (HOST [,OPTIONS])
+
+=item METHODS
+
+login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
+site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS])
+ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME
+), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ),
+mkdir ( DIR [, RECURSE ]), 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
+
+=item Methods for the adventurous
+
+quot (CMD [,ARGS])
+
+=back
+
+=item THE dataconn CLASS
+
+read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
+bytes_read (), abort (), close ()
+
+=item UNIMPLEMENTED
+
+B<ALLO>, B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
+
+=item REPORTING BUGS
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=item USE EXAMPLES
+
+http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
+
+=item CREDITS
+
+=item COPYRIGHT
+
+=back
+
+=head2 Net::NNTP - NNTP Client class
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONSTRUCTOR
+
+new ( [ HOST ] [, OPTIONS ])
+
+=item METHODS
+
+article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
+[ MSGID|MSGNUM ], [FH] ), nntpstat ( [ MSGID|MSGNUM ] ), group ( [ GROUP ]
+), ihave ( MSGID [, MESSAGE ]), last (), date (), postok (), authinfo (
+USER, PASS ), list (), newgroups ( SINCE [, DISTRIBUTIONS ]), newnews (
+SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (), post ( [ MESSAGE ] ), slave
+(), quit ()
+
+=over 4
+
+=item Extension methods
+
+newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
+overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
+), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
+MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
+GROUP ] ), reader
+
+=back
+
+=item UNSUPPORTED
+
+=item DEFINITIONS
+
+MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
+=head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1081)
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item EXAMPLES
+
+=item CONSTRUCTOR
+
+new ( [ HOST, ] [ OPTIONS ] )
+
+=item METHODS
+
+user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( USER,
+PASS ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [,
+FH ] ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ] ), delete (
+MSGNUM ), reset (), quit ()
+
+=item NOTES
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
+=head2 Net::Ping - check a remote host for reachability
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+icmp, udp, tcp, stream, external
+
+=over 4
+
+=item Functions
+
+Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [,
+$timeout]);, $p->open($host);, $p->close();, pingecho($host [, $timeout]);
+
+=back
+
+=item NOTES
+
+=back
+
+=head2 Net::SMTP - Simple Mail Transfer Protocol Client
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item EXAMPLES
+
+=item CONSTRUCTOR
+
+new Net::SMTP [ HOST, ] [ OPTIONS ]
+
+=item METHODS
+
+banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), 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 SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
+=head2 Net::Time - time and daytime network client interface
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
+PROTOCOL [, TIMEOUT]]])
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
+=head2 Net::hostent - by-name interface to Perl's built-in gethost*()
+functions
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item EXAMPLES
+
+=item NOTE
+
+=item AUTHOR
+
+=back
+
+=head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item Where to get this document
+
+=item How to contribute to this document
+
+=back
+
+=item Author and Copyright Information
+
+=over 4
+
+=item Disclaimer
+
+=back
+
+=item Obtaining and installing libnet
+
+=over 4
+
+=item What is libnet ?
+
+=item Which version of perl do I need ?
+
+=item What other modules do I need ?
+
+=item What machines support libnet ?
+
+=item Where can I get the latest libnet release
+
+=back
+
+=item Using Net::FTP
+
+=over 4
+
+=item How do I download files from an FTP server ?
+
+=item How do I transfer files in binary mode ?
+
+=item How can I get the size of a file on a remote FTP server ?
+
+=item How can I get the modification time of a file on a remote FTP server
+?
+
+=item How can I change the permissions of a file on a remote server ?
+
+=item Can I do a reget operation like the ftp command ?
+
+=item How do I get a directory listing from an FTP server ?
+
+=item Changing directory to "" does not fail ?
+
+=item I am behind a SOCKS firewall, but the Firewall option does not work ?
+
+=item I am behind an FTP proxy firewall, but cannot access machines outside
+?
+
+=item My ftp proxy firewall does not listen on port 21
+
+=item Is it possible to change the file permissions of a file on an FTP
+server ?
+
+=item I have seen scripts call a method message, but cannot find it
+documented ?
+
+=item Why does Net::FTP not implement mput and mget methods
+
+=back
+
+=item Using Net::SMTP
+
+=over 4
+
+=item Why can't the part of an Email address after the @ be used as the
+hostname ?
+
+=item Why does Net::SMTP not do DNS MX lookups ?
+
+=item The verify method always returns true ?
+
+=back
+
+=item Debugging scripts
+
+=over 4
+
+=item How can I debug my scripts that use Net::* modules ?
+
+=back
+
+=item AUTHOR AND COPYRIGHT
+
+=back
+
+=head2 Net::netent - by-name interface to Perl's built-in getnet*()
+functions
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item EXAMPLES
+
+=item NOTE
+
+=item AUTHOR
+
+=back
+
+=head2 Net::protoent - by-name interface to Perl's built-in getproto*()
+functions
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item NOTE
+
+=item AUTHOR
+
+=back
+
+=head2 Net::servent - by-name interface to Perl's built-in getserv*()
+functions
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item EXAMPLES
+
+=item NOTE
+
+=item AUTHOR
+
+=back
+
+=head2 Netrc, Net::Netrc - OO interface to users netrc file
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item THE .netrc FILE
+
+machine name, default, login name, password string, account string, macdef
+name
+
+=item CONSTRUCTOR
+
+lookup ( MACHINE [, LOGIN ])
+
+=item METHODS
+
+login (), password (), account (), lpa ()
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=item COPYRIGHT
+
+=back
+
+=head2 O - Generic interface to Perl Compiler backends
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONVENTIONS
+
+=item IMPLEMENTATION
+
+=item AUTHOR
+
+=back
+
+=head2 ODBM_File - Tied access to odbm files
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
+
+=item DIAGNOSTICS
+
+=over 4
+
+=item C<odbm store returned -1, errno 22, key "..." at ...>
+
+=back
+
+=item BUGS AND WARNINGS
+
+=back
+
+=head2 Opcode - Disable named opcodes when compiling perl code
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item NOTE
+
+=item WARNING
+
+=item Operator Names and Operator Lists
+
+an operator name (opname), an operator tag name (optag), a negated opname
+or optag, an operator set (opset)
+
+=item Opcode Functions
+
+opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
+full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
+define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
+opdump (PAT)
+
+=item Manipulating Opsets
+
+=item TO DO (maybe)
+
+=back
+
+=over 4
+
+=item Predefined Opcode Tags
+
+:base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
+:base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
+:filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
+:dangerous
+
+=item SEE ALSO
+
+=item AUTHORS
+
+=back
+
+=head2 Opcode::Safe, Safe - Compile and execute code in restricted
+compartments
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+a new namespace, an operator mask
+
+=item WARNING
+
+=over 4
+
+=item RECENT CHANGES
+
+=item Methods in class Safe
+
+permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
+...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
+(PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
+root (NAMESPACE), mask (MASK)
+
+=item Some Safety Issues
+
+Memory, CPU, Snooping, Signals, State Changes
+
+=item AUTHOR
+
+=back
+
+=back
+
+=head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
+compiling
+
+=over 4
+
+=item SYNOPSIS	
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=back
+
+=head2 POSIX - Perl interface to IEEE Std 1003.1
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item NOTE
+
+=item CAVEATS 
+
+=item FUNCTIONS
+
+_exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
+atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
+clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
+cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
+execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
+fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
+fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
+fstat, ftell, fwrite, getc, getchar, getcwd, getegid, getenv, geteuid,
+getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid, getppid,
+getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha, isatty,
+iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper,
+isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime, log, log10,
+longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr, memcmp, memcpy,
+memmove, memset, mkdir, mkfifo, mktime, modf, nice, offsetof, open,
+opendir, pathconf, pause, perror, pipe, pow, printf, putc, putchar, puts,
+qsort, raise, rand, read, readdir, realloc, remove, rename, rewind,
+rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid, setsid,
+setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
+sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
+strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
+strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
+strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
+tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
+tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
+unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
+wctomb, write
+
+=item CLASSES
+
+=over 4
+
+=item POSIX::SigAction
+
+new
+
+=item POSIX::SigSet
+
+new, addset, delset, emptyset, fillset, ismember
+
+=item POSIX::Termios
+
+new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
+getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
+setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
+field values, c_cflag field values, c_iflag field values, c_lflag field
+values, c_oflag field values
+
+=back
+
+=item PATHNAME CONSTANTS
+
+Constants
+
+=item POSIX CONSTANTS
+
+Constants
+
+=item SYSTEM CONFIGURATION
+
+Constants
+
+=item ERRNO
+
+Constants
+
+=item FCNTL
+
+Constants
+
+=item FLOAT
+
+Constants
+
+=item LIMITS
+
+Constants
+
+=item LOCALE
+
+Constants
+
+=item MATH
+
+Constants
+
+=item SIGNAL
+
+Constants
+
+=item STAT
+
+Constants, Macros
+
+=item STDLIB
+
+Constants
+
+=item STDIO
+
+Constants
+
+=item TIME
+
+Constants
+
+=item UNISTD
+
+Constants
+
+=item WAIT
+
+Constants, Macros
+
+=back
+
+=head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
+name space
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+unix, stdio, perlio, crlf, utf8, raw
+
+=over 4
+
+=item Defaults and how to override them
+
+=back
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
+=head2 PerlIO::Scalar - support module for in-memory IO.
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
+=head2 PerlIO::Via - Helper class for PerlIO layers implemented in perl
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+$class->PUSHED([$mode][,$fh]), $obj->POPPED([$fh]),
+$class->OPEN($path,$mode[,$fh]), $class->FDOPEN($fd),
+$class->SYSOPEN($path,$imode,$perm,$fh), $obj->FILENO($fh),
+$obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
+$obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
+$obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
+$obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
+
+=back
+
+=head2 Pod::Checker, podchecker() - check pod documents for syntax errors
+
+=over 4
+
+=item SYNOPSIS
+
+=item OPTIONS/ARGUMENTS
+
+=over 4
+
+=item podchecker()
+
+B<-warnings> =E<gt> I<val>
+
+=back
+
+=item DESCRIPTION
+
+=item DIAGNOSTICS
+
+=over 4
+
+=item Errors
+
+empty =headn, =over on line I<N> without closing =back, =item without
+previous =over, =back without previous =over, No argument for =begin, =end
+without =begin, Nested =begin's, =for without formatter specification,
+unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
+interior-sequence "I<SEQ>", nested commands
+I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
+number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
+empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
+after =back
+
+=item Warnings
+
+multiple occurence of link target I<name>, line containing nothing but
+whitespace in paragraph, file does not start with =head, previous =item has
+no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
+vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
+items in =over, No argument for =item, empty section in previous paragraph,
+Verbatim paragraph in NAME section
+
+=item Hyperlinks
+
+ignoring leading/trailing whitespace in link, (section) in '$page'
+deprecated, alternative text/node '%s' contains non-escaped | or /
+
+=back
+
+=item RETURN VALUE
+
+=item EXAMPLES
+
+=item INTERFACE
+
+=back
+
+C<Pod::Checker-E<gt>new( %options )>
+
+C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
+@args )>
+
+C<$checker-E<gt>num_errors()>
+
+C<$checker-E<gt>name()>
+
+C<$checker-E<gt>node()>
+
+C<$checker-E<gt>idx()>
+
+C<$checker-E<gt>hyperlink()>
+
+=over 4
+
+=item AUTHOR
+
+=back
+
+=head2 Pod::Find - find POD documents in directory trees
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
+=over 4
+
+=item C<pod_find( { %opts } , @directories )>
+
+C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
+1>
+
+=back
+
+=over 4
+
+=item C<simplify_name( $str )>
+
+=back
+
+=over 4
+
+=item C<pod_where( { %opts }, $pod )>
+
+C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
+1>
+
+=back
+
+=over 4
+
+=item C<contains_pod( $file , $verbose )>
+
+=back
+
+=over 4
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
+=head2 Pod::Html - module to convert pod files to HTML
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item ARGUMENTS
+
+backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
+infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
+title, verbose
+
+=item EXAMPLE
+
+=item ENVIRONMENT
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=item COPYRIGHT
+
+=back
+
+=head2 Pod::InputObjects - objects representing POD input paragraphs,
+commands, etc.
+
+=over 4
+
+=item SYNOPSIS
+
+=item REQUIRES
+
+=item EXPORTS
+
+=item DESCRIPTION
+
+package B<Pod::InputSource>, package B<Pod::Paragraph>, package
+B<Pod::InteriorSequence>, package B<Pod::ParseTree>
+
+=back
+
+=over 4
+
+=item B<Pod::InputSource>
+
+=back
+
+=over 4
+
+=item B<new()>
+
+=back
+
+=over 4
+
+=item B<name()>
+
+=back
+
+=over 4
+
+=item B<handle()>
+
+=back
+
+=over 4
+
+=item B<was_cutting()>
+
+=back
+
+=over 4
+
+=item B<Pod::Paragraph>
+
+=back
+
+=over 4
+
+=item Pod::Paragraph-E<gt>B<new()>
+
+=back
+
+=over 4
+
+=item $pod_para-E<gt>B<cmd_name()>
+
+=back
+
+=over 4
+
+=item $pod_para-E<gt>B<text()>
+
+=back
+
+=over 4
+
+=item $pod_para-E<gt>B<raw_text()>
+
+=back
+
+=over 4
+
+=item $pod_para-E<gt>B<cmd_prefix()>
+
+=back
+
+=over 4
+
+=item $pod_para-E<gt>B<cmd_separator()>
+
+=back
+
+=over 4
+
+=item $pod_para-E<gt>B<parse_tree()>
+
+=back
+
+=over 4
+
+=item $pod_para-E<gt>B<file_line()>
+
+=back
+
+=over 4
+
+=item B<Pod::InteriorSequence>
+
+=back
+
+=over 4
+
+=item Pod::InteriorSequence-E<gt>B<new()>
+
+=back
+
+=over 4
+
+=item $pod_seq-E<gt>B<cmd_name()>
+
+=back
+
+=over 4
+
+=item $pod_seq-E<gt>B<prepend()>
+
+=back
+
+=over 4
+
+=item $pod_seq-E<gt>B<append()>
+
+=back
+
+=over 4
+
+=item $pod_seq-E<gt>B<nested()>
+
+=back
+
+=over 4
+
+=item $pod_seq-E<gt>B<raw_text()>
+
+=back
+
+=over 4
+
+=item $pod_seq-E<gt>B<left_delimiter()>
+
+=back
+
+=over 4
+
+=item $pod_seq-E<gt>B<right_delimiter()>
+
+=back
+
+=over 4
+
+=item $pod_seq-E<gt>B<parse_tree()>
+
+=back
+
+=over 4
+
+=item $pod_seq-E<gt>B<file_line()>
+
+=back
+
+=over 4
+
+=item Pod::InteriorSequence::B<DESTROY()>
+
+=back
+
+=over 4
+
+=item B<Pod::ParseTree>
+
+=back
+
+=over 4
+
+=item Pod::ParseTree-E<gt>B<new()>
+
+=back
+
+=over 4
+
+=item $ptree-E<gt>B<top()>
+
+=back
+
+=over 4
+
+=item $ptree-E<gt>B<children()>
+
+=back
+
+=over 4
+
+=item $ptree-E<gt>B<prepend()>
+
+=back
+
+=over 4
+
+=item $ptree-E<gt>B<append()>
+
+=back
+
+=over 4
+
+=item $ptree-E<gt>B<raw_text()>
 
 =back
 
-=item AUTHOR
+=over 4
 
-=item SEE ALSO
+=item Pod::ParseTree::B<DESTROY()>
 
 =back
 
-=head2 PerlIO::Scalar - support module for in-memory IO.
-
 =over 4
 
-=item SYNOPSIS
+=item SEE ALSO
 
-=item DESCRIPTION
+=item AUTHOR
 
 =back
 
-=head2 PerlIO::Via - Helper class for PerlIO layers implemented in perl
+=head2 Pod::LaTeX - Convert Pod data to formatted Latex
 
 =over 4
 
@@ -11911,144 +14617,117 @@ unix, stdio, perlio, crlf, utf8, raw
 
 =item DESCRIPTION
 
-$class->PUSHED([$mode][,$fh]), $obj->POPPED([$fh]),
-$class->OPEN($path,$mode[,$fh]), $class->FDOPEN($fd),
-$class->SYSOPEN($path,$imode,$perm,$fh), $obj->FILENO($fh),
-$obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
-$obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
-$obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
-$obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
-
 =back
 
-=head2 Pod::Checker, podchecker() - check pod documents for syntax errors
-
 =over 4
 
-=item SYNOPSIS
+=item OBJECT METHODS
 
-=item OPTIONS/ARGUMENTS
+C<initialize>
+
+=back
 
 =over 4
 
-=item podchecker()
+=item Data Accessors
 
-B<-warnings> =E<gt> I<val>
+B<AddPreamble>
 
 =back
 
-=item DESCRIPTION
+B<AddPostamble>
 
-=item DIAGNOSTICS
+B<Head1Level>
 
-=over 4
+B<Label>
 
-=item Errors
+B<LevelNoNum>
 
-empty =headn, =over on line I<N> without closing =back, =item without
-previous =over, =back without previous =over, No argument for =begin, =end
-without =begin, Nested =begin's, =for without formatter specification,
-unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
-interior-sequence "I<SEQ>", nested commands
-I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
-number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
-empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
-after =back
+B<MakeIndex>
 
-=item Warnings
+B<ReplaceNAMEwithSection>
 
-multiple occurence of link target I<name>, line containing nothing but
-whitespace in paragraph, file does not start with =head, previous =item has
-no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
-vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
-items in =over, No argument for =item, empty section in previous paragraph,
-Verbatim paragraph in NAME section
+B<StartWithNewPage>
 
-=item Hyperlinks
+B<TableOfContents>
 
-ignoring leading/trailing whitespace in link, (section) in '$page'
-deprecated, alternative text/node '%s' contains non-escaped | or /
+B<UniqueLabels>
 
-=back
+B<UserPreamble>
 
-=item RETURN VALUE
+B<UserPostamble>
 
-=item EXAMPLES
+B<Lists>
 
-=item INTERFACE
+=over 4
 
-=back
+=item Subclassed methods
 
-C<Pod::Checker-E<gt>new( %options )>
+=back
 
-C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
-@args )>
+B<begin_pod>
 
-C<$checker-E<gt>num_errors()>
+B<end_pod>
 
-C<$checker-E<gt>name()>
+B<command>
 
-C<$checker-E<gt>node()>
+B<verbatim>
 
-C<$checker-E<gt>idx()>
+B<textblock>
 
-C<$checker-E<gt>hyperlink()>
+B<interior_sequence>
 
 =over 4
 
-=item AUTHOR
-
-=back
-
-=head2 Pod::Find - find POD documents in directory trees
+=item List Methods
 
-=over 4
+B<begin_list>
 
-=item SYNOPSIS
+=back
 
-=item DESCRIPTION
+B<end_list>
 
-=back
+B<add_item>
 
 =over 4
 
-=item C<pod_find( { %opts } , @directories )>
+=item Methods for headings
 
-C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
-1>
+B<head>
 
 =back
 
 =over 4
 
-=item C<simplify_name( $str )>
+=item Internal methods
+
+B<_output>
 
 =back
 
-=over 4
+B<_replace_special_chars>
 
-=item C<pod_where( { %opts }, $pod )>
+B<_create_label>
 
-C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
-1>
+B<_create_index>
 
-=back
+B<_clean_latex_commands>
 
 =over 4
 
-=item C<contains_pod( $file , $verbose )>
+=item NOTES
 
-=back
+=item SEE ALSO
 
-=over 4
+=item AUTHORS
 
-=item AUTHOR
+=item COPYRIGHT
 
-=item SEE ALSO
+=item REVISION
 
 =back
 
-=head2 Pod::Html - module to convert pod files to HTML
+=head2 Pod::Man - Convert POD data to formatted *roff input
 
 =over 4
 
@@ -12056,391 +14735,375 @@ C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
 
 =item DESCRIPTION
 
-=item ARGUMENTS
-
-backlink, css, flush, header, help, htmldir, htmlroot, index, infile,
-libpods, netscape, outfile, podpath, podroot, quiet, recurse, title,
-verbose
+center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
+release, section
 
-=item EXAMPLE
+=item DIAGNOSTICS
 
-=item ENVIRONMENT
+roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
+specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
+escape EE<lt>%sE<gt>, %s:%d: Unknown sequence %s, %s:%d: Unmatched =back
 
-=item AUTHOR
+=item BUGS
 
 =item SEE ALSO
 
-=item COPYRIGHT
+=item AUTHOR
+
+=item COPYRIGHT AND LICENSE
 
 =back
 
-=head2 Pod::InputObjects - objects representing POD input paragraphs,
-commands, etc.
+=head2 Pod::ParseLink -- Parse an L<> formatting code in POD text
 
 =over 4
 
 =item SYNOPSIS
 
-=item REQUIRES
-
-=item EXPORTS
-
 =item DESCRIPTION
 
-package B<Pod::InputSource>, package B<Pod::Paragraph>, package
-B<Pod::InteriorSequence>, package B<Pod::ParseTree>
-
-=back
-
-=over 4
+=item AUTHOR
 
-=item B<Pod::InputSource>
+=item COPYRIGHT AND LICENSE
 
 =back
 
+=head2 Pod::ParseUtils - helpers for POD parsing and conversion
+
 =over 4
 
-=item B<new()>
+=item SYNOPSIS
+
+=item DESCRIPTION
 
 =back
 
 =over 4
 
-=item B<name()>
+=item Pod::List
 
-=back
+Pod::List-E<gt>new()
 
-=over 4
+=back
 
-=item B<handle()>
+$list-E<gt>file()
 
-=back
+$list-E<gt>start()
 
-=over 4
+$list-E<gt>indent()
 
-=item B<was_cutting()>
+$list-E<gt>type()
 
-=back
+$list-E<gt>rx()
 
-=over 4
+$list-E<gt>item()
 
-=item B<Pod::Paragraph>
+$list-E<gt>parent()
 
-=back
+$list-E<gt>tag()
 
 =over 4
 
-=item Pod::Paragraph-E<gt>B<new()>
+=item Pod::Hyperlink
+
+Pod::Hyperlink-E<gt>new()
 
 =back
 
-=over 4
+$link-E<gt>parse($string)
 
-=item $pod_para-E<gt>B<cmd_name()>
+$link-E<gt>markup($string)
 
-=back
+$link-E<gt>text()
 
-=over 4
+$link-E<gt>warning()
 
-=item $pod_para-E<gt>B<text()>
+$link-E<gt>file(), $link-E<gt>line()
 
-=back
+$link-E<gt>page()
 
-=over 4
+$link-E<gt>node()
 
-=item $pod_para-E<gt>B<raw_text()>
+$link-E<gt>alttext()
 
-=back
+$link-E<gt>type()
+
+$link-E<gt>link()
 
 =over 4
 
-=item $pod_para-E<gt>B<cmd_prefix()>
+=item Pod::Cache
 
-=back
+Pod::Cache-E<gt>new()
 
-=over 4
+=back
 
-=item $pod_para-E<gt>B<cmd_separator()>
+$cache-E<gt>item()
 
-=back
+$cache-E<gt>find_page($name)
 
 =over 4
 
-=item $pod_para-E<gt>B<parse_tree()>
+=item Pod::Cache::Item
+
+Pod::Cache::Item-E<gt>new()
 
 =back
 
-=over 4
+$cacheitem-E<gt>page()
 
-=item $pod_para-E<gt>B<file_line()>
+$cacheitem-E<gt>description()
 
-=back
+$cacheitem-E<gt>path()
 
-=over 4
+$cacheitem-E<gt>file()
 
-=item B<Pod::InteriorSequence>
+$cacheitem-E<gt>nodes()
 
-=back
+$cacheitem-E<gt>find_node($name)
+
+$cacheitem-E<gt>idx()
 
 =over 4
 
-=item Pod::InteriorSequence-E<gt>B<new()>
+=item AUTHOR
+
+=item SEE ALSO
 
 =back
 
+=head2 Pod::Parser - base class for creating POD filters and translators
+
 =over 4
 
-=item $pod_seq-E<gt>B<cmd_name()>
+=item SYNOPSIS
 
-=back
+=item REQUIRES
 
-=over 4
+=item EXPORTS
 
-=item $pod_seq-E<gt>B<prepend()>
+=item DESCRIPTION
 
-=back
+=item QUICK OVERVIEW
 
-=over 4
+=item PARSING OPTIONS
 
-=item $pod_seq-E<gt>B<append()>
+B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
+B<-warnings> (default: unset)
 
 =back
 
 =over 4
 
-=item $pod_seq-E<gt>B<nested()>
+=item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
 
 =back
 
 =over 4
 
-=item $pod_seq-E<gt>B<raw_text()>
+=item B<command()>
+
+C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
 
 =back
 
 =over 4
 
-=item $pod_seq-E<gt>B<left_delimiter()>
+=item B<verbatim()>
+
+C<$text>, C<$line_num>, C<$pod_para>
 
 =back
 
 =over 4
 
-=item $pod_seq-E<gt>B<right_delimiter()>
+=item B<textblock()>
+
+C<$text>, C<$line_num>, C<$pod_para>
 
 =back
 
 =over 4
 
-=item $pod_seq-E<gt>B<parse_tree()>
+=item B<interior_sequence()>
 
 =back
 
 =over 4
 
-=item $pod_seq-E<gt>B<file_line()>
+=item OPTIONAL SUBROUTINE/METHOD OVERRIDES
 
 =back
 
 =over 4
 
-=item Pod::InteriorSequence::B<DESTROY()>
+=item B<new()>
 
 =back
 
 =over 4
 
-=item B<Pod::ParseTree>
+=item B<initialize()>
 
 =back
 
 =over 4
 
-=item Pod::ParseTree-E<gt>B<new()>
+=item B<begin_pod()>
 
 =back
 
 =over 4
 
-=item $ptree-E<gt>B<top()>
+=item B<begin_input()>
 
 =back
 
 =over 4
 
-=item $ptree-E<gt>B<children()>
+=item B<end_input()>
 
 =back
 
 =over 4
 
-=item $ptree-E<gt>B<prepend()>
+=item B<end_pod()>
 
 =back
 
 =over 4
 
-=item $ptree-E<gt>B<append()>
+=item B<preprocess_line()>
 
 =back
 
 =over 4
 
-=item $ptree-E<gt>B<raw_text()>
+=item B<preprocess_paragraph()>
 
 =back
 
 =over 4
 
-=item Pod::ParseTree::B<DESTROY()>
+=item METHODS FOR PARSING AND PROCESSING
 
 =back
 
 =over 4
 
-=item SEE ALSO
+=item B<parse_text()>
 
-=item AUTHOR
+B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
+I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
+I<code-ref>|I<method-name>
 
 =back
 
-=head2 Pod::LaTeX - Convert Pod data to formatted Latex
-
 =over 4
 
-=item SYNOPSIS
-
-=item DESCRIPTION
+=item B<interpolate()>
 
 =back
 
 =over 4
 
-=item OBJECT METHODS
-
-C<initialize>
+=item B<parse_paragraph()>
 
 =back
 
 =over 4
 
-=item Data Accessors
-
-B<AddPreamble>
+=item B<parse_from_filehandle()>
 
 =back
 
-B<AddPostamble>
+=over 4
 
-B<Head1Level>
+=item B<parse_from_file()>
 
-B<Label>
+=back
 
-B<LevelNoNum>
+=over 4
 
-B<MakeIndex>
+=item ACCESSOR METHODS
 
-B<ReplaceNAMEwithSection>
+=back
 
-B<StartWithNewPage>
+=over 4
 
-B<TableOfContents>
+=item B<errorsub()>
 
-B<UniqueLabels>
+=back
 
-B<UserPreamble>
+=over 4
 
-B<UserPostamble>
+=item B<cutting()>
 
-B<Lists>
+=back
 
 =over 4
 
-=item Subclassed methods
+=item B<parseopts()>
 
 =back
 
-B<begin_pod>
+=over 4
 
-B<end_pod>
+=item B<output_file()>
 
-B<command>
+=back
 
-B<verbatim>
+=over 4
 
-B<textblock>
+=item B<output_handle()>
 
-B<interior_sequence>
+=back
 
 =over 4
 
-=item List Methods
-
-B<begin_list>
+=item B<input_file()>
 
 =back
 
-B<end_list>
-
-B<add_item>
-
 =over 4
 
-=item Methods for headings
-
-B<head>
+=item B<input_handle()>
 
 =back
 
 =over 4
 
-=item Internal methods
-
-B<_output>
+=item B<input_streams()>
 
 =back
 
-B<_replace_special_chars>
-
-B<_create_label>
+=over 4
 
-B<_create_index>
+=item B<top_stream()>
 
-B<_clean_latex_commands>
+=back
 
 =over 4
 
-=item NOTES
-
-=item SEE ALSO
+=item PRIVATE METHODS AND DATA
 
-=item AUTHORS
+=back
 
-=item COPYRIGHT
+=over 4
 
-=item REVISION
+=item B<_push_input_stream()>
 
 =back
 
-=head2 Pod::Man - Convert POD data to formatted *roff input
-
 =over 4
 
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, quotes,
-release, section
+=item B<_pop_input_stream()>
 
-=item DIAGNOSTICS
+=back
 
-roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
-specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape
-EE<lt>%sE<gt>, Unknown sequence %s, %s: Unknown command paragraph "%s" on
-line %d, Unmatched =back
+=over 4
 
-=item BUGS
+=item TREE-BASED PARSING
 
 =item SEE ALSO
 
@@ -12448,7 +15111,7 @@ line %d, Unmatched =back
 
 =back
 
-=head2 Pod::ParseUtils - helpers for POD parsing and conversion
+=head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
 
 =over 4
 
@@ -12456,342 +15119,359 @@ line %d, Unmatched =back
 
 =item DESCRIPTION
 
-=back
-
 =over 4
 
-=item Pod::List
-
-Pod::List-E<gt>new()
+=item EXPORT
 
 =back
 
-$list-E<gt>file()
-
-$list-E<gt>start()
-
-$list-E<gt>indent()
-
-$list-E<gt>type()
-
-$list-E<gt>rx()
-
-$list-E<gt>item()
-
-$list-E<gt>parent()
-
-$list-E<gt>tag()
-
-=over 4
-
-=item Pod::Hyperlink
+=item AUTHOR
 
-Pod::Hyperlink-E<gt>new()
+=item SEE ALSO
 
 =back
 
-$link-E<gt>parse($string)
-
-$link-E<gt>markup($string)
+=head2 Pod::Select, podselect() - extract selected sections of POD from
+input
 
-$link-E<gt>text()
+=over 4
 
-$link-E<gt>warning()
+=item SYNOPSIS
 
-$link-E<gt>file(), $link-E<gt>line()
+=item REQUIRES
 
-$link-E<gt>page()
+=item EXPORTS
 
-$link-E<gt>node()
+=item DESCRIPTION
 
-$link-E<gt>alttext()
+=item SECTION SPECIFICATIONS
 
-$link-E<gt>type()
+=item RANGE SPECIFICATIONS
 
-$link-E<gt>link()
+=back
 
 =over 4
 
-=item Pod::Cache
-
-Pod::Cache-E<gt>new()
+=item OBJECT METHODS
 
 =back
 
-$cache-E<gt>item()
-
-$cache-E<gt>find_page($name)
-
 =over 4
 
-=item Pod::Cache::Item
-
-Pod::Cache::Item-E<gt>new()
+=item B<curr_headings()>
 
 =back
 
-$cacheitem-E<gt>page()
-
-$cacheitem-E<gt>description()
+=over 4
 
-$cacheitem-E<gt>path()
+=item B<select()>
 
-$cacheitem-E<gt>file()
+=back
 
-$cacheitem-E<gt>nodes()
+=over 4
 
-$cacheitem-E<gt>find_node($name)
+=item B<add_selection()>
 
-$cacheitem-E<gt>idx()
+=back
 
 =over 4
 
-=item AUTHOR
-
-=item SEE ALSO
+=item B<clear_selections()>
 
 =back
 
-=head2 Pod::Parser - base class for creating POD filters and translators
-
 =over 4
 
-=item SYNOPSIS
+=item B<match_section()>
 
-=item REQUIRES
+=back
 
-=item EXPORTS
+=over 4
 
-=item DESCRIPTION
+=item B<is_selected()>
 
-=item QUICK OVERVIEW
+=back
 
-=item PARSING OPTIONS
+=over 4
 
-B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
-B<-warnings> (default: unset)
+=item EXPORTED FUNCTIONS
 
 =back
 
 =over 4
 
-=item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
+=item B<podselect()>
+
+B<-output>, B<-sections>, B<-ranges>
 
 =back
 
 =over 4
 
-=item B<command()>
-
-C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
+=item PRIVATE METHODS AND DATA
 
 =back
 
 =over 4
 
-=item B<verbatim()>
-
-C<$text>, C<$line_num>, C<$pod_para>
+=item B<_compile_section_spec()>
 
 =back
 
 =over 4
 
-=item B<textblock()>
-
-C<$text>, C<$line_num>, C<$pod_para>
+=item $self->{_SECTION_HEADINGS}
 
 =back
 
 =over 4
 
-=item B<interior_sequence()>
+=item $self->{_SELECTED_SECTIONS}
 
 =back
 
 =over 4
 
-=item OPTIONAL SUBROUTINE/METHOD OVERRIDES
+=item SEE ALSO
+
+=item AUTHOR
 
 =back
 
+=head2 Pod::Text - Convert POD data to formatted ASCII text
+
 =over 4
 
-=item B<new()>
+=item SYNOPSIS
 
-=back
+=item DESCRIPTION
 
-=over 4
+alt, code, indent, loose, quotes, sentence, width
 
-=item B<initialize()>
+=item DIAGNOSTICS
 
-=back
+Bizarre space in item, Item called without tag, Can't open %s for reading:
+%s, Invalid quote specification "%s", %s:%d: Unknown command paragraph
+"%s", %s:%d: Unknown escape: %s, %s:%d: Unknown sequence: %s, %s:%d:
+Unmatched =back
 
-=over 4
+=item RESTRICTIONS
 
-=item B<begin_pod()>
+=item NOTES
 
-=back
+=item SEE ALSO
 
-=over 4
+=item AUTHOR
 
-=item B<begin_input()>
+=item COPYRIGHT AND LICENSE
 
 =back
 
+=head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
+
 =over 4
 
-=item B<end_input()>
+=item SYNOPSIS
 
-=back
+=item DESCRIPTION
 
-=over 4
+=item BUGS
 
-=item B<end_pod()>
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT AND LICENSE
 
 =back
 
+=head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
+text
+
 =over 4
 
-=item B<preprocess_line()>
+=item SYNOPSIS
 
-=back
+=item DESCRIPTION
 
-=over 4
+=item BUGS
 
-=item B<preprocess_paragraph()>
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT AND LICENSE
 
 =back
 
+=head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII
+text with format escapes
+
 =over 4
 
-=item METHODS FOR PARSING AND PROCESSING
+=item SYNOPSIS
 
-=back
+=item DESCRIPTION
 
-=over 4
+=item SEE ALSO
 
-=item B<parse_text()>
+=item AUTHOR
 
-B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
-I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
-I<code-ref>|I<method-name>
+=item COPYRIGHT AND LICENSE
 
 =back
 
+=head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
+documentation
+
 =over 4
 
-=item B<interpolate()>
+=item SYNOPSIS
 
-=back
+=item ARGUMENTS
 
-=over 4
+C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
+C<-pathlist>
 
-=item B<parse_paragraph()>
+=item DESCRIPTION
 
-=back
+=item EXAMPLES
 
 =over 4
 
-=item B<parse_from_filehandle()>
+=item Recommended Use
 
 =back
 
-=over 4
+=item CAVEATS
 
-=item B<parse_from_file()>
+=item AUTHOR
+
+=item ACKNOWLEDGEMENTS
 
 =back
 
+=head2 SDBM_File - Tied access to sdbm files
+
 =over 4
 
-=item ACCESSOR METHODS
+=item SYNOPSIS
 
-=back
+=item DESCRIPTION
+
+C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
+
+=item DIAGNOSTICS
 
 =over 4
 
-=item B<errorsub()>
+=item C<sdbm store returned -1, errno 22, key "..." at ...>
 
 =back
 
-=over 4
-
-=item B<cutting()>
+=item BUGS AND WARNINGS
 
 =back
 
+=head2 Safe - Compile and execute code in restricted compartments
+
 =over 4
 
-=item B<parseopts()>
+=item SYNOPSIS
 
-=back
+=item DESCRIPTION
+
+a new namespace, an operator mask
+
+=item WARNING
 
 =over 4
 
-=item B<output_file()>
+=item RECENT CHANGES
 
-=back
+=item Methods in class Safe
 
-=over 4
+permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
+...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
+(PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
+root (NAMESPACE), mask (MASK)
 
-=item B<output_handle()>
+=item Some Safety Issues
 
-=back
+Memory, CPU, Snooping, Signals, State Changes
 
-=over 4
+=item AUTHOR
 
-=item B<input_file()>
+=back
 
 =back
 
+=head2 Scalar::Util - A selection of general-utility scalar subroutines
+
 =over 4
 
-=item B<input_handle()>
+=item SYNOPSIS
 
-=back
+=item DESCRIPTION
 
-=over 4
+blessed EXPR, dualvar NUM, STRING, isweak EXPR, readonly SCALAR, reftype
+EXPR, tainted EXPR, weaken REF
 
-=item B<input_streams()>
+=item COPYRIGHT
+
+=item BLATANT PLUG
 
 =back
 
+=head2 Search::Dict, look - search for key in dictionary file
+
 =over 4
 
-=item B<top_stream()>
+=item SYNOPSIS
+
+=item DESCRIPTION
 
 =back
 
+=head2 SelectSaver - save and restore selected file handle
+
 =over 4
 
-=item PRIVATE METHODS AND DATA
+=item SYNOPSIS
+
+=item DESCRIPTION
 
 =back
 
+=head2 SelfLoader - load functions only on demand
+
 =over 4
 
-=item B<_push_input_stream()>
+=item SYNOPSIS
 
-=back
+=item DESCRIPTION
 
 =over 4
 
-=item B<_pop_input_stream()>
+=item The __DATA__ token
 
-=back
+=item SelfLoader autoloading
 
-=over 4
+=item Autoloading and package lexicals
 
-=item TREE-BASED PARSING
+=item SelfLoader and AutoLoader
 
-=item SEE ALSO
+=item __DATA__, __END__, and the FOOBAR::DATA filehandle.
 
-=item AUTHOR
+=item Classes and inherited methods.
 
 =back
 
-=head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
+=item Multiple packages and fully qualified subroutine names
+
+=back
+
+=head2 Shell - run shell commands transparently within perl
 
 =over 4
 
@@ -12801,124 +15481,145 @@ I<code-ref>|I<method-name>
 
 =over 4
 
-=item EXPORT
+=item OBJECT ORIENTED SYNTAX
 
 =back
 
 =item AUTHOR
 
-=item SEE ALSO
-
 =back
 
-=head2 Pod::Select, podselect() - extract selected sections of POD from
-input
+=head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
+socket.h defines and structure manipulators 
 
 =over 4
 
 =item SYNOPSIS
 
-=item REQUIRES
-
-=item EXPORTS
-
 =item DESCRIPTION
 
-=item SECTION SPECIFICATIONS
-
-=item RANGE SPECIFICATIONS
+inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
+INADDR_LOOPBACK, INADDR_NONE, sockaddr_in PORT, ADDRESS, sockaddr_in
+SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, unpack_sockaddr_in
+SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un SOCKADDR_UN,
+pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
 
 =back
 
+=head2 Storable - persistency for perl data structures
+
 =over 4
 
-=item OBJECT METHODS
+=item SYNOPSIS
 
-=back
+=item DESCRIPTION
 
-=over 4
+=item MEMORY STORE
 
-=item B<curr_headings()>
+=item ADVISORY LOCKING
 
-=back
+=item SPEED
 
-=over 4
+=item CANONICAL REPRESENTATION
 
-=item B<select()>
+=item ERROR REPORTING
 
-=back
+=item WIZARDS ONLY
 
 =over 4
 
-=item B<add_selection()>
+=item Hooks
 
-=back
+C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
+I<serialized>, ..
 
-=over 4
+=item Predicates
 
-=item B<clear_selections()>
+C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
+C<Storable::is_retrieving>
+
+=item Recursion
+
+=item Deep Cloning
 
 =back
 
-=over 4
+=item EXAMPLES
 
-=item B<match_section()>
+=item WARNING
 
-=back
+=item BUGS
 
-=over 4
+=item CREDITS
 
-=item B<is_selected()>
+=item TRANSLATIONS
+
+=item AUTHOR
+
+=item SEE ALSO
 
 =back
 
+=head2 Switch - A switch statement for Perl
+
 =over 4
 
-=item EXPORTED FUNCTIONS
+=item VERSION
 
-=back
+=item SYNOPSIS
+
+=item BACKGROUND
+
+=item DESCRIPTION
 
 =over 4
 
-=item B<podselect()>
-
-B<-output>, B<-sections>, B<-ranges>
+=item Allowing fall-through
 
-=back
+=item Automating fall-through
 
-=over 4
+=item Alternative syntax
 
-=item PRIVATE METHODS AND DATA
+=item Higher-order Operations
 
 =back
 
-=over 4
+=item DEPENDENCIES
 
-=item B<_compile_section_spec()>
+=item AUTHOR
 
-=back
+=item BUGS
 
-=over 4
+=item LIMITATION
 
-=item $self->{_SECTION_HEADINGS}
+=item COPYRIGHT
 
 =back
 
+=head2 Symbol - manipulate Perl symbols and their names
+
 =over 4
 
-=item $self->{_SELECTED_SECTIONS}
+=item SYNOPSIS
+
+=item DESCRIPTION
 
 =back
 
+=head2 Sys::Hostname - Try every conceivable way to get hostname
+
 =over 4
 
-=item SEE ALSO
+=item SYNOPSIS
+
+=item DESCRIPTION
 
 =item AUTHOR
 
 =back
 
-=head2 Pod::Text - Convert POD data to formatted ASCII text
+=head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
+interface to the UNIX syslog(3) calls
 
 =over 4
 
@@ -12926,17 +15627,11 @@ B<-output>, B<-sections>, B<-ranges>
 
 =item DESCRIPTION
 
-alt, indent, loose, quotes, sentence, width
-
-=item DIAGNOSTICS
-
-Bizarre space in item, Can't open %s for reading: %s, Invalid quote
-specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape:
-%s, Unknown sequence: %s, Unmatched =back
-
-=item RESTRICTIONS
+openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
+setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
+closelog
 
-=item NOTES
+=item EXAMPLES
 
 =item SEE ALSO
 
@@ -12944,7 +15639,8 @@ specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape:
 
 =back
 
-=head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
+=head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
+Perl interface to the UNIX syslog(3) calls
 
 =over 4
 
@@ -12952,7 +15648,11 @@ specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape:
 
 =item DESCRIPTION
 
-=item BUGS
+openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
+setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
+closelog
+
+=item EXAMPLES
 
 =item SEE ALSO
 
@@ -12960,8 +15660,7 @@ specification "%s", %s:%d: Unknown command paragraph "%s", Unknown escape:
 
 =back
 
-=head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
-text
+=head2 Term::ANSIColor - Color screen output using ANSI escape sequences
 
 =over 4
 
@@ -12969,16 +15668,29 @@ text
 
 =item DESCRIPTION
 
-=item BUGS
+=item DIAGNOSTICS
+
+Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
+use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
+comma allowed after filehandle, No name for escape sequence %s
+
+=item ENVIRONMENT
+
+ANSI_COLORS_DISABLED
+
+=item RESTRICTIONS
+
+=item NOTES
 
 =item SEE ALSO
 
-=item AUTHOR
+=item AUTHORS
+
+=item LICENSE
 
 =back
 
-=head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII
-text with format escapes
+=head2 Term::Cap - Perl termcap interface
 
 =over 4
 
@@ -12986,43 +15698,30 @@ text with format escapes
 
 =item DESCRIPTION
 
-=item SEE ALSO
-
-=item AUTHOR
+=item EXAMPLES
 
 =back
 
-=head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
-documentation
+=head2 Term::Complete - Perl word completion module
 
 =over 4
 
 =item SYNOPSIS
 
-=item ARGUMENTS
-
-C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
-C<-pathlist>
-
 =item DESCRIPTION
 
-=item EXAMPLES
-
-=over 4
-
-=item Recommended Use
+E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
 
-=back
+=item DIAGNOSTICS
 
-=item CAVEATS
+=item BUGS
 
 =item AUTHOR
 
-=item ACKNOWLEDGEMENTS
-
 =back
 
-=head2 SDBM_File - Tied access to sdbm files
+=head2 Term::ReadLine - Perl interface to various C<readline> packages. If
+no real package is found, substitutes stubs instead of basic functions.
 
 =over 4
 
@@ -13030,21 +15729,24 @@ C<-pathlist>
 
 =item DESCRIPTION
 
-C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
+=item Minimal set of supported functions
 
-=item DIAGNOSTICS
+C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
+C<MinLine>, C<findConsole>, Attribs, C<Features>
 
-=over 4
+=item Additional supported functions
 
-=item C<sdbm store returned -1, errno 22, key "..." at ...>
+C<tkRunning>, C<ornaments>, C<newTTY>
 
-=back
+=item EXPORTS
 
-=item BUGS AND WARNINGS
+=item ENVIRONMENT
+
+=item CAVEATS
 
 =back
 
-=head2 Safe - Compile and execute code in restricted compartments
+=head2 Test - provides a simple framework for writing test scripts
 
 =over 4
 
@@ -13052,52 +15754,39 @@ C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
 
 =item DESCRIPTION
 
-a new namespace, an operator mask
-
-=item WARNING
-
 =over 4
 
-=item RECENT CHANGES
-
-=item Methods in class Safe
-
-permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
-...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
-(PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
-root (NAMESPACE), mask (MASK)
-
-=item Some Safety Issues
-
-Memory, CPU, Snooping, Signals, State Changes
+=item Functions
 
-=item AUTHOR
+B<plan>
 
 =back
 
 =back
 
-=head2 Search::Dict, look - search for key in dictionary file
+B<_to_value>
+
+B<ok>
 
 =over 4
 
-=item SYNOPSIS
+=item TEST TYPES
 
-=item DESCRIPTION
+NORMAL TESTS, SKIPPED TESTS, TODO TESTS
 
-=back
+=item ONFAIL
 
-=head2 SelectSaver - save and restore selected file handle
+=item BUGS and CAVEATS
 
-=over 4
+=item TODO
 
-=item SYNOPSIS
+=item SEE ALSO
 
-=item DESCRIPTION
+=item AUTHOR
 
 =back
 
-=head2 SelfLoader - load functions only on demand
+=head2 Test::Builder - Backend for building test libraries
 
 =over 4
 
@@ -13107,106 +15796,93 @@ Memory, CPU, Snooping, Signals, State Changes
 
 =over 4
 
-=item The __DATA__ token
-
-=item SelfLoader autoloading
+=item Construction
 
-=item Autoloading and package lexicals
+B<new>
 
-=item SelfLoader and AutoLoader
+=back
 
-=item __DATA__, __END__, and the FOOBAR::DATA filehandle.
+=back
 
-=item Classes and inherited methods.
+=over 4
 
-=back
+=item Setting up tests
 
-=item Multiple packages and fully qualified subroutine names
+B<exported_to>
 
 =back
 
-=head2 Shell - run shell commands transparently within perl
+B<plan>
 
-=over 4
+B<expected_tests>
 
-=item SYNOPSIS
+B<no_plan>
 
-=item DESCRIPTION
+B<skip_all>
 
 =over 4
 
-=item OBJECT ORIENTED SYNTAX
-
-=back
+=item Running tests
 
-=item AUTHOR
+B<ok>
 
 =back
 
-=head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
-socket.h defines and structure manipulators 
+B<is_eq>, B<is_num>
 
-=over 4
+B<like>
 
-=item SYNOPSIS
+B<skip>
 
-=item DESCRIPTION
+B<skip_rest>
 
-inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
-INADDR_LOOPBACK, INADDR_NONE, sockaddr_in PORT, ADDRESS, sockaddr_in
-SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS, unpack_sockaddr_in
-SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un SOCKADDR_UN,
-pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
+=over 4
 
-=back
+=item Test style
 
-=head2 Storable - persistency for perl data structures
+B<level>
 
-=over 4
+=back
 
-=item SYNOPSIS
+B<use_numbers>
 
-=item DESCRIPTION
+B<no_header>, B<no_ending>
 
-=item MEMORY STORE
+=over 4
 
-=item ADVISORY LOCKING
+=item Output
 
-=item SPEED
+B<diag>
 
-=item CANONICAL REPRESENTATION
+=back
 
-=item ERROR REPORTING
+B<_print>
 
-=item WIZARDS ONLY
+B<output>, B<failure_output>, B<todo_output>
 
 =over 4
 
-=item Hooks
-
-C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
-I<serialized>, ..
+=item Test Status and Info
 
-=item Predicates
+B<current_test>
 
-C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
-C<Storable::is_retrieving>
+=back
 
-=item Recursion
+B<summary>
 
-=item Deep Cloning
+B<details>  I<UNIMPLEMENTED>, B<todo>
 
-=back
+B<caller>
 
-=item EXAMPLES
+B<_sanity_check>
 
-=item WARNING
+B<_whoa>
 
-=item BUGS
+B<_my_exit>
 
-=item CREDITS
+=over 4
 
-=item TRANSLATIONS
+=item EXAMPLES
 
 =item AUTHOR
 
@@ -13214,62 +15890,73 @@ C<Storable::is_retrieving>
 
 =back
 
-=head2 Switch - A switch statement for Perl
+=head2 Test::Harness - run perl standard test scripts with statistics
 
 =over 4
 
-=item VERSION
-
 =item SYNOPSIS
 
-=item BACKGROUND
-
 =item DESCRIPTION
 
 =over 4
 
-=item Allowing fall-through
-
-=item Automating fall-through
+=item The test script output
 
-=item Higher-order Operations
+B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>,
+B<$Test::Harness::verbose>, B<$Test::Harness::switches>, B<Skipping tests>,
+B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything else>
 
-=back
+=item Failure
 
-=item DEPENDENCIES
+B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
+Failed>
 
-=item AUTHOR
+=item Functions
 
-=item BUGS
+B<runtests>
 
-=item COPYRIGHT
+=back
 
 =back
 
-=head2 Symbol - manipulate Perl symbols and their names
+B<_all_ok>
+
+B<_globdir>
+
+B<_run_all_tests>
+
+B<_mk_leader>
 
 =over 4
 
-=item SYNOPSIS
+=item EXPORT
 
-=item DESCRIPTION
+=item DIAGNOSTICS
 
-=back
+C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
+%s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
+%d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
+%s>, C<FAILED--Further testing stopped%s>
 
-=head2 Sys::Hostname - Try every conceivable way to get hostname
+=item ENVIRONMENT
 
-=over 4
+C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>, C<HARNESS_COMPILE_TEST>,
+C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_COLUMNS>,
+C<HARNESS_ACTIVE>
+
+=item EXAMPLE
+
+=item SEE ALSO
 
-=item SYNOPSIS
+=item AUTHORS
 
-=item DESCRIPTION
+=item TODO
 
-=item AUTHOR
+=item BUGS
 
 =back
 
-=head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
-interface to the UNIX syslog(3) calls
+=head2 Test::More - yet another framework for writing test scripts
 
 =over 4
 
@@ -13277,93 +15964,86 @@ interface to the UNIX syslog(3) calls
 
 =item DESCRIPTION
 
-openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
-setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
-closelog
-
-=item EXAMPLES
-
-=item SEE ALSO
+=over 4
 
-=item AUTHOR
+=item I love it when a plan comes together
 
 =back
 
-=head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
-Perl interface to the UNIX syslog(3) calls
+=back
 
 =over 4
 
-=item SYNOPSIS
+=item Test names
 
-=item DESCRIPTION
+=item I'm ok, you're not ok.
 
-openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
-setlogmask $mask_priority, setlogsock $sock_type (added in 5.004_02),
-closelog
+B<ok>
 
-=item EXAMPLES
+=back
 
-=item SEE ALSO
+B<is>, B<isnt>
 
-=item AUTHOR
+B<like>
 
-=back
+B<can_ok>
 
-=head2 Term::ANSIColor - Color screen output using ANSI escape sequences
+B<isa_ok>
+
+B<pass>, B<fail>
 
 =over 4
 
-=item SYNOPSIS
+=item Module tests
 
-=item DESCRIPTION
+B<use_ok>
 
-=item DIAGNOSTICS
+=back
 
-Invalid attribute name %s, Name "%s" used only once: possible typo, No
-comma allowed after filehandle, Bareword "%s" not allowed while "strict
-subs" in use
+B<require_ok>
 
-=item RESTRICTIONS
+=over 4
 
-=item NOTES
+=item Conditional tests
 
-=item AUTHORS
+B<SKIP: BLOCK>
 
 =back
 
-=head2 Term::Cap - Perl termcap interface
+B<TODO: BLOCK>
 
 =over 4
 
-=item SYNOPSIS
-
-=item DESCRIPTION
+=item Comparision functions
 
-=item EXAMPLES
+B<is_deeply>
 
 =back
 
-=head2 Term::Complete - Perl word completion module
+B<eq_array>
 
-=over 4
+B<eq_hash>
 
-=item SYNOPSIS
+B<eq_set>
 
-=item DESCRIPTION
+=over 4
 
-E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
+=item NOTES
 
-=item DIAGNOSTICS
+=item BUGS and CAVEATS
 
-=item BUGS
+Making your own ok(), The eq_* family have some caveats, Test::Harness
+upgrades
 
 =item AUTHOR
 
+=item HISTORY
+
+=item SEE ALSO
+
 =back
 
-=head2 Term::ReadLine - Perl interface to various C<readline> packages. If
-no real package is found, substitutes stubs instead of basic functions.
+=head2 Test::Simple - Basic utilities for writing tests.
 
 =over 4
 
@@ -13371,83 +16051,60 @@ no real package is found, substitutes stubs instead of basic functions.
 
 =item DESCRIPTION
 
-=item Minimal set of supported functions
-
-C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, $C<OUT>,
-C<MinLine>, C<findConsole>, Attribs, C<Features>
-
-=item Additional supported functions
-
-C<tkRunning>, C<ornaments>, C<newTTY>
-
-=item EXPORTS
-
-=item ENVIRONMENT
-
-=item CAVEATS
+B<ok>
 
 =back
 
-=head2 Test - provides a simple framework for writing test scripts
-
 =over 4
 
-=item SYNOPSIS
-
-=item DESCRIPTION
+=item EXAMPLE
 
-=item TEST TYPES
+=item CAVEATS
 
-NORMAL TESTS, SKIPPED TESTS, TODO TESTS
+=item NOTES
 
-=item RETURN VALUE
+=item HISTORY
 
-=item ONFAIL
+=item AUTHOR
 
 =item SEE ALSO
 
-=item AUTHOR
+L<Test::More>, L<Test>, L<Test::Unit>, L<Pod::Tests>, L<SelfTest>,
+L<Test::Harness>
 
 =back
 
-=head2 Test::Harness - run perl standard test scripts with statistics
+=head2 Test::Tutorial - A tutorial about writing really basic tests
 
 =over 4
 
-=item SYNOPSIS
-
 =item DESCRIPTION
 
 =over 4
 
-=item The test script output
+=item Nuts and bolts of testing.
 
-B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>,
-B<$Test::Harness::verbose>, B<$Test::Harness::switches>, B<Skipping tests>,
-B<Todo tests>, B<Bail out!>, B<Comments>
+=item Where to start?
 
-=back
+=item Names
 
-=item EXPORT
+=item Test the manual
 
-=item DIAGNOSTICS
+=item Sometimes the tests are wrong
 
-C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
-%s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
-%d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
-%s>, C<FAILED--Further testing stopped%s>
+=item Testing lots of values
 
-=item ENVIRONMENT
+=item Informative names
 
-C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>, C<HARNESS_COMPILE_TEST>,
-C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_COLUMNS>,
-C<HARNESS_ACTIVE>
+=item Skipping tests
 
-=item SEE ALSO
+=item Todo tests
 
-=item AUTHORS
+=item Testing with taint mode.
 
-=item BUGS
+=back
+
+=item FOOTNOTES
 
 =back
 
@@ -13587,14 +16244,15 @@ unexpand(1)
 
 =item DESCRIPTION
 
+=item OVERRIDES
+
 =item EXAMPLE
 
 =item AUTHOR
 
 =back
 
-=head2 Thread - manipulate threads in Perl (EXPERIMENTAL, subject to
-change)
+=head2 Thread - manipulate threads in Perl
 
 =over 4
 
@@ -13606,9 +16264,9 @@ change)
 
 =item FUNCTIONS
 
-new \&start_sub, new \&start_sub, LIST, lock VARIABLE, async BLOCK;,
-Thread->self, Thread->list, cond_wait VARIABLE, cond_signal VARIABLE,
-cond_broadcast VARIABLE, yield
+$thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
+LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
+cond_signal VARIABLE, cond_broadcast VARIABLE, yield
 
 =item METHODS
 
@@ -13773,6 +16431,34 @@ TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
 
 =back
 
+=head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
+timers
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
+$interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
+alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer,
+getitimer ( $which )
+
+=item EXAMPLES
+
+=item C API
+
+=item CAVEATS
+
+=item AUTHORS
+
+=item REVISION
+
+=item COPYRIGHT
+
+=back
+
 =head2 Time::Local - efficiently compute time from local and GMT time
 
 =over 4
@@ -13837,8 +16523,165 @@ function
 
 =item DESCRIPTION
 
-isa ( TYPE ), can ( METHOD ), VERSION ( [ REQUIRE ] ), UNIVERSAL::isa (
-VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD )
+$obj->isa( TYPE ), CLASS->isa( TYPE ), isa( VAL, TYPE ), $obj->can( METHOD
+), CLASS->can( METHOD ), can( VAL, METHOD ), VERSION ( [ REQUIRE ] )
+
+=back
+
+=head2 Unicode::Collate - use UCA (Unicode Collation Algorithm)
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Constructor and Tailoring
+
+alternate, backwards, entry, ignoreName, ignoreChar, level, normalization,
+overrideCJK, overrideHangul, preprocess, rearrange, table, undefName,
+undefChar, katakana_before_hiragana, upper_before_lower
+
+=item Other methods
+
+C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
+$Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
+C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
+$b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
+$Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
+C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$position =
+$Collator-E<gt>index($string, $substring)>, C<($position, $length) =
+$Collator-E<gt>index($string, $substring)>
+
+=item EXPORT
+
+=item CAVEAT
+
+=back
+
+=item AUTHOR
+
+=item SEE ALSO
+
+Unicode Collation Algorithm - Unicode TR #10, L<Unicode::Normalize>
+
+=back
+
+=head2 Unicode::Normalize - normalized forms of Unicode text
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+C<$string_NFD = NFD($raw_string)>, C<$string_NFC = NFC($raw_string)>,
+C<$string_NFKD = NFKD($raw_string)>, C<$string_NFKC = NFKC($raw_string)>,
+C<$normalized_string = normalize($form_name, $raw_string)>
+
+=over 4
+
+=item EXPORT
+
+=back
+
+=item AUTHOR
+
+=item SEE ALSO
+
+L<Lingua::KO::Hangul::Util>, http://www.unicode.org/unicode/reports/tr15/
+
+=back
+
+=head2 Unicode::UCD - Unicode character database
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
+=over 4
+
+=item charinfo
+
+=back
+
+=over 4
+
+=item charblock
+
+=back
+
+=over 4
+
+=item charscript
+
+=back
+
+=over 4
+
+=item charblocks
+
+=back
+
+=over 4
+
+=item charscripts
+
+=back
+
+=over 4
+
+=item Blocks versus Scripts
+
+=item Matching Scripts and Blocks
+
+=item Code Point Arguments
+
+=item charinrange
+
+=back
+
+=over 4
+
+=item compexcl
+
+=back
+
+=over 4
+
+=item casefold
+
+=back
+
+=over 4
+
+=item casespec
+
+=back
+
+=over 4
+
+=item Unicode::UCD::UnicodeVersion
+
+=back
+
+=over 4
+
+=item Implementation Note
+
+=back
+
+=over 4
+
+=item BUGS
+
+=item AUTHOR
 
 =back