This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Fix listing of MIME::QuotedPrint in perlmodlib
[perl5.git] / pod / perltoc.pod
index a787b97..2d63290 100644 (file)
@@ -885,7 +885,7 @@ Interaction, perlfaq9 - Networking
 
 =back
 
-=head2 perlfaq1 - General Questions About Perl ($Revision: 9671 $)
+=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: 9462 $)
+=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
 
@@ -1077,7 +1077,7 @@ program; what am I doing wrong?
 
 =back
 
-=head2 perlfaq4 - Data Manipulation ($Revision: 9491 $)
+=head2 perlfaq4 - Data Manipulation
 
 =over 4
 
@@ -1296,7 +1296,7 @@ array of hashes or arrays?
 
 =back
 
-=head2 perlfaq5 - Files and Formats ($Revision: 9576 $)
+=head2 perlfaq5 - Files and Formats
 
 =over 4
 
@@ -1430,7 +1430,7 @@ X<file, selecting a random line>
 
 =back
 
-=head2 perlfaq6 - Regular Expressions ($Revision: 8539 $)
+=head2 perlfaq6 - Regular Expressions
 
 =over 4
 
@@ -1527,7 +1527,7 @@ X<\E, regex>, X<qr//>
 
 =back
 
-=head2 perlfaq7 - General Perl Language Issues ($Revision: 9620 $)
+=head2 perlfaq7 - General Perl Language Issues
 
 =over 4
 
@@ -1610,7 +1610,7 @@ methods?
 
 =back
 
-=head2 perlfaq8 - System Interaction ($Revision: 9667 $)
+=head2 perlfaq8 - System Interaction
 
 =over 4
 
@@ -1744,7 +1744,7 @@ perl -Idir command line flag, the use lib pragma:
 
 =back
 
-=head2 perlfaq9 - Networking ($Revision: 8539 $)
+=head2 perlfaq9 - Networking
 
 =over 4
 
@@ -2001,10 +2001,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<*>
@@ -2153,7 +2152,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> 
@@ -2605,7 +2604,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
 
@@ -2635,6 +2634,8 @@ X<SYS$LOGIN>
 
 =item DESCRIPTION
 
+=item SEE ALSO
+
 =back
 
 =head2 perllexwarn - Perl Lexical Warnings
@@ -2666,8 +2667,6 @@ X<warning, reporting> X<warning, registering>
 
 =back
 
-=item TODO
-
 =item SEE ALSO
 
 =item AUTHOR
@@ -2684,6 +2683,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>,
@@ -2865,7 +2869,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
 
@@ -4265,31 +4269,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,
@@ -4353,18 +4358,18 @@ 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,
+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
 
@@ -4769,9 +4774,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
 
@@ -5526,7 +5532,7 @@ 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_PMf_LOCALE, RXf_UTF8, RXf_SPLIT, RXf_SKIPWHITE, RXf_START_ONLY,
-RXf_WHITE
+RXf_WHITE, RXf_NULL
 
 =item exec
 
@@ -5786,15 +5792,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
 
@@ -6021,7 +6026,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
 
@@ -6050,6 +6056,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>
@@ -6385,10 +6395,14 @@ L<http://perl.com/>, L<http://use.perl.org/>, L<http://www.perlmonks.org/>
 
 =over 4
 
+=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 Parallel testing
 
 =item Make Schwern poorer
@@ -6397,6 +6411,8 @@ L<http://perl.com/>, L<http://use.perl.org/>, L<http://www.perlmonks.org/>
 
 =item test B
 
+=item Deparse inlined constants
+
 =item A decent benchmark
 
 =item fix tainting bugs
@@ -6429,12 +6445,18 @@ L<http://perl.com/>, L<http://use.perl.org/>, L<http://www.perlmonks.org/>
 
 =item Cross-compile support
 
+=item roffitall
+
 =back
 
 =item Tasks that need a little C knowledge
 
 =over 4
 
+=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?
@@ -6445,6 +6467,8 @@ L<http://perl.com/>, L<http://use.perl.org/>, L<http://www.perlmonks.org/>
 
 =item Use secure CRT functions when building with VC8 on Win32
 
+=item __FUNCTION__ for MSVC-pre-7.0
+
 =back
 
 =item Tasks that need a knowledge of XS
