avoid warnings in diagnostics.pm; pod tweaks (from Peter Prymmer
[p5sagit/p5-mst-13.2.git] / pod / perltoc.pod
index ba7cdf3..6397388 100644 (file)
@@ -95,8 +95,8 @@ line?, Why don't perl one-liners work on my DOS/Mac/VMS system?, Where can
 I learn about CGI or Web programming in Perl?, Where can I learn about
 object-oriented Perl programming?, Where can I learn about linking C with
 Perl? [h2xs, xsubpp], I've read perlembed, perlguts, etc., but I can't
-embed perl inmy C program, what am I doing wrong?, When I tried to run my
-script, I got this message. What does itmean?, What's MakeMaker?,
+embed perl in my C program, what am I doing wrong?, When I tried to run my
+script, I got this message. What does it mean?, What's MakeMaker?,
 L<perlfaq4>: Data Manipulation, Why am I getting long decimals (eg,
 19.9499999999999) instead of the numbers I should be getting (eg, 19.95)?,
 Why isn't my octal data interpreted correctly?, Does Perl have a round()
@@ -1135,131 +1135,112 @@ CGI script to do bad things?
 
 =item DESCRIPTION
 
-=item Incompatible Changes
+=item Core Enhancements
 
 =over
 
-=item Perl Source Incompatibilities
-
-CHECK is a new keyword, Treatment of list slices of undef has changed
-
-=item Perl's version numbering has changed
-
-Literals of the form C<1.2.3> parse differently, Possibly changed
-pseudo-random number generator, Hashing function for hash keys has changed,
-C<undef> fails on read only values, Close-on-exec bit may be set on pipe
-and socket handles, Writing C<"$$1"> to mean C<"${$}1"> is unsupported,
-delete(), values() and C<\(%h)> operate on aliases to values, not copies,
-vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS, Text of some diagnostic
-output has changed, C<%@> has been removed, Parenthesized not() behaves
-like a list operator, Semantics of bareword prototype C<(*)> have changed
-
-=item On 64-bit platforms the semantics of bit operators have changed
-
-=item C Source Incompatibilities
-
-C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
+=item Interpreter cloning, threads, and concurrency
 
-=item Compatible C Source API Changes
+=item Lexically scoped warning categories
 
-C<PATCHLEVEL> is now C<PERL_VERSION>
+=item Unicode and UTF-8 support
 
-=item Binary Incompatibilities
+=item Support for interpolating named characters
 
-=back
+=item "our" declarations
 
-=item Installation and Configuration Improvements
+=item Support for strings represented as a vector of ordinals
 
-=over
+=item Improved Perl version numbering system
 
-=item -Dusethreads means something different
+=item New syntax for declaring subroutine attributes
 
-=item New Configure flags
+=item File and directory handles can be autovivified
 
-=item Threadedness and 64-bitness now more daring
+=item open() with more than two arguments
 
-=item Long Doubles
+=item 64-bit support
 
-=item -Dusemorebits
+=item Large file support
 
-=item -Duselargefiles
+=item Long doubles
 
-=item installusrbinperl
+=item "more bits"
 
-=item SOCKS support
+=item Enhanced support for sort() subroutines
 
-=item C<-A> flag
+=item C<sort $coderef @foo> allowed
 
-=item Enhanced Installation Directories
+=item File globbing implemented internally
 
-=back
+Support for CHECK blocks
 
-=item Core Changes
+=item POSIX character class syntax [: :] supported
 
-=over
+Better pseudo-random number generator
 
-=item Unicode and UTF-8 support
+=item Improved C<qw//> operator
 
-=item Interpreter cloning, threads, and concurrency
+Better worst-case behavior of hashes
 
-=item Lexically scoped warning categories
+=item pack() format 'Z' supported
 
-=item Lvalue subroutines
+=item pack() format modifier '!' supported
 
-=item "our" declarations
+=item pack() and unpack() support counted strings
 
-=item Support for strings represented as a vector of ordinals
+=item Comments in pack() templates
 
 =item Weak references
 
-=item File globbing implemented internally
-
 =item Binary numbers supported
 
+=item Lvalue subroutines
+
 =item Some arrows may be omitted in calls through references
 
+=item Boolean assignment operators are legal lvalues
+
 =item exists() is supported on subroutine names
 
 =item exists() and delete() are supported on array elements
 
-=item syswrite() ease-of-use
-
-=item File and directory handles can be autovivified
+=item Pseudo-hashes work better
 
-=item open() with more than two arguments
+=item Automatic flushing of output buffers
 
-=item 64-bit support
+=item Better diagnostics on meaningless filehandle operations
 
-=item Large file support
+=item Where possible, buffered data discarded from duped input filehandle
 
-=item Long doubles
+=item eof() has the same old magic as <>
 
-=item "more bits"
+=item binmode() can be used to set :crlf and :raw modes
 
-=item Enhanced support for sort() subroutines
+=item C<-T> filetest recognizes UTF-8 encoded files as "text"
 
-=item Better syntax checks on parenthesized unary operators
+=item system(), backticks and pipe open now reflect exec() failure
 
-=item POSIX character class syntax [: :] supported
+=item Improved diagnostics
 
-=item Improved C<qw//> operator
+=item Diagnostics follow STDERR
 
-=item pack() format 'Z' supported
+More consistent close-on-exec behavior
 
-=item pack() format modifier '!' supported
+=item syswrite() ease-of-use
 
-=item pack() and unpack() support counted strings
+=item Better syntax checks on parenthesized unary operators
 
-=item Comments in pack() templates
+=item Bit operators support full native integer width
 
-=item $^X variables may now have names longer than one character
+=item Improved security features
 
-=item C<use attrs> implicit in subroutine attributes
-
-=item Support for interpolating named characters
+More functional bareword prototype (*)
 
 =item C<require> and C<do> may be overridden
 
+=item $^X variables may now have names longer than one character
+
 =item New variable $^C reflects C<-c> switch
 
 =item New variable $^V contains Perl version as a string
@@ -1268,69 +1249,87 @@ C<PATCHLEVEL> is now C<PERL_VERSION>
 
 =back
 
-=item Significant bug fixes
+=item Modules and Pragmata
 
 =over
 
-=item <HANDLE> on empty files
+=item Modules
 
-=item C<eval '...'> improvements
+attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
+DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, 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, XSLoader, DBM Filters
 
-=item All compilation errors are true errors
+=item Pragmata
 
-=item Automatic flushing of output buffers
+=back
 
-=item Better diagnostics on meaningless filehandle operations
+=item Utility Changes
 
-=item Where possible, buffered data discarded from duped input filehandle
+=over
 
-=item eof() has the same old magic as <>
+=item dprofpp
 
-=item system(), backticks and pipe open now reflect exec() failure
+=item find2perl
 
-=item Implicitly closed filehandles are safer
+=item h2xs
 
-=item C<(\$)> prototype and C<$foo{a}>
+=item perlcc
 
-=item Pseudo-hashes work better
+=item perldoc
 
-=item C<goto &sub> and AUTOLOAD
+=item The Perl Debugger
 
-=item C<-bareword> allowed under C<use integer>
+=back
 
-=item Boolean assignment operators are legal lvalues
+=item Improved Documentation
 
-=item C<sort $coderef @foo> allowed
+perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
+perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
+perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
+perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
 
-=item Failures in DESTROY()
+=item Performance enhancements
 
-=item Locale bugs fixed
+=over
 
-=item Memory leaks
+=item Simple sort() using { $a <=> $b } and the like are optimized
 
-=item Spurious subroutine stubs after failed subroutine calls
+=item Optimized assignments to lexical variables
 
-=item Taint failures under C<-U>
+=item Faster subroutine calls
 
-=item END blocks and the C<-c> switch
+delete(), each(), values() and hash iteration are faster
 
-=item Potential to leak DATA filehandles
+=back
 
-=item Diagnostics follow STDERR
+=item Installation and Configuration Improvements
 
-=item Other fixes for better diagnostics
+=over
 
-=back
+=item -Dusethreads means something different
 
-=item Performance enhancements
+=item New Configure flags
 
-=over
+=item Threadedness and 64-bitness now more daring
 
-=item Simple sort() using { $a <=> $b } and the like are optimized
+=item Long Doubles
 
-=item Optimized assignments to lexical variables
+=item -Dusemorebits
 
-=item Faster subroutine calls
+=item -Duselargefiles
+
+=item installusrbinperl
+
+=item SOCKS support
+
+=item C<-A> flag
+
+=item Enhanced Installation Directories
 
 =back
 
@@ -1350,44 +1349,41 @@ C<PATCHLEVEL> is now C<PERL_VERSION>
 
 =back
 
-=item New tests
-
-=item Modules and Pragmata
+=item Significant bug fixes
 
 =over
 
-=item Modules
+=item <HANDLE> on empty files
 
-attributes, B, ByteLoader, constant, charnames, Data::Dumper, DB, DB_File,
-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 C<eval '...'> improvements
 
-=item Pragmata
+=item All compilation errors are true errors
 
-=back
+=item Implicitly closed filehandles are safer
 
-=item Utility Changes
+=item Behavior of list slices is more consistent
 
-=over
+=item C<(\$)> prototype and C<$foo{a}>
 
-=item perlcc
+=item C<goto &sub> and AUTOLOAD
 
-=item perldoc
+=item C<-bareword> allowed under C<use integer>
 
-=item The Perl Debugger
+=item Failures in DESTROY()
 
-=back
+=item Locale bugs fixed
+
+=item Memory leaks
+
+=item Spurious subroutine stubs after failed subroutine calls
 
-=item Documentation Changes
+=item Taint failures under C<-U>
+
+=item END blocks and the C<-c> switch
 
-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 Potential to leak DATA filehandles
+
+=back
 
 =item New or Changed Diagnostics
 
@@ -1400,21 +1396,20 @@ passed through, /%s/ should probably be written as "%s", %s() called too
 early to check prototype, %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, %s package attribute may clash with future reserved word:
-%s,        (in cleanup) %s, <> should be quotes, Attempt to join self, Bad
-evalled substitution pattern, Bad realloc() ignored, Bareword found in
-conditional, Binary number > 0b11111111111111111111111111111111
-non-portable, Bit vector size > 32 non-portable, Buffer overflow in
-prime_env_iter: %s, Can't check filesystem of script "%s", Can't declare
-class for non-scalar %s in "%s", Can't declare %s in "%s", Can't ignore
-signal CHLD, forcing to default, Can't modify non-lvalue subroutine call,
-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,
+%s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
+substitution pattern, Bad realloc() ignored, Bareword found in conditional,
+Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
+size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
+filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
+Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
+Can't modify non-lvalue subroutine call, 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): %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
+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:
@@ -1429,17 +1424,86 @@ 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
+around "%s" list, Possible Y2K bug: %s, pragma "attrs" is deprecated, use
+"sub NAME : ATTRS" instead, 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), Too late to run %s block, 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 New tests
+
+=item Incompatible Changes
+
+=over
+
+=item Perl Source Incompatibilities
+
+CHECK is a new keyword, Treatment of list slices of undef has changed
+
+=item Format of $English::PERL_VERSION is different
+
+Literals of the form C<1.2.3> parse differently, Possibly changed
+pseudo-random number generator, Hashing function for hash keys has changed,
+C<undef> fails on read only values, Close-on-exec bit may be set on pipe
+and socket handles, Writing C<"$$1"> to mean C<"${$}1"> is unsupported,
+delete(), values() and C<\(%h)> operate on aliases to values, not copies,
+vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS, Text of some diagnostic
+output has changed, C<%@> has been removed, Parenthesized not() behaves
+like a list operator, Semantics of bareword prototype C<(*)> have changed
+
+=item Semantics of bit operators may have changed on 64-bit platforms
+
+=item More builtins taint their results
+
+=item C Source Incompatibilities
+
+C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
+
+=item Compatible C Source API Changes
+
+C<PATCHLEVEL> is now C<PERL_VERSION>
+
+=item Binary Incompatibilities
+
+=back
+
+=item Known Problems
+
+=over
+
+=item Thread test failures
+
+=item EBCDIC platforms not supported
+
+=item In 64-bit HP-UX the lib/io_multihomed test may hang
+
+=item NEXTSTEP 3.3 POSIX test failure
+
+=item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
+gcc
+
+=item UNICOS/mk CC failures during Configure run
+
+=item Arrow operator and arrays
+
+=item Windows 2000
+
+=item Experimental features
+
+Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
+pseudo-hash data type, The Compiler suite, Internal implementation of file
+globbing, The DB module, The regular expression constructs C<(?{ code })>
+and C<(??{ code })>
+
+=back
 
 =item Obsolete Diagnostics
 
