=back
-=head2 perlfaq1 - General Questions About Perl ($Revision: 9681 $)
+=head2 perlfaq1 - General Questions About Perl
=over 4
=back
-=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 9462 $)
+=head2 perlfaq2 - Obtaining and Learning about Perl
=over 4
=back
-=head2 perlfaq3 - Programming Tools ($Revision: 8539 $)
+=head2 perlfaq3 - Programming Tools
=over 4
=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?
=back
-=head2 perlfaq4 - Data Manipulation ($Revision: 9681 $)
+=head2 perlfaq4 - Data Manipulation
=over 4
=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)?
=back
-=head2 perlfaq5 - Files and Formats ($Revision: 9576 $)
+=head2 perlfaq5 - Files and Formats
=over 4
=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>
=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>
=back
-=head2 perlfaq6 - Regular Expressions ($Revision: 8539 $)
+=head2 perlfaq6 - Regular Expressions
=over 4
=back
-=head2 perlfaq7 - General Perl Language Issues ($Revision: 9620 $)
+=head2 perlfaq7 - General Perl Language Issues
=over 4
=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?
=back
-=head2 perlfaq8 - System Interaction ($Revision: 9681 $)
+=head2 perlfaq8 - System Interaction
=over 4
=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)
=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?
=back
-=head2 perlfaq9 - Networking ($Revision: 8539 $)
+=head2 perlfaq9 - Networking
=over 4
=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>,
$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),
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>
=item PCRE/Python Support
-C<< (?P<NAME>pattern) >>, C<< (?P=NAME) >>, C<< (?P>NAME) >>
+C<< (?PE<lt>NAMEE<gt>pattern) >>, C<< (?P=NAME) >>, C<< (?P>NAME) >>
=item BUGS
=item Ignoring A Thread
+=item Process and Thread Termination
+
=back
=item Threads And Data
=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?
=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
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,
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
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>
=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
=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
=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
=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?
=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
=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 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
=back
-=head2 perldelta - what is new for perl v5.9.5
+=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 array/hash dereferencing in defined()
+=item strictures and dereferencing in defined()
=item C<(?p{})> has been removed
=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 Math::BigInt/Math::BigFloat
+=item XS-assisted SWASHGET
-config(), import(), roundmode common, bpi(), bcos(), bsin(), batan(),
-batan2(), bmuladd(), bexp(), bnok(), from_hex(), from_oct(), and
-from_bin(), as_oct()
+=item Constant subroutines
-=item New Core Modules
+=item C<PERL_DONT_CREATE_GVSV>
-=item Module changes
+=item Weak references are cheaper
-C<assertions>, C<base>, C<strict> and C<warnings>, C<warnings>, C<less>,
-C<Attribute::Handlers>, C<B::Lint>, C<B>, C<Thread>
+=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 Utility Changes
+=item Installation and Configuration Improvements
=over 4
-=item C<cpanp>
+=item Configuration improvements
-=item C<cpan2dist>
+C<-Dusesitecustomize>, Relocatable installations, strlcat() and strlcpy(),
+C<d_pseudofork> and C<d_printf_format_null>, Configure help
-=item C<pod2html>
+=item Compilation improvements
-=back
+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 Documentation
+=item Installation improvements
-=over 4
+Module auxiliary files
-=item New manpage, perlunifaq
+=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 win32 builds
+=item Removal of CPP symbols
-=item C<d_pseudofork> and C<d_printf_format_null>
+=item Less space is used by ops
-=item Help
+=item New parser
-=item 64bit systems
+=item Use of C<const>
-=item Ports
+=item Mathoms
-=back
+=item C<AvFLAGS> has been removed
-=item Selected Bug Fixes
+=item C<av_*> changes
-=item New or Changed Diagnostics
+=item $^H and %^H
+
+=item B:: modules inheritance changed
+
+=item Anonymous hash and array constructors
+
+=back
+
+=item Known Problems
=over 4
-=item Deprecations
+=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
=back
-=head2 perl5100delta, perldelta - what is new for perl 5.10.0
+=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()
+
+=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 C<:unique>
-=item Scoping of the C<sort> pragma
-
-=item Scoping of C<bignum>, C<bigint>, C<bigrat>
-
=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 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
+
+=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 C<(?p{})> has been removed
+=item Memory optimisations
-=item Pseudo-hashes have been removed
+=item UTF-8 cache optimisation
-=item Removal of the bytecode compiler and of perlcc
+=item Sloppy stat on Windows
-=item Removal of the JPL
+=item Regular expressions optimisations
-=item Recursive inheritance detected earlier
+Engine de-recursivised, Single char char-classes treated as literals, Trie
+optimisation of literal string alternations, Aho-Corasick start-point
+optimisation
=back
-=item Core Enhancements
+=item Installation and Configuration Improvements
=over 4
-=item The C<feature> pragma
+=item Configuration improvements
-=item New B<-E> command-line switch
+C<-Dusesitecustomize>, Relocatable installations, strlcat() and strlcpy(),
+C<d_pseudofork> and C<d_printf_format_null>, Configure help
-=item Defined-or operator
+=item Compilation improvements
-=item Switch and Smart Match operator
+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 Regular expressions
+=item Installation improvements
-Recursive Patterns, Named Capture Buffers, Possessive Quantifiers,
-Backtracking control verbs, Relative backreferences, C<\K> escape, Vertical
-and horizontal whitespace, and linebreak
+Module auxiliary files
-=item C<say()>
+=item New Or Improved Platforms
-=item Lexical C<$_>
+=back
-=item The C<_> prototype
+=item Selected Bug Fixes
-=item UNITCHECK blocks
+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 Pragma, C<mro>
+=item New or Changed Diagnostics
-=item readpipe() is now overridable
+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 default argument for readline()
+=item Changed Internals
-=item state() variables
+=over 4
-=item Stacked filetest operators
+=item Reordering of SVt_* constants
-=item UNIVERSAL::DOES()
+=item Elimination of SVt_PVBM
-=item C<CLONE_SKIP()>
+=item New type SVt_BIND
-=item Formats
+=item Removal of CPP symbols
-=item Byte-order modifiers for pack() and unpack()
+=item Less space is used by ops
-=item Byte count feature in pack()
+=item New parser
-=item C<no VERSION>
+=item Use of C<const>
-=item C<chdir>, C<chmod> and C<chown> on filehandles
+=item Mathoms
-=item OS groups
+=item C<AvFLAGS> has been removed
-=item Recursive sort subs
+=item C<av_*> changes
-=item Exceptions in constant folding
+=item $^H and %^H
-=item Source filters in @INC
+=item B:: modules inheritance changed
-=item New internal variables
+=item Anonymous hash and array constructors
-C<${^RE_DEBUG_FLAGS}>, C<${^CHILD_ERROR_NATIVE}>
+=back
-=item Miscellaneous
+=item Known Problems
-=item UCD 5.0.0
+=over 4
-=item MAD
+=item UTF-8 problems
=back
-=item Modules and Pragmata
-=head1 Utility Changes
-=head1 New Documentation
-=head1 Performance Enhancements
-=head1 Installation and Configuration Improvements
-=head1 Selected Bug Fixes
-=head1 New or Changed Diagnostics
-=head1 Changed Internals
-=head1 New Tests
-=head1 Known Problems
-=head1 Platform Specific Problems
-=head1 Reporting Bugs
+=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
=back
-=head2 perl594delta, perldelta - what is new for perl v5.9.4
+=head2 perl594delta - what is new for perl v5.9.4
=over 4
=back
-=head2 perl593delta, perldelta - what is new for perl v5.9.3
+=head2 perl593delta - what is new for perl v5.9.3
=over 4
=back
-=head2 perl592delta, perldelta - what is new for perl v5.9.2
+=head2 perl592delta - what is new for perl v5.9.2
=over 4
=back
-=head2 perl591delta, perldelta - what is new for perl v5.9.1
+=head2 perl591delta - what is new for perl v5.9.1
=over 4
=back
-=head2 perl590delta, perldelta - what is new for perl v5.9.0
+=head2 perl590delta - what is new for perl v5.9.0
=over 4
=back
-=head2 perl588delta, perldelta - what is new for perl v5.8.8
+=head2 perl588delta - what is new for perl v5.8.8
=over 4
=back
-=head2 perl587delta, perldelta - what is new for perl v5.8.7
+=head2 perl587delta - what is new for perl v5.8.7
=over 4
=item Syntax
+=item Filename Case
+
+=item Symbolic Links
+
=item Wildcard expansion
=item Pipes
=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
=over 4
-=item subpragma access
+=item Consider this carefully
+
+=item The "access" sub-pragma
+
+=item Limitation with regard to C<_>
=back
=item $Archive::Tar::error
+=item $Archive::Tar::INSECURE_EXTRACT_MODE
+
=item $Archive::Tar::HAS_PERLIO
=item $Archive::Tar::HAS_IO_STRING
=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
=over 4
-=item $conf = $cb->configure_object ()
+=item $conf = $cb->configure_object;
=back
=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
=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
=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
=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
=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
=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
=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
=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
needs_linking (o)
-nicetext
-
parse_abstract
parse_version
makeaperl (override)
-nicetext (override)
+maketext_filter (override)
prefixify (override)
=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
Implement $PREFER_BIN
-=item AUTHORS
+=item BUG REPORTS
+
+=item AUTHOR
=item COPYRIGHT
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>
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>
=item See Also
-=item AUTHOR
-
=item ACKNOWLEDGEMENTS
+=item BUG REPORTS
+
+=item AUTHOR
+
=item COPYRIGHT
=back
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()
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
=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
=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
=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
=item DIAGNOSTICS
C<Invalid argument passed to setlogsock>, C<eventlog passed to setlogsock,
-but operating system isn't Win32-compatible>, 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>
+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
AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request
tracker, Search CPAN, Kobes' CPAN Search, Perl Documentation
+=item COPYRIGHT
+
=item LICENSE
=back
=item DIAGNOSTICS
C<Invalid argument passed to setlogsock>, C<eventlog passed to setlogsock,
-but operating system isn't Win32-compatible>, 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>
+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
AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request
tracker, Search CPAN, Kobes' CPAN Search, Perl Documentation
+=item COPYRIGHT
+
=item LICENSE
=back
=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
=item SUPPORT
+=item COPYRIGHT
+
=item AUTHOR
=back