a test for B::Xref
[p5sagit/p5-mst-13.2.git] / pod / perltoc.pod
index 806e12f..94c2207 100644 (file)
@@ -101,8 +101,8 @@ Parentheses for capturing, Other regexp features
 
 =back
 
-=head2 perlfaq - frequently asked questions about Perl ($Date: 2002/01/31
-04:27:54 $)
+=head2 perlfaq - frequently asked questions about Perl ($Date: 2002/03/11
+21:32:23 $)
 
 =over 4
 
@@ -854,14 +854,313 @@ HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLLIB, PERL5DB, PERL5SHELL
 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
 
+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 file %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"
+
 =back
 
 =head2 perllexwarn - Perl Lexical Warnings
@@ -906,7 +1205,7 @@ B<-w>, B<-W>, B<-X>
 
 =item use strict
 
-=item Looking at data and -w and w
+=item Looking at data and -w and v
 
 =item help
 
@@ -944,16 +1243,16 @@ B<-w>, B<-W>, B<-X>
 
 =item Debugger Commands
 
-h [command], p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], T, s
-[expr], n [expr], r, <CR>, c [line|sub], l, l min+incr, l min-max, l line,
-l subname, -, w [line], f filename, /pattern/, ?pattern?, L, S [[!]regex],
-t, t expr, b [line] [condition], b subname [condition], b postpone subname
-[condition], b load filename, b compile subname, d [line], D, a [line]
-command, a [line], A, W expr, W, 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, man
-[manpage]
+h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars],
+T, s [expr], n [expr], r, <CR>, c [line|sub], l, l min+incr, l min-max, l
+line, l subname, -, v [line], f filename, /pattern/, ?pattern?, L [abw], S
+[[!]regex], t, t expr, b, b [line] [condition], b 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]
 
 =item Configurable Options
 
@@ -2086,8 +2385,6 @@ v1.30, 03 August 1998, v1.23, 10 July 1998
 
 =item AUTHORS / CONTRIBUTORS
 
-=item VERSION
-
 =back
 
 =head2 perllocale - Perl locale handling (internationalization and
@@ -2216,11 +2513,7 @@ LC_NUMERIC, LC_TIME, LANG
 
 =item Questions With Answers
 
-Will My Old Scripts Break?, How Do I Make My Scripts Work With Unicode?,
-How Do I Know Whether My String Is In Unicode?, How Do I Detect Data That's
-Not Valid In a Particular Encoding, How Do I Convert Binary Data Into a
-Particular Encoding, Or Vice Versa?, How Do I Display Unicode? How Do I
-Input Unicode?, How Does Unicode Work With Traditional Locales?
+, , , , , , 
 
 =item Hexadecimal Notation
 
@@ -2261,19 +2554,10 @@ to enable UTF-8/UTF-EBCDIC in scripts
 
 =item Character encodings for input and output
 
-=back
-
-=item CAVEATS
-
-=item UNICODE REGULAR EXPRESSION SUPPORT LEVEL
-
-=over 4
+=item Unicode Regular Expression Support Level
 
 =item Unicode Encodings
 
-UTF-8, UTF-EBCDIC, UTF-16, UTF-16BE, UTF16-LE, Surrogates, and BOMs (Byte
-Order Marks), UTF-32, UTF-32BE, UTF32-LE, UCS-2, UCS-4, UTF-7
-
 =item Security Implications of Malformed UTF-8
 
 =item Unicode in Perl on EBCDIC
@@ -2282,7 +2566,7 @@ Order Marks), UTF-32, UTF-32BE, UTF32-LE, UCS-2, UCS-4, UTF-7
 
 =back
 
-=item SEE ALSO
+=item BUGS
 
 =back
 
@@ -2314,6 +2598,8 @@ Order Marks), UTF-32, UTF-32BE, UTF32-LE, UCS-2, UCS-4, UTF-7
 
 =item Unicode and UTF
 
+=item Using Encode
+
 =back
 
 =item SINGLE OCTET TABLES
