Add the URL for annotated svn of S03.
[p5sagit/p5-mst-13.2.git] / pod / perltoc.pod
index fcd2047..1836d4a 100644 (file)
@@ -885,7 +885,7 @@ Interaction, perlfaq9 - Networking
 
 =back
 
-=head2 perlfaq1 - General Questions About Perl ($Revision: 8539 $)
+=head2 perlfaq1 - General Questions About Perl
 
 =over 4
 
@@ -899,11 +899,11 @@ Interaction, perlfaq9 - Networking
 
 =item Which version of Perl should I use?
 
-=item What are perl4, perl5, or perl6?
+=item What are Perl 4, Perl 5, or Perl 6?
 
 =item What was Ponie?
 
-=item What is perl6?
+=item What is Perl 6?
 
 =item How stable is Perl?
 
@@ -937,7 +937,7 @@ http://www.perl.org/advocacy/whyperl.html
 
 =back
 
-=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 8539 $)
+=head2 perlfaq2 - Obtaining and Learning about Perl
 
 =over 4
 
@@ -992,7 +992,7 @@ References, Tutorials, Task-Oriented, Special Topics
 
 =back
 
-=head2 perlfaq3 - Programming Tools ($Revision: 8539 $)
+=head2 perlfaq3 - Programming Tools
 
 =over 4
 
@@ -1031,7 +1031,10 @@ Alpha, BBEdit and BBEdit Lite
 
 =item How can I use curses with Perl?
 
-=item How can I use X or Tk with Perl?
+=item How can I write a GUI (X, Tk, Gtk, etc.) in Perl?
+X<GUI> X<Tk> X<Wx> X<WxWidgets> X<Gtk> X<Gtk2> X<CamelBones> X<Qt>
+
+Tk, Wx, Gtk and Gtk2, Win32::GUI, CamelBones, Qt, Athena
 
 =item How can I make my Perl program run faster?
 
@@ -1077,7 +1080,7 @@ program; what am I doing wrong?
 
 =back
 
-=head2 perlfaq4 - Data Manipulation ($Revision: 8539 $)
+=head2 perlfaq4 - Data Manipulation
 
 =over 4
 
@@ -1221,6 +1224,8 @@ intersection of two arrays?
 =item How do I select a random element from an array?
 
 =item How do I permute N elements of a list?
+X<List::Permuter> X<permute> X<Algorithm::Loops> X<Knuth>
+X<The Art of Computer Programming> X<Fischer-Krause>
 
 =item How do I sort an array by (anything)?
 
@@ -1296,7 +1301,7 @@ array of hashes or arrays?
 
 =back
 
-=head2 perlfaq5 - Files and Formats ($Revision: 8579 $)
+=head2 perlfaq5 - Files and Formats
 
 =over 4
 
@@ -1307,10 +1312,6 @@ array of hashes or arrays?
 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
 X<flush> X<buffer> X<unbuffer> X<autoflush>
 
-=item How do I change, delete, or insert a line in a file, or append to the
-beginning of a file?
-X<file, editing>
-
 =item How do I count the number of lines in a file?
 X<file, counting lines> X<lines> X<line>
 
@@ -1339,8 +1340,8 @@ X<footer>
 =item How can I write() into a string?
 X<write, into a string>
 
-=item How can I output my numbers with commas added?
-X<number, commify>
+=item How can I open a filehandle to a string?
+X<string>, X<open>, X<IO::Scalar>, X<filehandle>
 
 =item How can I translate tildes (~) in a filename?
 X<tilde> X<tilde expansion>
@@ -1430,7 +1431,7 @@ X<file, selecting a random line>
 
 =back
 
-=head2 perlfaq6 - Regular Expressions ($Revision: 8539 $)
+=head2 perlfaq6 - Regular Expressions
 
 =over 4
 
@@ -1527,7 +1528,7 @@ X<\E, regex>, X<qr//>
 
 =back
 
-=head2 perlfaq7 - General Perl Language Issues ($Revision: 9309 $)
+=head2 perlfaq7 - General Perl Language Issues
 
 =over 4
 
@@ -1555,6 +1556,8 @@ commas?
 
 =item How do I create a module?
 
+=item How do I adopt or take over a module already on CPAN?
+
 =item How do I create a class?
 
 =item How can I tell if a variable is tainted?
@@ -1610,7 +1613,7 @@ methods?
 
 =back
 
-=head2 perlfaq8 - System Interaction ($Revision: 8539 $)
+=head2 perlfaq8 - System Interaction
 
 =over 4
 
@@ -1655,8 +1658,10 @@ STDIN, STDOUT, and STDERR are shared, Signals, Zombies
 =item How do I set the time and date?
 
 =item How can I sleep() or alarm() for under a second?
+X<Time::HiRes> X<BSD::Itimer> X<sleep> X<select>
 
 =item How can I measure time under a second?
+X<Time::HiRes> X<BSD::Itimer> X<sleep> X<select>
 
 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
 
@@ -1709,6 +1714,7 @@ complete?
 =item How do I timeout a slow event?
 
 =item How do I set CPU limits?
+X<BSD::Resource> X<limit> X<CPU>
 
 =item How do I avoid zombies on a Unix system?
 
@@ -1731,6 +1737,9 @@ search path?
 
 =item How do I add a directory to my include path (@INC) at runtime?
 
+the PERLLIB environment variable, the PERL5LIB environment variable, the
+perl -Idir command line flag, the use lib pragma:
+
 =item What is socket.ph and where do I get it?
 
 =back
@@ -1741,7 +1750,7 @@ search path?
 
 =back
 
-=head2 perlfaq9 - Networking ($Revision: 8539 $)
+=head2 perlfaq9 - Networking
 
 =over 4
 
@@ -1998,10 +2007,9 @@ X<operator, logical, not> X<not>
 X<operator, logical, and> X<and>
 
 =item Logical or, Defined or, and Exclusive Or
-X<operator, logical, or> X<operator, logical, xor> X<operator, logical,
-err>
+X<operator, logical, or> X<operator, logical, xor>
 X<operator, logical, defined or> X<operator, logical, exclusive or>
-X<or> X<xor> X<err>
+X<or> X<xor>
 
 =item C Operators Missing From Perl
 X<operator, missing from perl> X<&> X<*>
@@ -2150,7 +2158,7 @@ flow of your Perl program X<control flow>, Keywords related to switch,
 Keywords related to scoping, Miscellaneous functions, Functions for
 processes and process groups X<process> X<pid> X<process id>, Keywords
 related to perl modules X<module>, Keywords related to classes and
-object-orientedness X<object> X<class> X<package>, Low-level socket
+object-orientation X<object> X<class> X<package>, Low-level socket
 functions X<socket> X<sock>, System V interprocess communication functions
 X<IPC> X<System V> X<semaphore> X<shared memory> X<memory> X<message>,
 Fetching user and group info X<user> X<group> X<password> X<uid> X<gid> 
@@ -2602,7 +2610,7 @@ B<-M>[B<->]I<'module ...'>, B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>
 X<-n>, B<-p> X<-p>, B<-P> X<-P>, B<-s> X<-s>, B<-S> X<-S>, B<-t> X<-t>,
 B<-T> X<-T>, B<-u> X<-u>, B<-U> X<-U>, B<-v> X<-v>, B<-V> X<-V>,
 B<-V:>I<configvar>, B<-w> X<-w>, B<-W> X<-W>, B<-X> X<-X>, B<-x> X<-x>,
-B<-x> I<directory>
+B<-x>I<directory>
 
 =back
 
@@ -2632,6 +2640,8 @@ X<SYS$LOGIN>
 
 =item DESCRIPTION
 
+=item SEE ALSO
+
 =back
 
 =head2 perllexwarn - Perl Lexical Warnings
@@ -2663,8 +2673,6 @@ X<warning, reporting> X<warning, registering>
 
 =back
 
-=item TODO
-
 =item SEE ALSO
 
 =item AUTHOR
@@ -2681,6 +2689,11 @@ X<warning, reporting> X<warning, registering>
 
 =over 4
 
+=item Calling the debugger
+
+perl -d program_name, perl -d -e 0, perl -d:Ptkdb program_name, perl -dt
+threaded_program_name
+
 =item Debugger Commands
 
 h X<debugger command, h>, h [command], h h, p expr X<debugger command, p>,
@@ -2786,8 +2799,8 @@ $ARG, $_ X<$_> X<$ARG>, $a, $b X<$a> X<$b>, $<I<digits>> X<$1> X<$2> X<$3>,
 $MATCH, $& X<$&> X<$MATCH>, ${^MATCH} X<${^MATCH}>, $PREMATCH, $` X<$`>
 X<$PREMATCH>, ${^PREMATCH} X<${^PREMATCH}>, $POSTMATCH, $' X<$'>
 X<$POSTMATCH>, ${^POSTMATCH} X<${^POSTMATCH}>, $LAST_PAREN_MATCH, $+ X<$+>
-X<$LAST_PAREN_MATCH>, $^N X<$^N>, @LAST_MATCH_END, @+ X<@+>
-X<@LAST_MATCH_END>, %+ X<%+>, HANDLE->input_line_number(EXPR),
+X<$LAST_PAREN_MATCH>, $LAST_SUBMATCH_RESULT, $^N X<$^N>, @LAST_MATCH_END,
+@+ X<@+> X<@LAST_MATCH_END>, %+ X<%+>, HANDLE->input_line_number(EXPR),
 $INPUT_LINE_NUMBER, $NR, $. X<$.> X<$NR> X<$INPUT_LINE_NUMBER> X<line
 number>, IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR,
 $RS, $/ X<$/> X<$RS> X<$INPUT_RECORD_SEPARATOR>, HANDLE->autoflush(EXPR),
@@ -2815,27 +2828,28 @@ IO::Handle->format_formfeed EXPR, $FORMAT_FORMFEED, $^L X<$^L>
 X<$FORMAT_FORMFEED>, $ACCUMULATOR, $^A X<$^A> X<$ACCUMULATOR>,
 $CHILD_ERROR, $? X<$?> X<$CHILD_ERROR>, ${^CHILD_ERROR_NATIVE}
 X<$^CHILD_ERROR_NATIVE>, ${^ENCODING} X<$^ENCODING>, $OS_ERROR, $ERRNO, $!
