X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperltoc.pod;h=617ed2390f2bc21729319d06b9ba26a6593761c1;hb=c4f1ce08c1c189f6f2a738bd05fe6603760d0e85;hp=3f86e677e52f87a47f14e0f0d1da0a5cc8d8f7a1;hpb=758a5d7997f283f8e3786c3e353533cc466d5004;p=p5sagit%2Fp5-mst-13.2.git

diff --git a/pod/perltoc.pod b/pod/perltoc.pod
index 3f86e67..617ed23 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/11/19
+17:09:37 $)
 
 =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,49 +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,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
+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 THING, log EXPR, log,
+lstat EXPR, lstat, m//, map BLOCK LIST, map EXPR,LIST, mkdir FILENAME,MASK,
+mkdir FILENAME, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgrcv
+ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my 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,MODE,REFERENCE, open FILEHANDLE, opendir DIRHANDLE,EXPR, ord
+EXPR, ord, our EXPR, our EXPR : ATTRIBUTES, pack TEMPLATE,LIST, package
+NAMESPACE, package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos
+SCALAR, pos, print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE
+FORMAT, LIST, printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST,
+q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR,
+quotemeta, rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
+FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
+readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
+ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR,
+require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir
+DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME,
+rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir
+DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT,
+semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
@@ -472,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
 
@@ -496,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
 
@@ -580,7 +645,7 @@ more elaborate constructs
 
 =back
 
-=head2 perlpod - plain old documentation
+=head2 perlpod - the Plain Old Documentation format
 
 =over 4
 
@@ -588,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
@@ -649,7 +767,7 @@ Discontinuance, Deprecation, Discontinuance, Discontinuance
 
 =item Parsing Traps
 
-Parsing, Parsing, Parsing, Parsing
+Parsing, Parsing, Parsing, Parsing, Parsing
 
 =item Numerical Traps
 
@@ -733,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
 
@@ -833,7 +952,8 @@ 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
 
@@ -883,33 +1003,34 @@ listing
 
 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
 $LAST_PAREN_MATCH, $+, $^N, @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,
+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,
+${^OPEN}, $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, @F, @INC, @_,
-%INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
+$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
 
@@ -1011,6 +1132,78 @@ ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, $ARGV, @ARGV, @F, @INC, @_,
 
 =back
 
+=head2 perlpacktut - tutorial on C<pack> and C<unpack>
+
+=over 4
+
+=item DESCRIPTION
+
+=item The Basic Principle
+
+=item Packing Text
+
+=item Packing Numbers
+
+=over 4
+
+=item Integers
+
+=item Unpacking a Stack Frame
+
+=item How to Eat an Egg on a Net
+
+=item Floating point Numbers
+
+=back
+
+=item Exotic Templates
+
+=over 4
+
+=item Bit Strings
+
+=item Uuencoding
+
+=item Doing Sums
+
+=item  Unicode
+
+=item Another Portable Binary Encoding
+
+=back
+
+=item Lengths and Widths
+
+=over 4
+
+=item String Lengths
+
+=item Dynamic Templates
+
+=back
+
+=item Packing and Unpacking C Structures
+
+=over 4
+
+=item The Alignment Pit
+
+=item Alignment, Take 2
+
+=item Alignment, Take 3
+
+=item Pointers for How to Use Them
+
+=back
+
+=item Pack Recipes
+
+=item Funnies Section
+
+=item Authors
+
+=back
+
 =head2 perlretut - Perl regular expressions tutorial
 
 =over 4
@@ -1089,7 +1282,7 @@ i, m, s, x
 
 =item Regular Expressions
 
-cntrl, graph, print, punct, xdigit
+[1], [2], [3], cntrl, graph, print, punct, xdigit
 
 =item Extended Patterns
 
@@ -1341,7 +1534,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
 
@@ -1656,6 +1849,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
@@ -1843,20 +2044,21 @@ 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, exit EXPR, exit, 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,
+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,
 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
@@ -1981,6 +2183,60 @@ 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 Displaying Unicode As Text
+
+=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 UNICODE IN OLDER PERLS
+
+=item SEE ALSO
+
+=item ACKNOWLEDGEMENTS
+
+=item AUTHOR, COPYRIGHT, AND LICENSE
+
+=back
+
 =head2 perlunicode - Unicode support in Perl
 
 =over 4
@@ -1992,7 +2248,7 @@ 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
 
@@ -2008,6 +2264,21 @@ to enable a few features
 
 =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
@@ -2184,6 +2455,31 @@ chcp, dataset access, OS/390, z/OS iconv, locales
 
 =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
@@ -2197,52 +2493,52 @@ chcp, dataset access, OS/390, z/OS iconv, locales
 =item Pragmatic Modules
 
 attributes, attrs, autouse, base, blib, bytes, charnames, constant,
-diagnostics, fields, filetest, integer, less, locale, open, ops, overload,
-re, sigtrap, strict, subs, utf8, vars, warnings, warnings::register
+diagnostics, encoding, fields, filetest, integer, less, locale, open, ops,
+overload, re, sigtrap, sort, strict, subs, utf8, vars, vmsish, warnings,
+warnings::register
 
 =item Standard Modules
 
-AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
-B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
-B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
-B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
-CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
-CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
-Class::Struct, Cwd, DB, DB_File, Devel::SelfStubber, Digest, DirHandle,
-Dumpvalue, Encode, Encode::EncodeFormat, Encode::Tcl, English, Env,
-Exporter, Exporter::Heavy, ExtUtils::Command, ExtUtils::Constant,
-ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
-ExtUtils::MM_Cygwin, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_Unix,
-ExtUtils::MM_VMS, ExtUtils::MM_Win32, ExtUtils::MakeMaker,
-ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists,
-ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename,
-File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find,
-File::Path, File::Spec, File::Spec::Epoc, File::Spec::Functions,
-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,
-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, Text::Abbrev, Text::Balanced, Text::ParseWords,
-Text::Soundex, Text::Tabs, Text::Wrap, Thread, Thread::Queue,
-Thread::Semaphore, Thread::Signal, Thread::Specific, Tie::Array,
-Tie::Handle, Tie::Hash, Tie::RefHash, Tie::Scalar, Tie::SubstrHash,
-Time::Local, Time::gmtime, Time::localtime, Time::tm, UNIVERSAL, UnicodeCD,
-User::grent, User::pwent, Win32
+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::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, Locale::Constants,
+Locale::Country, Locale::Currency, Locale::Language, Locale::Maketext,
+Locale::Maketext::TPJ13, Math::BigFloat, Math::BigInt, Math::BigInt::Calc,
+Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire,
+Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File,
+Memoize::SDBM_File, Memoize::Saves, Memoize::Storable, NDBM_File, NEXT,
+Net::Cmd, Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc,
+Net::POP3, Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ,
+Net::netent, Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX,
+PerlIO, Pod::Checker, Pod::Find, Pod::Html, Pod::InputObjects, Pod::LaTeX,
+Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser, Pod::Plainer,
+Pod::Select, Pod::Text, Pod::Text::Color, Pod::Text::Overstrike,
+Pod::Text::Termcap, Pod::Usage, Pod::t::basic, SDBM_File, Safe,
+Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch,
+Symbol, Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine, Test,
+Test::Builder, Test::Harness, Test::More, Test::Simple, Test::Tutorial,
+Text::Abbrev, Text::Balanced, Text::ParseWords, Text::Soundex, Text::Tabs,
+Text::Wrap, Thread, Tie::Array, Tie::Handle, Tie::Hash, Tie::RefHash,
+Tie::Scalar, Tie::SubstrHash, Time::Local, Time::gmtime, Time::localtime,
+Time::tm, UNIVERSAL, Unicode::Collate, Unicode::UCD, User::grent,
+User::pwent, Win32
 
 =item Extension Modules
 
@@ -2274,8 +2570,6 @@ User::grent, User::pwent, Win32
 
 =item Guidelines for Module Creation
 
-Adding a Copyright Notice
-
 =item Guidelines for Converting Perl 4 Library Scripts into Modules
 
 =item Guidelines for Reusing Application Code
