Integrate README.macosx more.

p4raw-id: //depot/perl@20395

6 files changed, 386 insertions, 367 deletions

diff --git a/pod/buildtoc.PL b/pod/buildtoc.PL
index da61bbad9a..3585b7d892 100644
--- a/pod/buildtoc.PL
+++ b/pod/buildtoc.PL
@@ -76,6 +76,7 @@ if (-d "pod") {
     perlirix            
     perlmachten         
     perlmacos
+    perlmacosx
     perlmint
     perlmpeix
     perlnetware             
diff --git a/pod/perl.pod b/pod/perl.pod
index b73df56dc0..0ec140727e 100644
--- a/pod/perl.pod
+++ b/pod/perl.pod
@@ -168,6 +168,7 @@ For ease of access, the Perl manual has been split up into several sections.
     perlirix		Perl notes for Irix
     perlmachten		Perl notes for Power MachTen
     perlmacos		Perl notes for Mac OS (Classic)
+    perlmacosx		Perl notes for Mac OS X
     perlmint		Perl notes for MiNT
     perlmpeix		Perl notes for MPE/iX
     perlnetware		Perl notes for NetWare
diff --git a/pod/perlport.pod b/pod/perlport.pod
index 605248171e..73a6616861 100644
--- a/pod/perlport.pod
+++ b/pod/perlport.pod
@@ -2247,7 +2247,7 @@ http://www.cpan.org/ports/index.html for binary distributions.
 L<perlaix>, L<perlamiga>, L<perlapollo>, L<perlbeos>, L<perlbs2000>,
 L<perlce>, L<perlcygwin>, L<perldgux>, L<perldos>, L<perlepoc>,
 L<perlebcdic>, L<perlfreebsd>, L<perlhurd>, L<perlhpux>, L<perlirix>,
-L<perlmachten>, L<perlmacos>, L<perlmint>, L<perlmpeix>,
+L<perlmachten>, L<perlmacos>, L<perlmacosx>, L<perlmint>, L<perlmpeix>,
 L<perlnetware>, L<perlos2>, L<perlos390>, L<perlos400>,
 L<perlplan9>, L<perlqnx>, L<perlsolaris>, L<perltru64>,
 L<perlunicode>, L<perlvmesa>, L<perlvms>, L<perlvos>,
diff --git a/pod/perltoc.pod b/pod/perltoc.pod
index 6262f4d127..43d3838f75 100644
--- a/pod/perltoc.pod
+++ b/pod/perltoc.pod
@@ -185,6 +185,8 @@ Interaction, perlfaq9 - Networking
 
 =item Declarations
 
+=item Comments
+
 =item Simple Statements
 
 =item Compound Statements
@@ -802,7 +804,7 @@ Precedence
 
 Regular Expression, Regular Expression, Regular Expression, Regular
 Expression, Regular Expression, Regular Expression, Regular Expression,
-Regular Expression
+Regular Expression, Regular Expression
 
 =item Subroutine, Signal, Sorting Traps
 
@@ -848,11 +850,11 @@ OS/2, MS-DOS, Win95/NT, Macintosh, VMS
 
 =item Command Switches
 
-B<-0>[I<octal/hexadecimal>], B<-a>, B<-C [I<number/list>]>, B<-c>, B<-d>,
-B<-d:>I<foo[=bar,baz]>, B<-D>I<letters>, B<-D>I<number>, B<-e>
-I<commandline>, B<-F>I<pattern>, B<-h>, B<-i>[I<extension>],
-B<-I>I<directory>, B<-l>[I<octnum>], B<-m>[B<->]I<module>,
-B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
+B<-0>[I<octal/hexadecimal>], B<-A [I<assertions>]>, B<-a>, B<-C
+[I<number/list>]>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>, B<-D>I<letters>,
+B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>, B<-h>,
+B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
+B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
 B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>,
 B<-X>, B<-x> I<directory>
@@ -862,10 +864,11 @@ B<-X>, B<-x> I<directory>
 =item ENVIRONMENT
 
 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
-:perlio, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
+:perlio, :pop, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
 PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS,
-PERL_DESTRUCT_LEVEL, PERL_ENCODING, PERL_ROOT (specific to the VMS port),
-PERL_SIGNALS, PERL_UNICODE, SYS$LOGIN (specific to the VMS port)
+PERL_DESTRUCT_LEVEL, PERL_ENCODING, PERL_HASH_SEED, PERL_HASH_SEED_DEBUG,
+PERL_ROOT (specific to the VMS port), PERL_SIGNALS, PERL_UNICODE, SYS$LOGIN
+(specific to the VMS port)
 
 =back
 
@@ -1017,7 +1020,7 @@ listing
 =item Predefined Names
 
 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
-$LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $MULTILINE_MATCHING, $*,
+$LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+,
 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
@@ -1042,10 +1045,11 @@ $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
-0x100, 0x200, $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S,
-$BASETIME, $^T, ${^TAINT}, ${^UNICODE}, $PERL_VERSION, $^V, $WARNING, $^W,
-${^WARNING_BITS}, $EXECUTABLE_NAME, $^X, ARGV, $ARGV, @ARGV, ARGVOUT, @F,
-@INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
+0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R,
+$EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, ${^UNICODE},
+$PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, $EXECUTABLE_NAME, $^X,
+ARGV, $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG,
+$SIG{expr}
 
 =item Error Indicators
 
@@ -1751,8 +1755,8 @@ safe subprocesses, sockets, and semaphores)
 
 =item Deferred Signals (Safe signals)
 
-Long running opcodes, Interrupting IO, Signals as "faults", Signals
-triggered by operating system state
+Long running opcodes, Interrupting IO, Restartable system calls, Signals as
+"faults", Signals triggered by operating system state
 
 =back
 
@@ -2140,6 +2144,8 @@ portable
 
 =item Command names versus file pathnames
 
