From: Steve Hay Date: Sun, 14 Feb 2010 22:46:51 +0000 (+0000) Subject: First stab at a perl5115delta.pod with just under a week to go X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=555dc087e23cb8cb4cb1c91e73f10b9b9bf80630;p=p5sagit%2Fp5-mst-13.2.git First stab at a perl5115delta.pod with just under a week to go --- diff --git a/pod/perl5115delta.pod b/pod/perl5115delta.pod index 569fc7b..19adb9b 100644 --- a/pod/perl5115delta.pod +++ b/pod/perl5115delta.pod @@ -1,8 +1,5 @@ =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.11.5 =head1 DESCRIPTION @@ -14,214 +11,178 @@ If you are upgrading from an earlier release such as 5.11.3, first read L, which describes differences between 5.11.3 and 5.11.4. -=head1 Notice - -XXX Any important notices here - -=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 +=head2 32-bit limit on substr arguments removed -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. +The 32-bit limit on C arguments has now been removed. The full range +of the system's signed and unsigned integers is now available for the C +and C arguments. =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 - -=head2 Removed Modules and Pragmata - -=head1 Utility Changes +=over 4 -XXX Changes to installed programs such as F and F go -here. Most of these are built within the directories F and F. +=item C -=over 4 +XXX Double-check that the following has actually been done or else remove it: +Upgraded from version 0.81 to 0.82. -=item F +The C and C functions can now be optionally exported to the +caller's namespace and are also now documented. -XXX +Undefined version objects are now uninitialized with zero rather than C. =back -=head1 New Documentation - -XXX Changes which create B files in F go here. +=head2 Updated Modules =over 4 -=item L - -XXX +=item C -=back +Upgraded from version 1.94_53 to 1.94_55. -=head1 Changes to Existing Documentation +This module is also now built in a less specialized way, which resolves a +problem that caused C after C to fail, fixing RT #72218. -XXX Changes which significantly change existing files in F go here. -Any changes to F should go in L. +=item C +Upgraded from version 0.44 to 0.46. -=head1 Performance Enhancements +=item C -XXX Changes which enhance performance without changing behaviour go here. There -may well be none in a stable release. +Upgraded from version 2.21 to 2.22. -=over 4 +This resolves RT #72700, in which an exception thrown from a closure was +getting lost. -=item * +=item C -XXX +Upgraded from version 2.2.2 to 2.3.0. =back -=head1 Installation and Configuration Improvements - -XXX Changes to F, F, F, and analogous tools -go here. - -=head2 Configuration improvements - -XXX - -=head2 Compilation improvements +=head1 Changes to Existing Documentation -XXX +The syntax C is now documented as valid, as +is the syntax C, +although actually using the latter may not be the best idea for the +readability of your source code. -=head2 Platform Specific Changes +=head1 Installation and Configuration Improvements -=over 4 +=head2 Configuration improvements -=item XXX-some-platform +Support for SystemTap's C compatibility layer has been added and an +issue with linking C has been fixed in the process. -XXX +C is now used instead of C for C's new usage of ANSI +escape codes by setting C<$Config{less}> (and thereby C<$Config{pager}>, +which fixes RT #72156. -=back +USE_PERL_ATOF is now reported in the compile-time options listed by the C<-V> +switch. =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 * -XXX - -=back - -=head1 New or Changed Diagnostics - -XXX New or changed warnings emitted by the core's C code go here. - -=over 4 +Arbitrary whitespace is now allowed between C and C in +C statements. (Fixes RT #72432) -=item C +=item * -XXX +A panic caused by trying to load C when the parser is already in +error (e.g. by a missing C under C) is now averted. This +was a regression since Perl 5.10.0. (Fixes RT #72590) -=back +=item * -=head1 Changed Internals +A possible SEGV in C has been fixed. This was a regression since +Perl 5.10. -XXX Changes which affect the interface available to C code go here. +=item * -=over 4 +A possible SEGV when freeing a scalar that was upgraded to an C +type from a simple(r) scalar has been fixed. =item * -XXX +A type conversion bug in C that caused it to break around C<2**48> +has been fixed. -=back +=item * -=head1 New Tests +Filehandles are now always blessed into C, which, together with +some suitable manipulation of C<@IO::File::ISA>, fixes a breakage introduced +in Perl 5.11.3 by a change that always blessed filehandles into C +rather than checking for C first. -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. +=item * -=over 4 +A change in C's behaviour in Perl 5.10.0 that wasn't +documented at the time is now documented in L. (Fixes RT +#62522) -=item F +=item * -XXX +RT #71504 is now fixed by simply skipping the tests that failed on OpenBSD +with ithreads and perlio. =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. +=head1 New or Changed Diagnostics =over 4 =item * -XXX +C and C called with numbers smaller than they can reliably +handle will now issue the warnings C and +C. =back -=head1 Deprecations - -XXX Add any new known deprecations here. - -The following items are now deprecated. +=head1 New Tests =over 4 -=item * +=item F -XXX +Tests some suitably portable filetest operators to check that they work as +expected, particularly in the light of some internal changes made in how +filehandles are blessed. -=back +=item F -=head1 Platform Specific Notes +Tests that times greater than C<2**63>, which can now be handed to C +and C, do not cause an internal overflow or an excessively long +loop. -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 +=back -=head1 Obituary +=head1 Known Problems -XXX If any significant core contributor has died, we've added a short obituary -here. +Perl 5.11.5 is a development release leading up to Perl 5.12.0. +Some notable known problems found in 5.11.5 are listed as dependencies +of RT #69710, the Perl 5 version 12 meta-ticket. =head1 Acknowledgements +Perl 5.11.5 represents approximately one month of development since +Perl 5.11.4 and contains XXX lines of changes across XXX files +from XXX authors and committers: + 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. =head1 Reporting Bugs @@ -234,7 +195,7 @@ If you believe you have an unreported bug, please run the B program included with your release. Be sure to trim your bug down to a tiny but sufficient test case. Your bug report, along with the output of C, will be sent off to perlbug@perl.org to be -analysed by the Perl porting team. +analyzed by the Perl porting team. If the bug you are reporting has security implications, which make it inappropriate to send to a publicly archived mailing list, then please send