This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Supply missing right brace in regex example
[perl5.git] / pod / perldelta.pod
index 255f99c..6dfb854 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.31.2
+perldelta - what is new for perl v5.31.4
 
 =head1 DESCRIPTION
 
-This document describes differences between the 5.31.1 release and the 5.31.2
+This document describes differences between the 5.31.3 release and the 5.31.4
 release.
 
-If you are upgrading from an earlier release such as 5.31.0, first read
-L<perl5311delta>, which describes differences between 5.31.0 and 5.31.1.
+If you are upgrading from an earlier release such as 5.31.2, first read
+L<perl5313delta>, which describes differences between 5.31.2 and 5.31.3.
 
 =head1 Notice
 
@@ -27,6 +27,15 @@ here, but most should go in the L</Performance Enhancements> section.
 
 [ List each enhancement as a =head2 entry ]
 
+=head2 Now can dump compiled patterns before optimization
+
+This is primarily useful for tracking down bugs in the regular
+expression compiler.  This dump happens on C<-DDEBUGGING> perls, if you
+specify C<-Drv> on the command line; or on any perl if the pattern is
+compiled within the scope of S<C<use re qw(Debug DUMP_PRE_OPTIMIZE)>> or
+S<C<use re qw(Debug COMPILE EXTRA)>>.  (All but the 2nd case display
+other information as well.)
+
 =head1 Security
 
 XXX Any security-related notices go here.  In particular, any security
@@ -218,12 +227,7 @@ XXX Changes (i.e. rewording) of diagnostic messages go here
 
 =item *
 
-C<\N{} here is restricted to one character> is now emitted in the same
-circumstances where previously C<\N{} in inverted character class or as
-a range end-point is restricted to one character> was.
-
-This is due to new circumstances having been added in perl v5.30 that
-weren't covered by the earlier wording.
+XXX Describe change here
 
 =back
 
@@ -259,10 +263,7 @@ L</Platform Support> section, instead.
 
 =item *
 
-The C<ECHO> macro is now defined.  This is used in a C<dtrace> rule
-that was originally changed for FreeBSD, and the FreeBSD make
-apparently predefines it.  The Solaris make does not predefine C<ECHO>
-which broke this rule on Solaris.  [perl #134218]
+XXX
 
 =back
 
@@ -338,14 +339,9 @@ L</Modules and Pragmata> section.
 
 =over 4
 
-=item Linux
-
-C<cc> will be used to populate C<plibpth> if C<cc> is C<clang>.  [perl
-#134189]
-
-=item VMS
+=item XXX-some-platform
 
-C<-Duse64bitint> is now the default on VMS.
+XXX
 
 =back
 
@@ -361,23 +357,7 @@ well.
 
 =item *
 
-The PERL_DESTRUCT_LEVEL environment variable was formerly only honored on
-perl binaries built with DEBUGGING support. It is now checked on all perl
-builds. Its normal use is to force perl to individually free every block
-of memory which it has allocated before exiting, which is useful when
-using automated leak detection tools such as valgrind.
-
-=item *
-
-The API eval_sv() now accepts a C<G_RETHROW> flag.  If this flag is
-set and an exception is thrown while compiling or executing the
-supplied code, it will be rethrown, and eval_sv() will not return.
-[perl #134177]
-
-=item *
-
-As part of the fix for [perl #2754] perl_parse() now returns non-zero
-if exit(0) is called in a C<BEGIN>, C<UNITCHECK> or C<CHECK> block.
+XXX
 
 =back
 
@@ -392,22 +372,11 @@ files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
 
 =item *
 
-Parsing incomplete hex or binary literals was changed in 5.31.1 to
-treat such a literal as just the 0, leaving the following C<x> or C<b>
-to be parsed as part of the next token.  This could lead to some
-silent changes in behaviour, so now incomplete hex or binary literals
-produce a fatal error.  [perl #134125]
-
-=item *
-
-eval_pv()'s I<croak_on_error> flag will now throw even if the
-exception is a false overloaded value.  [perl #134177]
-
-=item *
-
-C<INIT> blocks and the program itself are no longer run if exit(0) is
-called within a C<BEGIN>, C<UNITCHECK> or C<CHECK> block.  [perl
-#2754]
+Perl no longer treats strings starting with "0x" or "0b" as hex or
+binary numbers respectively when converting a string to a number.
+This reverts a change in behaviour inadvertently introduced in perl
+5.30.0 intended to improve precision when converting a string to a
+floating point number. [perl #134230]
 
 =back
 
@@ -447,7 +416,7 @@ died, add a short obituary here.
 
 XXX Generate this with:
 
-  perl Porting/acknowledgements.pl v5.31.1..HEAD
+  perl Porting/acknowledgements.pl v5.31.3..HEAD
 
 =head1 Reporting Bugs