From: Gurusamy Sarathy <gsar@cpan.org>
Date: Tue, 14 Mar 2000 19:31:53 +0000 (+0000)
Subject: regen perltoc, other pod nits
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=b38f6a391036f7db7d1fabe868dff4ea8261a014;p=p5sagit%2Fp5-mst-13.2.git

regen perltoc, other pod nits

p4raw-id: //depot/perl@5735
---

diff --git a/ext/IO/poll.c b/ext/IO/poll.c
index 0f8c843..024c52f 100644
--- a/ext/IO/poll.c
+++ b/ext/IO/poll.c
@@ -5,8 +5,8 @@
  * This program is free software; you can redistribute it and/or
  * modify it under the same terms as Perl itself.
  *
- * For systems that do not have the poll() system call (for example Linux)
- * try to emulate it as closely as possible using select()
+ * For systems that do not have the poll() system call (for example Linux
+ * kernels < v2.1.23) try to emulate it as closely as possible using select()
  *
  */
 
diff --git a/pod/Makefile b/pod/Makefile
index 50fb270..bd2e148 100644
--- a/pod/Makefile
+++ b/pod/Makefile
@@ -47,6 +47,7 @@ POD = \
 	perlipc.pod	\
 	perlthrtut.pod	\
 	perldbmfilter.pod	\
+	perldebguts.pod	\
 	perldebug.pod	\
 	perlnumber.pod	\
 	perldiag.pod	\
@@ -113,6 +114,7 @@ MAN = \
 	perlipc.man	\
 	perlthrtut.man	\
 	perldbmfilter.man	\
+	perldebguts.man	\
 	perldebug.man	\
 	perlnumber.man	\
 	perldiag.man	\
@@ -179,6 +181,7 @@ HTML = \
 	perlipc.html	\
 	perlthrtut.html	\
 	perldbmfilter.html	\
+	perldebguts.html	\
 	perldebug.html	\
 	perlnumber.html	\
 	perldiag.html	\
@@ -245,6 +248,7 @@ TEX = \
 	perlipc.tex	\
 	perlthrtut.tex	\
 	perldbmfilter.tex	\
+	perldebguts.tex	\
 	perldebug.tex	\
 	perlnumber.tex	\
 	perldiag.tex	\
diff --git a/pod/buildtoc b/pod/buildtoc
index d947ddc..21fee31 100644
--- a/pod/buildtoc
+++ b/pod/buildtoc
@@ -11,7 +11,7 @@ sub output ($);
 	   perlmod perlmodlib perlmodinstall perlfork perlform perllocale 
 	   perlref perlreftut perldsc
 	   perllol perlboot perltoot perltootc perlobj perltie perlbot perlipc
-	   perldbmfilter perldebug perlnumber
+	   perldbmfilter perldebug perlnumber perldebguts
 	   perldiag perlsec perltrap perlport perlstyle perlpod perlbook
 	   perlembed perlapio perlxs perlxstut perlguts perlcall perlcompile
 	   perlapi perlintern perlhist
diff --git a/pod/perlnumber.pod b/pod/perlnumber.pod
index d64fda4..9f628cc 100644
--- a/pod/perlnumber.pod
+++ b/pod/perlnumber.pod
@@ -26,7 +26,7 @@ p-adic arithmetic, and so on.  See L<overload> for details.
 
 =head1 Storing numbers
 
-Perl can internally represents numbers in 3 different ways: as native
+Perl can internally represent numbers in 3 different ways: as native
 integers, as native floating point numbers, and as decimal strings.
 Decimal strings may have an exponential notation part, as in C<"12.34e-56">.
 I<Native> here means "a format supported by the C compiler which was used
@@ -54,7 +54,7 @@ The upshot of all this is that Perl cannot store a number like
 12345678901234567 as a floating point number on such architectures without
 loss of information.
 
-Similarly, decimal strings may represent only those numbers which have a
+Similarly, decimal strings can represent only those numbers which have a
 finite decimal expansion.  Being strings, and thus of arbitrary length, there
 is no practical limit for the exponent or number of decimal digits for these
 numbers.  (But realize that what we are discussing the rules for just the
diff --git a/pod/perltoc.pod b/pod/perltoc.pod
index 0a67fdc..ba7cdf3 100644
--- a/pod/perltoc.pod
+++ b/pod/perltoc.pod
@@ -121,10 +121,10 @@ How do I strip blank space from the beginning/end of a string?, How do I
 pad a string with blanks or pad a number with zeroes?, How do I extract
 selected columns from a string?, How do I find the soundex value of a
 string?, How can I expand variables in text strings?, What's wrong with
-always quoting "$vars"?, Why don't my E<lt>E<lt>HERE documents work?, What
-is the difference between a list and an array?, What is the difference
-between $array[1] and @array[1]?, How can I remove duplicate elements from
-a list or array?, How can I tell whether a list or array contains a certain
+always quoting "$vars"?, Why don't my <<HERE documents work?, What is the
+difference between a list and an array?, What is the difference between
+$array[1] and @array[1]?, How can I remove duplicate elements from a list
+or array?, How can I tell whether a list or array contains a certain
 element?, How do I compute the difference of two arrays?  How do I compute
 the intersection of two arrays?, How do I test whether two arrays or hashes
 are equal?, How do I find the first array element for which a condition is
@@ -161,16 +161,16 @@ How can I use a filehandle indirectly?, How can I set up a footer format to
 be used with write()?, How can I write() into a string?, How can I output
 my numbers with commas added?, How can I translate tildes (~) in a
 filename?, How come when I open a file read-write it wipes it out?, Why do
-I sometimes get an "Argument list too long" when I use E<lt>*E<gt>?, Is
-there a leak/bug in glob()?, How can I open a file with a leading "E<gt>"
-or trailing blanks?, How can I reliably rename a file?, How can I lock a
-file?, Why can't I just open(FH, ">file.lock")?, I still don't get locking.
- I just want to increment the number in the file.  How can I do this?, How
-do I randomly update a binary file?, How do I get a file's timestamp in
-perl?, How do I set a file's timestamp in perl?, How do I print to more
-than one file at once?, How can I read in an entire file all at once?, How
-can I read in a file by paragraphs?, How can I read a single character from
-a file?  From the keyboard?, How can I tell whether there's a character
+I sometimes get an "Argument list too long" when I use <*>?, Is there a
+leak/bug in glob()?, How can I open a file with a leading ">" or trailing
+blanks?, How can I reliably rename a file?, How can I lock a file?, Why
+can't I just open(FH, ">file.lock")?, I still don't get locking.  I just
+want to increment the number in the file.  How can I do this?, How do I
+randomly update a binary file?, How do I get a file's timestamp in perl?,
+How do I set a file's timestamp in perl?, How do I print to more than one
+file at once?, How can I read in an entire file all at once?, How can I
+read in a file by paragraphs?, How can I read a single character from a
+file?  From the keyboard?, How can I tell whether there's a character
 waiting on a filehandle?, How do I do a C<tail -f> in perl?, How do I dup()
 a filehandle in Perl?, How do I close a file descriptor by number?, Why
 can't I use "C:\temp\foo" in DOS paths?  What doesn't `C:\temp\foo.exe`
@@ -210,10 +210,10 @@ Array, Hash, Method, Regex}?, How do I create a static variable?, What's
 the difference between dynamic and lexical (static) scoping?  Between
 local() and my()?, How can I access a dynamic variable while a similarly
 named lexical is in scope?, What's the difference between deep and shallow
