This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta for 31b6f23ed55c
[perl5.git] / pod / perldelta.pod
index 368de39..452c8a5 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.23.8
+perldelta - what is new for perl v5.25.2
 
 =head1 DESCRIPTION
 
-This document describes differences between the 5.23.7 release and the 5.23.8
+This document describes differences between the 5.25.1 release and the 5.25.2
 release.
 
-If you are upgrading from an earlier release such as 5.23.6, first read
-L<perl5237delta>, which describes differences between 5.23.6 and 5.23.7.
+If you are upgrading from an earlier release such as 5.25.0, first read
+L<perl5251delta>, which describes differences between 5.25.0 and 5.25.1.
 
 =head1 Notice
 
@@ -27,12 +27,23 @@ here, but most should go in the L</Performance Enhancements> section.
 
 [ List each enhancement as a =head2 entry ]
 
-=head2 More fields provided to C<sigaction> callback with C<SA_SIGINFO>
+=head2 Perl can now do default collation in UTF-8 locales on platforms
+that support it
 
-When passing the C<SA_SIGINFO> flag to L<sigaction|POSIX/sigaction>, the
-C<errno>, C<status>, C<uid>, C<pid>, C<addr> and C<band> fields are now
-included in the hash passed to the handler, if supported by the
-platform.
+Some platforms natively do a reasonable job of collating and sorting in
+UTF-8 locales.  Perl now works with those.  For portability and full
+control, L<Unicode::Collate> is still recommended, but now you may
+not need to do anything special to get good-enough results, depending on
+your application.  See
+L<perllocale/Category C<LC_COLLATE>: Collation: Text Comparisons and Sorting>
+
+=head2 Better locale collation of strings containing embedded C<NUL>
+characters
+
+In locales that have multi-level character weights, these are now
+ignored at the higher priority ones.  There are still some gotchas in
+some strings, though.  See
+L<perllocale/Collation of strings containing embedded C<NUL> characters>.
 
 =head1 Security
 
@@ -42,6 +53,25 @@ L</Selected Bug Fixes> section.
 
 [ List each security issue as a =head2 entry ]
 
+=head2 C<-Di> switch is now required for PerlIO debugging output
+
+Previously PerlIO debugging output would be sent to the file specified
+by the C<PERLIO_DEBUG> environment variable if perl wasn't running
+setuid and the C<-T> or C<-t> switches hadn't been parsed yet.
+
+If perl performed output at a point where it hadn't yet parsed its
+switches this could result in perl creating or overwriting the file
+named by C<PERLIO_DEBUG> even when the C<-T> switch had been supplied.
+
+Perl now requires the C<-Di> switch to produce PerlIO debugging
+output.  By default this is written to C<stderr>, but can optionally
+be redirected to a file by setting the C<PERLIO_DEBUG> environment
+variable.
+
+If perl is running setuid or the C<-T> switch has supplied
+C<PERLIO_DEBUG> is ignored and the debugging output is sent to
+C<stderr> as for any other C<-D> switch.
+
 =head1 Incompatible Changes
 
 XXX For a release on a stable branch, this section aspires to be:
@@ -130,10 +160,7 @@ L<XXX> has been upgraded from version A.xx to B.yy.
 
 =item *
 
-L<POSIX> has been upgraded from version 1.59 to 1.60.
-
-It can now export constants for the C<code> value in the hash passed to the
-L<sigaction|POSIX/sigaction> handler when using the C<SA_SIGINFO> flag.
+L<Module::CoreList> has been upgraded from 5.20160520 to 5.20160620.
 
 =back
 
@@ -196,6 +223,10 @@ and New Warnings
 
 =item *
 
+L<Version control conflict marker|perldiag/"Version control conflict marker">
+
+=item *
+
 XXX L<message|perldiag/"message">
 
 =back
@@ -254,7 +285,9 @@ L</Platform Support> section, instead.
 
 =item *
 
-XXX
+F<make_ext.pl> no longer updates a module's F<pm_to_blib> file when no
+files require updates.  This could cause dependencies, F<perlmain.c>
+in particular, to be rebuilt unnecessarily.  [perl #126710]
 
 =back
 
@@ -274,14 +307,6 @@ that they represent may be covered elsewhere.
 
 XXX
 
-=item *
-
-The GNU Make makefile for Win32 now supports parallel builds.  [perl #126632]
-
-=item *
-
-You can now build perl with MSVC++ on Win32 using GNU Make.  [perl #126632]
-
 =back
 
 =head1 Platform Support
@@ -327,10 +352,9 @@ L</Modules and Pragmata> section.
 
 =over 4
 
-=item Win32
+=item XXX-some-platform
 
-Builds using Microsoft Visual C++ 2003 and earlier no longer produce
-an "INTERNAL COMPILER ERROR" message.  [perl #126045]
+XXX
 
 =back
 
@@ -346,7 +370,8 @@ well.
 
 =item *
 
-XXX
+Perl no longer panics when switching into some locales on machines with
+buggy C<strxfrm()> implementations in their libc. [perl #121734]
 
 =back
 
@@ -361,13 +386,8 @@ files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
 
 =item *
 
-Line numbers larger than 2**31-1 but less than 2**32 are no longer
-returned by caller() as negative numbers.  [perl #126991]
-
-=item *
-
-C<< unless ( I<assignment> ) >> now properly warns when syntax
-warnings are enabled.  [perl #127122]
+C< until ($x = 1) { ... } > and C< ... until $x = 1 > now properly
+warn when syntax warnings are enabled.  [perl #127333]
 
 =back
 
@@ -407,7 +427,7 @@ here.
 
 XXX Generate this with:
 
-  perl Porting/acknowledgements.pl v5.23.7..HEAD
+  perl Porting/acknowledgements.pl v5.25.1..HEAD
 
 =head1 Reporting Bugs
 
@@ -421,15 +441,10 @@ included with your release.  Be sure to trim your bug down to a tiny but
 sufficient test case.  Your bug report, along with the output of C<perl -V>,
 will be sent off to perlbug@perl.org to be analysed by the Perl porting team.
 
-If the bug you are reporting has security implications, which make it
-inappropriate to send to a publicly archived mailing list, then please send it
-to perl5-security-report@perl.org.  This points to a closed subscription
-unarchived mailing list, which includes all the core committers, who will be
-able to help assess the impact of issues, figure out a resolution, and help
-co-ordinate the release of patches to mitigate or fix the problem across all
-platforms on which Perl is supported.  Please only use this address for
-security issues in the Perl core, not for modules independently distributed on
-CPAN.
+If the bug you are reporting has security implications which make it
+inappropriate to send to a publicly archived mailing list, then see
+L<perlsec/SECURITY VULNERABILITY CONTACT INFORMATION>
+for details of how to report the issue.
 
 =head1 SEE ALSO