-X<$!> X<$ERRNO> X<$OS_ERROR>, %! X<%!>, $EXTENDED_OS_ERROR, $^E X<$^E>
-X<$EXTENDED_OS_ERROR>, $EVAL_ERROR, $@ X<$@> X<$EVAL_ERROR>, $PROCESS_ID,
-$PID, $$ X<$$> X<$PID> X<$PROCESS_ID>, $REAL_USER_ID, $UID, $< X<< $< >>
-X<$UID> X<$REAL_USER_ID>, $EFFECTIVE_USER_ID, $EUID, $> X<< $> >> X<$EUID>
-X<$EFFECTIVE_USER_ID>, $REAL_GROUP_ID, $GID, $( X<$(> X<$GID>
-X<$REAL_GROUP_ID>, $EFFECTIVE_GROUP_ID, $EGID, $) X<$)> X<$EGID>
-X<$EFFECTIVE_GROUP_ID>, $PROGRAM_NAME, $0 X<$0> X<$PROGRAM_NAME>, $[ X<$[>,
-$] X<$]>, $COMPILING, $^C X<$^C> X<$COMPILING>, $DEBUGGING, $^D X<$^D>
-X<$DEBUGGING>, ${^RE_DEBUG_FLAGS}, ${^RE_TRIE_MAXBUF}, $SYSTEM_FD_MAX, $^F
-X<$^F> X<$SYSTEM_FD_MAX>, $^H, %^H, $INPLACE_EDIT, $^I X<$^I>
-X<$INPLACE_EDIT>, $^M X<$^M>, $OSNAME, $^O X<$^O> X<$OSNAME>, ${^OPEN},
-$PERLDB, $^P X<$^P> X<$PERLDB>, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40,
-0x80, 0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R X<$^R>
-X<$LAST_REGEXP_CODE_RESULT>, $EXCEPTIONS_BEING_CAUGHT, $^S X<$^S>
-X<$EXCEPTIONS_BEING_CAUGHT>, $BASETIME, $^T X<$^T> X<$BASETIME>, ${^TAINT},
-${^UNICODE}, ${^UTF8CACHE}, ${^UTF8LOCALE}, $PERL_VERSION, $^V X<$^V>
-X<$PERL_VERSION>, $WARNING, $^W X<$^W> X<$WARNING>, ${^WARNING_BITS},
-${^WIN32_SLOPPY_STAT}, $EXECUTABLE_NAME, $^X X<$^X> X<$EXECUTABLE_NAME>,
-ARGV X<ARGV>, $ARGV X<$ARGV>, @ARGV X<@ARGV>, ARGVOUT X<ARGVOUT>, @F X<@F>,
-@INC X<@INC>, @ARG, @_ X<@_> X<@ARG>, %INC X<%INC>, %ENV, $ENV{expr}
-X<%ENV>, %SIG, $SIG{expr} X<%SIG>
+X<$!> X<$ERRNO> X<$OS_ERROR>, %OS_ERROR, %ERRNO, %! X<%!>,
+$EXTENDED_OS_ERROR, $^E X<$^E> X<$EXTENDED_OS_ERROR>, $EVAL_ERROR, $@ X<$@>
+X<$EVAL_ERROR>, $PROCESS_ID, $PID, $$ X<$$> X<$PID> X<$PROCESS_ID>,
+$REAL_USER_ID, $UID, $< X<< $< >> X<$UID> X<$REAL_USER_ID>,
+$EFFECTIVE_USER_ID, $EUID, $> X<< $> >> X<$EUID> X<$EFFECTIVE_USER_ID>,
+$REAL_GROUP_ID, $GID, $( X<$(> X<$GID> X<$REAL_GROUP_ID>,
+$EFFECTIVE_GROUP_ID, $EGID, $) X<$)> X<$EGID> X<$EFFECTIVE_GROUP_ID>,
+$PROGRAM_NAME, $0 X<$0> X<$PROGRAM_NAME>, $[ X<$[>, $] X<$]>, $COMPILING,
+$^C X<$^C> X<$COMPILING>, $DEBUGGING, $^D X<$^D> X<$DEBUGGING>,
+${^RE_DEBUG_FLAGS}, ${^RE_TRIE_MAXBUF}, $SYSTEM_FD_MAX, $^F X<$^F>
+X<$SYSTEM_FD_MAX>, $^H, %^H, $INPLACE_EDIT, $^I X<$^I> X<$INPLACE_EDIT>,
+$^M X<$^M>, $OSNAME, $^O X<$^O> X<$OSNAME>, ${^OPEN}, $PERLDB, $^P X<$^P>
+X<$PERLDB>, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80, 0x100, 0x200,
+0x400, $LAST_REGEXP_CODE_RESULT, $^R X<$^R> X<$LAST_REGEXP_CODE_RESULT>,
+$EXCEPTIONS_BEING_CAUGHT, $^S X<$^S> X<$EXCEPTIONS_BEING_CAUGHT>,
+$BASETIME, $^T X<$^T> X<$BASETIME>, ${^TAINT}, ${^UNICODE}, ${^UTF8CACHE},
+${^UTF8LOCALE}, $PERL_VERSION, $^V X<$^V> X<$PERL_VERSION>, $WARNING, $^W
+X<$^W> X<$WARNING>, ${^WARNING_BITS}, ${^WIN32_SLOPPY_STAT},
+$EXECUTABLE_NAME, $^X X<$^X> X<$EXECUTABLE_NAME>, ARGV X<ARGV>, $ARGV
+X<$ARGV>, @ARGV X<@ARGV>, ARGVOUT X<ARGVOUT>, @F X<@F>, @INC X<@INC>, @ARG,
+@_ X<@_> X<@ARG>, %INC X<%INC>, %ENV, $ENV{expr} X<%ENV>, %SIG, $SIG{expr}
+X<%SIG>
 
 =item Error Indicators
 X<error> X<exception>
@@ -2862,7 +2876,7 @@ m X</m> X<regex, multiline> X<regexp, multiline> X<regular expression,
 multiline>, s X</s> X<regex, single-line> X<regexp, single-line> X<regular
 expression, single-line>, i X</i> X<regex, case-insensitive> X<regexp,
 case-insensitive> X<regular expression, case-insensitive>, x X</x>, p X</p>
-X<regex, preserve> X<regexp, preserve>
+X<regex, preserve> X<regexp, preserve>, g and c X</g> X</c>
 
 =item Regular Expressions
 
@@ -2871,7 +2885,7 @@ X<punct>, xdigit X<xdigit>
 
 =item Extended Patterns
 