@@ -2715,8 +3001,8 @@ tarball, Announce to the modules list, Announce to clpa, Fix bugs!
 
 =back
 
-=head2 perlfaq1 - General Questions About Perl ($Revision: 1.6 $, $Date:
-2002/01/31 01:46:23 $)
+=head2 perlfaq1 - General Questions About Perl ($Revision: 1.7 $, $Date:
+2002/02/21 14:49:15 $)
 
 =over 4
 
@@ -2762,8 +3048,8 @@ Scheme, or Tcl?
 
 =back
 
-=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.8 $,
-$Date: 2002/02/08 22:31:57 $)
+=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.9 $,
+$Date: 2002/03/09 21:01:13 $)
 
 =over 4
 
@@ -2903,8 +3189,8 @@ my C program; what am I doing wrong?
 
 =back
 
-=head2 perlfaq4 - Data Manipulation ($Revision: 1.14 $, $Date: 2002/02/08
-22:30:23 $)
+=head2 perlfaq4 - Data Manipulation ($Revision: 1.19 $, $Date: 2002/03/11
+22:15:19 $)
 
 =over 4
 
@@ -2939,6 +3225,8 @@ decimal:>, B<How do I convert from decimal to binary:>
 
 =item Why aren't my random numbers random?
 
+=item How do I get a random number between X and Y?
+
 =back
 
 =item Data: Dates
@@ -3118,8 +3406,8 @@ array of hashes or arrays?
 
 =back
 
-=head2 perlfaq5 - Files and Formats ($Revision: 1.9 $, $Date: 2002/02/11
-19:30:21 $)
+=head2 perlfaq5 - Files and Formats ($Revision: 1.12 $, $Date: 2002/03/11
+22:25:25 $)
 
 =over 4
 
@@ -3193,7 +3481,7 @@ file.  Do I still have to use locking?
 
 =item How do I close a file descriptor by number?
 
-=item Why can't I use "C:\temp\foo" in DOS paths?  What doesn't
+=item Why can't I use "C:\temp\foo" in DOS paths?  Why doesn't
 `C:\temp\foo.exe` work?
 
 =item Why doesn't glob("*.*") get all the files?
@@ -3842,6 +4130,8 @@ C<!!!>, C<!!>, C<!>
 
 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
 
+=item The C<length(NAME)> Keyword
+
 =item Variable-length Parameter Lists
 
 =item The C_ARGS: Keyword
@@ -3866,6 +4156,8 @@ C<!!!>, C<!!>, C<!>
 
 =item The ALIAS: Keyword
 
+=item The OVERLOAD: Keyword
+
 =item The INTERFACE: Keyword
 
 =item The INTERFACE_MACRO: Keyword
@@ -4310,14 +4602,18 @@ CvSTASH, get_cv, Nullcv
 load_module, perl_alloc, perl_construct, perl_destruct, perl_free,
 perl_parse, perl_run, require_pv
 
+=item Functions in file pp_pack.c
+
+pack_cat, unpack_str
+
 =item Global Variables
 
 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
 
 =item GV Functions
 
-GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload, gv_stashpv,
-gv_stashsv
+GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
+gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
 
 =item Handy Values
 
@@ -4370,37 +4666,38 @@ svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
 
 =item SV Manipulation Functions
 
