X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/03b7d2792b10d1f615dd9a9680ffd3cd2f73f584..2e1181e2b05e12b94778d854867841997e321faa:/pod/perldelta.pod

diff --git a/pod/perldelta.pod b/pod/perldelta.pod
index cfe5fa5..089a280 100644
--- a/pod/perldelta.pod
+++ b/pod/perldelta.pod
@@ -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.31.3
+perldelta - what is new for perl v5.31.5
 
 =head1 DESCRIPTION
 
-This document describes differences between the 5.31.2 release and the 5.31.3
+This document describes differences between the 5.31.4 release and the 5.31.5
 release.
 
-If you are upgrading from an earlier release such as 5.31.1, first read
-L<perl5312delta>, which describes differences between 5.31.1 and 5.31.2.
+If you are upgrading from an earlier release such as 5.31.3, first read
+L<perl5314delta>, which describes differences between 5.31.3 and 5.31.4.
 
 =head1 Notice
 
@@ -45,6 +45,24 @@ XXX For a release on a stable branch, this section aspires to be:
 
 [ List each incompatible change as a =head2 entry ]
 
+=head2 Modifiable variables are no longer permitted in constants
+
+Code like:
+
+    my $var;
+    $sub = sub () { $var };
+
+where C<$var> is referenced elsewhere in some sort of modiable context
+now produces an exception when the sub is defined.
+
+This error can be avoided by adding a return to the sub definition:
+
+    $sub = sub () { return $var };
+
+This has been deprecated since perl 5.22.
+
+[perl #131138]
+
 =head1 Deprecations
 
 XXX Any deprecated features, syntax, modules etc. should be listed here.
@@ -125,27 +143,17 @@ XXX Remove this section if not applicable.
 
 =item *
 
-L<Devel::PPPort> has been upgraded from version 3.54 to 3.55.
-
-The test files generated on Win32 are now identical to when they are
-generated on POSIX-like systems.
-
-=item *
-
-L<File::Find> has been upgraded from version 1.36 to 1.37.
-
-On Win32, the tests no longer require either a file in the drive root
-directory, or a writable root directory.
-
-=item *
+L<XXX> has been upgraded from version A.xx to B.yy.
 
-L<Thread> has been upgraded from version 3.04 to 3.05.
+If there was something important to note about this change, include that here.
 
 =item *
 
-L<XXX> has been upgraded from version A.xx to B.yy.
+L<Dumpvalue> has been upgraded from version 1.18 to 1.21.
 
-If there was something important to note about this change, include that here.
+Previously, when dumping elements of an array and encountering an undefined
+value, the string printed would have been C<empty array>.  This has been
+changed to what was apparently originally intended:  C<empty slot>.
 
 =back
 
@@ -184,6 +192,28 @@ section.
 
 Additionally, the following selected changes have been made:
 
+=head3 URLs have been changed to https://, stale links updated
+
+=over 4
+
+=item *
+
+Where applicable, the URLs in the documentation have been moved from
+using the http:// protocol to https:// . This also affects the location
+of the bug tracker at L<https://rt.perl.org>.
+
+=item *
+
+Some links to OS/2 libraries, Address Sanitizer and other system tools
+had gone stale. These have been updated with working links.
+
+=item *
+
+Some links to old mails on perl5-porters had gone stale. These have been
+updated with working links.
+
+=back
+
 =head3 L<XXX>
 
 =over 4
@@ -272,7 +302,9 @@ L</Platform Support> section, instead.
 
 =item *
 
-XXX
+Perl now no longer probes for C<d_u32align>, defaulting to C<define>
+on all platforms.  This check was error prone when it was done, which
+was on 32-bit platforms only.  [perl #133495]
 
 =back
 
@@ -348,9 +380,9 @@ L</Modules and Pragmata> section.
 
 =over 4
 
-=item XXX-some-platform
+=item Windows
 
-XXX
+Support for building perl with Visual C++ 6.0 has now been removed.
 
 =back
 
@@ -366,7 +398,19 @@ well.
 
 =item *
 
-XXX
+Added the C<<PL_curstackinfo->si_cxsubix>> field. This records the stack
+index of the most recently pushed sub/format/eval context.  It is set and
+restored automatically by C<cx_pushsub()>, C<cx_popsub()> etc., but would
+need to be manually managed if you do any unusual manipulation of the
+context stack.
+
+=item *
+
+Various macros dealing with character type classification and changing
+case where the input is encoded in UTF-8 now require an extra parameter
+to prevent potential reads beyond the end of the buffer.  Use of these
+has generated a deprecation warning since 5.26.  Details are in
+L<perldeprecation/In XS code, use of various macros dealing with UTF-8.>
 
 =back
 
@@ -381,8 +425,7 @@ files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
 
 =item *
 
-C<< $@ = 100; die; >> now correctly propagates the 100 as an exception
-instead of ignoring it.  [perl #134291]
+XXX
 
 =back
 
@@ -422,13 +465,13 @@ died, add a short obituary here.
 
 XXX Generate this with:
 
-  perl Porting/acknowledgements.pl v5.31.2..HEAD
+  perl Porting/acknowledgements.pl v5.31.4..HEAD
 
 =head1 Reporting Bugs
 
 If you find what you think is a bug, you might check the perl bug database
 at L<https://rt.perl.org/>.  There may also be information at
-L<http://www.perl.org/>, the Perl Home Page.
+L<https://www.perl.org/>, the Perl Home Page.
 
 If you believe you have an unreported bug, please run the L<perlbug> program
 included with your release.  Be sure to trim your bug down to a tiny but