+=item Networking
+
 =item Interprocess Communication (IPC)
 
 =item External Subroutines (XS)
@@ -2422,10 +2428,6 @@ enable UTF-8/UTF-EBCDIC in scripts
 
 =item When Unicode Does Not Happen
 
-chmod, chmod, chown, chroot, exec, link, mkdir, rename, rmdir, stat,
-symlink, truncate, unlink, utime, %ENV, glob (aka the <*>), open, opendir,
-sysopen, qx (aka the backtick operator), system, readdir, readlink
-
 =item Forcing Unicode in Perl (Or Unforcing Unicode in Perl)
 
 =item Using Unicode in XS
@@ -2598,6 +2600,8 @@ chcp, dataset access, OS/390, z/OS iconv, locales
 
 =item Unicode
 
+=item Algorithmic Complexity Attacks
+
 =back
 
 =item SEE ALSO
@@ -2753,8 +2757,8 @@ South Africa
 
 =item Asia
 
-China, India, Indonesia, Israel, Japan, Korea, Philippines, Russian
-Federation, Saudi Arabia, Singapore, South Korea, Taiwan, Thailand
+China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi
+Arabia, Singapore, South Korea, Taiwan
 
 =item Central America
 
@@ -2770,18 +2774,15 @@ Kingdom
 
 =item North America
 
-Alberta, Manitoba, Nova Scotia, Ontario, Quebec, Mexico
-
-=item United States
-
+Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States,
 Alabama, California, Colorado, Delaware, District of Columbia, Florida,
-Illinois, Indiana, Kentucky, Massachusetts, Michigan, New Jersey, New York,
-North Carolina, Ohio, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas,
-Utah, Virginia, ashington, Wisconsin
+Illinois, Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey,
+New York, North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas,
+Utah, Virginia, Washington, Wisconsin
 
 =item Oceania
 
-Australia, New Zealand
+Australia, New Zealand, United States
 
 =item South America
 
@@ -2947,8 +2948,8 @@ tarball, Announce to the modules list, Announce to clpa, Fix bugs!
 
 =back
 
-=head2 perlfaq1 - General Questions About Perl ($Revision: 1.11 $, $Date:
-2002/12/06 07:40:11 $)
+=head2 perlfaq1 - General Questions About Perl ($Revision: 1.12 $, $Date:
+2003/07/09 15:47:28 $)
 
 =over 4
 
@@ -2964,6 +2965,8 @@ tarball, Announce to the modules list, Announce to clpa, Fix bugs!
 
 =item What are perl4 and perl5?
 
+=item What is Ponie?
+
 =item What is perl6?
 
 =item How stable is Perl?
@@ -3137,8 +3140,8 @@ my C program; what am I doing wrong?
 
 =back
 
-=head2 perlfaq4 - Data Manipulation ($Revision: 1.43 $, $Date: 2003/02/23
-20:25:09 $)
+=head2 perlfaq4 - Data Manipulation ($Revision: 1.44 $, $Date: 2003/07/28
+17:35:21 $)
 
 =over 4
 
@@ -3515,8 +3518,8 @@ file?
 
 =back
 
-=head2 perlfaq7 - General Perl Language Issues ($Revision: 1.14 $, $Date:
-2003/01/31 17:38:14 $)
+=head2 perlfaq7 - General Perl Language Issues ($Revision: 1.15 $, $Date:
+2003/07/24 02:17:21 $)
 
 =over 4
 
@@ -4208,6 +4211,8 @@ C<t>, C<p>, C<n>, C<s>
 
 =item Hash API Extensions
 
+=item AVs, HVs and undefined values
+
 =item References
 
 =item Blessed References and Class Objects
@@ -4604,8 +4609,9 @@ savepv, savepvn, savesharedpv, StructCopy, Zero
 
 =item Miscellaneous Functions
 
-fbm_compile, fbm_instr, form, getcwd_sv, strEQ, strGE, strGT, strLE, strLT,
-strNE, strnEQ, strnNE
+fbm_compile, fbm_instr, form, getcwd_sv, new_version, scan_version, strEQ,
+strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_nolocking,
+sv_nosharing, sv_nounlocking, upg_version, vcmp, vnumify, vstringify
 
 =item Numeric functions
 
@@ -4636,11 +4642,11 @@ svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
 
 get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
 newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
-new_version, scan_version, scan_vstring, SvCUR, SvCUR_set, SvEND, SvGROW,
-SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV,
-SvIOK_UV, SvIsCOW, SvIsCOW_shared_hash, SvIV, SvIVx, SvIVX, SvLEN, SvNIOK,
-SvNIOKp, SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV,
-SvNVX, SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only,
+SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off,
+SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIsCOW,
+SvIsCOW_shared_hash, SvIV, SvIVx, SvIVX, SvLEN, SvNIOK, SvNIOKp,
+SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX,
+SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only,
 SvPOK_only_UTF8, SvPV, SvPVbyte, SvPVbytex, SvPVbytex_force,
 SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, SvPVutf8x, SvPVutf8x_force,
 SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX, SvPV_force, SvPV_force_nomg,
@@ -4655,19 +4661,18 @@ sv_catpv_mg, sv_catsv, sv_catsv_flags, 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,
-upg_version, vcmp, vnumify, vstringify
+sv_magic, sv_magicext, sv_mortalcopy, sv_newmortal, sv_newref, 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
 
@@ -5028,6 +5033,9 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item Taint rethink
 
+=item Perform correctly when XSUBs call subroutines that exit via
+goto(LABEL) and friends
+
 =back
 
 =item Vague ideas
@@ -5259,6 +5267,8 @@ Argument stack, Mark stack, Save stack
 
 =item Millions of Macros
 
+=item The .i Targets
+
 =item Poking at Perl
 
 =item Using a source-level debugger
@@ -5266,6 +5276,8 @@ Argument stack, Mark stack, Save stack
 run [args], break function_name, break source.c:xxx, step, next, continue,
 finish, 'enter', print
 