-get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
-newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
-new_vstring, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV,
-SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIV, SvIVX,
-SvIVx, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, SvNOK_off,
-SvNOK_on, SvNOK_only, SvNV, SvNVx, SvNVX, SvOK, SvOOK, SvPOK, SvPOKp,
-SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVbyte,
-SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen, SvPVutf8,
-SvPVutf8x, SvPVutf8x_force, SvPVutf8_force, SvPVutf8_nolen, SvPVX, SvPVx,
-SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT, SvREFCNT_dec,
-SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT,
-SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, SvUNLOCK, SvUOK,
-SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, sv_2bool,
-sv_2cv, sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen,
-sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv,
-sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn,
+get_sv, looks_like_number, memcmp_byte_utf8, newRV_inc, newRV_noinc, newSV,
+newSViv, newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv,
+newSVsv, newSVuv, new_vstring, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK,
+SvIOKp, SvIOK_notUV, SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV,
+SvIOK_UV, SvIV, SvIVx, SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK,
+SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVx, SvNVX, SvOK, SvOOK,
+SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV,
+SvPVbyte, SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen,
+SvPVutf8, SvPVutf8x, SvPVutf8x_force, SvPVutf8_force, SvPVutf8_nolen,
+SvPVx, SvPVX, SvPV_force, SvPV_force_nomg, SvPV_nolen, SvREFCNT,
+SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSTASH,
+SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, SvUNLOCK,
+SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on, SvUV, SvUVx, SvUVX,
+sv_2bool, sv_2cv, sv_2io, sv_2iv, sv_2mortal, sv_2nv, sv_2pvbyte,
+sv_2pvbyte_nolen, sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen,
+sv_2uv, sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn,
 sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags,
-sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm, sv_dec,
-sv_derived_from, sv_eq, sv_force_normal, sv_force_normal_flags, sv_free,
-sv_gets, sv_grow, sv_inc, sv_insert, sv_isa, sv_isobject, sv_iv, sv_len,
-sv_len_utf8, sv_magic, sv_magicext, sv_mortalcopy, sv_newmortal, sv_newref,
-sv_nolocking, sv_nosharing, 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_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm,
+sv_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal,
+sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, sv_insert,
+sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, sv_magicext,
+sv_mortalcopy, sv_newmortal, sv_newref, sv_nolocking, sv_nosharing,
+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
 
 =item Unicode Support
@@ -4495,25 +4792,10 @@ PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
 
 =item Methods in Detail
 
-char * name;, Size_t size;, IV kind;, PERLIO_K_BUFFERED, PERLIO_K_CANCRLF,
-PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, PERLIO_K_RAW, IV             
-(*Pushed)(pTHX_ PerlIO *f,const char *mode, SV *arg);, IV             
-(*Popped)(pTHX_ PerlIO *f);,  PerlIO * (*Open)(...);, SV *     
-(*Getarg)(pTHX_ PerlIO *f, CLONE_PARAMS *param, int flags), IV      
-(*Fileno)(pTHX_ PerlIO *f);, PerlIO *  (*Dup)(pTHX_ PerlIO *f, PerlIO *o,
-CLONE_PARAMS *param, int flags),  SSize_t      (*Read)(pTHX_ PerlIO *f,
-void *vbuf, Size_t count);,  SSize_t   (*Unread)(pTHX_ PerlIO *f, const
-void *vbuf, Size_t count);,  SSize_t   (*Write)(PerlIO *f, const void
-*vbuf, Size_t count);, IV               (*Seek)(pTHX_ PerlIO *f, Off_t
-offset, int whence);,  Off_t            (*Tell)(pTHX_ PerlIO *f);,  IV    
-     (*Close)(pTHX_ PerlIO *f);,  IV        (*Flush)(pTHX_ PerlIO *f);, 
-IV        (*Fill)(pTHX_ PerlIO *f);,  IV          (*Eof)(pTHX_ PerlIO
-*f);,  IV          (*Error)(pTHX_ PerlIO *f);,  void              
-(*Clearerr)(pTHX_ PerlIO *f);, void            (*Setlinebuf)(pTHX_ PerlIO
-*f);,  STDCHAR *     (*Get_base)(pTHX_ PerlIO *f);,  Size_t        
-(*Get_bufsiz)(pTHX_ PerlIO *f);,  STDCHAR *    (*Get_ptr)(pTHX_ PerlIO
-*f);,  SSize_t (*Get_cnt)(pTHX_ PerlIO *f);,  void            
-(*Set_ptrcnt)(pTHX_ PerlIO *f,STDCHAR *ptr,SSize_t cnt);
+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
 
 =item Core Layers
 