-binding?, Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?, How do I
-redefine a builtin function, operator, or method?, What's the difference
-between calling a function as &foo and foo()?, How do I create a switch or
-case statement?, How can I catch accesses to undefined
+binding?, Why doesn't "my($foo) = <FILE>;" work right?, How do I redefine a
+builtin function, operator, or method?, What's the difference between
+calling a function as &foo and foo()?, How do I create a switch or case
+statement?, How can I catch accesses to undefined
 variables/functions/methods?, Why can't a method included in this same file
 be found?, How can I find out my current package?, How can I comment out a
 large block of perl code?, How do I clear a package?, How can I use a
@@ -382,10 +382,7 @@ What does CPAN/src/... mean?
 
 =item Perl Books
 
-References, Tutorials		
-    *Learning Perl [2nd edition]
-	by Randal L. Schwartz and Tom Christiansen
-	    with foreword by Larry Wall, Task-Oriented, Special Topics
+References, Tutorials, Task-Oriented, Special Topics
 
 =item Perl in Magazines
 
@@ -585,7 +582,7 @@ string?
 
 =item What's wrong with always quoting "$vars"?
 
-=item Why don't my E<lt>E<lt>HERE documents work?
+=item Why don't my <<HERE documents work?
 
 1. There must be no space after the << part, 2. There (probably) should be
 a semicolon at the end, 3. You can't (easily) have any space in front of
@@ -736,12 +733,11 @@ filehandles between subroutines?  How do I make an array of filehandles?
 
 =item How come when I open a file read-write it wipes it out?
 
-=item Why do I sometimes get an "Argument list too long" when I use
-E<lt>*E<gt>?
+=item Why do I sometimes get an "Argument list too long" when I use <*>?
 
 =item Is there a leak/bug in glob()?
 
-=item How can I open a file with a leading "E<gt>" or trailing blanks?
+=item How can I open a file with a leading ">" or trailing blanks?
 
 =item How can I reliably rename a file?
 
@@ -911,7 +907,7 @@ is in scope?
 
 =item What's the difference between deep and shallow binding?
 
-=item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?
+=item Why doesn't "my($foo) = <FILE>;" work right?
 
 =item How do I redefine a builtin function, operator, or method?
 
@@ -1133,7 +1129,7 @@ CGI script to do bad things?
 
 =back
 
-=head2 perldelta - what's new for perl v5.6 (as of v5.005_64)
+=head2 perldelta - what's new for perl v5.6.0
 
 =over
 
@@ -1166,7 +1162,7 @@ C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
 
 =item Compatible C Source API Changes
 
-C<PATCHLEVEL> is now C<PERL_VERSION>, Support for C++ exceptions
+C<PATCHLEVEL> is now C<PERL_VERSION>
 
 =item Binary Incompatibilities
 
@@ -1230,6 +1226,8 @@ C<PATCHLEVEL> is now C<PERL_VERSION>, Support for C++ exceptions
 
 =item File and directory handles can be autovivified
 
+=item open() with more than two arguments
+
 =item 64-bit support
 
 =item Large file support
@@ -1258,21 +1256,13 @@ C<PATCHLEVEL> is now C<PERL_VERSION>, Support for C++ exceptions
 
 =item C<use attrs> implicit in subroutine attributes
 
-=item Regular expression improvements
-
-=item Overloading improvements
-
-=item open() with more than two arguments
-
 =item Support for interpolating named characters
 
-=item Experimental support for user-hooks in @INC
-
 =item C<require> and C<do> may be overridden
 
 =item New variable $^C reflects C<-c> switch
 
-=item New variable $^V contains Perl version in v5.6.0 format
+=item New variable $^V contains Perl version as a string
 
 =item Optional Y2K warnings
 
@@ -1282,7 +1272,7 @@ C<PATCHLEVEL> is now C<PERL_VERSION>, Support for C++ exceptions
 
 =over
 
-=item E<lt>HANDLEE<gt> on empty files
+=item <HANDLE> on empty files
 
 =item C<eval '...'> improvements
 
@@ -1320,8 +1310,6 @@ C<PATCHLEVEL> is now C<PERL_VERSION>, Support for C++ exceptions
 
 =item Spurious subroutine stubs after failed subroutine calls
 
-=item Consistent numeric conversions
-
 =item Taint failures under C<-U>
 
 =item END blocks and the C<-c> switch
@@ -1342,12 +1330,6 @@ C<PATCHLEVEL> is now C<PERL_VERSION>, Support for C++ exceptions
 
 =item Optimized assignments to lexical variables
 
-=item Method lookups optimized
-
-=item Faster mechanism to invoke XSUBs
-
-=item Perl_malloc() improvements
-
 =item Faster subroutine calls
 
 =back
@@ -1356,11 +1338,11 @@ C<PATCHLEVEL> is now C<PERL_VERSION>, Support for C++ exceptions
 
 =over
 
-=item Additional supported platforms
+=item Supported platforms
 
 =item DOS
 
-=item OS/2
+=item OS390 (OpenEdition MVS)
 
 =item VMS
 
@@ -1377,13 +1359,13 @@ C<PATCHLEVEL> is now C<PERL_VERSION>, Support for C++ exceptions
 =item Modules
 
 attributes, B, ByteLoader, constant, charnames, Data::Dumper, DB, DB_File,
