This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta: Incorporate the local $_ entry from 658a9f3
[perl5.git] / pod / perldelta.pod
index fe26dcf..2ea8a86 100644 (file)
@@ -40,9 +40,9 @@ phones.  This conflicts with the long-standing Perl usage of having
 C<BELL> mean the ASCII C<BEL> character, U+0007.  In Perl 5.14,
 C<\N{BELL}> will continue to mean U+0007, but its use will generate a
 deprecated warning message, unless such warnings are turned off.  The
-new name for U+0007 in Perl will be C<ALERT>, which corresponds nicely
-with the existing shorthand sequence for it, C<"\a">.  C<\N{BEL}> will
-mean U+0007, with no warning given.  The character at U+1F514 will not
+new name for U+0007 in Perl is C<ALERT>, which corresponds nicely
+with the existing shorthand sequence for it, C<"\a">.  C<\N{BEL}>
+means U+0007, with no warning given.  The character at U+1F514 will not
 have a name in 5.14, but can be referred to by C<\N{U+1F514}>.  The plan
 is that in Perl 5.16, C<\N{BELL}> will refer to U+1F514, and so all code
 that uses C<\N{BELL}> should convert by then to using C<\N{ALERT}>,
@@ -372,11 +372,11 @@ result of stringifying the object.
 
 =head3 Assignment to C<$0> sets the legacy process name with C<prctl()> on Linux
 
-On Linux the legacy process name will be set with L<prctl(2)>, in
+On Linux the legacy process name is now set with L<prctl(2)>, in
 addition to altering the POSIX name via C<argv[0]> as perl has done
-since version 4.000. Now system utilities that read the legacy process
+since version 4.000.  Now system utilities that read the legacy process
 name such as ps, top and killall will recognize the name you set when
-assigning to C<$0>. The string you supply will be cut off at 16 bytes,
+assigning to C<$0>.  The string you supply will be cut off at 16 bytes;
 this is a limitation imposed by Linux.
 
 =head3 C<srand()> now returns the seed
@@ -489,12 +489,12 @@ See L</Internal Changes>.
 
 In L<perlunicode/"User-Defined Character Properties">, it says you can
 create custom properties by defining subroutines whose names begin with
-"In" or "Is". However, Perl did not actually enforce that naming
-restriction, so \p{foo::bar} could call foo::bar() if it existed. Now this
+"In" or "Is".  However, Perl did not actually enforce that naming
+restriction, so \p{foo::bar} could call foo::bar() if it existed.  Now this
 convention has been enforced.
 
 Also, Perl no longer allows a tainted regular expression to invoke a
