From f57984018de6ac0df0c346f0215c99fb67667412 Mon Sep 17 00:00:00 2001 From: Dominic Hargreaves Date: Sat, 3 Nov 2012 13:02:21 +0000 Subject: finalise perl5125delta --- pod/perl5125delta.pod | 199 ++++++-------------------------------------------- 1 file changed, 24 insertions(+), 175 deletions(-) diff --git a/pod/perl5125delta.pod b/pod/perl5125delta.pod index 7a8eba4ee0..9123ace5c6 100644 --- a/pod/perl5125delta.pod +++ b/pod/perl5125delta.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.12.5 =head1 DESCRIPTION @@ -16,10 +13,6 @@ If you are upgrading from an earlier release such as 5.12.3, first read L, which describes differences between 5.12.3 and 5.12.4. -=head1 Notice - -XXX Any important notices here - =head1 Security =head2 C decode_xs n-byte heap-overflow (CVE-2011-2939) @@ -48,39 +41,11 @@ This problem has been fixed. =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 reports are welcome. - - -=head1 Core Enhancements - -XXX New core language features go here. Summarise user-visible core language -enhancements. Particularly prominent performance optimisations could go -here, but most should go in the L section. - -=head1 New Platforms - -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 -directories, or new subdirectories and F files at the top level of the -source tree. +There are no changes intentionally incompatible with 5.XXX.XXX. If any +exist, they are bugs and reports are welcome. =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, which prints stub -entries to STDOUT. Results can be pasted in place of the '=head2' entries -below. 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. - -=head2 New Modules and Pragmata - -=head2 Pragmata Changes - =head2 Updated Modules =head3 L @@ -107,38 +72,8 @@ See L. The documentation for the C function now actually says "upper", not "lower". -=head2 Removed Modules and Pragmata - -=head1 Utility Changes - -XXX Changes to installed programs such as F and F go -here. Most of these are built within the directories F and F. - -=over 4 - -=item F - -XXX - -=back - -=head1 New Documentation - -XXX Changes which create B files in F go here. - -=over 4 - -=item L - -XXX - -=back - =head1 Changes to Existing Documentation -XXX Changes which significantly change existing files in F go here. -Any changes to F should go in L. - =head2 L The L document contains a helpful table to use in C to @@ -156,32 +91,8 @@ has been rectified. This document has been corrected to take non-ASCII platforms into account. -=head1 Performance Enhancements - -XXX Changes which enhance performance without changing behaviour go here. There -may well be none in a stable release. - -=over 4 - -=item * - -XXX - -=back - =head1 Installation and Configuration Improvements -XXX Changes to F, F, F, and analogous tools -go here. - -=head2 Configuration improvements - -XXX - -=head2 Compilation improvements - -XXX - =head2 Platform Specific Changes =over 4 @@ -195,10 +106,6 @@ Lion and Mountain Lion. =head1 Selected Bug Fixes -XXX Important bug fixes in the core language are summarised here. -Bug fixes in files in F and F are best summarised in -L. - =over 4 =item * @@ -252,81 +159,6 @@ been fixed [perl #90160]. =back -=head1 New or Changed Diagnostics - -XXX New or changed warnings emitted by the core's C code go here. - -=over 4 - -=item C - -XXX - -=back - -=head1 Changed Internals - -XXX Changes which affect the interface available to C code go here. - -=over 4 - -=item * - -XXX - -=back - -=head1 New Tests - -XXX Changes which create B files in F go here. Changes to -existing files in F aren't worth summarising, although the bugs that -they represent may be. - -=over 4 - -=item F - -XXX - -=back - -=head1 Known Problems - -XXX Descriptions of platform agnostic bugs we know we can't fix go here. Any -tests that had to be Ced 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. - -=over 4 - -=item * - -XXX - -=back - -=head1 Deprecations - -XXX Add any new known deprecations here. - -The following items are now deprecated. - -=over 4 - -=item * - -XXX - -=back - -=head1 Platform Specific Notes - -XXX Any changes specific to a particular platform. VMS and Win32 are the usual -stars here. It's probably best to group changes under the same section layout -as the main perldelta - =head1 Errata =head2 split() and C<@_> @@ -336,15 +168,32 @@ In void context it now produces a "Useless use of split" warning. This is actually a change introduced in perl 5.12.0, but it was missed from that release's L. -=head1 Obituary +=head1 Acknowledgements + +Perl 5.12.5 represents approximately 16 months of development since Perl 5.12.4 +and contains approximately 2,000 lines of changes across 62 files from 17 +authors. -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.12.5: -=head1 Acknowledgements +Andy Dougherty, Craig A. Berry, David Mitchell, Dominic Hargreaves, Father +Chrysostomos, Florian Ragwitz, George Greer, Goro Fuji, Jesse Vincent, Karl +Williamson, Leon Brocard, Nicholas Clark, Rafael Garcia-Suarez, Reini Urban, +Ricardo Signes, Steve Hay, Tony Cook. + +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. -XXX The list of people to thank goes here. +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. +For a more complete list of all of Perl's historical contributors, please see +the F file in the Perl source distribution. =head1 Reporting Bugs -- cgit v1.2.1