@@ -2286,28 +2580,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
 
@@ -2346,8 +2716,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
 
@@ -2393,8 +2763,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
 
@@ -2449,8 +2819,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.10 $, $Date: 2001/11/19
+17:09:37 $)
 
 =over 4
 
@@ -2490,12 +2860,13 @@ MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
 
 =item How can I generate simple menus without using CGI or Tk?
 
-=item What is undump?
-
 =item How can I make my Perl program run faster?
 
 =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?
@@ -2534,8 +2905,8 @@ mean?
 
 =back
 
-=head2 perlfaq4 - Data Manipulation ($Revision: 1.49 $, $Date: 1999/05/23
-20:37:49 $)
+=head2 perlfaq4 - Data Manipulation ($Revision: 1.9 $, $Date: 2001/12/07
+21:17:58 $)
 
 =over 4
 
@@ -2553,7 +2924,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?
 
@@ -2744,8 +3120,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
 
@@ -2837,7 +3213,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.5 $, $Date: 2001/12/02 01:55:12 $)
 
 =over 4
 
@@ -2903,8 +3279,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
 
@@ -2982,8 +3358,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
 
@@ -3110,7 +3486,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
@@ -3119,6 +3495,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)
 
@@ -3251,6 +3629,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
@@ -3507,6 +3887,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
@@ -3702,6 +4086,8 @@ A, p, d, s, n, r, f, M, o, j, x
 
 =back
 
+=item Custom Operators
+
 =item AUTHORS
 
 =item SEE ALSO
@@ -3899,38 +4285,41 @@ 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_number, grok_numeric_radix, GvSV,
-gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload, gv_stashpv,
-gv_stashsv, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID,
-HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force,
-HeSVKEY_set, HeVAL, HvNAME, hv_clear, hv_delete, hv_delete_ent, hv_exists,
-hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey,
-hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iterval, hv_magic, hv_store,
-hv_store_ent, hv_undef, isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE,
-isUPPER, is_utf8_char, is_utf8_string, items, ix, LEAVE, load_module,
-looks_like_number, MARK, mg_clear, mg_copy, mg_find, mg_free, mg_get,
-mg_length, mg_magical, mg_set, Move, New, newAV, Newc, newCONSTSUB, newHV,
-newRV_inc, newRV_noinc, NEWSV, newSV, newSViv, newSVnv, newSVpv, newSVpvf,
-newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv, newXS, newXSproto,
-Newz, 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, 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,
+get_sv, GIMME, GIMME_V, grok_bin, grok_hex, grok_number,
+grok_numeric_radix, grok_oct, GvSV, gv_fetchmeth, gv_fetchmethod,
+gv_fetchmethod_autoload, gv_stashpv, gv_stashsv, G_ARRAY, G_DISCARD,
+G_EVAL, G_NOARGS, G_SCALAR, G_VOID, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV,
+HeSVKEY, HeSVKEY_force, HeSVKEY_set, HeVAL, HvNAME, hv_clear, hv_delete,
+hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
+hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv,
+hv_iterval, hv_magic, hv_store, hv_store_ent, hv_undef, isALNUM, isALPHA,
+isDIGIT, isLOWER, isSPACE, isUPPER, is_utf8_char, is_utf8_string, items,
+ix, LEAVE, load_module, looks_like_number, MARK, mg_clear, mg_copy,
+mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set, Move, New, newAV,
+Newc, newCONSTSUB, newHV, newRV_inc, newRV_noinc, NEWSV, newSV, newSViv,
+newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv,
+newSVuv, newXS, newXSproto, Newz, new_vstring, Nullav, Nullch, Nullcv,
+Nullhv, Nullsv, ORIGMARK, perl_alloc, perl_clone, perl_construct,
+perl_destruct, perl_free, perl_parse, perl_run, PL_modglobal, PL_na,
+PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, POPl, POPn, POPp, POPpbytex, POPpx,
+POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew, Renewc,
+require_pv, RETVAL, Safefree, savepv, savepvn, SAVETMPS, scan_bin,
+scan_hex, scan_oct, sharedsv_find, sharedsv_init, sharedsv_lock,
+sharedsv_new, sharedsv_thrcnt_dec, sharedsv_thrcnt_inc, sharedsv_unlock,
+sortsv, SP, SPAGAIN, ST, strEQ, strGE, strGT, strLE, strLT, strNE, strnEQ,
+strnNE, StructCopy, SvCUR, SvCUR_set, SvEND, SvGETMAGIC, SvGROW, SvIOK,
+SvIOKp, SvIOK_notUV, SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV,
+SvIOK_UV, SvIV, SvIVX, SvIVx, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK,
 SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVx, SvNVX, SvOK, SvOOK,
 SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV,
 SvPVbyte, SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen,
 SvPVutf8, SvPVutf8x, SvPVutf8x_force, SvPVutf8_force, SvPVutf8_nolen,
-SvPVx, SvPVX, SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT,
+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,
+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,
+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,
@@ -3941,21 +4330,22 @@ 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_reftype, sv_replace, sv_report_used, sv_reset,
-sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv,
-sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn,
-sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv,
-sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg,
-sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref,
-sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg,
-sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade,
-sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn, THIS, toLOWER,
-toUPPER, 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_pvutf8n_force, sv_recode_to_utf8, sv_reftype, sv_replace,
+sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv,
+sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg,
+sv_setpvn, sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv,
+sv_setref_pv, sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_flags,
+sv_setsv_mg, sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true,
+sv_unmagic, sv_unref, sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn,
+sv_usepvn_mg, sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode,
+sv_utf8_upgrade, sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn,
+THIS, toLOWER, toUPPER, to_utf8_case, utf8n_to_uvchr, utf8n_to_uvuni,
+utf8_distance, utf8_hop, utf8_length, utf8_to_bytes, utf8_to_uvchr,
+utf8_to_uvuni, uvchr_to_utf8, uvuni_to_utf8, warn, XPUSHi, XPUSHn, XPUSHp,
+XPUSHs, XPUSHu, XS, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO,
+XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNO,
+XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK,
+Zero
 
 =item AUTHORS
 
@@ -3996,9 +4386,6 @@ sv_clean_all, sv_clean_objs, sv_free_arenas
 
 =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
@@ -4096,21 +4483,15 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item Support for I/O disciplines
 
-=item Eliminate need for "use utf8";
-
-=item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
-
-=item Autoload byte.pm
+=item Autoload bytes.pm
 
 =item Make "\u{XXXX}" et al work
 
-=item Overloadable regex assertions
-
-=item Unicode collation and normalization
+=item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
 
-=item Unicode case mappings 
+=item Overloadable regex assertions
 
-=item Unicode regular expression character classes
+=item Unicode
 
 =item use Thread for iThreads
 
@@ -4154,8 +4535,6 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item Custom opcodes
 
-=item spawnvp() on Win32
-
 =item DLL Versioning
 
 =item Introduce @( and @)
@@ -4240,7 +4619,7 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item Prototypes versus indirect objects
 
-=item Install HMTL
+=item Install HTML
 
 =item Prototype method calls
 
@@ -4274,6 +4653,8 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item Use fchown/fchmod internally
 
+=item Make v-strings overloaded objects
+
 =back
 
 =item Vague ideas
@@ -4282,7 +4663,7 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item ref() in list context
 
-=item Make tr/// return histogram
+=item Make tr/// return histogram of characters in list context
 
 =item Compile to real threaded code
 
@@ -4434,6 +4815,10 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item Make "use utf8" the default
 
+=item Unicode collation and normalization
+
+=item Create debugging macros
+
 =back
 
 =back
@@ -4448,9 +4833,9 @@ Does concept match the general goals of Perl?, Where is the
 implementation?, Backwards compatibility, Could it be a module instead?, Is
 the feature generic enough?, Does it potentially introduce new bugs?, Does
 it preclude other desirable features?, Is the implementation robust?, Is
-the implementation generic enough to be portable?, Is there enough
-documentation?, Is there another way to do it?, Does it create too much
-work?, Patches speak louder than words
+the implementation generic enough to be portable?, Is the implementation
+tested?, Is there enough documentation?, Is there another way to do it?,
+Does it create too much work?, Patches speak louder than words
 
 =over 4
 