+=item gdb macro support
+
 =item Dumping Perl Data Structures
 
 =item Patching
@@ -5398,6 +5410,12 @@ B<-V>
 
 =item Incompatible Changes
 
+=over 4
+
+=item The C<$*> variable has been removed
+
+=back
+
 =item Core Enhancements
 
 =over 4
@@ -7195,23 +7213,13 @@ long, Process terminated by SIG%s
 
 =item Definitions
 
-"Package" refers to the collection of files distributed by the Copyright
-Holder, and derivatives of that collection of files created through textual
-modification, "Standard Version" refers to such a Package if it has not
-been modified, or has been modified in accordance with the wishes of the
-Copyright Holder as specified below, "Copyright Holder" is whoever is named
-in the copyright or copyrights for the package, "You" is you, if you're
-thinking about copying or distributing this Package, "Reasonable copying
-fee" is whatever you can justify on the basis of media cost, duplication
-charges, time of people involved, and so on. (You will not be required to
-justify it to the Copyright Holder, but only to the computing community at
-large as a market that must bear the fee.), "Freely Available" means that
-no fee is charged for the item itself, though there may be fees involved in
-handling the item. It also means that recipients of the item may
-redistribute it under the same conditions they received it
+"Package", "Standard Version", "Copyright Holder", "You", "Reasonable
+copying fee", "Freely Available"
 
 =item Conditions
 
+a), b), c), d), a), b), c), d)
+
 =back
 
 =back
@@ -7495,11 +7503,11 @@ I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
 
 =item NDBM_File and ODBM_File do not work on FAT filesystems
 
-=item fork() failures in io_* tests
+=item C<fork()> failures in io_* tests
 
 =item Script Portability on Cygwin
 
-Pathnames, Text/Binary, F<.exe>, chown(), Miscellaneous
+Pathnames, Text/Binary, PerlIO, F<.exe>, C<chown()>, Miscellaneous
 
 =back
 
@@ -7790,6 +7798,32 @@ op/lexassign.t, pragma/warnings.t
 
 =back
 
+=head2 perlmacosx, README.macosx - Perl under Mac OS X
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item INSTALLATION PREFIX
+
+=item LIBPERL AND PREBINDING
+
+=item UPDATING PANTHER
+
+=item MACPERL
+
+=item CARBON
+
+=item COCOA
+
+=item AUTHOR
+
+=item DATE
+
+=back
+
 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
 
 =over 4
@@ -8298,7 +8332,7 @@ Solaris FAQ, Precompiled Binaries, Solaris Documentation
 
 =item Compiler and Related Tools on Solaris.
 
-=item Environment for Compiling Perl on Solaris
+=item Environment for Compiling perl on Solaris
 
 =back
 
@@ -8306,11 +8340,11 @@ Solaris FAQ, Precompiled Binaries, Solaris Documentation
 
 =over 4
 
-=item 64-bit Issues with Perl on Solaris.
+=item 64-bit perl on Solaris.
 
-=item Threads in Perl on Solaris.
+=item Threads in perl on Solaris.
 
-=item Malloc Issues with Perl on Solaris.
+=item Malloc Issues with perl on Solaris.
 
 =back
 
@@ -8675,22 +8709,14 @@ blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
 
 =back
 
-=head2 assertions - selects assertions
+=head2 assertions - select assertions in blocks of code
 
 =over 4
 
 =item SYNOPSIS
 
-=item ABSTRACT
-
 =item DESCRIPTION
 
-=over 4
-
-=item EXPORT
-
-=back
-
 =item SEE ALSO
 
 =item AUTHOR
@@ -8699,22 +8725,14 @@ blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
 
 =back
 
-=head2 assertions::activate - assertions activation
+=head2 assertions::activate - activate assertions
 
 =over 4
 
 =item SYNOPSIS
 
-=item ABSTRACT
-
 =item DESCRIPTION
 
-=over 4
-
-=item EXPORT
-
-=back
-
 =item SEE ALSO
 
 =item AUTHOR
@@ -8831,6 +8849,8 @@ a or accuracy, p or precision, t or trace, l or lib, v or version
 
 =item METHODS
 
+=item CAVEAT
+
 =back
 
 =item MODULES USED
@@ -8861,6 +8881,8 @@ a or accuracy, p or precision, t or trace, l or lib, v or version
 
 =item METHODS
 
+=item CAVEAT
+
 inf(), NaN(), upgrade()
 
 =item MATH LIBRARY
@@ -8901,6 +8923,8 @@ inf(), NaN(), upgrade()
 
 =item METHODS
 
+=item CAVEAT
+
 =back
 
 =item EXAMPLES
@@ -9390,6 +9414,8 @@ B<untrapped>, B<any>, I<signal>, I<number>
 
 C<strict refs>, C<strict vars>, C<strict subs>
 
+=item HISTORY
+
 =back
 
 =head2 subs - Perl pragma to predeclare sub names
@@ -9473,7 +9499,7 @@ code
 
 $num_octets = utf8::upgrade($string);, utf8::downgrade($string[, FAIL_OK]),
 utf8::encode($string), $flag = utf8::decode($string), $flag =
-utf8::valid(STRING)
+utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
 
 =back
 
@@ -9505,10 +9531,7 @@ utf8::valid(STRING)
 
 =item What IS a version
 
-Numeric Versions - any initial parameter which "looks like a number", see
-L<Numeric Versions>, V-String Versions - any initial parameter which
-contains more than one decimal point, contains an embedded underscore, or
-has a leading 'v' see L<V-String Versions>
+Numeric Versions, V-String Versions
 
 =item Numeric Versions
 
@@ -9516,36 +9539,14 @@ has a leading 'v' see L<V-String Versions>
 
 =item Object Methods
 
