This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
No longer print experimental::isa warning (closes #18754)
[perl5.git] / pod / perldelta.pod
index 316c027..39261f9 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.35.7
+perldelta - what is new for perl v5.35.9
 
 =head1 DESCRIPTION
 
-This document describes differences between the 5.35.6 release and the 5.35.7
+This document describes differences between the 5.35.8 release and the 5.35.9
 release.
 
-If you are upgrading from an earlier release such as 5.35.5, first read
-L<perl5356delta>, which describes differences between 5.35.5 and 5.35.6.
+If you are upgrading from an earlier release such as 5.35.7, first read
+L<perl5358delta>, which describes differences between 5.35.7 and 5.35.8.
 
 =head1 Notice
 
@@ -27,26 +27,40 @@ here, but most should go in the L</Performance Enhancements> section.
 
 [ List each enhancement as a =head2 entry ]
 
-=head2 builtin Functions
+=head2 @_ is now experimental within signatured subs
 
-A new core module L<builtin> has been added, which provides documentation for
-new always-present functions that are built into the interpreter.
+Even though subroutine signatures currently remain experimental, use of the
+default arguments array (C<@_>) with a subroutine that has a signature is
+specifically also experimental, with its own warning category.  Silencing the
+C<experimental::signatures> warning category is not sufficient to dismiss
+this.  The new warning is emitted with the category name
+C<experimental::args_array_with_signatures>.
 
-    say "Reference type of arrays is ", builtin::reftype([]);
+Any subroutine that has a signature and tries to make use of the defaults
+argument array or an element thereof (C<@_> or C<$_[INDEX]>), either
+explicitly or implicitly (such as C<shift> or C<pop> with no argument) will
+provoke a warning at compile-time:
 
-It also provides a lexical import mechanism for providing short name versions
-of these functions.
+    use experimental 'signatures';
 
-    use builtin 'reftype';
-    say "Reference type of arrays is ", reftype([]);
+    sub f ($x, $y = 123) {
+      say "The first argument is $_[0]";
+    }
 
-An initial set of functions exists to provide convenient access to stable
-boolean values, weakening references, and inspecting properties of references.
+Z<>
 
-This builtin function mechanism and the functions it provides are all
-currently B<experimental>.
+    Use of @_ in array element with signatured subroutine is experimental
+    at file.pl line 4.
 
-For more information, see the L<builtin> module.
+The behaviour of code which attempts to do this is no longer specified, and
+may be subject to change in a future version.
+
+=head2 The C<isa> operator is no longer experimental
+
+Introduced in Perl version 5.32.0, this operator has remained unchanged
+since then. The operator is now considered a stable languauge feature.
+
+For more detail see L<perlop/Class Instance Operator>.
 
 =head1 Security
 
@@ -70,6 +84,39 @@ XXX For a release on a stable branch, this section aspires to be:
 
 XXX Any deprecated features, syntax, modules etc. should be listed here.
 
+=head2 Downgrading a C<use VERSION> statement to below v5.11
+
+Attempting to issue a second C<use VERSION> statement that requests a version
+lower than C<v5.11> when an earlier statement that requested a version at
+least C<v5.11> has already been seen, will now print a deprecation warning.
+
+For example:
+
+    use v5.14;
+    say "The say statement is permitted";
+    use v5.8;                               # This will print a warning
+    print "We must use print\n";
+
+This is because of an intended related change to the interaction between
+C<use VERSION> and C<use strict>. If you specify a version >= 5.11, strict is
+enabled implicitly. If you request a version < 5.11, strict will become
+disabled I<even if you had previously written> C<use strict>. This was not
+the previous behaviour of C<use VERSION>, which at present will track
+explicitly-enabled strictness flags independently.
+
+Code which wishes to mix versions in this manner should use lexical scoping
+with block syntax to ensure that the differently versioned regions remain
+lexically isolated.
+
+    {
+        use v5.14;
+        say "The say statement is permitted";
+    }
+    {
+        use v5.8;                           # No warning is emitted
+        print "We must use print\n";
+    }
+
 =head2 Module removals
 
 XXX Remove this section if not applicable.
@@ -239,7 +286,9 @@ XXX Changes (i.e. rewording) of diagnostic messages go here
 
 =item *
 
-XXX Describe change here
+L<Subroutine %s redefined|perldiag/"Subroutine %s redefined">
+
+Localized subroutine redefinitions no longer trigger this warning.
 
 =back
 
@@ -367,12 +416,12 @@ well.
 
 =over 4
 
-=item * A new phase_name() interface provides access to the name
-for each interpreter phase (i.e., PL_phase value).
-
-=item * The changes in v5.35.5 for how memory for hash iterator state was allocated could cause unbounded memory consumption (until process exit). The bug that caused this has been fixed - memory consumption is now stable, and potentially lower than v5.35.4 and earlier.
+=item *
 
-=for The v5.36.0 perldelta, just drop the paragraph about the bugfix.
+New equality-test functions C<sv_numeq> and C<sv_streq> have been added, along
+with C<..._flags>-suffixed variants.  These expose a simple and consistent API
+to perform numerical or string comparison which is aware of operator
+overloading.
 
 =back
 
@@ -427,7 +476,7 @@ died, add a short obituary here.
 
 XXX Generate this with:
 
-  perl Porting/acknowledgements.pl v5.35.6..HEAD
+  perl Porting/acknowledgements.pl v5.35.8..HEAD
 
 =head1 Reporting Bugs