@@ -4468,6 +4853,11 @@ It's easier to rsync the source tree, It's more recent, It's more reliable
 It's easier to rsync the patches, It's a good reference, Finding a start
 point, Finding how to fix a bug, Finding the source of misbehaviour
 
+=item 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
 
 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
@@ -4504,10 +4894,12 @@ finish, 'enter', print
 
 =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/>
+F<t/pod/>, F<t/run/>, t/base t/comp, t/cmd t/run t/io t/op, t/lib ext lib
 
 =back
 
@@ -4582,12 +4974,146 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =back
 
-=head2 perldelta - what will be new for perl v5.8.0
+=head2 perldelta - what is new for perl v5.8.0
 
 =over 4
 
 =item DESCRIPTION
 
+=item Highlights In 5.8.0
+
+=item Incompatible Changes
+
+=over 4
+
+=item 64-bit platforms and malloc
+
+=item AIX Dynaloading
+
+=item Attributes for C<my> variables now handled at run-time.
+
+=item Socket Extension Dynamic in VMS
+
+=item IEEE-format Floating Point Default on OpenVMS Alpha
+
+=item Different Definition of the Unicode Character Classes \p{In...}
+
+=item Perl Parser Stress Tested
+
+=item REF(...) Instead Of SCALAR(...)
+
+=item Deprecations
+
+=back
+
+=item Core Enhancements
+
+=over 4
+
+=item PerlIO is Now The Default
+
+=item Signals Are Now Safe
+
+=item Unicode Overhaul
+
+=item Understanding of Numbers
+
+=item Miscellaneous Enhancements
+
+=back
+
+=item Modules and Pragmata
+
+=over 4
+
+=item New Modules and Pragmata
+
+=item Updated And Improved Modules and Pragmata
+
+=back
+
+=item Utility Changes
+
+=item New Documentation
+
+=item Performance Enhancements
+
+=item Installation and Configuration Improvements
+
+=over 4
+
+=item Generic Improvements
+
+=item New Or Improved Platforms
+
+=back
+
+=item Selected Bug Fixes
+
+=over 4
+
+=item Platform Specific Changes and Fixes
+
+=back
+
+=item New or Changed Diagnostics
+
+=item Changed Internals
+
+=item Security Vulnerability Closed
+
+=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 Mac OS X
+
+=item OS/390
+
+=item op/sprintf tests 129 and 130
+
+=item  Failure of Thread tests
+
+=item UNICOS
+
+=item UTS
+
+=item VMS
+
+=item Localising a Tied Variable Leaks Memory
+
+=item Localising Tied Arrays and Hashes Is Broken
+
+=item Self-tying of Arrays and Hashes Is Forbidden
+
+=item Building Extensions Can Fail Because Of Largefiles
+
+=item Unicode Support on EBCDIC Still Spotty
+
+=item The Compiler Suite Is Still Experimental
+
+=item The Long Double Support Is Still Experimental
+
+=item Seen In Perl 5.7 But Gone Now
+
+=back
+
 =item Reporting Bugs
 
 =item SEE ALSO
@@ -4684,7 +5210,7 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
 
-=item HP-UX lib/io_multihomed Fails When LP64-Configur
+=item HP-UX lib/io_multihomed Fails When LP64-Configured
 
 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
 
@@ -4936,16 +5462,45 @@ d_strtoq, d_u32align, d_ualarm, d_usleep
 
 =back
 
-=head2 perl56delta, perldelta - what's new for perl v5.6.0
+=head2 perl561delta, perldelta - what's new for perl v5.6.x
 
 =over 4
 
 =item DESCRIPTION
 
-=item Core Enhancements
+=item Summary of changes between 5.6.0 and 5.6.1
 
 =over 4
 
+=item Security Issues
+
+=item Core bug fixes
+
+C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
+Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
+references to special variables, Lexical warnings, Spurious warnings and
+errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
+map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
+Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
+Module;>, Tests
+
+=item Core features
+
+=item Configuration issues
+
+=item Documentation
+
+=item Bundled modules
+
+B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
+Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
+IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
+Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
+
+=item Platform-specific improvements
+
+NCR MP-RAS, NonStop-UX
+
 =item Interpreter cloning, threads, and concurrency
 
 =item Lexically scoped warning categories
@@ -5140,6 +5695,8 @@ perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
 
 =item Enhanced Installation Directories
 
+=item gcc automatically tried if 'cc' does not seem to be working
+
 =back
 
 =item Platform specific changes
@@ -5283,16 +5840,14 @@ C<PATCHLEVEL> is now C<PERL_VERSION>
 
 =over 4
 
-=item Thread test failures
-
-=item EBCDIC platforms not supported
+=item Localizing a tied hash element may leak memory
 
-=item In 64-bit HP-UX the lib/io_multihomed test may hang
+=item Known test failures
 
-=item NEXTSTEP 3.3 POSIX test failure
+64-bit builds, Failure of Thread tests, NEXTSTEP 3.3 POSIX test failure,
+Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with gcc
 
-=item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
-gcc
+=item EBCDIC platforms not fully supported
 
 =item UNICOS/mk CC failures during Configure run
 
@@ -5321,107 +5876,492 @@ to mean "${$}<digit>" is deprecated
 
 =back
 
-=head2 perl5005delta, perldelta - what's new for perl5.005
+=head2 perl56delta, perldelta - what's new for perl v5.6.0
 
 =over 4
 
 =item DESCRIPTION
 
-=item About the new versioning system
-
-=item Incompatible Changes
+=item Core Enhancements
 
 =over 4
 
-=item WARNING:	This version is not binary compatible with Perl 5.004.
+=item Interpreter cloning, threads, and concurrency
 
-=item Default installation structure has changed
+=item Lexically scoped warning categories
 
-=item Perl Source Compatibility
+=item Unicode and UTF-8 support
 
-=item C Source Compatibility
+=item Support for interpolating named characters
 
-=item Binary Compatibility
+=item "our" declarations
 
-=item Security fixes may affect compatibility
+=item Support for strings represented as a vector of ordinals
 
-=item Relaxed new mandatory warnings introduced in 5.004
+=item Improved Perl version numbering system
 
-=item Licensing
+=item New syntax for declaring subroutine attributes
 
-=back
+=item File and directory handles can be autovivified
 
-=item Core Changes
+=item open() with more than two arguments
 
-=over 4
+=item 64-bit support
 
-=item Threads
+=item Large file support
 
-=item Compiler
+=item Long doubles
 
-=item Regular Expressions
+=item "more bits"
 
-Many new and improved optimizations, Many bug fixes, New regular expression
-constructs, New operator for precompiled regular expressions, Other
-improvements, Incompatible changes
+=item Enhanced support for sort() subroutines
 
-=item	Improved malloc()
+=item C<sort $coderef @foo> allowed
 
-=item Quicksort is internally implemented
+=item File globbing implemented internally
 
-=item Reliable signals
+=item Support for CHECK blocks
 
-=item Reliable stack pointers
+=item POSIX character class syntax [: :] supported
 
-=item More generous treatment of carriage returns
+=item Better pseudo-random number generator
 
-=item Memory leaks
+=item Improved C<qw//> operator
 
-=item Better support for multiple interpreters
+=item Better worst-case behavior of hashes
 
-=item Behavior of local() on array and hash elements is now well-defined
+=item pack() format 'Z' supported
 
-=item C<%!> is transparently tied to the L<Errno> module
+=item pack() format modifier '!' supported
 
-=item Pseudo-hashes are supported
+=item pack() and unpack() support counted strings
 
-=item C<EXPR foreach EXPR> is supported
+=item Comments in pack() templates
 
-=item Keywords can be globally overridden
+=item Weak references
 
-=item C<$^E> is meaningful on Win32
+=item Binary numbers supported
 
-=item C<foreach (1..1000000)> optimized
+=item Lvalue subroutines
 
-=item C<Foo::> can be used as implicitly quoted package name
+=item Some arrows may be omitted in calls through references
 
