This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Regen toc.
authorJarkko Hietaniemi <jhi@iki.fi>
Mon, 4 Mar 2002 14:46:29 +0000 (14:46 +0000)
committerJarkko Hietaniemi <jhi@iki.fi>
Mon, 4 Mar 2002 14:46:29 +0000 (14:46 +0000)
p4raw-id: //depot/perl@14996

pod/perltoc.pod

index 806e12f..01ef3a6 100644 (file)
@@ -854,14 +854,310 @@ 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 key '%_' in fixed hash, Attempt to bless into a
+reference, Attempt to free non-arena SV: 0x%lx, Attempt to free nonexistent
+shared string, Attempt to free temp prematurely, Attempt to free
+unreferenced glob pointers, Attempt to free unreferenced scalar, Attempt to
+join self, Attempt to pack pointer to temporary value, Attempt to use
+reference as lvalue in substr, Bad arg length for %s, is %d, should be %s,
+Bad evalled substitution pattern, Bad filehandle: %s, Bad free() ignored,
+Bad hash, Bad index while coercing array into hash, Badly placed ()'s, Bad
+name after %s::, Bad realloc() ignored, Bad symbol for array, Bad symbol
+for filehandle, Bad symbol for hash, Bareword found in conditional,
+Bareword "%s" not allowed while "strict subs" in use, Bareword "%s" refers
+to nonexistent package, BEGIN failed--compilation aborted, BEGIN not safe
+after errors--compilation aborted, \1 better written as $1, Binary number >
+0b11111111111111111111111111111111 non-portable, bind() on closed socket
+%s, binmode() on closed filehandle %s, Bit vector size > 32 non-portable,
+Bizarre copy of %s in %s, B<-P> not allowed for setuid/setgid script,
+Buffer overflow in prime_env_iter: %s, Callback called exit, %s() called
+too early to check prototype, / cannot take a count, Can't bless
+non-reference value, Can't call method "%s" in empty package "%s", Can't
+call method "%s" on an undefined value, Can't call method "%s" on unblessed
+reference, Can't call method "%s" without a package or object reference,
+Can't chdir to %s, Can't check filesystem of script "%s" for nosuid, Can't
+coerce array into hash, Can't coerce %s to integer in %s, Can't coerce %s
+to number in %s, Can't coerce %s to string in %s, Can't create pipe
+mailbox, Can't declare class for non-scalar %s in "%s", Can't declare %s in
+"%s", Can't do inplace edit: %s is not a regular file, Can't do inplace
+edit on %s: %s, Can't do inplace edit without backup, Can't do inplace
+edit: %s would not be unique, Can't do {n,m} with n > m in regex; marked by
+<-- HERE in m/%s/, Can't do setegid!, Can't do seteuid!, Can't do setuid,
+Can't do waitpid with flags, Can't emulate -%s on #! line, Can't exec "%s":
+%s, Can't exec %s, Can't execute %s, Can't find an opnumber for "%s", Can't
+find %s character property "%s", Can't find label %s, Can't find %s on
+PATH, Can't find %s on PATH, '.' not in PATH, Can't find string terminator
+%s anywhere before EOF, Can't find %s property definition %s, Can't fork,
+Can't get filespec - stale stat buffer?, Can't get pipe mailbox device
+name, Can't get SYSGEN parameter value for MAXBUF, Can't "goto" into the
+middle of a foreach loop, Can't "goto" out of a pseudo block, Can't goto
+subroutine from an eval-string, Can't goto subroutine outside a subroutine,
+Can't ignore signal CHLD, forcing to default, Can't "last" outside a loop
+block, Can't localize lexical variable %s, Can't localize pseudo-hash
+element, Can't localize through a reference, Can't locate %s, Can't locate
+auto/%s.al in @INC, Can't locate object method "%s" via package "%s",
+(perhaps you forgot to load "%s"?), Can't locate package %s for @%s::ISA,
+Can't make list assignment to \%ENV on this system, Can't modify %s in %s,
+Can't modify nonexistent substring, Can't modify non-lvalue subroutine
+call, Can't msgrcv to read-only var, Can't "next" outside a loop block,
+Can't open %s: %s, Can't open bidirectional pipe, Can't open error file %s
+as stderr, Can't open input file %s as stdin, Can't open output file %s as
+stdout, Can't open output pipe (name: %s), Can't open perl script%s: %s,
+Can't read CRTL environ, Can't redefine active sort subroutine %s, Can't
+"redo" outside a loop block, Can't remove %s: %s, skipping file, Can't
+rename %s to %s: %s, skipping file, Can't reopen input pipe (name: %s) in
+binary mode, Can't resolve method `%s' overloading `%s' in package `%s',
+Can't reswap uid and euid, Can't return %s from lvalue subroutine, Can't
+return %s to lvalue scalar context, Can't return outside a subroutine,
+Can't stat script "%s", Can't swap uid and euid, Can't take log of %g,
+Can't take sqrt of %g, Can't undef active subroutine, Can't unshift, Can't
+upgrade that kind of scalar, Can't upgrade to undef, Can't use an undefined
+value as %s reference, Can't use anonymous symbol table for method lookup,
+Can't use bareword ("%s") as %s ref while "strict refs" in use, Can't use
+%! because Errno.pm is not available, Can't use %s for loop variable, Can't
+use global %s in "my", Can't use "my %s" in sort comparison, Can't use %s
+ref as %s ref, Can't use string ("%s") as %s ref while "strict refs" in
+use, Can't use subscript on %s, Can't use \%c to mean $%c in expression,
+Can't weaken a nonreference, Can't x= to read-only value, Character in "C"
+format wrapped, Character in "c" format wrapped, close() on unopened
+filehandle %s, %s: Command not found, Compilation failed in require,
+Complex regular subexpression recursion limit (%d) exceeded, connect() on
+closed socket %s, Constant(%s)%s: %s, Constant is not %s reference,
+Constant subroutine %s redefined, Constant subroutine %s undefined, Copy
+method did not return a reference, CORE::%s is not a keyword, corrupted
+regexp pointers, corrupted regexp program, Corrupt malloc ptr 0x%lx at
+0x%lx, C<-p> destination: %s, C<-T> and C<-B> not implemented on
+filehandles, Deep recursion on subroutine "%s", defined(@array) is
+deprecated, defined(%hash) is deprecated, %s defines neither package nor
+VERSION--version check failed, Delimiter for here document is too long, Did
+not produce a valid header, %s did not return a true value, (Did you mean
+&%s instead?), (Did you mean "local" instead of "our"?), (Did you mean $ or
+@ instead of %?), Died, Document contains no data, %s does not define
+%s::VERSION--version check failed, Don't know how to handle magic of type
+'%s', do_study: out of memory, (Do you need to predeclare %s?), dump()
+better written as CORE::dump(), Duplicate free() ignored, elseif should be
+elsif, Empty %s, entering effective %s failed, Error converting file
+specification %s, %s: Eval-group in insecure regular expression, %s:
+Eval-group not allowed at run time, %s: Eval-group not allowed, use re
+'eval', Excessively long <> operator, exec? I'm not *that* kind of
+operating system, Execution of %s aborted due to compilation errors,
+Exiting eval via %s, Exiting format via %s, Exiting pseudo-block via %s,
+Exiting subroutine via %s, Exiting substitution via %s, Explicit blessing
+to '' (assuming package main), %s: Expression syntax, %s failed--call queue
+aborted, False [] range "%s" in regex; marked by <-- HERE in m/%s/, Fatal
+VMS error at %s, line %d, fcntl is not implemented, Filehandle %s opened
+only for input, Filehandle %s opened only for output, Final $ should be \$
+or $name, Final @ should be \@ or @name, flock() on closed filehandle %s,
+Quantifier follows nothing in regex;, Format not terminated, Format %s
+redefined, Found = in conditional, should be ==, %s found where operator
+expected, gdbm store returned %d, errno %d, key "%s", gethostent not
+implemented, get%sname() on closed socket %s, getpwnam returned invalid UIC
+%#o for user "%s", getsockopt() on closed socket %s, Global symbol "%s"
+requires explicit package name, glob failed (%s), Glob not terminated, Got
+an error from DosAllocMem, goto must have label, %s-group starts with a
+count, %s had compilation errors, Had to create %s unexpectedly, Hash %%s
+missing the % in argument %d of %s(), %s has too many errors, Hexadecimal
+number > 0xffffffff non-portable, Identifier too long, Illegal binary digit
+%s, Illegal binary digit %s ignored, Illegal character %s (carriage
+return), Illegal character in prototype for %s : %s, Illegal division by
+zero, Illegal hexadecimal digit %s ignored, Illegal modulus zero, Illegal
+number of bits in vec, Illegal octal digit %s, Illegal octal digit %s
+ignored, Illegal switch in PERL5OPT: %s, Ill-formed CRTL environ value
+"%s", Ill-formed message in prime_env_iter: |%s|, (in cleanup) %s, In
+EBCDIC the v-string components cannot exceed 2147483647, Insecure
+dependency in %s, Insecure directory in %s, Insecure $ENV{%s} while running
+%s, Integer overflow in %s number, Internal disaster in regex; marked by
+<-- HERE in m/%s/, Internal inconsistency in tracking vforks, Internal urp
+in regex; marked by <-- HERE in m/%s/, %s (...) interpreted as function,
+Invalid %s attribute: %s, Invalid %s attributes: %s, Invalid conversion in
+%s: "%s", Invalid [] range "%s" in regex; marked by <-- HERE in m/%s/,
+Invalid [] range "%s" in transliteration operator, Invalid separator
+character %s in attribute list, Invalid type in pack: '%s', Invalid type in
+unpack: '%s', ioctl is not implemented, ioctl() on unopened %s,
+IO::Socket::atmark not implemented on this architecture, `%s' is not a code
+reference, `%s' is not an overloadable type, junk on end of regexp, Label
+not found for "last %s", Label not found for "next %s", Label not found for
+"redo %s", leaving effective %s failed, listen() on closed socket %s,
+lstat() on filehandle %s, Lvalue subs returning %s not implemented yet,
+Lookbehind longer than %d not implemented in regex;, Malformed
+PERLLIB_PREFIX, Malformed prototype for %s: %s, Malformed UTF-8 character
+(%s), Malformed UTF-16 surrogate, %s matches null string many times in
+regex;, "%s" may clash with future reserved word, % may only be used in
+unpack, Method for operation %s not found in package %s during blessing,
+Method %s not permitted, Might be a runaway multi-line %s string starting
+on line %d, Misplaced _ in number, Missing %sbrace%s on \N{}, Missing comma
+after first argument to %s function, Missing command in piped open, Missing
+name in "my sub", Missing $ on loop variable, (Missing operator before
+%s?), Missing right brace on %s, Missing right curly or square bracket,
+(Missing semicolon on previous line?), Modification of a read-only value
+attempted, Modification of non-creatable array value attempted, %s,
+Modification of non-creatable hash value attempted, %s, Module name must be
+constant, Module name required with -%c option, More than one argument to
+open, msg%s not implemented, Multidimensional syntax %s not supported, /
+must be followed by a*, A* or Z*, / must be followed by a, A or Z, / must
+follow a numeric type, "my sub" not yet implemented, "my" variable %s can't
+be in a package, Name "%s::%s" used only once: possible typo, Negative
+length, Negative offset to vec in lvalue context, Nested quantifiers in
+regex; marked by <-- HERE in m/%s/, %s never introduced, No %s allowed
+while running setuid, No B<-e> allowed in setuid scripts, No comma allowed
+after %s, No command into which to pipe on command line, No DB::DB routine
+defined, No dbm on this machine, No DBsub routine, No error file after 2>
+or 2>> on command line, No input file after < on command line, No #! line,
+"no" not allowed in expression, No output file after > on command line, No
+output file after > or >> on command line, No package name allowed for
+variable %s in "our", No Perl script found in input, No setregid available,
+No setreuid available, No space allowed after -%c, No %s specified for -%c,
+No such class %s, No such pipe open, No such pseudo-hash field "%s", No
+such pseudo-hash field "%s" in variable %s of type %s, No such signal:
+SIG%s, Not a CODE reference, Not a format reference, Not a GLOB reference,
+Not a HASH reference, Not an ARRAY reference, Not a perl script, Not a
+SCALAR reference, Not a subroutine reference, Not a subroutine reference in
+overload table, Not enough arguments for %s, Not enough format arguments,
+%s: not found, %s not allowed in length fields, no UTC offset information;
+assuming local time is UTC, Null filename used, NULL OP IN RUN, Null
+picture in formline, Null realloc, NULL regexp argument, NULL regexp
+parameter, Number too long, Octal number in vector unsupported, Octal
+number > 037777777777 non-portable, Odd number of arguments for
+overload::constant, Odd number of elements in anonymous hash, Odd number of
+elements in hash assignment, Offset outside string, -%s on unopened
+filehandle %s, %s() on unopened %s, oops: oopsAV, oops: oopsHV, Operation
+`%s': no method found, %s, Operator or semicolon missing before %s, "our"
+variable %s redeclared, Out of memory!, Out of memory during "large"
+request for %s, Out of memory during request for %s, Out of memory during
+ridiculously large request, Out of memory for yacc stack, @ outside of
+string, %s package attribute may clash with future reserved word: %s, page
+overflow, panic: %s, panic: ck_grep, panic: ck_split, panic: corrupt saved
+stack index, panic: del_backref, panic: die %s, panic: pp_match%s, panic:
+do_subst, panic: do_trans_%s, panic: frexp, panic: goto, panic:
+INTERPCASEMOD, panic: INTERPCONCAT, panic: kid popen errno read, panic:
+last, panic: leave_scope clearsv, panic: leave_scope inconsistency, panic:
+magic_killbackrefs, panic: malloc, panic: mapstart, panic: null array,
+panic: pad_alloc, panic: pad_free curpad, panic: pad_free po, panic:
+pad_reset curpad, panic: pad_sv po, panic: pad_swipe curpad, panic:
+pad_swipe po, panic: pp_iter, panic: pp_split, panic: realloc, panic:
+restartop, panic: return, panic: scan_num, panic: sv_insert, panic:
+top_env, panic: yylex, panic: utf16_to_utf8: odd bytelen, Parentheses
+missing around "%s" list, Perl %s required--this is only version %s,
+stopped, PERL_SH_DIR too long, perl: warning: Setting locale failed,
+perlio: argument list not closed for layer "%s", perlio: invalid separator
+character %s in attribute list, perlio: unknown layer "%s", Permission
+denied, pid %x not a child, P must have an explicit size, POSIX syntax [%s]
+belongs inside character classes in regex;, POSIX syntax [. .] is reserved
+for future extensions in regex;, POSIX syntax [= =] is reserved for future
+extensions in regex;, POSIX class [:%s:] unknown in regex;, POSIX getpgrp
+can't take an argument, Possible attempt to put comments in qw() list,
+Possible attempt to separate words with commas, Possible memory corruption:
+%s overflowed 3rd argument, Possible unintended interpolation of %s in
+string, Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME :
+ATTRS" instead, Precedence problem: open %s should be open(%s), Premature
+end of script headers, printf() on closed filehandle %s, print() on closed
+filehandle %s, Process terminated by SIG%s, Prototype mismatch: %s vs %s,
+Prototype not terminated, Quantifier in {,} bigger than %d in regex;,
+Quantifier unexpected on zero-length expression;, Range iterator outside
+integer range, readline() on closed filehandle %s, Reallocation too large:
+%lx, realloc() of freed memory ignored, Recompile perl with B<-D>DEBUGGING
+to use B<-D> switch, Recursive inheritance detected in package '%s',
+Recursive inheritance detected while looking for method %s, Reference found
+where even-sized list expected, Reference is already weak, Reference
+miscount in sv_replace(), Reference to nonexistent group in regex;, regexp
+memory corruption, Regexp out of space, Repeat count in pack overflows,
+Repeat count in unpack overflows, Reversed %s= operator, Runaway format,
+Scalar value @%s[%s] better written as $%s[%s], Scalar value @%s{%s} better
+written as $%s{%s}, Scalars leaked: %d, Script is not setuid/setgid in
+suidperl, Search pattern not terminated, %sseek() on unopened filehandle,
+select not implemented, Self-ties of arrays and hashes are not supported,
+Semicolon seems to be missing, semi-panic: attempt to dup freed string,
+sem%s not implemented, send() on closed socket %s, Sequence (? incomplete
+in regex; marked by <-- HERE in m/%s/, Sequence (?{...}) not terminated or
+not {}-balanced in regex;, Sequence (?%s...) not implemented in regex;,
+Sequence (?%s...) not recognized in regex;, Sequence (?#... not terminated
+in regex;, 500 Server error, Server error, setegid() not implemented,
+seteuid() not implemented, setpgrp can't take arguments, setrgid() not
+implemented, setruid() not implemented, setsockopt() on closed socket %s,
+Setuid/gid script is writable by world, shm%s not implemented, <> should be
+quotes, /%s/ should probably be written as "%s", shutdown() on closed
+socket %s, SIG%s handler "%s" not defined, sort is now a reserved word,
+Sort subroutine didn't return a numeric value, Sort subroutine didn't
+return single value, splice() offset past end of array, Split loop,
+Statement unlikely to be reached, stat() on unopened filehandle %s, Stub
+found while resolving method `%s' overloading %s, Subroutine %s redefined,
+Substitution loop, Substitution pattern not terminated, Substitution
+replacement not terminated, substr outside of string, suidperl is no longer
+needed since %s, Switch (?(condition)... contains too many branches in
+regex;, Switch condition not recognized in regex;, switching effective %s
+is not implemented, syntax error, syntax error at line %d: `%s' unexpected,
+syntax error in file %s at line %d, next 2 tokens "%s", %s syntax OK,
+System V %s is not implemented on this machine, syswrite() on closed
+filehandle %s, Target of goto is too deeply nested, tell() on unopened
+filehandle, That use of $[ is unsupported, The crypt() function is
+unimplemented due to excessive paranoia, The %s function is unimplemented,
+The stat preceding %s wasn't an lstat, This Perl can't reset CRTL environ
+elements (%s), This Perl can't set CRTL environ elements (%s=%s), times not
+implemented, Too few args to syscall, Too late for "B<-T>" option, Too late
+for "-%s" option, Too late to run %s block, Too many args to syscall, Too
+many arguments for %s, Too many )'s, Too many ('s, Trailing \ in regex
+m/%s/, Transliteration pattern not terminated, Transliteration replacement
+not terminated, truncate not implemented, Type of arg %d to %s must be %s
+(not %s), umask not implemented, Unable to create sub named "%s",
+Unbalanced context: %d more PUSHes than POPs, Unbalanced saves: %d more
+saves than restores, Unbalanced scopes: %d more ENTERs than LEAVEs,
+Unbalanced tmps: %d more allocs than frees, Undefined format "%s" called,
+Undefined sort subroutine "%s" called, Undefined subroutine &%s called,
+Undefined subroutine called, Undefined subroutine in sort, Undefined top
+format "%s" called, Undefined value assigned to typeglob, %s: Undefined
+variable, unexec of %s into %s failed!, Unicode character %s is illegal,
+Unknown BYTEORDER, Unknown "re" subpragma '%s' (known ones are: %s),
+Unknown switch condition (?(%.2s in regex;, Unknown open() mode '%s',
+Unknown process %x sent message to prime_env_iter: %s, Unknown warnings
+category '%s', unmatched [ in regex; marked by <-- HERE in m/%s/, unmatched
+( in regex; marked by <-- HERE in m/%s/, Unmatched right %s bracket,
+Unquoted string "%s" may clash with future reserved word, Unrecognized
+character %s, /%s/: Unrecognized escape \\%c in character class passed
+through, Unrecognized escape \\%c passed through in regex;, Unrecognized
+escape \\%c passed through, Unrecognized signal name "%s", Unrecognized
+switch: -%s  (-h will show valid options), Unsuccessful %s on filename
+containing newline, Unsupported directory function "%s" called, Unsupported
+function %s, Unsupported function fork, Unsupported script encoding,
+Unsupported socket function "%s" called, Unterminated attribute list,
+Unterminated attribute parameter in attribute list, Unterminated compressed
+integer, Unterminated <> operator, untie attempted while %d inner
+references still exist, Useless (?%s) - use /%s modifier in regex;, Useless
+(?-%s) - don't use /%s modifier in regex;, Useless use of %s in void
+context, Useless use of "re" pragma, Useless use of sort in scalar context,
+Useless use of %s with no values, "use" not allowed in expression, Use of
+bare << to mean <<"" is deprecated, Use of *glob{FILEHANDLE} is deprecated,
+Use of chdir('') or chdir(undef) as chdir() deprecated, Use of implicit
+split to @_ is deprecated, Use of inherited AUTOLOAD for non-method %s() is
+deprecated, Use of -l on filehandle %s, Use of "package" with no arguments
+is deprecated, Use of %s in printf format not supported, Use of $* is
+deprecated, Use of %s is deprecated, Use of $# is deprecated, Use of
+reference "%s" as array index, Use of reserved word "%s" is deprecated, Use
+of tainted arguments in %s is deprecated, Use of uninitialized value%s,
+Using a hash as a reference is deprecated, Using an array as a reference is
+deprecated, UTF-16 surrogate %s, Value of %s can be "0"; test with
+defined(), Value of CLI symbol "%s" too long, Variable "%s" is not
+imported%s, "%s" variable %s masks earlier declaration in same %s, Variable
+"%s" may be unavailable, Variable syntax, Variable "%s" will not stay
+shared, Variable length lookbehind not implemented in regex;, Version
+number must be a constant number, v-string in use/require is non-portable,
+Warning: something's wrong, Warning: unable to close filehandle %s
+properly, Warning: Use of "%s" without parentheses is ambiguous, Wide
+character in %s, write() on closed filehandle %s, X outside of string, x
+outside of string, Xsub "%s" called in sort, Xsub called in sort, YOU
+HAVEN'T DISABLED SET-ID SCRIPTS IN THE KERNEL YET!, You need to quote "%s"
+
 =back
 
 =head2 perllexwarn - Perl Lexical Warnings
@@ -906,7 +1202,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 +1240,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
 
@@ -2216,11 +2512,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
 
@@ -2271,9 +2563,6 @@ to enable UTF-8/UTF-EBCDIC in scripts
 
 =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
@@ -2314,6 +2603,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
@@ -3842,6 +4133,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
@@ -4310,6 +4603,10 @@ 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
@@ -4378,7 +4675,7 @@ 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,
+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,
@@ -4387,20 +4684,21 @@ 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 +4793,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 +4953,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
@@ -5107,6 +5386,8 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item REF(...) Instead Of SCALAR(...)
 
+=item pack/unpack D/F recycled
+
 =item Deprecations
 
 =back
@@ -5197,6 +5478,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 +6240,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 +7151,7 @@ R4 x86, R4 PPC
 
 =item Contact Information
 
-=item Update 2001-12-26
+=item Update 2002-03-02
 
 =back
 
@@ -6973,7 +7255,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 +7696,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 +9399,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 +9412,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 +9853,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 +9883,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()>
 
@@ -12624,7 +12907,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
 
@@ -13962,6 +14246,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 +14403,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 +14427,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 +14734,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 +14859,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 +14892,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 +14908,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
 
@@ -17458,6 +17871,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 +18158,8 @@ $Collator-E<gt>index($string, $substring)>
 
 =item EXPORT
 
+=item TODO
+
 =item CAVEAT
 
 =back
@@ -17726,6 +18197,8 @@ getCombinClass($codepoint)>, C<$is_exclusion = isExclusion($codepoint)>
 
 =item EXPORT
 
+=item TODO
+
 =back
 
 =item AUTHOR