@@ -4670,10 +4952,6 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item Memory leaks after failed eval
 
-=item pack for IV, UVs, NVs, and long doubles
-
-=item pack "(stuff)*"
-
 =item bitfields in pack
 
 =item Cross compilation
@@ -4756,6 +5034,8 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item Make v-strings overloaded objects
 
+=item Allow restricted hash assignment
+
 =back
 
 =item Vague ideas
@@ -5103,10 +5383,10 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item New Unicode Properties
 
-=item Perl Parser Stress Tested
-
 =item REF(...) Instead Of SCALAR(...)
 
+=item pack/unpack D/F recycled
+
 =item Deprecations
 
 =back
@@ -5179,10 +5459,6 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item lib/ftmp-security tests warn 'system possibly insecure'
 
-=item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
-
-=item HP-UX lib/io_multihomed Fails When LP64-Configured
-
 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
 
 =item Linux With Sfio Fails op/misc Test 48
@@ -5197,6 +5473,8 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item UNICOS
 
+=item UNICOS and UNICOS/mk
+
 =item UTS
 
 =item VMS
@@ -5957,8 +6235,7 @@ C<PATCHLEVEL> is now C<PERL_VERSION>
 
 =item Known test failures
 
-64-bit builds, Failure of Thread tests, NEXTSTEP 3.3 POSIX test failure,
-Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with gcc
+, , 
 
 =item EBCDIC platforms not fully supported
 
@@ -6869,7 +7146,7 @@ R4 x86, R4 PPC
 
 =item Contact Information
 
-=item Update 2001-12-26
+=item Update 2002-03-02
 
 =back
 
@@ -6973,7 +7250,8 @@ C<-lcygipc> (C<use IPC::SysV>)
 =item Configure-time Options for Perl on Cygwin
 
 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
-C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>
+C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
+C<-Dmksymlinks>
 
 =item Suspicious Warnings on Cygwin
 
@@ -7413,7 +7691,7 @@ Perl manual in F<.INF> format, Pdksh
 
 =item GNU C<info> files
 
-=item F<.PDF> files
+=item F<PDF> files
 
 =item C<LaTeX> docs
 
@@ -9116,6 +9394,8 @@ B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
 
 =item DESCRIPTION
 
+=item EXAMPLE
+
 =item OPTIONS
 
 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
@@ -9127,8 +9407,8 @@ B<-terse>, B<-linenoise>, B<-debug>, B<-env>
 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
-B<#classym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
-B<#flags>, B<#flagval>, B<#hyphenseq>, B<#label>, B<#lastaddr>, B<#name>,
+B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
+B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
@@ -9568,8 +9848,7 @@ B<Parameters:>
 
 =item CREATING A CLICKABLE IMAGE BUTTON
 
-B<Parameters:>, 3. The third option (-align, optional) is an alignment
-type, and may be TOP, BOTTOM or MIDDLE
+B<Parameters:>
 
 =item CREATING A JAVASCRIPT ACTION BUTTON
 
@@ -9599,9 +9878,8 @@ the <form> tag
 =item FETCHING ENVIRONMENT VARIABLES
 
 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
-B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
-name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
-()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
+B<path_translated()>, B<remote_host()>, B<script_name()>, B<referer()>,
+B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
 B<request_method()>, B<content_type()>, B<http()>, B<https()>
 
@@ -10171,13 +10449,13 @@ C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>, C<d_strtouq>,
 C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>, C<d_syscallproto>,
 C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>,
 C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>,
-C<d_truncate>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>,
-C<d_uname>, C<d_union_semun>, C<d_unordered>, C<d_usleep>,
-C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>,
-C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>,
-C<d_volatile>, C<d_vprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>,
-C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>,
-C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
+C<d_tm_tm_gmtoff>, C<d_tm_tm_zone>, C<d_truncate>, C<d_tzname>,
+C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
+C<d_unordered>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>,
+C<d_vendorbin>, C<d_vendorlib>, C<d_vfork>, C<d_void_closedir>,
+C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
+C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
+C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
 C<doublesize>, C<drand01>, C<dynamic_ext>
 