@@ -1447,7 +1511,7 @@ Character class syntax [: :] is reserved for future extensions, Ill-formed
 logical name |%s| in prime_env_iter, Probable precedence problem on %s,
 regexp too big, Use of "$$<digit>" to mean "${$}<digit>" is deprecated
 
-=item BUGS
+=item Reporting Bugs
 
 =item SEE ALSO
 
@@ -1746,18 +1810,18 @@ last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length,
 link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR,
 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,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
-LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST, printf FORMAT,
-LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/, qq/STRING/,
-qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta, rand EXPR,
-rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read FILEHANDLE,SCALAR,LENGTH,
-readdir DIRHANDLE, readline EXPR, readlink EXPR, readlink, readpipe EXPR,
-recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, ref EXPR, ref, rename
+ID,CMD,ARG, msgget KEY,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd
+ID,MSG,FLAGS, my EXPR, my EXPR : ATTRIBUTES, next LABEL, next, no Module
+LIST, oct EXPR, oct, open FILEHANDLE,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 LIST, print LIST, print,
+printf FILEHANDLE FORMAT, LIST, printf FORMAT, LIST, prototype FUNCTION,
+push ARRAY,LIST, q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/,
+quotemeta EXPR, quotemeta, rand EXPR, rand, read
+FILEHANDLE,SCALAR,LENGTH,OFFSET, read FILEHANDLE,SCALAR,LENGTH, readdir
+DIRHANDLE, readline EXPR, readlink EXPR, readlink, readpipe EXPR, recv
+SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, ref EXPR, ref, rename
 OLDNAME,NEWNAME, require VERSION, require EXPR, require, reset EXPR, reset,
 return EXPR, return, reverse LIST, rewinddir DIRHANDLE, rindex
 STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, rmdir, s///, scalar