@@ -6459,6 +6483,8 @@ L<http://perl.com/>, L<http://use.perl.org/>, L<http://www.perlmonks.org/>
 
 =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
@@ -6475,16 +6501,26 @@ L<http://perl.com/>, L<http://use.perl.org/>, L<http://www.perlmonks.org/>
 
 =item -C on the #! line
 
+=item Propagate const outwards from Perl_moreswitches()
+
 =back
 
 =item Tasks that need a knowledge of the interpreter
 
 =over 4
 
+=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
@@ -6513,6 +6549,8 @@ L<http://perl.com/>, L<http://use.perl.org/>, L<http://www.perlmonks.org/>
 
 =item Virtualize operating system access
 
+=item Investigate PADTMP hash pessimisation
+
 =back
 
 =item Big projects
@@ -6588,24 +6626,115 @@ B<-V>
 
 =back
 
-=head2 perldelta - what is new for perl v5.9.5
+=head2 perldelta - 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 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
+
+=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 @- 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
@@ -6614,107 +6743,399 @@ B<-V>
 
 =back
 
+=item Modules and Pragmata
+
+=over 4
+
+=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, Building XS extensions on Windows,
+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
+
+=item Platform Specific Problems
+
+=item Reporting Bugs
+
+=item SEE ALSO
+
+=back
+
+=head2 perl5100delta, perldelta - 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 readpipe() is now overridable
 
-=item default argument for readline()
+=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 Smart match
+=item MAD
 
-=item Implicit loading of C<feature>
+=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 @- 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 Pragmas
+=item Modules and Pragmata
 
 =over 4
 
-=item New Pragma, C<mro>
+=item Pragmata Changes
 
-=item bignum, bigint, bigrat
+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 Core Modules
+=item New modules
 
-=item Module changes
+=item Selected Changes to Core Modules
 
-C<assertions>, C<base>, C<strict> and C<warnings>, C<warnings>, C<less>,
 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 C<cpanp>
+=item In-place sorting
 
-=item C<cpan2dist>
+=item Lexical array access
 
-=item C<pod2html>
+=item XS-assisted SWASHGET
 
-=back
+=item Constant subroutines
 
-=item Documentation
+=item C<PERL_DONT_CREATE_GVSV>
 
-=over 4
+=item Weak references are cheaper
 
-=item New manpage, perlunifaq
+=item sort() enhancements
 
-=back
+=item Memory optimisations
 
-=item Performance Enhancements
+=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 C++ compatibility
+=item Configuration improvements
 
-=item Visual C++
+C<-Dusesitecustomize>, Relocatable installations, strlcat() and strlcpy(),
+C<d_pseudofork> and C<d_printf_format_null>, Configure help
 
-=item Static build on Win32
+=item Compilation improvements
 
-=item C<d_pseudofork>
+Parallel build, Borland's compilers support, Static build on Windows,
+ppport.h files, C++ compatibility, Building XS extensions on Windows,
+Support for Microsoft 64-bit compiler, Visual C++, Win32 builds
 
-=item Ports
+=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 Deprecations
+=item Reordering of SVt_* constants
 
-=back
+=item Elimination of SVt_PVBM
 
-=item Changed Internals
+=item New type SVt_BIND
 
-=item Known Problems
+=item Removal of CPP symbols
 
-=over 4
+=item Less space is used by ops
 
-=item Platform Specific Problems
+=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
+
+=item Platform Specific Problems
+
 =item Reporting Bugs
 
 =item SEE ALSO
@@ -6739,6 +7160,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
@@ -6781,6 +7204,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
@@ -6822,7 +7251,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
 
@@ -10027,8 +10462,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
 
@@ -10038,20 +10473,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
@@ -10070,12 +10497,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
 
@@ -10084,7 +10513,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
 
@@ -10277,6 +10706,8 @@ DJGPP, Pthreads
 
 =item nss_delete core dump from op/pwent or op/grent
 
+=item Miscellaneous
+
 =item AUTHOR
 
 =item DATE
@@ -11197,6 +11628,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
@@ -11279,9 +11712,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
 
@@ -11466,9 +11899,10 @@ signal name: ..
 
 =item BUGS AND LIMITATIONS
 
-Threadsafe modules, Using non-threadsafe modules, 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
+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,
 Returning objects from threads, Perl Bugs and the CPAN Version of