-New Operator - Like all OO interfaces, the new() operator is used to
-initialize version objects.  One way to increment versions when programming
-is to use the CVS variable $Revision, which is automatically incremented by
-CVS every time the file is committed to the repository, Stringification -
-Any time a version object is used as a string, a stringified representation
-is returned in reduced form (no extraneous zeros):, Numification - although
-all mathematical operations on version objects are forbidden by default, it
-is possible to retrieve a number which roughly corresponds to the version
-object through the use of the $obj->numify method.  For formatting
-purposes, when displaying a number which corresponds a version object, all
-sub versions are assumed to have three decimal places.	So for example:,
-Comparison operators - Both cmp and <=> operators perform the same
-comparison between terms (upgrading to a version object automatically). 
-Perl automatically generates all of the other comparison operators based on
-those two.  In addition to the obvious equalities listed below, appending a
-single trailing 0 term does not change the value of a version for
-comparison purposes.  In other words "v1.2" and "v1.2.0" are identical
-versions
+New Operator, Stringification, Numification, Comparison operators, Logical
+Operators
 
 =item Quoting
 
 =item Types of Versions Objects
 
-Ordinary versions - These are the versions that normal modules will use. 
-Can contain as many subversions as required. In particular, those using
-RCS/CVS can use one of the following:, Beta versions - For module authors
-using CPAN, the  convention has been to note unstable releases with an
-underscore in the version string, see L<CPAN>.	Beta releases will test as
-being newer than the more recent stable release, and less than the next
-stable release.  For example:
+Ordinary versions, alpha versions
 
 =item Replacement UNIVERSAL::VERSION
 
@@ -9730,9 +9731,8 @@ $keep, $check, $modtime
 =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV>
 objects
 
-sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation,
-C<init_av>, check_av, begin_av, end_av, comppadlist, regex_padav,
-C<main_cv>
+sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av,
+check_av, begin_av, end_av, comppadlist, regex_padav, main_cv
 
 =item Functions for Examining the Symbol Table
 
@@ -9757,7 +9757,7 @@ perlstring(STR), class(OBJ), threadsv_names
 
 =item B::SV Methods
 
-REFCNT, FLAGS
+REFCNT, FLAGS, object_2svref
 
 =item B::IV Methods
 
@@ -9803,7 +9803,7 @@ BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
 
 =item B::AV Methods
 
-FILL, MAX, OFF, ARRAY, AvFLAGS
+FILL, MAX, OFF, ARRAY, ARRAYelt, AvFLAGS
 
 =item B::CV Methods
 
@@ -9839,7 +9839,7 @@ children
 =item B::PMOP Methods
 
 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
-pmpermflags, precomp, pmoffet
+pmpermflags, precomp, pmoffset
 
 =item B::SVOP METHOD
 
@@ -9922,15 +9922,15 @@ B<find_leaders>
 
 =item DESCRIPTION
 
+=item EXAMPLE
+
 =item OPTIONS
 
-B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
-B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
-B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
+B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
 
-=item EXAMPLES
+=item KNOWN BUGS
 
-=item BUGS
+=item NOTICE
 
 =item AUTHORS
 
@@ -10060,7 +10060,7 @@ B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
 
 =item OPTIONS
 
-B<-l>, B<-p>, B<-P>, B<-q>, B<-f>I<FILE>, B<-s>I<LETTERS>, B<C>,
+B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>,
 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
 
 =item USING B::Deparse AS A MODULE
@@ -10263,20 +10263,6 @@ disablecache ( ), enablecache ( ), timesum ( T1, T2 )
 
 =back
 
-=head2 ByteLoader - load byte compiled perl code
-
-=over 4
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item AUTHOR
-
-=item SEE ALSO
-
-=back
-
 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
 
 =over 4
@@ -10285,15 +10271,15 @@ disablecache ( ), enablecache ( ), timesum ( T1, T2 )
 
 =item DESCRIPTION
 
+=item EXAMPLE
+
 =item OPTIONS
 
-B<-ofilename>, B<-afilename>, B<-->, B<-f>, B<-fcompress-nullops>,
-B<-fomit-sequence-numbers>, B<-fbypass-nullops>, B<-On>, B<-D>, B<-Do>,
-B<-Db>, B<-Da>, B<-DC>, B<-S>, B<-upackage>
+B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
 
-=item EXAMPLES
+=item KNOWN BUGS
 
-=item BUGS
+=item NOTICE
 
 =item AUTHORS
 
@@ -10464,7 +10450,8 @@ B<Parameters:>
 
 =item CREATING A CLICKABLE IMAGE BUTTON
 
-B<Parameters:>
+B<Parameters:>, 3. The third option (-align, optional) is an alignment
+type, and may be TOP, BOTTOM or MIDDLE
 
 =item CREATING A JAVASCRIPT ACTION BUTTON
 
@@ -10494,8 +10481,9 @@ 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()>, B<referer()>,
-B<auth_type ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
+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<server_software ()>, B<remote_user ()>, B<user_name ()>,
 B<request_method()>, B<content_type()>, B<http()>, B<https()>
 
@@ -11043,54 +11031,53 @@ C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>,
 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_msghdr_s>,
 C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>,
