This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta for e9d373c4
[perl5.git] / pod / perldelta.pod
index 4f69f7e..f0d4886 100644 (file)
@@ -5,15 +5,15 @@
 [ this is a template for a new perldelta file.  Any text flagged as XXX needs
 to be processed before release. ]
 
-perldelta - what is new for perl v5.19.4
+perldelta - what is new for perl v5.19.5
 
 =head1 DESCRIPTION
 
-This document describes differences between the 5.19.3 release and the 5.19.4
+This document describes differences between the 5.19.4 release and the 5.19.5
 release.
 
-If you are upgrading from an earlier release such as 5.19.2, first read
-L<perl5193delta>, which describes differences between 5.19.2 and 5.19.3.
+If you are upgrading from an earlier release such as 5.19.3, first read
+L<perl5194delta>, which describes differences between 5.19.3 and 5.19.4.
 
 =head1 Notice
 
@@ -27,26 +27,45 @@ here, but most should go in the L</Performance Enhancements> section.
 
 [ List each enhancement as a =head2 entry ]
 
-=head2 rand() now uses a consistent random number generator
+=head2 Unicode 6.3 now supported
 
-Previously perl would use a platform specific random number generator,
-varying between the libc C<rand()>, C<random()> or C<drand48()>.
+Perl now supports and is shipped with Unicode 6.3 (though Perl may be
+recompiled with any previous Unicode release as well).  A detailed list of
+Unicode 6.3 changes is at L<http://www.unicode.org/versions/Unicode6.3.0/>.
 
-This meant that the quality of perl's random numbers would vary from
-platform to platform, from the 15 bits of C<rand()> on Win32 to
-48-bits on POSIX platforms such as Linux with C<drand48()>.
+=head2 Experimental Postfix Dereferencing
 