-=item C<exists $Foo::{Bar::}> tests existence of a package
+=item Boolean assignment operators are legal lvalues
 
-=item Better locale support
+=item exists() is supported on subroutine names
 
-=item Experimental support for 64-bit platforms
+=item exists() and delete() are supported on array elements
 
-=item prototype() returns useful results on builtins
+=item Pseudo-hashes work better
 
-=item Extended support for exception handling
+=item Automatic flushing of output buffers
 
-=item Re-blessing in DESTROY() supported for chaining DESTROY() methods
+=item Better diagnostics on meaningless filehandle operations
 
-=item All C<printf> format conversions are handled internally
+=item Where possible, buffered data discarded from duped input filehandle
 
-=item New C<INIT> keyword
+=item eof() has the same old magic as <>
 
-=item New C<lock> keyword
+=item binmode() can be used to set :crlf and :raw modes
 
-=item New C<qr//> operator
+=item C<-T> filetest recognizes UTF-8 encoded files as "text"
 
-=item C<our> is now a reserved word
+=item system(), backticks and pipe open now reflect exec() failure
 
-=item Tied arrays are now fully supported
+=item Improved diagnostics
 
-=item Tied handles support is better
+=item Diagnostics follow STDERR
 
-=item 4th argument to substr
+=item More consistent close-on-exec behavior
+
+=item syswrite() ease-of-use
+
+=item Better syntax checks on parenthesized unary operators
+
+=item Bit operators support full native integer width
+
+=item Improved security features
+
+=item More functional bareword prototype (*)
+
+=item C<require> and C<do> may be overridden
+
+=item $^X variables may now have names longer than one character
+
+=item New variable $^C reflects C<-c> switch
+
+=item New variable $^V contains Perl version as a string
+
+=item Optional Y2K warnings
+
+=item Arrays now always interpolate into double-quoted strings
+
+=back
+
+=item Modules and Pragmata
+
+=over 4
+
+=item Modules
+
+attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
+DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
+Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
+File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
+Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
+podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
+pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
+Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
+
+=item Pragmata
+
+=back
+
+=item Utility Changes
+
+=over 4
+
+=item dprofpp
+
+=item find2perl
+
+=item h2xs
+
+=item perlcc
+
+=item perldoc
+
+=item The Perl Debugger
+
+=back
+
+=item Improved Documentation
+
+perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
+perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
+perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
+perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
+
+=item Performance enhancements
+
+=over 4
+
+=item Simple sort() using { $a <=> $b } and the like are optimized
+
+=item Optimized assignments to lexical variables
+
+=item Faster subroutine calls
+
+=item delete(), each(), values() and hash iteration are faster
+
+=back
+
+=item Installation and Configuration Improvements
+
+=over 4
+
+=item -Dusethreads means something different
+
+=item New Configure flags
+
+=item Threadedness and 64-bitness now more daring
+
+=item Long Doubles
+
+=item -Dusemorebits
+
+=item -Duselargefiles
+
+=item installusrbinperl
+
+=item SOCKS support
+
+=item C<-A> flag
+
+=item Enhanced Installation Directories
+
+=back
+
+=item Platform specific changes
+
+=over 4
+
+=item Supported platforms
+
+=item DOS
+
+=item OS390 (OpenEdition MVS)
+
+=item VMS
+
+=item Win32
+
+=back
+
+=item Significant bug fixes
+
+=over 4
+
+=item <HANDLE> on empty files
+
+=item C<eval '...'> improvements
+
+=item All compilation errors are true errors
+
+=item Implicitly closed filehandles are safer
+
+=item Behavior of list slices is more consistent
+
+=item C<(\$)> prototype and C<$foo{a}>
+
+=item C<goto &sub> and AUTOLOAD
+
+=item C<-bareword> allowed under C<use integer>
+
+=item Failures in DESTROY()
+
+=item Locale bugs fixed
+
+=item Memory leaks
+
+=item Spurious subroutine stubs after failed subroutine calls
+
+=item Taint failures under C<-U>
+
+=item END blocks and the C<-c> switch
+
+=item Potential to leak DATA filehandles
+
+=back
+
+=item New or Changed Diagnostics
+
+"%s" variable %s masks earlier declaration in same %s, "my sub" not yet
+implemented, "our" variable %s redeclared, '!' allowed only after types %s,
+/ cannot take a count, / must be followed by a, A or Z, / must be followed
+by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
+\\%c passed through, /%s/: Unrecognized escape \\%c in character class
+passed through, /%s/ should probably be written as "%s", %s() called too
+early to check prototype, %s argument is not a HASH or ARRAY element, %s
+argument is not a HASH or ARRAY element or slice, %s argument is not a
+subroutine name, %s package attribute may clash with future reserved word:
+%s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
+substitution pattern, Bad realloc() ignored, Bareword found in conditional,
+Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
+size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
+filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
+Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
+Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
+remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
+weaken a nonreference, Character class [:%s:] unknown, Character class
+syntax [%s] belongs inside character classes, Constant is not %s reference,
+constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
+defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
+"local" instead of "our"?), Document contains no data, entering effective
+%s failed, false [] range "%s" in regexp, Filehandle %s opened only for
+output, flock() on closed filehandle %s, Global symbol "%s" requires
+explicit package name, Hexadecimal number > 0xffffffff non-portable,
+Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
+|%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
+number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
+%s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
+separator character %s in attribute list, Invalid separator character %s in
+subroutine attribute list, leaving effective %s failed, Lvalue subs
+returning %s not implemented yet, Method %s not permitted, Missing
+%sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
+No %s specified for -%c, No package name allowed for variable %s in "our",
+No space allowed after -%c, no UTC offset information; assuming local time
+is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
+panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
+around "%s" list, Possible unintended interpolation of %s in string,
+Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
+instead, Premature end of script headers, Repeat count in pack overflows,
+Repeat count in unpack overflows, realloc() of freed memory ignored,
+Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
+zero-length expression, switching effective %s is not implemented, This
+Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
+environ elements (%s=%s), Too late to run %s block, Unknown open() mode
+'%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
+escape \\%c passed through, Unterminated attribute parameter in attribute
+list, Unterminated attribute list, Unterminated attribute parameter in
+subroutine attribute list, Unterminated subroutine attribute list, Value of
+CLI symbol "%s" too long, Version number must be a constant number
+
+=item New tests
+
+=item Incompatible Changes
+
+=over 4
+
+=item Perl Source Incompatibilities
+
+CHECK is a new keyword, Treatment of list slices of undef has changed,
+Format of $English::PERL_VERSION is different, Literals of the form
+C<1.2.3> parse differently, Possibly changed pseudo-random number
+generator, Hashing function for hash keys has changed, C<undef> fails on
+read only values, Close-on-exec bit may be set on pipe and socket handles,
+Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
+values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
+Text of some diagnostic output has changed, C<%@> has been removed,
+Parenthesized not() behaves like a list operator, Semantics of bareword
+prototype C<(*)> have changed, Semantics of bit operators may have changed
+on 64-bit platforms, More builtins taint their results
+
+=item C Source Incompatibilities
+
+C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
+
+=item Compatible C Source API Changes
+
+C<PATCHLEVEL> is now C<PERL_VERSION>
+
+=item Binary Incompatibilities
+
+=back
+
+=item Known Problems
+
+=over 4
+
+=item Thread test failures
+
+=item EBCDIC platforms not supported
+
+=item In 64-bit HP-UX the lib/io_multihomed test may hang
+
+=item NEXTSTEP 3.3 POSIX test failure
+
+=item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
+gcc
+
+=item UNICOS/mk CC failures during Configure run
+
+=item Arrow operator and arrays
+
+=item Experimental features
+
+Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
+pseudo-hash data type, The Compiler suite, Internal implementation of file
+globbing, The DB module, The regular expression code constructs:
+
+=back
+
+=item Obsolete Diagnostics
+
+Character class syntax [: :] is reserved for future extensions, Ill-formed
+logical name |%s| in prime_env_iter, In string, @%s now must be written as
+\@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
+to mean "${$}<digit>" is deprecated
+
+=item Reporting Bugs
+
+=item SEE ALSO
+
+=item HISTORY
+
+=back
+
+=head2 perl5005delta, perldelta - what's new for perl5.005
+
+=over 4
+
+=item DESCRIPTION
+
+=item About the new versioning system
+
+=item Incompatible Changes
+
+=over 4
+
+=item WARNING:	This version is not binary compatible with Perl 5.004.
+
+=item Default installation structure has changed
+
+=item Perl Source Compatibility
+
+=item C Source Compatibility
+
+=item Binary Compatibility
+
+=item Security fixes may affect compatibility
+
+=item Relaxed new mandatory warnings introduced in 5.004
+
+=item Licensing
+
+=back
+
+=item Core Changes
+
+=over 4
+
+=item Threads
+
+=item Compiler
+
+=item Regular Expressions
+
+Many new and improved optimizations, Many bug fixes, New regular expression
+constructs, New operator for precompiled regular expressions, Other
+improvements, Incompatible changes
+
+=item	Improved malloc()
+
+=item Quicksort is internally implemented
+
+=item Reliable signals
+
+=item Reliable stack pointers
+
+=item More generous treatment of carriage returns
+
+=item Memory leaks
+
+=item Better support for multiple interpreters
+
+=item Behavior of local() on array and hash elements is now well-defined
+
+=item C<%!> is transparently tied to the L<Errno> module
+
+=item Pseudo-hashes are supported
+
+=item C<EXPR foreach EXPR> is supported
+
+=item Keywords can be globally overridden
+
+=item C<$^E> is meaningful on Win32
+
+=item C<foreach (1..1000000)> optimized
+
+=item C<Foo::> can be used as implicitly quoted package name
+
+=item C<exists $Foo::{Bar::}> tests existence of a package
+
+=item Better locale support
+
+=item Experimental support for 64-bit platforms
+
+=item prototype() returns useful results on builtins
+
+=item Extended support for exception handling
+
+=item Re-blessing in DESTROY() supported for chaining DESTROY() methods
+
+=item All C<printf> format conversions are handled internally
+
+=item New C<INIT> keyword
+
+=item New C<lock> keyword
+
+=item New C<qr//> operator
+
+=item C<our> is now a reserved word
+
+=item Tied arrays are now fully supported
+
+=item Tied handles support is better
+
+=item 4th argument to substr
 
 =item Negative LENGTH argument to splice
 
