a test for B::Xref
[p5sagit/p5-mst-13.2.git] / pod / perltoc.pod
index 95a0fee..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,25 +1243,26 @@ B<-w>, B<-W>, B<-X>
 
 =item Debugger Commands
 
-h [command], p expr, x 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
 
 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
-C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
-C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>, C<HighBit>,
-C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>, C<NonStop>
+C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
+C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
+C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
+C<NonStop>
 
 =item Debugger input/output
 
@@ -2085,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
@@ -2215,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
 
@@ -2260,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
@@ -2281,7 +2566,7 @@ Order Marks), UTF-32, UTF-32BE, UTF32-LE, UCS-2, UCS-4, UTF-7
 
 =back
 
-=item SEE ALSO
+=item BUGS
 
 =back
 
@@ -2313,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
@@ -2714,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
 
@@ -2761,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
 
@@ -2817,8 +3104,8 @@ References, Tutorials, Task-Oriented, Special Topics
 
 =back
 
-=head2 perlfaq3 - Programming Tools ($Revision: 1.13 $, $Date: 2002/02/08
-22:32:47 $)
+=head2 perlfaq3 - Programming Tools ($Revision: 1.15 $, $Date: 2002/02/11
+19:29:52 $)
 
 =over 4
 
@@ -2902,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
 
@@ -2938,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
@@ -3117,8 +3406,8 @@ array of hashes or arrays?
 
 =back
 
-=head2 perlfaq5 - Files and Formats ($Revision: 1.8 $, $Date: 2002/01/28
-04:17:26 $)
+=head2 perlfaq5 - Files and Formats ($Revision: 1.12 $, $Date: 2002/03/11
+22:25:25 $)
 
 =over 4
 
@@ -3192,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?
@@ -3841,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
@@ -3865,6 +4156,8 @@ C<!!!>, C<!!>, C<!>
 
 =item The ALIAS: Keyword
 
+=item The OVERLOAD: Keyword
+
 =item The INTERFACE: Keyword
 
 =item The INTERFACE_MACRO: Keyword
@@ -4309,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
 
@@ -4369,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
@@ -4494,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
 
@@ -4669,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
@@ -4755,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
@@ -5102,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
@@ -5178,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
@@ -5196,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
@@ -5956,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
 
@@ -6868,7 +7146,7 @@ R4 x86, R4 PPC
 
 =item Contact Information
 
-=item Update 2001-12-26
+=item Update 2002-03-02
 
 =back
 
@@ -6972,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
 
@@ -7412,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
 
@@ -7944,6 +8223,8 @@ LIST, waitpid PID,FLAGS
 
 =over 4
 
+=item Multiple methods to build perl for VOS
+
 =item Stratus POSIX Support
 
 =back
@@ -8332,6 +8613,20 @@ new, phash
 
 =back
 
+=head2 if - C<use> a Perl module if a condition holds
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item BUGS
+
+=item AUTHOR
+
+=back
+
 =head2 integer - Perl pragma to use integer arithmetic instead of floating
 point
 
@@ -9099,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>,
@@ -9110,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>
@@ -9551,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
 
@@ -9582,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()>
 
@@ -10154,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>
 
@@ -10899,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
 
@@ -12607,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
 
@@ -12683,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
 
@@ -13599,7 +14020,7 @@ EXPR, tainted EXPR, weaken REF
 
 =item SEE ALSO
 
-Locale::Language, Locale::Country, Locale::Currency
+Locale::Language, Locale::Country, Locale::Script, Locale::Currency
 
 =item AUTHOR
 
@@ -13613,40 +14034,28 @@ Locale::Language, Locale::Country, Locale::Currency
 
 =item SYNOPSIS
 
-=back
-
-=over 4
-
 =item DESCRIPTION
 
 B<alpha-2>, B<alpha-3>, B<numeric>
 
-=back
-
-=over 4
-
 =item CONVERSION ROUTINES
 
 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
 country_code2code( CODE, CODESET, CODESET )
 
-=back
-
-=over 4
-
 =item QUERY ROUTINES
 
 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
 
-=back
+=item SEMI-PRIVATE ROUTINES
 
 =over 4
 
-=item CODE ALIASING
+=item alias_code
 
-=back
+=item rename_country
 
-=over 4
+=back
 
 =item EXAMPLES
 
@@ -13656,8 +14065,8 @@ C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
 
 =item SEE ALSO
 
-Locale::Language, 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
 
@@ -13674,41 +14083,26 @@ identification (ISO 4217)
 
 =item SYNOPSIS
 