-user-defined. It simply dies instead [perl #82616].
+user-defined property.  It simply dies instead [perl #82616].
 
 =head1 Incompatible Changes
 
@@ -511,7 +511,7 @@ different, anomalous behavior than their use in all other
 double-quote-like contexts.   Since 5.10.1, a deprecated warning message
 has been raised when this happens.  Now, all double-quote-like contexts
 have the same behavior, namely to be equivalent to C<\x{100}> -
-C<\x{1FF}>, with no deprecation warning. Use of these values in the
+C<\x{1FF}>, with no deprecation warning.  Use of these values in the
 command line option C<"-0"> retains the current meaning to slurp input
 files whole; previously, this was documented only for C<"-0777">.  It is
 recommended, however, because of various ambiguities, to use the new
@@ -589,7 +589,8 @@ was compiled at run time as happens in cases like these two:
   $foo =~ $bar; # when $bar contains (?{...})
   $foo =~ /$bar(?{ $finished = 1 })/;
 
-This was a bug, which has now been fixed. But it has the potential to break
+This was a bug, which has now been fixed.  But
+it has the potential to break
 any code that was relying on it.
 
 =head2 Stashes and Package Variables
@@ -606,7 +607,7 @@ In the following:
     # here, @a refers again to the old, tied array
 
 The new local array used to be made tied too, which was fairly pointless,
-and has now been fixed. This fix could however potentially cause a change
+and has now been fixed.  This fix could however potentially cause a change
 in behaviour of some code.
 
 =head3 Stashes are now always defined
@@ -620,12 +621,21 @@ hashes that drastically reduce their memory usage overhead.
 
 Calling defined on a stash has been deprecated since 5.6.0, warned on
 lexicals since 5.6.0, and warned for stashes (and other package
-variables) since 5.12.0. C<defined %hash> has always exposed an
+variables) since 5.12.0.  C<defined %hash> has always exposed an
 implementation detail - emptying a hash by deleting all entries from it does
 not make C<defined %hash> false, hence C<defined %hash> is not valid code to
-determine whether an arbitrary hash is empty. Instead, use the behaviour
+determine whether an arbitrary hash is empty.  Instead, use the behaviour
 that an empty C<%hash> always returns false in a scalar context.
 
+=head3 Clearing stashes
+
+Stash list assignment C<%foo:: = ()> used to make the stash anonymous
+temporarily while it was being emptied. Consequently, any of its
+subroutines referenced elsewhere would become anonymous (showing up as
+"(unknown)" in C<caller>). Now they retain their package names, such that
+C<caller> will return the original sub name if there is still a reference
+to its typeglob, or "foo::__ANON__" otherwise [perl #79208].
+
 =head3 Dereferencing typeglobs
 
 If you assign a typeglob to a scalar variable:
@@ -633,13 +643,14 @@ If you assign a typeglob to a scalar variable:
     $glob = *foo;
 
 the glob that is copied to C<$glob> is marked with a special flag
-indicating that the glob is just a copy. This allows subsequent assignments
-to C<$glob> to overwrite the glob. The original glob, however, is
+indicating that the glob is just a copy.  This
+allows subsequent assignments to C<$glob> to
+overwrite the glob.  The original glob, however, is
 immutable.
 
-Many Perl operators did not distinguish between these two types of globs.
+Some Perl operators did not distinguish between these two types of globs.
 This would result in strange behaviour in edge cases: C<untie $scalar>
-would do nothing if the last thing assigned to the scalar was a glob
+would not untie the scalar if the last thing assigned to it was a glob
 (because it treated it as C<untie *$scalar>, which unties a handle).
 Assignment to a glob slot (e.g., C<*$glob = \@some_array>) would simply
 assign C<\@some_array> to C<$glob>.
@@ -649,31 +660,22 @@ has been modified to make a new immutable glob if its operand is a glob
 copy.  This allows operators that make a distinction between globs and
 scalars to be modified to treat only immutable globs as globs.  (C<tie>,
 C<tied> and C<untie> have been left as they are for compatibility's sake,
-but will warn. See L</Deprecations>.)
+but will warn.  See L</Deprecations>.)
 
 This causes an incompatible change in code that assigns a glob to the
-return value of C<*{}> when that operator was passed a glob copy. Take the
+return value of C<*{}> when that operator was passed a glob copy.  Take the
 following code, for instance:
 
     $glob = *foo;
     *$glob = *bar;
 
 The C<*$glob> on the second line returns a new immutable glob. That new
-glob is made an alias to C<*bar>. Then it is discarded. So the second
+glob is made an alias to C<*bar>.  Then it is discarded. So the second
 assignment has no effect.
 
 See L<http://rt.perl.org/rt3/Public/Bug/Display.html?id=77810> for even
 more detail.
 
-=head3 Clearing stashes
-
-Stash list assignment C<%foo:: = ()> used to make the stash anonymous
-temporarily while it was being emptied. Consequently, any of its
-subroutines referenced elsewhere would become anonymous (showing up as
-"(unknown)" in C<caller>). Now they retain their package names, such that
-C<caller> will return the original sub name if there is still a reference
-to its typeglob, or "foo::__ANON__" otherwise [perl #79208].
-
 =head3 Magic variables outside the main package
 
 In previous versions of Perl, magic variables like C<$!>, C<%SIG>, etc. would
@@ -686,6 +688,19 @@ such as signal handlers being wiped when modules were loaded, etc.
 This has been fixed (or the feature has been removed, depending on how you see
 it).
 
+=head3 local($_) will strip all magic from $_
+
+local() on scalar variables will give them a new value, but keep all
+their magic intact.  This has proven to be problematic for the default
+scalar variable $_, where L<perlsub> recommends that any subroutine
+that assigns to $_ should localize it first.  This would throw an
+exception if $_ is aliased to a read-only variable, and could have
+various unintentional side-effects in general.
+
+Therefore, as an exception to the general rule, local($_) will not
+only assign a new value to $_, but also remove all existing magic from
+it as well.
+
 =head2 Changes to Syntax or to Perl Operators
 
 =head3 C<given> return values
@@ -719,13 +734,14 @@ functions:
 
 Due to this bug fix [perl #75904], functions
 using the C<(*)>, C<(;$)> and C<(;*)> prototypes
-are parsed with higher precedence than before. So in the following example:
+are parsed with higher precedence than before.  So
+in the following example:
 
   sub foo($);
   foo $a < $b;
 
 the second line is now parsed correctly as C<< foo($a) < $b >>, rather than
-C<< foo($a < $b) >>. This happens when one of these operators is used in
+C<< foo($a < $b) >>.  This happens when one of these operators is used in
 an unparenthesised argument:
 
   < > <= >= lt gt le ge
@@ -756,7 +772,7 @@ as numbers [perl #57706].
 =head3 Negative zero
 
 Negative zero (-0.0), when converted to a string, now becomes "0" on all
-platforms. It used to become "-0" on some, but "0" on others.
+platforms.  It used to become "-0" on some, but "0" on others.
 
 If you still need to determine whether a zero is negative, use
 C<sprintf("%g", $zero) =~ /^-/> or the L<Data::Float> module on CPAN.
@@ -765,8 +781,9 @@ C<sprintf("%g", $zero) =~ /^-/> or the L<Data::Float> module on CPAN.
 
 Previously C<my $pi := 4;> was exactly equivalent to C<my $pi : = 4;>,
 with the C<:> being treated as the start of an attribute list, ending before
-the C<=>. The use of C<:=> to mean C<: => was deprecated in 5.12.0, and is now
-a syntax error. This will allow the future use of C<:=> as a new token.
+the C<=>.  The use of C<:=> to mean C<: => was deprecated in 5.12.0, and is
+now a syntax error.  This will allow the future use of C<:=> as a new
+token.
 
 We find no Perl 5 code on CPAN using this construction, outside the core's
 tests for it, so we believe that this change will have very little impact on
@@ -782,27 +799,27 @@ the C<=>.
 
 On systems other than Windows that do not have
 a C<fchdir> function, newly-created threads no
-longer inherit directory handles from their parent threads. Such programs
+longer inherit directory handles from their parent threads.  Such programs
 would usually have crashed anyway [perl #75154].
 
 =head3 C<close> on shared pipes
 
 The C<close> function no longer waits for the child process to exit if the
 underlying file descriptor is still in use by another thread, to avoid
-deadlocks. It returns true in such cases.
+deadlocks.  It returns true in such cases.
 
 =head3 fork() emulation will not wait for signalled children
 
 On Windows parent processes would not terminate until all forked
 childred had terminated first.  However, C<kill('KILL', ...)> is
 inherently unstable on pseudo-processes, and C<kill('TERM', ...)>
-might not get delivered if the child if blocked in a system call.
+might not get delivered if the child is blocked in a system call.
 
 To avoid the deadlock and still provide a safe mechanism to terminate
 the hosting process, Perl will now no longer wait for children that
 have been sent a SIGTERM signal.  It is up to the parent process to
 waitpid() for these children if child clean-up processing must be
-allowed to finish. However, it is also the responsibility of the
+allowed to finish.  However, it is also the responsibility of the
 parent then to avoid the deadlock by making sure the child process
 can't be blocked on I/O either.
 
@@ -817,7 +834,7 @@ Several long-standing typos and naming confusions in Policy_sh.SH have
 been fixed, standardizing on the variable names used in config.sh.
 
 This will change the behavior of Policy.sh if you happen to have been
-accidentally relying on the Policy.sh incorrect behavior.
+accidentally relying on its incorrect behavior.
 
 =head3 Perl source code is read in text mode on Windows
 
@@ -920,7 +937,7 @@ L<Unicode::Casing>, which provides improved functionality.
 
 The following modules will be removed from the core distribution in a
 future release, and should be installed from CPAN instead. Distributions
-on CPAN which require these should add them to their prerequisites. The
+on CPAN which require these should add them to their prerequisites.  The
 core versions of these modules will issue a deprecation warning.
 
 If you ship a packaged version of Perl, either alone or as part of a
@@ -955,10 +972,10 @@ preference, as it offers significantly improved profiling and reporting.
 
 =head2 "Safe signals" optimisation
 
-Signal dispatch has been moved from the runloop into control ops. This
+Signal dispatch has been moved from the runloop into control ops.  This
 should give a few percent speed increase, and eliminates almost all of
 the speed penalty caused by the introduction of "safe signals" in
-5.8.0. Signals should still be dispatched within the same statement as
+5.8.0.  Signals should still be dispatched within the same statement as
 they were previously - if this is not the case, or it is possible to
 create uninterruptible loops, this is a bug, and reports are encouraged
 of how to recreate such issues.
@@ -1016,7 +1033,7 @@ been).
 
 When an object has many weak references to it, freeing that object
 can under some some circumstances take O(N^2) time to free (where N is the
-number of references). The number of circumstances has been reduced
+number of references).  The number of circumstances has been reduced
 [perl #75254]
 
 =head2 Lexical array and hash assignments
@@ -1035,7 +1052,7 @@ the subroutine is called [perl #72416].
 =head2 Size optimisations to SV and HV structures
 
 xhv_fill has been eliminated from struct xpvhv, saving 1 IV per hash and
-on some systems will cause struct xpvhv to become cache-aligned. To avoid
+on some systems will cause struct xpvhv to become cache-aligned.  To avoid
 this memory saving causing a slowdown elsewhere, boolean use of HvFILL
 now calls HvTOTALKEYS instead (which is equivalent) - so while the fill
 data when actually required are now calculated on demand, the cases when
@@ -1062,7 +1079,8 @@ uses Exporter but doesn't use this functionality.
 =head2 Memory savings for weak references
 
 For weak references, the common case of just a single weak reference per
-referent has been optimised to reduce the storage required. In this case it
+referent has been optimised to reduce the
+storage required.  In this case it
 saves the equivalent of one small Perl array per referent.
 
 =head2 C<%+> and C<%-> use less memory
@@ -1110,16 +1128,16 @@ at compile time.
 C<CPAN::Meta::YAML> 0.003 has been added as a dual-life module.  It supports a
 subset of YAML sufficient for reading and writing META.yml and MYMETA.yml files
 included with CPAN distributions or generated by the module installation
-toolchain. It should not be used for any other general YAML parsing or
+toolchain.  It should not be used for any other general YAML parsing or
 generation task.
 
 =item *
 
-C<CPAN::Meta> version 2.110440 has been added as a dual-life module. It
+C<CPAN::Meta> version 2.110440 has been added as a dual-life module.  It
 provides a standard library to read, interpret and write CPAN distribution
 metadata files (e.g. META.json and META.yml) which describes a
 distribution, its contents, and the requirements for building it and
-installing it. The latest CPAN distribution metadata specification is
+installing it.  The latest CPAN distribution metadata specification is
 included as C<CPAN::Meta::Spec> and notes on changes in the specification
 over time are given in C<CPAN::Meta::History>.
 
@@ -1155,7 +1173,7 @@ a single location for easier maintenance.
 =item *
 
 The following modules were added by the C<Unicode::Collate> 
-upgrade. See below for details.
+upgrade.  See below for details.
 
 C<Unicode::Collate::CJK::Big5>
 
@@ -1183,6 +1201,10 @@ prerequisites and version constraints as defined in the L<CPAN::Meta::Spec>.
 
 =item *
 
+C<attributes> has been upgraded from version 0.12 to 0.14.
+
+=item *
+
 C<Archive::Extract> has been upgraded from version 0.38 to 0.48.
 
 Updates since 0.38 include: a safe print method that guards
@@ -1232,7 +1254,19 @@ Pax extended headers are now skipped.
 
 =item *
 
-C<B> has been upgraded from version 1.23 to 1.27.
+C<Attribute::Handlers> has been upgraded from version 0.87 to 0.89.
+
+=item *
+
+C<autodie> has been upgraded from version 2.06_01 to 2.1001.
+
+=item *
+
+C<AutoLoader> has been upgraded from version 5.70 to 5.71.
+
+=item *
+
+C<B> has been upgraded from version 1.23 to 1.29.
 
 It no longer crashes when taking apart a C<y///> containing characters
 outside the octet range or compiled in a C<use utf8> scope.
@@ -1242,7 +1276,7 @@ reduction in functionality.
 
 =item *
 
-C<B::Concise> has been upgraded from version 0.78 to 0.82.
+C<B::Concise> has been upgraded from version 0.78 to 0.83.
 
 B::Concise marks rv2sv, rv2av and rv2hv ops with the new OPpDEREF flag
 as "DREFed".
@@ -1252,7 +1286,11 @@ It no longer produces mangled output with the C<-tree> option
 
 =item *
 
-C<B::Deparse> has been upgraded from version 0.96 to 1.02.
+C<B::Debug> has been upgraded from version 1.12 to 1.16.
+
+=item *
+
+C<B::Deparse> has been upgraded from version 0.96 to 1.03.
 
 The deparsing of a nextstate op has changed when it has both a
 change of package (relative to the previous nextstate), or a change of
@@ -1270,7 +1308,23 @@ Deparsing of C<our> followed by a variable with funny characters
 
 =item *
 
-C<Carp> has been upgraded from version 1.15 to 1.19.
+C<B::Lint> has been upgraded from version 1.11_01 to 1.13.
+
+=item *
+
+C<base> has been upgraded from version 2.15 to 2.16.
+
+=item *
+
+C<Benchmark> has been upgraded from version 1.11 to 1.12.
+
+=item *
+
+C<bignum> has been upgraded from version 0.23 to 0.26.
+
+=item *
+
+C<Carp> has been upgraded from version 1.15 to 1.20.
 
 L<Carp> now detects incomplete L<caller()|perlfunc/"caller EXPR"> overrides and
 avoids using bogus C<@DB::args>.  To provide backtraces,
@@ -1290,7 +1344,7 @@ errors' error that will ensue if there has been a syntax error
 
 =item *
 
-C<CGI> has been upgraded from version 3.48 to 3.51.
+C<CGI> has been upgraded from version 3.48 to 3.52.
 
 This provides the following security fixes: the MIME boundary in 
 multipart_init is now random and the handling of 
@@ -1304,6 +1358,10 @@ It has been updated to use bzip2 1.0.6.
 
 =item *
 
+C<Compress::Raw::Zlib> has been upgraded from version 2.024 to 2.033.
+
+=item *
+
 C<CPAN> has been upgraded from version 1.94_56 to 1.9600.
 
 Major highlights:
@@ -1345,6 +1403,10 @@ CPANPLUS now includes support for META.json and MYMETA.json.
 
 =item *
 
+C<CPANPLUS::Dist::Build> has been upgraded from version 0.46 to 0.54.
+
+=item *
+
 C<Data::Dumper> has been upgraded from version 2.125 to 2.130_02.
 
 The indentation used to be off when C<$Data::Dumper::Terse> was set. This
@@ -1358,6 +1420,14 @@ C<Dumpxs> no longer crashes with globs returned by C<*$io_ref>
 
 =item *
 
+C<DB_File> has been upgraded from version 1.820 to 1.821.
+
+=item *
+
+C<DBM_Filter> has been upgraded from version 0.03 to 0.04.
+
+=item *
+
 C<Devel::DProf> has been upgraded from version 20080331.00 to 20110228.00.
 
 Merely loading C<Devel::DProf> now no longer triggers profiling to start.
@@ -1371,6 +1441,14 @@ profiling and reporting.
 
 =item *
 
+C<Devel::Peek> has been upgraded from version 1.04 to 1.07.
+
+=item *
+
+C<Devel::SelfStubber> has been upgraded from version 1.03 to 1.05.
+
+=item *
+
 C<diagnostics> has been upgraded from version 1.19 to 1.22.
 
 It now renders pod links slightly better, and has been taught to find
@@ -1396,7 +1474,15 @@ New SHA-512/224 and SHA-512/256 transforms (ref. NIST Draft FIPS 180-4
 
 =item *
 
-C<DynaLoader> has been upgraded from version 1.10 to 1.12.
+C<DirHandle> has been upgraded from version 1.03 to 1.04.
+
+=item *
+
+C<Dumpvalue> has been upgraded from version 1.13 to 1.16.
+
+=item *
+
+C<DynaLoader> has been upgraded from version 1.10 to 1.13.
 
 It fixes a buffer overflow when passed a very long file name.
 
@@ -1414,6 +1500,10 @@ disallowed; in those cases where it warned, all 66 warn.
 
 =item *
 
+C<Env> has been upgraded from version 1.01 to 1.02.
+
+=item *
+
 C<Errno> has been upgraded from version 1.11 to 1.13.
 
 The implementation of C<Errno> has been refactored to use about 55% less memory.
@@ -1430,6 +1520,14 @@ Exporter no longer overrides C<$SIG{__WARN__}> [perl #74472]
 
 =item *
 
+C<ExtUtils::CBuilder> has been upgraded from version 0.27 to 0.280202.
+
+=item *
+
+C<ExtUtils::Command> has been upgraded from version 1.16 to 1.17.
+
+=item *
+
 C<ExtUtils::Constant> has been upgraded from 0.22 to 0.23.
 
 The C<AUTOLOAD> helper code generated by C<ExtUtils::Constant::ProxySubs>
@@ -1443,7 +1541,39 @@ constants onto the package's C<@EXPORT_OK>.
 
 =item *
 
-C<File::DosGlob> has been upgraded from version 1.01 to 1.03.
+C<ExtUtils::Install> has been upgraded from version 1.55 to 1.56.
+
+=item *
+
+C<ExtUtils::MakeMaker> has been upgraded from version 6.56 to 6.57_05.
+
+=item *
+
+C<ExtUtils::Manifest> has been upgraded from version 1.57 to 1.58.
+
+=item *
+
+C<ExtUtils::ParseXS> has been upgraded from version 2.21 to 2.2210.
+
+=item *
+
+C<Fcntl> has been upgraded from version 1.06 to 1.11.
+
+=item *
+
+C<File::Basename> has been upgraded from version 2.78 to 2.81.
+
+=item *
+
+C<File::CheckTree> has been upgraded from version 4.4 to 4.41.
+
+=item *
+
+C<File::Copy> has been upgraded from version 2.17 to 2.21.
+
+=item *
+
+C<File::DosGlob> has been upgraded from version 1.01 to 1.04.
 
 It allows patterns containing literal parentheses (they no longer need to
 be escaped).  On Windows, it no longer
@@ -1462,13 +1592,17 @@ Dragonfly BSD for the C<http> and C<ftp> schemes.
 
 =item *
 
-C<File::Find> has been upgraded from version 1.15 to 1.18.
+C<File::Find> has been upgraded from version 1.15 to 1.19.
 
 It improves handling of backslashes on Windows, so that paths like
 F<c:\dir\/file> are no longer generated [perl #71710].
 
 =item *
 
+C<File::Glob> has been upgraded from version 1.07 to 1.12.
+
+=item *
+
 C<File::Spec> has been upgraded from version 3.31 to 3.33.
 
 Several portability fixes were made in C<File::Spec::VMS>: a colon is now
@@ -1479,38 +1613,58 @@ name is empty; C<abs2rel()> properly handles Unix-style input (5.12.2).
 
 =item *
 
-C<File::stat> has been upgraded from 1.02 to 1.04.
+C<File::stat> has been upgraded from 1.02 to 1.05.
 
 The C<-x> and C<-X> file test operators now work correctly under the root
 user.
 
 =item *
 
-C<GDBM_File> has been upgraded from 1.10 to 1.13.
+C<Filter::Simple> has been upgraded from version 0.84 to 0.86.
+
+=item *
+
+C<GDBM_File> has been upgraded from 1.10 to 1.14.
 
 This fixes a memory leak when DBM filters are used.
 
 =item *
 
-C<Hash::Util> has been upgraded from 0.07 to 0.10.
+C<Hash::Util> has been upgraded from 0.07 to 0.11.
 
 Hash::Util no longer emits spurious "uninitialized" warnings when
 recursively locking hashes that have undefined values [perl #74280].
 
 =item *
 
-C<I18N::Langinfo> has been upgraded from version 0.03 to 0.07.
+C<Hash::Util::FieldHash> has been upgraded from version 1.04 to 1.09.
+
+=item *
+
+C<I18N::Collate> has been upgraded from version 1.01 to 1.02.
+
+=item *
+
+C<I18N::Langinfo> has been upgraded from version 0.03 to 0.08.
 
 C<langinfo()> now defaults to using C<$_> if there is no argument given, just
 as the documentation has always claimed.
 
 =item *
 
-C<IO::Select> has been upgraded from version 1.17 to 1.18.
+C<I18N::LangTags> has been upgraded from version 0.35 to 0.35_01.
+
+=item *
+
+C<if> has been upgraded from version 0.05 to 0.0601.
 
-It now allows IO::Handle objects (and objects in derived classes) to be
-removed from an IO::Select set even if the underlying file descriptor is
-closed or invalid.
+=item *
+
+C<IO> has been upgraded from version 1.25_02 to 1.25_04.
+
+This version of C<IO> includes a new C<IO::Select>, which now allows IO::Handle
+objects (and objects in derived classes) to be removed from an IO::Select set
+even if the underlying file descriptor is closed or invalid.
 
 =item *
 
@@ -1626,7 +1780,11 @@ C<Module::Load::Conditional> has been upgraded from version 0.34 to 0.44.
 
 =item *
 
-C<NDBM_File> has been upgraded from version 1.08 to 1.11.
+C<mro> has been upgraded from version 1.02 to 1.07.
+
+=item *
+
+C<NDBM_File> has been upgraded from version 1.08 to 1.12.
 
 This fixes a memory leak when DBM filters are used.
 
@@ -1650,7 +1808,11 @@ This fixes a memory leak when DBM filters are used.
 
 =item *
 
-C<overload> has been upgraded from 1.10 to 1.12.
+C<Opcode> has been upgraded from version 1.15 to 1.18.
+
+=item *
+
+C<overload> has been upgraded from 1.10 to 1.13.
 
 C<overload::Method> can now handle subroutines that are themselves blessed
 into overloaded classes [perl #71998].
@@ -1674,6 +1836,10 @@ L<CPAN::Meta::YAML> and L<JSON::PP>, which are now part of the Perl core.
 
 =item *
 
+C<PerlIO::encoding> has been upgraded from version 0.12 to 0.14.
+
+=item *
+
 C<PerlIO::scalar> has been upgraded from 0.07 to 0.11.
 
 A C<read> after a C<seek> beyond the end of the string no longer thinks it
@@ -1681,6 +1847,14 @@ has data to read [perl #78716].
 
 =item *
 
+C<PerlIO::via> has been upgraded from version 0.09 to 0.11.
+
+=item *
+
+C<Pod::Html> has been upgraded from version 1.09 to 1.1.
+
+=item *
+
 C<Pod::LaTeX> has been upgraded from version 0.58 to 0.59.
 
 =item *
@@ -1721,6 +1895,10 @@ It adds several version::vxs::* routines to the default share.
 
 =item *
 
+C<SDBM_File> has been upgraded from version 1.06 to 1.09.
+
+=item *
+
 C<SelfLoader> has been upgraded from 1.17 to 1.18.
 
 It now works in taint mode [perl #72062].
@@ -1755,6 +1933,10 @@ during freezing [perl #80074].
 
 =item *
 
+C<Sys::Hostname> has been upgraded from version 1.11 to 1.16.
+
+=item *
+
 C<Term::ANSIColor> has been upgraded from version 2.02 to 3.00.
 
 =item *
@@ -1799,6 +1981,10 @@ Calling C<< Tie::Hash-E<gt>TIEHASH() >> used to loop forever.  Now it C<croak>s.
 
 =item *
 
+C<Tie::Hash::NamedCapture> has been upgraded from version 0.06 to 0.08.
+
+=item *
+
 C<Tie::RefHash> has been upgraded from version 1.38 to 1.39.
 
 =item *
@@ -1954,6 +2140,10 @@ C<Win32::GetProductInfo>, C<Win32::GetOSDisplayName>.
 The names returned by C<Win32::GetOSName> and C<Win32::GetOSDisplayName>
 have been corrected.
 
+=item *
+
+C<XS::Typemap> has been upgraded from version 0.03 to 0.05.
+
 =back
 
 =head2 Removed Modules and Pragmata
@@ -2002,14 +2192,14 @@ split mostly from the NOTES section of the pod2man man page.
 
 =head3 L<perlsource>, L<perlinterp>, L<perlhacktut>, and L<perlhacktips>
 
-See L</L<perlhack> and perlrepository revamp>, below.
+See L</perlhack and perlrepository revamp>, below.
 
 =head2 Changes to Existing Documentation
 
 =head3 L<perlmodlib> is now complete
 
 The perlmodlib page that came with Perl 5.12.0 was missing a lot of
-modules, due to a bug in the script that generates the list. This has been
+modules, due to a bug in the script that generates the list.  This has been
 fixed [perl #74332] (5.12.1).
 
 =head3 Replace wrong tr/// table in L<perlebcdic>
@@ -2103,7 +2293,7 @@ L<perlbook> has been expanded to cover many more popular books.
 
 The documentation for the C<SvTRUE> macro in
 L<perlapi> was simply wrong in stating that
-get-magic is not processed. It has been corrected.
+get-magic is not processed.  It has been corrected.
 
 =head3 L<perlvar> revamp
 
@@ -2123,22 +2313,24 @@ C<use locale> affects formats.
 
 =head3 L<overload>
 
-L<overload>'s documentation has practically undergone a rewrite. It
+L<overload>'s documentation has practically undergone a rewrite.  It
 is now much more straightforward and clear.
 
-=head3 L<perlhack> and perlrepository revamp
+=head3 perlhack and perlrepository revamp
 
 The L<perlhack> and perlrepository documents have been heavily edited and
 split up into several new documents.
 
 The L<perlhack> document is now much shorter, and focuses on the Perl 5
-development process and submitting patches to Perl. The technical content has
+development process and submitting patches
+to Perl.  The technical content has
 been moved to several new documents, L<perlsource>, L<perlinterp>,
-L<perlhacktut>, and L<perlhacktips>. This technical content has only been
+L<perlhacktut>, and L<perlhacktips>.  This technical content has only been
 lightly edited.
 
-The perlrepository document has been renamed to L<perlgit>. This new document
-is just a how-to on using git with the Perl source code. Any other content
+The perlrepository document has been renamed to
+L<perlgit>.  This new document is just a how-to
+on using git with the Perl source code.  Any other content
 that used to be in perlrepository has been moved to perlhack.
 
 =head3 Time::Piece examples
@@ -2217,8 +2409,8 @@ deprecated so as to reserve its use for Perl itself in a future release.
 =item Operation "%s" returns its argument for ...
 
 Performing an operation requiring Unicode semantics (such as case-folding)
-on a Unicode surrogate or a non-Unicode character now triggers a warning:
-'Operation "%s" returns its argument for ...'.
+on a Unicode surrogate or a non-Unicode character now triggers this
+warning.
 
 =item Use of qw(...) as parentheses is deprecated
 
@@ -2421,13 +2613,14 @@ Perl now builds on AIX 4.2 (5.12.1).
 =item Apollo DomainOS
 
 The last vestiges of support for this platform have been excised from the
-Perl distribution. It was officially discontinued in version 5.12.0. It had
+Perl distribution.  It was officially discontinued
+in version 5.12.0.  It had
 not worked for years before that.
 
 =item MacOS Classic
 
 The last vestiges of support for this platform have been excised from the
-Perl distribution. It was officially discontinued in an earlier version.
+Perl distribution.  It was officially discontinued in an earlier version.
 
 =back
 
@@ -2505,11 +2698,21 @@ Perl now allows -Duse64bitint without promoting to use64bitall on HP-UX
 
 =head3 IRIX
 
+=over
+
+=item *
+
 Conversion of strings to floating-point numbers is now more accurate on
 IRIX systems [perl #32380].
 
+=back
+
 =head3 Mac OS X
 
+=over
+
+=item *
+
 Early versions of Mac OS X (Darwin) had buggy implementations of the
 C<setregid>, C<setreuid>, C<setrgid> and C<setruid> functions, so perl
 would pretend they did not exist.
@@ -2517,35 +2720,67 @@ would pretend they did not exist.
 These functions are now recognised on Mac OS 10.5 (Leopard; Darwin 9) and
 higher, as they have been fixed [perl #72990].
 
+=back
+
 =head3 MirBSD
 
+=over
+
+=item *
+
 Previously if you built perl with a shared libperl.so on MirBSD (the
 default config), it would work up to the installation; however, once
 installed, it would be unable to find libperl.  So path handling is now
 treated as in the other BSD dialects.
 
+=back
+
 =head3 NetBSD
 
+=over
+
+=item *
+
 The NetBSD hints file has been changed to make the system's malloc the
 default.
 
+=back
+
 =head3 Recent OpenBSDs now use perl's malloc
 
+=over
+
+=item *
+
 OpenBSD E<gt> 3.7 has a new malloc implementation which is mmap-based
 and as such can release memory back to the OS; however, perl's use of
 this malloc causes a substantial slowdown so we now default to using
 perl's malloc instead [perl #75742].
 
+=back
+
 =head3 OpenVOS
 
+=over
+
+=item *
+
 perl now builds again with OpenVOS (formerly known as Stratus VOS)
 [perl #78132] (5.12.3).
 
+=back
+
 =head3 Solaris
 
-DTrace is now supported on Solaris. There used to be build failures, but
+=over
+
+=item *
+
+DTrace is now supported on Solaris.  There used to be build failures, but
 these have been fixed [perl #73630] (5.12.3).
 
+=back
+
 =head3 VMS
 
 =over
@@ -2604,7 +2839,8 @@ introduction of spurious line breaks whenever the perlio buffer fills up.
 
 =item *
 
-F<git_version.h> is now installed on VMS. This was an oversight in v5.12.0 which
+F<git_version.h> is now installed on VMS.  This
+was an oversight in v5.12.0 which
 caused some extensions to fail to build (5.12.2).
 
 =item *
@@ -2786,7 +3022,7 @@ supported but discouraged.
 
 It is now possible for XS code to hook into Perl's lexical scope
 mechanism at compile time, using the new C<Perl_blockhook_register>
-function. See L<perlguts/"Compile-time scope hooks">.
+function.  See L<perlguts/"Compile-time scope hooks">.
 
 =head3 The recursive part of the peephole optimizer is now hookable
 
@@ -3006,7 +3242,8 @@ its design was insufficient for reliably getting the lexical C<$_> at
 run-time.
 
 Use the new C<find_rundefsv> function or the C<UNDERBAR> macro
-instead. They directly return the right SV representing C<$_>, whether it's
+instead.  They directly return the right SV
+representing C<$_>, whether it's
 lexical or dynamic.
 
 =item C<CALL_FPTR> and C<CPERLscope>
@@ -3092,12 +3329,12 @@ cause perl to crash whenever the glob's contents were accessed
 =item *
 
 PerlIO no longer crashes when called recursively, e.g., from a signal
-handler. Now it just leaks memory [perl #75556].
+handler.  Now it just leaks memory [perl #75556].
 
 =item *
 
 Most I/O functions were not warning for unopened handles unless the
-'closed' and 'unopened' warnings categories were both enabled. Now only
+'closed' and 'unopened' warnings categories were both enabled.  Now only
 C<use warnings 'unopened'> is necessary to trigger these warnings (as was
 always meant to be the case).
 
@@ -3171,7 +3408,7 @@ unrecognized escape sequences, passed-through.
 
 A regular expression match in the right-hand side of a global substitution
 (C<s///g>) that is in the same scope will no longer cause match variables
-to have the wrong values on subsequent iterations. This can happen when an
+to have the wrong values on subsequent iterations.  This can happen when an
 array or hash subscript is interpolated in the right-hand side, as in
 C<s|(.)|@a{ print($1), /./ }|g> [perl #19078].
 
@@ -3224,7 +3461,7 @@ point it is.
 =item *
 
 The C<(?|...)> regular expression construct no longer crashes if the final
-branch has more sets of capturing parentheses than any other branch. This
+branch has more sets of capturing parentheses than any other branch.  This
 was fixed in Perl 5.10.1 for the case of a single branch, but that fix did
 not take multiple branches into account [perl #84746].
 
@@ -3290,7 +3527,7 @@ to turn into
 
   $text =~ /phoo/
 
-at compile time. Now it correctly matches against C<$_> [perl #20444].
+at compile time.  Now it correctly matches against C<$_> [perl #20444].
 
 =item *
 
@@ -3332,7 +3569,8 @@ is no longer treated as a constant [perl #63540].
 
 =item *
 
-C<state> can now be used with attributes. It used to mean the same thing as
+C<state> can now be used with attributes.  It
+used to mean the same thing as
 C<my> if attributes were present [perl #68658].
 
 =item *
@@ -3411,7 +3649,7 @@ the assignment contained a subroutine.
 
 C<PL_isarev>, which is accessible to Perl via C<mro::get_isarev> is now
 updated properly when packages are deleted or removed from the C<@ISA> of
-other classes. This allows many packages to be created and deleted without
+other classes.  This allows many packages to be created and deleted without
 causing a memory leak [perl #75176].
 
 =back
@@ -3447,7 +3685,7 @@ means the following code will no longer crash:
 =item *
 
 Assigning a glob to a PVLV used to convert it to a plain string. Now it
-works correctly, and a PVLV can hold a glob. This would happen when a
+works correctly, and a PVLV can hold a glob.  This would happen when a
 nonexistent hash or array element was passed to a subroutine:
 
   sub { $_[0] = *foo }->($hash{key});
@@ -3469,7 +3707,7 @@ cases.
 During the restoration of a localised typeglob on scope exit, any
 destructors called as a result would be able to see the typeglob in an
 inconsistent state, containing freed entries, which could result in a
-crash. This would affect code like this:
+crash.  This would affect code like this:
 
   local *@;
   eval { die bless [] }; # puts an object in $@
@@ -3478,7 +3716,7 @@ crash. This would affect code like this:
   }
 
 Now the glob entries are cleared before any destructors are called. This
-also means that destructors can vivify entries in the glob. So perl tries
+also means that destructors can vivify entries in the glob.  So perl tries
 again and, if the entries are re-created too many times, dies with a
 'panic: gp_free...' error message.
 
@@ -3490,20 +3728,34 @@ again and, if the entries are re-created too many times, dies with a
 
 =item *
 
-What has become known as the "Unicode Bug" is mostly resolved in this release.
-Under C<use feature 'unicode_strings'>, the internal storage format of a
-string no longer affects the external semantics.  There are two known
-exceptions.  User-defined case changing functions, which are planned to
-be deprecated in 5.14, require utf8-encoded strings to function; and the
-character C<LATIN SMALL LETTER SHARP S> in regular expression
-case-insensitive matching has a somewhat different set of bugs depending
-on the internal storage format.  Case-insensitive matching of all
-characters that have multi-character matches, as this one does, is
-problematical in Perl [perl #58182].
+What has become known as the "Unicode Bug" is almost completely resolved in
+this release.  Under C<use feature 'unicode_strings'> (which is
+automatically selected by C<use 5.012> and above), the internal
+storage format of a string no longer affects the external semantics.
+[perl #58182].
+
+There are two known exceptions:
+
+=over
+
+=item 1
+
+The now-deprecated user-defined case changing
+functions require utf8-encoded strings to function.  The CPAN module
+L<Unicode::Casing> has been written to replace this feature, without its
+drawbacks, and the feature is scheduled to be removed in 5.16.
+
+=item 2
+
+C<quotemeta> (and its in-line equivalent C<\Q>) also can give different
+results if a string is encoded in UTF-8 or not.  See
+L<perlunicode/The "Unicode Bug">.
+
+=back
 
 =item *
 
-The handling of Unicode non-characters has changed.
+The handling of Unicode non-character code points has changed.
 Previously they were mostly considered illegal, except that only one of
 the 66 of them was known about in places.  The Unicode standard
 considers them legal, but forbids the "open interchange" of them.
@@ -3513,6 +3765,43 @@ This is part of the change to allow the internal use of any code point
 
 =item *
 
+Case-insensitive C<"/i"> regular expression matching of Unicode
+characters which match multiple characters now works much more as
+intended.  For example
+
+ "\N{LATIN SMALL LIGATURE FFI}" =~ /ffi/ui
+
+and
+
+ "ffi" =~ /\N{LATIN SMALL LIGATURE FFI}/ui
+
+are both true.  Previously, there were many bugs with this feature.
+What hasn't been fixed are the places where the pattern contains the
+multiple characters, but the characters are split up by other things,
+such as in
+
+ "\N{LATIN SMALL LIGATURE FFI}" =~ /(f)(f)i/ui
+
+or
+
+ "\N{LATIN SMALL LIGATURE FFI}" =~ /ffi*/ui
+
+or
+
+ "\N{LATIN SMALL LIGATURE FFI}" =~ /[a-f][f-m][g-z]/ui
+
+None of these match.
+
+Also, this matching doesn't fully conform to the current Unicode
+standard, which asks that the matching be made upon the NFD
+(Normalization Form .ecomposed) of the text.  However, as of this
+writing, March 2010, the Unicode standard is currently in flux about
+what they will recommend doing with regard to such cases.  It may be
+that they will throw out the whole concept of multi-character matches.
+[perl #71736].
+
+=item *
+
 Naming a deprecated character in \N{...} no longer leaks memory.
 
 =item *
@@ -3596,6 +3885,10 @@ by C<splice @ISA> are respected by method calls) [perl #78400].
 In-memory files created by C<open $fh, 'E<gt>' \$buffer> were not calling
 FETCH/STORE at all [perl #43789] (5.12.2).
 
+=item *
+
+utf8::is_utf8 now respects get-magic (e.g. $1) (5.12.1).
+
 =back
 
 =item *
@@ -3659,14 +3952,10 @@ name was not tainted.
 
 =item *
 
-C<sprintf> now dies when passed a tainted scalar for the format. It did
+C<sprintf> now dies when passed a tainted scalar for the format.  It did
 already die for arbitrary expressions, but not for simple scalars
 [perl #82250].
 
-=item *
-
-utf8::is_utf8 now respects get-magic (e.g. $1) (5.12.1).
-
 =back
 
 =head2 The Debugger
@@ -3702,8 +3991,8 @@ already have values when $^P is assigned to [perl #72422].
 
 C<#line> directives in string evals were not properly updating the arrays
 of lines of code (C<< @{"_<..."} >>) that the debugger (or any debugging or
-profiling module) uses. In threaded builds, they were not being updated at
-all. In non-threaded builds, the line number was ignored, so any change to
+profiling module) uses.  In threaded builds, they were not being updated at
+all.  In non-threaded builds, the line number was ignored, so any change to
 the existing line number would cause the lines to be misnumbered
 [perl #79442].
 
@@ -3729,8 +4018,9 @@ Creating a new thread when directory handles were open used to cause a
 crash, because the handles were not cloned, but simply passed to the new
 thread, resulting in a double free.
 
-Now directory handles are cloned properly, on systems that have a C<fchdir>
-function. On other systems, new threads simply do not inherit directory
+Now directory handles are cloned properly, on Windows
+and on systems that have a C<fchdir> function.  On other
+systems, new threads simply do not inherit directory
 handles from their parent threads [perl #75154].
 
 =item *
@@ -3746,7 +4036,8 @@ separator), had the wrong reference count in child threads.
 =item *
 
 Perl now does a timely cleanup of SVs that are cloned into a new thread but
-then discovered to be orphaned (i.e., their owners are I<not> cloned). This
+then discovered to be orphaned (i.e., their
+owners are I<not> cloned).  This
 eliminates several "scalars leaked" warnings when joining threads.
 
 =back
@@ -3817,7 +4108,7 @@ they were blocked before by C<POSIX::sigprocmask> [perl #82040].
 =item *
 
 A signal handler called within a signal handler could cause leaks or
-double-frees.  Now fixed. [perl #76248].
+double-frees.  Now fixed [perl #76248].
 
 =back
 
@@ -3835,7 +4126,7 @@ L<substr()|perlfunc/"substr EXPR,OFFSET,LENGTH,REPLACEMENT">,
 L<pos()|perlfunc/"index STR,SUBSTR,POSITION">, L<keys()|perlfunc/"keys HASH">,
 and L<vec()|perlfunc/"vec EXPR,OFFSET,BITS"> could, when used in combination
 with lvalues, result in leaking the scalar value they operate on, and cause its
-destruction to happen too late. This has now been fixed.
+destruction to happen too late.  This has now been fixed.
 
 =item *
 
@@ -4012,7 +4303,7 @@ The ref types in the typemap for XS bindings now support magical variables
 =item *
 
 C<sv_catsv_flags> no longer calls C<mg_get> on its second argument (the
-source string) if the flags passed to it do not include SV_GMAGIC. So it
+source string) if the flags passed to it do not include SV_GMAGIC.  So it
 now matches the documentation.
 
 =item *
@@ -4124,6 +4415,12 @@ You can now use the C<keys>, C<values>, C<each> builtin functions on arrays
 This is actually a change introduced in perl 5.12.0, but it was missed from
 that release's perldelta.
 
+=head2 C<split> and C<@_>
+
+C<split> no longer modifies C<@_> when called in scalar or void context.
+In void context it now produces a "Useless use of split" warning.
+This was also a perl 5.12.0 changed which missed the perldelta.
+
 =head1 Obituary
 
 Randy Kobes, creator of the kobesearch alternative to search.cpan.org and