@@ -3113,7 +3177,7 @@ portable
 =item CPAN Testers
 
 Mailing list: cpan-testers@perl.org, Testing results:
-C<http://testers.cpan.org/>
+http://testers.cpan.org/
 
 =item PLATFORMS
 
@@ -3123,49 +3187,20 @@ C<http://testers.cpan.org/>
 
 =item DOS and Derivatives
 
-The djgpp environment for DOS, C<http://www.delorie.com/djgpp/>, The EMX
-environment for DOS, OS/2, etc.
-C<emx@iaehv.nl>,C<http://www.leo.org/pub/comp/os/os2/leo/gnu/emx+gcc/index.
-html> or
-C<ftp://hobbes.nmsu.edu/pub/os2/dev/emx>, Build instructions for Win32,
-L<perlwin32>, The ActiveState Pages, C<http://www.activestate.com/>, The
-Cygwin environment for Win32; F<README.cygwin> (installed as
-L<perlcygwin>), C<http://sourceware.cygnus.com/cygwin/>, The U/WIN
-environment for Win32,C<http://www.research.att.com/sw/tools/uwin/>
+Build instructions for OS/2, L<perlos2>
 
 =item S<Mac OS>
 
-The MacPerl Pages, C<http://www.macperl.com/>, The MacPerl mailing lists,
-C<http://www.macperl.org/>, MacPerl Module Porters,
-C<http://pudge.net/mmp/>
-
 =item VMS
 
