This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta for 54b7cb3
[perl5.git] / pod / perldelta.pod
index 957a479..a5346f0 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.21.2
+perldelta - what is new for perl v5.21.3
 
 =head1 DESCRIPTION
 
-This document describes differences between the 5.21.1 release and the 5.21.2
+This document describes differences between the 5.21.2 release and the 5.21.3
 release.
 
-If you are upgrading from an earlier release such as 5.21.0, first read
-L<perl5211delta>, which describes differences between 5.21.0 and 5.21.1.
+If you are upgrading from an earlier release such as 5.21.1, first read
+L<perl5212delta>, which describes differences between 5.21.1 and 5.21.2.
 
 =head1 Notice
 
@@ -45,6 +45,12 @@ XXX For a release on a stable branch, this section aspires to be:
 
 [ List each incompatible change as a =head2 entry ]
 
+=head2 S<C<use UNIVERSAL '...'>> is now a fatal error
+
+Importing functions from C<UNIVERSAL> has been deprecated since v5.12, and
+is now a fatal error.  S<C<"use UNIVERSAL">> without any arguments is still
+allowed.
+
 =head1 Deprecations
 
 XXX Any deprecated features, syntax, modules etc. should be listed here.
@@ -119,15 +125,37 @@ XXX
 
 =item *
 
-L<Math::BigInt> has been upgraded from version 1.9995 to 1.9996.
+L<B::Debug> has been upgraded from version 1.19 to 1.21
+
+=item *
+
+L<CPAN::Meta::Requirements> has been upgraded from version 2.125 to 2.126.
+
+=item *
+
+L<ExtUtils::Manifest> has been upgraded from version 1.64 to 1.65.
+
+The MANIFEST is now opened with C<:raw>, to prevent C<CRLF>s leaking in.
+
+=item *
+
+L<perl5db.pl> has been upgraded from version 1.45 to 1.46.
 
-Correct handling of subclasses.
-L<[cpan #96254]|https://rt.cpan.org/Ticket/Display.html?id=96254>
-L<[cpan #96329]|https://rt.cpan.org/Ticket/Display.html?id=96329>
+Fixed the scope level handling of the debugger's C<y> command.
 
 =item *
 
-L<Module::CoreList> has been upgraded from version 5.021001_1 to 5.021002.
+L<POSIX> has been upgraded from version 1.41 to 1.42.
+
+Replaced the thread-unsafe code used to prevent duplicate warning
+messages for using the isxxx() functions.  [perl #122476]
+
+=item *
+
+L<Socket> has been upgraded from version 2.014 to 2.015.
+
+Test suite updates, particularly useful for Solaris and cygwin, and
+a slight change to the pattern used for IPv4 address matching.
 
 =back
 
@@ -200,7 +228,48 @@ XXX L<message|perldiag/"message">
 
 =item *
 
-XXX L<message|perldiag/"message">
+L<Hexadecimal float: exponent overflow|perldiag/"Hexadecimal float: exponent overflow">
+
+(W overflow) The hexadecimal floating point has larger exponent
+than the floating point supports.
+
+=item *
+
+L<Hexadecimal float: exponent underflow|perldiag/"Hexadecimal float: exponent underflow">
+
+(W overflow) The hexadecimal floating point has smaller exponent
+than the floating point supports.
+
+=item *
+
+L<Hexadecimal float: internal error|perldiag/"Hexadecimal float: internal error">
+
+(F) Something went horribly bad in hexadecimal float handling.
+
+=item *
+
+L<Hexadecimal float: mantissa overflow|perldiag/"Hexadecimal float: mantissa overflow">
+
+(W overflow) The hexadecimal floating point literal had more bits in
+the mantissa (the part between the 0x and the exponent, also known as
+the fraction or the significand) than the floating point supports.
+
+=item *
+
+L<Hexadecimal float: precision loss|perldiag/"Hexadecimal float: precision loss">
+
+(W overflow) The hexadecimal floating point had internally more
+digits than could be output.  This can be caused by unsupported
+long double formats, or by 64-bit integers not being available
+(needed to retrieve the digits under some configurations).
+
+=item *
+
+L<Hexadecimal float: unsupported long double format|perldiag/"Hexadecimal float: unsupported long double format">
+
+(F) You have configured Perl to use long doubles but
+the internals of the long double format are unknown,
+therefore the hexadecimal float output is impossible.
 
 =back
 
@@ -248,7 +317,7 @@ L</Platform Support> section, instead.
 
 =item *
 
-XXX
+Internal handling of floating point values has been improved.
 
 =back
 
@@ -331,12 +400,11 @@ well.
 
 =item *
 
-The following private API functions had their context parameter removed,
-C<Perl_cast_ulong>,  C<Perl_cast_i32>, C<Perl_cast_iv>,    C<Perl_cast_uv>,
-C<Perl_cv_const_sv>, C<Perl_mg_find>,  C<Perl_mg_findext>, C<Perl_mg_magical>,
-C<Perl_mini_mktime>, C<Perl_my_dirfd>, C<Perl_sv_backoff>, C<Perl_utf8_hop>.
-
-Users of the public API prefix-less calls remain unaffected.
+Added L<perlapi/sync_locale>.
+Changing the program's locale should be avoided by XS code.  Nevertheless,
+certain non-Perl libraries called from XS, such as C<Gtk> do so.  When this
+happens, Perl needs to be told that the locale has changed.  Use this function
+to do so, before returning to Perl.
 
 =back
 
@@ -351,7 +419,15 @@ files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
 
 =item *
 
-XXX
+Failing to compile C<use Foo> in an eval could leave a spurious
+C<BEGIN> subroutine definition, which would produce a "Subroutine
+BEGIN redefined" warning on the next use of C<use>, or other C<BEGIN>
+block.  [perl #122107]
+
+=item *
+
+C<method { BLOCK } ARGS> syntax now correctly parses the arguments if they
+begin with an opening brace.  [perl #46947]
 
 =back
 
@@ -391,7 +467,7 @@ here.
 
 XXX Generate this with:
 
-  perl Porting/acknowledgements.pl v5.21.1..HEAD
+  perl Porting/acknowledgements.pl v5.21.2..HEAD
 
 =head1 Reporting Bugs