-Devel::DProf, Dumpvalue, Benchmark, Devel::Peek, English,
-ExtUtils::MakeMaker, Fcntl, File::Compare, File::Find, File::Glob,
-File::Spec, File::Spec::Functions, Getopt::Long, IO, JPL, lib,
-Math::BigInt, Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects,
-Pod::Checker, podchecker, Pod::ParseUtils, Pod::Find, Pod::Select,
-podselect, Pod::Usage, pod2usage, Pod::Text and Pod::Man, SDBM_File,
-Sys::Syslog, Sys::Hostname, Time::Local, Win32, DBM Filters
+Devel::DProf, Dumpvalue, Benchmark, Devel::Peek, English, Env, Fcntl,
+File::Compare, File::Find, File::Glob, File::Spec, File::Spec::Functions,
+Getopt::Long, IO, JPL, lib, Math::BigInt, Math::Complex, Math::Trig,
+Pod::Parser, Pod::InputObjects, Pod::Checker, podchecker, Pod::ParseUtils,
+Pod::Find, Pod::Select, podselect, Pod::Usage, pod2usage, Pod::Text and
+Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname, Term::ANSIColor,
+Time::Local, Win32, DBM Filters
 
 =item Pragmata
 
@@ -1393,19 +1375,19 @@ Sys::Syslog, Sys::Hostname, Time::Local, Win32, DBM Filters
 
 =over
 
-=item h2ph
-
 =item perlcc
 
-=item h2xs
+=item perldoc
+
+=item The Perl Debugger
 
 =back
 
 =item Documentation Changes
 
-perlapi.pod, perlcompile.pod, perlfilter.pod, perlhack.pod, perlintern.pod,
-perlopentut.pod, perlreftut.pod, perlboot.pod, perltootc.pod,
-perlunicode.pod
+perlapi.pod, perlcompile.pod, perldebug.pod, perldebguts.pod,
+perlfilter.pod, perlhack.pod, perlintern.pod, perlopentut.pod,
+perlreftut.pod, perlboot.pod, perltootc.pod, perlunicode.pod
 
 =item New or Changed Diagnostics
 
@@ -1429,35 +1411,35 @@ Can't read CRTL environ, Can't remove %s: %s, skipping file, Can't return
 %s from lvalue subroutine, Can't weaken a nonreference, Character class
 [:%s:] unknown, Character class syntax [%s] belongs inside character
 classes, Constant is not %s reference, constant(%s): %%^H is not localized,
-constant(%s): %s, defined(@array) is deprecated, defined(%hash) is
-deprecated, Did not produce a valid header, Did you mean "local" instead of
-"our"?, Document contains no data, entering effective %s failed, false []
-range "%s" in regexp, Filehandle %s opened only for output, flock() on
-closed filehandle %s, Global symbol "%s" requires explicit package name,
-Hexadecimal number > 0xffffffff non-portable, Ill-formed CRTL environ value
-"%s", Ill-formed message in prime_env_iter: |%s|, Illegal binary digit %s,
-Illegal binary digit %s ignored, Illegal number of bits in vec, Integer
-overflow in %s number, Invalid %s attribute: %s, Invalid %s attributes: %s,
-invalid [] range "%s" in regexp, Invalid separator character %s in
-attribute list, Invalid separator character %s in subroutine attribute
-list, leaving effective %s failed, Lvalue subs returning %s not implemented
-yet, Method %s not permitted, Missing %sbrace%s on \N{}, Missing command in
-piped open, Missing name in "my sub", No %s specified for -%c, No package
-name allowed for variable %s in "our", No space allowed after -%c, no UTC
-offset information; assuming local time is UTC, Octal number > 037777777777
-non-portable, panic: del_backref, panic: kid popen errno read, panic:
-magic_killbackrefs, Parentheses missing around "%s" list, Possible Y2K bug:
-%s, Premature end of script headers, Repeat count in pack overflows, Repeat
-count in unpack overflows, realloc() of freed memory ignored, Reference is
-already weak, setpgrp can't take arguments, Strange *+?{} on zero-length
-expression, switching effective %s is not implemented, This Perl can't
-reset CRTL environ elements (%s), This Perl can't set CRTL environ elements
-(%s=%s), Unknown open() mode '%s', Unknown process %x sent message to
-prime_env_iter: %s, Unrecognized escape \\%c passed through, Unterminated
-attribute parameter in attribute list, Unterminated attribute list,
-Unterminated attribute parameter in subroutine attribute list, Unterminated
-subroutine attribute list, Value of CLI symbol "%s" too long, Version
-number must be a constant number
+constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
+defined(%hash) is deprecated, Did not produce a valid header, Did you mean
+"local" instead of "our"?, Document contains no data, entering effective %s
+failed, false [] range "%s" in regexp, Filehandle %s opened only for
+output, flock() on closed filehandle %s, Global symbol "%s" requires
+explicit package name, Hexadecimal number > 0xffffffff non-portable,
+Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
+|%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
+number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
+%s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
+separator character %s in attribute list, Invalid separator character %s in
+subroutine attribute list, leaving effective %s failed, Lvalue subs
+returning %s not implemented yet, Method %s not permitted, Missing
+%sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
+No %s specified for -%c, No package name allowed for variable %s in "our",
+No space allowed after -%c, no UTC offset information; assuming local time
+is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
+panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
+around "%s" list, Possible Y2K bug: %s, Premature end of script headers,
+Repeat count in pack overflows, Repeat count in unpack overflows, realloc()
+of freed memory ignored, Reference is already weak, setpgrp can't take
+arguments, Strange *+?{} on zero-length expression, switching effective %s
+is not implemented, This Perl can't reset CRTL environ elements (%s), This
+Perl can't set CRTL environ elements (%s=%s), Unknown open() mode '%s',
+Unknown process %x sent message to prime_env_iter: %s, Unrecognized escape
+\\%c passed through, Unterminated attribute parameter in attribute list,
+Unterminated attribute list, Unterminated attribute parameter in subroutine
+attribute list, Unterminated subroutine attribute list, Value of CLI symbol
+"%s" too long, Version number must be a constant number
 
 =item Obsolete Diagnostics
 
@@ -1618,8 +1600,6 @@ regular expressions
 
 =item Bitwise String Operators
 
-=item Strings of Character
-
 =item Integer Arithmetic
 
 =item Floating-point Arithmetic
