From d394c985cd6b93d920219735886d7cf537f1a6b0 Mon Sep 17 00:00:00 2001
From: Graham Knop
Date: Wed, 25 Oct 2023 14:08:49 +0200
Subject: [PATCH] update perldelta for release
---
pod/perldelta.pod | 355 +++++++++-------------------------------------
1 file changed, 69 insertions(+), 286 deletions(-)
diff --git a/pod/perldelta.pod b/pod/perldelta.pod
index b8dfd80736d2..a1886921dfd3 100644
--- a/pod/perldelta.pod
+++ b/pod/perldelta.pod
@@ -2,9 +2,6 @@
=head1 NAME
-[ 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.39.4
=head1 DESCRIPTION
@@ -15,110 +12,14 @@ release.
If you are upgrading from an earlier release such as 5.39.2, first read
L, which describes differences between 5.39.2 and 5.39.3.
-=head1 Notice
-
-XXX Any important notices here
-
-=head1 Core Enhancements
-
-XXX New core language features go here. Summarize user-visible core language
-enhancements. Particularly prominent performance optimisations could go
-here, but most should go in the L section.
-
-[ List each enhancement as a =head2 entry ]
-
-=head1 Security
-
-XXX Any security-related notices go here. In particular, any security
-vulnerabilities closed should be noted here rather than in the
-L section.
-
-[ List each security issue as a =head2 entry ]
-
-=head1 Incompatible Changes
-
-XXX For a release on a stable branch, this section aspires to be:
-
- There are no changes intentionally incompatible with 5.XXX.XXX
- If any exist, they are bugs, and we request that you submit a
- report. See L below.
-
-[ List each incompatible change as a =head2 entry ]
-
-=head1 Deprecations
-
-XXX Any deprecated features, syntax, modules etc. should be listed here.
-
-=head2 Module removals
-
-XXX Remove this section if not applicable.
-
-The following modules will be removed from the core distribution in a
-future release, and will at that time need to be installed from CPAN.
-Distributions on CPAN which require these modules will need to list them as
-prerequisites.
-
-The core versions of these modules will now issue C<"deprecated">-category
-warnings to alert you to this fact. To silence these deprecation warnings,
-install the modules in question from CPAN.
-
-Note that these are (with rare exceptions) fine modules that you are encouraged
-to continue to use. Their disinclusion from core primarily hinges on their
-necessity to bootstrapping a fully functional, CPAN-capable Perl installation,
-not usually on concerns over their design.
-
-=over
-
-=item XXX
-
-XXX Note that deprecated modules should be listed here even if they are listed
-as an updated module in the L section.
-
-=back
-
-[ List each other deprecation as a =head2 entry ]
-
-=head1 Performance Enhancements
-
-XXX Changes which enhance performance without changing behaviour go here.
-There may well be none in a stable release.
-
-[ List each enhancement as an =item entry ]
-
-=over 4
-
-=item *
-
-XXX
-
-=back
-
=head1 Modules and Pragmata
-XXX All changes to installed files in F, F, F and F
-go here. If Module::CoreList is updated, generate an initial draft of the
-following sections using F. A paragraph summary
-for important changes should then be added by hand. In an ideal world,
-dual-life modules would have a F file that could be cribbed.
-
-The list of new and updated modules is modified automatically as part of
-preparing a Perl release, so the only reason to manually add entries here is if
-you're summarising the important changes in the module update. (Also, if the
-manually-added details don't match the automatically-generated ones, the
-release manager will have to investigate the situation carefully.)
-
-[ Within each section, list entries as an =item entry ]
-
=head2 New Modules and Pragmata
=over 4
=item *
-XXX Remove this section if Porting/corelist-perldelta.pl did not add any content here.
-
-=item *
-
L 0.000156 has been added to the Perl core.
This distribution contains a comprehensive set of test tools for writing unit
@@ -140,34 +41,46 @@ This module is a dependency of L.
=item *
-L has been upgraded from version 1.77 to 1.78.
+L has been upgraded from version 1.84 to 1.85.
-Made parsing of the C command arguments saner. [GH #21350]
+It now documents the C<:all> feature bundle, and suggests a reason why you may
+not wish to use it.
-=back
+=item *
-=head2 Removed Modules and Pragmata
+L now accepts a version bundle as an input argument, requesting it to
+import all of the functions that are considered a stable part of the module at
+the given Perl version. For example:
-=over 4
+ use builtin ':5.40';
=item *
-XXX Remove this section if Porting/corelist-perldelta.pl did not add any content here.
+L has been upgraded from version 2.15 to 2.16.
-=back
+The C function now works correctly on 32-bit platforms even if the
+platform's C type is larger than 32 bits. [L]
-=head1 Documentation
+The C and C typemap entries have been fixed so they work with
+any variable name, rather than just the hardcoded C and C.
-XXX Changes to files in F go here. Consider grouping entries by
-file and be sure to link to the appropriate page, e.g. L.
+The mappings for C, C, C, C and C have
+been updated to be integer types; previously they were C floating-point.
-=head2 New Documentation
+=item *
-XXX Changes which create B files in F go here.
+L has been upgraded from version 1.77 to 1.78.
-=head3 L
+Made parsing of the C command arguments saner.
+[L]
+
+=item *
-XXX Description of the purpose of the new file here
+L has been upgraded from version 5.20230920 to 5.20231020.
+
+=back
+
+=head1 Documentation
=head2 Changes to Existing Documentation
@@ -175,208 +88,98 @@ We have attempted to update the documentation to reflect the changes
listed in this document. If you find any we have missed, open an issue
at L.
-XXX Changes which significantly change existing files in F go here.
-However, any changes to F should go in the L
-section.
-
Additionally, the following selected changes have been made:
-=head3 L
+=head3 L
=over 4
=item *
-XXX Description of the change here
+Removed statement suggesting C
is a no-op.
=back
-=head1 Diagnostics
-
-The following additions or changes have been made to diagnostic output,
-including warnings and fatal error messages. For the complete list of
-diagnostic messages, see L.
-
-XXX New or changed warnings emitted by the core's C code go here. Also
-include any changes in L that reconcile it to the C code.
-
-=head2 New Diagnostics
-
-XXX Newly added diagnostic messages go under here, separated into New Errors
-and New Warnings
-
-=head3 New Errors
+=head3 L
=over 4
=item *
-XXX L
+Several internal functions now have documentation - the various C
+functions, C, C, C and similar.
=back
-=head3 New Warnings
-
-=over 4
-
-=item *
-
-XXX L
+=head1 Diagnostics
-=back
+The following additions or changes have been made to diagnostic output,
+including warnings and fatal error messages. For the complete list of
+diagnostic messages, see L.
-=head2 Changes to Existing Diagnostics
+=head2 New Diagnostics
-XXX Changes (i.e. rewording) of diagnostic messages go here
+=head3 New Errors
=over 4
=item *
-XXX Describe change here
-
-=back
-
-=head1 Utility Changes
-
-XXX Changes to installed programs such as F and F go here.
-Most of these are built within the directory F.
+L
-[ List utility changes as a =head2 entry for each utility and =item
-entries for each change
-Use L with program names to get proper documentation linking. ]
-
-=head2 L
-
-=over 4
+(F) You attempted to C