-C<(?#text)> X<(?#)>, C<(?kimsx-imsx)> X<(?)>, C<(?:pattern)> X<(?:)>,
+C<(?#text)> X<(?#)>, C<(?pimsx-imsx)> X<(?)>, C<(?:pattern)> X<(?:)>,
 C<(?imsx-imsx:pattern)>, C<(?|pattern)> X<(?|)> X<Branch reset>,
 Look-Around Assertions X<look-around assertion> X<lookaround assertion>
 X<look-around> X<lookaround>, C<(?=pattern)> X<(?=)> X<look-ahead,
@@ -2895,10 +2909,10 @@ X<backtracking> X<atomic> X<possessive>
 =item Special Backtracking Control Verbs
 
 Verbs that take an argument, C<(*PRUNE)> C<(*PRUNE:NAME)> X<(*PRUNE)>
-X<(*PRUNE:NAME)> X<\v>, C<(*SKIP)> C<(*SKIP:NAME)> X<(*SKIP)>,
-C<(*MARK:NAME)> C<(*:NAME)> X<(*MARK)> C<(*MARK:NAME)> C<(*:NAME)>,
-C<(*THEN)> C<(*THEN:NAME)>, C<(*COMMIT)> X<(*COMMIT)>, Verbs without an
-argument, C<(*FAIL)> C<(*F)> X<(*FAIL)> X<(*F)>, C<(*ACCEPT)> X<(*ACCEPT)>
+X<(*PRUNE:NAME)>, C<(*SKIP)> C<(*SKIP:NAME)> X<(*SKIP)>, C<(*MARK:NAME)>
+C<(*:NAME)> X<(*MARK)> C<(*MARK:NAME)> C<(*:NAME)>, C<(*THEN)>
+C<(*THEN:NAME)>, C<(*COMMIT)> X<(*COMMIT)>, Verbs without an argument,
+C<(*FAIL)> C<(*F)> X<(*FAIL)> X<(*F)>, C<(*ACCEPT)> X<(*ACCEPT)>
 
 =item Backtracking
 X<backtrack> X<backtracking>
@@ -3452,6 +3466,8 @@ string
 
 =item Ignoring A Thread
 
+=item Process and Thread Termination
+
 =back
 
 =item Threads And Data
@@ -3970,15 +3986,17 @@ classes, Use of "Is" Prefix, Blocks
 
 =over 4
 
-=item DESCRIPTION
+=item Q and A
 
 =over 4
 
 =item perlunitut isn't really a Unicode tutorial, is it?
 
-=item What about binary data, like images?
+=item What character encodings does Perl support?
 
-=item What about the UTF8 flag?
+=item Which version of perl should I use?
+
+=item What about binary data, like images?
 
 =item When should I decode or encode?
 
@@ -3988,30 +4006,43 @@ classes, Use of "Is" Prefix, Blocks
 
 =item Is there a way to automatically decode or encode?
 
-=item Cheat?! Tell me, how can I cheat?
-
 =item What if I don't know which encoding was used?
 
 =item Can I use Unicode in my Perl sources?
 
 =item Data::Dumper doesn't restore the UTF8 flag; is it broken?
 
+=item Why do regex character classes sometimes match only in the ASCII
+range?
+
+=item Why do some characters not uppercase or lowercase correctly?
+
 =item How can I determine if a string is a text string or a binary string?
 
 =item How do I convert from encoding FOO to encoding BAR?
 
+=item What are C<decode_utf8> and C<encode_utf8>?
+
+=item What is a "wide character"?
+
+=back
+
+=item INTERNALS
+
+=over 4
+
+=item What is "the UTF8 flag"?
+
 =item What about the C<use bytes> pragma?
 
-=item What are C<decode_utf8> and C<encode_utf8>?
+=item What about the C<use encoding> pragma?
+
+=item What is the difference between C<:encoding> and C<:utf8>?
 
 =item What's the difference between C<UTF-8> and C<utf8>?
 
 =item I lost track; what encoding is the internal format really?
 
-=item What character encodings does Perl support?
-
-=item Which version of perl should I use?
-
 =back
 
 =item AUTHOR
@@ -4262,31 +4293,32 @@ AnyDBM_File, Archive::Extract, Archive::Tar, Archive::Tar::File,
 Attribute::Handlers, AutoLoader, AutoSplit, B, B::Concise, B::Debug,
 B::Deparse, B::Lint, B::Showlex, B::Terse, B::Xref, Benchmark, CGI,
 CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push,
-CGI::Switch, CGI::Util, CPAN, CPAN::FirstTime, CPAN::Kwalify, CPAN::Nox,
-CPAN::Version, CPANPLUS, CPANPLUS::Dist::Base, CPANPLUS::Dist::Sample,
-CPANPLUS::Shell::Classic, CPANPLUS::Shell::Default::Plugins::HOWTO, Carp,
-Carp::Heavy, Class::ISA, Class::Struct, Compress::Raw::Zlib,
-Compress::Zlib, Config, Cwd, DB, DBM_Filter, DBM_Filter::compress,
-DBM_Filter::encode, DBM_Filter::int32, DBM_Filter::null, DBM_Filter::utf8,
-DB_File, Data::Dumper, Devel::DProf, Devel::InnerPackage, Devel::Peek,
-Devel::SelfStubber, Digest, Digest::MD5, Digest::SHA, Digest::base,
-Digest::file, DirHandle, Dumpvalue, DynaLoader, Encode, Encode::Alias,
-Encode::Byte, Encode::CJKConstants, Encode::CN, Encode::CN::HZ,
-Encode::Config, Encode::EBCDIC, Encode::Encoder, Encode::Encoding,
-Encode::GSM0338, Encode::Guess, Encode::JP, Encode::JP::H2Z,
-Encode::JP::JIS7, Encode::KR, Encode::KR::2022_KR, Encode::MIME::Header,
-Encode::MIME::Name, Encode::PerlIO, Encode::Supported, Encode::Symbol,
-Encode::TW, Encode::Unicode, Encode::Unicode::UTF7, English, Env, Errno,
-Exporter, Exporter::Heavy, ExtUtils::CBuilder,
-ExtUtils::CBuilder::Platform::Windows, ExtUtils::Command,
-ExtUtils::Command::MM, ExtUtils::Constant, ExtUtils::Constant::Base,
-ExtUtils::Constant::Utils, ExtUtils::Constant::XS, ExtUtils::Embed,
-ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM,
-ExtUtils::MM_AIX, ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin,
-ExtUtils::MM_DOS, ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2,
-ExtUtils::MM_QNX, ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS,
-ExtUtils::MM_VOS, ExtUtils::MM_Win32, ExtUtils::MM_Win95, ExtUtils::MY,
-ExtUtils::MakeMaker, ExtUtils::MakeMaker::Config, ExtUtils::MakeMaker::FAQ,
+CGI::Switch, CGI::Util, CORE, CPAN, CPAN::API::HOWTO, CPAN::FirstTime,
+CPAN::Kwalify, CPAN::Nox, CPAN::Version, CPANPLUS, CPANPLUS::Dist::Base,
+CPANPLUS::Dist::Sample, CPANPLUS::Shell::Classic,
+CPANPLUS::Shell::Default::Plugins::HOWTO, Carp, Carp::Heavy, Class::ISA,
+Class::Struct, Compress::Raw::Zlib, Compress::Zlib, Config, Cwd, DB,
+DBM_Filter, DBM_Filter::compress, DBM_Filter::encode, DBM_Filter::int32,
+DBM_Filter::null, DBM_Filter::utf8, DB_File, Data::Dumper, Devel::DProf,
+Devel::InnerPackage, Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5,
+Digest::SHA, Digest::base, Digest::file, DirHandle, Dumpvalue, DynaLoader,
+Encode, Encode::Alias, Encode::Byte, Encode::CJKConstants, Encode::CN,
+Encode::CN::HZ, Encode::Config, Encode::EBCDIC, Encode::Encoder,
+Encode::Encoding, Encode::GSM0338, Encode::Guess, Encode::JP,
+Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR, Encode::KR::2022_KR,
+Encode::MIME::Header, Encode::MIME::Name, Encode::PerlIO,
+Encode::Supported, Encode::Symbol, Encode::TW, Encode::Unicode,
+Encode::Unicode::UTF7, English, Env, Errno, Exporter, Exporter::Heavy,
+ExtUtils::CBuilder, ExtUtils::CBuilder::Platform::Windows,
+ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant,
+ExtUtils::Constant::Base, ExtUtils::Constant::Utils,
+ExtUtils::Constant::XS, ExtUtils::Embed, ExtUtils::Install,
+ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_AIX,
+ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS,
+ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_QNX,
+ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_VOS,
+ExtUtils::MM_Win32, ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker,
+ExtUtils::MakeMaker::Config, ExtUtils::MakeMaker::FAQ,
 ExtUtils::MakeMaker::Tutorial, ExtUtils::MakeMaker::bytes,
 ExtUtils::MakeMaker::vmsish, ExtUtils::Manifest, ExtUtils::Mkbootstrap,
 ExtUtils::Mksymlists, ExtUtils::Packlist, ExtUtils::ParseXS,
@@ -4311,7 +4343,7 @@ List::Util, Locale::Constants, Locale::Country, Locale::Currency,
 Locale::Language, Locale::Maketext, Locale::Maketext::Simple,
 Locale::Maketext::TPJ13, Locale::Script, Log::Message,
 Log::Message::Config, Log::Message::Handlers, Log::Message::Item,
-MIME::Base64, MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt,
+MIME::Base64, MIME::QuotedPrint, Math::BigFloat, Math::BigInt,
 Math::BigInt::Calc, Math::BigInt::CalcEmu, Math::BigInt::FastCalc,
 Math::BigRat, Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File,
 Memoize::Expire, Memoize::ExpireFile, Memoize::ExpireTest,
@@ -4350,19 +4382,20 @@ Pod::Simple::TextContent, Pod::Simple::XMLOutStream, Pod::Text,
 Pod::Text::Color, Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage,
 SDBM_File, Safe, Scalar::Util, Search::Dict, SelectSaver, SelfLoader,
 Shell, Socket, Storable, Switch, Symbol, Sys::Hostname, Sys::Syslog,
-Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine, Term::UI, Test,
-Test::Builder, Test::Builder::Module, Test::Builder::Tester,
-Test::Builder::Tester::Color, Test::Harness, Test::Harness::Assert,
-Test::Harness::Iterator, Test::Harness::Point, Test::Harness::Results,
-Test::Harness::Straps, Test::Harness::TAP, Test::Harness::Util, Test::More,
-Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced,
-Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Thread,
-Thread::Queue, Thread::Semaphore, Tie::Array, Tie::File, Tie::Handle,
-Tie::Hash, Tie::Hash::NamedCapture, Tie::Memoize, Tie::RefHash,
-Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::Piece,
-Time::Piece::Seconds, Time::gmtime, Time::localtime, Time::tm, UNIVERSAL,
-Unicode::Collate, Unicode::Normalize, Unicode::UCD, User::grent,
-User::pwent, Win32, Win32API::File, XS::APItest, XS::Typemap, XSLoader
+Sys::Syslog::win32::Win32, Term::ANSIColor, Term::Cap, Term::Complete,
+Term::ReadLine, Term::UI, Test, Test::Builder, Test::Builder::Module,
+Test::Builder::Tester, Test::Builder::Tester::Color, Test::Harness,
+Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Point,
+Test::Harness::Results, Test::Harness::Straps, Test::Harness::TAP,
+Test::Harness::Util, Test::More, Test::Simple, Test::Tutorial,
+Text::Abbrev, Text::Balanced, Text::ParseWords, Text::Soundex, Text::Tabs,
+Text::Wrap, Thread, Thread::Queue, Thread::Semaphore, Tie::Array,
+Tie::File, Tie::Handle, Tie::Hash, Tie::Hash::NamedCapture, Tie::Memoize,
+Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local,
+Time::Piece, Time::Piece::Seconds, Time::gmtime, Time::localtime, Time::tm,
+UNIVERSAL, Unicode::Collate, Unicode::Normalize, Unicode::UCD, User::grent,
+User::pwent, Win32, Win32API::File, Win32CORE, XS::APItest, XS::Typemap,
+XSLoader
 
 =item Extension Modules
 
@@ -4765,9 +4798,10 @@ currently selected output channel, CV
 =item D
 
 dangling statement, data structure, data type, datagram, DBM, declaration,
-decrement, default, defined, delimiter, dereference, derived class,
-descriptor, destroy, destructor, device, directive, directory, directory
-handle, dispatch, distribution, dweomer, dwimmer, dynamic scoping
+decrement, default, defined, delimiter, deprecated modules and features,
+dereference, derived class, descriptor, destroy, destructor, device,
+directive, directory, directory handle, dispatch, distribution, (to be)
+dropped modules, dweomer, dwimmer, dynamic scoping
 
 =item E
 
@@ -5521,7 +5555,8 @@ callback
 
 C</m> - RXf_PMf_MULTILINE, C</s> - RXf_PMf_SINGLELINE, C</i> -
 RXf_PMf_FOLD, C</x> - RXf_PMf_EXTENDED, C</p> - RXf_PMf_KEEPCOPY,
-RXf_SKIPWHITE, RXf_PMf_LOCALE, RXf_UTF8, RXf_START_ONLY, RXf_WHITE
+RXf_PMf_LOCALE, RXf_UTF8, RXf_SPLIT, RXf_SKIPWHITE, RXf_START_ONLY,
+RXf_WHITE, RXf_NULL
 
 =item exec
 
@@ -5718,6 +5753,10 @@ X<sv_pvn>, sv_pvutf8 X<sv_pvutf8>, sv_pvutf8n X<sv_pvutf8n>, sv_taint
 X<sv_taint>, sv_unref X<sv_unref>, sv_usepvn X<sv_usepvn>, sv_usepvn_mg
 X<sv_usepvn_mg>, sv_uv X<sv_uv>, unpack_str X<unpack_str>
 
+=item Functions in file pp_ctl.c
+
+find_runcv X<find_runcv>
+
 =item Functions in file pp_pack.c
 
 packlist X<packlist>, unpackstring X<unpackstring>
@@ -5777,15 +5816,14 @@ X<getcwd_sv>, my_snprintf X<my_snprintf>, my_sprintf X<my_sprintf>,
 my_vsnprintf X<my_vsnprintf>, new_version X<new_version>, scan_version
 X<scan_version>, strEQ X<strEQ>, strGE X<strGE>, strGT X<strGT>, strLE
 X<strLE>, strLT X<strLT>, strNE X<strNE>, strnEQ X<strnEQ>, strnNE
-X<strnNE>, sv_nosharing X<sv_nosharing>, upg_version X<upg_version>, vcmp
-X<vcmp>, vnormal X<vnormal>, vnumify X<vnumify>, vstringify X<vstringify>,
-vverify X<vverify>
+X<strnNE>, sv_destroyable X<sv_destroyable>, sv_nosharing X<sv_nosharing>,
+upg_version X<upg_version>, vcmp X<vcmp>, vnormal X<vnormal>, vnumify
+X<vnumify>, vstringify X<vstringify>, vverify X<vverify>
 
 =item MRO Functions
 
-mro_get_linear_isa X<mro_get_linear_isa>, mro_get_linear_isa_c3
-X<mro_get_linear_isa_c3>, mro_get_linear_isa_dfs X<mro_get_linear_isa_dfs>,
-mro_method_changed_in X<mro_method_changed_in>
+mro_get_linear_isa X<mro_get_linear_isa>, mro_method_changed_in
+X<mro_method_changed_in>
 
 =item Multicall Functions
 
@@ -5993,10 +6031,6 @@ PAD_SET_CUR X<PAD_SET_CUR>, PAD_SET_CUR_NOSAVE X<PAD_SET_CUR_NOSAVE>,
 PAD_SV X<PAD_SV>, PAD_SVl X<PAD_SVl>, SAVECLEARSV X<SAVECLEARSV>,
 SAVECOMPPAD X<SAVECOMPPAD>, SAVEPADSV X<SAVEPADSV>
 
-=item Functions in file pp_ctl.c
-
-find_runcv X<find_runcv>
-
 =item GV Functions
 
 is_gv_magical X<is_gv_magical>, is_gv_magical_sv X<is_gv_magical_sv>
@@ -6016,7 +6050,8 @@ magic_sethint X<magic_sethint>, mg_localize X<mg_localize>
 
 =item MRO Functions
 
-mro_isa_changed_in X<mro_isa_changed_in>
+mro_get_linear_isa_c3 X<mro_get_linear_isa_c3>, mro_get_linear_isa_dfs
+X<mro_get_linear_isa_dfs>, mro_isa_changed_in X<mro_isa_changed_in>
 
 =item Pad Data Structures
 
@@ -6045,6 +6080,10 @@ djSP X<djSP>, LVRET X<LVRET>
 sv_add_arena X<sv_add_arena>, sv_clean_all X<sv_clean_all>, sv_clean_objs
 X<sv_clean_objs>, sv_free_arenas X<sv_free_arenas>
 
+=item SV-Body Allocation
+
+sv_2num X<sv_2num>
+
 =item Unicode Support
 
 find_uninit_var X<find_uninit_var>, report_uninit X<report_uninit>
@@ -6253,9 +6292,9 @@ finish, 'enter', print
 
 =item Writing a test
 
-F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
-F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base t/comp,
-t/cmd t/run t/io t/op, t/lib ext lib
+F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/mro/>,
+F<t/op/>, F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base
+t/comp, t/cmd t/run t/io t/op, t/lib ext lib
 
 =item Special Make Test Targets
 
@@ -6267,7 +6306,8 @@ check.utf8, minitest.utf16 test.utf16, test_harness, test-notty test_notty
 =item Running tests by hand
 
 -v, -torture, -re=PATTERN, -re LIST OF PATTERNS, PERL_CORE=1,
-PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST
+PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST, PERL_TEST_Net_Ping,
+PERL_TEST_NOVREXX, PERL_TEST_NUMCONVERTS
 
 =item Common problems when patching Perl source code
 
@@ -6336,28 +6376,62 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =back
 
-=head2 perltodo - Perl TO-DO List
+=head2 perlcommunity - a brief overview of the Perl community
 
 =over 4
 
 =item DESCRIPTION
 
-=item The roadmap to 5.10
-
 =over 4
 
-=item Needed for the final 5.10.0 release
+=item Where to find the community
+
+=item Mailing lists and Newsgroups
+
+=item IRC
+
+=item Websites
+
+L<http://perl.com/>, L<http://use.perl.org/>, L<http://www.perlmonks.org/>
+
+=item User Groups
+
+=item Workshops
+
+=item Hackathons
+
+=item Conventions
+
+=item Calendar of Perl Events
+
+=back
+
+=item AUTHOR
 
 =back
 
+=head2 perltodo - Perl TO-DO List
+
+=over 4
+
+=item DESCRIPTION
+
 =item Tasks that only need Perl knowledge
 
 =over 4
 
+=item Remove duplication of test setup.
+
+=item merge common code in installperl and installman
+
 =item common test code for timed bail out
 
 =item POD -E<gt> HTML conversion in the core still sucks
 
+=item merge checkpods and podchecker
+
+=item perlmodlib.PL rewrite
+
 =item Parallel testing
 
 =item Make Schwern poorer
@@ -6366,6 +6440,8 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item test B
 
+=item Deparse inlined constants
+
 =item A decent benchmark
 
 =item fix tainting bugs
@@ -6398,12 +6474,20 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item Cross-compile support
 
+=item roffitall
+
 =back
 
 =item Tasks that need a little C knowledge
 
 =over 4
 
+=item Exterminate PL_na!
+
+=item Modernize the order of directories in @INC
+
+=item -Duse32bit*
+
 =item Make it clear from -v if this is the exact official release
 
 =item Profile Perl - am I hot or not?
@@ -6414,6 +6498,10 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item Use secure CRT functions when building with VC8 on Win32
 
+=item strcat(), strcpy(), strncat(), strncpy(), sprintf(), vsprintf()
+
+=item -D_FORTIFY_SOURCE=2, -fstack-protector
+
 =back
 
 =item Tasks that need a knowledge of XS
@@ -6428,6 +6516,8 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item Unicode and glob()
 
+=item Unicode and lc/uc operators
+
 =item use less 'memory'
 
 =item Re-implement C<:unique> in a way that is actually thread-safe
@@ -6436,24 +6526,41 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item readpipe(LIST)
 
-=item strcat(), strcpy(), strncat(), strncpy(), sprintf(), vsprintf()
-
 =item Audit the code for destruction ordering assumptions
 
 =item Extend PerlIO and PerlIO::Scalar
 
 =item -C on the #! line
 
+=item Propagate const outwards from Perl_moreswitches()
+
+=item Duplicate logic in S_method_common() and
+Perl_gv_fetchmethod_autoload()
+
+=item Organize error messages
+
 =back
 
 =item Tasks that need a knowledge of the interpreter
 
 =over 4
 
+=item UTF-8 revamp
+
+=item Properly Unicode safe tokeniser and pads.
+
+=item state variable initialization in list context
+
 =item Implement $value ~~ 0 .. $range
 
+=item A does() built-in
+
+=item Tied filehandles and write() don't mix
+
 =item Attach/detach debugger from running program
 
+=item Optimize away empty destructors
+
 =item LVALUE functions for lists
 
 =item LVALUE functions in the debugger
@@ -6472,16 +6579,16 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item entersub XS vs Perl
 
-=item Self ties
+=item Self-ties
 
 =item Optimize away @_
 
-=item Properly Unicode safe tokeniser and pads.
-
 =item The yada yada yada operators
 
 =item Virtualize operating system access
 
+=item Investigate PADTMP hash pessimisation
+
 =back
 
 =item Big projects
@@ -6510,71 +6617,480 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item DESCRIPTION
 
-=item OPTIONS
+=item OPTIONS
+
+B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
+I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
+I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
+B<-w> I<option:value> or B<-w> I<option>, B<-X>, B<-L> I<language_code>,
+B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
+B<-V>
+
+=item SECURITY
+
+=item ENVIRONMENT
+
+=item AUTHOR
+
+=back
+
+=head2 perlhist - the Perl history records
+
+=over 4
+
+=item DESCRIPTION
+
+=item INTRODUCTION
+
+=item THE KEEPERS OF THE PUMPKIN
+
+=over 4
+
+=item PUMPKIN?
+
+=back
+
+=item THE RECORDS
+
+=over 4
+
+=item SELECTED RELEASE SIZES
+
+=item SELECTED PATCH SIZES
+
+=back
+
+=item THE KEEPERS OF THE RECORDS
+
+=back
+
+=head2 perldelta, perl5100delta - what is new for perl 5.10.0
+
+=over 4
+
+=item DESCRIPTION
+
+=item Core Enhancements
+
+=over 4
+
+=item The C<feature> pragma
+
+=item New B<-E> command-line switch
+
+=item Defined-or operator
+
+=item Switch and Smart Match operator
+
+=item Regular expressions
+
+Recursive Patterns, Named Capture Buffers, Possessive Quantifiers,
+Backtracking control verbs, Relative backreferences, C<\K> escape, Vertical
+and horizontal whitespace, and linebreak
+
+=item C<say()>
+
+=item Lexical C<$_>
+
+=item The C<_> prototype
+
+=item UNITCHECK blocks
+
+=item New Pragma, C<mro>
+
+=item readdir() may return a "short filename" on Windows
+
+=item readpipe() is now overridable
+
+=item Default argument for readline()
+
+=item state() variables
+
+=item Stacked filetest operators
+
+=item UNIVERSAL::DOES()
+
+=item Formats
+
+=item Byte-order modifiers for pack() and unpack()
+
+=item C<no VERSION>
+
+=item C<chdir>, C<chmod> and C<chown> on filehandles
+
+=item OS groups
+
+=item Recursive sort subs
+
+=item Exceptions in constant folding
+
+=item Source filters in @INC
+
+=item New internal variables
+
+C<${^RE_DEBUG_FLAGS}>, C<${^CHILD_ERROR_NATIVE}>, C<${^RE_TRIE_MAXBUF}>,
+C<${^WIN32_SLOPPY_STAT}>
+
+=item Miscellaneous
+
+=item UCD 5.0.0
+
+=item MAD
+
+=item kill() on Windows
+
+=back
+
+=item Incompatible Changes
+
+=over 4
+
+=item Packing and UTF-8 strings
+
+=item Byte/character count feature in unpack()
+
+=item The C<$*> and C<$#> variables have been removed
+
+=item substr() lvalues are no longer fixed-length
+
+=item Parsing of C<-f _>
+
+=item C<:unique>
+
+=item Effect of pragmas in eval
+
+=item chdir FOO
+
+=item Handling of .pmc files
+
+=item $^V is now a C<version> object instead of a v-string
+
+=item @- and @+ in patterns
+
+=item $AUTOLOAD can now be tainted
+
+=item Tainting and printf
+
+=item undef and signal handlers
+
+=item strictures and dereferencing in defined()
+
+=item C<(?p{})> has been removed
+
+=item Pseudo-hashes have been removed
+
+=item Removal of the bytecode compiler and of perlcc
+
+=item Removal of the JPL
+
+=item Recursive inheritance detected earlier
+
+=back
+
+=item Modules and Pragmata
+
+=over 4
+
+=item Upgrading individual core modules
+
+=item Pragmata Changes
+
+C<feature>, C<mro>, Scoping of the C<sort> pragma, Scoping of C<bignum>,
+C<bigint>, C<bigrat>, C<base>, C<strict> and C<warnings>, C<version>,
+C<warnings>, C<less>
+
+=item New modules
+
+=item Selected Changes to Core Modules
+
+C<Attribute::Handlers>, C<B::Lint>, C<B>, C<Thread>
+
+=back
+
+=item Utility Changes
+
+perl -d, ptar, ptardiff, shasum, corelist, h2ph and h2xs, perlivp,
+find2perl, config_data, cpanp, cpan2dist, pod2html
+
+=item New Documentation
+
+=item Performance Enhancements
+
+=over 4
+
+=item In-place sorting
+
+=item Lexical array access
+
+=item XS-assisted SWASHGET
+
+=item Constant subroutines
+
+=item C<PERL_DONT_CREATE_GVSV>
+
+=item Weak references are cheaper
+
+=item sort() enhancements
+
+=item Memory optimisations
+
+=item UTF-8 cache optimisation
+
+=item Sloppy stat on Windows
+
+=item Regular expressions optimisations
+
+Engine de-recursivised, Single char char-classes treated as literals, Trie
+optimisation of literal string alternations, Aho-Corasick start-point
+optimisation
+
+=back
+
+=item Installation and Configuration Improvements
+
+=over 4
+
+=item Configuration improvements
+
+C<-Dusesitecustomize>, Relocatable installations, strlcat() and strlcpy(),
+C<d_pseudofork> and C<d_printf_format_null>, Configure help
+
+=item Compilation improvements
+
+Parallel build, Borland's compilers support, Static build on Windows,
+ppport.h files, C++ compatibility, Support for Microsoft 64-bit compiler,
+Visual C++, Win32 builds
+
+=item Installation improvements
+
+Module auxiliary files
+
+=item New Or Improved Platforms
+
+=back
+
+=item Selected Bug Fixes
+
+strictures in regexp-eval blocks, Calling CORE::require(), Subscripts of
+slices, C<no warnings 'category'> works correctly with -w, threads
+improvements, chr() and negative values, PERL5SHELL and tainting, Using
+*FILE{IO}, Overloading and reblessing, Overloading and UTF-8, eval memory
+leaks fixed, Random device on Windows, PERLIO_DEBUG, PerlIO::scalar and
+read-only scalars, study() and UTF-8, Critical signals, @INC-hook fix,
+C<-t> switch fix, Duping UTF-8 filehandles, Localisation of hash elements
+
+=item New or Changed Diagnostics
+
+Use of uninitialized value, Deprecated use of my() in false conditional,
+!=~ should be !~, Newline in left-justified string, Too late for "-T"
+option, "%s" variable %s masks earlier declaration,
+readdir()/closedir()/etc. attempted on invalid dirhandle, Opening
+dirhandle/filehandle %s also as a file/directory, Use of -P is deprecated,
+v-string in use/require is non-portable, perl -V
+
+=item Changed Internals
+
+=over 4
+
+=item Reordering of SVt_* constants
+
+=item Elimination of SVt_PVBM
+
+=item New type SVt_BIND
+
+=item Removal of CPP symbols
+
+=item Less space is used by ops
+
+=item New parser
+
+=item Use of C<const>
+
+=item Mathoms
+
+=item C<AvFLAGS> has been removed
+
+=item C<av_*> changes
+
+=item $^H and %^H
+
+=item B:: modules inheritance changed
+
+=item Anonymous hash and array constructors
+
+=back
+
+=item Known Problems
+
+=over 4
+
+=item UTF-8 problems
+
+=back
+
+=item Platform Specific Problems
+
+=item Reporting Bugs
+
+=item SEE ALSO
+
+=back
+
+=head2 perl5110delta, perldelta - what is new for perl v5.11.0
+
+=over 4
+
+=item DESCRIPTION
+
+=item Incompatible Changes
+
+=item Core Enhancements
+
+=item Modules and Pragmata
+
+=item Utility Changes
+
+=item Documentation
+
+=item Performance Enhancements
+
+=item Installation and Configuration Improvements
+
+=item Selected Bug Fixes
+
+=item New or Changed Diagnostics
+
+=item Changed Internals
+
+=item Known Problems
+
+=over 4
+
+=item Platform Specific Problems
+
+=back
+
+=item Reporting Bugs
+
+=item SEE ALSO
+
+=back
+
+=head2 perl5100delta - what is new for perl 5.10.0
+
+=over 4
+
+=item DESCRIPTION
+
+=item Core Enhancements
+
+=over 4
+
+=item The C<feature> pragma
+
+=item New B<-E> command-line switch
+
+=item Defined-or operator
+
+=item Switch and Smart Match operator
+
+=item Regular expressions
+
+Recursive Patterns, Named Capture Buffers, Possessive Quantifiers,
+Backtracking control verbs, Relative backreferences, C<\K> escape, Vertical
+and horizontal whitespace, and linebreak
+
+=item C<say()>
+
+=item Lexical C<$_>
+
+=item The C<_> prototype
+
+=item UNITCHECK blocks
+
+=item New Pragma, C<mro>
+
+=item readdir() may return a "short filename" on Windows
+
+=item readpipe() is now overridable
+
+=item Default argument for readline()
+
+=item state() variables
+
+=item Stacked filetest operators
+
+=item UNIVERSAL::DOES()
+
+=item Formats
+
+=item Byte-order modifiers for pack() and unpack()
 
-B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
-I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
-I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
-B<-w> I<option:value> or B<-w> I<option>, B<-X>, B<-L> I<language_code>,
-B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
-B<-V>
+=item C<no VERSION>
 
-=item SECURITY
+=item C<chdir>, C<chmod> and C<chown> on filehandles
 
-=item ENVIRONMENT
+=item OS groups
 
-=item AUTHOR
+=item Recursive sort subs
 
-=back
+=item Exceptions in constant folding
 
-=head2 perlhist - the Perl history records
+=item Source filters in @INC
 
-=over 4
+=item New internal variables
 
-=item DESCRIPTION
+C<${^RE_DEBUG_FLAGS}>, C<${^CHILD_ERROR_NATIVE}>, C<${^RE_TRIE_MAXBUF}>,
+C<${^WIN32_SLOPPY_STAT}>
 
-=item INTRODUCTION
+=item Miscellaneous
 
-=item THE KEEPERS OF THE PUMPKIN
+=item UCD 5.0.0
 
-=over 4
+=item MAD
 
-=item PUMPKIN?
+=item kill() on Windows
 
 =back
 
-=item THE RECORDS
+=item Incompatible Changes
 
 =over 4
 
-=item SELECTED RELEASE SIZES
+=item Packing and UTF-8 strings
 
-=item SELECTED PATCH SIZES
+=item Byte/character count feature in unpack()
 
-=back
+=item The C<$*> and C<$#> variables have been removed
 
-=item THE KEEPERS OF THE RECORDS
+=item substr() lvalues are no longer fixed-length
 
-=back
+=item Parsing of C<-f _>
+
+=item C<:unique>
 
-=head2 perldelta - what is new for perl v5.9.5
+=item Effect of pragmas in eval
 
-=over 4
+=item chdir FOO
 
-=item DESCRIPTION
+=item Handling of .pmc files
 
-=item Incompatible Changes
+=item $^V is now a C<version> object instead of a v-string
 
-=over 4
+=item @- and @+ in patterns
+
+=item $AUTOLOAD can now be tainted
 
 =item Tainting and printf
 
 =item undef and signal handlers
 
-=item strictures and array/hash dereferencing in defined()
+=item strictures and dereferencing in defined()
 
 =item C<(?p{})> has been removed
 
+=item Pseudo-hashes have been removed
+
 =item Removal of the bytecode compiler and of perlcc
 
 =item Removal of the JPL
@@ -6583,114 +7099,156 @@ B<-V>
 
 =back
 
-=item Core Enhancements
+=item Modules and Pragmata
 
 =over 4
 
-=item Regular expressions
+=item Upgrading individual core modules
 
-Recursive Patterns, Named Capture Buffers, Possessive Quantifiers,
-Backtracking control verbs, Relative backreferences, C<\K> escape, Vertical
-and horizontal whitespace, and linebreak
+=item Pragmata Changes
 
-=item The C<_> prototype
+C<feature>, C<mro>, Scoping of the C<sort> pragma, Scoping of C<bignum>,
+C<bigint>, C<bigrat>, C<base>, C<strict> and C<warnings>, C<version>,
+C<warnings>, C<less>
 
-=item UNITCHECK blocks
+=item New modules
 
-=item readpipe() is now overridable
+=item Selected Changes to Core Modules
 
-=item default argument for readline()
+C<Attribute::Handlers>, C<B::Lint>, C<B>, C<Thread>
 
-=item UCD 5.0.0
+=back
 
-=item Smart match
+=item Utility Changes
 
-=item Implicit loading of C<feature>
+perl -d, ptar, ptardiff, shasum, corelist, h2ph and h2xs, perlivp,
+find2perl, config_data, cpanp, cpan2dist, pod2html
 
-=back
+=item New Documentation
 
-=item Modules and Pragmas
+=item Performance Enhancements
 
 =over 4
 
-=item New Pragma, C<mro>
+=item In-place sorting
 
-=item bignum, bigint, bigrat
+=item Lexical array access
 
-=item New Core Modules
+=item XS-assisted SWASHGET
 
-=item Module changes
+=item Constant subroutines
 
-C<assertions>, C<base>, C<strict> and C<warnings>, C<warnings>, C<less>,
-C<Attribute::Handlers>, C<B::Lint>, C<B>, C<Thread>
+=item C<PERL_DONT_CREATE_GVSV>
 
-=back
+=item Weak references are cheaper
 
-=item Utility Changes
+=item sort() enhancements
 
-=over 4
+=item Memory optimisations
 
-=item C<cpanp>
+=item UTF-8 cache optimisation
 
-=item C<cpan2dist>
+=item Sloppy stat on Windows
 
-=item C<pod2html>
+=item Regular expressions optimisations
+
+Engine de-recursivised, Single char char-classes treated as literals, Trie
+optimisation of literal string alternations, Aho-Corasick start-point
+optimisation
 
 =back
 
-=item Documentation
+=item Installation and Configuration Improvements
 
 =over 4
 
-=item New manpage, perlunifaq
+=item Configuration improvements
+
+C<-Dusesitecustomize>, Relocatable installations, strlcat() and strlcpy(),
+C<d_pseudofork> and C<d_printf_format_null>, Configure help
+
+=item Compilation improvements
+
+Parallel build, Borland's compilers support, Static build on Windows,
+ppport.h files, C++ compatibility, Support for Microsoft 64-bit compiler,
+Visual C++, Win32 builds
+
+=item Installation improvements
+
+Module auxiliary files
+
+=item New Or Improved Platforms
 
 =back
 
-=item Performance Enhancements
+=item Selected Bug Fixes
 
-=item Installation and Configuration Improvements
+strictures in regexp-eval blocks, Calling CORE::require(), Subscripts of
+slices, C<no warnings 'category'> works correctly with -w, threads
+improvements, chr() and negative values, PERL5SHELL and tainting, Using
+*FILE{IO}, Overloading and reblessing, Overloading and UTF-8, eval memory
+leaks fixed, Random device on Windows, PERLIO_DEBUG, PerlIO::scalar and
+read-only scalars, study() and UTF-8, Critical signals, @INC-hook fix,
+C<-t> switch fix, Duping UTF-8 filehandles, Localisation of hash elements
+
+=item New or Changed Diagnostics
+
+Use of uninitialized value, Deprecated use of my() in false conditional,
+!=~ should be !~, Newline in left-justified string, Too late for "-T"
+option, "%s" variable %s masks earlier declaration,
+readdir()/closedir()/etc. attempted on invalid dirhandle, Opening
+dirhandle/filehandle %s also as a file/directory, Use of -P is deprecated,
+v-string in use/require is non-portable, perl -V
+
+=item Changed Internals
 
 =over 4
 
-=item C++ compatibility
+=item Reordering of SVt_* constants
 
-=item Visual C++
+=item Elimination of SVt_PVBM
 
-=item Static build on Win32
+=item New type SVt_BIND
 
-=item C<d_pseudofork>
+=item Removal of CPP symbols
 
-=item Ports
+=item Less space is used by ops
 
-=back
+=item New parser
 
-=item Selected Bug Fixes
+=item Use of C<const>
 
-=item New or Changed Diagnostics
+=item Mathoms
 
-=over 4
+=item C<AvFLAGS> has been removed
 
-=item Deprecations
+=item C<av_*> changes
 
-=back
+=item $^H and %^H
 
-=item Changed Internals
+=item B:: modules inheritance changed
+
+=item Anonymous hash and array constructors
+
+=back
 
 =item Known Problems
 
 =over 4
 
-=item Platform Specific Problems
+=item UTF-8 problems
 
 =back
 
+=item Platform Specific Problems
+
 =item Reporting Bugs
 
 =item SEE ALSO
 
 =back
 
-=head2 perl595delta, perldelta - what is new for perl v5.9.5
+=head2 perl595delta - what is new for perl v5.9.5
 
 =over 4
 
@@ -6708,6 +7266,8 @@ C<Attribute::Handlers>, C<B::Lint>, C<B>, C<Thread>
 
 =item C<(?p{})> has been removed
 
+=item Pseudo-hashes have been removed
+
 =item Removal of the bytecode compiler and of perlcc
 
 =item Removal of the JPL
@@ -6750,6 +7310,12 @@ and horizontal whitespace, and linebreak
 
 =item bignum, bigint, bigrat
 
+=item Math::BigInt/Math::BigFloat
+
+config(), import(), roundmode common, bpi(), bcos(), bsin(), batan(),
+batan2(), bmuladd(), bexp(), bnok(), from_hex(), from_oct(), and
+from_bin(), as_oct()
+
 =item New Core Modules
 
 =item Module changes
@@ -6791,7 +7357,13 @@ C<Attribute::Handlers>, C<B::Lint>, C<B>, C<Thread>
 
 =item Static build on Win32
 
-=item C<d_pseudofork>
+=item win32 builds
+
+=item C<d_pseudofork> and C<d_printf_format_null>
+
+=item Help
+
+=item 64bit systems
 
 =item Ports
 
@@ -6823,7 +7395,7 @@ C<Attribute::Handlers>, C<B::Lint>, C<B>, C<Thread>
 
 =back
 
-=head2 perl594delta, perldelta - what is new for perl v5.9.4
+=head2 perl594delta - what is new for perl v5.9.4
 
 =over 4
 
@@ -6955,7 +7527,7 @@ State variable %s will be reinitialized
 
 =back
 
-=head2 perl593delta, perldelta - what is new for perl v5.9.3
+=head2 perl593delta - what is new for perl v5.9.3
 
 =over 4
 
@@ -7126,7 +7698,7 @@ pattern
 
 =back
 
-=head2 perl592delta, perldelta - what is new for perl v5.9.2
+=head2 perl592delta - what is new for perl v5.9.2
 
 =over 4
 
@@ -7200,7 +7772,7 @@ B::Concise, Socket, Sys::Syslog, threads
 
 =back
 
-=head2 perl591delta, perldelta - what is new for perl v5.9.1
+=head2 perl591delta - what is new for perl v5.9.1
 
 =over 4
 
@@ -7286,7 +7858,7 @@ Benchmark, Carp, Exporter, FindBin, List::Util, threads::shared
 
 =back
 
-=head2 perl590delta, perldelta - what is new for perl v5.9.0
+=head2 perl590delta - what is new for perl v5.9.0
 
 =over 4
 
@@ -7447,7 +8019,7 @@ Win32::GetOSVersion
 
 =back
 
-=head2 perl588delta, perldelta - what is new for perl v5.8.8
+=head2 perl588delta - what is new for perl v5.8.8
 
 =over 4
 
@@ -7514,7 +8086,7 @@ pattern
 
 =back
 
-=head2 perl587delta, perldelta - what is new for perl v5.8.7
+=head2 perl587delta - what is new for perl v5.8.7
 
 =over 4
 
@@ -9996,8 +10568,8 @@ C<PATH>, I<nroff>, Permissions
 
 =item Optional Libraries for Perl on Cygwin
 
-C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
-C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
+C<-lcrypt>, C<-lgdbm_compat> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
+C<cygserver> (C<use IPC::SysV>), C<-lutil>
 
 =item Configure-time Options for Perl on Cygwin
 
@@ -10007,20 +10579,12 @@ C<-Dmksymlinks>
 
 =item Suspicious Warnings on Cygwin
 
-I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
+Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
 
 =back
 
 =item MAKE ON CYGWIN
 
-=over 4
-
-=item Errors on Cygwin
-
-=item ld2 on Cygwin
-
-=back
-
 =item TEST ON CYGWIN
 
 =over 4
@@ -10039,12 +10603,14 @@ I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
 
 =item Script Portability on Cygwin
 
-Pathnames, Text/Binary, PerlIO, F<.exe>, cygwin vs. windows process ids,
-C<chown()>, Miscellaneous
+Pathnames, Text/Binary, PerlIO, F<.exe>, Cygwin vs. Windows process ids,
+Cygwin vs. Windows errors, C<chown()>, Miscellaneous
 
 =item Prebuilt methods:
 
-C<Cwd::cwd>, C<Cygwin::pid_to_winpid>, C<Cygwin::winpid_to_pid>
+C<Cwd::cwd>, C<Cygwin::pid_to_winpid>, C<Cygwin::winpid_to_pid>,
+C<Cygwin::win_to_posix_path>, C<Cygwin::posix_to_win_path>,
+C<Cygwin::mount_table()>, C<Cygwin::mount_flags>, C<Cygwin::is_binmount>
 
 =back
 
@@ -10053,7 +10619,7 @@ C<Cwd::cwd>, C<Cygwin::pid_to_winpid>, C<Cygwin::winpid_to_pid>
 =item MANIFEST ON CYGWIN
 
 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
-Source, Compiled Module Source, Perl Modules/Scripts
+Source, Compiled Module Source, Perl Modules/Scripts, Perl Module Tests
 
 =item BUGS ON CYGWIN
 
@@ -10246,6 +10812,8 @@ DJGPP, Pthreads
 
 =item nss_delete core dump from op/pwent or op/grent
 
+=item Miscellaneous
+
 =item AUTHOR
 
 =item DATE
@@ -11158,6 +11726,10 @@ Digital UNIX formerly known as DEC OSF/1) systems
 
 =item Syntax
 
+=item Filename Case
+
+=item Symbolic Links
+
 =item Wildcard expansion
 
 =item Pipes
@@ -11166,6 +11738,8 @@ Digital UNIX formerly known as DEC OSF/1) systems
 
 =item PERL5LIB and PERLLIB
 