-F<README.vms> (installed as L<README_vms>), L<perlvms>, vmsperl list,
-C<majordomo@perl.org>, vmsperl on the web,
-C<http://www.sidhe.org/vmsperl/index.html>
-
 =item VOS
 
-F<README.vos>, VOS mailing list, VOS Perl on the web at
-C<http://ftp.stratus.com/pub/vos/vos.html>
-
 =item EBCDIC Platforms
 
-F<README.os390>, F<README.posix-bc>, F<README.vmesa>, perl-mvs list, AS/400
-Perl information at C<http://as400.rochester.ibm.com/>as well as on CPAN in
-the F<ports/> directory
-
 =item Acorn RISC OS
 
 =item Other perls
 
-Amiga, F<README.amiga> (installed as L<perlamiga>), Atari, F<README.mint>
-and Guido Flohr's web pageC<http://stud.uni-sb.de/~gufl0000/>, Be OS,
-F<README.beos>, HP 300 MPE/iX, F<README.mpeix> and Mark Bixby's web
-pageC<http://www.cccd.edu/~markb/perlix.html>, Novell Netware, Plan 9,
-F<README.plan9>
-
 =back
 
 =item FUNCTION IMPLEMENTATIONS
@@ -3204,14 +3239,17 @@ wait, waitpid PID,FLAGS
 
 =item CHANGES
 
