X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperltoc.pod;h=078f41c527de2917b3cb39403b0cd6fff35c4c36;hb=890ed176d1ab1cf305ce9634210857cfed305fff;hp=e12154b4dde31098c5fdf2001993beddfaa5444a;hpb=fa1c7b030b9523f22b5aa55eab60d198f7831f89;p=p5sagit%2Fp5-mst-13.2.git

diff --git a/pod/perltoc.pod b/pod/perltoc.pod
index e12154b..078f41c 100644
--- a/pod/perltoc.pod
+++ b/pod/perltoc.pod
@@ -29,6 +29,8 @@ through to locate the proper section you're looking for.
 
 =item Miscellaneous
 
+=item Language-Specific
+
 =item Platform-Specific
 
 =back
@@ -346,6 +348,8 @@ regular expressions
 
 =item Lvalue subroutines
 
+Lvalue subroutines are EXPERIMENTAL
+
 =item Passing Symbol Table Entries (typeglobs)
 
 =item When to Still Use local()
@@ -396,44 +400,45 @@ in perl5
 
 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 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
+binmode FILEHANDLE, LAYER, 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 THING, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map
+EXPR,LIST, mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget
+KEY,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my
+TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL, next, no
+Module VERSION LIST, no Module VERSION, no Module LIST, no Module, oct
+EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open
+FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE,MODE,REFERENCE, open FILEHANDLE,
+opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR TYPE, our EXPR :
+ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST, package NAMESPACE,
+package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos,
+print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST,
+printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/,
+qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta,
+rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
 readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
 ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR,
@@ -446,13 +451,15 @@ 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,
 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