@@ -1647,8 +1627,8 @@ cntrl, graph, print, punct, xdigit
 =item Extended Patterns
 
 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
-C<(?=pattern)>, C<(?!pattern)>, C<(?E<lt>=pattern)>, C<(?<!pattern)>, C<(?{
-code })>, C<(??{ code })>, C<(?E<gt>pattern)>,
+C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
+code })>, C<(??{ code })>, C<< (?>pattern) >>,
 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
 
 =item Backtracking
@@ -1662,7 +1642,7 @@ C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
 =item Combining pieces together
 
 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
-C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<(?E<gt>S)>, C<(?=S)>, C<(?<=S)>,
+C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
 C<(?(condition)yes-pattern|no-pattern)>
 
@@ -1739,28 +1719,28 @@ in perl5
 
 I<-X> FILEHANDLE, I<-X> EXPR, I<-X>, abs VALUE, abs, accept
 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
-binmode FILEHANDLE, bless REF,CLASSNAME, bless REF, caller EXPR, caller,
-chdir EXPR, chmod LIST, chomp VARIABLE, chomp LIST, chomp, chop VARIABLE,
-chop LIST, chop, chown LIST, chr NUMBER, chr, chroot FILENAME, chroot,
-close FILEHANDLE, close, closedir DIRHANDLE, connect SOCKET,NAME, continue
-BLOCK, cos EXPR, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen
-HASH,DBNAME,MASK, defined EXPR, defined, delete EXPR, die LIST, do BLOCK,
-do SUBROUTINE(LIST), do EXPR, dump LABEL, dump, each HASH, eof FILEHANDLE,
-eof (), eof, eval EXPR, eval BLOCK, exec LIST, exec PROGRAM LIST, exists
-EXPR, exit EXPR, exp EXPR, exp, fcntl FILEHANDLE,FUNCTION,SCALAR, fileno
-FILEHANDLE, flock FILEHANDLE,OPERATION, fork, format, formline
-PICTURE,LIST, getc FILEHANDLE, getc, getlogin, getpeername SOCKET, getpgrp
-PID, getppid, getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME,
-gethostbyname NAME, getnetbyname NAME, getprotobyname NAME, getpwuid UID,
-getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE,
-getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport
-PORT,PROTO, getpwent, getgrent, gethostent, getnetent, getprotoent,
-getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent STAYOPEN,
-setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, endhostent,
-endnetent, endprotoent, endservent, getsockname SOCKET, getsockopt
-SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL, goto EXPR,
-goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex, import, index
-STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
+binmode FILEHANDLE, DISCIPLINE, binmode FILEHANDLE, bless REF,CLASSNAME,
+bless REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE,
+chomp LIST, chomp, chop VARIABLE, chop LIST, chop, chown LIST, chr NUMBER,
+chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE,
+connect SOCKET,NAME, continue BLOCK, cos EXPR, crypt PLAINTEXT,SALT,
+dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete
+EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump,
+each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST,
+exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl
+FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION,
+fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin,
+getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam
+NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname
+NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr
+ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
+getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
+getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent
+STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
+endhostent, endnetent, endprotoent, endservent, getsockname SOCKET,
+getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL,
+goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex,
+import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
 FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST,
 last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length,
 link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR,
@@ -1768,7 +1748,7 @@ lock, log EXPR, log, lstat FILEHANDLE, lstat EXPR, lstat, m//, map BLOCK
 LIST, map EXPR,LIST, mkdir FILENAME,MASK, mkdir FILENAME, msgctl
 ID,CMD,ARG, msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv
 ID,VAR,SIZE,TYPE,FLAGS, my EXPR, my EXPR : ATTRIBUTES, next LABEL, next, no
-Module LIST, oct EXPR, oct, open FILEHANDLE,MODE,EXPR, open
+Module LIST, oct EXPR, oct, open FILEHANDLE,MODE,LIST, open
 FILEHANDLE,EXPR, open FILEHANDLE, opendir DIRHANDLE,EXPR, ord EXPR, ord,
 our EXPR, pack TEMPLATE,LIST, package, package NAMESPACE, pipe
 READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos, print FILEHANDLE
@@ -1824,7 +1804,7 @@ LIST, write FILEHANDLE, write EXPR, write, y///
 
 =item Predefined Names
 
-$ARG, $_, $E<lt>I<digits>E<gt>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
+$ARG, $_, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
 $LAST_PAREN_MATCH, $+, @+, $MULTILINE_MATCHING, $*, input_line_number
 HANDLE EXPR, $INPUT_LINE_NUMBER, $NR, $, input_record_separator HANDLE
 EXPR, $INPUT_RECORD_SEPARATOR, $RS, $/, autoflush HANDLE EXPR,
@@ -2152,7 +2132,7 @@ localization)
 
 =item Permanently fixing locale problems
 
-=item Permanently fixing your locale configuration
+=item Permanently fixing your system's locale configuration
 
 =item Fixing system locale configuration
 
@@ -2843,24 +2823,28 @@ B<filter_fetch_value>
 =item Debugger Commands
 
 h [command], p expr, x expr, V [pkg [vars]], X [vars], T, s [expr], n