-C<d_nanosleep>, C<d_nice>, C<d_nl_langinfo>, 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_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>,
-C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>,
-C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>,
-C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>,
-C<d_pthread_atfork>, C<d_pthread_attr_setscope>, 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_random_r>, C<d_readdir64_r>, C<d_readdir>, C<d_readdir_r>,
-C<d_readlink>, C<d_readv>, C<d_recvmsg>, C<d_rename>, C<d_rewinddir>,
-C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>, C<d_sbrkproto>,
-C<d_scalbnl>, C<d_sched_yield>, C<d_scm_rights>, C<d_SCNfldbl>,
-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_sendmsg>, C<d_setegid>,
-C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>,
-C<d_sethostent_r>, C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>,
-C<d_setlocale_r>, C<d_setnent>, C<d_setnetent_r>, C<d_setpent>,
-C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>, C<d_setprior>,
-C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>, C<d_setpwent_r>,
-C<d_setregid>, C<d_setresgid>, C<d_setresuid>, C<d_setreuid>, C<d_setrgid>,
-C<d_setruid>, C<d_setsent>, C<d_setservent_r>, C<d_setsid>, 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_sigprocmask>, C<d_sigsetjmp>,
-C<d_sockatmark>, C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>,
-C<d_sockpair>, C<d_socks5_init>, C<d_sqrtl>, C<d_srand48_r>,
-C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>, 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_ptr_lval_nochange_cnt>,
-C<d_stdio_ptr_lval_sets_cnt>, 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_strerror_r>, C<d_strftime>, C<d_strtod>, C<d_strtol>,
-C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>,
-C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>,
-C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
-C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
-C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>,
-C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>,
-C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
-C<d_unordered>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>,
-C<d_vendorbin>, C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>,
-C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>, C<d_volatile>,
-C<d_vprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>,
-C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>, C<db_prefixtype>,
-C<db_version_major>, C<db_version_minor>, C<db_version_patch>,
-C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>, C<doublesize>,
-C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
+C<d_nice>, C<d_nl_langinfo>, 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_perl_otherlibdirs>,
+C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
+C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
+C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>,
+C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, C<d_pthread_atfork>,
+C<d_pthread_attr_setscope>, 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_random_r>, C<d_readdir64_r>,
+C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
+C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
+C<d_sanemcmp>, C<d_sbrkproto>, C<d_scalbnl>, C<d_sched_yield>,
+C<d_scm_rights>, C<d_SCNfldbl>, 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_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>,
+C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>,
+C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>,
+C<d_setnent>, C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>,
+C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>,
+C<d_setpwent>, C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>,
+C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>,
+C<d_setservent_r>, C<d_setsid>, 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_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>,
+C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>,
+C<d_socks5_init>, C<d_sqrtl>, C<d_srand48_r>, C<d_srandom_r>,
+C<d_sresgproto>, C<d_sresuproto>, 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_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>,
+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_strerror_r>,
+C<d_strftime>, C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>,
+C<d_strtoq>, C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>,
+C<d_suidsafe>, C<d_symlink>, C<d_syscall>, C<d_syscallproto>, C<d_sysconf>,
+C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>,
+C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>,
+C<d_tm_tm_gmtoff>, C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>,
+C<d_ttyname_r>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>,
+C<d_uname>, C<d_union_semun>, C<d_unordered>, C<d_usleep>,
+C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>,
+C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>, C<d_void_closedir>,
+C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
+C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
+C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
+C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
+C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
 
 =item e
 
@@ -11176,8 +11163,9 @@ C<man3direxp>, C<man3ext>
 
 =item M
 
-C<Mcc>, C<mips_type>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
-C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
+C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>,
+C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>,
+C<myuname>
 
 =item n
 
@@ -11518,6 +11506,12 @@ Dumper
 
 =item BUGS
 
+=over 4
+
+=item NOTE
+
+=back
+
 =item AUTHOR
 
 =item VERSION
@@ -11665,7 +11659,7 @@ md5($data,...), md5_hex($data,...), md5_base64($data,...)
 
 =item METHODS
 
-$md5 = Digest::MD5->new, $md5->clone, $md5->reset, $md5->add($data,...),
+$md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...),
 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
 
 =item EXAMPLES
@@ -12881,10 +12875,12 @@ dynamic extensions at load time
 
 =item Inherently Cross-Platform Methods
 
-os_flavor_is
+installvars
 
 =back
 
+os_flavor_is
+
 =over 4
 
 =item File::Spec wrappers
@@ -13170,6 +13166,8 @@ depend (o)
 
 dir_target (o)
 
+init_DEST
+
 init_dist
 
 dist (o)
@@ -13389,6 +13387,8 @@ perl_script (override)
 
 replace_manpage_separator
 
+init_DEST
+
 init_DIRFILESEP
 
 init_main (override)
@@ -13411,8 +13411,6 @@ const_cccmd (override)
 
 tool_sxubpp (override)
 
-xsubpp_version (override)
-
 tools_other (override)
 
 init_dist (override)
@@ -13627,18 +13625,18 @@ INSTALLVENDORBIN, INSTALLVENDORLIB, INSTALLVENDORMAN1DIR,
 INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR,
 INST_MAN3DIR, INST_SCRIPT, LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS,
 LINKTYPE, MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET,
-MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_VC, OBJECT, OPTIMIZE,
-PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK,
-PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES,
-PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT,
-PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT, PRINT_PREREQ, SITEPREFIX,
-SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, VERSION_FROM, VERSION_SYM,
-XS, XSOPT, XSPROTOARG, XS_VERSION
+MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT,
+OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB,
+PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW,
+PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
+PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT,
+PRINT_PREREQ, SITEPREFIX, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION,
+VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION
 
 =item Additional lowercase attributes
 
-clean, depend, dist, dynamic_lib, linkext, macro, realclean, test,
-tool_autosplit
+clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean,
+test, tool_autosplit
 
 =item Overriding MakeMaker Methods
 
@@ -13654,6 +13652,8 @@ C<<MAN3PODS => ' '>>
   make distdir,   make disttest,    make tardist,    make dist,    make
 uutardist,    make shdist,    make zipdist,    make ci
 
+=item Module Meta-Data
+
 =item Disabling an extension
 
 =item Other Handy Functions
@@ -13691,7 +13691,8 @@ shell commands, easier to customize, cleaner internals, less cruft
 
 =item Module Writing
 
-How do I keep my $VERSION up to date without resetting it manually?
+How do I keep my $VERSION up to date without resetting it manually?, What's
+this F<META.yml> thing and how did it get in my F<MANIFEST>?!
 
 =item XS
 
