This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perldelta for #112966/2c5f48c251e
[perl5.git] / pod / perldelta.pod
index 8e0791a..f275297 100644 (file)
@@ -5,16 +5,16 @@
 [ 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.17.1
+perldelta - what is new for perl v5.17.2
 
 =head1 DESCRIPTION
 
-This document describes differences between the 5.17.0 release and
-the 5.17.1 release.
+This document describes differences between the 5.17.1 release and
+the 5.17.2 release.
 
-If you are upgrading from an earlier release such as 5.16.0, first read
-L<perl5170delta>, which describes differences between 5.16.0 and
-5.17.0.
+If you are upgrading from an earlier release such as 5.17.0, first read
+L<perl5171delta>, which describes differences between 5.17.0 and
+5.17.1.
 
 =head1 Notice
 
@@ -28,18 +28,6 @@ here, but most should go in the L</Performance Enhancements> section.
 
 [ List each enhancement as a =head2 entry ]
 
-=head2 More CORE:: subs
-
-Several more built-in functions have been added as subroutines to the
-CORE:: namespace, namely, those non-overridable keywords that can be
-implemented without custom parsers: C<defined>, C<delete>, C<exists>,
-C<glob>, C<pos>, C<protoytpe>, C<scalar>, C<split>, C<study>, C<undef>,
-
-As some of these have prototypes, C<prototype('CORE::...')> has been
-changed not to make a distinction between overridable and non-overridable
-keywords.  This is to make C<prototype('CORE::pos')> consistent with
-C<prototype(&CORE::pos)>.
-
 =head1 Security
 
 XXX Any security-related notices go here.  In particular, any security
@@ -56,13 +44,7 @@ XXX For a release on a stable branch, this section aspires to be:
     If any exist, they are bugs, and we request that you submit a
     report.  See L</Reporting Bugs> below.
 
-=head2 C<\N{BELL}> now refers to U+1F514 instead of U+0007
-
-Unicode 6.0 reused the name "BELL" for a different code point than it
-traditionally had meant.  Since Perl v5.14, use of this name still
-referred to U+0007, but would raise a deprecated warning.  Now, "BELL"
-refers to U+1F514, and the name for U+0007 is "ALERT".  All the
-functions in L<charnames> have been correspondingly updated.
+[ List each incompatible change as a =head2 entry ]
 
 =head1 Deprecations
 
@@ -115,58 +97,22 @@ XXX
 
 =item *
 
-L<ExtUtils::CBuilder> has been upgraded from version 0.280206 to 0.280208.
-
-Manifest files are now correctly embedded for those versions of VC++ which
-make use of them.
-
-=item *
-
-L<B> has been upgraded from version 1.35 to 1.36.
-
-C<B::COP::stashlen> has been replaced with C<B::COP::stashoff>.
-
-C<B::COP::stashpv> now supports UTF8 package names and embedded nulls.
-
-=item *
-
-L<ExtUtils::CBuilder> has been upgraded from version 0.280206 to 0.280208.
-
-It no longer fails when trying to embed manifests on Windows
-[perl #111782, #111798].
-
-=item *
-
-L<File::DosGlob> has been upgraded from version 1.07 to 1.08.
-
-There are no visible changes, only minor internal refactorings.
-
-=item *
-
-L<File::Spec::Unix> has been upgraded from version 3.39_02 to 3.39_03.
-
-C<abs2rel> could produce incorrect results when given two relative paths or
-the root directory twice [perl #111510].
-
-=item *
-
-L<IO> has been upgraded from version 1.25_06 to 1.25_07.
-
-C<sync()> can now be called on read-only file handles [perl #64772].
-
-=item *
-
-L<Pod::Html> has been upgraded from version 1.15_02 to 1.16.
+L<File::stat> has been upgraded from version 1.06 to 1.07.
 
-The option C<--libpods> has been re-instated. It is deprecated, and its use
-does nothing other than issue a warning that it is no longer supported.
+Previously C<File::stat>'s overloaded C<-x> and C<-X> operators did not give
+the correct results for directories or executable files when running as
+root. They had been treating executable permissions for root just like for
+any other user, performing group membership tests I<etc> for files not owned
+by root. They now follow the correct Unix behaviour - for a directory they
+are always true, and for a file if any of the three execute permission bits
+are set then they report that root can execute the file. Perl's builtin
+C<-x> and C<-X> operators have always been correct.
 
 =item *
 
-L<Unicode::UCD> has been upgraded from version 0.43 to 0.44.
+L<Tie::StdHandle> has been upgraded from version 4.2 to 4.3.
 
-This adds a function L<all_casefolds()|Unicode::UCD/all_casefolds()>
-that returns all the casefolds.
+C<READ> now respects the offset argument to C<read> [perl #112826].
 
 =back
 
@@ -236,7 +182,10 @@ XXX Newly added diagnostic messages go here
 
 =item *
 
-XXX L<message|perldiag/"message">
+L<Group name must start with a non-digit word character in regex; marked by <-- HERE in m/%s/|perldiag/"Group name must start with a non-digit word character in regex; marked by <-- HERE in m/%s/">
+
+This error has been added for C<(?&0)>, which is invalid.  It used to
+produce an incomprehensible error message [perl #101666].
 
 =back
 
@@ -246,7 +195,12 @@ XXX L<message|perldiag/"message">
 
 =item *
 
-XXX L<message|perldiag/"message">
+C<chr()> now warns when passed a negative value [perl #83048].
+
+=item *
+
+C<srand()> now warns when passed a value that doesn't fit in a C<UV> (since the
+value will be truncated rather than overflowing) [perl #40605].
 
 =back
 
@@ -262,22 +216,6 @@ XXX Describe change here
 
 =back
 
-=head2 Removals of Diagnostics
-
-=over 4
-
-=item *
-
-The "Runaway prototype" warning that occurs in bizarre cases has been
-removed as being unhelpful and inconsistent.
-
-=item *
-
-The "Not a format reference" error has been removed, as the only case in
-which it could be triggered was a bug.
-
-=back
-
 =head1 Utility Changes
 
 XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go
@@ -310,7 +248,20 @@ L</Platform Support> section, instead.
 
 =item *
 
-XXX
+Building perl with some Windows compilers used to fail due to a problem
+with miniperl's C<glob> operator (which uses the C<perlglob> program)
+deleting the PATH environment variable [perl #113798].
+
+=item *
+
+C<delete local> no longer crashes with certain magical arrays and hashes
+[perl #112966].
+
+=item *
+
+C<local> on elements of certain magical arrays and hashes used not to
+arrange to have the element deleted on scope exit, even if the element did
+not exist before C<local>.
 
 =back
 
@@ -375,10 +326,9 @@ L</Modules and Pragmata> section.
 
 =over 4
 
-=item Win32
+=item XXX-some-platform
 
-C<link> on Win32 now attempts to set C<$!> to more appropriate values
-based on the Win32 API error code. [perl #112272]
+XXX
 
 =back
 
@@ -394,16 +344,7 @@ be noted as well.
 
 =item *
 
-The C<study> function was made a no-op in 5.16.  It was simply disabled via
-a C<return> statement; the code was left in place.  Now the code supporting
-what C<study> used to do has been removed.
-
-=item *
-
-Under threaded perls, there is no longer a separate PV allocated for every
-COP to store its package name (C<< cop->stashpv >>).  Instead, there is an
-offset (C<< cop->stashoff >>) into the new C<PL_stashpad> array, which
-holds stash pointers.
+XXX
 
 =back
 
@@ -419,106 +360,70 @@ L</Modules and Pragmata>.
 
 =item *
 
-Perl now works as well as can be expected on all releases of Unicode so
-far.  In v5.16, it worked on Unicodes 6.0 and 6.1, but there were
-various bugs for earlier releases; the older the release the more
-problems.
-
-=item *
-
-C<vec> no longer produces "uninitialized" warnings in lvalue context
-[perl #9423].
-
-=item *
-
-An optimisation involving fixed strings in regular expressions could cause
-a severe performance penalty in edge cases.  This has been fixed
-[perl #76546].
+A regression introduced in v5.14.0 has been fixed, in which some calls
+to the C<re> module would clobber C<$_>.
 
 =item *
 
-The "Can't find an opnumber" message that C<prototype> produces when passed
-a string like "CORE::nonexistent_keyword" is now passes UTF8 and embedded
-nulls through unchanged [perl #97478].
+C<do FILE> now always either sets or clears C<$@>, even when the file can't be
+read. This ensures that testing C<$@> first (as recommended by the
+documentation) always returns the correct result.
 
 =item *
 
-C<prototype> now treats magical variables like C<$1> the same way as
-non-magical variables when checking for the CORE:: prefix, instead of
-treating them as subroutine names.
+The array iterator used for the C<each @array> construct is now correctly
+reset when C<@array> is cleared (RT #75596). This happens for example when the
+array is globally assigned to, as in C<@array = (...)>, but not when its
+B<values> are assigned to. In terms of the XS API, it means that C<av_clear()>
+will now reset the iterator.
 
-=item *
-
-Under threaded perls, a run-time code block in a regular expression could
-corrupt the package name stored in the op tree, resulting in bad reads
-in C<caller>, and possibly crashes [perl #113060].
-
-=item *
-
-Referencing a closure prototype (C<\&{$_[1]}> in an attribute handler for a
-closure) no longer results in a copy of the subroutine (or assertion
-failures on debugging builds).
+This mirrors the behaviour of the hash iterator when the hash is cleared.
 
 =item *
 
-C<eval '__PACKAGE__'> now returns the right answer on threaded builds if
-the current package has been assigned over (as in
-C<*ThisPackage:: = *ThatPackage::>) [perl #78742].
+C<< $class->can >>, C<< $class->isa >>, and C<< $class->DOES >> now return
+correct results, regardless of whether that package referred to by C<$class>
+exists [perl #47113].
 
 =item *
 
-If a package is deleted by code that it calls, it is possible for C<caller>
-to see a stack frame belonging to that deleted package.  C<caller> could
-crash if the stash's memory address was reused for a scalar and a
-substitution was performed on the same scalar [perl #113486].
+Arriving signals no longer clear C<$@> [perl #45173].
 
 =item *
 
-C<UNIVERSAL::can> no longer treats its first argument differently
-depending on whether it is a string or number internally.
+Allow C<my ()> declarations with an empty variable list [perl #113554].
 
 =item *
 
-C<open> with "<&" for the mode checks to see whether the third argument is
-a number, in determining whether to treat it as a file descriptor or a
-handle name.  Magical variables like C<$1> were always failing the numeric
-check and being treated as handle names.
+During parsing, subs declared after errors no longer leave stubs
+[perl #113712].
 
 =item *
 
-C<warn>'s handling of magical variables (C<$1>, ties) has undergone several
-fixes.  FETCH is only called once now on a tied argument or a tied C<$@>
-[perl #97480].  Tied variables returning objects that stringify as "" are
-no longer ignored.  A tied C<$@> that happened to return a reference the
-I<previous> time is was used is no longer ignored.
+Closures containing no string evals no longer hang on to their containing
+subroutines, allowing variables closed over by outer subroutines to be
+freed when the outer sub is freed, even if the inner sub still exists
+[perl #89544].
 
 =item *
 
-Numeric operators on magical variables (e.g., S<C<$1 + 1>>) used to use
-floating point operations even where integer operations were more appropriate, resulting in loss of accuracy on 64-bit platforms
-[perl #109542].
+Duplication of in-memory filehandles by opening with a "<&=" or ">&=" mode
+stopped working properly in 5.16.0.  It was causing the new handle to
+reference a different scalar variable.  This has been fixed [perl #113764].
 
 =item *
 
-Unary negation no longer treats a string as a number if the string happened
-to be used as a number some time.  So, if $x contains the string "dogs",
-C<-$x> returns "-dogs" even if C<$y=0+$x> has happened at some point.
-
-=item *
-
-In Perl 5.14, C<-'-10'> was fixed to return "10", not "+10".  But magical
-variables (C<$1>, ties) were not fixed till now [perl #57706].
+C<qr//> expressions no longer crash with custom regular expression engines
+that do not set C<offs> at regular expression compilation time
+[perl #112962].
 
 =back
 
 =head1 Known Problems
 
 XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any
-tests that had to be C<TODO>ed for the release would be noted here, unless
-they were specific to a particular platform (see below).
-
-This is a list of some significant unfixed bugs, which are regressions
-from either 5.XXX.XXX or 5.XXX.XXX.
+tests that had to be C<TODO>ed for the release would be noted here. Unfixed
+platform specific bugs also go here.
 
 [ List each fix as a =item entry ]
 
@@ -539,7 +444,7 @@ here.
 
 XXX Generate this with:
 
-  perl Porting/acknowledgements.pl v5.17.0..HEAD
+  perl Porting/acknowledgements.pl v5.17.1..HEAD
 
 =head1 Reporting Bugs