+=item The Perl Forked Debugger
+
 =item PERL_VMS_EXCEPTION_DEBUG
 
 =item Command line
@@ -11248,9 +11822,9 @@ utime LIST, waitpid PID,FLAGS
 =item Setting Up Perl on Win32
 
 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Visual
-C++ 2005 Express Edition, Microsoft Visual C++ Toolkit 2003, Microsoft
-Platform SDK 64-bit Compiler, MinGW release 3 with gcc, MinGW release 1
-with gcc
+C++ 2008 Express Edition Beta 2, Microsoft Visual C++ 2005 Express Edition,
+Microsoft Visual C++ Toolkit 2003, Microsoft Platform SDK 64-bit Compiler,
+MinGW release 3 with gcc, MinGW release 1 with gcc
 
 =item Building
 
@@ -11435,8 +12009,9 @@ signal name: ..
 
 =item BUGS AND LIMITATIONS
 
-Using non-threadsafe modules, Parent-child threads, Creating threads inside
-special blocks, Unsafe signals, Perl has been built with
+Thread-safe modules, Using non-thread-safe modules, Current working
+directory, Environment variables, Parent-child threads, Creating threads
+inside special blocks, Unsafe signals, Perl has been built with
 C<PERL_OLD_SIGNALS> (see C<perl -V>), The environment variable
 C<PERL_SIGNALS> is set to C<unsafe> (see L<perlrun/"PERL_SIGNALS">), The
 module L<Perl::Unsafe::Signals> is used, Returning closures from threads,