@@ -5917,7 +6857,7 @@ C<-lcygipc> (C<use IPC::SysV>)
 
 =item Configure-time Options for Perl on Cygwin
 
-C<-Uusedl>, C<-Uusemymalloc>, C<-Dusemultiplicity>, C<-Duseperlio>,
+C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>
 
 =item Suspicious Warnings on Cygwin
@@ -6003,6 +6943,50 @@ Source, Compiled Module Source, Perl Modules/Scripts
 
 =back
 
+=head2 perldos - Perl under DOS, W31, W95.
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Prerequisites for Compiling Perl on DOS
+
+DJGPP, Pthreads
+
+=item Shortcomings of Perl under DOS
+
+=item Building Perl on DOS
+
+=item Testing Perl on DOS
+
+=item Installation of Perl on DOS
+
+=back
+
+=item BUILDING AND INSTALLING MODULES ON DOS
+
+=over 4
+
+=item Building Prerequisites for Perl on DOS
+
+=item Unpacking CPAN Modules on DOS
+
+=item Building Non-XS Modules on DOS
+
+=item Building XS Modules on DOS
+
+=back
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
 =head2 perlepoc, README.epoc - Perl for EPOC
 
 =over 4
@@ -6052,6 +7036,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
@@ -6062,6 +7048,8 @@ 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
@@ -6086,6 +7074,8 @@ Source, Compiled Module Source, Perl Modules/Scripts
 
 =back
 
+=item nss_delete core dump from op/pwent or op/grent
+
 =item AUTHOR
 
 =item DATE
@@ -6167,7 +7157,9 @@ op/lexassign.t, pragma/warnings.t
 
 =item NOTE
 
-=item What's New in Perl ffor MPE/iX
+=item Binary distribution from HP
+
+=item What's New in Perl for MPE/iX
 
 =item Welcome to Perl/iX
 
@@ -6489,7 +7481,8 @@ C<COND_WAIT>, F<os2.c>
 
 =back
 
-=head2 perlos390, README.os390 - building and installing Perl for OS/390.
+=head2 perlos390, README.os390 - building and installing Perl for OS/390
+and z/OS
 
 =over 4
 
@@ -6499,6 +7492,8 @@ C<COND_WAIT>, F<os2.c>
 
 =over 4
 
+=item Tools
+
 =item Unpacking Perl distribution on OS/390
 
 =item Setup and utilities for Perl on OS/390
@@ -6649,6 +7644,8 @@ DATAMODEL_NATIVE specified", sh: ar: not found
 
 =item op/stat.t test 4 in Solaris
 
+=item nss_delete core dump from op/pwent or op/grent
+
 =back
 
 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
@@ -6825,57 +7822,146 @@ LIST, waitpid PID,FLAGS
 
 =item SDBM_File
 
-=back
+=back
+
+=item Revision date
+
+=item AUTHOR
+
+=back
+
+=head2 perlvos, README.vos - Perl for Stratus VOS
+
+=over 4
+
+=item SYNOPSIS
+
+=over 4
+
+=item Stratus POSIX Support
+
+=back
+
+=item INSTALLING PERL IN VOS
+
+=over 4
+
+=item Compiling Perl 5 on VOS
+
+=item Installing Perl 5 on VOS
+
+=back
+
+=item USING PERL IN VOS
+
+=over 4
+
+=item Unimplemented Features of Perl on VOS
+
+=item Restrictions of Perl on VOS
+
+=back
+
+=item SUPPORT STATUS
+
+=item AUTHOR
+
+=item LAST UPDATE
+
+=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 Revision date
+=item SEE ALSO
 
-=item AUTHOR
+=item HISTORY
 
 =back
 
-=head2 perlvos, README.vos - Perl for Stratus VOS
+=head1 PRAGMA DOCUMENTATION
+
+=head2 attrs - set/get attributes of a subroutine (deprecated)
 
 =over 4
 
 =item SYNOPSIS
 
-=over 4
+=item DESCRIPTION
 
-=item Stratus POSIX Support
+method, locked
 
 =back
 
-=item INSTALLING PERL IN VOS
+=head2 re - Perl pragma to alter regular expression behaviour
 
 =over 4
 
-=item Compiling Perl 5 on VOS
+=item SYNOPSIS
 
-=item Installing Perl 5 on VOS
+=item DESCRIPTION
 
 =back
 
-=item USING PERL IN VOS
+=head2 threadshared::shared, threads::shared - Perl extension for sharing
+data structures between threads
 
 =over 4
 
-=item Unimplemented Features of Perl on VOS
+=item SYNOPSIS
 
-=item Restrictions of Perl on VOS
+=item DESCRIPTION
 
-=back
+=item EXPORT
 
-=item SUPPORT STATUS
+=item FUNCTIONS
+
+share VARIABLE, lock VARIABLE, unlock VARIABLE, cond_wait VARIABLE,
+cond_signal VARIABLE, cond_broadcast VARIABLE
+
+=item BUGS
 
 =item AUTHOR
 
-=item LAST UPDATE
+=item SEE ALSO
 
 =back
 
-=head1 PRAGMA DOCUMENTATION
-
-=head2 attrs - set/get attributes of a subroutine (deprecated)
+=head2 threads - Perl extension allowing use of interpreter based threads
+from perl
 
 =over 4
 
@@ -6883,17 +7969,22 @@ LIST, waitpid PID,FLAGS
 
 =item DESCRIPTION
 
-method, locked
+$thread = new(function, LIST), $thread->join, $thread->detach,
+threads->self, $thread->tid
 
-=back
+=item TODO
 
-=head2 re - Perl pragma to alter regular expression behaviour
+Fix so the return value is returned when you join, Add join_all, Fix memory
+leaks!
 
-=over 4
+=item AUTHOR and COPYRIGHT
 