-EXPR, sleep, sockatmark SOCKET, socket SOCKET,DOMAIN,TYPE,PROTOCOL,
-socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort
-BLOCK LIST, sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice
-ARRAY,OFFSET,LENGTH, splice ARRAY,OFFSET, splice ARRAY, split
-/PATTERN/,EXPR,LIMIT, split /PATTERN/,EXPR, split /PATTERN/, split, sprintf
-FORMAT, LIST, sqrt EXPR, sqrt, srand EXPR, srand, stat FILEHANDLE, stat
-EXPR, stat, study SCALAR, study, sub BLOCK, sub NAME, sub NAME BLOCK,
+EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
+SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
+sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
+splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split
+/PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, format
+parameter index, flags, vector flag, (minimum) width, precision, or maximum
+width, size, order of arguments, sqrt EXPR, sqrt, srand EXPR, srand, stat
+FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub NAME BLOCK, sub NAME
+(PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK,
 substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
 EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
 FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
@@ -849,316 +856,19 @@ B<-X>, B<-x> I<directory>
 
 =item ENVIRONMENT
 
-HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLLIB, PERL5DB, PERL5SHELL
-(specific to the Win32 port), PERL_DEBUG_MSTATS, PERL_DESTRUCT_LEVEL,
-PERL_ENCODING, PERL_ROOT (specific to the VMS port), SYS$LOGIN (specific to
-the VMS port)
-
-=item DESCRIPTION
-
-accept() on closed socket %s, Allocation too large: %lx, '!' allowed only
-after types %s, Ambiguous call resolved as CORE::%s(), qualify as such or
-use &, Ambiguous range in transliteration operator, Ambiguous use of %s
-resolved as %s, '|' and '<' may not both be specified on command line, '|'
-and '>' may not both be specified on command line, Applying %s to %s will
-act on scalar(%s), Args must match #! line, Arg too short for msgsnd, %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, Argument "%s" isn't
-numeric%s, Array @%s missing the @ in argument %d of %s(), assertion
-botched: %s, Assertion failed: file "%s", Assignment to both a list and a
-scalar, Attempt to access disallowed key '%s' in a fixed hash, Attempt to
-clear a fixed hash, Attempt to delete readonly key '%s' from a fixed hash,
-Attempt to delete disallowed key '%s' from a fixed hash, Attempt to bless
-into a reference, Attempt to free non-arena SV: 0x%lx, Attempt to free
-nonexistent shared string, Attempt to free temp prematurely, Attempt to
-free unreferenced glob pointers, Attempt to free unreferenced scalar,
-Attempt to join self, Attempt to pack pointer to temporary value, Attempt
-to use reference as lvalue in substr, Bad arg length for %s, is %d, should
-be %s, Bad evalled substitution pattern, Bad filehandle: %s, Bad free()
-ignored, Bad hash, Bad index while coercing array into hash, Badly placed
-()'s, Bad name after %s::, Bad realloc() ignored, Bad symbol for array, Bad
-symbol for filehandle, Bad symbol for hash, Bareword found in conditional,
-Bareword "%s" not allowed while "strict subs" in use, Bareword "%s" refers
-to nonexistent package, BEGIN failed--compilation aborted, BEGIN not safe
-after errors--compilation aborted, \1 better written as $1, Binary number >
-0b11111111111111111111111111111111 non-portable, bind() on closed socket
-%s, binmode() on closed filehandle %s, Bit vector size > 32 non-portable,
-Bizarre copy of %s in %s, B<-P> not allowed for setuid/setgid script,
-Buffer overflow in prime_env_iter: %s, Callback called exit, %s() called
-too early to check prototype, / cannot take a count, Can't bless
-non-reference value, Can't call method "%s" in empty package "%s", Can't
-call method "%s" on an undefined value, Can't call method "%s" on unblessed
-reference, Can't call method "%s" without a package or object reference,
-Can't chdir to %s, Can't check filesystem of script "%s" for nosuid, Can't
-coerce array into hash, Can't coerce %s to integer in %s, Can't coerce %s
-to number in %s, Can't coerce %s to string in %s, Can't create pipe
-mailbox, Can't declare class for non-scalar %s in "%s", Can't declare %s in
-"%s", Can't do inplace edit: %s is not a regular file, Can't do inplace
-edit on %s: %s, Can't do inplace edit without backup, Can't do inplace
-edit: %s would not be unique, Can't do {n,m} with n > m in regex; marked by
-<-- HERE in m/%s/, Can't do setegid!, Can't do seteuid!, Can't do setuid,
-Can't do waitpid with flags, Can't emulate -%s on #! line, Can't exec "%s":
-%s, Can't exec %s, Can't execute %s, Can't find an opnumber for "%s", Can't
-find %s character property "%s", Can't find label %s, Can't find %s on
-PATH, Can't find %s on PATH, '.' not in PATH, Can't find string terminator
-%s anywhere before EOF, Can't find %s property definition %s, Can't fork,
-Can't get filespec - stale stat buffer?, Can't get pipe mailbox device
-name, Can't get SYSGEN parameter value for MAXBUF, Can't "goto" into the
-middle of a foreach loop, Can't "goto" out of a pseudo block, Can't goto
-subroutine from an eval-string, Can't goto subroutine outside a subroutine,
-Can't ignore signal CHLD, forcing to default, Can't "last" outside a loop
-block, Can't localize lexical variable %s, Can't localize pseudo-hash
-element, Can't localize through a reference, Can't locate %s, Can't locate
-auto/%s.al in @INC, Can't locate object method "%s" via package "%s",
-(perhaps you forgot to load "%s"?), Can't locate package %s for @%s::ISA,
-Can't make list assignment to \%ENV on this system, Can't modify %s in %s,
-Can't modify nonexistent substring, Can't modify non-lvalue subroutine
-call, Can't msgrcv to read-only var, Can't "next" outside a loop block,
-Can't open %s: %s, Can't open bidirectional pipe, Can't open error file %s
-as stderr, Can't open input file %s as stdin, Can't open output file %s as
-stdout, Can't open output pipe (name: %s), Can't open perl script%s: %s,
-Can't read CRTL environ, Can't redefine active sort subroutine %s, Can't
-"redo" outside a loop block, Can't remove %s: %s, skipping file, Can't
-rename %s to %s: %s, skipping file, Can't reopen input pipe (name: %s) in
-binary mode, Can't resolve method `%s' overloading `%s' in package `%s',
-Can't reswap uid and euid, Can't return %s from lvalue subroutine, Can't
-return %s to lvalue scalar context, Can't return outside a subroutine,
-Can't stat script "%s", Can't swap uid and euid, Can't take log of %g,
-Can't take sqrt of %g, Can't undef active subroutine, Can't unshift, Can't
-upgrade that kind of scalar, Can't upgrade to undef, Can't use an undefined
-value as %s reference, Can't use anonymous symbol table for method lookup,
-Can't use bareword ("%s") as %s ref while "strict refs" in use, Can't use
-%! because Errno.pm is not available, Can't use %s for loop variable, Can't
-use global %s in "my", Can't use "my %s" in sort comparison, Can't use %s
-ref as %s ref, Can't use string ("%s") as %s ref while "strict refs" in
-use, Can't use subscript on %s, Can't use \%c to mean $%c in expression,
-Can't weaken a nonreference, Can't x= to read-only value, Character in "C"
-format wrapped, Character in "c" format wrapped, close() on unopened
-filehandle %s, %s: Command not found, Compilation failed in require,
-Complex regular subexpression recursion limit (%d) exceeded, connect() on
-closed socket %s, Constant(%s)%s: %s, Constant is not %s reference,
-Constant subroutine %s redefined, Constant subroutine %s undefined, Copy
-method did not return a reference, CORE::%s is not a keyword, corrupted
-regexp pointers, corrupted regexp program, Corrupt malloc ptr 0x%lx at
-0x%lx, C<-p> destination: %s, C<-T> and C<-B> not implemented on
-filehandles, Deep recursion on subroutine "%s", defined(@array) is
-deprecated, defined(%hash) is deprecated, %s defines neither package nor
-VERSION--version check failed, Delimiter for here document is too long, Did
-not produce a valid header, %s did not return a true value, (Did you mean
-&%s instead?), (Did you mean "local" instead of "our"?), (Did you mean $ or
-@ instead of %?), Died, Document contains no data, %s does not define
-%s::VERSION--version check failed, Don't know how to handle magic of type
-'%s', do_study: out of memory, (Do you need to predeclare %s?), dump()
-better written as CORE::dump(), Duplicate free() ignored, elseif should be
-elsif, Empty %s, entering effective %s failed, Error converting file
-specification %s, %s: Eval-group in insecure regular expression, %s:
-Eval-group not allowed at run time, %s: Eval-group not allowed, use re
-'eval', Excessively long <> operator, exec? I'm not *that* kind of
-operating system, Execution of %s aborted due to compilation errors,
-Exiting eval via %s, Exiting format via %s, Exiting pseudo-block via %s,
-Exiting subroutine via %s, Exiting substitution via %s, Explicit blessing
-to '' (assuming package main), %s: Expression syntax, %s failed--call queue
-aborted, False [] range "%s" in regex; marked by <-- HERE in m/%s/, Fatal
-VMS error at %s, line %d, fcntl is not implemented, Filehandle %s opened
-only for input, Filehandle %s opened only for output, Final $ should be \$
-or $name, Final @ should be \@ or @name, flock() on closed filehandle %s,
-Quantifier follows nothing in regex;, Format not terminated, Format %s
-redefined, Found = in conditional, should be ==, %s found where operator
-expected, gdbm store returned %d, errno %d, key "%s", gethostent not
-implemented, get%sname() on closed socket %s, getpwnam returned invalid UIC
-%#o for user "%s", getsockopt() on closed socket %s, Global symbol "%s"
-requires explicit package name, glob failed (%s), Glob not terminated, Got
-an error from DosAllocMem, goto must have label, %s-group starts with a
-count, %s had compilation errors, Had to create %s unexpectedly, Hash %%s
-missing the % in argument %d of %s(), %s has too many errors, Hexadecimal
-number > 0xffffffff non-portable, Identifier too long, Illegal binary digit
-%s, Illegal binary digit %s ignored, Illegal character %s (carriage
-return), Illegal character in prototype for %s : %s, Illegal division by
-zero, Illegal hexadecimal digit %s ignored, Illegal modulus zero, Illegal
-number of bits in vec, Illegal octal digit %s, Illegal octal digit %s
-ignored, Illegal switch in PERL5OPT: %s, Ill-formed CRTL environ value
-"%s", Ill-formed message in prime_env_iter: |%s|, (in cleanup) %s, In
-EBCDIC the v-string components cannot exceed 2147483647, Insecure
-dependency in %s, Insecure directory in %s, Insecure $ENV{%s} while running
-%s, Integer overflow in %s number, Internal disaster in regex; marked by
-<-- HERE in m/%s/, Internal inconsistency in tracking vforks, Internal urp
-in regex; marked by <-- HERE in m/%s/, %s (...) interpreted as function,
-Invalid %s attribute: %s, Invalid %s attributes: %s, Invalid conversion in
-%s: "%s", Invalid [] range "%s" in regex; marked by <-- HERE in m/%s/,
-Invalid [] range "%s" in transliteration operator, Invalid separator
-character %s in attribute list, Invalid type in pack: '%s', Invalid type in
-unpack: '%s', ioctl is not implemented, ioctl() on unopened %s,
-IO::Socket::atmark not implemented on this architecture, `%s' is not a code
-reference, `%s' is not an overloadable type, junk on end of regexp, Label
-not found for "last %s", Label not found for "next %s", Label not found for
-"redo %s", leaving effective %s failed, listen() on closed socket %s,
-lstat() on filehandle %s, Lvalue subs returning %s not implemented yet,
-Lookbehind longer than %d not implemented in regex;, Malformed
-PERLLIB_PREFIX, Malformed prototype for %s: %s, Malformed UTF-8 character
-(%s), Malformed UTF-16 surrogate, %s matches null string many times in
-regex;, "%s" may clash with future reserved word, % may only be used in
-unpack, Method for operation %s not found in package %s during blessing,
-Method %s not permitted, Might be a runaway multi-line %s string starting
-on line %d, Misplaced _ in number, Missing %sbrace%s on \N{}, Missing comma
-after first argument to %s function, Missing command in piped open, Missing
-name in "my sub", Missing $ on loop variable, (Missing operator before
-%s?), Missing right brace on %s, Missing right curly or square bracket,
-(Missing semicolon on previous line?), Modification of a read-only value
-attempted, Modification of non-creatable array value attempted, %s,
-Modification of non-creatable hash value attempted, %s, Module name must be
-constant, Module name required with -%c option, More than one argument to
-open, msg%s not implemented, Multidimensional syntax %s not supported, /
-must be followed by a*, A* or Z*, / must be followed by a, A or Z, / must
-follow a numeric type, "my sub" not yet implemented, "my" variable %s can't
-be in a package, Name "%s::%s" used only once: possible typo, Negative
-length, Negative offset to vec in lvalue context, Nested quantifiers in
-regex; marked by <-- HERE in m/%s/, %s never introduced, No %s allowed
-while running setuid, No B<-e> allowed in setuid scripts, No comma allowed
-after %s, No command into which to pipe on command line, No DB::DB routine
-defined, No dbm on this machine, No DBsub routine, No error file after 2>
-or 2>> on command line, No input file after < on command line, No #! line,
-"no" not allowed in expression, No output file after > on command line, No
-output file after > or >> on command line, No package name allowed for
-variable %s in "our", No Perl script found in input, No setregid available,
-No setreuid available, No space allowed after -%c, No %s specified for -%c,
-No such class %s, No such pipe open, No such pseudo-hash field "%s", No
-such pseudo-hash field "%s" in variable %s of type %s, No such signal:
-SIG%s, Not a CODE reference, Not a format reference, Not a GLOB reference,
-Not a HASH reference, Not an ARRAY reference, Not a perl script, Not a
-SCALAR reference, Not a subroutine reference, Not a subroutine reference in
-overload table, Not enough arguments for %s, Not enough format arguments,
-%s: not found, %s not allowed in length fields, no UTC offset information;
-assuming local time is UTC, Null filename used, NULL OP IN RUN, Null
-picture in formline, Null realloc, NULL regexp argument, NULL regexp
-parameter, Number too long, Octal number in vector unsupported, Octal
-number > 037777777777 non-portable, Odd number of arguments for
-overload::constant, Odd number of elements in anonymous hash, Odd number of
-elements in hash assignment, Offset outside string, -%s on unopened
-filehandle %s, %s() on unopened %s, oops: oopsAV, oops: oopsHV, Operation
-`%s': no method found, %s, Operator or semicolon missing before %s, "our"
-variable %s redeclared, Out of memory!, Out of memory during "large"
-request for %s, Out of memory during request for %s, Out of memory during
-ridiculously large request, Out of memory for yacc stack, @ outside of
-string, %s package attribute may clash with future reserved word: %s, page
-overflow, panic: %s, panic: ck_grep, panic: ck_split, panic: corrupt saved
-stack index, panic: del_backref, panic: die %s, panic: pp_match%s, panic:
-do_subst, panic: do_trans_%s, panic: frexp, panic: goto, panic:
-INTERPCASEMOD, panic: INTERPCONCAT, panic: kid popen errno read, panic:
-last, panic: leave_scope clearsv, panic: leave_scope inconsistency, panic:
-magic_killbackrefs, panic: malloc, panic: mapstart, panic: null array,
-panic: pad_alloc, panic: pad_free curpad, panic: pad_free po, panic:
-pad_reset curpad, panic: pad_sv po, panic: pad_swipe curpad, panic:
-pad_swipe po, panic: pp_iter, panic: pp_split, panic: realloc, panic:
-restartop, panic: return, panic: scan_num, panic: sv_insert, panic:
-top_env, panic: yylex, panic: utf16_to_utf8: odd bytelen, Parentheses
-missing around "%s" list, Perl %s required--this is only version %s,
-stopped, PERL_SH_DIR too long, perl: warning: Setting locale failed,
-perlio: argument list not closed for layer "%s", perlio: invalid separator
-character %s in attribute list, perlio: unknown layer "%s", Permission
-denied, pid %x not a child, P must have an explicit size, POSIX syntax [%s]
-belongs inside character classes in regex;, POSIX syntax [. .] is reserved
-for future extensions in regex;, POSIX syntax [= =] is reserved for future
-extensions in regex;, POSIX class [:%s:] unknown in regex;, POSIX getpgrp
-can't take an argument, Possible attempt to put comments in qw() list,
-Possible attempt to separate words with commas, Possible memory corruption:
-%s overflowed 3rd argument, Possible unintended interpolation of %s in
-string, Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME :
-ATTRS" instead, Precedence problem: open %s should be open(%s), Premature
-end of script headers, printf() on closed filehandle %s, print() on closed
-filehandle %s, Process terminated by SIG%s, Prototype mismatch: %s vs %s,
-Prototype not terminated, Quantifier in {,} bigger than %d in regex;,
-Quantifier unexpected on zero-length expression;, Range iterator outside
-integer range, readline() on closed filehandle %s, Reallocation too large:
-%lx, realloc() of freed memory ignored, Recompile perl with B<-D>DEBUGGING
-to use B<-D> switch, Recursive inheritance detected in package '%s',
-Recursive inheritance detected while looking for method %s, Reference found
-where even-sized list expected, Reference is already weak, Reference
-miscount in sv_replace(), Reference to nonexistent group in regex;, regexp
-memory corruption, Regexp out of space, Repeat count in pack overflows,
-Repeat count in unpack overflows, Reversed %s= operator, Runaway format,
-Scalar value @%s[%s] better written as $%s[%s], Scalar value @%s{%s} better
-written as $%s{%s}, Scalars leaked: %d, Script is not setuid/setgid in
-suidperl, Search pattern not terminated, %sseek() on unopened filehandle,
-select not implemented, Self-ties of arrays and hashes are not supported,
-Semicolon seems to be missing, semi-panic: attempt to dup freed string,
-sem%s not implemented, send() on closed socket %s, Sequence (? incomplete
-in regex; marked by <-- HERE in m/%s/, Sequence (?{...}) not terminated or
-not {}-balanced in regex;, Sequence (?%s...) not implemented in regex;,
-Sequence (?%s...) not recognized in regex;, Sequence (?#... not terminated
-in regex;, 500 Server error, Server error, setegid() not implemented,
-seteuid() not implemented, setpgrp can't take arguments, setrgid() not
-implemented, setruid() not implemented, setsockopt() on closed socket %s,
-Setuid/gid script is writable by world, shm%s not implemented, <> should be
-quotes, /%s/ should probably be written as "%s", shutdown() on closed
-socket %s, SIG%s handler "%s" not defined, sort is now a reserved word,
-Sort subroutine didn't return a numeric value, Sort subroutine didn't
-return single value, splice() offset past end of array, Split loop,
-Statement unlikely to be reached, stat() on unopened filehandle %s, Stub
-found while resolving method `%s' overloading %s, Subroutine %s redefined,
-Substitution loop, Substitution pattern not terminated, Substitution
-replacement not terminated, substr outside of string, suidperl is no longer
-needed since %s, Switch (?(condition)... contains too many branches in
-regex;, Switch condition not recognized in regex;, switching effective %s
-is not implemented, syntax error, syntax error at line %d: `%s' unexpected,
-syntax error in file %s at line %d, next 2 tokens "%s", %s syntax OK,
-System V %s is not implemented on this machine, syswrite() on closed
-filehandle %s, Target of goto is too deeply nested, tell() on unopened
-filehandle, That use of $[ is unsupported, The crypt() function is
-unimplemented due to excessive paranoia, The %s function is unimplemented,
-The stat preceding %s wasn't an lstat, This Perl can't reset CRTL environ
-elements (%s), This Perl can't set CRTL environ elements (%s=%s), times not
-implemented, Too few args to syscall, Too late for "B<-T>" option, Too late
-for "-%s" option, Too late to run %s block, Too many args to syscall, Too
-many arguments for %s, Too many )'s, Too many ('s, Trailing \ in regex
-m/%s/, Transliteration pattern not terminated, Transliteration replacement
-not terminated, truncate not implemented, Type of arg %d to %s must be %s
-(not %s), umask not implemented, Unable to create sub named "%s",
-Unbalanced context: %d more PUSHes than POPs, Unbalanced saves: %d more
-saves than restores, Unbalanced scopes: %d more ENTERs than LEAVEs,
-Unbalanced tmps: %d more allocs than frees, Undefined format "%s" called,
-Undefined sort subroutine "%s" called, Undefined subroutine &%s called,
-Undefined subroutine called, Undefined subroutine in sort, Undefined top
-format "%s" called, Undefined value assigned to typeglob, %s: Undefined
-variable, unexec of %s into %s failed!, Unicode character %s is illegal,
-Unknown BYTEORDER, Unknown "re" subpragma '%s' (known ones are: %s),
-Unknown switch condition (?(%.2s in regex;, Unknown open() mode '%s',
-Unknown process %x sent message to prime_env_iter: %s, Unknown warnings
-category '%s', unmatched [ in regex; marked by <-- HERE in m/%s/, unmatched
-( in regex; marked by <-- HERE in m/%s/, Unmatched right %s bracket,
-Unquoted string "%s" may clash with future reserved word, Unrecognized
-character %s, /%s/: Unrecognized escape \\%c in character class passed
-through, Unrecognized escape \\%c passed through in regex;, Unrecognized
-escape \\%c passed through, Unrecognized signal name "%s", Unrecognized
-switch: -%s  (-h will show valid options), Unsuccessful %s on filename
-containing newline, Unsupported directory function "%s" called, Unsupported
-function %s, Unsupported function fork, Unsupported script encoding,
-Unsupported socket function "%s" called, Unterminated attribute list,
-Unterminated attribute parameter in attribute list, Unterminated compressed
-integer, Unterminated <> operator, untie attempted while %d inner
-references still exist, Useless (?%s) - use /%s modifier in regex;, Useless
-(?-%s) - don't use /%s modifier in regex;, Useless use of %s in void
-context, Useless use of "re" pragma, Useless use of sort in scalar context,
-Useless use of %s with no values, "use" not allowed in expression, Use of
-bare << to mean <<"" is deprecated, Use of *glob{FILEHANDLE} is deprecated,
-Use of chdir('') or chdir(undef) as chdir() deprecated, Use of implicit
-split to @_ is deprecated, Use of inherited AUTOLOAD for non-method %s() is
-deprecated, Use of -l on filehandle %s, Use of "package" with no arguments
-is deprecated, Use of %s in printf format not supported, Use of $* is
-deprecated, Use of %s is deprecated, Use of $# is deprecated, Use of
-reference "%s" as array index, Use of reserved word "%s" is deprecated, Use
-of tainted arguments in %s is deprecated, Use of uninitialized value%s,
-Using a hash as a reference is deprecated, Using an array as a reference is
-deprecated, UTF-16 surrogate %s, Value of %s can be "0"; test with
-defined(), Value of CLI symbol "%s" too long, Variable "%s" is not
-imported%s, "%s" variable %s masks earlier declaration in same %s, Variable
-"%s" may be unavailable, Variable syntax, Variable "%s" will not stay
-shared, Variable length lookbehind not implemented in regex;, Version
-number must be a constant number, v-string in use/require is non-portable,
-Warning: something's wrong, Warning: unable to close filehandle %s
-properly, Warning: Use of "%s" without parentheses is ambiguous, Wide
-character in %s, write() on closed filehandle %s, X outside of string, x
-outside of string, Xsub "%s" called in sort, Xsub called in sort, YOU
-HAVEN'T DISABLED SET-ID SCRIPTS IN THE KERNEL YET!, You need to quote "%s"
+HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
+:perlio, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
+PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS,
+PERL_DESTRUCT_LEVEL, PERL_ENCODING, PERL_ROOT (specific to the VMS port),
+SYS$LOGIN (specific to the VMS port)
+
+=back
+
+=head2 perldiag - various Perl diagnostics
+
+=over 4
+
+=item DESCRIPTION
 
 =back
 
@@ -1250,8 +960,8 @@ subname [condition], b postpone subname [condition], b load filename, b
 compile subname, B line, B *, a [line] command, A line, A *, w expr, W
 expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [
 command ], << command, > ?, > command, >> command, { ?, { [ command ], {{
-command, ! number, ! -number, ! pattern, !! cmd, @ file, H -number, q or
-^D, R, |dbcmd, ||dbcmd, command, m expr, M, man [manpage]
+command, ! number, ! -number, ! pattern, !! cmd, source file, H -number, q
+or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man [manpage]
 
 =item Configurable Options
 
@@ -1329,7 +1039,8 @@ ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
 0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S,
 $BASETIME, $^T, ${^TAINT}, $PERL_VERSION, $^V, $WARNING, $^W,
 ${^WARNING_BITS}, ${^WIDE_SYSTEM_CALLS}, $EXECUTABLE_NAME, $^X, ARGV,
-$ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
+$ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG,
+$SIG{expr}
 
 =item Error Indicators
 
@@ -1421,6 +1132,8 @@ $ARGV, @ARGV, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
 
 =item File Locking
 
+=item IO Layers
+
 =back
 
 =item SEE ALSO 
@@ -2009,11 +1722,20 @@ safe subprocesses, sockets, and semaphores)
 
 =item Signals
 
+=over 4
+
+=item Handling the SIGHUP Signal in Daemons
+
+=back
+
 =item Named Pipes
 
 =over 4
 
-=item WARNING
+=item Deferred Signals
+
+Long running opcodes, Interrupting IO, Signals as "faults", Signals
+triggered by operating system state
 
 =back
 
@@ -2079,7 +1801,7 @@ Proto, LocalPort, Listen, Reuse
 
 =back
 
-=head2 perlfork - Perl's fork() emulation (EXPERIMENTAL, subject to change)
+=head2 perlfork - Perl's fork() emulation
 
 =over 4
 
@@ -2131,8 +1853,8 @@ application, Thread-safety of extensions
 
 =item Flavors of Perl numeric operations
 
-Arithmetic operators except, C<no integer>, Arithmetic operators except,
-C<use integer>, Bitwise operators, C<no integer>, Bitwise operators, C<use
+Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other
+mathematical operators, Bitwise operators, Bitwise operators during C<use
 integer>, Operators which expect an integer, Operators which expect a
 string
 
@@ -2148,6 +1870,118 @@ string
 
 =item DESCRIPTION
 
+=item Status
+
+=item What Is A Thread Anyway?
+
+=item Threaded Program Models
+
+=over 4
+
+=item Boss/Worker
+
+=item Work Crew
+
+=item Pipeline
+
+=back
+
+=item Native threads
+
+=item What kind of threads are Perl threads?
+
+=item Thread-Safe Modules
+
+=item Thread Basics
+
+=over 4
+
+=item Basic Thread Support
+
+=item A Note about the Examples
+
+=item Creating Threads
+
+=item Giving up control
+
+=item Waiting For A Thread To Exit
+
+=item Ignoring A Thread
+
+=back
+
+=item Threads And Data
+
+=over 4
+
+=item Shared And Unshared Data
+
+=item Thread Pitfalls: Races
+
+=back
+
+=item Synchronization and control
+
+=over 4
+
+=item Controlling access: lock()
+
+=item A Thread Pitfall: Deadlocks
+
+=item Queues: Passing Data Around
+
+=item Semaphores: Synchronizing Data Access
+
+=item Basic semaphores
+
+=item Advanced Semaphores
+
+=item cond_wait() and cond_signal()
+
+=back
+
+=item General Thread Utility Routines
+
+=over 4
+
+=item What Thread Am I In?
+
+=item Thread IDs
+
+=item Are These Threads The Same?
+
+=item What Threads Are Running?
+
+=back
+
+=item A Complete Example
+
+=item Performance considerations
+
+=item Process-scope Changes
+
+=item Thread-Safety of System Libraries
+
+=item Conclusion
+
+=item Bibliography
+
+=over 4
+
+=item Introductory Texts
+
+=item OS-Related References
+
+=item Other References
+
+=back
+
+=item Acknowledgements
+
+=item AUTHOR
+
+=item Copyrights
+
 =back
 
 =head2 perlothrtut - old tutorial on threads in Perl
@@ -2287,6 +2121,8 @@ portable
 
 =item System Interaction
 
+=item Command names versus file pathnames
+
 =item Interprocess Communication (IPC)
 
 =item External Subroutines (XS)
@@ -2348,16 +2184,15 @@ 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,
+getprotoent, getservent, sethostent STAYOPEN, setnetent STAYOPEN,
+setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, endhostent,
+endnetent, endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob
+EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link
+OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG,
+msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open
+FILEHANDLE,EXPR, open FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink
+EXPR, readlink, select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG,
+semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
@@ -2516,8 +2351,6 @@ LC_NUMERIC, LC_TIME, LANG
 
 =item Questions With Answers
 
-, , , , , , 
-
 =item Hexadecimal Notation
 
 =item Further Resources
@@ -2528,7 +2361,7 @@ LC_NUMERIC, LC_TIME, LANG
 
 =item SEE ALSO
 
-=item ACKNOWLEDGEMENTS
+=item ACKNOWLEDGMENTS
 
 =item AUTHOR, COPYRIGHT, AND LICENSE
 
@@ -2544,24 +2377,26 @@ LC_NUMERIC, LC_TIME, LANG
 
 =item Important Caveats
 
-Input and Output Disciplines, Regular Expressions, C<use utf8> still needed
-to enable UTF-8/UTF-EBCDIC in scripts
+Input and Output Layers, Regular Expressions, C<use utf8> still needed to
+enable UTF-8/UTF-EBCDIC in scripts
 
-=item Byte and Character semantics
+=item Byte and Character Semantics
 
-=item Effects of character semantics
+=item Effects of Character Semantics
 
 =item Scripts
 
 =item Blocks
 
-=item Character encodings for input and output
+=item User-Defined Character Properties
+
+=item Character Encodings for Input and Output
 
 =item Unicode Regular Expression Support Level
 
 =item Unicode Encodings
 
-=item Security Implications of Malformed UTF-8
+=item Security Implications of Unicode
 
 =item Unicode in Perl on EBCDIC
 
@@ -2573,6 +2408,16 @@ to enable UTF-8/UTF-EBCDIC in scripts
 
 =item BUGS
 
+=over 4
+
+=item Interaction with Locales
+
+=item Interaction with Extensions
+
+=item Speed
+
+=back
+
 =item SEE ALSO
 
 =back
@@ -2723,6 +2568,8 @@ chcp, dataset access, OS/390, z/OS iconv, locales
 
 =item Protecting Your Programs
 
+=item Unicode
+
 =back
 
 =item SEE ALSO
@@ -2792,51 +2639,59 @@ module (sometimes unnecessary), B<INSTALL> the module
 
 =item Pragmatic Modules
 
-attributes, autouse, base, bigint, bignum, bigrat, blib, bytes, charnames,
-constant, diagnostics, encoding, fields, filetest, if, integer, less,
-locale, open, overload, re, sigtrap, sort, strict, subs, utf8, vars,
-vmsish, warnings, warnings::register
+attributes, attrs, autouse, base, bigint, bignum, bigrat, blib, bytes,
+charnames, constant, diagnostics, encoding, fields, filetest, if, integer,
+less, locale, open, ops, overload, re, sigtrap, sort, strict, subs,
+threads, utf8, vars, vmsish, warnings, warnings::register
 
 =item Standard Modules
 
-AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, Benchmark, CGI,
-CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push,
-CGI::Switch, CGI::Util, CPAN, CPAN::FirstTime, CPAN::Nox, Carp,
-Carp::Heavy, Class::ISA, Class::Struct, Cwd, DB, Devel::SelfStubber,
-Digest, DirHandle, Dumpvalue, English, Env, Exporter, Exporter::Heavy,
-ExtUtils::Command, ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install,
-ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM_BeOS,
-ExtUtils::MM_Cygwin, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_Unix,
-ExtUtils::MM_VMS, ExtUtils::MM_Win32, ExtUtils::MakeMaker,
-ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists,
-ExtUtils::Packlist, ExtUtils::testlib, Fatal, File::Basename,
-File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find,
-File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc,
-File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix,
-File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache,
-FileHandle, Filter::Simple, FindBin, Getopt::Long, Getopt::Std, Hash::Util,
-I18N::Collate, I18N::LangTags, I18N::LangTags::List, IPC::Open2,
+AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
+B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
+B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
+B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
+CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
+CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
+Class::Struct, Config, Cwd, DB, DB_File, Devel::SelfStubber, Digest,
+DirHandle, Dumpvalue, Encode, English, Env, Errno, Exporter,
+Exporter::Heavy, ExtUtils::Command, ExtUtils::Command::MM,
+ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install,
+ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_Any,
+ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS,
+ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_UWIN,
+ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
+ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker, ExtUtils::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::Cygwin, File::Spec::Epoc, File::Spec::Functions,
+File::Spec::Mac, File::Spec::OS2, File::Spec::Unix, File::Spec::VMS,
+File::Spec::Win32, File::Temp, File::stat, FileCache, FileHandle,
+Filter::Simple, FindBin, Getopt::Long, Getopt::Std, Hash::Util,
+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,
 Locale::Script, Math::BigFloat, Math::BigInt, Math::BigInt::Calc,
 Math::BigRat, Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File,
 Memoize::Expire, Memoize::ExpireFile, Memoize::ExpireTest,
-Memoize::NDBM_File, Memoize::SDBM_File, Memoize::Storable, NEXT, Net::Cmd,
-Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3,
-Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent,
-Net::protoent, Net::servent, PerlIO, Pod::Checker, Pod::Find,
-Pod::Functions, Pod::Html, Pod::InputObjects, Pod::LaTeX, Pod::Man,
-Pod::ParseLink, Pod::ParseUtils, Pod::Parser, Pod::Plainer, Pod::Select,
-Pod::Text, Pod::Text::Color, Pod::Text::Overstrike, Pod::Text::Termcap,
-Pod::Usage, Pod::t::basic, Search::Dict, SelectSaver, SelfLoader, Shell,
-Switch, Symbol, Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine,
-Test, Test::Builder, Test::Harness, Test::Harness::Assert,
+Memoize::NDBM_File, Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT,
+Net::Cmd, Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc,
+Net::POP3, Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ,
+Net::netent, Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX,
+PerlIO, PerlIO::via::QuotedPrint, Pod::Checker, Pod::Find, Pod::Functions,
+Pod::Html, Pod::InputObjects, Pod::LaTeX, Pod::Man, Pod::ParseLink,
+Pod::ParseUtils, Pod::Parser, Pod::Plainer, Pod::Select, Pod::Text,
+Pod::Text::Color, Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage,
+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::Harness::Assert,
 Test::Harness::Iterator, Test::Harness::Straps, Test::More, Test::Simple,
 Test::Tutorial, Text::Abbrev, Text::Balanced, Text::ParseWords,
-Text::Soundex, Text::Tabs, Text::Wrap, Thread, Tie::Array, Tie::File,
-Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash, Tie::Scalar,
-Tie::SubstrHash, Time::Local, Time::gmtime, Time::localtime, Time::tm,
-UNIVERSAL, Unicode::Collate, Unicode::UCD, User::grent, User::pwent, Win32
+Text::Soundex, Text::Tabs, Text::Wrap, Thread, Thread::Queue,
+Thread::Semaphore, Tie::Array, Tie::File, Tie::Handle, Tie::Hash,
+Tie::Memoize, 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
 
@@ -2848,18 +2703,46 @@ UNIVERSAL, Unicode::Collate, Unicode::UCD, User::grent, User::pwent, Win32
 
 =item Africa
 
+South Africa
+
 =item Asia
 
+China, India, Indonesia, Israel, Japan, Korea, Philippines, Russian
+Federation, Saudi Arabia, Singapore, South Korea, Taiwan, Thailand
+
 =item Central America
 
+Costa Rica
+
 =item Europe
 
+Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Estonia,
+Finland, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia,
+Lithuania, Netherlands, Norway, Poland, Portugal, Romania, Russia,
+Slovakia, Slovenia, Spain, Sweden, Switzerland, Turkey, Ukraine, United
+Kingdom
+
 =item North America
 
+Alberta, Manitoba, Nova Scotia, Ontario, Quebec, Mexico
+
+=item United States
+
+Alabama, California, Colorado, Delaware, District of Columbia, Florida,
+Illinois, Indiana, Kentucky, Massachusetts, Michigan, New Jersey, New York,
+North Carolina, Ohio, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas,
+Utah, Virginia, ashington, Wisconsin
+
 =item Oceania
 
+Australia, New Zealand
+
 =item South America
 
+Argentina, Brazil, Chile
+
+=item RSYNC Mirrors
+
 =back
 
 =item Modules: Creation, Use, and Abuse
@@ -3014,8 +2897,8 @@ tarball, Announce to the modules list, Announce to clpa, Fix bugs!
 
 =back
 
-=head2 perlfaq1 - General Questions About Perl ($Revision: 1.7 $, $Date:
-2002/02/21 14:49:15 $)
+=head2 perlfaq1 - General Questions About Perl ($Revision: 1.8 $, $Date:
+2002/04/07 18:46:13 $)
 
 =over 4
 
@@ -3061,8 +2944,8 @@ Scheme, or Tcl?
 
 =back
 
-=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.9 $,
-$Date: 2002/03/09 21:01:13 $)
+=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.13 $,
+$Date: 2002/04/26 16:56:35 $)
 
 =over 4
 
@@ -3117,8 +3000,8 @@ References, Tutorials, Task-Oriented, Special Topics
 
 =back
 
-=head2 perlfaq3 - Programming Tools ($Revision: 1.15 $, $Date: 2002/02/11
-19:29:52 $)
+=head2 perlfaq3 - Programming Tools ($Revision: 1.22 $, $Date: 2002/05/06
+13:11:13 $)
 
 =over 4
 
@@ -3144,7 +3027,7 @@ References, Tutorials, Task-Oriented, Special Topics
 
 =item Is there an IDE or Windows Perl Editor?
 
-Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+,
+Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl,
 CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright,
 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
 
@@ -3202,8 +3085,8 @@ my C program; what am I doing wrong?
 
 =back
 
-=head2 perlfaq4 - Data Manipulation ($Revision: 1.19 $, $Date: 2002/03/11
-22:15:19 $)
+=head2 perlfaq4 - Data Manipulation ($Revision: 1.25 $, $Date: 2002/05/30
+07:04:25 $)
 
 =over 4
 
@@ -3223,10 +3106,10 @@ Trig functions?
 
 =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:>
+How do I convert hexadecimal into decimal, How do I convert from decimal to
+hexadecimal, How do I convert from octal to decimal, How do I convert from
+decimal to octal, How do I convert from binary to decimal, How do I convert
+from decimal to binary
 
 =item Why doesn't & work the way I want it to?
 
@@ -3419,8 +3302,8 @@ array of hashes or arrays?
 
 =back
 
-=head2 perlfaq5 - Files and Formats ($Revision: 1.12 $, $Date: 2002/03/11
-22:25:25 $)
+=head2 perlfaq5 - Files and Formats ($Revision: 1.18 $, $Date: 2002/05/30
+07:04:25 $)
 
 =over 4
 
@@ -3512,8 +3395,8 @@ protected files?  Isn't this a bug in Perl?
 
 =back
 
-=head2 perlfaq6 - Regular Expressions ($Revision: 1.8 $, $Date: 2002/01/31
-04:27:55 $)
+=head2 perlfaq6 - Regular Expressions ($Revision: 1.12 $, $Date: 2002/06/01
+22:31:09 $)
 
 =over 4
 
@@ -3579,8 +3462,8 @@ file?
 
 =back
 
-=head2 perlfaq7 - General Perl Language Issues ($Revision: 1.7 $, $Date:
-2002/01/31 04:27:55 $)
+=head2 perlfaq7 - General Perl Language Issues ($Revision: 1.8 $, $Date:
+2002/03/26 15:48:32 $)
 
 =over 4
 
@@ -3658,8 +3541,8 @@ is in scope?
 
 =back
 
-=head2 perlfaq8 - System Interaction ($Revision: 1.6 $, $Date: 2002/01/28
-04:17:27 $)
+=head2 perlfaq8 - System Interaction ($Revision: 1.8 $, $Date: 2002/05/16
+12:41:42 $)
 
 =over 4
 
@@ -3786,7 +3669,7 @@ search path?
 
 =back
 
-=head2 perlfaq9 - Networking ($Revision: 1.7 $, $Date: 2002/01/28 04:17:27
+=head2 perlfaq9 - Networking ($Revision: 1.9 $, $Date: 2002/04/07 18:46:13
 $)
 
 =over 4
@@ -3888,12 +3771,14 @@ i, &, s, r
 
 =item The Optimized C Back End
 
-B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
-B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj,
-B::Stash, B::Terse, B::Xref
-
 =back
 
+=item Module List for the Compiler Suite
+
+B, O, 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
+
 =item KNOWN PROBLEMS
 
 =item AUTHOR
@@ -4079,7 +3964,7 @@ C<!!!>, C<!!>, C<!>
 
 =item EXAMPLE 8 (Coming Soon)
 
-=item EXAMPLE 9 (Coming Soon)
+=item EXAMPLE 9 Passing open files to XSes
 
 =item Troubleshooting these Examples
 
@@ -4269,6 +4154,8 @@ C<t>, C<p>, C<n>, C<s>
 
 =item Creating New Variables
 
+GV_ADDMULTI, GV_ADDWARN
+
 =item Reference Counts and Mortality
 
 =item Stashes and Globs
@@ -4612,8 +4499,8 @@ CvSTASH, get_cv, Nullcv
 
 =item Embedding Functions
 
-load_module, perl_alloc, perl_construct, perl_destruct, perl_free,
-perl_parse, perl_run, require_pv
+load_module, nothreadhook, perl_alloc, perl_construct, perl_destruct,
+perl_free, perl_parse, perl_run, require_pv
 
 =item Functions in file pp_pack.c
 
@@ -4637,8 +4524,8 @@ HEf_SVKEY, Nullch, Nullsv
 get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set,
 HeVAL, HvNAME, hv_clear, hv_delete, hv_delete_ent, hv_exists,
 hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey,
-hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iterval, hv_magic, hv_store,
-hv_store_ent, hv_undef, newHV, Nullhv
+hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iternext_flags, hv_iterval,
+hv_magic, hv_store, hv_store_ent, hv_undef, newHV, Nullhv
 
 =item Magical Functions
 
@@ -4648,8 +4535,8 @@ SvSetSV, SvSetSV_nosteal, SvSHARE
 
 =item Memory Management
 
-Copy, Move, New, Newc, NEWSV, Newz, Renew, Renewc, Safefree, savepv,
-savepvn, savesharedpv, StructCopy, Zero
+Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree,
+savepv, savepvn, savesharedpv, StructCopy, Zero
 
 =item Miscellaneous Functions
 
@@ -4705,13 +4592,13 @@ sv_nounlocking, sv_nv, sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte,
 sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force, sv_pvn_force_flags,
 sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype, sv_replace,
 sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv,
-sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg,
-sv_setpvn, sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv,
-sv_setref_pv, sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_flags,
-sv_setsv_mg, sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true,
-sv_unmagic, sv_unref, sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn,
-sv_usepvn_mg, sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode,
-sv_utf8_upgrade, sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn
+sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpvn, sv_setpvn_mg,
+sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv, sv_setref_pvn,
+sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg, sv_setuv, sv_setuv_mg,
+sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref, sv_unref_flags,
+sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_utf8_decode,
+sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, sv_utf8_upgrade_flags,
+sv_uv, sv_vcatpvfn, sv_vsetpvfn
 
 =item Unicode Support
 
@@ -4805,10 +4692,11 @@ PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
 
 =item Methods in Detail
 
-name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_CANCRLF, PERLIO_K_FASTGETS,
-PERLIO_K_MULTIARG, PERLIO_K_RAW, Pushed, Popped, Open, Getarg, Fileno, Dup,
-Read, Write, Seek, Tell, Close, Flush, Fill, Eof, Error,  Clearerr,
-Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, Set_ptrcnt
+fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF,
+PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode,
+Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof,
+Error,	Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
+Set_ptrcnt
 
 =item Core Layers
 
@@ -4816,7 +4704,7 @@ Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt, Set_ptrcnt
 
 =item Extension Layers
 
-":encoding", ":Scalar", ":Object" or ":Perl"
+":encoding", ":scalar", ":via"
 
 =back
 
@@ -4848,8 +4736,8 @@ B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
 
 =item Co-existence with stdio
 
-B<PerlIO_importFILE(f,flags)>, B<PerlIO_exportFILE(f,flags)>,
-B<PerlIO_findFILE(f)>, B<PerlIO_releaseFILE(p,f)>
+B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
+B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
 
 =item "Fast gets" Functions
 
@@ -4889,12 +4777,10 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item Unicode
 
-=item use Thread for iThreads
-
-=item make perl_clone optionally clone ops
-
 =item Work out exit/die semantics for threads
 
+=item Better support for nonpreemptive threading systems like GNU pth
+
 =item Typed lexicals for compiler
 
 =item Compiler workarounds for Win32
@@ -4919,8 +4805,6 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item Locales
 
-=item Thread-safe regexes
-
 =item Arithmetic on non-Arabic numerals
 
 =item POSIX Unicode character classes
@@ -4993,8 +4877,6 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item Cache recently used regexps
 
-=item Re-entrant functions
-
 =item Cross-compilation support
 
 =item Bit-shifting bitvectors
@@ -5051,6 +4933,10 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item Allow restricted hash assignment
 
+=item Should overload be inheritable?
+
+=item Taint rethink
+
 =back
 
 =item Vague ideas
@@ -5093,6 +4979,12 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item Update auxiliary tools
 
+=item Create debugging macros
+
+=item truncate to the people
+
+=item Unicode in Filenames
+
 =back
 
 =item Recently done things
@@ -5213,10 +5105,6 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item Unicode collation and normalization
 
-=item Create debugging macros
-
-=item truncate to the people
-
 =item pack/unpack tutorial
 
 =back
@@ -5246,7 +5134,7 @@ NFS, rsync'ing the patches
 
 =item Why rsync the source tree
 
-It's easier to rsync the source tree, It's more recent, It's more reliable
+It's easier to rsync the source tree, It's more reliable
 
 =item Why rsync the patches
 
@@ -5301,6 +5189,11 @@ finish, 'enter', print
 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
 F<t/pod/>, F<t/run/>, t/base t/comp, t/cmd t/run t/io t/op, t/lib ext lib
 
+=item Special Make Test Targets
+
+coretest, test.deparse, minitest, test.third check.third utest.third
+ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8
+
 =back
 
 =item EXTERNAL TOOLS FOR DEBUGGING PERL
@@ -5317,7 +5210,7 @@ F<t/pod/>, F<t/run/>, t/base t/comp, t/cmd t/run t/io t/op, t/lib ext lib
 
 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
 
-=item Compaq's/Digital's Third Degree
+=item Compaq's/Digital's/HP's Third Degree
 
 =item PERL_DESTRUCT_LEVEL
 
@@ -5388,22 +5281,28 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =over 4
 
+=item Binary Incompatibility
+
 =item 64-bit platforms and malloc
 
 =item AIX Dynaloading
 
-=item Attributes for C<my> variables now handled at run-time.
+=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 New Unicode Semantics (no more C<use utf8>, almost)
+
 =item New Unicode Properties
 
 =item REF(...) Instead Of SCALAR(...)
 
 =item pack/unpack D/F recycled
 
+=item glob() now returns filenames in alphabetical order
+
 =item Deprecations
 
 =back
@@ -5412,14 +5311,20 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =over 4
 
+=item Unicode Overhaul
+
 =item PerlIO is Now The Default
 
-=item Safe Signals
+=item ithreads
 
-=item Unicode Overhaul
+=item Restricted Hashes
+
+=item Safe Signals
 
 =item Understanding of Numbers
 
+=item Arrays now always interpolate into double-quoted strings [561]
+
 =item Miscellaneous Changes
 
 =back
@@ -5462,7 +5367,7 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item Changed Internals
 
-=item Security Vulnerability Closed
+=item Security Vulnerability Closed [561]
 
 =item New Tests
 
@@ -5470,52 +5375,100 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =over 4
 
-=item AIX
+=item The Compiler Suite Is Still Very Experimental
 
-=item Amiga Perl Invoking Mystery
+=item Localising Tied Arrays and Hashes Is Broken
+
+=item Building Extensions Can Fail Because Of Largefiles
+
+=item Modifying $_ Inside for(..)
 
 =item mod_perl 1.26 Doesn't Build With Threaded Perl
 
 =item lib/ftmp-security tests warn 'system possibly insecure'
 
-=item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
+=item libwww-perl (LWP) fails base/date #51
+
+=item PDL failing some tests
+
+=item Perl_get_sv
+
+=item Self-tying Problems
+
+=item ext/threads/t/libc
+
+=item Failure of Thread (5.005-style) tests
+
+=item Timing problems
+
+=item Tied/Magical Array/Hash Elements Do Not Autovivify
+
+=item Unicode in package/class and subroutine names does not work
+
+=back
+
+=item Platform Specific Problems
+
+=over 4
+
+=item AIX
+
+=item Alpha systems with old gccs fail several tests
+
+=item AmigaOS
+
+=item BeOS
+
+=item Cygwin "unable to remap"
+
+=item Cygwin ndbm tests fail on FAT
+
+=item DJGPP Failures
+
+=item FreeBSD built with ithreads coredumps reading large directories
+
+=item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
+
+=item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
+
+=item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
+
+=item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
 
 =item Linux With Sfio Fails op/misc Test 48
 
 =item Mac OS X
 
+=item Mac OS X dyld undefined symbols
+
+=item OS/2 Test Failures
+
 =item op/sprintf tests 91, 129, and 130
 
-=item Failure of Thread (5.005-style) tests
+=item Solaris 2.5
 
-=item UNICOS
+=item Solaris x86 Fails Tests With -Duse64bitint
 
-=item UNICOS and UNICOS/mk
+=item SUPER-UX (NEC SX)
+
+=item Term::ReadKey not working on Win32
 
 =item UNICOS/mk
 
 =item UTS
 
+=item VOS (Stratus)
+
 =item VMS
 
 =item Win32
 
-=item Localising a Tied Variable Leaks Memory
+=item XML::Parser not working
 
 =item z/OS (OS/390)
 
-=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
@@ -6256,8 +6209,6 @@ C<PATCHLEVEL> is now C<PERL_VERSION>
 
 =item Known test failures
 
-, , 
-
 =item EBCDIC platforms not fully supported
 
 =item UNICOS/mk CC failures during Configure run
@@ -7093,6 +7044,8 @@ long, Process terminated by SIG%s
 
 =over 4
 
+=item NOTE
+
 =item SYNOPSIS
 
 =back
@@ -7145,6 +7098,8 @@ B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
 
 =back
 
+=item PERL 5.8.0 BROKEN IN AMIGAOS
+
 =item AUTHORS
 
 =item SEE ALSO
@@ -7167,7 +7122,7 @@ R4 x86, R4 PPC
 
 =item Contact Information
 
-=item Update 2002-03-02
+=item Update 2002-05-30
 
 =back
 
@@ -7266,7 +7221,7 @@ C<PATH>, I<nroff>, Permissions
 =item Optional Libraries for Perl on Cygwin
 
 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
-C<-lcygipc> (C<use IPC::SysV>)
+C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
 
 =item Configure-time Options for Perl on Cygwin
 
@@ -7296,6 +7251,8 @@ I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
 
 =item File Permissions on Cygwin
 
+=item NDBM_File does not work on FAT filesystems
+
 =item Script Portability on Cygwin
 
 Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous
@@ -7425,6 +7382,26 @@ DJGPP, Pthreads
 
 =back
 
+=head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item FreeBSD core dumps from readdir_r with ithreads
+
+=item $^X doesn't always contain a full path in FreeBSD
+
+=item Perl will no longer be part of "base FreeBSD"
+
+=back
+
+=item AUTHOR
+
+=back
+
 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
 (HP-UX) systems
 
@@ -7456,12 +7433,16 @@ DJGPP, Pthreads
 
 =item The HP ANSI C Compiler
 
+=item The GNU C Compiler
+
 =item Using Large Files with Perl on HP-UX
 
 =item Threaded Perl on HP-UX
 
 =item 64-bit Perl on HP-UX
 
+=item Oracle on HP-UX
+
 =item GDBM and Threads on HP-UX
 
 =item NFS filesystems and utime(2) on HP-UX
@@ -7496,8 +7477,7 @@ DJGPP, Pthreads
 
 =back
 
-=head2 perlmachten, README.machten - Perl version 5 on Power MachTen
-systems
+=head2 perlirix, README.irix - Perl version 5 on Irix systems
 
 =over 4
 
@@ -7505,7 +7485,34 @@ systems
 
 =over 4
 
-=item Compiling Perl 5 on MachTen
+=item Building 32-bit Perl in Irix
+
+=item Building 64-bit Perl in Irix
+
+=item About Compiler Versions of Irix
+
+=item Linker Problems in Irix
+
+=item Malloc in Irix
+
+=item Building with threads in Irix
+
+=back
+
+=item AUTHOR
+
+=back
+
+=head2 perlmachten, README.machten - Perl version 5 on Power MachTen
+systems
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item Compiling Perl 5 on MachTen
 
 =item Failures during C<make test> on MachTen
 
@@ -7598,7 +7605,7 @@ public_html/feedback.cgi, src/perl-5.6.0-mpe
 
 =item Setup
 
-Buildtype.bat, SetNWBld.bat, MPKBuild.bat
+SetNWBld.bat, Buildtype.bat
 
 =item Make
 
@@ -7612,8 +7619,6 @@ Buildtype.bat, SetNWBld.bat, MPKBuild.bat
 
 =item Build new extensions
 
-=item Known Issues
-
 =item Acknowledgements
 
 =item Authors
@@ -7781,11 +7786,13 @@ C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
-OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>
+OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
+C<OS2::DLLname([how [, \&xsub]])>
 
 =item Prebuilt variables:
 
-$OS2::emx_rev, $OS2::emx_env, $OS2::os_ver
+$OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
+$OS2::nsyserror
 
 =item Misfeatures
 
@@ -7798,7 +7805,10 @@ C<flock>
 
 =item Centralized management of resources
 
-C<HAB>, C<HMQ>
+C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
+C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
+C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
+C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
 
 =back
 
@@ -7844,6 +7854,8 @@ C<HAB>, C<HMQ>
 
 =over 4
 
+=item Text-mode filehandles
+
 =item Priorities
 
 =item DLL name mangling: pre 5.6.2
@@ -8103,6 +8115,8 @@ Digital UNIX formerly known as DEC OSF/1) systems
 
 =item ext/ODBM_File/odbm Test Failing With Static Builds
 
+=item Perl Fails Because Of Unresolved Symbol sockatmark
+
 =item AUTHOR
 
 =back
@@ -8262,8 +8276,12 @@ LIST, waitpid PID,FLAGS
 
 =item Restrictions of Perl on VOS
 
+=item Handling of underflow and overflow
+
 =back
 
+=item TEST STATUS
+
 =item SUPPORT STATUS
 
 =item AUTHOR
@@ -8272,7 +8290,7 @@ LIST, waitpid PID,FLAGS
 
 =back
 
-=head2 perlwin32 - Perl under Win32
+=head2 perlwin32 - Perl under Windows
 
 =over 4
 
@@ -8284,7 +8302,8 @@ LIST, waitpid PID,FLAGS
 
 =item Setting Up Perl on Win32
 
-Make, Command Shell, Borland C++, Microsoft Visual C++, Mingw32 with GCC
+Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform
+SDK 64-bit Compiler, Mingw32 with GCC
 
 =item Building
 
@@ -8296,7 +8315,11 @@ Make, Command Shell, Borland C++, Microsoft Visual C++, Mingw32 with GCC
 
 Environment Variables, File Globbing, Using perl from the command line,
 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
-Extensions, Running Perl Scripts, Miscellaneous Things
+Extensions, Notes on 64-bit Windows
+
+=item Running Perl Scripts
+
+Miscellaneous Things
 
 =back
 
@@ -8351,8 +8374,8 @@ data structures between threads
 
 =item FUNCTIONS
 
-share VARIABLE, lock VARIABLE, unlock VARIABLE, cond_wait VARIABLE,
-cond_signal VARIABLE, cond_broadcast VARIABLE
+share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
+cond_broadcast VARIABLE
 
 =item NOTES
 
@@ -8374,19 +8397,21 @@ from perl
 =item DESCRIPTION
 
 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
-threads->self, $thread->tid
+threads->self, $thread->tid, threads->object( tid ), threads->yield();,
+threads->list();, async BLOCK;
 
-=item TODO
+=item WARNINGS
 
-Fix so the return value is returned when you join, Add join_all, Fix memory
-leaks!
+A thread exited while %d other threads were still running
 
-=item AUTHOR and COPYRIGHT
+=item TODO
 
 =item BUGS
 
-creating a thread from within a thread is unsafe under win32,
-PERL_OLD_SIGNALS are not threadsafe, will not be
+Parent-Child threads, Returning objects, Creating threads inside BEGIN
+blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
+
+=item AUTHOR and COPYRIGHT
 
 =item SEE ALSO
 
@@ -8436,6 +8461,18 @@ FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
 
 =back
 
+=head2 attrs - set/get attributes of a subroutine (deprecated)
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+method, locked
+
+=back
+
 =head2 autouse - postpone load of modules until a function is used
 
 =over 4
@@ -8602,7 +8639,7 @@ semantics
 =back
 
 =head2 charnames - define character names for C<\N{named}> string literal
-escapes.
+escapes
 
 =over 4
 
@@ -8614,7 +8651,9 @@ escapes.
 
 =item charnames::viacode(code)
 
-=item charnames::vianame(code)
+=item charnames::vianame(name)
+
+=item ALIASES
 
 =item ILLEGAL CHARACTERS
 
@@ -8679,14 +8718,34 @@ diagnostics
 
 =back
 
-=head2 encoding - pragma to control the conversion of legacy data into
-Unicode
+=head2 encoding - allows you to write your script in non-ascii or non-utf8
 
 =over 4
 
 =item SYNOPSIS
 
-=item DESCRIPTION
+=item ABSTRACT
+
+=item USAGE
+
+use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
+I<ENCNAME_IN> ...] ;, no encoding;
+
+=item CAVEATS
+
+=over 4
+
+=item NOT SCOPED
+
+=item DO NOT MIX MULTIPLE ENCODINGS
+
+=back
+
+=item Non-ASCII Identifiers and Filter option
+
+use encoding I<ENCNAME> Filter=E<gt>1;
+
+=item EXAMPLE - Greekperl
 
 =item KNOWN PROBLEMS
 
@@ -8779,6 +8838,8 @@ point
 
 =item CAVEATS
 
+=item NOTES
+
 =item SEE ALSO
 
 =item AUTHOR
@@ -8796,7 +8857,7 @@ operations
 
 =back
 
-=head2 open - perl pragma to set default disciplines for input and output
+=head2 open - perl pragma to set default PerlIO layers for input and output
 
 =over 4
 
@@ -8812,6 +8873,18 @@ operations
 
 =back
 
+=head2 ops - Perl pragma to restrict unsafe operations when compiling
+
+=over 4
+
+=item SYNOPSIS	
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=back
+
 =head2 overload - Package for overloading perl operations
 
 =over 4
@@ -8959,6 +9032,8 @@ B<untrapped>, B<any>, I<signal>, I<number>
 
 =item DESCRIPTION
 
+=item CAVEATS
+
 =back
 
 =head2 strict - Perl pragma to restrict unsafe constructs
@@ -8983,6 +9058,62 @@ C<strict refs>, C<strict vars>, C<strict subs>
 
 =back
 
+=head2 threads - Perl extension allowing use of interpreter based threads
+from perl
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+$thread = threads->create(function, LIST), $thread->join, $thread->detach,
+threads->self, $thread->tid, threads->object( tid ), threads->yield();,
+threads->list();, async BLOCK;
+
+=item WARNINGS
+
+A thread exited while %d other threads were still running
+
+=item TODO
+
+=item BUGS
+
+Parent-Child threads, Returning objects, Creating threads inside BEGIN
+blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
+
+=item AUTHOR and COPYRIGHT
+
+=item SEE ALSO
+
+=back
+
+=head2 threadshared, threads::shared - Perl extension for sharing data
+structures between threads
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item EXPORT
+
+=item FUNCTIONS
+
+share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
+cond_broadcast VARIABLE
+
+=item NOTES
+
+=item BUGS
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
 code
 
@@ -8996,12 +9127,14 @@ code
 
 =item Utility functions
 
-$num_octets = utf8::upgrade($string);, utf8::downgrade($string[, CHECK]),
+$num_octets = utf8::upgrade($string);, utf8::downgrade($string[, FAIL_OK]),
 utf8::encode($string), $flag = utf8::decode($string), $flag =
 utf8::valid(STRING)
 
 =back
 
+=item BUGS
+
 =item SEE ALSO
 
 =back
@@ -9571,6 +9704,8 @@ B<-u Package>
 
 =item IMPLEMENTATION
 
+=item BUGS
+
 =item AUTHOR
 
 =back
@@ -9631,6 +9766,26 @@ C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
 
 =back
 
+=head2 Bblock, B::Bblock - Walk basic blocks
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Functions
+
+B<find_leaders>
+
+=back
+
+=item AUTHOR
+
+=back
+
 =head2 Benchmark - benchmark running times of Perl code
 
 =over 4
@@ -9689,6 +9844,28 @@ disablecache ( ), enablecache ( ), timesum ( T1, T2 )
 
 =back
 
+=head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item OPTIONS
+
+B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
+B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
+B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
+
+=item EXAMPLES
+
+=item BUGS
+
+=item AUTHORS
+
+=back
+
 =head2 CGI - Simple Common Gateway Interface Class
 
 =over 4
@@ -10370,8 +10547,7 @@ C<asctime_r_proto>, C<awk>
 
 =item b
 
-C<baserev>, C<bash>, C<bin>, C<bincompat5005>, C<binexp>, C<bison>,
-C<byacc>, C<byteorder>
+C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
 
 =item c
 
@@ -10387,54 +10563,50 @@ C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
 
 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_alarm>, C<d_archlib>,
 C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>, C<d_bcmp>,
-C<d_bcopy>, C<d_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_crypt_r>, C<d_csh>, C<d_ctermid_r>,
-C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>,
-C<d_dirfd>, C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>,
-C<d_dosuid>, C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>,
-C<d_endgrent>, C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>,
-C<d_endnent>, C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>,
-C<d_endpwent>, C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>,
-C<d_eofnblk>, C<d_eunice>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>,
-C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>,
-C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>,
-C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>,
-C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>,
-C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>,
-C<d_fsync>, C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>,
-C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>, C<d_getgrent_r>,
-C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>, C<d_gethbyaddr>,
-C<d_gethbyname>, C<d_gethent>, C<d_gethname>, C<d_gethostbyaddr_r>,
-C<d_gethostbyname_r>, C<d_gethostent_r>, C<d_gethostprotos>,
-C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>, C<d_getmnt>,
-C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>, C<d_getnent>,
-C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>,
-C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
-C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
-C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>,
-C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
-C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>,
-C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>,
-C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>,
-C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
-C<d_htonl>, C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>,
-C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>, C<d_killpg>,
-C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>, C<d_locconv>,
-C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>,
-C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>,
-C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>,
-C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>,
-C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, C<d_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>
-
-=item n
-
-C<nv_preserves_uv_bits>, C<d_off64_t>, C<d_old_pthread_create_joinable>,
+C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>,
+C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>,
+C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>,
+C<d_crypt>, C<d_crypt_r>, C<d_csh>, C<d_ctermid_r>, C<d_ctime_r>,
+C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>,
+C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>,
+C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>,
+C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>, C<d_endnent>,
+C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>, C<d_endpwent>,
+C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>, C<d_eofnblk>,
+C<d_eunice>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>, C<d_fcntl>,
+C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>, C<d_fds_bits>,
+C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>, C<d_flock>,
+C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>, C<d_fpclass>,
+C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>,
+C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>,
+C<d_ftello>, C<d_ftime>, C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>,
+C<d_getfsstat>, C<d_getgrent>, C<d_getgrent_r>, C<d_getgrgid_r>,
+C<d_getgrnam_r>, C<d_getgrps>, C<d_gethbyaddr>, C<d_gethbyname>,
+C<d_gethent>, C<d_gethname>, C<d_gethostbyaddr_r>, C<d_gethostbyname_r>,
+C<d_gethostent_r>, C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>,
+C<d_getlogin_r>, C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>,
+C<d_getnbyname>, C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>,
+C<d_getnetent_r>, C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>,
+C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>,
+C<d_getppid>, C<d_getprior>, C<d_getprotobyname_r>,
+C<d_getprotobynumber_r>, C<d_getprotoent_r>, C<d_getprotoprotos>,
+C<d_getprpwnam>, C<d_getpwent>, C<d_getpwent_r>, C<d_getpwnam_r>,
+C<d_getpwuid_r>, C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>,
+C<d_getservbyname_r>, C<d_getservbyport_r>, C<d_getservent_r>,
+C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, C<d_gettimeod>,
+C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>,
+C<d_index>, C<d_inetaton>, C<d_int64_t>, C<d_isascii>, C<d_isfinite>,
+C<d_isinf>, C<d_isnan>, C<d_isnanl>, C<d_killpg>, C<d_lchown>,
+C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>, C<d_locconv>, C<d_lockf>,
+C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>, C<d_madvise>,
+C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>,
+C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>,
+C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>,
+C<d_modfl>, C<d_modfl_pow32_bug>, C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>,
+C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>,
+C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, C<d_msgsnd>,
+C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nl_langinfo>,
+C<d_nv_preserves_uv>, C<d_off64_t>, C<d_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>,
@@ -10503,7 +10675,8 @@ C<getprotobynumber_r_proto>, C<getprotoent_r_proto>, C<getpwent_r_proto>,
 C<getpwnam_r_proto>, C<getpwuid_r_proto>, C<getservbyname_r_proto>,
 C<getservbyport_r_proto>, C<getservent_r_proto>, C<getspnam_r_proto>,
 C<gidformat>, C<gidsign>, C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>,
-C<gmtime_r_proto>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
+C<gmtime_r_proto>, C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>,
+C<gzip>
 
 =item h
 
@@ -10559,11 +10732,15 @@ C<man3direxp>, C<man3ext>
 =item M
 
 C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
-C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>,
+C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
+
+=item n
+
 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
-C<nonxs_ext>, C<nroff>, C<nveformat>, C<nvEUformat>, C<nvfformat>,
-C<nvFUformat>, C<nvgformat>, C<nvGUformat>, C<nvsize>, C<nvtype>
+C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
+C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
+C<nvsize>, C<nvtype>
 
 =item o
 
@@ -10622,9 +10799,9 @@ C<ttyname_r_proto>
 
 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
-C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
-C<use64bitint>, C<usecrosscompile>, C<usedl>, C<useithreads>,
-C<uselargefiles>, C<uselongdouble>, C<usemorebits>, C<usemultiplicity>,
+C<uname>, C<uniq>, C<uquadtype>, C<use64bitall>, C<use64bitint>,
+C<usecrosscompile>, C<usedl>, C<useithreads>, C<uselargefiles>,
+C<uselongdouble>, C<usemorebits>, C<usemultiplicity>,
 C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>, C<useposix>,
 C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>,
 C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>,
@@ -11096,8 +11273,8 @@ stopDbSignal
 
 =item Methods
 
-dumpValue, dumpValues, dumpvars, set_quote, set_unctrl, compactDump,
-veryCompact, set, get
+dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
+compactDump, veryCompact, set, get
 
 =back
 
@@ -11140,45 +11317,72 @@ Perl code
 
 =item SYNOPSIS
 
+=over 4
+
+=item Table of Contents
+
+=back
+
 =item DESCRIPTION
 
+=over 4
+
+=item TERMINOLOGY
+
+=back
+
 =item PERL ENCODING API
 
+$octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
+$octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
+CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
+CHECK]);
+
 =over 4
 
-=item Generic Encoding Interface
+=item Listing available encodings
 
-$bytes	= encode(ENCODING, $string[, CHECK]), $string = decode(ENCODING,
-$bytes[, CHECK]), from_to($string, FROM_ENCODING, TO_ENCODING[, CHECK])
+=item Defining Aliases
 
-=item Handling Malformed Data
+=back
 
-Scheme 1, Scheme 2, Other Schemes
+=item Encoding via PerlIO
 
-=item UTF-8 / utf8
+=item Handling Malformed Data
 
-$bytes = encode_utf8($string);, $string = decode_utf8($bytes [, CHECK]);
+I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
+I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
+(I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
+Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
+bitmask
 
-=item Listing available encodings
+=over 4
 
-=item Defining Aliases
+=item Unimplemented fallback schemes
 
 =back
 
 =item Defining Encodings
 
-=item Encoding and IO
+=item The UTF-8 flag
+
+Goal #1:, Goal #2:, Goal #3:, Goal #4:
+
+=over 4
 
 =item Messing with Perl's Internals
 
 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
 
+=back
+
 =item SEE ALSO
 
+=item MAINTAINER
+
 =back
 
-=head2 Encode::lib::Encode::Alias, Encode::Alias - alias defintions to
-encodings
+=head2 Encode::Alias - alias definitions to encodings
 
 =over 4
 
@@ -11191,7 +11395,7 @@ reference, e.g.:
 
 =over 4
 
-=item  Alias overloading
+=item Alias overloading
 
 =back
 
@@ -11199,159 +11403,676 @@ reference, e.g.:
 
 =back
 
-=head2 Encode::lib::Encode::Details, Encode::Details - implementation
-details of Encode.pm
+=head2 Encode::Byte - Single Byte Encodings
 
 =over 4
 
-=item DESCRIPTION
+=item SYNOPSIS
 
-=over 4
+=item ABSTRACT
 
-=item TERMINOLOGY
+=item DESCRIPTION
+
+=item SEE ALSO
 
 =back
 
-=item ENCODINGS
+=head2	 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
 
-=over 4
+=head2 Encode::CN - China-based Chinese Encodings
 
-=item Characteristics of an Encoding
+=over 4
 
-=item Types of Encodings
+=item SYNOPSIS
 
-Fixed length 8-bit (or less) encodings, Fixed length 16-bit encodings,
-Fixed length 32-bit encodings, Multi-byte encodings, "Escape" encodings
+=item DESCRIPTION
 
-=item Specifying Encodings
+=item NOTES
 
-1. By name, 2. As an object
+=item BUGS
 
-=item Encoding Names
+=item SEE ALSO
 
-The MIME name as defined in IETF RFCs, The name in the IANA registry, The
-name used by the organization that defined it
+=back
 
-=item Encoding Classification
+=head2 Encode::CN::HZ -- internally used by Encode::CN
 
-=back
+=head2 Encode::Config -- internally used by Encode
 
-=item PERL ENCODING API
+=head2 Encode::EBCDIC - EBCDIC Encodings
 
 =over 4
 
-=item Generic Encoding Interface
-
-=item Handling Malformed Data
+=item SYNOPSIS
 
-Scheme 1, Scheme 2, Other Schemes
+=item ABSTRACT
 
-=item UTF-8 / utf8
+=item DESCRIPTION
 
-$bytes = encode_utf8($string);, $string = decode_utf8($bytes [,CHECK]);
+=item SEE ALSO
 
-=item Other Encodings of Unicode
+=back
 
-=item Listing available encodings
+=head2 Encode::Encoding - Encode Implementation Base Class
 
-=item Defining Aliases
+=over 4
 
-As a simple string, As a qr// compiled regular expression, e.g.:, As a code
-reference, e.g.:
+=item SYNOPSIS
 
-=item Defining Encodings
+=item DESCRIPTION
 
-=back
+=over 4
 
-=item Encoding and IO
+=item Methods you should implement
 
-=item Encoding How to ...
+-E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
 
-IO with mixed content (faking iso-2022-*), MIME's Content-Length:, UTF-8
-strings in binary data, Perl/Encode wrappers on non-Unicode XS modules
+=item Other methods defined in Encode::Encodings
 
-=item Messing with Perl's Internals
+-E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
 
-is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
+=item Example: Encode::ROT13
 
-=item IMPLEMENTATION CLASSES
+=back
 
--E<gt>name, -E<gt>new_sequence, -E<gt>encode($string,$check),
--E<gt>decode($octets,$check)
+=item Why the heck Encode API is different?
 
 =over 4
 
 =item Compiled Encodings
 
-.enc, .ucm, .ucm, .c, .xs, ascii and iso-8859-*, IBM-1047 and two other
-variants of EBCDIC, symbol and dingbats as used by Tk on X11
-
 =back
 
 =item SEE ALSO
 
+Scheme 1, Scheme 2, Other Schemes
+
 =back
 
-=head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
-Implementation Base Class
+=head2 Encode::Guess -- Guesses encoding from data
 
 =over 4
 
 =item SYNOPSIS
 
+=item ABSTRACT
+
 =item DESCRIPTION
 
--E<gt>name, -E<gt>new_sequence, -E<gt>encode($string,$check),
--E<gt>decode($octets,$check)
+Encode::Guess->set_suspects, Encode::Guess->add_suspects,
+Encode::decode("Guess" ...), Encode::Guess->guess($data),
+guess_encoding($data, [, I<list of suspects>])
 
-=over 4
+=item CAVEATS
 
-=item Compiled Encodings
+=item TO DO
 
-.enc, .ucm, .ucm, .c, .xs, ascii and iso-8859-*, IBM-1047 and two other
-variants of EBCDIC, symbol and dingbats as used by Tk on X11
+=item SEE ALSO
 
 =back
 
-=back
+=head2 Encode::JP - Japanese Encodings
 
-=head2 Encode::lib::Encode::Supported, Encode::Supports -- Supported
-encodings by Encode
+=over 4
+
+=item SYNOPSIS
+
+=item ABSTRACT
+
+=item DESCRIPTION
+
+=item Note on ISO-2022-JP(-1)?
+
+=item BUGS
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
+
+=head2 Encode::JP::JIS7 -- internally used by Encode::JP
+
+=head2 Encode::KR - Korean Encodings
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item BUGS
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::KR::2022_KR -- internally used by Encode::KR
+
+=head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
+
+=over 4
+
+=item SYNOPSIS
+
+=item ABSTRACT
+
+=item DESCRIPTION
+
+=item BUGS
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
+
+=over 4
+
+=item Overview
+
+=item How does it work?
+
+=item BUGS
+
+=over 4
+
+=item Workaround
+
+=item How can I tell whether my encoding fully supports PerlIO ?
+
+=back
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::Supported -- Encodings supported by Encode
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item Encoding Names
+
+=back
+
+=item Supported Encodings
+
+=over 4
+
+=item Built-in Encodings
+
+=item Encode::Unicode -- other Unicode encodings
+
+=item Encode::Byte -- Extended ASCII
+
+ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
+the Cyrillic world, gsm0338 - Hentai Latin 1
+
+=item CJK: Chinese, Japanese, Korean (Multibyte)
+
+Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
+Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
+Encode::JIS2K -- JIS X 0213 encodings via CPAN
+
+=item Miscellaneous encodings
+
+Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
+
+=back
+
+=item Unsupported encodings
+
+  ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
+Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
+System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
+Various Mac encodings, (Mac) Indic encodings
+
+=item Encoding vs. Charset -- terminology
+
+=item Encoding Classification (by Anton Tagunov and Dan Kogai)
+
+=over 4
+
+=item Microsoft-related naming mess
+
+KS_C_5601-1987, GB2312, Big5, Shift_JIS
+
+=back
+
+=item Glossary
+
+character repertoire, coded character set (CCS), character encoding scheme
+(CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
+UTF-16
+
+=item See Also
+
+=item References
+
+ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
+RFC, UC, Unicode Glossary
+
+=over 4
+
+=item Other Notable Sites
+
+czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
+"Introduction to i18n"
+
+=item Offline sources
+
+C<CJKV Information Processing> by Ken Lunde
+
+=back
+
+=back
+
+=head2 Encode::Symbol - Symbol Encodings
+
+=over 4
+
+=item SYNOPSIS
+
+=item ABSTRACT
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::TW - Taiwan-based Chinese Encodings
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item NOTES
+
+=item BUGS
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::Unicode -- Various Unicode Transformation Formats
+
+=over 4
+
+=item SYNOPSIS
+
+=item ABSTRACT
+
+L<http://www.unicode.org/glossary/> says:, Quick Reference
+
+=item Size, Endianness, and BOM
+
+=over 4
+
+=item by size
+
+=item by endianness
+
+BOM as integer when fetched in network byte order
+
+=back
+
+=item Surrogate Pairs
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
+encodings
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+As a simple string, As a qr// compiled regular expression, e.g.:, As a code
+reference, e.g.:
+
+=over 4
+
+=item Alias overloading
+
+=back
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::lib::Encode::CJKConstants,   Encode::CJKConstants.pm --
+Internally used by Encode::??::ISO_2022_*
+
+=head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
+Encode::CN
+
+=head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
+Encode
+
+=head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
+Implementation Base Class
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Methods you should implement
+
+-E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check])
+
+=item Other methods defined in Encode::Encodings
+
+-E<gt>name, -E<gt>new_sequence, -E<gt>perlio_ok(), -E<gt>needs_lines()
+
+=item Example: Encode::ROT13
+
+=back
+
+=item Why the heck Encode API is different?
+
+=over 4
+
+=item Compiled Encodings
+
+=back
+
+=item SEE ALSO
+
+Scheme 1, Scheme 2, Other Schemes
+
+=back
+
+=head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
+data
+
+=over 4
+
+=item SYNOPSIS
+
+=item ABSTRACT
+
+=item DESCRIPTION
+
+Encode::Guess->set_suspects, Encode::Guess->add_suspects,
+Encode::decode("Guess" ...), Encode::Guess->guess($data),
+guess_encoding($data, [, I<list of suspects>])
+
+=item CAVEATS
+
+=item TO DO
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
+Encode::JP::2022_JP*
+
+=head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
+by Encode::JP
+
+=head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
+used by Encode::KR
+
+=head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
+and 'Q' header encoding
+
+=over 4
+
+=item SYNOPSIS
+
+=item ABSTRACT
+
+=item DESCRIPTION
+
+=item BUGS
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
+on Encode and PerlIO
+
+=over 4
+
+=item Overview
+
+=item How does it work?
+
+=item BUGS
+
+=over 4
+
+=item Workaround
+
+=item How can I tell whether my encoding fully supports PerlIO ?
+
+=back
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
+supported by Encode
+
+=over 4
+
+=item DESCRIPTION
+
+=over 4
+
+=item Encoding Names
+
+=back
+
+=item Supported Encodings
+
+=over 4
+
+=item Built-in Encodings
+
+=item Encode::Unicode -- other Unicode encodings
+
+=item Encode::Byte -- Extended ASCII
+
+ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
+the Cyrillic world, gsm0338 - Hentai Latin 1
+
+=item CJK: Chinese, Japanese, Korean (Multibyte)
+
+Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
+Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
+Encode::JIS2K -- JIS X 0213 encodings via CPAN
+
+=item Miscellaneous encodings
+
+Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
+
+=back
+
+=item Unsupported encodings
+
+  ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
+Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
+System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
+Various Mac encodings, (Mac) Indic encodings
+
+=item Encoding vs. Charset -- terminology
+
+=item Encoding Classification (by Anton Tagunov and Dan Kogai)
+
+=over 4
+
+=item Microsoft-related naming mess
+
+KS_C_5601-1987, GB2312, Big5, Shift_JIS
+
+=back
+
+=item Glossary
+
+character repertoire, coded character set (CCS), character encoding scheme
+(CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
+UTF-16
+
+=item See Also
+
+=item References
+
+ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
+RFC, UC, Unicode Glossary
+
+=over 4
+
+=item Other Notable Sites
+
+czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
+"Introduction to i18n"
+
+=item Offline sources
+
+C<CJKV Information Processing> by Ken Lunde
+
+=back
+
+=back
+
+=head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
+
+=over 4
+
+=item SYNOPSIS
+
+  use Encode::Encoder;
+  # Encode::encode("ISO-8859-1", $data); 
+  Encode::Encoder->new($data)->iso_8859_1; # OOP way
+  # shortcut
+  use Encode::Encoder qw(encoder);
+  encoder($data)->iso_8859_1;
+  # you can stack them!
+  encoder($data)->iso_8859_1->base64;  # provided base64() is defined
+  # you can use it as a decoder as well
+  encoder($base64)->bytes('base64')->latin1;
+  # stringified
+  print encoder($data)->utf8->latin1;  # prints the string in latin1
+  # numified
+  encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
+
+=item ABSTRACT
+
+=item Description
+
+=over 4
+
+=item Predefined Methods
+
+$e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
+$e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
+$e-E<gt>bytes([$encoding])
+
+=item Example: base64 transcoder
+
+=item Operator Overloading
+
+=back
+
+=item SEE ALSO
+
+=back
+
+=head2 Encodencoding, encoding - allows you to write your script in
+non-ascii or non-utf8
+
+=over 4
+
+=item SYNOPSIS
+
+=item ABSTRACT
+
+=item USAGE
+
+use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
+I<ENCNAME_IN> ...] ;, no encoding;
+
+=item CAVEATS
 
 =over 4
 
-=item DESCRIPTION
+=item NOT SCOPED
 
-=over 4
+=item DO NOT MIX MULTIPLE ENCODINGS
 
-=item Encoding Names
+=back
+
+=item Non-ASCII Identifiers and Filter option
+
+use encoding I<ENCNAME> Filter=E<gt>1;
+
+=item EXAMPLE - Greekperl
+
+=item KNOWN PROBLEMS
+
+=item SEE ALSO
 
 =back
 
-=item Supported Encodings
+=head2 Encoder, Encode::Encoder -- Object Oriented Encoder
 
 =over 4
 
-=item Built-in Encodings
+=item SYNOPSIS
 
-=item Encode::Byte
+  use Encode::Encoder;
+  # Encode::encode("ISO-8859-1", $data); 
+  Encode::Encoder->new($data)->iso_8859_1; # OOP way
+  # shortcut
+  use Encode::Encoder qw(encoder);
+  encoder($data)->iso_8859_1;
+  # you can stack them!
+  encoder($data)->iso_8859_1->base64;  # provided base64() is defined
+  # you can use it as a decoder as well
+  encoder($base64)->bytes('base64')->latin1;
+  # stringified
+  print encoder($data)->utf8->latin1;  # prints the string in latin1
+  # numified
+  encoder("\x{abcd}\x{ef}g")->utf8 == 6; # true. bytes::length($data)
 
-=item The CJK: Chinese, Japanese, Korean (Multibyte)
+=item ABSTRACT
 
-Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
-Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN
+=item Description
 
-=item Miscellaneous encodings
+=over 4
 
-Encode::EBCDIC, Encode::Symbols
+=item Predefined Methods
 
-=back
+$e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
+$e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
+$e-E<gt>bytes([$encoding])
 
-=item Encoding vs. Charset
+=item Example: base64 transcoder
 
-=item Encoding Classification (by Anton Tagunov and Dan Kogai)
+=item Operator Overloading
 
-=item See Also
+=back
+
+=item SEE ALSO
 
 =back
 
@@ -11383,6 +12104,22 @@ arrays
 
 =back
 
+=head2 Errno - System errno constants
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CAVEATS
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
 =head2 Exporter - Implements default import method for modules
 
 =over 4
@@ -11476,6 +12213,18 @@ test_f file
 
 =back
 
+=head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+B<test_harness>
+
+=back
+
 =head2 ExtUtils::Constant - generate XS code to import C header constants
 
 =over 4
@@ -11592,7 +12341,8 @@ packlist(), version()
 
 =item DESCRIPTION
 
-For static extensions, For dynamic extensions, For dynamic extensions
+For static extensions, For dynamic extensions at build/link time, For
+dynamic extensions at load time
 
 =over 4
 
@@ -11618,6 +12368,66 @@ For static extensions, For dynamic extensions, For dynamic extensions
 
 =back
 
+=head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
+=head2 ExtUtils::MM_Any - Platform agnostic MM methods
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item Inherently Cross-Platform Methods
+
+=over 4
+
+=item File::Spec wrappers  B<DEPRECATED>
+
+canonpath
+
+=back
+
+=back
+
+catdir
+
+catfile
+
+curdir
+
+file_name_is_absolute
+
+path
+
+rootdir
+
+updir
+
+=over 4
+
+=item Thought To Be Cross-Platform Methods
+
+test_via_harness
+
+=back
+
+test_via_script
+
+=over 4
+
+=item AUTHOR
+
+=back
+
 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
 ExtUtils::MakeMaker
 
@@ -11644,7 +12454,33 @@ canonpath, cflags, manifypods, perl_archive
 
 =back
 
-=head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
+=head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Overridden methods
+
+B<replace_manpage_separator>
+
+=back
+
+=back
+
+=over 4
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
+=head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
 ExtUtils::MakeMaker
 
 =over 4
@@ -11655,41 +12491,54 @@ ExtUtils::MakeMaker
 
 =back
 
-catfile
+maybe_command
 
-constants (o)
+guess_name
 
-static_lib (o)
+macify
 
-dynamic_bs (o)
+patternify
 
-dynamic_lib (o)
+init_main
 
-canonpath
+init_others
 
-perl_script
+init_dirscan
 
-pm_to_blib
+libscan (o)
 
-test_via_harness (o)
+constants (o)
 
-tool_autosplit (override)
+static (o)
 
-tools_other (o)
+dlsyms (o)
 
-xs_o (o)
+dynamic (o)
 
-top_targets (o)
+clean (o)
 
-htmlifypods (o)
+realclean (o)
 
-manifypods (o)
+rulez (o)
 
-dist_ci (o)
+processPL (o)
 
-dist_core (o)
+=head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
+ExtUtils::MakeMaker
 
-pasthru (o)
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
+constants (o)
+
+static_lib (o)
+
+dynamic_lib (o)
 
 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
 ExtUtils::MakeMaker
@@ -11706,7 +12555,7 @@ ExtUtils::MakeMaker
 
 perl_archive_after
 
-=head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
+=head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
 
 =over 4
 
@@ -11714,27 +12563,35 @@ perl_archive_after
 
 =item DESCRIPTION
 
-=item METHODS
-
 =over 4
 
-=item Preloaded methods
+=item Overridden methods
 
-canonpath
+B<replace_manpage_separator>
 
 =back
 
 =back
 
-catdir
+=over 4
 
-catfile
+=item AUTHOR
 
-curdir
+=item SEE ALSO
 
-rootdir
+=back
 
-updir
+=head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item METHODS
+
+=back
 
 =over 4
 
@@ -11768,9 +12625,9 @@ dist_ci (o)
 
 dist_core (o)
 
-dist_dir (o)
+dist_dir
 
-dist_test (o)
+dist_test
 
 dlsyms (o)
 
@@ -11784,10 +12641,10 @@ exescan
 
 extliblist
 
-file_name_is_absolute
-
 find_perl
 
+find_tests
+
 =over 4
 
 =item Methods to actually produce chunks of text for the Makefile
@@ -11802,14 +12659,22 @@ guess_name
 
 has_link_code
 
-htmlifypods (o)
-
 init_dirscan
 
 init_main
 
 init_others
 
+init_INST
+
+init_INSTALL
+
+init_lib2arch
+
+init_PERL
+
+init_PERM
+
 install (o)
 
 installbin (o)
@@ -11836,20 +12701,16 @@ needs_linking (o)
 
 nicetext
 
-parse_version
-
 parse_abstract
 
-pasthru (o)
+parse_version
 
-path
+pasthru (o)
 
 perl_script
 
 perldepend (o)
 
-ppd
-
 perm_rw (o)
 
 perm_rwx (o)
@@ -11862,6 +12723,8 @@ post_initialize (o)
 
 postamble (o)
 
+ppd
+
 prefixify
 
 processPL (o)
@@ -11884,9 +12747,9 @@ subdirs (o)
 
 test (o)
 
-test_via_harness (o)
+test_via_harness (override)
 
-test_via_script (o)
+test_via_script (override)
 
 tool_autosplit (o)
 
@@ -11935,11 +12798,9 @@ wraplist
 
 =back
 
-rootdir (override)
-
 =over 4
 
-=item SelfLoaded methods
+=item Methods
 
 guess_name (override)
 
@@ -11947,18 +12808,16 @@ guess_name (override)
 
 find_perl (override)
 
-path (override)
-
 maybe_command (override)
 
 maybe_command_in_dirs (override)
 
 perl_script (override)
 
-file_name_is_absolute (override)
-
 replace_manpage_separator
 
+init_main (override)
+
 init_others (override)
 
 constants (override)
@@ -12007,12 +12866,8 @@ clean (override)
 
 realclean (override)
 
-dist_basics (override)
-
 dist_core (override)
 
-dist_dir (override)
-
 dist_test (override)
 
 install (override)
@@ -12021,16 +12876,16 @@ perldepend (override)
 
 makefile (override)
 
-test (override)
-
-test_via_harness (override)
+find_tests (override)
 
-test_via_script (override)
+test (override)
 
 makeaperl (override)
 
 nicetext (override)
 
+prefixify (override)
+
 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
 ExtUtils::MakeMaker
 
@@ -12042,8 +12897,6 @@ ExtUtils::MakeMaker
 
 =back
 
-catfile
-
 constants (o)
 
 static_lib (o)
@@ -12052,14 +12905,10 @@ dynamic_bs (o)
 
 dynamic_lib (o)
 
-canonpath
-
 perl_script
 
 pm_to_blib
 
-test_via_harness (o)
-
 tool_autosplit (override)
 
 tools_other (o)
@@ -12068,8 +12917,6 @@ xs_o (o)
 
 top_targets (o)
 
-htmlifypods (o)
-
 manifypods (o)
 
 dist_ci (o)
@@ -12078,6 +12925,26 @@ dist_core (o)
 
 pasthru (o)
 
+=head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
+=head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
 =head2 ExtUtils::MakeMaker - create an extension Makefile
 
 =over 4
@@ -12112,20 +12979,21 @@ pasthru (o)
 
 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,
-INSTALLDIRS, INSTALLHTMLPRIVLIBDIR, INSTALLHTMLSCRIPTDIR,
-INSTALLHTMLSITELIBDIR, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
-INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITELIB, INST_ARCHLIB, INST_BIN,
-INST_EXE, INST_HTMLLIBDIR, INST_HTMLSCRIPTDIR, INST_LIB, INST_MAN1DIR,
-INST_MAN3DIR, INST_SCRIPT, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE,
-MAKEAPERL, MAKEFILE, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME,
-NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE, PERL, PERL_CORE,
-PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLRUN, PERM_RW,
-PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
-PPM_INSTALL_SCRIPT, PREFIX, PREREQ_PM, PREREQ_FATAL, PREREQ_PRINT,
-PRINT_PREREQ, SKIP, TEST_LIBS, VERSION, VERSION_FROM, XS, XSOPT,
-XSPROTOARG, XS_VERSION
+EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN, FULLPERLRUNINST,
+FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB, INSTALLBIN,
+INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB, INSTALLSCRIPT,
+INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB, INSTALLSITEMAN1DIR,
+INSTALLSITEMAN3DIR, INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB,
+INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN,
+INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT, LDDLFLAGS, LDFROM, LIB,
+LIBPERL_A, LIBS, LINKTYPE, 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, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX,
+PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
+PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT,
+PRINT_PREREQ, SITEPREFIX, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION,
+VERSION_FROM, XS, XSOPT, XSPROTOARG, XS_VERSION
 
 =item Additional lowercase attributes
 
@@ -12134,13 +13002,17 @@ tool_autosplit
 
 =item Overriding MakeMaker Methods
 
+=item The End Of Cargo Cult Programming
+
+C<<MAN3PODS => ' '>>
+
 =item Hintsfile support
 
 =item Distribution Support
 
    make distcheck,    make skipcheck,	 make distclean,    make manifest, 
-  make distdir,    make tardist,    make dist,	  make uutardist,    make
-shdist,    make zipdist,    make ci
+  make distdir,   make disttest,    make tardist,    make dist,    make
+uutardist,    make shdist,    make zipdist,    make ci
 
 =item Disabling an extension
 
@@ -12172,8 +13044,8 @@ PERL_MM_OPT, PERL_MM_USE_DEFAULT
 
 =item DIAGNOSTICS
 
-C<Not in MANIFEST:> I<file>, C<No such file:> I<file>, C<MANIFEST:> I<$!>,
-C<Added to MANIFEST:> I<file>
+C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
+C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
 
 =item ENVIRONMENT
 
@@ -12185,6 +13057,18 @@ B<PERL_MM_MANIFEST_DEBUG>
 
 =back
 
+=head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=back
+
 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
 
 =over 4
@@ -12292,6 +13176,10 @@ C<basename>, C<dirname>
 
 =item DESCRIPTION
 
+=item AUTHOR
+
+=item HISTORY
+
 =back
 
 =head2 File::Compare - Compare files or filehandles
@@ -12699,6 +13587,12 @@ catpath
 
 =over 4
 
+=item Note For File::Spec::Win32 Maintainers
+
+=back
+
+=over 4
+
 =item SEE ALSO
 
 =back
@@ -12801,6 +13695,8 @@ TopSystemUID
 
 =item DESCRIPTION
 
+=item BUGS
+
 =item NOTE
 
 =item AUTHOR
@@ -12815,6 +13711,10 @@ TopSystemUID
 
 =item DESCRIPTION
 
+cacheout EXPR, cacheout MODE, EXPR
+
+=item CAVEATS
+
 =item BUGS
 
 =back
@@ -13001,6 +13901,8 @@ B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
 
 =item Object oriented interface
 
+=item Thread Safety
+
 =item Documentation and help texts
 
 =item Storing options in a hash
@@ -13313,15 +14215,252 @@ Zhuang, {zu} : Zulu, {zun} : Zuni
 
 =item COPYRIGHT AND LICENSE
 
-=back
+=back
+
+=head2 IO - load various IO modules
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=back
+
+=head2 IO::Dir - supply object methods for directory handles
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
+rewind (), close (), tie %hash, IO::Dir, DIRNAME [, OPTIONS ]
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
+=head2 IO::File - supply object methods for filehandles
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONSTRUCTOR
+
+new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
+
+=item METHODS
+
+open( FILENAME [,MODE [,PERMS]] )
+
+=item SEE ALSO
+
+=item HISTORY
+
+=back
+
+=head2 IO::Handle - supply object methods for I/O handles
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONSTRUCTOR
+
+new (), new_from_fd ( FD, MODE )
+
+=item METHODS
+
+$io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
+$io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
+$io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
+$io->blocking ( [ BOOL ] ), $io->untaint
+
+=item NOTE
+
+=item SEE ALSO
+
+=item BUGS
+
+=item HISTORY
+
+=back
+
+=head2 IO::Pipe - supply object methods for pipes
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONSTRUCTOR
+
+new ( [READER, WRITER] )
+
+=item METHODS
+
+reader ([ARGS]), writer ([ARGS]), handles ()
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
+=head2 IO::Poll - Object interface to system poll call
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item METHODS
+
+mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
+IO ), handles( [ EVENT_MASK ] )
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
+=head2 IO::Seekable - supply seek based methods for I/O objects
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+$io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
+WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
+$io->tell
+
+=item SEE ALSO
+
+=item HISTORY
+
+=back
+
+=head2 IO::Select - OO interface to the select system call
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONSTRUCTOR
+
+new ( [ HANDLES ] )
+
+=item METHODS
+
+add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
+[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
+count (), bits(), select ( READ, WRITE, ERROR [, TIMEOUT ] )
+
+=item EXAMPLE
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
+=head2 IO::Socket - Object interface to socket communications
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONSTRUCTOR
+
+new ( [ARGS] )
+
+=item METHODS
+
+accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
+protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
+=head2 IO::Socket::INET - Object interface for AF_INET domain sockets
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONSTRUCTOR
+
+new ( [ARGS] )
+
+=over 4
+
+=item METHODS
+
+sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
+()
+
+=back
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
+=head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONSTRUCTOR
+
+new ( [ARGS] )
+
+=item METHODS
 
-=head2 IO - load various IO modules
+hostpath(), peerpath()
 
-=over 4
+=item SEE ALSO
 
-=item SYNOPSIS
+=item AUTHOR
 
-=item DESCRIPTION
+=item COPYRIGHT
 
 =back
 
@@ -13569,6 +14708,28 @@ hostpath(), peerpath()
 
 =back
 
+=head2 IPC::Msg - SysV Msg IPC object class
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item METHODS
+
+new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
+( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
+FLAGS ] ), stat
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
 =head2 IPC::Open2, open2 - open a process for both reading and writing
 
 =over 4
@@ -13596,6 +14757,29 @@ handling
 
 =back
 
+=head2 IPC::Semaphore - SysV Semaphore IPC object class
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item METHODS
+
+new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
+getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
+set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
+, VALUE ), stat
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
 =head2 IPC::SysV - SysV IPC constants
 
 =over 4
@@ -13660,6 +14844,25 @@ set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
 
 =back
 
+=head2 List::Util - A selection of general-utility list subroutines
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
+BLOCK LIST, shuffle LIST, sum LIST
+
+=item KNOWN BUGS
+
+=item SUGGESTED ADDITIONS
+
+=item COPYRIGHT
+
+=back
+
 =head2 List::Utilib::List::Util, List::Util - A selection of
 general-utility list subroutines
 
@@ -13760,7 +14963,7 @@ C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
-http://www.cia.gov/cia/publications/factbook/docs/app-f.html
+http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
 
 =item AUTHOR
 
@@ -13998,6 +15201,21 @@ encode_qp($str), decode_qp($str);
 
 =back
 
+=head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
+strings
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+encode_qp($str), decode_qp($str);
+
+=item COPYRIGHT
+
+=back
+
 =head2 Math::BigFloat - Arbitrary size floating point math package
 
 =over 4
@@ -14118,6 +15336,10 @@ Canonical notation, Input, Output
 
 =item bmod
 
+=item bmodinv
+
+=item bmodpow
+
 =item bpow
 
 =item blsft
@@ -14287,15 +15509,23 @@ the same terms as Perl itself.
 
 =over 4
 
-=item new
+=item new()
 
-=item numerator
+=item numerator()
 
-=item denominator
+=item denominator()
 
 	$d = $x->denominator();
 
-=item parts
+=item parts()
+
+=item as_number()
+
+=item bfac()
+
+=item blog()
+
+=item bround()/round()/bfround()
 
 =back
 
@@ -14393,7 +15623,7 @@ cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
 
 =back
 
-=head2 Memoize - Make your functions faster by trading space for time
+=head2 Memoize - Make functions faster by trading space for time
 
 =over 4
 
@@ -14783,9 +16013,10 @@ MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
 
 =item Functions
 
-Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);,
-$p->bind($local_addr);, $p->ping($host [, $timeout]);, $p->open($host);,
-$p->open($host);, $p->close();, pingecho($host [, $timeout]);
+Net::Ping->new([$proto [, $def_timeout [, $bytes]]]);, $p->ping($host [,
+$timeout]);, $p->source_verify( { 0 | 1 } );, $p->hires( { 0 | 1 } );,
+$p->bind($local_addr);, $p->open($host);, $p->close();, pingecho($host [,
+$timeout]);
 
 =back
 
@@ -14793,6 +16024,8 @@ $p->open($host);, $p->close();, pingecho($host [, $timeout]);
 
 =item NOTES
 
+=item INSTALL
+
 =item AUTHORS
 
 =item COPYRIGHT
@@ -14823,6 +16056,8 @@ ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
 quit ()
 
+=item ADDRESSES
+
 =item SEE ALSO
 
 =item AUTHOR
@@ -15044,6 +16279,24 @@ login (), password (), account (), lpa ()
 
 =back
 
+=head2 O - Generic interface to Perl Compiler backends
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item CONVENTIONS
+
+=item IMPLEMENTATION
+
+=item BUGS
+
+=item AUTHOR
+
+=back
+
 =head2 ODBM_File - Tied access to odbm files
 
 =over 4
@@ -15297,10 +16550,12 @@ name space
 
 =item DESCRIPTION
 
-unix, stdio, perlio, crlf, utf8, raw
+unix, stdio, perlio, crlf, utf8, bytes, raw, pop
 
 =over 4
 
+=item Alternatives to raw
+
 =item Defaults and how to override them
 
 =back
@@ -15311,7 +16566,19 @@ unix, stdio, perlio, crlf, utf8, raw
 
 =back
 
-=head2 PerlIO::Scalar - support module for in-memory IO.
+=head2 PerlIO::encoding - encoding layer
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=back
+
+=head2 PerlIO::scalar - support module for in-memory IO.
 
 =over 4
 
@@ -15321,7 +16588,7 @@ unix, stdio, perlio, crlf, utf8, raw
 
 =back
 
-=head2 PerlIO::Via - Helper class for PerlIO layers implemented in perl
+=head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
 
 =over 4
 
@@ -15329,13 +16596,18 @@ unix, stdio, perlio, crlf, utf8, raw
 
 =item DESCRIPTION
 
+=item EXPECTED METHODS
+
 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
-$class->OPEN($path,$mode[,$fh]), $class->FDOPEN($fd),
-$class->SYSOPEN($path,$imode,$perm,$fh), $obj->FILENO($fh),
-$obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
-$obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
-$obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
-$obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
+$obj->OPEN($path,$mode[,$fh]), $obj->BINMODE([,$fh]),
+$obj->FDOPEN($fd[,$fh]), $obj->SYSOPEN($path,$imode,$perm,[,$fh]),
+$obj->FILENO($fh), $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh),
+$obj->FILL($fh), $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh),
+$obj->TELL($fh), $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh),
+$obj->SETLINEBUF($fh), $obj->CLEARERR($fh), $obj->ERROR($fh),
+$obj->EOF($fh)
+
+=item EXAMPLES
 
 =over 4
 
@@ -15345,6 +16617,20 @@ $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
 
 =back
 
+=head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=item COPYRIGHT
+
+=back
+
 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
 
 =over 4
@@ -15381,7 +16667,7 @@ after =back
 
 =item Warnings
 
-multiple occurence of link target I<name>, line containing nothing but
+multiple occurrence of link target I<name>, line containing nothing but
 whitespace in paragraph, file does not start with =head, previous =item has
 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
@@ -15880,7 +17166,7 @@ escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
 
 =back
 
-=head2 Pod::ParseLink -- Parse an LE<lt>E<gt> formatting code in POD text
+=head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
 
 =over 4
 
@@ -15888,6 +17174,8 @@ escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
 
 =item DESCRIPTION
 
+=item SEE ALSO
+
 =item AUTHOR
 
 =item COPYRIGHT AND LICENSE
@@ -16430,8 +17718,8 @@ text
 
 =back
 
-=head2 Pod::Text::Termcap, Pod::Text::Color - Convert POD data to ASCII
-text with format escapes
+=head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
+escapes
 
 =over 4
 
@@ -16578,6 +17866,58 @@ C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
 
 =back
 
+=head2 Safe - Compile and execute code in restricted compartments
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+a new namespace, an operator mask
+
+=item WARNING
+
+=over 4
+
+=item RECENT CHANGES
+
+=item Methods in class Safe
+
+permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
+...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
+(PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
+root (NAMESPACE), mask (MASK)
+
+=item Some Safety Issues
+
+Memory, CPU, Snooping, Signals, State Changes
+
+=item AUTHOR
+
+=back
+
+=back
+
+=head2 Scalar::Util - A selection of general-utility scalar subroutines
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+blessed EXPR, dualvar NUM, STRING, isweak EXPR, openhandle FH, reftype
+EXPR, tainted EXPR, weaken REF
+
+=item KNOWN BUGS
+
+=item COPYRIGHT
+
+=item BLATANT PLUG
+
+=back
+
 =head2 Search::Dict, look - search for key in dictionary file
 
 =over 4
@@ -16661,7 +18001,7 @@ SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
 
 =back
 
-=head2 Storable - persistency for perl data structures
+=head2 Storable - persistence for Perl data structures
 
 =over 4
 
@@ -16677,6 +18017,10 @@ SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
 
 =item CANONICAL REPRESENTATION
 
+=item FORWARD COMPATIBILITY
+
+utf8 data, restricted hashes, files from future versions of Storable
+
 =item ERROR REPORTING
 
 =item WIZARDS ONLY
@@ -16707,9 +18051,13 @@ C<Storable::is_retrieving>
 
 =item BUGS
 
-=item CREDITS
+=over 4
 
-=item TRANSLATIONS
+=item 64 bit data in perl 5.6.0 and 5.6.1
+
+=back
+
+=item CREDITS
 
 =item AUTHOR
 
@@ -16775,6 +18123,27 @@ C<Storable::is_retrieving>
 
 =back
 
+=head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
+interface to the UNIX syslog(3) calls
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
+setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
+in 5.004_02), closelog
+
+=item EXAMPLES
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=back
+
 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
 Perl interface to the UNIX syslog(3) calls
 
@@ -16822,7 +18191,7 @@ ANSI_COLORS_DISABLED
 
 =item AUTHORS
 
-=item LICENSE
+=item COPYRIGHT AND LICENSE
 
 =back
 
@@ -16996,6 +18365,8 @@ B<isnt_eq>, B<isnt_num>
 
 B<like>, B<unlike>
 
+B<maybe_regex>
+
 B<cmp_ok>
 
 B<BAILOUT>
@@ -17052,6 +18423,8 @@ B<_my_exit>
 
 =over 4
 
+=item THREADS
+
 =item EXAMPLES
 
 =item SEE ALSO
@@ -17116,13 +18489,13 @@ B<_leader_width>
 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
-%s>, C<FAILED--Further testing stopped%s>
+%s>, C<FAILED--Further testing stopped: %s>
 
 =item ENVIRONMENT
 
-C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>, C<HARNESS_COMPILE_TEST>,
-C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_COLUMNS>,
-C<HARNESS_ACTIVE>
+C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
+C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
+C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
 
 =item EXAMPLE
 
@@ -17314,6 +18687,8 @@ B<SKIP: BLOCK>
 
 B<TODO: BLOCK>, B<todo_skip>
 
+When do I use SKIP vs. TODO?
+
 =over 4
 
 =item Comparison functions
@@ -17570,7 +18945,7 @@ unexpand(1)
 
 =back
 
-=head2 Thread - manipulate threads in Perl
+=head2 Thread - manipulate threads in Perl (for old code only)
 
 =over 4
 
@@ -17627,9 +19002,12 @@ new, new NUMBER, down, down NUMBER, up, up NUMBER
 =back
 
 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
+(for old code)
 
 =over 4
 
+=item CAVEAT
+
 =item SYNOPSIS
 
 =item DESCRIPTION
@@ -17699,7 +19077,7 @@ SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
 
 =item C<autochomp>
 
-=item C<defer>, C<flush>, and C<discard>
+=item C<defer>, C<flush>, C<discard>, and C<autodefer>
 
 =back
 
@@ -17707,11 +19085,13 @@ SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
 
 =item Deferred Writing
 
-=item CAVEATS
+=over 4
+
+=item Autodeferring
+
+=back
 
-You might be tempted to think that deferred writing is like transactions,
-with C<flush> as C<commit> and C<discard> as C<rollback>, but it isn't, so
-don't
+=item CAVEATS
 
 =item SUBCLASSING
 
@@ -17931,7 +19311,7 @@ $obj->isa( TYPE ), CLASS->isa( TYPE ), isa( VAL, TYPE ), $obj->can( METHOD
 
 =back
 
-=head2 Unicode::Collate - use UCA (Unicode Collation Algorithm)
+=head2 Unicode::Collate - Unicode Collation Algorithm
 
 =over 4
 
@@ -17947,34 +19327,44 @@ alternate, backwards, entry, ignoreName, ignoreChar, level, normalization,
 overrideCJK, overrideHangul, preprocess, rearrange, table, undefName,
 undefChar, katakana_before_hiragana, upper_before_lower
 
-=item Other methods
+=item Methods for Collation
 
 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 =
+C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
+$Collator-E<gt>viewSortKey($string)>, C<$position =
 $Collator-E<gt>index($string, $substring)>, C<($position, $length) =
 $Collator-E<gt>index($string, $substring)>
 
+=item Other Methods
+
+UCA_Version, Base_Unicode_Version
+
 =item EXPORT
 
 =item TODO
 
 =item CAVEAT
 
+=item BUGS
+
 =back
 
 =item AUTHOR
 
 =item SEE ALSO
 
-Unicode Collation Algorithm - Unicode TR #10, L<Unicode::Normalize>
+http://www.unicode.org/unicode/reports/tr10/,
+http://www.unicode.org/unicode/reports/tr10/allkeys.txt,
+http://www.unicode.org/unicode/reports/tr15/,
+http://www.unicode.org/unicode/reports/tr18, L<Unicode::Normalize>
 
 =back
 
-=head2 Unicode::Normalize - normalized forms of Unicode text
+=head2 Unicode::Normalize - Unicode Normalization Forms
 
 =over 4
 
@@ -18021,7 +19411,7 @@ C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
 =item SEE ALSO
 
 http://www.unicode.org/unicode/reports/tr15/,
-http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProperties.txt
+http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt
 
 =back
 
@@ -18171,7 +19561,7 @@ Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFullPathName(FILENAME),
 Win32::GetLastError(), Win32::GetLongPathName(PATHNAME),
-Win32::GetNextAvailDrive(), Win32::GetOSVersion(),
+Win32::GetNextAvailDrive(), Win32::GetOSVersion(), Win32::GetOSName(),
 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
@@ -18187,24 +19577,6 @@ Win32::UnregisterServer(LIBRARYNAME)
 
 =back
 
-=head2 XS::Typemap - module to test the XS typemaps distributed with perl
-
-=over 4
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=back
-
-=over 4
-
-=item NOTES
-
-=item AUTHOR
-
-=back
-
 =head2 XSLoader - Dynamically load C libraries into Perl code
 
 =over 4