@@ -13815,18 +13816,6 @@ B<PERL_MM_MANIFEST_DEBUG>
 
 =back
 
-=head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
-
-=over 4
-
-=item SYNOPSIS
-
-=item DESCRIPTION
-
-=item SEE ALSO
-
-=back
-
 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
 
 =over 4
@@ -14118,10 +14107,12 @@ tmpdir (override)
 
 =item DESCRIPTION
 
-canonpath()
+=item AUTHORS
 
 =back
 
+canonpath()
+
 =over 4
 
 =item SEE ALSO
@@ -14485,6 +14476,8 @@ cacheout EXPR, cacheout MODE, EXPR
 
 =item BUGS
 
+=item NOTES
+
 =back
 
 =head2 FileHandle - supply object methods for filehandles
@@ -14846,88 +14839,93 @@ the function @langs = panic_languages(@accept_languages)
 
 =item LIST OF LANGUAGES
 
-{ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {aa} :
-Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} : Afro-Asiatic (Other)],
-{aka} : Akan, {akk} : Akkadian, {sq} : Albanian, {ale} : Aleut, [{alg} :
-Algonquian languages], [{tut} : Altaic (Other)], {am} : Amharic, {i-ami} :
-Ami, [{apa} : Apache languages], {ar} : Arabic, {arc} : Aramaic, {arp} :
-Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy} : Armenian, [{art} :
-Artificial (Other)], {as} : Assamese, [{ath} : Athapascan languages],
-[{aus} : Australian languages], [{map} : Austronesian (Other)], {ava} :
-Avaric, {ae} : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani,
-{ban} : Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bam} :
-Bambara, [{bai} : Bamileke languages], {bad} : Banda, [{bnt} : Bantu
-(Other)], {bas} : Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak
-(Indonesia), {bej} : Beja, {be} : Belarusian, {bem} : Bemba, {bn} :
-Bengali, [{ber} : Berber (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} :
-Bikol, {bin} : Bini, {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} :
-Breton, {bug} : Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} :
-Buriat, {my} : Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan,
-[{cau} : Caucasian (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)],
-[{cai} : Central American Indian (Other)], {chg} : Chagatai, [{cmc} :
-Chamic languages], {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy}
-: Cheyenne, {chb} : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} :
-Chinook Jargon, {chp} : Chipewyan, {cho} : Choctaw, {cu} : Church Slavic,
-{chk} : Chuukese, {cv} : Chuvash, {cop} : Coptic, {kw} : Cornish, {co} :
-Corsican, {cre} : Cree, {mus} : Creek, [{cpe} : English-based Creoles and
-pidgins (Other)], [{cpf} : French-based Creoles and pidgins (Other)],
-[{cpp} : Portuguese-based Creoles and pidgins (Other)], [{crp} : Creoles
-and pidgins (Other)], {hr} : Croatian, [{cus} : Cushitic (Other)], {cs} :
-Czech, {dak} : Dakota, {da} : Danish, {day} : Dayak, {i-default} : Default
-(Fallthru) Language, {del} : Delaware, {din} : Dinka, {div} : Divehi, {doi}
-: Dogri, {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} :
-Dutch, {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha,
-{efi} : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite,
-{en} : English, {enm} : Old English (1100-1500), {ang} : Old English
-(ca.450-1100), {eo} : Esperanto, {et} : Estonian, {ewe} : Ewe, {ewo} :
-Ewondo, {fan} : Fang, {fat} : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} :
-Finnish, [{fiu} : Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm}
-: Middle French (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} :
-Frisian, {fur} : Friulian, {ful} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic,
-{gl} : Gallegan, {lug} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez,
-{ka} : Georgian, {de} : German, {gmh} : Middle High German (ca.1050-1500),
-{goh} : Old High German (ca.750-1050), [{gem} : Germanic (Other)], {gil} :
-Gilbertese, {gon} : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} :
-Grebo, {grc} : Ancient Greek, {el} : Modern Greek, {gn} : Guarani, {gu} :
-Gujarati, {gwi} : Gwich'in, {hai} : Haida, {ha} : Hausa, {haw} : Hawaiian,
+{ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} :
+Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} :
+Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian,
+{ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)],
+{am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic,
+{arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy}
+: Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} :
+Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} :
+Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae}
+: Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} :
+Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai}
+: Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} :
+Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} :
+Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber
+(Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini,
+{bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} :
+Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} :
+Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian
+(Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central
+American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages],
+{ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb}
+: Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} :
+Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} :
+Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree,
+{mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf}
+: French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based
+Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} :
+Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} :
+Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru)
+Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri,
+{dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch,
+{dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi}
+: Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} :
+English, {enm} : Old English (1100-1500), {ang} : Old English
+(ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} :
+Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat}
+: Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} :
+Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French
+(ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} :
+Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan,
+{lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian,
+{de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High
+German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon}
+: Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient
+Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} :
+Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian,
 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