-v1.46, 12 February 2000, v1.45, 20 December 1999, v1.44, 19 July 1999,
-v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May 1999, v1.40, 11 April
-1999, v1.39, 11 February 1999, v1.38, 31 December 1998, v1.37, 19 December
-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
+v1.47, 22 March 2000, v1.46, 12 February 2000, v1.45, 20 December 1999,
+v1.44, 19 July 1999, v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May
+1999, v1.40, 11 April 1999, v1.39, 11 February 1999, v1.38, 31 December
+1998, v1.37, 19 December 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 SEE ALSO
+
 =item AUTHORS / CONTRIBUTORS
 
 =item VERSION
@@ -3791,33 +3829,34 @@ isDIGIT, isLOWER, isSPACE, isUPPER, items, ix, LEAVE, looks_like_number,
 MARK, mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical,
 mg_set, Move, New, newAV, Newc, newCONSTSUB, newHV, newRV_inc, newRV_noinc,
 NEWSV, newSViv, newSVnv, newSVpv, newSVpvf, newSVpvn, newSVrv, newSVsv,
-newXS, newXSproto, Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv, ORIGMARK,
-perl_alloc, perl_construct, perl_destruct, perl_free, perl_parse, perl_run,
-PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_modglobal, PL_na,
-PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, POPl, POPn, POPp, POPs, PUSHi,
-PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew, Renewc, require_pv,
-RETVAL, Safefree, savepv, savepvn, SAVETMPS, SP, SPAGAIN, ST, strEQ, strGE,
-strGT, strLE, strLT, strNE, strnEQ, strnNE, StructCopy, SvCUR, SvCUR_set,
-SvEND, SvGETMAGIC, SvGROW, SvIOK, SvIOKp, SvIOK_off, SvIOK_on, SvIOK_only,
-SvIV, SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, SvNOK_off,
-SvNOK_on, SvNOK_only, SvNV, SvNVX, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off,
-SvPOK_on, SvPOK_only, SvPV, SvPVX, SvPV_force, SvPV_nolen, SvREFCNT,
-SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSETMAGIC,
-SvSetSV, SvSetSV_nosteal, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off,
-SvTAINTED_on, SvTRUE, SvTYPE, svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV,
-SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUPGRADE, SvUV, SvUVX, sv_2mortal, sv_bless,
-sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_mg, sv_catpv_mg,
-sv_catsv, sv_catsv_mg, sv_chop, sv_cmp, sv_dec, sv_derived_from, sv_eq,
-sv_grow, sv_inc, sv_insert, sv_isa, sv_isobject, sv_len, sv_magic,
-sv_mortalcopy, sv_newmortal, 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_setsv, sv_setsv_mg, sv_setuv, sv_setuv_mg, sv_unref,
-sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_vcatpvfn, sv_vsetpvfn, THIS,
-toLOWER, toUPPER, warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XS,
-XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, XSRETURN_NV,
-XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV,
-XST_mPV, XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK, Zero
+newSVuv, newXS, newXSproto, Newz, Nullav, Nullch, Nullcv, Nullhv, Nullsv,
+ORIGMARK, perl_alloc, perl_construct, perl_destruct, perl_free, perl_parse,
+perl_run, PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_modglobal,
+PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes, POPi, POPl, POPn, POPp, POPs,
+PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu, PUTBACK, Renew, Renewc,
+require_pv, RETVAL, Safefree, savepv, savepvn, SAVETMPS, SP, SPAGAIN, ST,
+strEQ, strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, StructCopy,
+SvCUR, SvCUR_set, SvEND, SvGETMAGIC, SvGROW, SvIOK, SvIOKp, SvIOK_off,
+SvIOK_on, SvIOK_only, SvIV, SvIVX, SvLEN, SvNIOK, SvNIOKp, SvNIOK_off,
+SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX, SvOK, SvOOK,
+SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only, SvPV, SvPVX, SvPV_force,
+SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off,
+SvROK_on, SvRV, SvSETMAGIC, SvSetSV, SvSetSV_nosteal, SvSTASH, SvTAINT,
+SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, svtype, SVt_IV,
+SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG, SvUPGRADE, SvUV,
+SvUVX, sv_2mortal, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn,
+sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_mg, sv_chop, sv_cmp, sv_dec,
+sv_derived_from, sv_eq, sv_grow, sv_inc, sv_insert, sv_isa, sv_isobject,
+sv_len, sv_magic, sv_mortalcopy, sv_newmortal, 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_setsv, sv_setsv_mg, sv_setuv,
+sv_setuv_mg, sv_unref, sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_vcatpvfn,
+sv_vsetpvfn, THIS, toLOWER, toUPPER, warn, XPUSHi, XPUSHn, XPUSHp, XPUSHs,
+XPUSHu, XS, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO,
+XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_YES, XST_mIV, XST_mNO,
+XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES, XS_VERSION, XS_VERSION_BOOTCHECK,
+Zero
 
 =item AUTHORS
 