@@ -11513,7 +12088,8 @@ FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
 
 =back
 
-=head2 base - Establish IS-A relationship with base classes at compile time
+=head2 base - Establish an ISA relationship with base classes at compile
+time
 
 =over 4
 
@@ -11523,7 +12099,7 @@ FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
 
 =item DIAGNOSTICS
 
-Base class package "%s" is empty
+Base class package "%s" is empty, Class 'Foo' tried to inherit from itself
 
 =item HISTORY
 
@@ -11558,7 +12134,7 @@ or version
 
 =item Methods
 
-inf(), NaN(), upgrade(), in_effect()
+inf(), NaN(), e, PI, bexp(), bpi(), upgrade(), in_effect()
 
 =item MATH LIBRARY
 
@@ -11600,7 +12176,7 @@ a or accuracy, p or precision, t or trace, l or lib, hex, oct, v or version
 
 =item Caveats
 
-inf(), NaN(), upgrade(), in_effect()
+inf(), NaN(), e, PI(), bexp(), bpi(), upgrade(), in_effect()
 
 =item Math Library
 
@@ -11644,7 +12220,7 @@ in_effect(), hex()/oct()
 
 =item Methods
 
-inf(), NaN(), upgrade(), in_effect()
+inf(), NaN(), e, PI, bexp(), bpi(), upgrade(), in_effect()
 
 =item MATH LIBRARY
 