@@ -11747,7 +12181,7 @@ escapes
 
 =item DESCRIPTION
 
-=item CUSTOM TRANSLATORS
+=item ALIASES
 
 =item CUSTOM ALIASES
 
@@ -11765,7 +12199,7 @@ escapes
 
 =item charnames::vianame(name)
 
-=item ALIASES
+=item CUSTOM TRANSLATORS
 
 =item ILLEGAL CHARACTERS
 
@@ -11795,9 +12229,11 @@ escapes
 
 =item TECHNICAL NOTES
 
+=item CAVEATS
+
 =item BUGS
 
-=item AUTHOR
+=item AUTHORS
 
 =item COPYRIGHT
 
@@ -11888,7 +12324,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
 
@@ -11959,8 +12396,6 @@ upgrading for byte-strings
 
 =item The 'say' feature
 
-=item the 'err' feature
-
 =item the 'state' feature
 
 =back
@@ -12137,8 +12572,6 @@ operations
 
 =back
 
-=item PERFORMANCE CONSIDERATIONS
-
 =item SEE ALSO
 
 =over 4
@@ -12643,6 +13076,10 @@ $ae->extract_path, $ae->files
 
 =item File Extensions
 
+=item Supporting Very Large Files
+
+=item Bunzip2 support of arbitrary extensions.
+
 =back
 
 =item GLOBAL VARIABLES
@@ -12863,7 +13300,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
 
@@ -13213,7 +13650,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
 
@@ -13253,7 +13691,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
 
@@ -13296,7 +13735,8 @@ 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
 
@@ -13361,7 +13801,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
 
@@ -13978,6 +14419,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
@@ -14004,10 +14461,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
@@ -14055,9 +14516,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
 
@@ -14086,7 +14547,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(),
@@ -14162,31 +14624,53 @@ http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
 
 =back
 
-=item FAQ
+=item FAQ
+
+1), 2), 3), 4), 5), 6), 7), 8), 9), 10), 11), 12), 13), 14), 15), 16)
+
+=item COMPATIBILITY
+
+=over 4
+
+=item OLD PERL VERSIONS
+
+=item CPANPLUS
+
+=back
+
+=item SECURITY ADVICE
+
+=item BUGS
+
+=item AUTHOR
+
+=item LICENSE
+
+=item TRANSLATIONS
+
+=item SEE ALSO
+
+=back
+
+=head2 CPAN::API::HOWTO - a recipe book for programming with CPAN.pm
 
-1), 2), 3), 4), 5), 6), 7), 8), 9), 10), 11), 12), 13), 14), 15)
+=over 4
 
-=item COMPATIBILITY
+=item RECIPES
 
 =over 4
 
-=item OLD PERL VERSIONS
+=item What distribution contains a particular module?
 
-=item CPANPLUS
+=item What modules does a particular distribution contain?
 
 =back
 
-=item SECURITY ADVICE
-
-=item BUGS
-
-=item AUTHOR
+=item SEE ALSO
 
 =item LICENSE
 
-=item TRANSLATIONS
-
-=item SEE ALSO
+=item AUTHOR
 
 =back
 
@@ -14198,6 +14682,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
@@ -14321,7 +14821,7 @@ Provide a valid C<CPANPLUS::Configure> object, No arguments
 
 =over 4
 
-=item $conf = $cb->configure_object ()
+=item $conf = $cb->configure_object;
 
 =back
 
@@ -14356,7 +14856,8 @@ verbose => BOOL] )
 
 =over 4
 
-=item $mod_obj = $cb->parse_module( module => $modname|$distname|$modobj )
+=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,
@@ -14405,6 +14906,45 @@ path, index_files, force, verbose
 
 =over 4
 
+=item CUSTOM MODULE SOURCES
+
+=over 4
+
+=item %files = $cb->list_custom_sources
+
+=back
+
+=back
+
+=over 4
+
+=item $local_index = $cb->add_custom_source( uri => URI, [verbose => BOOL]
+);
+
+=back
+
+=over 4
+
+=item $local_index = $cb->remove_custom_source( uri => URI, [verbose =>
+BOOL] );
+
+=back
+
+=over 4
+
+=item $bool = $cb->update_custom_source( [remote => URI] );
+
+=back
+
+=over 4
+
+=item $file = $cb->write_custom_source_index( path =>
+/path/to/package/root, [to => /path/to/index/file, verbose => BOOL] );
+
+=back
+
+=over 4
+
 =item BUG REPORTS
 
 =item AUTHOR