@@ -10916,8 +11194,103 @@ variants of EBCDIC, symbol and dingbats as used by Tk on X11
 
 =head2 Encode::Tcl - Tcl encodings
 
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::Tcl::Escape - Tcl Escape encodings
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::Tcl::Extended - Tcl EUC encodings
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::Tcl::Table - Tcl Table encodings
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=back
+
 =head2 Encode::lib::Encode::Tcl, Encode::Tcl - Tcl encodings
 
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::lib::Encode::Tcl::Escape, Encode::Tcl::Escape - Tcl Escape
+encodings
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::lib::Encode::Tcl::Extended, Encode::Tcl::Extended - Tcl EUC
+encodings
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=back
+
+=head2 Encode::lib::Encode::Tcl::Table, Encode::Tcl::Table - Tcl Table
+encodings
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=back
+
 =head2 Encode::lib::EncodeFormat, EncodeFormat - the format of encoding
 tables of the Encode extension
 
@@ -12624,7 +12997,8 @@ B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
 
 =item Summary of Option Specifications
 
-!, +, s, i, o, f, : I<type> [ I<desttype> ]
+!, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
++ [ I<desttype> ]
 
 =back
 
@@ -12700,6 +13074,36 @@ clustering
 
 =back
 
+=head2 Hash::Util - A selection of general-utility hash subroutines
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item Restricted hashes
+
+lock_keys, unlock_keys
+
+=back
+
+=back
+
+lock_value, unlock_value
+
+B<lock_hash>, B<unlock_hash>
+
+=over 4
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
 =head2 I18N::Collate - compare 8-bit scalar data according to the current
 locale
 
@@ -13643,7 +14047,15 @@ country_code2code( CODE, CODESET, CODESET )
 
 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
 
-=item CODE ALIASING
+=item SEMI-PRIVATE ROUTINES
+
+=over 4
+
+=item alias_code
+
+=item rename_country
+
+=back
 
 =item EXAMPLES
 
@@ -13653,8 +14065,8 @@ C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
 
 =item SEE ALSO
 
-Locale::Language, Locale::Script, Locale::Currency, ISO 3166,
-http://www.din.de/gremien/nas/nabd/iso3166ma/,
+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
 
@@ -13962,6 +14374,120 @@ stringify, bstr(), bdiv, Modifying and =, bpow
 
 Canonical notation, Input, Output
 
+=item METHODS
+
+=over 4
+
+=item accuracy
+
+=item brsft
+
+=item new
+
+=item bnan
+
+=item bzero
+
+=item binf
+
+=item bone
+
+=item is_one() / is_zero() / is_nan() / is_positive() / is_negative() /
+is_inf() / is_odd() / is_even() / is_int()
+
+       $x->is_zero();                  # true if arg is +0
+       $x->is_nan();                   # true if arg is NaN
+       $x->is_one();                   # true if arg is +1
+       $x->is_one('-');                # true if arg is -1
+       $x->is_odd();                   # true if odd, false for even
+       $x->is_even();                  # true if even, false for odd
+       $x->is_positive();              # true if >= 0
+       $x->is_negative();              # true if <  0
+       $x->is_inf();                   # true if +inf
+       $x->is_inf('-');                # true if -inf (sign is default
+'+')
+       $x->is_int();                   # true if $x is an integer
+
+=item bcmp
+
+=item bacmp
+
+=item sign
+
+=item bcmp
+
+=item bneg
+
+=item babs
+
+=item bnorm
+
+=item bnot
+
+=item binc
+
+=item bdec
+
+=item badd
+
+=item bsub
+
+=item bmul
+
+=item bdiv
+
+=item bmod
+
+=item bpow
+
+=item blsft
+
+=item brsft
+
+=item band
+
+=item bior
+
+=item bxor
+
+=item bnot
+
+=item bsqrt
+
+=item bfac
+
+=item round
+
+=item bround
+
+=item bfround
+
+=item bfloor
+
+=item bceil
+
+=item bgcd
+
+=item blcm
+
+=item exponent
+
+=item mantissa
+
+=item parts
+
+=item copy
+
+=item as_number
+
+=item bsstr
+
+=item as_hex
+
+=item as_bin
+
+=back
+
 =item ACCURACY and PRECISION
 
 =over 4