-{hup} : Hupa, {iba} : Iban, {is} : Icelandic, {ibo} : Igbo, {ijo} : Ijo,
-{ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European (Other)],
-{id} : Indonesian, {ia} : Interlingua (International Auxiliary Language
-Association), {ie} : Interlingue, {iu} : Inuktitut, {ik} : Inupiaq, [{ira}
-: Iranian (Other)], {ga} : Irish, {mga} : Middle Irish (900-1200), {sga} :
-Old Irish (to 900), [{iro} : Iroquoian languages], {it} : Italian, {ja} :
-Japanese, {jw} : Javanese, {jrb} : Judeo-Arabic, {jpr} : Judeo-Persian,
-{kab} : Kabyle, {kac} : Kachin, {kl} : Kalaallisut, {kam} : Kamba, {kn} :
-Kannada, {kau} : Kanuri, {kaa} : Kara-Kalpak, {kar} : Karen, {ks} :
-Kashmiri, {kaw} : Kawi, {kk} : Kazakh, {kha} : Khasi, {km} : Khmer, [{khi}
-: Khoisan (Other)], {kho} : Khotanese, {ki} : Kikuyu, {kmb} : Kimbundu,
-{rw} : Kinyarwanda, {ky} : Kirghiz, {i-klingon} : Klingon, {kv} : Komi,
-{kon} : Kongo, {kok} : Konkani, {ko} : Korean, {kos} : Kosraean, {kpe} :
-Kpelle, {kro} : Kru, {kj} : Kuanyama, {kum} : Kumyk, {ku} : Kurdish, {kru}
-: Kurukh, {kut} : Kutenai, {lad} : Ladino, {lah} : Lahnda, {lam} : Lamba,
-{lo} : Lao, {la} : Latin, {lv} : Latvian, {lb} : Letzeburgesch, {lez} :
-Lezghian, {ln} : Lingala, {lt} : Lithuanian, {nds} : Low German, {loz} :
-Lozi, {lub} : Luba-Katanga, {lua} : Luba-Lulua, {lui} : Luiseno, {lun} :
-Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai, {mk} : Macedonian,
-{mad} : Madurese, {mag} : Magahi, {mai} : Maithili, {mak} : Makasar, {mg} :
-Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} : Maltese, {mnc} : Manchu,
-{mdr} : Mandar, {man} : Mandingo, {mni} : Manipuri, [{mno} : Manobo
-languages], {gv} : Manx, {mi} : Maori, {mr} : Marathi, {chm} : Mari, {mh} :
-Marshall, {mwr} : Marwari, {mas} : Masai, [{myn} : Mayan languages], {men}
-: Mende, {mic} : Micmac, {min} : Minangkabau, {i-mingo} : Mingo, [{mis} :
-Miscellaneous languages], {moh} : Mohawk, {mo} : Moldavian, [{mkh} :
-Mon-Khmer (Other)], {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul}
-: Multiple languages], [{mun} : Munda languages], {nah} : Nahuatl, {na} :
-Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele, {ng} :
-Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
+{hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo,
+{ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European
+(Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua
+(International Auxiliary Language Association), {ie} : Interlingue, {iu} :
+Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} :
+Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian
+languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} :
+Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle,
+{kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} :
+Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar}
+: Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh,
+{kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese,
+{ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz,
+{i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} :
+Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama,
+{kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} :
+Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} :
+Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} :
+Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban
+(Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui}
+: Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai,
+{mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili,
+{mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} :
+Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} :
+Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} :
+Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai,
+[{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} :
+Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} :
+Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)],
+{lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple
+languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan,
+{na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele,
+{ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
-{non} : Old Norse, [{nai} : North American Indian], {se} : Northern Sami,
-{no} : Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub}
-: Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro,
-{nzi} : Nzima, {oc} : Occitan (post 1500), {oji} : Ojibwa, {or} : Oriya,
-{om} : Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
+{nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} :
+Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} :
+Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi}
+: Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} :
+Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
@@ -14937,34 +14935,37 @@ Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
-languages], {sam} : Samaritan Aramaic, [{smi} : Sami languages (Other)],
-{sm} : Samoan, {sad} : Sandawe, {sg} : Sango, {sa} : Sanskrit, {sat} :
-Santali, {sc} : Sardinian, {sas} : Sasak, {sco} : Scots, {sel} : Selkup,
-[{sem} : Semitic (Other)], {sr} : Serbian, {srr} : Serer, {shn} : Shan,
-{sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign Languages, {bla} : Siksika,
-{sd} : Sindhi, {si} : Sinhalese, [{sit} : Sino-Tibetan (Other)], [{sio} :
-Siouan languages], {den} : Slave (Athapascan), [{sla} : Slavic (Other)],
-{sk} : Slovak, {sl} : Slovenian, {sog} : Sogdian, {so} : Somali, {son} :
-Songhai, {snk} : Soninke, {wen} : Sorbian languages, {nso} : Northern
-Sotho, {st} : Southern Sotho, [{sai} : South American Indian (Other)], {es}
-: Spanish, {suk} : Sukuma, {sux} : Sumerian, {su} : Sundanese, {sus} :
-Susu, {sw} : Swahili, {ss} : Swati, {sv} : Swedish, {syr} : Syriac, {tl} :
-Tagalog, {ty} : Tahitian, [{tai} : Tai (Other)], {tg} : Tajik, {tmh} :
-Tamashek, {ta} : Tamil, {i-tao} : Tao, {tt} : Tatar, {i-tay} : Tayal, {te}
-: Telugu, {ter} : Tereno, {tet} : Tetum, {th} : Thai, {bo} : Tibetan, {tig}
-: Tigre, {ti} : Tigrinya, {tem} : Timne, {tiv} : Tiv, {tli} : Tlingit,
-{tpi} : Tok Pisin, {tkl} : Tokelau, {tog} : Tonga (Nyasa), {to} : Tonga
-(Tonga Islands), {tsi} : Tsimshian, {ts} : Tsonga, {i-tsu} : Tsou, {tn} :
-Tswana, {tum} : Tumbuka, {tr} : Turkish, {ota} : Ottoman Turkish
-(1500-1928), {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} : Twi,
-{uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian, {umb} : Umbundu, {und} :
-Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} : Vai, {ven} : Venda, {vi} :
-Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak} : Wakashan languages],
-{wal} : Walamo, {war} : Waray, {was} : Washo, {cy} : Welsh, {wo} : Wolof,
-{x-...} : Unregistered (Semi-Private Use), {xh} : Xhosa, {sah} : Yakut,
-{yao} : Yao, {yap} : Yapese, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik
-languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} :
-Zhuang, {zu} : Zulu, {zun} : Zuni
+languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} :
+Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami,
+[{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} :
+Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak,
+{sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian,
+{srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign
+Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} :
+Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave
+(Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian,
+{sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} :
+Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} :
+South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} :
+Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati,
+{sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} :
+Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao,
+{tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} :
+Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} :
+Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau,
+{tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian,
+{ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} :
+Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh}
+: Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} :
+Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian,
+{umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} :
+Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak}
+: Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was}
+: Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private
+Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} :
+Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
+: Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu,
+{zun} : Zuni
 
 =item SEE ALSO
 