@@ -14599,7 +15139,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
 
@@ -14974,7 +15514,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
 
@@ -15217,6 +15757,51 @@ uptodate, path, verbose
 
 =back
 
+=over 4
+
+=item $file = $cb->_add_custom_module_source( uri => URI, [verbose => BOOL]
+); 
+
+=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
@@ -15335,11 +15920,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
@@ -15859,6 +16445,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
@@ -16496,11 +17096,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
 
@@ -16732,7 +17332,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
 
@@ -16848,9 +17448,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
 
@@ -17207,6 +17805,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
@@ -17366,6 +17990,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
@@ -17424,7 +18101,7 @@ $md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest
 
 =over 4
 
-=item SYNOPSIS (SHA)
+=item SYNOPSIS
 
 =item SYNOPSIS (HMAC-SHA)
 
@@ -18418,7 +19095,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
 
@@ -20031,7 +20709,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
 
@@ -20186,7 +20864,9 @@ characters in them. What do I do?
 
 Implement $PREFER_BIN
 
-=item AUTHORS
+=item BUG REPORTS
+
+=item AUTHOR
 
 =item COPYRIGHT
 
@@ -20326,7 +21006,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
 
@@ -20338,10 +21018,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
@@ -20628,6 +21325,10 @@ devnull
 
 tmpdir
 
+case_tolerant
+
+file_name_is_absolute
+
 catfile
 
 canonpath
@@ -21097,7 +21798,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>
 
@@ -21279,7 +21980,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>
 
@@ -24544,10 +25245,12 @@ Whitespace, IO Redirect
 
 =item See Also
 
-=item AUTHOR
-
 =item ACKNOWLEDGEMENTS
 
+=item BUG REPORTS
+
+=item AUTHOR
+
 =item COPYRIGHT
 
 =back
@@ -25453,6 +26156,8 @@ Input, Output
 
 =item bsqrt()
 
+=item broot()
+
 =item bfac()
 
 =item round()
@@ -25564,11 +26269,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,
@@ -25714,8 +26414,6 @@ the same terms as Perl itself.
 
 =item bfac()
 
-=item blog()
-
 =item bround()/round()/bfround()
 
 =item bmod()
@@ -25762,6 +26460,10 @@ the same terms as Perl itself.
 
 =item bpow()
 
+=item bexp()
+
+=item bnok()
+
 =item config()
 
 =back
@@ -26083,8 +26785,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()
@@ -26118,18 +26820,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
@@ -26152,8 +26858,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
@@ -26237,9 +26949,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
 
@@ -26257,6 +26969,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
@@ -26472,6 +27186,16 @@ _infer_xs_spec
 
 rscan_dir
 
+dist_dir
+
+man3page_name
+
+expand_test_dir
+
+_detildefy
+
+find_perl_interpreter
+
 =over 4
 
 =item AUTHOR
@@ -26601,6 +27325,10 @@ Module::Build works even if YAML.pm is not installed
 
 =item Caveats
 
+=item ACKNOWLEDGEMENTS
+
+=item BUG REPORTS
+
 =item AUTHOR
 
 =item COPYRIGHT
@@ -26660,6 +27388,8 @@ modules, verbose, nocache
 
 =item See Also
 
+=item BUG REPORTS
+
 =item AUTHOR
 
 =item COPYRIGHT
@@ -27056,8 +27786,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
 
@@ -27516,8 +28246,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
 
@@ -30087,6 +30817,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
@@ -30101,18 +30833,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
 
@@ -30121,6 +30866,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
@@ -30146,6 +30893,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
@@ -30160,18 +30909,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
 
@@ -30180,6 +30942,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
@@ -30373,13 +31152,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
 
@@ -31353,8 +32134,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
 
@@ -31550,8 +32330,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
 
@@ -31729,6 +32508,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
@@ -31747,6 +32530,8 @@ $flags = 0), clock(), stat, stat FH, stat EXPR
 
 =item SUPPORT
 
+=item COPYRIGHT
+
 =item AUTHOR
 
 =back