-[expr], E<lt>CRE<gt>, c [line|sub], l, l min+incr, l min-max, l line, l
-subname, -, w [line], f filename, /pattern/, ?pattern?, L, S [[!]pattern],
-t, t expr, b [line] [condition], b subname [condition], b postpone subname
+[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, W [expr], W, O [opt[=val]] [opt"val"] [opt?]..,
+command, a [line], A, W expr, W, O booloption .., O anyoption? .., O
+option=value .., < ?, < [ command ], << command, > ?, > command, >>
+command, { ?, { [ command ], {{ command, ! number, ! -number, ! pattern, !!
+cmd, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, man [manpage]
+
+=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<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>, E<lt> [ command ],
-E<lt>E<lt> command, E<gt> command, E<gt>E<gt> command, { [ command ], {{
-command, ! number, ! -number, ! pattern, !! cmd, H -number, q or ^D, R,
-|dbcmd, ||dbcmd, command, m expr, m package
+C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>, C<NonStop>
 
 =item Debugger input/output
 
-Prompt, Multiline commands, Stack backtrace, Listing, Frame listing
+Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
+listing
 
 =item Debugging compile-time statements
 
@@ -2872,38 +2856,59 @@ Prompt, Multiline commands, Stack backtrace, Listing, Frame listing
 
 =item The Perl Profiler
 
-=item Debugger support in perl
+=back
 
-=item Debugger Internals
+=item Debugging regular expressions
+
+=item Debugging memory usage
 
-=item Other resources
+=item SEE ALSO
 
 =item BUGS
 
 =back
 
-=item Debugging Perl memory usage
+=head2 perlnumber - semantics of numbers and numeric operations in Perl
 
 =over
 
-=item Using C<$ENV{PERL_DEBUG_MSTATS}>
+=item SYNOPSIS
 
-C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
-SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
-6144>
+=item DESCRIPTION
 
-=item Example of using B<-DL> switch
+=item Storing numbers
 
-C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
+=item Numeric operators and numeric conversions
 
-=item B<-DL> details
+=item Flavors of Perl numeric operations
 
-C<!!!>, C<!!>, C<!>
+Arithmetic operators except, C<no integer>, Arithmetic operators except,
+C<use integer>, Bitwise operators, C<no integer>, Bitwise operators, C<use
+integer>, Operators which expect an integer, Operators which expect a
+string
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
 
-=item Limitations of B<-DL> statistic
+=head2 perldebguts - Guts of Perl debugging 
+
+=over
+
+=item DESCRIPTION
+
+=item Debugger Internals
+
+=over
+
+=item Writing Your Own Debugger
 
 =back
 
+=item Frame Listing Output Examples
+
 =item Debugging regular expressions
 
 =over
@@ -2921,28 +2926,27 @@ C<anchored(TYPE)>
 
 =back
 
-=back
-
-=head2 perlnumber - semantics of numbers and numeric operations in Perl
+=item Debugging Perl memory usage
 
 =over
 
-=item SYNOPSIS
+=item Using C<$ENV{PERL_DEBUG_MSTATS}>
 
-=item DESCRIPTION
+C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
+SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
+6144>
 
-=item Storing numbers
+=item Example of using B<-DL> switch
 
-=item Numeric operators and numeric conversions
+C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
 
-=item Flavors of Perl numeric operations
+=item B<-DL> details
 
-Arithmetic operators except, C<no integer>, Arithmetic operators except,
-C<use integer>, Bitwise operators, C<no integer>, Bitwise operators, C<use
-integer>, Operators which expect an integer, Operators which expect a
-string
+C<!!!>, C<!!>, C<!>
 
-=item AUTHOR
+=item Limitations of B<-DL> statistics
+
+=back
 
 =item SEE ALSO
 
@@ -3170,22 +3174,22 @@ F<README.plan9>
 
 =item Alphabetical Listing of Perl Functions
 
--I<X> FILEHANDLE, -I<X> EXPR, -I<X>, binmode FILEHANDLE, chmod LIST, chown
-LIST, chroot FILENAME, chroot, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen
-HASH,DBNAME,MODE, dump LABEL, exec LIST, fcntl FILEHANDLE,FUNCTION,SCALAR,
-flock FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid,
-getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME,
-getpwuid UID, getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber
-NUMBER, getservbyport PORT,PROTO, getpwent, getgrent, gethostent,
-getnetent, getprotoent, getservent, setpwent, setgrent, sethostent
-STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN,
-endpwent, endgrent, endhostent, endnetent, endprotoent, endservent,
-getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl
-FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat
-FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd
-ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open
-FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select
-RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
+-I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
+FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
+PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
+LIST, fcntl FILEHANDLE,FUNCTION,SCALAR, flock FILEHANDLE,OPERATION, fork,
+getlogin, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam NAME,
+getgrnam NAME, getnetbyname NAME, getpwuid UID, getgrgid GID, getnetbyaddr
+ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent,
+getgrent, gethostent, getnetent, getprotoent, getservent, setpwent,
+setgrent, sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN,
+setservent STAYOPEN, endpwent, endgrent, endhostent, endnetent,
+endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob,
+ioctl FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link OLDFILE,NEWFILE,
+lstat FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS,
+msgsnd ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR,
+open FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink,
+select RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
 KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
@@ -3206,6 +3210,8 @@ v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May 1999, v1.40, 11 April
 1998, v1.36, 9 September 1998, v1.35, 13 August 1998, v1.33, 06 August
 1998, v1.32, 05 August 1998, v1.30, 03 August 1998, v1.23, 10 July 1998
 
+=item Supported Platforms
+
 =item AUTHORS / CONTRIBUTORS
 
 =item VERSION
@@ -3738,13 +3744,13 @@ B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
 
 =over
 
-=item The Cross Referencing Back End (B::Xref)
+=item The Cross Referencing Back End
 
 i, &, s, r
 
 =item The Decompiling Back End
 
-=item The Lint Back End (B::Lint)
+=item The Lint Back End
 
 =item The Simple C Back End
 
@@ -4081,13 +4087,6 @@ new, phash
 
 =item SYNOPSIS
 
-    $can_perhaps_read = -r "file";	# use the mode bits
-    {
-	use filetest 'access';		# intuit harder
-	$can_really_read = -r "file";
-    }
-    $can_perhaps_read = -r "file";	# use the mode bits again
-
 =item DESCRIPTION
 
 =over
@@ -4154,6 +4153,20 @@ operations
 
 =back
 
+=head2 open - perl pragma to set default disciplines for input and output
+
+=over
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item UNIMPLEMENTED FUNCTIONALITY
+
+=item SEE ALSO
+
+=back
+
 =head2 ops - Perl pragma to restrict unsafe operations when compiling
 
 =over
@@ -4354,7 +4367,8 @@ C<strict refs>, C<strict vars>, C<strict subs>
 
 =item DESCRIPTION
 
-warnings::enabled($category), warnings::warn($category, $message)
+use warnings::register, warnings::enabled([$category]),
+warnings::warn([$category,] $message)
 
 =back
 
@@ -5124,8 +5138,7 @@ parameters in the B<header()> and B<redirect()>  statements:
 
 =item Server Push
 
-multipart_init()     
-  multipart_init(-boundary=>$boundary);, multipart_start(), multipart_end()
+multipart_init(), multipart_start(), multipart_end()
 
 =item Avoiding Denial of Service Attacks
 
@@ -5564,45 +5577,46 @@ C<d_getspent>, C<d_getspnam>, C<d_gettimeod>, C<d_gnulibc>, C<d_grpasswd>,
 C<d_hasmntopt>, C<d_htonl>, C<d_iconv>, C<d_index>, C<d_inetaton>,
 C<d_int64_t>, C<d_isascii>, C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>,
 C<d_link>, C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>,
-C<d_lseekproto>, C<d_lstat>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>,
-C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>,
-C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>,
-C<d_mktime>, C<d_mmap>, C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>,
-C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>,
-C<d_msgctl>, C<d_msgget>, C<d_msgrcv>, C<d_msgsnd>, C<d_msync>,
-C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nv_preserves_uv>, C<d_off64_t>,
-C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
-C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_phostname>, C<d_pipe>,
-C<d_poll>, C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEldbl>,
-C<d_PRIfldbl>, C<d_PRIFldbl>, C<d_PRIgldbl>, C<d_PRIGldbl>, C<d_PRIi64>,
-C<d_PRIo64>, C<d_PRIu64>, C<d_PRIx64>, C<d_PRIX64>, C<d_pthread_yield>,
-C<d_pwage>, C<d_pwchange>, C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>,
-C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>, C<d_quad>, C<d_readdir>,
-C<d_readlink>, C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>,
-C<d_safemcpy>, C<d_sanemcmp>, C<d_sched_yield>, C<d_scm_rights>,
-C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>, C<d_semctl_semid_ds>,
-C<d_semctl_semun>, C<d_semget>, C<d_semop>, C<d_setegid>, C<d_seteuid>,
-C<d_setgrent>, C<d_setgrps>, C<d_sethent>, C<d_setlinebuf>, C<d_setlocale>,
-C<d_setnent>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>,
-C<d_setprior>, C<d_setpwent>, C<d_setregid>, C<d_setresgid>,
-C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>,
-C<d_setsid>, C<d_setspent>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>,
-C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>,
-C<d_sigsetjmp>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>, C<d_sqrtl>,
-C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>,
-C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, C<d_stdio_stream_array>,
-C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>,
-C<d_strerrm>, C<d_strerror>, C<d_strtod>, C<d_strtol>, C<d_strtold>,
-C<d_strtoll>, C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>,
-C<d_suidsafe>, C<d_symlink>, C<d_syscall>, C<d_sysconf>, C<d_sysernlst>,
-C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
+C<d_lseekproto>, C<d_lstat>, C<d_madvise>, C<d_mblen>, C<d_mbstowcs>,
+C<d_mbtowc>, C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>,
+C<d_memset>, C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>,
+C<d_mkstemps>, C<d_mktime>, C<d_mmap>, C<d_mprotect>, C<d_msg>,
+C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>,
+C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msgrcv>, C<d_msgsnd>,
+C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nv_preserves_uv>,
+C<d_off64_t>, C<d_old_pthread_create_joinable>, C<d_oldpthreads>,
+C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_phostname>,
+C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>,
+C<d_PRIEldbl>, C<d_PRIfldbl>, C<d_PRIFldbl>, C<d_PRIgldbl>, C<d_PRIGldbl>,
+C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>, C<d_PRIx64>, C<d_PRIX64>,
+C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>, C<d_pwclass>,
+C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>,
+C<d_qgcvt>, C<d_quad>, C<d_readdir>, C<d_readlink>, C<d_rename>,
+C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>,
+C<d_sched_yield>, C<d_scm_rights>, C<d_seekdir>, C<d_select>, C<d_sem>,
+C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>,
+C<d_semop>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, C<d_setgrps>,
+C<d_sethent>, C<d_setlinebuf>, C<d_setlocale>, C<d_setnent>, C<d_setpent>,
+C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>, C<d_setprior>, C<d_setpwent>,
+C<d_setregid>, C<d_setresgid>, C<d_setresuid>, C<d_setreuid>, C<d_setrgid>,
+C<d_setruid>, C<d_setsent>, C<d_setsid>, C<d_setspent>, C<d_setvbuf>,
+C<d_sfio>, C<d_shm>, C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>,
+C<d_shmdt>, C<d_shmget>, C<d_sigaction>, C<d_sigsetjmp>, C<d_socket>,
+C<d_socklen_t>, C<d_sockpair>, C<d_sqrtl>, C<d_statblks>,
+C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>,
+C<d_stdio_ptr_lval>, C<d_stdio_stream_array>, C<d_stdiobase>,
+C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>,
+C<d_strerror>, C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>,
+C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>,
+C<d_symlink>, C<d_syscall>, 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_umask>, C<d_uname>, C<d_union_semun>, C<d_ustat>, 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_xenix>, C<date>, C<db_hashtype>, C<db_prefixtype>,
-C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>, C<doublesize>,
-C<drand01>, C<dynamic_ext>
+C<d_umask>, C<d_uname>, C<d_union_semun>, 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_xenix>, C<date>,
+C<db_hashtype>, C<db_prefixtype>, C<defvoidused>, C<direntrytype>,
+C<dlext>, C<dlsrc>, C<doublesize>, C<drand01>, C<dynamic_ext>
 
 =item e
 
@@ -5628,24 +5642,25 @@ C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<huge>
 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_db>, C<i_dbm>,
 C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>, C<i_gdbm>,
-C<i_grp>, C<i_iconv>, C<i_inttypes>, C<i_limits>, C<i_locale>,
+C<i_grp>, C<i_iconv>, C<i_ieeefp>, C<i_inttypes>, C<i_limits>, C<i_locale>,
 C<i_machcthr>, C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>,
 C<i_netdb>, C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>,
 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
-C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>, C<i_sysin>,
-C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>, C<i_sysmount>,
-C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>, C<i_sysselct>,
-C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>, C<i_sysstatvfs>,
-C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>, C<i_sysuio>,
-C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>, C<i_termio>,
-C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>, C<i_values>,
-C<i_varargs>, C<i_varhdr>, C<i_vfork>, C<ignore_versioned_solibs>,
-C<inc_version_list>, C<inc_version_list_init>, C<incpath>, C<inews>,
-C<installarchlib>, C<installbin>, C<installman1dir>, C<installman3dir>,
-C<installprefix>, C<installprefixexp>, C<installprivlib>, C<installscript>,
-C<installsitearch>, C<installsitebin>, C<installsitelib>, C<installstyle>,
-C<installusrbinperl>, C<installvendorbin>, C<installvendorlib>, C<intsize>,
+C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
+C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
+C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
+C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
+C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
+C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
+C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
+C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
+C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
+C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installman1dir>,
+C<installman3dir>, C<installprefix>, C<installprefixexp>,
+C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>,
+C<installsitelib>, C<installstyle>, C<installusrbinperl>,
+C<installvendorarch>, C<installvendorbin>, C<installvendorlib>, C<intsize>,
 C<ivdformat>, C<ivsize>, C<ivtype>
 
 =item k
@@ -5712,15 +5727,15 @@ C<selectminbits>, C<selecttype>, C<sendmail>, C<sh>, C<shar>, C<sharpbang>,
 C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>, C<sig_count>,
 C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>, C<signal_t>,
 C<sitearch>, C<sitearchexp>, C<sitebin>, C<sitebinexp>, C<sitelib>,
-C<sitelibexp>, C<siteprefix>, C<siteprefixexp>, C<sizetype>, C<sleep>,
-C<smail>, C<small>, C<so>, C<sockethdr>, C<socketlib>, C<socksizetype>,
-C<sort>, C<spackage>, C<spitshell>, C<split>, C<sPRId64>, C<sPRIeldbl>,
-C<sPRIEldbl>, C<sPRIfldbl>, C<sPRIFldbl>, C<sPRIgldbl>, C<sPRIGldbl>,
-C<sPRIi64>, C<sPRIo64>, C<sPRIu64>, C<sPRIx64>, C<sPRIX64>, C<src>,
-C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>, C<stdchar>,
-C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>,
-C<stdio_ptr>, C<stdio_stream_array>, C<strings>, C<submit>, C<subversion>,
-C<sysman>
+C<sitelib_stem>, C<sitelibexp>, C<siteprefix>, C<siteprefixexp>,
+C<sizetype>, C<sleep>, C<smail>, C<small>, C<so>, C<sockethdr>,
+C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>,
+C<split>, C<sPRId64>, C<sPRIeldbl>, C<sPRIEldbl>, C<sPRIfldbl>,
+C<sPRIFldbl>, C<sPRIgldbl>, C<sPRIGldbl>, C<sPRIi64>, C<sPRIo64>,
+C<sPRIu64>, C<sPRIx64>, C<sPRIX64>, C<src>, C<ssizetype>, C<startperl>,
+C<startsh>, C<static_ext>, C<stdchar>, C<stdio_base>, C<stdio_bufsiz>,
+C<stdio_cnt>, C<stdio_filbuf>, C<stdio_ptr>, C<stdio_stream_array>,
+C<strings>, C<submit>, C<subversion>, C<sysman>
 
 =item t
 
@@ -5741,8 +5756,9 @@ C<uvxformat>
 
 =item v
 
-C<vendorbin>, C<vendorbinexp>, C<vendorlib>, C<vendorlibexp>,
-C<vendorprefix>, C<vendorprefixexp>, C<version>, C<vi>, C<voidflags>
+C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
+C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>, C<vendorprefix>,
+C<vendorprefixexp>, C<version>, C<vi>, C<voidflags>
 
 =item x
 
@@ -5954,14 +5970,13 @@ printing and C<eval>
 =item Methods
 
 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or> 
-I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dumpxs	I<or> 
-I<PACKAGE>->Dumpxs(I<ARRAYREF [>, I<ARRAYREF]>),
-I<$OBJ>->Seen(I<[HASHREF]>), I<$OBJ>->Values(I<[ARRAYREF]>),
-I<$OBJ>->Names(I<[ARRAYREF]>), I<$OBJ>->Reset
+I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
+I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
+I<$OBJ>->Reset
 
 =item Functions
 
-Dumper(I<LIST>), DumperX(I<LIST>)
+Dumper(I<LIST>)
 
 =item Configuration Variables or Methods
 
@@ -6114,7 +6129,7 @@ veryCompact, set, get
 
 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
-dl_load_file(), dl_loadflags(), dl_find_symbol(),
+dl_load_file(), dl_unload_file(), dl_loadflags(), dl_find_symbol(),
 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
 bootstrap()
 
@@ -6148,7 +6163,8 @@ variables
 
 =back
 
-=head2 Env - perl module that imports environment variables
+=head2 Env - perl module that imports environment variables as scalars or
+arrays
 
 =over
 
@@ -6156,6 +6172,8 @@ variables
 
 =item DESCRIPTION
 
+=item LIMITATIONS
+
 =item AUTHOR
 
 =back
@@ -7254,10 +7272,6 @@ splitdir (override)
 
 catpath (override)
 
-splitpath
-
-splitdir
-
 =over
 
 =item SEE ALSO
@@ -7372,8 +7386,7 @@ $fh->print, $fh->printf, $fh->getline, $fh->getlines
 
 =back
 
-=head2 Getopt::Long, GetOptions - extended processing of command line
-options
+=head2 Getopt::Long - Extended processing of command line options
 
 =over
 
@@ -7381,36 +7394,72 @@ options
 
 =item DESCRIPTION
 
-!, +, :s, :i, :f
+=item Command Line Options, an Introduction
+
+=item Getting Started with Getopt::Long
 
 =over
 
-=item Linkage specification
+=item Simple options
 
-=item Aliases and abbreviations
+=item A little bit less simple options
 
-=item Non-option call-back routine
+=item Mixing command line option with other arguments
 
-=item Option starters
+=item Options with values
 
-=item Return values and Errors
+=item Options with multiple values
+
+=item Options with hash values
+
+=item User-defined subroutines to handle options
+
+=item Options with multiple names
+
+=item Case and abbreviations
+
+=item Summary of Option Specifications
+
+!, +, s, i, f, : I<type> [ I<desttype> ]
 
 =back
 
-=item COMPATIBILITY
+=item Advanced Possibilities
 
-=item EXAMPLES
+=over
+
+=item Documentation and help texts
+
+=item Storing options in a hash
+
+=item Bundling
+
+=item The lonesome dash
+
+=item Argument call-back
+
+=back
 
-=item CONFIGURATION OPTIONS
+=item Configuring Getopt::Long
 
 default, auto_abbrev, getopt_compat, require_order, permute, bundling
 (default: reset), bundling_override (default: reset), ignore_case 
 (default: set), ignore_case_always (default: reset), pass_through (default:
 reset), prefix, prefix_pattern, debug (default: reset)
 
-=item OTHER USEFUL VARIABLES
+=item Return values and Errors
+
+=item Legacy
+
+=over
 
-$Getopt::Long::VERSION, $Getopt::Long::error
+=item Default destinations
+
+=item Alternative option starters
+
+=item Configuration variables
+
+=back
 
 =item AUTHOR
 
@@ -8059,7 +8108,8 @@ set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
 
 =back
 
-=head2 Math::BigFloat - Arbitrary length float math package
+=head2 MD5-1.7::MD5, MD5 - Perl interface to the RSA Data Security Inc. MD5
+Message-Digest Algorithm
 
 =over
 
@@ -8067,16 +8117,18 @@ set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
 
 =item DESCRIPTION
 
-number format, Error returns 'NaN', Division is computed to, Rounding is
-performed
+=item EXAMPLES
 
-=item BUGS
+=item NOTE
 
 =item AUTHOR
 
+=item SEE ALSO
+
 =back
 
-=head2 Math::BigInt - Arbitrary size integer math package
+=head2 MD5-1.7::blib::MD5, MD5 - Perl interface to the RSA Data Security
+Inc. MD5 Message-Digest Algorithm
 
 =over
 
@@ -8084,20 +8136,17 @@ performed
 
 =item DESCRIPTION
 
-Canonical notation, Input, Output
-
 =item EXAMPLES
 
-=item Autocreating constants
-
-=item BUGS
+=item NOTE
 
 =item AUTHOR
 
+=item SEE ALSO
+
 =back
 
-=head2 Math::Complex - complex numbers and associated mathematical
-functions
+=head2 Math::BigFloat - Arbitrary length float math package
 
 =over
 
@@ -8105,21 +8154,32 @@ functions
 
 =item DESCRIPTION
 
-=item OPERATIONS
+number format, Error returns 'NaN', Division is computed to, Rounding is
+performed
 
-=item CREATION
+=item BUGS
 
-=item STRINGIFICATION
+=item AUTHOR
 
-=item USAGE
+=back
+
+=head2 Math::BigInt - Arbitrary size integer math package
+
+=over
 
-=item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
+=item SYNOPSIS
 
-=item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
+=item DESCRIPTION
+
+Canonical notation, Input, Output
+
+=item EXAMPLES
+
+=item Autocreating constants
 
 =item BUGS
 
-=item AUTHORS
+=item AUTHOR
 
 =back
 
@@ -8617,9 +8677,9 @@ B<-verbose>, B<-perl>, B<-script>, B<-inc>
 
 =item ARGUMENTS
 
-help, htmldir, htmlroot, infile, outfile, podroot, podpath, libpods,
-netscape, nonetscape, index, noindex, recurse, norecurse, title, css,
-verbose, quiet
+backlink, css, flush, header, help, htmldir, htmlroot, index, infile,
+libpods, netscape, outfile, podpath, podroot, quiet, recurse, title,
+verbose
 
 =item EXAMPLE
 
@@ -8881,8 +8941,6 @@ EE<lt>%sE<gt>, Unknown sequence %s, Unmatched =back
 
 =item BUGS
 
-=item NOTES
-
 =item SEE ALSO
 
 =item AUTHOR
@@ -9009,7 +9067,8 @@ idx()
 
 =item PARSING OPTIONS
 
-B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset)
+B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
+B<-warnings> (default: unset)
 
 =back
 
@@ -9231,6 +9290,26 @@ I<code-ref>|I<method-name>
 
 =back
 
+=head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
+
+=over
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over
+
+=item EXPORT
+
+=back
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
 =head2 Pod::Select, podselect() - extract selected sections of POD from
 input
 
@@ -9608,6 +9687,26 @@ closelog
 
 =back
 
+=head2 Term::ANSIColor - Color screen output using ANSI escape sequences
+
+=over
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item DIAGNOSTICS
+
+Invalid attribute name %s, Identifier %s used only once: possible typo, No
+comma allowed after filehandle, Bareword %s not allowed while "strict subs"
+in use
+
+=item RESTRICTIONS
+
+=item AUTHORS
+
+=back
+
 =head2 Term::Cap - Perl termcap interface
 
 =over
@@ -10071,6 +10170,84 @@ functions
 
 =back
 
+=head2 XML-Writer-0.3::Writer, XML::Writer - Perl extension for writing XML
+documents.
+
+=over
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item METHODS
+
+=over
+
+=item Writing XML
+
+new([$params]), OUTPUT, NAMESPACES, PREFIX_MAP, NEWLINES, UNSAFE, end(),
+xmlDecl([$encoding, $standalone]), doctype($name, [$publicId, $systemId]),
+comment($text), pi($target [, $data]), startTag($name [, $aname1 =>
+$value1, ...]), emptyTag($name [, $aname1 => $value1, ...]),
+endTag([$name]), characters($data)
+
+=item Querying XML
+
+in_element($name), within_element($name), current_element(), ancestor($n)
+
+=item Additional Namespace Support
+
+addPrefix($uri, $prefix), removePrefix($uri)
+
+=back
+
+=item ERROR REPORTING
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
+=head2 XML-Writer-0.3::blib::XML::Writer, XML::Writer - Perl extension for
+writing XML documents.
+
+=over
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item METHODS
+
+=over
+
+=item Writing XML
+
+new([$params]), OUTPUT, NAMESPACES, PREFIX_MAP, NEWLINES, UNSAFE, end(),
+xmlDecl([$encoding, $standalone]), doctype($name, [$publicId, $systemId]),
+comment($text), pi($target [, $data]), startTag($name [, $aname1 =>
+$value1, ...]), emptyTag($name [, $aname1 => $value1, ...]),
+endTag([$name]), characters($data)
+
+=item Querying XML
+
+in_element($name), within_element($name), current_element(), ancestor($n)
+
+=item Additional Namespace Support
+
+addPrefix($uri, $prefix), removePrefix($uri)
+
+=back
+
+=item ERROR REPORTING
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
 =head2 XSLoader - Dynamically load C libraries into Perl code
 
 =over
diff --git a/pod/roffitall b/pod/roffitall
index ebfcc7e..018c0b3 100644
--- a/pod/roffitall
+++ b/pod/roffitall
@@ -56,6 +56,7 @@ toroff=`
     $mandir/perlbot.1	\
     $mandir/perlipc.1	\
     $mandir/perlthrtut.1	\
+    $mandir/perldebguts.1	\
     $mandir/perldebug.1	\
     $mandir/perlnumber.1	\
     $mandir/perldiag.1	\