-=item SYNOPSIS
+=item BUGS
 
-=item DESCRIPTION
+creating a thread from within a thread is unsafe under win32,
+PERL_OLD_SIGNALS are not threadsafe, will not be
+
+=item SEE ALSO
 
 =back
 
@@ -7011,7 +8102,7 @@ semantics
 =back
 
 =head2 charnames - define character names for C<\N{named}> string literal
-escape.
+escapes.
 
 =over 4
 
@@ -7021,6 +8112,10 @@ escape.
 
 =item CUSTOM TRANSLATORS
 
+=item charnames::viacode(code)
+
+=item charnames::vianame(code)
+
 =item BUGS
 
 =back
@@ -7035,7 +8130,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
 
@@ -7072,6 +8177,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
@@ -7325,6 +8445,16 @@ B<untrapped>, B<any>, I<signal>, I<number>
 
 =back
 
+=head2 sort - perl pragma to control sort() behaviour
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
 =head2 strict - Perl pragma to restrict unsafe constructs
 
 =over 4
@@ -7379,6 +8509,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
@@ -7397,68 +8539,33 @@ warnings::warnif($object, $message)
 
 =head2 warnings::register - warnings import function
 
-=head1 MODULE DOCUMENTATION
-
-=head2 AnyDBM_File - provide framework for multiple DBMs
-
 =over 4
 
 =item SYNOPSIS
 
 =item DESCRIPTION
 
-=over 4
-
-=item DBM Comparisons
-
-[0], [1], [2], [3]
-
 =back
 
-=item SEE ALSO
-
-=back
+=head1 MODULE DOCUMENTATION
 
-=head2 Attribute::Handlers - Simpler definition of attribute handlers
+=head2 AnyDBM_File - provide framework for multiple DBMs
 
 =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 DBM Comparisons
 
-=item Attributes as C<tie> interfaces
+[0], [1], [2], [3]
 
 =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
+=item SEE ALSO
 
 =back
 
@@ -7993,8 +9100,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
 
@@ -8213,7 +9320,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
 
@@ -8243,8 +9351,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()>
 
@@ -8386,6 +9495,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
@@ -8747,11 +9860,11 @@ 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_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_difftime>, C<d_dirfd>, 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>,
@@ -8766,24 +9879,24 @@ 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_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_atfork>,
+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_procselfexe>, 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>,
@@ -8845,7 +9958,7 @@ 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_fp>,
-C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_iconv>, C<i_ieeefp>, C<i_inttypes>,
+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>,
@@ -8913,7 +10026,7 @@ C<perl>, C<perl_patchlevel>
 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
-C<privlibexp>, C<prototype>, C<ptrsize>
+C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
 
 =item q
 
@@ -8991,8 +10104,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,
@@ -9044,7 +10173,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
 
@@ -9203,7 +10332,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
 
@@ -9243,6 +10375,28 @@ Dumper
 
 =back
 
+=head2 Devel::PPPort, Perl/Pollution/Portability
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item WriteFile
+
+=back
+
+=item ppport.h
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
 =head2 Devel::Peek - A data debugging tool for the XS programmer
 
 =over 4
@@ -9253,6 +10407,8 @@ Dumper
 
 =over 4
 
+=item Runtime debugging
+
 =item Memory footprint debugging
 
 =back
@@ -9375,8 +10531,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
@@ -9450,8 +10606,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
 
@@ -9608,6 +10764,8 @@ arrays
 
 =item Tag Handling Utility Functions
 
+=item C<AUTOLOAD>ed Constants
+
 =back
 
 =back
@@ -9637,7 +10795,7 @@ cat
 
 eqtime src dst
 
-rm_f files...
+rm_rf files...
 
 rm_f files...
 
@@ -9673,7 +10831,7 @@ test_f file
 
 =item USAGE
 
-IV, UV, NV, PV, PVN, PVN, YES, NO, UNDEF
+IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
 
 =item FUNCTIONS
 
@@ -9695,6 +10853,8 @@ params WHAT
 
 dump_names
 
+dogfood
+
 C_constant, name, type, value, macro, default, pre, post, def_pre =item
 def_post
 
@@ -9702,6 +10862,8 @@ 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
 
@@ -10034,6 +11196,8 @@ prefixify
 
 processPL (o)
 
+quote_paren
+
 realclean (o)
 
 replace_manpage_separator
@@ -10276,7 +11440,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,
@@ -10289,8 +11453,9 @@ MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME,
 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, SKIP, TEST_LIBS, VERSION,
-VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION
+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
 
@@ -10313,7 +11478,7 @@ shdist,    make zipdist,    make ci
 
 =item ENVIRONMENT
 
-PERL_MM_OPT
+PERL_MM_OPT, PERL_MM_USE_DEFAULT
 
 =item SEE ALSO
 
@@ -10517,6 +11682,8 @@ rmscopy($from,$to[,$date_flag])
 
 =item DESCRIPTION
 
+=item NOTES
+
 =item EXPORTS (by request only)
 
 =item BUGS
@@ -10541,8 +11708,12 @@ C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
 C<untaint>, C<untaint_pattern>, C<untaint_skip>
 
+=item WARNINGS
+
 =item CAVEAT
 
+$dont_use_nlink, symlinks
+
 =item NOTES
 
 =item HISTORY
@@ -10591,6 +11762,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
@@ -10613,7 +11790,7 @@ tmpdir
 
 path
 
-canonpath
+canonpath()
 
 splitpath
 
@@ -10623,7 +11800,7 @@ catpath
 
 abs2rel
 
-rel2abs
+rel2abs()
 
 =over 4
 
@@ -10649,7 +11826,7 @@ rel2abs
 
 =back
 
-=head2 File::Spec::Mac - File::Spec for MacOS
+=head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
 
 =over 4
 
@@ -10663,7 +11840,7 @@ canonpath
 
 =back
 
-catdir
+catdir()
 
 catfile
 
@@ -10693,6 +11870,8 @@ rel2abs
 
 =over 4
 
+=item AUTHORS
+
 =item SEE ALSO
 
 =back
@@ -10707,7 +11886,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
 
@@ -10717,11 +11897,11 @@ rel2abs
 
 =item METHODS
 
-canonpath
+canonpath()
 
 =back
 
-catdir
+catdir()
 
 catfile
 
@@ -10749,11 +11929,11 @@ splitpath
 
 splitdir
 
-catpath
+catpath()
 
 abs2rel
 
-rel2abs
+rel2abs()
 
 =over 4
 
@@ -10997,6 +12177,23 @@ $fh->print, $fh->printf, $fh->getline, $fh->getlines
 
 =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 with an explicit C<import> subroutine
+
+=item Using Filter::Simple and Exporter together
+
 =item How it works
 
 =back
@@ -11059,6 +12256,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
@@ -11135,7 +12334,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
 
@@ -11170,6 +12369,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
@@ -12043,7 +13246,7 @@ set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
 =item DESCRIPTION
 
 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
-BLOCK LIST, sum LIST
+BLOCK LIST, shuffle LIST, sum LIST
 
 =item SUGGESTED ADDITIONS
 
@@ -12061,7 +13264,7 @@ general-utility list subroutines
 =item DESCRIPTION
 
 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
-BLOCK LIST, sum LIST
+BLOCK LIST, shuffle LIST, sum LIST
 
 =item SUGGESTED ADDITIONS
 
@@ -12489,7 +13692,7 @@ Remarks
 
 =item EXAMPLES
 
-  use Math::BigInt qw(bstr);
+  use Math::BigInt;
 
 =item Autocreating constants
 
@@ -12507,8 +13710,9 @@ Out of Memory!, Fails to load Calc on Perl prior 5.6.0
 
 =item CAVEATS
 
-stringify, bstr(), bsstr() and 'cmp', int(), bdiv, Modifying and =, bpow,
-Overloading -$x, Mixing different object types, bsqrt()
+stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
+handling, Modifying and =, bpow, Overloading -$x, Mixing different object
+types, bsqrt()
 
 =item LICENSE
 
@@ -12799,6 +14003,14 @@ C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
 
 =item DESCRIPTION
 