-=back
-
-=over 4
-
 =item DESCRIPTION
 
 XTS, XXX
 
-=back
-
-=over 4
-
 =item CONVERSION ROUTINES
 
 code2currency(), currency2code()
 
-=back
-
-=over 4
-
 =item QUERY ROUTINES
 
 C<all_currency_codes()>, C<all_currency_names()>
 
-=back
-
-=over 4
-
 =item EXAMPLES
 
 =item KNOWN BUGS AND LIMITATIONS
 
 =item SEE ALSO
 
-Locale::Country, ISO 4217:1995, http://www.bsi-global.com/iso4217currency
+Locale::Country, Locale::Script, ISO 4217:1995,
+http://www.bsi-global.com/iso4217currency
 
 =item AUTHOR
 
@@ -13723,39 +14117,23 @@ Locale::Country, ISO 4217:1995, http://www.bsi-global.com/iso4217currency
 
 =item SYNOPSIS
 
-=back
-
-=over 4
-
 =item DESCRIPTION
 
-=back
-
-=over 4
-
 =item CONVERSION ROUTINES
 
 code2language(), language2code()
 
-=back
-
-=over 4
-
 =item QUERY ROUTINES
 
 C<all_language_codes()>, C<all_language_names()>
 
-=back
-
-=over 4
-
 =item EXAMPLES
 
 =item KNOWN BUGS AND LIMITATIONS
 
 =item SEE ALSO
 
-Locale::Country, Locale::Currency, ISO 639:1988 (E/F),
+Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
 http://lcweb.loc.gov/standards/iso639-2/langhome.html
 
 =item AUTHOR
@@ -13853,6 +14231,46 @@ $language->language_tag(), $language->encoding()
 
 =back
 
+=head2 Locale::Script - ISO codes for script identification (ISO 15924)
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+B<alpha-2>, B<alpha-3>, B<numeric>
+
+=over 4
+
+=item SPECIAL CODES
+
+=back
+
+=item CONVERSION ROUTINES
+
+code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
+script_code2code( CODE, CODESET, CODESET )
+
+=item QUERY ROUTINES
+
+C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
+
+=item EXAMPLES
+
+=item KNOWN BUGS AND LIMITATIONS
+
+=item SEE ALSO
+
+Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
+http://www.evertype.com/standards/iso15924/
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=back
+
 =head2 MIME::Base64 - Encoding and decoding of base64 strings
 
 =over 4
@@ -13956,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
@@ -13999,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
@@ -14009,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
 
@@ -14316,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
 
@@ -14441,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
 
@@ -14473,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
 
@@ -14489,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
 
@@ -16725,7 +17272,7 @@ NORMAL TESTS, SKIPPED TESTS, TODO TESTS
 
 =item BUGS and CAVEATS
 
-=item TODO
+=item NOTE
 
 =item SEE ALSO
 
@@ -17452,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
 
@@ -17472,7 +18075,8 @@ EOF this, TELL this, SEEK this, offset, whence, DESTROY this
 
 =back
 
-=head2 Tie::Hash, Tie::StdHash - base class definitions for tied hashes
+=head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
+tied hashes
 
 =over 4
 
@@ -17483,12 +18087,34 @@ EOF this, TELL this, SEEK this, offset, whence, DESTROY this
 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
 
-=item CAVEATS
+=item Inheriting from B<Tie::StdHash>
+
+=item Inheriting from B<Tie::ExtraHash>
+
+=item C<UNTIE> and C<DESTROY>
 
 =item MORE INFORMATION
 
 =back
 
+=head2 Tie::Memoize - add data to hash when needed
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item Inheriting from B<Tie::Memoize>
+
+=item EXAMPLE
+
+=item BUGS
+
+=item AUTHOR
+
+=back
+
 =head2 Tie::RefHash - use references as hash keys
 
 =over 4
@@ -17660,6 +18286,8 @@ $Collator-E<gt>index($string, $substring)>
 
 =item EXPORT
 
+=item TODO
+
 =item CAVEAT
 
 =back
@@ -17697,6 +18325,8 @@ getCombinClass($codepoint)>, C<$is_exclusion = isExclusion($codepoint)>
 
 =item EXPORT
 
+=item TODO
+
 =back
 
 =item AUTHOR
@@ -17860,9 +18490,10 @@ Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
-Win32::RegisterServer(LIBRARYNAME), Win32::SetCwd(NEWDIRECTORY),
-Win32::SetLastError(ERROR), Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS,
-PID), Win32::UnregisterServer(LIBRARYNAME)
+Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
+Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
+Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
+Win32::UnregisterServer(LIBRARYNAME)
 
 =back