From d5dc70019fa9d6f8c265e0493cfe7dea6cec45a1 Mon Sep 17 00:00:00 2001 From: Abigail Date: Mon, 19 Mar 2012 03:20:09 +0100 Subject: [PATCH] Retry first shot at perldelta.pod. Documents the differences between 5.15.8 and 5.15.9. --- pod/perldelta.pod | 167 +++++++++++++++++++++++++++++------------------------- 1 file changed, 89 insertions(+), 78 deletions(-) diff --git a/pod/perldelta.pod b/pod/perldelta.pod index 3326e71..94528fe 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.15.9 =head1 DESCRIPTION @@ -18,13 +15,17 @@ L, which describes differences between 5.15.7 and =head1 Notice -XXX Any important notices here +This space intentionally left blank. =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. +=head2 C<< no feature; >> now means reset to default + +C<< no feature >> now resets to the default feature set. To disable all +features (which is likely to be a pretty special-purpose request, since +it presumably won't match any named set of semantics) you can now +write C<< no feature ':all' >>. + [ List each enhancement as a =head2 entry ] @@ -48,24 +49,20 @@ XXX For a release on a stable branch, this section aspires to be: =head1 Deprecations -XXX Any deprecated features, syntax, modules etc. should be listed here. -In particular, deprecated modules should be listed here even if they are -listed as an updated module in the L section. +=head2 Literal C<< "{" >> characters in regular expressions. -[ List each deprecation as a =head2 entry ] +It has been documented that the current plans include requiring a +literal C<< "{" >> to be escaped: 5.18 will emit deprecation warnings, +and it will be required in 5.20. =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 a =item entry ] - =over 4 =item * -XXX +Fix a slowdown in freeing nested hashes. This may speedup the exit of +certain programs. =back @@ -146,71 +143,31 @@ 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. - -[ Within each section, list entries as a =item entry that links to perldiag, - e.g. - - =item * - - L -] - =head2 New Diagnostics -XXX Newly added diagnostic messages go here - =head3 New Errors -=over 4 - -=item * - -XXX L - -=back +Compared to 5.15.8, 5.15.9 does not introduce new errors. =head3 New Warnings -=over 4 - -=item * - -XXX L - -=back +Compared to 5.15.8, 5.15.9 does not introduce new errors, but see +L =head2 Changes to Existing Diagnostics -XXX Changes (i.e. rewording) of diagnostic messages go here - =over 4 =item * -XXX Describe change here +L, which replaces +C<< lvalue attribute cannot be removed after the subroutine has been defined >>. =back =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. - -[ List utility changes as a =head3 entry for each utility and =item -entries for each change -Use L with program names to get proper documentation linking. ] - -=head3 L - -=over 4 - -=item * - -XXX - -=back +No utilities changed between 5.15.8 and 5.15.9. =head1 Configuration and Compilation @@ -231,22 +188,15 @@ XXX =head1 Testing -XXX Any significant changes to the testing of a freshly built perl should be -listed here. Changes which create B files in F go here as do any -large changes to the testing harness (e.g. when parallel testing was added). -Changes to existing files in F aren't worth summarising, although the bugs -that they represent may be covered elsewhere. - -[ List each test improvement as a =item entry ] - =over 4 =item * -F has been added, to test that C always closes -the file handle that it opens. Previously, it had been leaking the file handle -if it happened to have file descriptor 0, which would happen if C was -called (explicitly or implicitly) when C had been closed. +F<< t/op/require_37033.t >> has been added, to test that C +always closes the file handle that it opens. Previously, it had been +leaking the file handle if it happened to have file descriptor 0, which +would happen if C was called (explicitly or implicitly) when +C had been closed. =back @@ -327,9 +277,46 @@ L. =item * -C with a non-reference, non-string value in $@ now properly +I is now considered a script that uses two characters. This corrects +a Unicode 6.1 omission. + +=item * + +C<< perlfunc.hmtl >> is now being generated again. [perl #107870] + +=item * + +C<< $$ >> is no longer tainted. Since this value comes directly from +C<< getpid() >>, it is always safe. + +=item * + +Fix leaking a file handle. [perl #37033] + +=item * + +An off-by-one error caused C<< /[:upper:]/ >> and C<< /[:punct:]/ >> to +unexepectly match characters with code points above 255. This has been +rectified. [perl 111400]. + +=item * + +C<< (?foo: ...) >> no longer loses passed in character set. + +=item * + +Allow attributes to set C<< :lvalue >> on a defined sub. [perl 107366]. + +=item * + +C<< die; >> with a non-reference, non-string value in $@ now properly propgates that value [perl #111654]. +=item * + +C<< Term::ReadLine >> now uses AnyEvent instead of Tk for an event loop. + + =back =head1 Known Problems @@ -358,9 +345,33 @@ here. =head1 Acknowledgements -XXX Generate this with: +XXX Redo this on 2012-03-20 + +Perl 5.15.9 represents approximately 4 weeks of development since Perl 5.15.8 +and contains approximately 74,000 lines of changes across 470 files from 23 +authors. + +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.15.9: + +Aaron Crane, Abigail, Chris 'BinGOs' Williams, Craig A. Berry, Dave Rolsky, +David Cantrell, David Golden, David Mitchell, Eric Brine, Father Chrysostomos, +Florian Ragwitz, James E Keenan, Jesse Vincent, Karl Williamson, Marc Green, +Max Maischein, Nicholas Clark, Pau Amma, Reini Urban, Ricardo Signes, Tony +Cook, Yves Orton, Zefram. + +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. + +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. - perl Porting/acknowledgements.pl v5.15.8..HEAD +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 -- 1.8.3.1