@@ -11715,7 +12291,7 @@ escapes
 
 =item DESCRIPTION
 
-=item CUSTOM TRANSLATORS
+=item ALIASES
 
 =item CUSTOM ALIASES
 
@@ -11733,7 +12309,7 @@ escapes
 
 =item charnames::vianame(name)
 
-=item ALIASES
+=item CUSTOM TRANSLATORS
 
 =item ILLEGAL CHARACTERS
 
@@ -11763,9 +12339,11 @@ escapes
 
 =item TECHNICAL NOTES
 
+=item CAVEATS
+
 =item BUGS
 
-=item AUTHOR
+=item AUTHORS
 
 =item COPYRIGHT
 
@@ -11856,7 +12434,8 @@ Legend of characters above
 
 =item KNOWN PROBLEMS
 
-literals in regex that are longer than 127 bytes, EBCDIC, format
+literals in regex that are longer than 127 bytes, EBCDIC, format, Thread
+safety
 
 =over 4
 
@@ -11927,8 +12506,6 @@ upgrading for byte-strings
 
 =item The 'say' feature
 
-=item the 'err' feature
-
 =item the 'state' feature
 
 =back
@@ -11963,7 +12540,11 @@ new, phash
 
 =over 4
 
-=item subpragma access
+=item Consider this carefully
+
+=item The "access" sub-pragma
+
+=item Limitation with regard to C<_>
 
 =back
 
@@ -12105,8 +12686,6 @@ operations
 
 =back
 
-=item PERFORMANCE CONSIDERATIONS
-
 =item SEE ALSO
 
 =over 4
@@ -12611,7 +13190,9 @@ $ae->extract_path, $ae->files
 
 =item File Extensions
 
-=item Bzip2 Support
+=item Supporting Very Large Files
+
+=item Bunzip2 support of arbitrary extensions.
 
 =back
 
@@ -12819,6 +13400,8 @@ FILE, HARDLINK, SYMLINK, CHARDEV, BLOCKDEV, DIR, FIFO, SOCKET
 
 =item $Archive::Tar::error
 
+=item $Archive::Tar::INSECURE_EXTRACT_MODE
+
 =item $Archive::Tar::HAS_PERLIO
 
 =item $Archive::Tar::HAS_IO_STRING
@@ -12833,7 +13416,7 @@ Can't you lazy-load data instead?, How much memory will an X kb tar file
 need?, What do you do with unsupported filetypes in an archive?, I'm using
 WinZip, or some other non-POSIX client, and files are not being extracted
 properly!, How do I extract only files that have property X from an
-archive?, How do I access .tar.Z files?
+archive?, How do I access .tar.Z files?, How do I handle Unicode strings?
 
 =item TODO
 
@@ -13142,8 +13725,7 @@ FILL, MAX, KEYS, RITER, NAME, ARRAY, PMROOT
 
 =item B::OP Methods
 
-next, sibling, name, ppaddr, desc, targ, type, opt, static, flags, private,
-spare
+next, sibling, name, ppaddr, desc, targ, type, opt, flags, private, spare
 
 =item B::UNOP METHOD
 
@@ -13184,7 +13766,8 @@ redoop, nextop, lastop
 
 =item B::COP Methods
 
-label, stash, stashpv, file, cop_seq, arybase, line, warnings, io, hints
+label, stash, stashpv, file, cop_seq, arybase, line, warnings, io, hints,
+hints_hash
 
 =back
 
@@ -13224,7 +13807,8 @@ B<-base>I<n>, B<-bigendian>, B<-littleendian>
 
 =item Other options
 
-B<-main>, B<-nomain>, B<-nobanner>, B<-banner>, B<-banneris> => subref
+B<-src>, B<-stash="somepackage">, B<-main>, B<-nomain>, B<-nobanner>,
+B<-banner>, B<-banneris> => subref
 
 =item Option Stickiness
 
@@ -13256,9 +13840,9 @@ B<#>I<var>, B<#>I<var>I<N>, B<#>I<Var>, B<#addr>, B<#arg>, B<#class>,
 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
 B<#flags>, B<#flagval>, B<#hints>, B<#hintsval>, B<#hyphseq>, B<#label>,
 B<#lastaddr>, B<#name>, B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>,
-B<#private>, B<#privval>, B<#seq>, B<#seqnum>, B<#opt>, B<#static>,
-B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>, B<#targ>, B<#targarg>,
-B<#targarglife>, B<#typenum>
+B<#private>, B<#privval>, B<#seq>, B<#seqnum>, B<#opt>, B<#sibaddr>,
+B<#svaddr>, B<#svclass>, B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>,
+B<#typenum>
 
 =back
 
@@ -13267,7 +13851,8 @@ B<#targarglife>, B<#typenum>
 perl -MO=Concise,bar foo.pl, perl -MDigest::MD5=md5 -MO=Concise,md5 -e1,
 perl -MPOSIX -MO=Concise,_POSIX_ARG_MAX -e1, perl -MPOSIX -MO=Concise,a -e
 'print _POSIX_SAVED_IDS', perl -MPOSIX -MO=Concise,a -e 'sub
-a{_POSIX_SAVED_IDS}'
+a{_POSIX_SAVED_IDS}', perl -MB::Concise -e
+'B::Concise::compile("-exec","-src", \%B::Concise::)->()'
 
 =item Using B::Concise outside of the O framework
 
@@ -13332,7 +13917,8 @@ B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
 
 =item ambient_pragmas
 
-strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
+strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits,
+%^H
 
 =item coderef2text
 
@@ -13949,6 +14535,22 @@ FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
 
 =back
 
+=head2 CORE - Pseudo-namespace for Perl's core routines
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item OVERRIDING CORE FUNCTIONS
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
 =head2 CPAN - query, download and build perl modules from CPAN sites
 
 =over 4
@@ -13975,10 +14577,14 @@ and the C<fforce> pragma, Lockfile, Signals
 
 =item mkmyconfig
 
+=item recent ***EXPERIMENTAL COMMAND***
+
 =item recompile
 
 =item report Bundle|Distribution|Module
 
+=item smoke ***EXPERIMENTAL COMMAND***
+
 =item upgrade [Module|/Regex/]...
 
 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
@@ -14026,9 +14632,9 @@ cwd, getcwd, fastcwd, backtickcwd
 
 =item Language Specs
 
-comment [scalar], cpanconfig [hash], disabled [boolean], goto [string],
-install [hash], make [hash], match [hash], patches [array], pl [hash], test
-[hash]
+comment [scalar], cpanconfig [hash], depends [hash] *** EXPERIMENTAL
+FEATURE ***, disabled [boolean], goto [string], install [hash], make
+[hash], match [hash], patches [array], pl [hash], test [hash]
 
 =item Processing Instructions
 
@@ -14057,7 +14663,8 @@ CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
 CPAN::Bundle::readme(), CPAN::Bundle::test(),
 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
-CPAN::Distribution::author, CPAN::Distribution::clean(),
+CPAN::Distribution::author, CPAN::Distribution::pretty_id(),
+CPAN::Distribution::base_id(), CPAN::Distribution::clean(),
 CPAN::Distribution::containsmods(), CPAN::Distribution::cvs_import(),
 CPAN::Distribution::dir(), CPAN::Distribution::force($method,@args),
 CPAN::Distribution::get(), CPAN::Distribution::install(),
@@ -14135,7 +14742,7 @@ http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
 
 =item FAQ
 
-1), 2), 3), 4), 5), 6), 7), 8), 9), 10), 11), 12), 13), 14), 15)
+1), 2), 3), 4), 5), 6), 7), 8), 9), 10), 11), 12), 13), 14), 15), 16)
 
 =item COMPATIBILITY
 
@@ -14161,6 +14768,28 @@ http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
 
 =back
 
+=head2 CPAN::API::HOWTO - a recipe book for programming with CPAN.pm
+
+=over 4
+
+=item RECIPES
+
+=over 4
+
+=item What distribution contains a particular module?
+
+=item What modules does a particular distribution contain?
+
+=back
+
+=item SEE ALSO
+
+=item LICENSE
+
+=item AUTHOR
+
+=back
+
 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
 
 =over 4
@@ -14169,6 +14798,22 @@ http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
 
 =item DESCRIPTION
 
+=back
+
+auto_commit, build_cache, build_dir, build_dir_reuse,
+build_requires_install_policy, cache_metadata, check_sigs, colorize_output,
+colorize_print, colorize_warn, colorize_debug, commandnumber_in_prompt,
+ftp_passive, getcwd, histfile, histsize, inactivity_timeout, index_expire,
+inhibit_startup_message, keep_source_where, load_module_verbosity,
+makepl_arg, make_arg, make_install_arg, make_install_make_command,
+mbuildpl_arg, mbuild_arg, mbuild_install_arg, mbuild_install_build_command,
+pager, prefer_installer, prefs_dir, prerequisites_policy,
+randomize_urllist, scan_cache, shell, show_unparsable_versions,
+show_upload_date, show_zero_versions, tar_verbosity, term_is_latin,
+term_ornaments, test_report, use_sqlite, yaml_load_code, yaml_module
+
+=over 4
+
 =item LICENSE
 
 =back
@@ -14292,7 +14937,7 @@ Provide a valid C<CPANPLUS::Configure> object, No arguments
 
 =over 4
 
-=item $conf = $cb->configure_object ()
+=item $conf = $cb->configure_object;
 
 =back
 
@@ -14327,50 +14972,90 @@ verbose => BOOL] )
 
 =over 4
 
-=item $mod_obj = $cb->parse_module( module => $modname|$distname|$modobj )
-
-Text::Bastardize, Text-Bastardize, Text-Bastardize-1.06,
-AYRNIEU/Text-Bastardize, AYRNIEU/Text-Bastardize-1.06,
-AYRNIEU/Text-Bastardize-1.06.tar.gz,
-http://example.com/Text-Bastardize-1.06.tar.gz,
-file:///tmp/Text-Bastardize-1.06.tar.gz
-
-=back
+=item $mod_obj = $cb->parse_module( module =>
+$modname|$distname|$modobj|URI )
+
+Text::Bastardize, Text-Bastardize, Text-Bastardize-1.06,
+AYRNIEU/Text-Bastardize, AYRNIEU/Text-Bastardize-1.06,
+AYRNIEU/Text-Bastardize-1.06.tar.gz,
+http://example.com/Text-Bastardize-1.06.tar.gz,
+file:///tmp/Text-Bastardize-1.06.tar.gz
+
+=back
+
+=over 4
+
+=item $bool = $cb->reload_indices( [update_source => BOOL, verbose => BOOL]
+);
+
+=back
+
+=over 4
+
+=item $bool = $cb->flush(CACHE_NAME)
+
+C<methods>, C<hosts>, C<modules>, C<lib>, C<load>, C<all>
+
+=back
+
+=over 4
+
+=item @mods = $cb->installed()
+
+=back
+
+=over 4
+
+=item $bool = $cb->local_mirror([path => '/dir/to/save/to', index_files =>
+BOOL, force => BOOL, verbose => BOOL] )
+
+path, index_files, force, verbose
+
+=back
+
+=over 4
+
+=item $file = $cb->autobundle([path => OUTPUT_PATH, force => BOOL, verbose
+=> BOOL])
+
+=back
+
+=over 4
+
+=item CUSTOM MODULE SOURCES
 
 =over 4
 