@@ -15041,7 +15042,7 @@ new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
 
 =item METHODS
 
-open( FILENAME [,MODE [,PERMS]] )
+open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
 
 =item SEE ALSO
 
@@ -15279,7 +15280,7 @@ new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
 
 =item METHODS
 
-open( FILENAME [,MODE [,PERMS]] )
+open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
 
 =item SEE ALSO
 
@@ -16039,10 +16040,12 @@ ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
 
 =item BUGS
 
-=item CAVEAT
+=item CAVEATS
 
 stringify, bstr(), bdiv, Modifying and =, bpow
 
+=item SEE ALSO
+
 =item LICENSE
 
 =item AUTHORS
@@ -16235,7 +16238,8 @@ bsqrt(), div(), blog()
 
 =item BUGS
 
-Out of Memory!, Fails to load Calc on Perl prior 5.6.0
+broot() does not work, Out of Memory!, Fails to load Calc on Perl prior
+5.6.0
 
 =item CAVEATS
 
@@ -16259,7 +16263,9 @@ types, bsqrt(), brsft()
 
 =item DESCRIPTION
 
-=item EXPORT
+=item STORAGE
+
+=item METHODS
 
 =item WRAP YOUR OWN
 
@@ -16332,6 +16338,8 @@ the same terms as Perl itself.
 
 =item bround()/round()/bfround()
 
+=item bmod()
+
 =item is_one()
 
 =item is_zero()
@@ -16352,6 +16360,8 @@ the same terms as Perl itself.
 
 	$x->bfloor();
 
+=item config
+
 =back
 
 =item BUGS
@@ -16640,7 +16650,7 @@ dataend ()
 
 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
-ungetline ( TEXT ), read_until_dot (), tied_fh ()
+ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh ()
 
 =item EXPORTS
 
@@ -16707,15 +16717,16 @@ login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
 site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS])
 ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME
 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ),
-mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), dir ( [ DIR ] ), get (
-REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put ( LOCAL_FILE [, REMOTE_FILE ]
-), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ), append ( LOCAL_FILE [,
-REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size ( FILE ), supported (
-CMD ), hash ( [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR
-] ), list ( [ DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe (
-FILE ), port ( [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [,
-DEST_FILE ] ), pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
-pasv_wait ( NON_PASV_SERVER ), abort (), quit ()
+mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), alloc ( SIZE [, RECORD_SIZE] ),
+dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put (
+LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ),
+append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size
+( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[
+BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ DIR ] ), retr ( FILE ),
+stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [ PORT ] ), pasv (),
+pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_xfer_unique (
+SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( NON_PASV_SERVER ),
+abort (), quit ()
 
 =over 4
 
@@ -16732,7 +16743,7 @@ bytes_read (), abort (), close ()
 
 =item UNIMPLEMENTED
 
-B<ALLO>, B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
+B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
 
 =item REPORTING BUGS
 
@@ -16806,8 +16817,6 @@ MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
 
 =item DESCRIPTION
 
-=item EXAMPLES
-
 =item CONSTRUCTOR
 
 new ( [ HOST, ] [ OPTIONS ] )
@@ -16841,8 +16850,8 @@ MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
 
 =item Functions
 
-Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device ]]]]);,
-$p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
+Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos
+]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
 $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
 $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
 [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host
@@ -17288,7 +17297,7 @@ wctomb, write
 
 =item POSIX::SigAction
 
-new, handler, mask, flags
+new, handler, mask, flags, safe
 
 =item POSIX::SigSet
 
@@ -19426,7 +19435,7 @@ C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
 
 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
-C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
+C<HARNESS_OK_SLOW>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
 
 =item EXAMPLE
 
@@ -19768,6 +19777,10 @@ L<Test::Harness>
 
 =item C<extract_bracketed>
 
+=item C<extract_variable>
+
+[0], [1], [2]
+
 =item C<extract_tagged>
 
 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
@@ -20199,6 +20212,10 @@ getitimer ( $which )
 
 =item BUGS
 
+=item SUPPORT
+
+=item AUTHOR
+
 =back
 
 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
@@ -20302,8 +20319,6 @@ Base_Unicode_Version
 
 =item EXPORT
 
-=item TODO
-
 =item CAVEAT
 
 =item Conformance Test
diff --git a/win32/Makefile b/win32/Makefile
index 22ddba1576..704b780fd3 100644
--- a/win32/Makefile
+++ b/win32/Makefile
@@ -984,6 +984,7 @@ utils: $(PERLEXE) $(X2P)
 	copy ..\README.irix     .\perlirix.pod
 	copy ..\README.machten  .\perlmachten.pod
 	copy ..\README.macos    .\perlmacos.pod
+	copy ..\README.macosx   .\perlmacosx.pod
 	copy ..\README.mint     .\perlmint.pod
 	copy ..\README.mpeix    .\perlmpeix.pod
 	copy ..\README.netware  .\perlnetware.pod
diff --git a/win32/makefile.mk b/win32/makefile.mk
index d01284e781..969876b53d 100644
--- a/win32/makefile.mk
+++ b/win32/makefile.mk
@@ -1119,6 +1119,7 @@ utils: $(PERLEXE) $(X2P)
 	copy ..\README.irix	..\pod\perlirix.pod
 	copy ..\README.machten	..\pod\perlmachten.pod
 	copy ..\README.macos	..\pod\perlmacos.pod
+	copy ..\README.macosx	..\pod\perlmacosx.pod
 	copy ..\README.mint	..\pod\perlmint.pod
 	copy ..\README.mpeix	..\pod\perlmpeix.pod
 	copy ..\README.netware	..\pod\perlnetware.pod