diff options
author | Dominic Hargreaves <dom@earth.li> | 2012-11-03 13:02:21 +0000 |
---|---|---|
committer | Dominic Hargreaves <dom@earth.li> | 2012-11-03 13:02:21 +0000 |
commit | f57984018de6ac0df0c346f0215c99fb67667412 (patch) | |
tree | e4e1559dc0d57149118b1aabf700047b9c42a95b | |
parent | 0d9d6df7de296091e4fcb2c713a7f7f91df875fb (diff) | |
download | perl-f57984018de6ac0df0c346f0215c99fb67667412.tar.gz |
finalise perl5125delta
-rw-r--r-- | pod/perl5125delta.pod | 199 |
1 files 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<perl5124delta>, which describes differences between 5.12.3 and 5.12.4. -=head1 Notice - -XXX Any important notices here - =head1 Security =head2 C<Encode> 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</Performance Enhancements> 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<hints/> -directories, or new subdirectories and F<README> 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<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>, 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<Changes> file that could be -cribbed. - -=head2 New Modules and Pragmata - -=head2 Pragmata Changes - =head2 Updated Modules =head3 L<B::Concise> @@ -107,38 +72,8 @@ See L</Security>. The documentation for the C<upper> function now actually says "upper", not "lower". -=head2 Removed Modules and Pragmata - -=head1 Utility Changes - -XXX Changes to installed programs such as F<perlbug> and F<xsubpp> go -here. Most of these are built within the directories F<utils> and F<x2p>. - -=over 4 - -=item F<XXX> - -XXX - -=back - -=head1 New Documentation - -XXX Changes which create B<new> files in F<pod/> go here. - -=over 4 - -=item L<XXX> - -XXX - -=back - =head1 Changes to Existing Documentation -XXX Changes which significantly change existing files in F<pod/> go here. -Any changes to F<pod/perldiag.pod> should go in L</New or Changed Diagnostics>. - =head2 L<perlebcdic> The L<perlebcdic> document contains a helpful table to use in C<tr///> 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<Configure>, F<installperl>, F<installman>, 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<ext/> and F<lib/> are best summarised in -L</Modules and Pragmata>. - =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<C> code go here. - -=over 4 - -=item C<XXX> - -XXX - -=back - -=head1 Changed Internals - -XXX Changes which affect the interface available to C<XS> code go here. - -=over 4 - -=item * - -XXX - -=back - -=head1 New Tests - -XXX Changes which create B<new> files in F<t/> go here. Changes to -existing files in F<t/> aren't worth summarising, although the bugs that -they represent may be. - -=over 4 - -=item F<XXX> - -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 C<TODO>ed 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<perl5120delta>. -=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<AUTHORS> file in the Perl source distribution. =head1 Reporting Bugs |