+=over 4
+
+=item Enforcing redispatch
+
+=item Avoiding repetitions
+
+=back
+
 =item AUTHOR
 
 =item BUGS AND IRRITATIONS
@@ -12849,8 +14061,8 @@ 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_ext_passive, ftp_int_pasive,
-local_netmask, test_hosts, test_exists
+time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
+ftp_int_pasive, local_netmask, test_hosts, test_exists
 
 =back
 
@@ -12890,16 +14102,16 @@ new (HOST [,OPTIONS])
 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 (), 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 ()
+), 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
 
@@ -12912,7 +14124,7 @@ quot (CMD [,ARGS])
 =item THE dataconn CLASS
 
 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
-abort (), close ()
+bytes_read (), abort (), close ()
 
 =item UNIMPLEMENTED
 
@@ -12924,6 +14136,10 @@ B<ALLO>, B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
 
 =item SEE ALSO
 
+=item USE EXAMPLES
+
+http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
+
 =item CREDITS
 
 =item COPYRIGHT
@@ -13016,19 +14232,24 @@ MSGNUM ), reset (), quit ()
 
 =item DESCRIPTION
 
-icmp, udp, tcp, stream, external
-
 =over 4
 
 =item Functions
 
 Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [,
-$timeout]);, $p->open($host);, $p->close();, pingecho($host [, $timeout]);
+$timeout]);, $p->open($host);, $p->open($host);, $p->close();,
+pingecho($host [, $timeout]);
 
 =back
 
+=item WARNING
+
 =item NOTES
 
+=item AUTHOR(S)
+
+=item COPYRIGHT
+
 =back
 
 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
@@ -13047,11 +14268,13 @@ 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 [...]] ), data ( [ DATA ] ), expand ( ADDRESS ),
-verify ( ADDRESS ), help ( [ $subject ] ), quit ()
+banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
+PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
+ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
+ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
+ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
+DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
+quit ()
 
 =item SEE ALSO
 
@@ -13137,7 +14360,7 @@ functions
 
 =over 4
 
-=item How do I download files from a FTP server ?
+=item How do I download files from an FTP server ?
 
 =item How do I transfer files in binary mode ?
 
@@ -13150,13 +14373,13 @@ functions
 
 =item Can I do a reget operation like the ftp command ?
 
-=item How do I get a directory listing from a FTP server ?
+=item How do I get a directory listing from an FTP server ?
 
-=item Changeing directory to "" does not fail ?
+=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 a FTP proxy firewall, but cannot access machines outside
+=item I am behind an FTP proxy firewall, but cannot access machines outside
 ?
 
 =item My ftp proxy firewall does not listen on port 21
@@ -13574,7 +14797,7 @@ unix, stdio, perlio, crlf, utf8, raw
 
 =item DESCRIPTION
 
-$class->PUSHED([$mode][,$fh]), $obj->POPPED([$fh]),
+$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),
@@ -13582,6 +14805,12 @@ $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)
 
+=over 4
+
+=item Example - a Hexadecimal Handle
+
+=back
+
 =back
 
 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
@@ -14065,12 +15294,16 @@ B<_output>
 
 B<_replace_special_chars>
 
+B<_replace_special_chars_late>
+
 B<_create_label>
 
 B<_create_index>
 
 B<_clean_latex_commands>
 
+B<_split_delimited>
+
 =over 4
 
 =item NOTES
@@ -14093,17 +15326,20 @@ B<_clean_latex_commands>
 
 =item DESCRIPTION
 
-center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, quotes,
+center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
 release, section
 
 =item DIAGNOSTICS
 
 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
+escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
+=back
 
 =item BUGS
 
+=item CAVEATS
+
 =item SEE ALSO
 
 =item AUTHOR
@@ -14112,6 +15348,20 @@ escape EE<lt>%sE<gt>, %s:%d: Unknown sequence %s, %s:%d: Unmatched =back
 
 =back
 
+=head2 Pod::ParseLink -- Parse an LE<lt>E<gt> formatting code in POD text
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item AUTHOR
+
+=item COPYRIGHT AND LICENSE
+
+=back
+
 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
 
 =over 4
@@ -14590,13 +15840,14 @@ B<-output>, B<-sections>, B<-ranges>
 
 =item DESCRIPTION
 
-alt, indent, loose, quotes, sentence, width
+alt, code, 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
+Bizarre space in item, Item called without tag, Can't open %s for reading:
+%s, Invalid quote specification "%s", %s:%d: Unknown command paragraph
+"%s", %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
+Unmatched =back
 
 =item RESTRICTIONS
 
@@ -14656,6 +15907,8 @@ text with format escapes
 
 =item DESCRIPTION
 
+=item NOTES
+
 =item SEE ALSO
 
 =item AUTHOR
@@ -14669,28 +15922,66 @@ documentation
 
 =over 4
 
-=item SYNOPSIS
+=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
+
+=back
+
+=item CAVEATS
+
+=item AUTHOR
+
+=item ACKNOWLEDGEMENTS
+
+=back
+
+=head2 Pod::t::basic, basic.pod - Test of various basic POD features in
+translators.
+
+=over 4
+
+=item HEADINGS
 
-=item ARGUMENTS
+=item This C<is> a "level 1" heading
 
-C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
-C<-pathlist>
+=over 4
 
-=item DESCRIPTION
+=item ``Level'' "2 I<heading>
 
-=item EXAMPLES
+=back
+
+=item This C<is> a "level 1" heading
 
 =over 4
 
-=item Recommended Use
+=item ``Level'' 2 I<heading>
 
 =back
 
-=item CAVEATS
+=item LINKS
 
-=item AUTHOR
+=item OVER AND ITEMS
 
-=item ACKNOWLEDGEMENTS
+This  is a test, a, b, a, b, c, d, "foo", B<bar>, C<baz>, Some longer item
+text
+
+=item FORMATTING CODES
+
+E<amp>, E<apos>, E<lt>, E<gt>, E<quot>, E<sol>
+
+=item VERBATIM
 
 =back
 
@@ -14933,6 +16224,8 @@ C<Storable::is_retrieving>
 
 =item BUGS
 
+=item LIMITATION
+
 =item COPYRIGHT
 
 =back
@@ -15039,8 +16332,34 @@ ANSI_COLORS_DISABLED
 
 =item DESCRIPTION
 
+=over 4
+
+=item METHODS
+
+=back
+
+=back
+
+B<Tgetent>, OSPEED, TERM
+
+B<Tpad>, B<$string>, B<$cnt>, B<$FH>
+
+B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
+
+B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
+
+B<Trequire>
+
+=over 4
+
 =item EXAMPLES
 
+=item COPYRIGHT AND LICENSE
+
+=item AUTHOR
+
+=item SEE ALSO
+
 =back
 
 =head2 Term::Complete - Perl word completion module
@@ -15127,6 +16446,112 @@ NORMAL TESTS, SKIPPED TESTS, TODO TESTS
 
 =back
 
+=head2 Test::Builder - Backend for building test libraries
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Construction
+
+B<new>
+
+=back
+
+=back
+
+=over 4
+
+=item Setting up tests
+
+B<exported_to>
+
+=back
+
+B<plan>
+
+B<expected_tests>
+
+B<no_plan>
+
+B<skip_all>
+
+=over 4
+
+=item Running tests
+
+B<ok>
+
+=back
+
+B<is_eq>, B<is_num>
+
+B<like>
+
+B<skip>
+
+B<skip_rest>
+
+=over 4
+
+=item Test style
+
+B<level>
+
+=back
+
+B<use_numbers>
+
+B<no_header>, B<no_ending>
+
+=over 4
+
+=item Output
+
+B<diag>
+
+=back
+
+B<_print>
+
+B<output>, B<failure_output>, B<todo_output>
+
+=over 4
+
+=item Test Status and Info
+
+B<current_test>
+
+=back
+
+B<summary>
+
+B<details>  I<UNIMPLEMENTED>, B<todo>
+
+B<caller>
+
+B<_sanity_check>
+
+B<_whoa>
+
+B<_my_exit>
+
+=over 4
+
+=item EXAMPLES
+
+=item SEE ALSO
+
+=item AUTHORS
+
+=item COPYRIGHT
+
+=back
+
 =head2 Test::Harness - run perl standard test scripts with statistics
 
 =over 4