-Perl now uses its own internal C<drand48()> implementation on all
-platforms.  [perl #115928]
+When the C<postderef> feature is in effect, the following syntactical
+equivalencies are set up:
 
-=head2 Better 64-bit support
+  $sref->$*;  # same as ${ $sref }  # interpolates
+  $aref->@*;  # same as @{ $aref }  # interpolates
+  $href->%*;  # same as %{ $href }
+  $cref->&*;  # same as &{ $cref }
+  $gref->**;  # same as *{ $gref }
 
-On 64-bit platforms, the internal array functions now use 64-bit offsets,
-allowing Perl arrays to hold more than 2**31 elements, if you have the
-memory available.
+  $gref->*{ $slot }; # same as *{ $gref }{ $slot }
 
-The regular expression engine now supporst strings longer than 2**31
-characters.  [perl #112790, #116907]
+  $aref->@[ ... ];  # same as @$aref[ ... ]  # interpolates
+  $href->@{ ... };  # same as @$href{ ... }  # interpolates
+  $aref->%[ ... ];  # same as %$aref[ ... ]
+  $href->%{ ... };  # same as %$href{ ... }
+
+Those marked as interpolating only interpolate if the associated
+C<postderef_qq> feature is also enabled.  This feature is B<experimental> and
+will trigger C<experimental::postderef>-category warnings when used, unless
+they are suppressed.
+
+For more information, consult L<the Postfix Dereference Syntax section of
+perlref|perlref/Postfix Dereference Syntax>.
+
+=head2 C<sub>s now take a C<prototype> attribute
+
+When declaring or defining a C<sub>, the prototype can now be specified inside
+of a C<prototype> attribute instead of in parens following the name.
+
+For example, C<sub foo($$){}> could be rewritten as
+C<sub foo : prototype($$){}>.
 
 =head1 Security
 
@@ -58,23 +77,18 @@ L</Selected Bug Fixes> section.
 
 =head1 Incompatible Changes
 
-=head2 Locale decimal point character no longer leaks outside of
-S<C<use locale>> scope (with the exception of C<$!>)
+XXX For a release on a stable branch, this section aspires to be:
+
+    There are no changes intentionally incompatible with 5.XXX.XXX
+    If any exist, they are bugs, and we request that you submit a
+    report.  See L</Reporting Bugs> below.
 
-This is actually a bug fix, but some code has come to rely on the bug being
-present, so this change is listed here.  The current locale that the program is
-running under is not supposed to be visible to Perl code except within the
-scope of a S<C<use locale>>.  However, until now under certain circumstances,
-the character used for a decimal point (often a comma) leaked outside the
-scope.
+[ List each incompatible change as a =head2 entry ]
 
-This continues the work released in Perl 5.19.1.  It turns out that that did
-not catch all the leaks, including C<printf> and C<sprintf> not respecting
-S<C<use locale>>.  If your code is affected by this change, simply add a
-S<C<use locale>>.
+=head2 Functions C<PerlIO_vsprintf> and C<PerlIO_sprintf> have been removed
 
-Now, the only known place where C<'use locale'> is not respected is in the
-stringification of L<$!|perlvar/$!>.
+These two functions, undocumented, unused in CPAN, and problematic have been
+removed.
 
 =head1 Deprecations
 
@@ -109,12 +123,18 @@ as an updated module in the L</Modules and Pragmata> section.
 
 =head1 Performance Enhancements
 
+XXX Changes which enhance performance without changing behaviour go here.
+There may well be none in a stable release.
+
+[ List each enhancement as a =item entry ]
+
 =over 4
 
 =item *
 
-The trie performance enhancement for regular expressions has now been extended
-to those compiled under C</iaa>.
+Perl has an optimizer for regular expression patterns.  It analyzes the pattern
+to find things such as the minimum length a string has to be to match, etc.  It
+now better handles code points that are above the Latin1 range.
 
 =back
 
@@ -146,338 +166,168 @@ XXX
 
 =item *
 
-L<autodie> has been upgraded from version 2.20 to 2.21.
-
-Numerous improvements have been made, many speed-related.  See the F<Changes>
-file in the CPAN distribution for full details.
-
-=item *
-
-L<B> has been upgraded from version 1.45 to 1.46.
-
-The fix for [perl #118525] introduced a regression in the behaviour of
-C<B::CV::GV>, changing the return value from a C<B::SPECIAL> object on a
-C<NULL> C<CvGV> to C<undef>.  C<B::CV::GV> again returns a C<B::SPECIAL>
-object in this case. [perl #119351]
-
-=item *
-
-L<B::Concise> has been upgraded from version 0.98 to 0.99.
-
-The handling of the C<glob> operator, broken since Perl 5.17.6, has been fixed.
-
-=item *
-
-L<Carp> has been upgraded from version 1.31 to 1.32.
-
-=over 4
-
-=item *
-
-In stack traces, subroutine arguments that are strings are now quoted in a
-consistent manner, regardless of what characters they contain and how they're
-internally represented.
-
-=item *
-
-C<Carp> now won't vivify the C<overload::StrVal> glob or subroutine or the
-C<overload> stash.
-
-=item *
-
-C<Carp> now avoids some unwanted Unicode warnings on older Perls.  This doesn't
-affect behaviour with current Perl.
-
-=item *
-
-C<Carp::Heavy> detects version mismatch with C<Carp>, to give a good error
-message if a current (stub) C<Carp::Heavy> gets loaded by an old C<Carp> that
-expects C<Carp::Heavy> to provide subroutines.
+L<attributes> has been upgraded from version 0.21 to 0.22.
 
-=back
+Support has been added for the C<prototype> attribute.
 
 =item *
 
-L<charnames> has been upgraded from version 1.38 to 1.39.
-
-This module now works on EBCDIC platforms.
-
-=item *
-
-L<CPAN::Meta> has been upgraded from version 2.132140 to 2.132510.
+L<autodie> has been upgraded from version 2.21 to 2.22.
 
 No changes have been made to the installed code other than the version bump to
 keep in sync with the latest CPAN release.
 
 =item *
 
-L<CPAN::Meta::Requirements> has been upgraded from version 2.122 to 2.123.
+L<CPAN::Meta> has been upgraded from version 2.132620 to 2.132830.
 
-No changes have been made to the installed code other than the version bump to
-keep in sync with the latest CPAN release.
+L<CPAN::Meta::Prereqs> now has a C<merged_requirements> method for combining
+requirements across multiple phases and types, and an invalid 'meta-spec' is no
+longer a fatal error.
 
 =item *
 
-L<Data::Dumper> has been upgraded from version 2.148 to 2.149.
-
-This upgrade is part of a larger change to make the array interface 64-bit safe
-by using SSize_t instead of I32 for array indices.
-
-In addition, an EBCDIC fix has been applied.
-
-=item *
-
-L<Devel::Peek> has been upgraded from version 1.13 to 1.14.
-
-This upgrade is part of a larger change to preserve referential identity when
-passing C<undef> to a subroutine by using NULL rather than &PL_sv_undef for
-nonexistent array elements.
-
-In addition, C<Dump> with no args was broken in Perl 5.19.3, but has now been
-fixed.
-
-=item *
-
-L<DynaLoader> has been upgraded from version 1.19 to 1.20.
-
-The documentation now makes it clear, as has always been the case, that
-C<dl_unload_file> is only called automatically to unload all loaded shared
-objects if the perl interpreter was built with the C macro
-DL_UNLOAD_ALL_AT_EXIT defined.  Support for GNU DLD has also been removed.
-
-=item *
-
-L<Encode> has been upgraded from version 2.52 to 2.55.
-
-An erroneous early return in C<decode_utf8> has been removed, and a bug in
-C<_utf8_on> under COW has been fixed.  Encode also now uses L<parent> rather
-than L<base> throughout.
-
-=item *
-
-L<Exporter> has been upgraded from version 5.69 to 5.70.
-
-A number of typos have been corrected in the documentation.
-
-=item *
-
-L<ExtUtils::CBuilder> has been upgraded from version 0.280205 to 0.280212.
-
-No changes have been made to the installed code other than the version bump to
-keep in sync with the latest CPAN release.
-
-=item *
-
-L<ExtUtils::Command> has been upgraded from version 1.17 to 1.18.
-
-No changes have been made to the installed code other than the version bump to
-keep in sync with the latest CPAN release.
-
-=item *
-
-L<ExtUtils::MakeMaker> has been upgraded from version 6.72 to 6.76.
-
-Numerous updates and bug fixes are incorporated.  See the F<Changes> file for
-full details.
-
-=item *
-
-L<ExtUtils::ParseXS> has been upgraded from version 3.21 to 3.22.
+L<CPAN::Meta::Requirements> has been upgraded from version 2.123 to 2.125.
 
 No changes have been made to the installed code other than the version bump to
 keep in sync with the latest CPAN release.
 
 =item *
 
-L<File::Find> has been upgraded from version 1.24 to 1.25.
+L<CPAN::Meta::YAML> has been upgraded from version 0.008 to 0.010.
 
-Better diagnostics are now provided in the case of a failed C<chdir>.
+No material changes have been made to the installed code other than the version
+bump to keep in sync with the latest CPAN release.
 
 =item *
 
-L<File::Glob> has been upgraded from version 1.20 to 1.21.
+L<Cwd> has been upgraded from version 3.44 to 3.45.
 
-C<glob()> now warns in the context of C<use warnings "syscalls";> if the
-supplied pattern has an internal NUL (C<"\0">) character.
+An obsolete #define has been removed from the XS code.
 
 =item *
 
-L<HTTP::Tiny> has been upgraded from version 0.034 to 0.035.
+L<ExtUtils::Install> has been upgraded from version 1.60 to 1.61.
 
-Encoded data from C<post_form> now preserves term order if data is provided as
-an array reference.  (They are still sorted for consistency if provided as a
-hash reference.)
+Some POD formatting errors in the documentation have been corrected.
 
 =item *
 
-L<I18N::LangTags> has been upgraded from version 0.39 to 0.40.
+L<ExtUtils::MakeMaker> has been upgraded from version 6.76 to 6.80.
 
-Bosnian has now joined Croatian and Serbian in the lists of mutually
-intelligible Slavic languages. [perl #72594]
+Numerous updates and bug fixes are incorporated.  See the F<Changes> file for
+full details.
 
 =item *
 
-L<IO> has been upgraded from version 1.28 to 1.29.
+L<feature> has been upgraded from version 1.33 to 1.34.
 
-A minor internals-only change has been made to the XS code.
+The new features C<postderef> and C<postderef_qq> have been added.
 
 =item *
 
-L<IPC::Open3> has been upgraded from version 1.15 to 1.16.
+L<File::Fetch> has been upgraded from version 0.42 to 0.44.
 
-This upgrade is part of a larger change to preserve referential identity when
-passing C<undef> to a subroutine by using NULL rather than &PL_sv_undef for
-nonexistent array elements.
+No changes have been made to the installed code other than the version bump to
+keep in sync with the latest CPAN release.
 
 =item *
 
-L<Locale::Codes> has been upgraded from version 3.26 to 3.27.
+L<File::Glob> has been upgraded from version 1.21 to 1.22.
 
-New codes have been added and the (deprecated) set of FIPS-10 country codes has
-been removed.
+Since Perl 5.16, code that used C<glob> inside a thread had been
+unintentionally sharing state between threads.  This has now been fixed.  [perl
+#119897/#117823]
 
 =item *
 
-L<Math::BigInt> has been upgraded from version 1.9992 to 1.9993.
+L<File::Temp> has been upgraded from version 0.2301 to 0.2304.
 
-Cleaned up the L<Math::BigInt> and L<Math::BigFloat> documentation to be more
-consistent with other perl documentation. [perl #86686]
-
-Added a bint() method for rounding towards zero. [perl #85296]
+Required versions of other modules used are now listed more explicitly, L<base>
+is now used instead of L<parent>, and L<Exporter> is no longer inherited from.
 
 =item *
 
-L<Math::BigInt::FastCalc> has been upgraded from version 0.30 to 0.31.
+L<Getopt::Long> has been upgraded from version 2.41 to 2.42.
 
-This upgrade is part of a larger change to make the array interface 64-bit safe
-by using SSize_t instead of I32 for array indices.
+The floating point specifier C<name=f> no longer erroneously accepts values
+like 1.2.3.  [cpan #88707]
 
 =item *
 
-L<Module::CoreList> has been upgraded from version 2.97 to 2.98.
+L<HTTP::Tiny> has been upgraded from version 0.035 to 0.036.
 
-The list of Perl versions covered has been updated.
+No changes have been made to the installed code other than the version bump to
+keep in sync with the latest CPAN release.
 
 =item *
 
-L<Module::Load::Conditional> has been upgraded from version 0.54 to 0.58.
+L<List::Util> has been upgraded from version 1.32 to 1.34.
 
-C<requires> has been made more robust. [cpan #83728]
+The list reduction functions C<any>, C<all>, C<none> and C<notall> have been
+added.
 
 =item *
 
-L<Module::Metadata> has been upgraded from version 1.000014 to 1.000018.
+L<Module::CoreList> has been upgraded from version 2.99 to 3.00.
 
-The module's DESCRIPTION has been re-worded regarding safety/security to
-satisfy CVE-2013-1437.  Also, versions are now detainted if needed. [cpan
-#88576]
+The list of Perl versions covered has been updated, %delta is now exported, and
+a bug in C<is_core> whereby it wrongly assumed a linear list of releases has
+been fixed.
 
 =item *
 
-L<mro> has been upgraded from version 1.13 to 1.14.
+L<Module::Metadata> has been upgraded from version 1.000018 to 1.000019.
 
-This upgrade is part of a larger change to make the array interface 64-bit safe
-by using SSize_t instead of I32 for array indices.
+Warnings are now disabled during version evaluation.
 
 =item *
 
-L<parent> has been upgraded from version 0.226 to 0.227.
+L<Parse::CPAN::Meta> has been upgraded from version 1.4407 to 1.4409.
 
 No changes have been made to the installed code other than the version bump to
 keep in sync with the latest CPAN release.
 
 =item *
 
-L<Parse::CPAN::Meta> has been upgraded from version 1.4405 to 1.4407.
+L<Perl::OSType> has been upgraded from version 1.005 to 1.006.
 
 No changes have been made to the installed code other than the version bump to
 keep in sync with the latest CPAN release.
 
 =item *
 
-L<Perl::OSType> has been upgraded from version 1.003 to 1.005.
-
-The Unix OSType 'bitrig' has been added.
-
-=item *
-
-L<perlfaq> has been upgraded from version 5.0150043 to 5.0150044.
-
-The use of C<gensym> in a number of examples has been removed, the use of C<&>
-in subroutine calls is now clarified and several new questions have been
-answered.
-
-=item *
-
-L<re> has been upgraded from version 0.25 to 0.26.
+The podlators modules have been upgraded from version 2.5.1 to 2.5.3.
 
-A function signature has been corrected in the XS implementation.
+Numerous updates and bug fixes are incorporated.  See the F<Changes> file in
+the CPAN distribution for full details.
 
 =item *
 
-L<Scalar::Util> has been upgraded from version 1.31 to 1.32.
+L<Test::Harness> has been upgraded from version 3.28 to 3.29.
 
-The documentation of C<blessed> has been improved to mention the fact that
-package "0" is defined but false.
+All modules now use C<our> rather than C<use vars>, have C<use warnings>
+enabled and C<use parent> instead of @ISA.
 
 =item *
 
-L<Socket> has been upgraded from version 2.011 to 2.012.
+L<threads> has been upgraded from version 1.87 to 1.89.
 
-Syntax errors when building on the WinCE platform have been fixed. [cpan #87389]
+The documentation of C<alarm> and C<_handle> has been updated.
 
 =item *
 
-L<Storable> has been upgraded from version 2.46 to 2.47.
+L<Unicode::Normalize> has been upgraded from version 1.16 to 1.17.
 
-This upgrade is part of a larger change to preserve referential identity when
-passing C<undef> to a subroutine by using NULL rather than &PL_sv_undef for
-nonexistent array elements.
+The module now C<die>s if it cannot get Unicode code points using C<unpack>.
+(There is already a similar C<die> if Unicode code points cannot be stringified
+using C<pack>.)
 
 =item *
 
-L<Term::ReadLine> has been upgraded from version 1.10 to 1.14.
-
-Term::ReadLine::EditLine support has been added.
-
-=item *
-
-L<Time::Piece> has been upgraded from version 1.22 to 1.23.
-
-Day of year parsing (like "%y%j") has been fixed.
-
-=item *
-
-L<Unicode::Collate> has been upgraded from version 0.98 to 0.99.
-
-By default, out-of-range values are replaced with C<U+FFFD> (REPLACEMENT
-CHARACTER) when C<UCA_Version> E<gt>= 22, or ignored when C<UCA_Version> E<lt>=
-20.  When C<UCA_Version> E<gt>= 22, the weights of out-of-range values can be
-overridden.
-
-=item *
+L<warnings> has been upgraded from version 1.19 to 1.20.
 
-L<Unicode::UCD> has been upgraded from version 0.53 to 0.54.
-
-This module now works on EBCDIC platforms.
-
-=item *
-
-L<version> has been upgraded from version 0.9903 to 0.9904.
-
-No changes have been made to the installed code other than the version bump to
-keep in sync with the latest CPAN release.
-
-=item *
-
-L<warnings> has been upgraded from version 1.18 to 1.19.
-
-The C<syscalls> warnings category has been added to check for embedded NUL
-(C<"\0">) characters in pathnames and string arguments to other system calls.
-
-=item *
-
-L<XS::Typemap> has been upgraded from version 0.10 to 0.11.
+The new warnings category C<experimental::postderef> has been added.
 
 =back
 
@@ -510,13 +360,35 @@ XXX Changes which significantly change existing files in F<pod/> go here.
 However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
 section.
 
-=head3 L<XXX>
+=head3 L<perlref>
 
 =over 4
 
 =item *
 
-XXX Description of the change here
+Documentation of the new postfix dereference syntax has been added.
+
+=back
+
+=head3 L<perlreguts>
+
+=over 4
+
+=item *
+
+The documentation has been updated in the light of recent changes to
+F<regcomp.c>.
+
+=back
+
+=head3 L<perlvar>
+
+=over 4
+
+=item *
+
+Three L<English> variable names which have long been documented but do not
+actually exist have been removed from the documentation.
 
 =back
 
@@ -550,41 +422,48 @@ XXX L<message|perldiag/"message">
 
 =item *
 
-L<Invalid \0 character in %s for %s: %s\0%s|perldiag/"Invalid \0 character in %s for %s: %s\0%s">
+L<Attribute prototype(%s) discards earlier prototype attribute in same sub|perldiag/"Attribute prototype(%s) discards earlier prototype attribute in same sub">
 
-(W syscalls) Embedded \0 characters in pathnames or other system call arguments
-produce a warning as of 5.20. The parts after the \0 were formerly ignored by
-system calls.
+(W misc) A sub was declared as sub foo : prototype(A) : prototype(B) {}, for
+example.  Since each sub can only have one prototype, the earlier
+declaration(s) are discarded while the last one is applied.
 
-=back
+=item *
 
-=head2 Changes to Existing Diagnostics
+L<Postfix dereference is experimental|perldiag/"Postfix dereference is experimental">
 
-XXX Changes (i.e. rewording) of diagnostic messages go here
+(S experimental::postderef) This warning is emitted if you use the experimental
+postfix dereference syntax.  Simply suppress the warning if you want to use the
+feature, but know that in doing so you are taking the risk of using an
+experimental feature which may change or be removed in a future Perl version:
 
-=over 4
+    no warnings "experimental::postderef";
+    use feature "postderef", "postderef_qq";
+    $ref->$*;
+    $aref->@*;
+    $aref->@[@indices];
+    ... etc ...
 
 =item *
 
-Warnings and errors from the regexp engine are now UTF-8 clean
+L<Prototype '%s' overridden by attribute 'prototype(%s)' in %s|perldiag/"Prototype '%s' overridden by attribute 'prototype(%s)' in %s">
 
-=item *
+(W prototype) A prototype was declared in both the parentheses after the sub
+name and via the prototype attribute.  The prototype in parentheses is useless,
+since it will be replaced by the prototype from the attribute before it's ever
+used.
 
-The "Unknown switch condition" error message has some slight changes.
-This error triggers when there is an unknown condition in a (?(foo))
-conditional; The error message used to read:
+=back
+
+=head2 Changes to Existing Diagnostics
 
-    Unknown switch condition (?(%s in regex;
+XXX Changes (i.e. rewording) of diagnostic messages go here
 
-But what %s could be was mostly up to luck; For (?(foobar)), you
-might've seen "fo" or "f".  For Unicode characters, you'd generally
-get a corrupted string.
-The message was changed to read:
+=over 4
 
-    Unknown switch condition (?(...)) in regex;
+=item *
 
-And additionally, the '<-- HERE' marker in the error will now point
-to the correct spot in the regex.
+XXX Describe change here
 
 =back
 
@@ -597,13 +476,13 @@ Most of these are built within the directories F<utils> and F<x2p>.
 entries for each change
 Use L<XXX> with program names to get proper documentation linking. ]
 
-=head3 L<find2perl>
+=head3 L<XXX>
 
 =over 4
 
 =item *
 
-L<find2perl> now handles C<?> wildcards correctly. [perl #113054]
+XXX
 
 =back
 
@@ -620,15 +499,7 @@ L</Platform Support> section, instead.
 
 =item *
 
-The F<Makefile.PL> for C<SDBM_File> now generates a better F<Makefile>, which
-avoids a race condition during parallel makes, which could cause the build to
-fail.  This is the last known parallel make problem (on *nix platforms), and
-therefore we believe that a parallel make should now always be error free.
-
-=for comment
-
-Strictly only for a build where build files such as F<Makefile.SH> have not
-been updated by C<git> in an already configured and built tree.
+XXX
 
 =back
 
@@ -646,23 +517,8 @@ that they represent may be covered elsewhere.
 
 =item *
 
-The test script F<t/bigmem/regexp.t> has been added to test that regular
-expression matches on very large strings now succeed as expected.
-
-=item *
-
-Various cases of C<die>, C<last>, C<goto> and C<exit> triggering C<DESTROY> are
-now tested by the new test script F<t/op/rt119311.t>.
-
-=item *
-
-The new test script F<t/win32/signal.t> tests that C<$!> and C<$^E> are now
-preserved across signal handlers by the Win32 signal emulation code.
-
-=item *
-
-The test script F<t/x2p/find2perl.t> has been added to test the F<find2perl>
-program on platforms where it is practical to do so.
+The new postfix dereference syntax is tested by a new test script,
+F<t/op/postfixderef.t>.
 
 =back
 
@@ -682,9 +538,9 @@ source tree.
 
 =over 4
 
-=item Bitrig
+=item XXX-some-platform
 
-Compile support has been added for Bitrig, a fork of OpenBSD.
+XXX
 
 =back
 
@@ -692,16 +548,11 @@ Compile support has been added for Bitrig, a fork of OpenBSD.
 
 XXX List any platforms that this version of perl no longer compiles on.
 
-Configure hints and conditional code for several very old platforms
-has been removed.  We have not received reports for these in many years,
-typically not since perl-5.6.0.
-
 =over 4
 
-=item AT&T 3b1
+=item XXX-some-platform
 
-Configure support for the 3b1, also known as the AT&T Unix PC (and the
-similar AT&T 7300), has been removed.
+XXX
 
 =back
 
@@ -714,12 +565,9 @@ L</Modules and Pragmata> section.
 
 =over 4
 
-=item WinCE
+=item XXX-some-platform
 
-The building of XS modules has largely been restored. Several still cannot
-(yet) be built but it is now possible to build Perl on WinCE with only a couple
-of further patches (to L<Socket> and L<ExtUtils::MakeMaker>), hopefully to be
-incorporated soon.
+XXX
 
 =back
 
@@ -735,19 +583,7 @@ well.
 
 =item *
 
-The internal representation has changed for the match variables C<$1>, C<$2>
-I<etc.>, C<$`>, C<$&>, C<$'>, C<${^PREMATCH}>, C<${^MATCH}> and
-C<${^POSTMATCH>.  It uses slightly less memory, avoids string comparisons
-and numeric conversions during lookup, and uses 23 fewer lines of C.  This
-change should not affect any external code.
-
-=item *
-
-Arrays now use NULL internally to represent unused slots, instead of
-C<&PL_sv_undef>.  C<&PL_sv_undef> is no longer treated as a special value,
-so C<av_store(av, 0, &PL_sv_undef)> will cause element 0 of that array to
-hold a read-only undefined scalar.  C<$array[0] = anything> will croak and
-C<\$array[0]> will compare equal to C<\undef>.
+XXX
 
 =back
 
@@ -762,100 +598,25 @@ files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
 
 =item *
 
-The value of C<$^E> is now saved across signal handlers on Win32. [perl #85104]
-
-=item *
-
-A lexical filehandle (as in C<open my $fh...>) is usually given a name
-based on the current package and the name of the variable; e.g.,
-"main::$fh".  Under recursion, the filehandle was losing the "$fh" part of
-the name.  This has been fixed.
-
-=item *
-
-Perl 5.19.3 accidentally extended the previous bug to all closures, even
-when not called recursively; i.e., lexical handles in closure would always
-be called "main::" or "MyPackage::" etc.  This has been fixed.
-
-=item *
-
-Uninitialized values returned by XSUBs are no longer exempt from
-uninitialized warnings.  [perl #118693]
-
-=item *
-
-C<elsif ("")> no longer erroneous produces a warning about void context.
-[perl #118753]
-
-=item *
-
-Passing C<undef> to a subroutine now causes @_ to contain the same read-only undefined scalar that C<undef> returns.  Furthermore, C<exists $_[0]> will now return true if C<undef> was the first argument.
-[perl #7508, #109726].
-
-=item *
-
-Passing a nonexistent array element to a subroutine does not usually
-autovivify it unless the subroutine modifies its argument.  This did not
-work correctly with negative indices and with nonexistent elements within
-the array.  The element would be vivified immediately.  The delayed
-vivification has been extended to work with those.  [perl #118691]
-
-=item *
-
-Assigning references or globs to the scalar returned by C<$#foo> after the
-@foo array has been freed no longer causes assertion failures on debugging
-builds and memory leaks on regular builds.
-
-=item *
-
-Perl 5.19.2 threw line numbers off after some cases of line breaks
-following keywords, such as
-
-   1 unless
-   1;
-
-This has been fixed.  [perl #118931]
-
-=item *
-
-On 64-bit platforms, large ranges like 1..1000000000000 no longer crash,
-but eat up all your memory instead.  [perl #119161]
-
-=item *
-
-C<__DATA__> now puts the C<DATA> handle in the right package, even if the
-current package has been renamed through glob assignment.
-
-=item *
-
-The string position set by C<pos> could shift if the string changed
-representation internally to or from utf8.  This could happen, e.g., with
-references to objects with string overloading.
-
-=item *
-
-Taking references to the return values of two C<pos> calls with the same
-argument, and then assigning a reference to one and C<undef> to the other,
-could result in assertion failures or memory leaks.
-
-=item *
-
-Elements of C<@-> and C<@+> now update correctly when they refer to
-nonexistent captures.  Previously, a referenced element (C<$ref = \$-[1]>) 
-could refer to the wrong match after subsequent matches.
+C<last> no longer returns values that the same statement has accumulated so
+far, fixing amongst other things the long-standing bug that C<push @a, last>
+would try to return the @a, copying it like a scalar in the process and
+resulting in the error, "Bizarre copy of ARRAY in last."  [perl #3112]
 
 =item *
 
-When C<die>, C<last>, C<next>, C<redo>, C<goto> and C<exit> unwind the
-scope, it is possible for DESTROY recursively to call a subroutine or
-format that is currently being exited.  It that case, sometimes the lexical
-variables inside the sub would start out having values from the outer call,
-instead of being undefined as they should.  This has been fixed.
-[perl #119311].
+An optimization in Perl 5.18 made incorrect assumptions causing a bad
+interaction with the L<Devel::CallParser> CPAN module.  This was partially
+fixed in Perl 5.19.4, but the fix was not sufficient and another fault has now
+been corrected.
 
 =item *
 
-C<${^MPEN>} is no longer treated as a synonym for C<${^MATCH}>.
+In some cases, closing file handled opened to pipe to or from a process, which
+had been duplicated into a standard handle, would call perl's internal waitpid
+wrapper with a pid of zero.  With the fix for [perl #85228] this zero pid was
+passed to waitpid(), possibly blocking the process.  This wait for process
+zero no longer occurs.  [perl #119893]
 
 =back
 
@@ -884,7 +645,7 @@ here.
 
 XXX Generate this with:
 
-  perl Porting/acknowledgements.pl v5.19.3..HEAD
+  perl Porting/acknowledgements.pl v5.19.4..HEAD
 
 =head1 Reporting Bugs