In perl.git, the branch blead has been updated

<http://perl5.git.perl.org/perl.git/commitdiff/86372193997c576b235ea7dc0e3ceeb9bb1fce1c?hp=b22c1b06a22800628b336f577cd4b6ed0eb4956e>

- Log -----------------------------------------------------------------
commit 86372193997c576b235ea7dc0e3ceeb9bb1fce1c
Author: Abigail <[email protected]>
Date:   Mon Oct 20 20:29:11 2014 +0200

    New perldelta for 5.14.6
-----------------------------------------------------------------------

Summary of changes:
 MANIFEST                                 |   1 +
 Makefile.SH                              |   8 +-
 pod/.gitignore                           |   2 +-
 pod/perl.pod                             |   1 +
 pod/{perldelta.pod => perl5215delta.pod} |   2 +-
 pod/perldelta.pod                        | 605 ++++++++++---------------------
 vms/descrip_mms.template                 |   2 +-
 win32/Makefile                           |   4 +-
 win32/makefile.mk                        |   4 +-
 win32/pod.mak                            |   4 +
 10 files changed, 200 insertions(+), 433 deletions(-)
 copy pod/{perldelta.pod => perl5215delta.pod} (99%)

diff --git a/MANIFEST b/MANIFEST
index 31c59fe..a31d29b 100644
--- a/MANIFEST
+++ b/MANIFEST
@@ -4471,6 +4471,7 @@ pod/perl5211delta.pod             Perl changes in version 
5.21.1
 pod/perl5212delta.pod          Perl changes in version 5.21.2
 pod/perl5213delta.pod          Perl changes in version 5.21.3
 pod/perl5214delta.pod          Perl changes in version 5.21.4
+pod/perl5215delta.pod          Perl changes in version 5.21.5
 pod/perl561delta.pod           Perl changes in version 5.6.1
 pod/perl56delta.pod            Perl changes in version 5.6
 pod/perl581delta.pod           Perl changes in version 5.8.1
diff --git a/Makefile.SH b/Makefile.SH
index 7b1fd5b..db66aeb 100755
--- a/Makefile.SH
+++ b/Makefile.SH
@@ -489,7 +489,7 @@ mini_obj = $(minindt_obj) $(MINIDTRACE_O)
 ndt_obj = $(obj0) $(obj1) $(obj2) $(obj3) $(ARCHOBJS)
 obj = $(ndt_obj) $(DTRACE_O)
 
-perltoc_pod_prereqs = extra.pods pod/perl5215delta.pod pod/perlapi.pod 
pod/perlintern.pod pod/perlmodlib.pod pod/perluniprops.pod
+perltoc_pod_prereqs = extra.pods pod/perl5216delta.pod pod/perlapi.pod 
pod/perlintern.pod pod/perlmodlib.pod pod/perluniprops.pod
 generated_pods = pod/perltoc.pod $(perltoc_pod_prereqs)
 generated_headers = uudmap.h bitcount.h mg_data.h
 
@@ -999,9 +999,9 @@ pod/perlintern.pod: $(MINIPERL_EXE) autodoc.pl embed.fnc
 pod/perlmodlib.pod: $(MINIPERL_EXE) pod/perlmodlib.PL MANIFEST
        $(MINIPERL) pod/perlmodlib.PL -q
 
-pod/perl5215delta.pod: pod/perldelta.pod
-       $(RMS) pod/perl5215delta.pod
-       $(LNS) perldelta.pod pod/perl5215delta.pod
+pod/perl5216delta.pod: pod/perldelta.pod
+       $(RMS) pod/perl5216delta.pod
+       $(LNS) perldelta.pod pod/perl5216delta.pod
 
 extra.pods: $(MINIPERL_EXE)
        -@test ! -f extra.pods || rm -f `cat extra.pods`
diff --git a/pod/.gitignore b/pod/.gitignore
index 7aa21c1..e814846 100644
--- a/pod/.gitignore
+++ b/pod/.gitignore
@@ -53,7 +53,7 @@
 /roffitall
 
 # generated
-/perl5215delta.pod
+/perl5216delta.pod
 /perlapi.pod
 /perlintern.pod
 *.html
diff --git a/pod/perl.pod b/pod/perl.pod
index 585df3d..6b2c93d 100644
--- a/pod/perl.pod
+++ b/pod/perl.pod
@@ -179,6 +179,7 @@ aux a2p c2ph h2ph h2xs perlbug pl2pm pod2html pod2man s2p 
splain xsubpp
 
     perlhist           Perl history records
     perldelta          Perl changes since previous version