-=item $bool = $cb->reload_indices( [update_source => BOOL, verbose => BOOL]
-);
+=item %files = $cb->list_custom_sources
 
 =back
 
-=over 4
+=back
 
-=item $bool = $cb->flush(CACHE_NAME)
+=over 4
 
-C<methods>, C<hosts>, C<modules>, C<lib>, C<load>, C<all>
+=item $local_index = $cb->add_custom_source( uri => URI, [verbose => BOOL]
+);
 
 =back
 
 =over 4
 
-=item @mods = $cb->installed()
+=item $local_index = $cb->remove_custom_source( uri => URI, [verbose =>
+BOOL] );
 
 =back
 
 =over 4
 
-=item $bool = $cb->local_mirror([path => '/dir/to/save/to', index_files =>
-BOOL, force => BOOL, verbose => BOOL] )
-
-path, index_files, force, verbose
+=item $bool = $cb->update_custom_source( [remote => URI] );
 
 =back
 
 =over 4
 
-=item $file = $cb->autobundle([path => OUTPUT_PATH, force => BOOL, verbose
-=> BOOL])
+=item $file = $cb->write_custom_source_index( path =>
+/path/to/package/root, [to => /path/to/index/file, verbose => BOOL] );
 
 =back
 
@@ -14570,7 +15255,7 @@ perlwrapper
 =item add_SOMETHING( ITEM => VAL, [ITEM => VAL, ITEM => VAL, ... ] );
 
 set|get_conf, set|get_program, _set|_get_build, _set|_get_source,
-_set|_get_mirror, _set|_get_dist, _set|_get_fetch, _set|_get_daemon
+_set|_get_mirror, _set|_get_fetch
 
 =back
 
@@ -14945,7 +15630,7 @@ _conf, _id, _lib, _perl5lib
 => CODEREF );
 
 install_prerequisite, send_test_report, munge_test_report,
-edit_test_report, proceed_on_test_failure
+edit_test_report, proceed_on_test_failure, munge_dist_metafile
 
 =back
 
@@ -15188,6 +15873,57 @@ uptodate, path, verbose
 
 =back
 
+=over 4
+
+=item $file = $cb->_add_custom_module_source( uri => URI, [verbose => BOOL]
+); 
+
+=back
+
+=over 4
+
+=item $index = $cb->__custom_module_source_index_file( uri => $uri );
+
+=back
+
+=over 4
+
+=item $file = $cb->_remove_custom_module_source( uri => URI, [verbose =>
+BOOL] ); 
+
+=back
+
+=over 4
+
+=item %files = $cb->__list_custom_module_sources
+
+=back
+
+=over 4
+
+=item $bool = $cb->__update_custom_module_sources( [verbose => BOOL] );
+
+=back
+
+=over 4
+
+=item $ok = $cb->__update_custom_module_source 
+
+=back
+
+=over 4
+
+=item $bool = $cb->__write_custom_module_index( path => /path/to/packages,
+[to => /path/to/index/file, verbose => BOOL] )
+
+=back
+
+=over 4
+
+=item $bool = $cb->__create_custom_module_entries( [verbose => BOOL] ) 
+
+=back
+
 =head2 CPANPLUS::Internals::Utils
 
 =over 4
@@ -15306,11 +16042,12 @@ PACKAGE_STRING );
 
 =item ACCESSORS
 
-name, module, version, path, comment, package, description, dslip, status,
-author, parent
+name, module, version, path, comment, package, description, dslip
 
 =back
 
+status, author, parent
+
 =over 4
 
 =item STATUS ACCESSORS
@@ -15830,6 +16567,20 @@ for CPANPLUS
 
 =back
 
+=head2 CPANPLUShell::Default::Plugins::CustomSource,
+CPANPLUS::Shell::Default::Plugins::CustomSource 
+
+=over 4
+
+=item SYNOPSIS
+
+    ### elaborate help text
+    CPAN Terminal> /? cs
+
+=item DESCRIPTION
+
+=back
+
 =head2 CPANPLUShell::Default::Plugins::HOWTO,
 CPANPLUS::Shell::Default::Plugins::HOWTO -- documentation on how to write
 your own plugins
@@ -16467,11 +17218,11 @@ C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
 
 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
-C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
-C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
-C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
-C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
-C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
+C<cf_email>, C<cf_time>, C<chgrp>, C<chmod>, C<chown>, C<clocktype>,
+C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>, C<cpp_stuff>,
+C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>, C<cpprun>,
+C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>, C<csh>,
+C<ctermid_r_proto>, C<ctime_r_proto>
 
 =item d
 
@@ -16703,7 +17454,7 @@ C<quadkind>, C<quadtype>
 
 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
-C<rmail>, C<run>, C<runnm>
+C<rm_try>, C<rmail>, C<run>, C<runnm>
 
 =item s
 
@@ -16819,9 +17570,7 @@ abs_path, realpath, fast_abs_path
 
 =back
 
-=head2 DB - programmatic interface to the Perl debugging API (draft,
-subject to
-change)
+=head2 DB - programmatic interface to the Perl debugging API
 
 =over 4
 
@@ -17178,6 +17927,32 @@ Dumper
 
 =back
 
+=head2 Devel::Arena - Perl extension for inspecting the core's arena
+structures
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=over 4
+
+=item EXPORT
+
+sv_stats [DONT_SHARE], shared_string_table, sizes, HEK_size STRING,
+shared_string_table_effectiveness, write_stats_at_END
+
+=back
+
+=item SEE ALSO
+
+=item AUTHOR
+
+=item COPYRIGHT AND LICENSE
+
+=back
+
 =head2 Devel::DProf - a Perl code profiler
 
 =over 4
@@ -17337,6 +18112,59 @@ perl 5.6.1, perl 5.6.0, perl 5.005_03, perl 5.005, perl 5.004_05, perl
 
 =back
 
+=head2 Devel::Size - Perl extension for finding the memory usage of Perl
+variables
+
+=over 4
+
+=item SYNOPSIS
+
+=item DESCRIPTION
+
+=item FUNCTIONS
+
+=over 4
+
+=item size($ref)
+
+=item total_size($ref)
+
+=back
+
+=item EXPORT
+
+=item UNDERSTANDING MEMORY ALLOCATION
+
+=over 4
+
+=item The C library
+
+=item Perl
+
+=back
+
+=item DANGERS
+
+=item Messages: texts originating from this module.
+
+=over 4
+
+=item Errors
+
+=item warnings
+
+=back
+
+=item BUGS
+
+=item AUTHOR
+
+=item COPYRIGHT
+
+=item SEE ALSO
+
+=back
+
 =head2 Digest - Modules that calculate message digests
 
 =over 4
@@ -17395,7 +18223,7 @@ $md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest
 
 =over 4
 
-=item SYNOPSIS (SHA)
+=item SYNOPSIS
 
 =item SYNOPSIS (HMAC-SHA)
 
@@ -18389,7 +19217,8 @@ Legend of characters above
 
 =item KNOWN PROBLEMS
 
-literals in regex that are longer than 127 bytes, EBCDIC, format
+literals in regex that are longer than 127 bytes, EBCDIC, format, Thread
+safety
 
 =over 4
 
@@ -18517,6 +19346,22 @@ C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
 
 =back
 
+=item Good Practices
+
+=over 4
+
+=item Declaring C<@EXPORT_OK> and Friends
+
+=item Playing Safe
+
+=item What not to Export
+
+=back
+
+=item SEE ALSO
+
+=item LICENSE
+
 =back
 
 =head2 Exporter::Heavy - Exporter guts
@@ -19277,8 +20122,6 @@ maybe_command
 
 needs_linking (o)
 
-nicetext
-
 parse_abstract
 
 parse_version
@@ -19446,7 +20289,7 @@ perldepend (override)
 
 makeaperl (override)
 
-nicetext (override)
+maketext_filter (override)
 
 prefixify (override)
 
@@ -19715,7 +20558,8 @@ MakeMaker
 
 How do I install a module into my home directory?, How do I get MakeMaker
 and Module::Build to install to the same place?, How do I keep from
-installing man pages?, How do I use a module without installing it?
+installing man pages?, How do I use a module without installing it?, PREFIX
+vs INSTALL_BASE from Module::Build::Cookbook
 
 =item Philosophy and History
 
@@ -20001,7 +20845,7 @@ C<fileparse_set_fstype> X<filesystem>
 
 =back
 
-=head2 File::CheckTree, validate - run many filetest checks on a tree
+=head2 File::CheckTree - run many filetest checks on a tree
 
 =over 4
 
@@ -20080,7 +20924,8 @@ rmscopy($from,$to[,$date_flag]) X<rmscopy>
 
 =item ACCESSORS
 
-$ff->uri, $ff->scheme, $ff->host, $ff->path, $ff->file
+$ff->uri, $ff->scheme, $ff->host, $ff->vol, $ff->share, $ff->path,
+$ff->file
 
 =back
 
@@ -20156,7 +21001,9 @@ characters in them. What do I do?
 
 Implement $PREFER_BIN
 
-=item AUTHORS
+=item BUG REPORTS
+
+=item AUTHOR
 
 =item COPYRIGHT
 
@@ -20296,7 +21143,7 @@ B<~>, B<~user>, B<.>, B<*>, B<?>, B<\>,  B<[]>,  B<{,}>,  B<()>
 
 =item FUNCTIONS
 
-mode, verbose, error, verbose, skip_others, keep_root, result, error
+mode, verbose, error, verbose, safe, keep_root, result, error
 
 =item TRADITIONAL INTERFACE
 
@@ -20308,10 +21155,27 @@ mode, verbose, error, verbose, skip_others, keep_root, result, error
 
 =item DIAGNOSTICS
 
+mkdir [path]: [errmsg] (SEVERE), No root path(s) specified, No such file or
+directory, cannot fetch initial working directory: [errmsg], cannot stat
+initial working directory: [errmsg], cannot chdir to [dir]: [errmsg],
+directory [dir] changed before chdir, expected dev=[n] inode=[n], actual
+dev=[n] ino=[n], aborting. (FATAL), cannot make directory [dir]
+read+writeable: [errmsg], cannot read [dir]: [errmsg], cannot reset chmod
+[dir]: [errmsg], cannot chdir to [parent-dir] from [child-dir]: [errmsg],
+aborting. (FATAL), cannot stat prior working directory [dir]: [errmsg],
+aborting. (FATAL), previous directory [parent-dir] changed before entering
+[child-dir], expected dev=[n] inode=[n], actual dev=[n] ino=[n], aborting.
+(FATAL), cannot make directory [dir] writeable: [errmsg], cannot remove
+directory [dir]: [errmsg], cannot restore permissions of [dir] to [0nnn]:
+[errmsg], cannot make file [file] writeable: [errmsg], cannot unlink file
+[file]: [errmsg], cannot restore permissions of [file] to [0nnn]: [errmsg]
+
 =item SEE ALSO
 
 =item BUGS
 
+=item ACKNOWLEDGEMENTS
+
 =item AUTHORS
 
 =item COPYRIGHT
@@ -20361,6 +21225,8 @@ file_name_is_absolute
 
 tmpdir (override)
 
+case_tolerant
+
 =over 4
 
 =item COPYRIGHT
@@ -20596,6 +21462,10 @@ devnull
 
 tmpdir
 
+case_tolerant
+
+file_name_is_absolute
+
 catfile
 
 canonpath
@@ -21065,7 +21935,7 @@ B<lock_hash_recurse>, B<unlock_hash_recurse>
 
 B<hash_unlocked>
 
-b<legal_keys>, B<hidden_keys>, B<all_keys>, B<hash_seed>
+B<legal_keys>, B<hidden_keys>, B<all_keys>, B<hash_seed>
 
 B<hv_store>
 
@@ -21247,7 +22117,7 @@ B<lock_hash_recurse>, B<unlock_hash_recurse>
 
 B<hash_unlocked>
 
-b<legal_keys>, B<hidden_keys>, B<all_keys>, B<hash_seed>
+B<legal_keys>, B<hidden_keys>, B<all_keys>, B<hash_seed>
 
 B<hv_store>
 
@@ -24512,10 +25382,12 @@ Whitespace, IO Redirect
 
 =item See Also
 
