Apply perldelta suggestions and comments from Karl Williamson

Co-authored-by: Karl Williamson <[email protected]>

Author: book

pod/perldelta.pod

@@ -87,7 +87,7 @@ invoking the code block.
 The feature flags enabling those keywords have been named
 L<C<keyword_any>|feature/"The 'keyword_any' feature">
 and L<C<keyword_all>|feature/"The 'keyword_all' feature">
-to avoid confusion with to the ability of the C<feature> module
+to avoid confusion with the ability of the C<feature> module
 to refer to all of its features by using the C<:all>
 export tag.  [L<GH #23104|https://github.com/Perl/perl5/issues/23104>]
 
@@ -132,7 +132,7 @@ package visibility.  See L<perlclass> for more detail.
 
 Along with the ability to declare methods lexically, this release also permits
 invoking a lexical subroutine as if it were a method, bypassing the usual
-name-based method resolution by name.
+name-based method resolution.
 
 Combined with lexical method declaration, these two new abilities create the
 effect of having private methods.
@@ -146,7 +146,7 @@ retroactively declared experimental.  Over the years, proposals to fix or
 supplement the features have come and gone.
 
 They were deprecated in Perl v5.38.0 and scheduled for removal in
-Perl v5.42.0. After some discussion their removal has been indefinitely
+Perl v5.42.0. After extensive discussion their removal has been indefinitely
 postponed. Using them no longer produces a deprecation warning.
 
 Switch itself still requires the C<switch> feature, which is enabled
@@ -213,6 +213,10 @@ C<S_do_trans_invmap()> can overflow the destination pointer C<d>.
 It is believed that this vulnerability can enable Denial of Service or
 Arbitrary Code Execution attacks on platforms that lack sufficient defenses.
 
+The patch to fix this issue (87f42aa0e0096e9a346c9672aa3a0bd3bef8c1dd)
+is applicable to all perls that are vulnerable, including those
+out-of-support.
+
 Discovered by: Nathan Mills.
 
 =head1 Incompatible Changes
@@ -534,6 +538,7 @@ All forms of C<gv_fetchmeth()> are now documented together.
 =item *
 
 C<gv_autoload4> is now documented with C<gv_autoload_pv> and additional notes added.
+The long C<Perl_> forms are now listed when available.
 
 =back
 
@@ -819,7 +824,7 @@ made:
 =item *
 
 A new F<t/run/todo.t> test script was added as a place for TODO tests
-for known unfixed bugs.
+for known unfixed bugs. Patches are welcome to add to this file.
 
 =item *
 
@@ -957,14 +962,6 @@ relevant additions to L<perlguts|perlguts/"Custom Operators">.
 
 =item *
 
-Enable removing most of F<mathoms.c> and stub functions [L<GH #22691|https://github.com/Perl/perl5/issues/22691>] and [L<GH #22714|https://github.com/Perl/perl5/issues/22714>].
-
-=item *
-
-C<pp_reverse>: don't COW buffer just to then un-COW it. [L<GH #22729|https://github.com/Perl/perl5/issues/22729>]
-
-=item *
-
 New API functions are introduced to convert strings encoded in UTF-8 to
 their ordinal code point equivalent.  These are safe to use by default,
 and generally more convenient to use than the existing ones.
@@ -1116,22 +1113,6 @@ not C<'0'>.
 
 =item *
 
-L<C<open>|perlfunc/open> automatically creates an anonymous temporary file when
-passed C<undef> as a filename:
-
-    open(my $fh, "+>", undef) or die ...
-
-Due to the way this feature was implemented, it would also trigger for
-non-existent elements of arrays or hashes:
-
-    open(my $fh, "+>", $hash{no_such_key}) or die ...
-    # unexpectedly succeeds and creates a temp file
-
-Now a temporary file is only created if a literal C<undef> is passed.
-[L<GH #22385|https://github.com/Perl/perl5/issues/22385>]
-
-=item *
-
 Compound assignment operators return lvalues that can be further modified:
 
     ($x &= $y) += $z;
@@ -1141,7 +1122,7 @@ Compound assignment operators return lvalues that can be further modified:
 
 However, the separate numeric/string bitwise operators provided by L<the
 C<bitwise> feature|feature/The 'bitwise' feature>, C<< &= ^= |= &.= ^.= |.= >>,
-did not do so:
+did not return such lvalues:
 
     use feature qw(bitwise);
     ($x &= $y) += $z;
@@ -1219,7 +1200,7 @@ with a misaligned access early in the build. [L<GH #22577|https://github.com/Per
 =item *
 
 On threaded builds on POSIX-like systems, if the perl signal handler
-receives we now resend the signal to the main perl thread.  Previously
+receives a signal, we now resend the signal to the main perl thread.  Previously
 this would crash.  [GH #22487]
 
 =item *
@@ -1346,7 +1327,7 @@ This has now been fixed, and runs as expected. ([L<GH #23064|https://github.com/
 
 L<perlfunc/readline> now clears the error flag if an error occurs when
 reading and that error is C<EAGAIN> or C<EWOULDBLOCK>.  This allows
-old code that depended on C<readline> to clear all errors to ignore
+code that depended on C<readline> to clear all errors to ignore
 these relatively harmless errors.  [L<GH #22883|https://github.com/Perl/perl5/issues/22883>]
 
 =item *