@@ -15156,6 +16581,8 @@ B<runtests>
 
 =back
 
+B<_all_ok>
+
 B<_globdir>
 
 B<_run_all_tests>
@@ -15203,6 +16630,12 @@ C<HARNESS_ACTIVE>
 
 =item I love it when a plan comes together
 
+=back
+
+=back
+
+=over 4
+
 =item Test names
 
 =item I'm ok, you're not ok.
@@ -15211,54 +16644,67 @@ B<ok>
 
 =back
 
-=back
-
 B<is>, B<isnt>
 
 B<like>
 
+B<can_ok>
+
+B<isa_ok>
+
 B<pass>, B<fail>
 
 =over 4
 
 =item Module tests
 
-B<use_ok>, B<require_ok>
+B<use_ok>
 
 =back
 
+B<require_ok>
+
 =over 4
 
 =item Conditional tests
 
-B<skip>   * UNIMPLEMENTED *
+B<SKIP: BLOCK>
 
 =back
 
-B<todo>  * UNIMPLEMENTED *
+B<TODO: BLOCK>
 
 =over 4
 
-=item Comparision functions
+=item Comparison functions
 
-B<eq_array>
+B<is_deeply>
 
 =back
 
+B<eq_array>
+
 B<eq_hash>
 
 B<eq_set>
 
 =over 4
 
+=item NOTES
+
 =item BUGS and CAVEATS
 
-=item AUTHOR
+Making your own ok(), The eq_* family have some caveats, Test::Harness
+upgrades
 
 =item HISTORY
 
 =item SEE ALSO
 
+=item AUTHORS
+
+=item COPYRIGHT
+
 =back
 
 =head2 Test::Simple - Basic utilities for writing tests.
@@ -15273,27 +16719,63 @@ B<ok>
 
 =back
 
-B<_sanity_check>
-
-B<_whoa>
-
-B<_my_exit>
-
 =over 4
 
 =item EXAMPLE
 
 =item CAVEATS
 
-=item HISTORY
+=item NOTES
 
-=item AUTHOR
+=item HISTORY
 
 =item SEE ALSO
 
-L<Test::More>, L<Test>, L<Test::Unit>, L<Pod::Tests>, L<SelfTest>,
+L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
 L<Test::Harness>
 
+=item AUTHORS
+
+=item COPYRIGHT
+
+=back
+
+=head2 Test::Tutorial - A tutorial about writing really basic tests
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item Nuts and bolts of testing.
+
+=item Where to start?
+
+=item Names
+
+=item Test the manual
+
+=item Sometimes the tests are wrong
+
+=item Testing lots of values
+
+=item Informative names
+
+=item Skipping tests
+
+=item Todo tests
+
+=item Testing with taint mode.
+
+=back
+
+=item FOOTNOTES
+
+=item AUTHORS
+
+=item COPYRIGHT
+
 =back
 
 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
@@ -15432,14 +16914,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
 
@@ -15451,9 +16934,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
 
@@ -15618,7 +17101,8 @@ TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
 
 =back
 
-=head2 Time::HiRes - High resolution ualarm, usleep, and gettimeofday
+=head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
+timers
 
 =over 4
 
@@ -15659,7 +17143,8 @@ getitimer ( $which )
 
 =back
 
-=head2 Time::Piece - Object Oriented time objects
+=head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
+function
 
 =over 4
 
@@ -15667,47 +17152,28 @@ getitimer ( $which )
 
 =item DESCRIPTION
 
-=item USAGE
-
-=over 4
-
-=item Local Locales
-
-=item Date Calculations
-
-=item Date Comparisons
-
-=item YYYY-MM-DDThh:mm:ss
-
-=item Week Number
-
-=item strftime method
-
-%%, %a, %A, %b, %B, %c, %C, %d, %D, %e, %h, %H, %I, %j, %m, %M, %n, %p, %r,
-%R, %S, %t, %T, %u, %U, %V, %w, %W, %x, %y, %Y, %Z
-
-=item strptime function
+=item NOTE
 
-=item Global Overriding
+=item AUTHOR
 
 =back
 
-=item SEE ALSO
-
-=item AUTHOR
+=head2 Time::localtime - by-name interface to Perl's built-in localtime()
+function
 
 =over 4
 
-=item License
+=item SYNOPSIS
 
-=item Bugs
+=item DESCRIPTION
 
-=back
+=item NOTE
+
+=item AUTHOR
 
 =back
 
-=head2 Time::Piece::Seconds, Time::Seconds - a simple API to convert
-seconds to other date values
+=head2 Time::tm - internal object used by Time::gmtime and Time::localtime
 
 =over 4
 
@@ -15715,17 +17181,11 @@ seconds to other date values
 
 =item DESCRIPTION
 
-=item METHODS
-
 =item AUTHOR
 
-=item LICENSE
-
-=item Bugs
-
 =back
 
-=head2 Time::Seconds - a simple API to convert seconds to other date values
+=head2 UNIVERSAL - base class for ALL classes (blessed references)
 
 =over 4
 
@@ -15733,18 +17193,12 @@ seconds to other date values
 
 =item DESCRIPTION
 
-=item METHODS
-
-=item AUTHOR
-
-=item LICENSE
-
-=item Bugs
+$obj->isa( TYPE ), CLASS->isa( TYPE ), isa( VAL, TYPE ), $obj->can( METHOD
+), CLASS->can( METHOD ), can( VAL, METHOD ), VERSION ( [ REQUIRE ] )
 
 =back
 
-=head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
-function
+=head2 Unicode::Collate - use UCA (Unicode Collation Algorithm)
 
 =over 4
 
@@ -15752,28 +17206,40 @@ function
 
 =item DESCRIPTION
 
-=item NOTE
+=over 4
 
-=item AUTHOR
+=item Constructor and Tailoring
 
-=back
+alternate, backwards, entry, ignoreName, ignoreChar, level, normalization,
+overrideCJK, overrideHangul, preprocess, rearrange, table, undefName,
+undefChar, katakana_before_hiragana, upper_before_lower
 
-=head2 Time::localtime - by-name interface to Perl's built-in localtime()
-function
+=item Other methods
 
-=over 4
+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 SYNOPSIS
+=item EXPORT
 
-=item DESCRIPTION
+=item CAVEAT
 
-=item NOTE
+=back
 
 =item AUTHOR
 
+=item SEE ALSO
+
+Unicode Collation Algorithm - Unicode TR #10, L<Unicode::Normalize>
+
 =back
 
-=head2 Time::tm - internal object used by Time::gmtime and Time::localtime
+=head2 Unicode::Normalize - normalized forms of Unicode text
 
 =over 4
 
@@ -15781,24 +17247,25 @@ function
 
 =item DESCRIPTION
 
-=item AUTHOR
+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)>
 
-=back
+=over 4
 
-=head2 UNIVERSAL - base class for ALL classes (blessed references)
+=item EXPORT
 
-=over 4
+=back
 
-=item SYNOPSIS
+=item AUTHOR
 
-=item DESCRIPTION
+=item SEE ALSO
 
-isa ( TYPE ), can ( METHOD ), VERSION ( [ REQUIRE ] ), UNIVERSAL::isa (
-VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD )
+L<Lingua::KO::Hangul::Util>, http://www.unicode.org/unicode/reports/tr15/
 
 =back
 
-=head2 UnicodeCD - Unicode character database
+=head2 Unicode::UCD - Unicode character database
 
 =over 4
 
@@ -15870,7 +17337,7 @@ VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD )
 
 =over 4
 
-=item UnicodeCD::UnicodeVersion
+=item Unicode::UCD::UnicodeVersion
 
 =back
 
@@ -15882,6 +17349,8 @@ VAL, TYPE ), UNIVERSAL::can ( VAL, METHOD )
 
 =over 4
 
+=item BUGS
+
 =item AUTHOR
 
 =back