@@ -5728,14 +5767,14 @@ 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<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>
+C<sizesize>, 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
 
@@ -7272,6 +7311,10 @@ splitdir (override)
 
 catpath (override)
 
+abs2rel (override)
+
+rel2abs (override)
+
 =over
 
 =item SEE ALSO
@@ -8108,44 +8151,6 @@ set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
 
 =back
 
-=head2 MD5-1.7::MD5, MD5 - Perl interface to the RSA Data Security Inc. MD5
-Message-Digest Algorithm
-
-=over
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item EXAMPLES
-
-=item NOTE
-
-=item AUTHOR
-
-=item SEE ALSO
-
-=back
-
-=head2 MD5-1.7::blib::MD5, MD5 - Perl interface to the RSA Data Security
-Inc. MD5 Message-Digest Algorithm
-
-=over
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item EXAMPLES
-
-=item NOTE
-
-=item AUTHOR
-
-=item SEE ALSO
-
-=back
-
 =head2 Math::BigFloat - Arbitrary length float math package
 
 =over
@@ -10164,87 +10169,19 @@ functions
 
 =item DESCRIPTION
 
-=item NOTE
-
-=item AUTHOR
-
-=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)
+=item System Specifics
 
 =back
 
-=item ERROR REPORTING
+=item NOTE
 
 =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 HISTORY
 
-=item SEE ALSO
+March 18th, 2000
 
 =back