-=item AUTHOR
-
 =item ACKNOWLEDGEMENTS
 
+=item BUG REPORTS
+
+=item AUTHOR
+
 =item COPYRIGHT
 
 =back
@@ -25267,6 +26139,14 @@ ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
 
 =item bpi()
 
+=item bcos()
+
+=item bsin()
+
+=item batan2()
+
+=item batan()
+
 =item bmuladd()
 
 =back
@@ -25391,6 +26271,14 @@ Input, Output
 
 =item bpi()
 
+=item bcos()
+
+=item bsin()
+
+=item batan2()
+
+=item batan()
+
 =item blsft()
 
 =item brsft()
@@ -25405,6 +26293,8 @@ Input, Output
 
 =item bsqrt()
 
+=item broot()
+
 =item bfac()
 
 =item round()
@@ -25516,11 +26406,6 @@ bsqrt(), div(), blog(), bexp()
 
 =item EXPORTS
 
-=item BUGS
-
-broot() does not work, Out of Memory!, Fails to load Calc on Perl prior
-5.6.0
-
 =item CAVEATS
 
 bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling,
@@ -25666,8 +26551,6 @@ the same terms as Perl itself.
 
 =item bfac()
 
-=item blog()
-
 =item bround()/round()/bfround()
 
 =item bmod()
@@ -25714,6 +26597,10 @@ the same terms as Perl itself.
 
 =item bpow()
 
+=item bexp()
+
+=item bnok()
+
 =item config()
 
 =back
@@ -26035,8 +26922,8 @@ build_requires, create_packlist, c_source, conflicts, create_makefile_pl,
 create_readme, dist_abstract, dist_author, dist_name, dist_version,
 dist_version_from, dynamic_config, extra_compiler_flags,
 extra_linker_flags, get_options, type, store, default, include_dirs,
-install_path, installdirs, license, apache, artistic, bsd, gpl, lgpl, mit,
-mozilla, open_source, perl, restrictive, unrestricted, meta_add,
+install_path, installdirs, license, apache, artistic, artistic_2, bsd, gpl,
+lgpl, mit, mozilla, open_source, perl, restrictive, unrestricted, meta_add,
 meta_merge, module_name, PL_files, pm_files, pod_files, recommends,
 recursive_test_files, requires, script_files, sign, test_files, xs_files,
 new_from_context(%args), resume(), subclass()
@@ -26070,18 +26957,22 @@ up_to_date($source_file, $derived_file), up_to_date(\@source_files,
 
 PL_files(), allow_mb_mismatch(), autosplit(), base_dir(), bindoc_dirs(),
 blib(), build_bat(), build_class(), build_elements(), build_requires(),
-build_script(), c_source(), config_dir(), conflicts(),
-create_makefile_pl(), create_packlist(), create_readme(), debugger(),
-destdir(), get_options(), html_css(), include_dirs(), install_base(),
-install_sets(), installdirs(), libdoc_dirs(), license(), magic_number(),
-mb_version(), meta_add(), meta_merge(), metafile(), module_name(),
-orig_dir(), original_prefix(), perl(), pm_files(), pod_files(), pollute(),
-prefix(), prereq_action_types(), quiet(), recommends(), recurse_into(),
-recursive_test_files(), requires(), scripts(), use_rcfile(), verbose(),
-xs_files()
+build_script(), c_source(), config_dir(), configure_requires(),
+conflicts(), create_makefile_pl(), create_packlist(), create_readme(),
+debugger(), destdir(), get_options(), html_css(), include_dirs(),
+install_base(), install_sets(), installdirs(), libdoc_dirs(), license(),
+magic_number(), mb_version(), meta_add(), meta_merge(), metafile(),
+module_name(), orig_dir(), original_prefix(), perl(), pm_files(),
+pod_files(), pollute(), prefix(), prereq_action_types(), quiet(),
+recommends(), recurse_into(), recursive_test_files(), requires(),
+scripts(), use_rcfile(), verbose(), xs_files()
 
 =back
 
+=item MODULE METADATA
+
+keywords, resources
+
 =item AUTHOR
 
 =item COPYRIGHT
@@ -26104,8 +26995,14 @@ xs_files()
 
 =over 4
 
+=item Types of prerequisites
+
+configure_requires, build_requires, requires, recommends, conflicts
+
 =item Format of prerequisites
 
+=item XS Extensions
+
 =back
 
 =item SAVING CONFIGURATION INFORMATION
@@ -26189,9 +27086,9 @@ auto_feature_names(), write()
 
 =over 4
 
-=item The basic installation recipe for modules that use Module::Build
+=item Installing modules that use Module::Build
 
-=item Making a CPAN.pm-compatible distribution
+=item Modifying Config.pm values
 
 =item Installing modules using the programmatic interface
 
@@ -26209,6 +27106,8 @@ auto_feature_names(), write()
 
 =over 4
 
+=item Making a CPAN.pm-compatible distribution
+
 =item Changing the order of the build process
 
 =item Adding new file types to the build process
@@ -26424,6 +27323,16 @@ _infer_xs_spec
 
 rscan_dir
 
+dist_dir
+
+man3page_name
+
+expand_test_dir
+
+_detildefy
+
+find_perl_interpreter
+
 =over 4
 
 =item AUTHOR
@@ -26553,6 +27462,10 @@ Module::Build works even if YAML.pm is not installed
 
 =item Caveats
 
+=item ACKNOWLEDGEMENTS
+
+=item BUG REPORTS
+
 =item AUTHOR
 
 =item COPYRIGHT
@@ -26612,6 +27525,8 @@ modules, verbose, nocache
 
 =item See Also
 
+=item BUG REPORTS
+
 =item AUTHOR
 
 =item COPYRIGHT
@@ -26875,11 +27790,11 @@ RECURSE ]), mkdir ( DIR [, RECURSE ]), alloc ( SIZE [, RECORD_SIZE] ), ls (
 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 ()
+BYTES_PER_HASH_MARK] ), feature ( NAME ), 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
 
@@ -27008,8 +27923,8 @@ 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
-[, $timeout]);
+[ $host ] );, $p->nack( $failed_ack_host );, $p->close();,
+$p->port_number([$port_number]), pingecho($host [, $timeout]);
 
 =back
 
@@ -27468,8 +28383,8 @@ opdump (PAT)
 
 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
-:filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
-:dangerous
+:filesys_write, :subprocess, :ownprocess, :others, :load,
+:still_to_be_decided, :dangerous
 
 =item SEE ALSO
 
@@ -30039,6 +30954,8 @@ B<setlogmask($mask_priority)>, B<setlogsock($sock_type)>,
 B<setlogsock($sock_type, $stream_location)> (added in Perl 5.004_02),
 B<Note>, B<closelog()>
 
+=item THE RULES OF SYS::SYSLOG
+
 =item EXAMPLES
 
 =item CONSTANTS
@@ -30053,18 +30970,31 @@ B<Note>, B<closelog()>
 
 =item DIAGNOSTICS
 
-Invalid argument passed to setlogsock, no connection to syslog available,
-stream passed to setlogsock, but %s is not writable, stream passed to
-setlogsock, but could not find any device, tcp passed to setlogsock, but
-tcp service unavailable, syslog: expecting argument %s, syslog: invalid
-level/facility: %s, syslog: too many levels given: %s, syslog: too many
-facilities given: %s, syslog: level must be given, udp passed to
-setlogsock, but udp service unavailable, unix passed to setlogsock, but
-path not available
+C<Invalid argument passed to setlogsock>, C<eventlog passed to setlogsock,
+but no Win32 API available>, C<no connection to syslog available>, C<stream
+passed to setlogsock, but %s is not writable>, C<stream passed to
+setlogsock, but could not find any device>, C<tcp passed to setlogsock, but
+tcp service unavailable>, C<syslog: expecting argument %s>, C<syslog:
+invalid level/facility: %s>, C<syslog: too many levels given: %s>,
+C<syslog: too many facilities given: %s>, C<syslog: level must be given>,
+C<udp passed to setlogsock, but udp service unavailable>, C<unix passed to
+setlogsock, but path not available>
 
 =item SEE ALSO
 
-=item AUTHORS
+=over 4
+
+=item Manual Pages
+
+=item RFCs
+
+=item Articles
+
+=item Event Log
+
+=back
+
+=item AUTHORS & ACKNOWLEDGEMENTS
 
 =item BUGS
 
@@ -30073,6 +31003,8 @@ path not available
 AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request
 tracker, Search CPAN, Kobes' CPAN Search, Perl Documentation
 
+=item COPYRIGHT
+
 =item LICENSE
 
 =back
@@ -30098,6 +31030,8 @@ B<setlogmask($mask_priority)>, B<setlogsock($sock_type)>,
 B<setlogsock($sock_type, $stream_location)> (added in Perl 5.004_02),
 B<Note>, B<closelog()>
 
+=item THE RULES OF SYS::SYSLOG
+
 =item EXAMPLES
 
 =item CONSTANTS
@@ -30112,18 +31046,31 @@ B<Note>, B<closelog()>
 
 =item DIAGNOSTICS
 
-Invalid argument passed to setlogsock, no connection to syslog available,
-stream passed to setlogsock, but %s is not writable, stream passed to
-setlogsock, but could not find any device, tcp passed to setlogsock, but
-tcp service unavailable, syslog: expecting argument %s, syslog: invalid
-level/facility: %s, syslog: too many levels given: %s, syslog: too many
-facilities given: %s, syslog: level must be given, udp passed to
-setlogsock, but udp service unavailable, unix passed to setlogsock, but
-path not available
+C<Invalid argument passed to setlogsock>, C<eventlog passed to setlogsock,
+but no Win32 API available>, C<no connection to syslog available>, C<stream
+passed to setlogsock, but %s is not writable>, C<stream passed to
+setlogsock, but could not find any device>, C<tcp passed to setlogsock, but
+tcp service unavailable>, C<syslog: expecting argument %s>, C<syslog:
+invalid level/facility: %s>, C<syslog: too many levels given: %s>,
+C<syslog: too many facilities given: %s>, C<syslog: level must be given>,
+C<udp passed to setlogsock, but udp service unavailable>, C<unix passed to
+setlogsock, but path not available>
 
 =item SEE ALSO
 
-=item AUTHORS
+=over 4
+
+=item Manual Pages
+
+=item RFCs
+
+=item Articles
+
+=item Event Log
+
+=back
+
+=item AUTHORS & ACKNOWLEDGEMENTS
 
 =item BUGS
 
@@ -30132,6 +31079,23 @@ path not available
 AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request
 tracker, Search CPAN, Kobes' CPAN Search, Perl Documentation
 
+=item COPYRIGHT
+
+=item LICENSE
+
+=back
+
+=head2 Syslog::win32::Win32, Sys::Syslog::Win32 - Win32 support for
+Sys::Syslog
+
+=over 4
+
+=item DESCRIPTION
+
+=item SEE ALSO
+
+=item AUTHORS
+
 =item LICENSE
 
 =back
@@ -30325,13 +31289,15 @@ record", allow => $ref] );
 
 =item See Also
 
+=item BUG REPORTS
+
 =item AUTHOR
 
 =item COPYRIGHT
 
 =back
 
-=head2 Term::UI::History, Log::Message::Simple
+=head2 Term::UI::History
 
 =over 4
 
@@ -31305,8 +32271,7 @@ arrays
 
 =back
 
-=head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
-by Knuth
+=head2 Text::Soundex - Implementation of the soundex algorithm.
 
 =over 4
 
@@ -31502,8 +32467,7 @@ SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
 
 =back
 
-=head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
-handles
+=head2 Tie::Handle - base class definitions for tied handles
 
 =over 4
 
@@ -31681,6 +32645,10 @@ $flags = 0), clock(), stat, stat FH, stat EXPR
 
 =over 4
 
+=item C<timelocal()> and C<timegm()>
+
+=item C<timelocal_nocheck()> and C<timegm_nocheck()>
+
 =item Year Value Interpretation
 
 =item Limits of time_t
@@ -31699,6 +32667,8 @@ $flags = 0), clock(), stat, stat FH, stat EXPR
 
 =item SUPPORT
 
+=item COPYRIGHT
+
 =item AUTHOR
 
 =back
@@ -32286,6 +33256,8 @@ C<":SEM_">, C<":PARTITION_">, C<":ALL">
 
 =back
 
+=head2 Win32CORE - Win32 CORE function stubs
+
 =over 4
 
 =item DESCRIPTION