@@ -14005,6 +14531,20 @@ Remarks
 
 =item Alternative math libraries
 
+=item SUBCLASSING
+
+=back
+
+=item Subclassing Math::BigInt
+
+=item UPGRADING
+
+=over 4
+
+=item Auto-upgrade
+
+bsqrt(), div(), blog()
+
 =back
 
 =item BUGS
@@ -14015,7 +14555,7 @@ Out of Memory!, Fails to load Calc on Perl prior 5.6.0
 
 stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
 handling, Modifying and =, bpow, Overloading -$x, Mixing different object
-types, bsqrt()
+types, bsqrt(), brsft()
 
 =item LICENSE
 
@@ -14322,7 +14862,7 @@ dataend ()
 
 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
-ungetline ( TEXT ), read_until_dot ()
+ungetline ( TEXT ), read_until_dot (), tied_fh ()
 
 =item EXPORTS
 
@@ -14447,11 +14987,12 @@ new ( [ HOST ] [, OPTIONS ])
 =item METHODS
 
 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
-[ MSGID|MSGNUM ], [FH] ), nntpstat ( [ MSGID|MSGNUM ] ), group ( [ GROUP ]
-), ihave ( MSGID [, MESSAGE ]), last (), date (), postok (), authinfo (
-USER, PASS ), list (), newgroups ( SINCE [, DISTRIBUTIONS ]), newnews (
-SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (), post ( [ MESSAGE ] ), slave
-(), quit ()
+[ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
+MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
+), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
+postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
+DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
+post ( [ MESSAGE ] ), postfh (), slave (), quit ()
 
 =over 4
 
@@ -14479,7 +15020,7 @@ MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
 
 =back
 
-=head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1081)
+=head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
 
 =over 4
 
@@ -14495,10 +15036,10 @@ new ( [ HOST, ] [ OPTIONS ] )
 
 =item METHODS
 
-user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( USER,
-PASS ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [,
-FH ] ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ] ), delete (
-MSGNUM ), reset (), quit ()
+user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
+PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
+[, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
+MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
 
 =item NOTES
 
@@ -16731,7 +17272,7 @@ NORMAL TESTS, SKIPPED TESTS, TODO TESTS
 
 =item BUGS and CAVEATS
 
-=item TODO
+=item NOTE
 
 =item SEE ALSO
 
@@ -17458,6 +17999,62 @@ SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
 
 =back
 
+=head2 Tie::File - Access the lines of a disk file via a Perl array
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item C<recsep>
+
+=item C<mode>
+
+=item C<cachesize>
+
+=item Option Format
+
+=back
+
+=item Public Methods
+
+=over 4
+
+=item C<flock>
+
+=item Tying to an already-opened filehandle
+
+=back
+
+=item CAVEATS
+
+=over 4
+
+=item Efficiency Note
+
+=item Efficiency Note 2
+
+=item Efficiency Note 3
+
+=back
+
+=item CAVEATS
+
+=item AUTHOR
+
+=item LICENSE
+
+=item WARRANTY
+
+=item THANKS
+
+=item TODO
+
+=back
+
 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
 handles
 
@@ -17689,6 +18286,8 @@ $Collator-E<gt>index($string, $substring)>
 
 =item EXPORT
 
+=item TODO
+
 =item CAVEAT
 
 =back
@@ -17726,6 +18325,8 @@ getCombinClass($codepoint)>, C<$is_exclusion = isExclusion($codepoint)>
 
 =item EXPORT
 
+=item TODO
+
 =back
 
 =item AUTHOR