+    perl5215delta Perl changes in version 5.21.5
     perl5214delta Perl changes in version 5.21.4
     perl5213delta Perl changes in version 5.21.3
     perl5212delta Perl changes in version 5.21.2
diff --git a/pod/perldelta.pod b/pod/perl5215delta.pod
similarity index 99%
copy from pod/perldelta.pod
copy to pod/perl5215delta.pod
index 799e46a..f832e85 100644
--- a/pod/perldelta.pod
+++ b/pod/perl5215delta.pod
@@ -2,7 +2,7 @@
 
 =head1 NAME
 
-perldelta - what is new for perl v5.21.5
+perl5215delta - what is new for perl v5.21.5
 
 =head1 DESCRIPTION
 
diff --git a/pod/perldelta.pod b/pod/perldelta.pod
index 799e46a..2c611ca 100644
--- a/pod/perldelta.pod
+++ b/pod/perldelta.pod
@@ -2,622 +2,383 @@
 
 =head1 NAME
 
-perldelta - what is new for perl v5.21.5
+[ 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.6
 
 =head1 DESCRIPTION
 
-This document describes differences between the 5.21.4 release and the 5.21.5
+This document describes differences between the 5.21.5 release and the 5.21.6
 release.
 
-If you are upgrading from an earlier release such as 5.21.3, first read
-L<perl5214delta>, which describes differences between 5.21.3 and 5.21.4.
+If you are upgrading from an earlier release such as 5.21.4, first read
+L<perl5215delta>, which describes differences between 5.21.4 and 5.21.5.
 
-=head1 Core Enhancements
+=head1 Notice
 
-=head2 New double-diamond operator
+XXX Any important notices here
 
-C<<< <<>> >>> is like C<< <> >> but uses three-argument C<open> to open
-each file in @ARGV.  So each element of @ARGV is an actual file name, and
-"|foo" won't be treated as a pipe open.
+=head1 Core Enhancements
 
-=head2 Aliasing via reference
+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</Performance Enhancements> section.
 
-Variables and subroutines can now be aliased by assigning to a reference:
+[ List each enhancement as a =head2 entry ]
 
-    \$c = \$d;
-    \&x = \&y;
+=head1 Security
 
-Or by using a backslash before a C<foreach> iterator variable, which is
-perhaps the most useful idiom this feature provides:
+XXX Any security-related notices go here.  In particular, any security
+vulnerabilities closed should be noted here rather than in the
+L</Selected Bug Fixes> section.
 
-    foreach \%hash (@array_of_hash_refs) { ... }
+[ List each security issue as a =head2 entry ]
 
-This feature is experimental and must be enabled via C<use feature
-'refaliasing'>.  It will warn unless the C<experimental::refaliasing>
-warnings category is disabled.
+=head1 Incompatible Changes
 
-See L<perlref/Assigning to References>
+XXX For a release on a stable branch, this section aspires to be:
 
-=head2 Perl now supports POSIX 2008 locale currency additions.
+    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</Reporting Bugs> below.
 
-On platforms that are able to handle POSIX.1-2008, the
-hash returned by
-L<C<POSIX::localeconv()>|perllocale/The localeconv function>
-includes the international currency fields added by that version of the
-POSIX standard.  These are
-C<int_n_cs_precedes>,
-C<int_n_sep_by_space>,
-C<int_n_sign_posn>,
-C<int_p_cs_precedes>,
-C<int_p_sep_by_space>,
-and
-C<int_p_sign_posn>.
+[ List each incompatible change as a =head2 entry ]
 
-=head2 Packing infinity or not-a-number into a character is now fatal
+=head1 Deprecations
 
-Before, when trying to pack infinity or not-a-number into a
-(signed) character, Perl would warn, and assumed you tried to
-pack C<< 0xFF >>; if you gave it as an argument to C<< chr >>,
-C<< U+FFFD >> was returned. 
+XXX Any deprecated features, syntax, modules etc. should be listed here.
 
-But now, all such actions (C<< pack >>, C<< chr >>, and C<< print '%c' >>)
-result in a fatal error.
+=head2 Module removals
 
-=head2 Inf and NaN
+XXX Remove this section if inapplicable.
 
-Many small improvements, bug fixes and added test cases for dealing 
-with math related to infinity and not-a-number.
+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.
 
-=head1 Security
+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.
 
-=head2 Perl is now compiled with -fstack-protector-strong if available
+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.
 
-Perl has been compiled with the anti-stack-smashing option
-C<-fstack-protector> since 5.10.1.  Now Perl uses the newer variant
-called C<-fstack-protector-strong>, if available.  (This was added
-already in 5.21.4.)
+=over
 
-=head1 Deprecations
+=item XXX
 
-=head2 Use of multiple /x regexp modifiers
+XXX Note that deprecated modules should be listed here even if they are listed
+as an updated module in the L</Modules and Pragmata> section.
 
-It is now deprecated to say something like any of the following:
-
-    qr/foo/xx;
-    /(?xax:foo)/;
-    use re qw(/amxx);
+=back
 
-That is, now C<x> should only occur once in any string of contiguous
-regular expression pattern modifiers.  We do not believe there are any
-occurrences of this in all of CPAN.  This is in preparation for a future
-Perl release having C</xx> mean to allow white-space for readability in
-bracketed character classes (those enclosed in square brackets:
-C<[...]>).
+[ List each other deprecation as a =head2 entry ]
 
 =head1 Performance Enhancements
 
-=over 4
+XXX Changes which enhance performance without changing behaviour go here.
+There may well be none in a stable release.
 
-=item *
+[ List each enhancement as a =item entry ]
 
-C<length> is up to 20% faster for non-magical/non-tied scalars containing a
-string if it is a non-utf8 string or if C<use bytes;> is in scope.
+=over 4
 
 =item *
 
-Non-magical/non-tied scalars that contain only a floating point value and are
-on most Perl builds with 64 bit integers now use 8-32 less bytes of memory
-depending on OS.
+XXX
 
-=item *
+=back
 
-In C<@array = split>, the assignment can be optimized away with C<split>
-writing directly to the array.  This optimisation was happening only for
-package arrays other than @_ and only
-sometimes.  Now this optimisation happens
-almost all the time.
+=head1 Modules and Pragmata
 
-=item *
+XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
+go here.  If Module::CoreList is updated, generate an initial draft of the
+following sections using F<Porting/corelist-perldelta.pl>.  A paragraph summary
+for important changes should then be added by hand.  In an ideal world,
+dual-life modules would have a F<Changes> file that could be cribbed.
 
-C<join> is now subject to constant folding.  Moreover, C<join> with a
-scalar or constant for the separator and a single-item list to join is
-simplified to a stringification.  The separator doesn't even get evaluated.
+[ Within each section, list entries as a =item entry ]
 
-=item *
+=head2 New Modules and Pragmata
 
-C<qq(@array)> is implemented using two ops: a stringify op and a join op.
-If the qq contains nothing but a single array, the stringification is
-optimized away.
+=over 4
 
 =item *
 
-C<our $var> and C<our($s,@a,%h)> in void context are no longer evaluated at
-run time.  Even a whole sequence of C<our $foo;> statements will simply be
-skipped over.  The same applies to C<state> variables.
+XXX
 
 =back
 
-=head1 Modules and Pragmata
-
 =head2 Updated Modules and Pragmata
 
 =over 4
 
 =item *
 
-L<attributes> has been upgraded from version 0.23 to 0.24.
-
-Avoid reading beyond the end of a buffer. [perl #122629]
-
-=item *
-
-L<B> has been upgraded from version 1.51 to 1.52.
-
-=item *
-
-L<B::Concise> has been upgraded from version 0.993 to 0.994.
-
-Null ops that are part of the execution chain are now given sequence
-numbers.
-
-Private flags for nulled ops are now dumped with mnemonics as they would be
-for the non-nulled counterparts.
-
-L<B::Deparse> has been upgraded from version 1.28 to 1.29.
-
-Parenthesised arrays in lists passed to C<\> are now correctly deparsed
-with parentheses (e.g., C<\(@a, (@b), @c)> now retains the parentheses
-around @b), this preserving the flattening behaviour of referenced
-parenthesised arrays.  Formerly, it only worked for one array: C<\(@a)>.
-
-C<local our> is now deparsed correctly, with the C<our> included.
-
-C<for($foo; !$bar; $baz) {...}> was deparsed without the C<!> (or C<not>).
-This has been fixed.
-
-Core keywords that conflict with lexical subroutines are now deparsed with
-the C<CORE::> prefix.
-
-C<foreach state $x (...) {...}> now deparses correctly with C<state> and
-not C<my>.
-
-C<our @array = split(...)> now deparses correctly with C<our> in those
-cases where the assignment is optimized away.
-
-=item *
-
-L<B::Debug> has been upgraded from version 1.21 to 1.22.
-
-=item *
-
-L<B::Deparse> has been upgraded from version 1.28 to 1.29.
-
-=item *
-
-L<Compress::Raw::Bzip2> has been upgraded from version 2.064 to 2.066.
-
-=item *
-
-L<Compress::Raw::Zlib> has been upgraded from version 2.065 to 2.066.
-
-=item *
-
-L<CPAN::Meta> has been upgraded from version 2.142060 to 2.142690.
-
-=item *
-
-L<DynaLoader> has been upgraded from version 1.26 to 1.27.
-
-Remove dl_nonlazy global if unused in Dynaloader. [perl #122926]
-
-=item *
+L<XXX> has been upgraded from version A.xx to B.yy.
 
-L<Errno> has been upgraded from version 1.20_04 to 1.21.
-
-=item *
-
-L<experimental> has been upgraded from version 0.010 to 0.012.
+=back
 
-=item *
+=head2 Removed Modules and Pragmata
 
-L<ExtUtils::CBuilder> has been upgraded from version 0.280219 to 0.280220.
+=over 4
 
 =item *
 
-L<ExtUtils::Miniperl> has been upgraded from version 1.02 to 1.03.
+XXX
 
-=item *
-
-L<Fcntl> has been upgraded from version 1.11 to 1.13.
+=back
 
-Add support for the Linux pipe buffer size fcntl() commands.
+=head1 Documentation
 
-=item *
+XXX Changes to files in F<pod/> go here.  Consider grouping entries by
+file and be sure to link to the appropriate page, e.g. L<perlfunc>.
 
-L<feature> has been upgraded from version 1.37 to 1.38.
+=head2 New Documentation
 
-=item *
+XXX Changes which create B<new> files in F<pod/> go here.
 
-L<File::Find> has been upgraded from version 1.28 to 1.29.
+=head3 L<XXX>
 
-Slightly faster module loading time.
+XXX Description of the purpose of the new file here
 
-=item *
+=head2 Changes to Existing Documentation
 
-L<File::Spec> has been upgraded from version 3.50 to 3.51.
+XXX Changes which significantly change existing files in F<pod/> go here.
+However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
+section.
 
-=item *
+=head3 L<XXX>
 
-L<HTTP::Tiny> has been upgraded from version 0.049 to 0.050.
+=over 4
 
 =item *
 
-The IO-Compress set of modules has been upgraded from version 2.064 to 2.066.
-
-=item *
+XXX Description of the change here
 
-L<JSON::PP> has been upgraded from version 2.27203 to 2.27300.
+=back
 
-=item *
+=head1 Diagnostics
 
-The libnet collection of modules has been upgraded from version 1.27 to 3.02.
+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<perldiag>.
 
-Support for IPv6 and SSL to Net::FTP, Net::NNTP, Net::POP3 and Net::SMTP.
+XXX New or changed warnings emitted by the core's C<C> code go here.  Also
+include any changes in L<perldiag> that reconcile it to the C<C> code.
 
-Improvements in Net::SMTP authentication.
+=head2 New Diagnostics
 
-=item *
+XXX Newly added diagnostic messages go under here, separated into New Errors
+and New Warnings
 
-L<Module::CoreList> has been upgraded from version 5.20140920 to 5.20141020.
+=head3 New Errors
 
-Updated to cover the latest releases of Perl.
+=over 4
 
 =item *
 
-L<Opcode> has been upgraded from version 1.28 to 1.29.
+XXX L<message|perldiag/"message">
 
-=item *
+=back
 
-The PathTools module collection has been upgraded from version 3.50 to 3.51.
+=head3 New Warnings
 
-Slightly faster module loading time.
+=over 4
 
 =item *
 
-L<perlfaq> has been upgraded from version 5.0150045 to version 5.0150046.
-[perl #123008]
+XXX L<message|perldiag/"message">
 
-=item *
-
-L<POSIX> has been upgraded from version 1.43 to 1.45.
+=back
 
-POSIX::tmpnam() now produces a deprecation warning.  [perl #122005]
+=head2 Changes to Existing Diagnostics
 
-=item *
+XXX Changes (i.e. rewording) of diagnostic messages go here
 
-L<re> has been upgraded from version 0.26 to 0.27.
+=over 4
 
 =item *
 
-L<Socket> has been upgraded from version 2.015 to 2.016.
+XXX Describe change here
 
-=item *
+=back
 
-L<Test::Simple> has been upgraded from version 1.001006 to 1.001008.
+=head1 Utility Changes
 
-=item *
+XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go here.
+Most of these are built within the directory F<utils>.
 
-L<threads::shared> has been upgraded from version 1.46 to 1.47.
+[ List utility changes as a =head2 entry for each utility and =item
+entries for each change
+Use L<XXX> with program names to get proper documentation linking. ]
 
-=item *
+=head2 L<XXX>
 
-L<warnings> has been upgraded from version 1.26 to 1.28.
+=over 4
 
 =item *
 
-L<XSLoader> has been upgraded from version 0.17 to 0.18.
-
-Allow XSLoader to load modules from a different namespace.
-[perl #122455]
+XXX
 
 =back
 
-=head1 Documentation
+=head1 Configuration and Compilation
 
-=head2 Changes to Existing Documentation
+XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
+go here.  Any other changes to the Perl build process should be listed here.
+However, any platform-specific changes should be listed in the
+L</Platform Support> section, instead.
 
-=head3 L<perlrecharclass>
+[ List changes as a =item entry ].
 
 =over 4
 
 =item *
 
-Clarifications have been added to L<perlrecharclass/Character Ranges>
-to the effect that Perl guarantees that C<[A-Z]>, C<[a-z]>, C<[0-9]> and
-any subranges thereof in regular expression bracketed character classes
-are guaranteed to match exactly what a naive English speaker would
-expect them to match, even on platforms (such as EBCDIC) where special
-handling is required to accomplish this.
+XXX
 
 =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<perldiag>.
+=head1 Testing
 
-=head2 New Diagnostics
+XXX Any significant changes to the testing of a freshly built perl should be
+listed here.  Changes which create B<new> files in F<t/> go here as do any
+large changes to the testing harness (e.g. when parallel testing was added).
+Changes to existing files in F<t/> aren't worth summarizing, although the bugs
+that they represent may be covered elsewhere.
 
-=head3 New Errors
+[ List each test improvement as a =item entry ]
 
 =over 4
 
 =item *
 
-L<Cannot chr %f|perldiag/"Cannot chr %f">
-
-=item *
-
-L<Cannot compress %f in pack|perldiag/"Cannot compress %f in pack">
+XXX
 
-=item *
+=back
 
-L<Cannot pack %f with '%c'|perldiag/"Cannot pack %f with '%c'">
+=head1 Platform Support
 
-=item *
+XXX Any changes to platform support should be listed in the sections below.
 
-L<Cannot print %f with '%c'|perldiag/"Cannot printf %f with '%c'">
+[ Within the sections, list each platform as a =item entry with specific
+changes as paragraphs below it. ]
 
-=back
+=head2 New Platforms
 
-=head2 Changes to Existing Diagnostics
+XXX List any platforms that this version of perl compiles on, that previous
+versions did not.  These will either be enabled by new files in the F<hints/>
+directories, or new subdirectories and F<README> files at the top level of the
+source tree.
 
 =over 4
 
-=item *
+=item XXX-some-platform
 
-'"my" variable &foo::bar can't be in a package' has been reworded to say
-'subroutine' instead of 'variable'.
+XXX
 
 =back
 
-=head1 Testing
+=head2 Discontinued Platforms
+
+XXX List any platforms that this version of perl no longer compiles on.
 
 =over 4
 
-=item *
+=item XXX-some-platform
 
-Some regular expression tests are written in such a way that they will
-run very slowly if certain optimizations break. These tests have been
-moved into new files, F<< t/re/speed.t >> and F<< t/re/speed_thr.t >>,
-and are run with a C<< watchdog() >>.
+XXX
 
 =back
 
-=head1 Platform Support
-
-=head2 Regained Platforms
-
-IRIX and Tru64 platforms are working again.
-(Some C<make test> failures remain.)
-
 =head2 Platform-Specific Notes
 
+XXX List any changes for specific platforms.  This could include configuration
+and compilation changes or changes in portability/compatibility.  However,
+changes within modules for platforms should generally be listed in the
+L</Modules and Pragmata> section.
+
 =over 4
 
-=item EBCDIC
+=item XXX-some-platform
 
-Special handling is required on EBCDIC platforms to get C<qr/[i-j]/> to
-match only C<"i"> and C<"j">, since there are 7 characters between the
-code points for C<"i"> and C<"j">.  This special handling had only been
-invoked when both ends of the range are literals.  Now it is also
-invoked if any of the C<\N{...}> forms for specifying a character by
-name or Unicode code point is used instead of a literal.  See
-L<perlrecharclass/Character Ranges>.
+XXX
 
 =back
 
 =head1 Internal Changes
 
-=over 4
-
-=item *
-
-SVs of type SVt_NV are now bodyless when a build configure and platform allow
-it, specifically C<sizeof(NV) <= sizeof(IV)>. The bodyless trick is the same 
one
-as for IVs since 5.9.2, but for NVs, unlike IVs, is not guaranteed on all
-platforms and build configurations.
-
-=item *
-
-The C<$DB::single>, C<$DB::signal> and C<$DB::trace> now have set and
-get magic that stores their values as IVs and those IVs are used when
-testing their values in C<pp_dbstate>.  This prevents perl from
-recursing infinity if an overloaded object is assigned to any of those
-variables. [perl #122445]
-
-=item *
-
-C<Perl_tmps_grow> which is marked as public API but undocumented has been
-removed from public API. If you use C<EXTEND_MORTAL> macro in your XS code to
-preextend the mortal stack, you are unaffected by this change.
-
-=item *
-
-C<cv_name>, which was introduced in 5.21.4, has been changed incompatibly.
-It now has a flags field that allows the caller to specify whether the name
-should be fully qualified.  See L<perlapi/cv_name>.
-
-=item *
-
-Internally Perl no longer uses the C<SVs_PADMY> flag.  C<SvPADMY()> now
-returns a true value for anything not marked PADTMP.  C<SVs_PADMY> is now
-defined as 0.
-
-=item *
-
-The macros SETsv and SETsvUN have been removed. They were no longer used
-in the core since commit 6f1401dc2a, and have not been found present on
-CPAN.
-
-=item *
-
-The C<< SvFAKE >> bit (unused on HVs) got informally reserved by
-David Mitchell for future work on vtables.
+XXX Changes which affect the interface available to C<XS> code go here.  Other
+significant internal changes for future core maintainers should be noted as
+well.
 
-=item *
+[ List each change as a =item entry ]
 
-The C<sv_catpvn_flags> function accepts C<SV_CATBYTES> and C<SV_CATUTF8>
-flags, which specify whether the appended string is bytes or utf8,
-respectively.
+=over 4
 
 =item *
 
-A new opcode class, C<< METHOP >> has been introduced, which holds
-class/method related info needed at runtime to improve performance
-of class/object method calls.
-
-C<< OP_METHOD >> and C<< OP_METHOD_NAMED >> are moved from being
-C<< UNOP/SVOP >> to being C<< METHOD >>.
+XXX
 
 =back
 
 =head1 Selected Bug Fixes
 
-=over 4
-
-=item *
-
-Locking and unlocking values via L<Hash::Util> or C<Internals::SvREADONLY>
-no longer has any effect on values that are read-only to begin.
-Previously, unlocking such values could result in crashes, hangs or
-other erratic behaviour.
-
-=item *
-
-The internal C<looks_like_number> function (which L<Scalar::Util> provides
-access to) began erroneously to return true for "-e1" in 5.21.4, affecting
-also C<-'-e1'>.  This has been fixed.
-
-=item *
-
-The flip-flop operator (C<..> in scalar context) would return the same
-scalar each time, unless the containing subroutine was called recursively.
-Now it always returns a new scalar.  [perl #122829]
-
-=item *
-
-Some unterminated C<(?(...)...)> constructs in regular expressions would
-either crash or give erroneous error messages.  C</(?(1)/> is one such
-example.
-
-=item *
-
-C<pack "w", $tied> no longer calls FETCH twice.
-
-=item *
-
-List assignments like C<($x, $z) = (1, $y)> now work correctly if $x and $y
-have been aliased by C<foreach>.
-
-=item *
-
-Some patterns including code blocks with syntax errors, such as
-C</ (?{(^{})/>, would hang or fail assertions on debugging builds.  Now
-they produce errors.
-
-=item *
+XXX Important bug fixes in the core language are summarized here.  Bug fixes in
+files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
 
-An assertion failure when parsing C<sort> with debugging enabled has been
-fixed.  [perl #122771]
+[ List each fix as a =item entry ]
 
-=item *
-
-C<*a = *b; @a = split //, $b[1]> could do a bad read and produce junk
-results.
-
-=item *
-
-In C<() = @array = split>, the C<() => at the beginning no longer confuses
-the optimizer, making it assume a limit of 1.
+=over 4
 
 =item *
 
-Fatal warnings no longer prevent the output of syntax errors.
-[perl #122966]
+XXX
 
-=item *
+=back
 
-Fixed a NaN double to long double conversion error on VMS. For quiet NaNs
-(and only on Itanium, not Alpha) negative infinity instead of NaN was
-produced. 
+=head1 Known Problems
 
-=item *
+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.  Unfixed
+platform specific bugs also go here.
 
-Fixed the issue that caused C<< make distclean >> to leave files behind
-that shouldn't. [perl #122820]
+[ List each fix as a =item entry ]
 
-=item *
-
-AIX now sets the length in C<< getsockopt >> correctly. [perl #120835],
-[rt #91183], [rt #85570].
+=over 4
 
 =item *
 
-During the pattern optimization phase, we no longer recurse into
-GOSUB/GOSTART when not SCF_DO_SUBSTR. This prevents the optimizer
-to run "forever" and exhaust all memory. [perl #122283]
-
-=item *
+XXX
 
-F<< t/op/crypt.t >> now performs SHA-256 algorithm if the default one
-is disabled. [perl #121591]
+=back
 
-=item *
+=head1 Errata From Previous Releases
 
-Fixed an off-by-one error when setting the size of shared array.
-[perl #122950]
+=over 4
 
 =item *
 
-Fixed a bug that could cause perl to execute an infinite loop during
-compilation. [perl #122995]
+XXX Add anything here that we forgot to add, or were mistaken about, in
+the perldelta of a previous release.
 
 =back
 
-=head1 Acknowledgements
-
-Perl 5.21.5 represents approximately 4 weeks of development since Perl 5.21.4
-and contains approximately 40,000 lines of changes across 530 files from 33
-authors.
+=head1 Obituary
 
-Excluding auto-generated files, documentation and release tools, there were
-approximately 29,000 lines of changes to 390 .pm, .t, .c and .h files.
+XXX If any significant core contributor has died, we've added a short obituary
+here.
 
-Perl continues to flourish into its third decade thanks to a vibrant community
-of users and developers. The following people are known to have contributed the
-improvements that became Perl 5.21.5:
-
-Aaron Crane, Abigail, Alberto Simões, Andrew Fresh, Chris 'BinGOs' Williams,
-Craig A. Berry, Dagfinn Ilmari Mannsåker, Daniel Dragan, David Mitchell, Doug
-Bell, Ed J, Father Chrysostomos, George Greer, Graham Knop, James E Keenan,
-Jarkko Hietaniemi, Karen Etheridge, Karl Williamson, Leon Timmermans, Lukas
-Mai, Niko Tyni, Peter Martini, Petr Písař, Rafael Garcia-Suarez, Reini Urban,
-Ricardo Signes, Shlomi Fish, Steve Hay, syber, Tony Cook, Vincent Pit, Yves
-Orton, Ævar Arnfjörð Bjarmason.
-
-The list above is almost certainly incomplete as it is automatically generated
-from version control history. In particular, it does not include the names of
-the (very much appreciated) contributors who reported issues to the Perl bug
-tracker.
+=head1 Acknowledgements
 
-Many of the changes included in this version originated in the CPAN modules
-included in Perl's core. We're grateful to the entire CPAN community for
-helping Perl to flourish.
+XXX Generate this with:
 
-For a more complete list of all of Perl's historical contributors, please see
-the F<AUTHORS> file in the Perl source distribution.
+  perl Porting/acknowledgements.pl v5.21.5..HEAD
 
 =head1 Reporting Bugs
 
diff --git a/vms/descrip_mms.template b/vms/descrip_mms.template
index 2271826..9033620 100644
--- a/vms/descrip_mms.template
+++ b/vms/descrip_mms.template
@@ -307,7 +307,7 @@ utils : $(utils1) $(utils2) $(utils3) $(utils4) $(utils5)
 extra.pods : miniperl
        @ @extra_pods.com
 
-PERLDELTA_CURRENT = [.pod]perl5215delta.pod
+PERLDELTA_CURRENT = [.pod]perl5216delta.pod
 
 $(PERLDELTA_CURRENT) : [.pod]perldelta.pod
        Copy/NoConfirm/Log $(MMS$SOURCE) $(PERLDELTA_CURRENT)
diff --git a/win32/Makefile b/win32/Makefile
index a8dc2af..e92420f 100644
--- a/win32/Makefile
+++ b/win32/Makefile
@@ -1158,7 +1158,7 @@ utils: $(PERLEXE) ..\utils\Makefile
        copy ..\README.tw       ..\pod\perltw.pod
        copy ..\README.vos      ..\pod\perlvos.pod
        copy ..\README.win32    ..\pod\perlwin32.pod
-       copy ..\pod\perldelta.pod ..\pod\perl5215delta.pod
+       copy ..\pod\perldelta.pod ..\pod\perl5216delta.pod
        cd ..\win32
        $(PERLEXE) $(PL2BAT) $(UTILS)
        $(MINIPERL) -I..\lib ..\autodoc.pl ..
@@ -1254,7 +1254,7 @@ distclean: realclean
        -if exist $(LIBDIR)\Win32API rmdir /s /q $(LIBDIR)\Win32API
        -if exist $(LIBDIR)\XS rmdir /s /q $(LIBDIR)\XS
        -cd $(PODDIR) && del /f *.html *.bat roffitall \
-           perl5215delta.pod perlaix.pod perlamiga.pod perlandroid.pod \
+           perl5216delta.pod perlaix.pod perlamiga.pod perlandroid.pod \
            perlapi.pod perlbs2000.pod perlce.pod perlcn.pod perlcygwin.pod \
            perldos.pod perlfreebsd.pod perlhaiku.pod perlhpux.pod \
            perlhurd.pod perlintern.pod perlirix.pod perljp.pod perlko.pod \
diff --git a/win32/makefile.mk b/win32/makefile.mk
index 4ea76c8..1f8030a 100644
--- a/win32/makefile.mk
+++ b/win32/makefile.mk
@@ -1347,7 +1347,7 @@ utils: $(PERLEXE) ..\utils\Makefile
        copy ..\README.tw       ..\pod\perltw.pod
        copy ..\README.vos      ..\pod\perlvos.pod
        copy ..\README.win32    ..\pod\perlwin32.pod
-       copy ..\pod\perldelta.pod ..\pod\perl5215delta.pod
+       copy ..\pod\perldelta.pod ..\pod\perl5216delta.pod
        $(PERLEXE) $(PL2BAT) $(UTILS)
        $(MINIPERL) -I..\lib ..\autodoc.pl ..
        $(MINIPERL) -I..\lib ..\pod\perlmodlib.PL -q ..
@@ -1442,7 +1442,7 @@ distclean: realclean
        -if exist $(LIBDIR)\Win32API rmdir /s /q $(LIBDIR)\Win32API
        -if exist $(LIBDIR)\XS rmdir /s /q $(LIBDIR)\XS
        -cd $(PODDIR) && del /f *.html *.bat roffitall \
-           perl5215delta.pod perlaix.pod perlamiga.pod perlandroid.pod \
+           perl5216delta.pod perlaix.pod perlamiga.pod perlandroid.pod \
            perlapi.pod perlbs2000.pod perlce.pod perlcn.pod perlcygwin.pod \
            perldos.pod perlfreebsd.pod perlhaiku.pod perlhpux.pod \
            perlhurd.pod perlintern.pod perlirix.pod perljp.pod perlko.pod \
diff --git a/win32/pod.mak b/win32/pod.mak
index 5e45ce7..a26826b 100644
--- a/win32/pod.mak
+++ b/win32/pod.mak
@@ -43,6 +43,7 @@ POD = perl.pod        \
        perl5213delta.pod       \
        perl5214delta.pod       \
        perl5215delta.pod       \
+       perl5216delta.pod       \
        perl561delta.pod        \
        perl56delta.pod \
        perl581delta.pod        \
@@ -179,6 +180,7 @@ MAN = perl.man      \
        perl5213delta.man       \
        perl5214delta.man       \
        perl5215delta.man       \
+       perl5216delta.man       \
        perl561delta.man        \
        perl56delta.man \
        perl581delta.man        \
@@ -315,6 +317,7 @@ HTML = perl.html    \
        perl5213delta.html      \
        perl5214delta.html      \
        perl5215delta.html      \
+       perl5216delta.html      \
        perl561delta.html       \
        perl56delta.html        \
        perl581delta.html       \
@@ -451,6 +454,7 @@ TEX = perl.tex      \
        perl5213delta.tex       \
        perl5214delta.tex       \
        perl5215delta.tex       \
+       perl5216delta.tex       \
        perl561delta.tex        \
        perl56delta.tex \
        perl581delta.tex        \

--
Perl5 Master Repository

Reply via email to