This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Add the URL for annotated svn of S03.
[perl5.git] / pod / perltoc.pod
index 2d63290..1836d4a 100644 (file)
@@ -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?
 
@@ -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)?
 
@@ -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>
@@ -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?
@@ -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?
 
@@ -2793,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),
@@ -2822,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>
@@ -3459,6 +3466,8 @@ string
 
 =item Ignoring A Thread
 
+=item Process and Thread Termination
+
 =back
 
 =item Threads And Data
@@ -3977,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 Which version of perl should I use?
 
-=item What about the UTF8 flag?
+=item What about binary data, like images?
 
 =item When should I decode or encode?
 
@@ -3995,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
@@ -4319,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,
@@ -6268,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
 
@@ -6282,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
 
@@ -6395,6 +6420,8 @@ L<http://perl.com/>, L<http://use.perl.org/>, L<http://www.perlmonks.org/>
 
 =over 4
 
+=item Remove duplication of test setup.
+
 =item merge common code in installperl and installman
 
 =item common test code for timed bail out
@@ -6403,6 +6430,8 @@ L<http://perl.com/>, L<http://use.perl.org/>, L<http://www.perlmonks.org/>
 
 =item merge checkpods and podchecker
 
+=item perlmodlib.PL rewrite
+
 =item Parallel testing
 
 =item Make Schwern poorer
@@ -6453,6 +6482,8 @@ L<http://perl.com/>, L<http://use.perl.org/>, L<http://www.perlmonks.org/>
 
 =over 4
 
+=item Exterminate PL_na!
+
 =item Modernize the order of directories in @INC
 
 =item -Duse32bit*
@@ -6467,7 +6498,9 @@ 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
+=item strcat(), strcpy(), strncat(), strncpy(), sprintf(), vsprintf()
+
+=item -D_FORTIFY_SOURCE=2, -fstack-protector
 
 =back
 
@@ -6493,8 +6526,6 @@ L<http://perl.com/>, L<http://use.perl.org/>, L<http://www.perlmonks.org/>
 
 =item readpipe(LIST)
 
-=item strcat(), strcpy(), strncat(), strncpy(), sprintf(), vsprintf()
-
 =item Audit the code for destruction ordering assumptions
 
 =item Extend PerlIO and PerlIO::Scalar
@@ -6503,12 +6534,21 @@ L<http://perl.com/>, L<http://use.perl.org/>, L<http://www.perlmonks.org/>
 
 =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
@@ -6539,12 +6579,10 @@ L<http://perl.com/>, L<http://use.perl.org/>, L<http://www.perlmonks.org/>
 
 =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
@@ -6626,7 +6664,7 @@ B<-V>
 
 =back
 
-=head2 perldelta - what is new for perl 5.10.0
+=head2 perldelta, perl5100delta - what is new for perl 5.10.0
 
 =over 4
 
@@ -6660,6 +6698,8 @@ and horizontal whitespace, and linebreak
 
 =item New Pragma, C<mro>
 
+=item readdir() may return a "short filename" on Windows
+
 =item readpipe() is now overridable
 
 =item Default argument for readline()
@@ -6697,6 +6737,8 @@ C<${^WIN32_SLOPPY_STAT}>
 
 =item MAD
 
+=item kill() on Windows
+
 =back
 
 =item Incompatible Changes
@@ -6721,6 +6763,8 @@ C<${^WIN32_SLOPPY_STAT}>
 
 =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
@@ -6747,6 +6791,8 @@ C<${^WIN32_SLOPPY_STAT}>
 
 =over 4
 
+=item Upgrading individual core modules
+
 =item Pragmata Changes
 
 C<feature>, C<mro>, Scoping of the C<sort> pragma, Scoping of C<bignum>,
@@ -6812,8 +6858,8 @@ 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
+ppport.h files, C++ compatibility, Support for Microsoft 64-bit compiler,
+Visual C++, Win32 builds
 
 =item Installation improvements
 
@@ -6876,6 +6922,12 @@ v-string in use/require is non-portable, perl -V
 
 =item Known Problems
 
+=over 4
+
+=item UTF-8 problems
+
+=back
+
 =item Platform Specific Problems
 
 =item Reporting Bugs
@@ -6884,7 +6936,47 @@ v-string in use/require is non-portable, perl -V
 
 =back
 
-=head2 perl5100delta, perldelta - what is new for perl 5.10.0
+=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
 
@@ -6918,6 +7010,8 @@ and horizontal whitespace, and linebreak
 
 =item New Pragma, C<mro>
 
+=item readdir() may return a "short filename" on Windows
+
 =item readpipe() is now overridable
 
 =item Default argument for readline()
@@ -6955,6 +7049,8 @@ C<${^WIN32_SLOPPY_STAT}>
 
 =item MAD
 
+=item kill() on Windows
+
 =back
 
 =item Incompatible Changes
@@ -6979,6 +7075,8 @@ C<${^WIN32_SLOPPY_STAT}>
 
 =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
@@ -7005,6 +7103,8 @@ C<${^WIN32_SLOPPY_STAT}>
 
 =over 4
 
+=item Upgrading individual core modules
+
 =item Pragmata Changes
 
 C<feature>, C<mro>, Scoping of the C<sort> pragma, Scoping of C<bignum>,
@@ -7070,8 +7170,8 @@ 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
+ppport.h files, C++ compatibility, Support for Microsoft 64-bit compiler,
+Visual C++, Win32 builds
 
 =item Installation improvements
 
@@ -7134,6 +7234,12 @@ v-string in use/require is non-portable, perl -V
 
 =item Known Problems
 
+=over 4
+
+=item UTF-8 problems
+
+=back
+
 =item Platform Specific Problems
 
 =item Reporting Bugs
@@ -7142,7 +7248,7 @@ v-string in use/require is non-portable, perl -V
 
 =back
 
-=head2 perl595delta, perldelta - what is new for perl v5.9.5
+=head2 perl595delta - what is new for perl v5.9.5
 
 =over 4
 
@@ -7289,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
 
@@ -7421,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
 
@@ -7592,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
 
@@ -7666,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
 
@@ -7752,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
 
@@ -7913,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
 
@@ -7980,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
 
@@ -11620,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
@@ -12430,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
 
@@ -13286,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
@@ -15766,6 +15882,12 @@ uptodate, path, verbose
 
 =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] ); 
 
@@ -19224,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
@@ -19984,8 +20122,6 @@ maybe_command
 
 needs_linking (o)
 
-nicetext
-
 parse_abstract
 
 parse_version
@@ -20153,7 +20289,7 @@ perldepend (override)
 
 makeaperl (override)
 
-nicetext (override)
+maketext_filter (override)
 
 prefixify (override)
 
@@ -20788,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