First stab at a perl5115delta.pod with just under a week to go
Steve Hay [Sun, 14 Feb 2010 22:46:51 +0000 (22:46 +0000)]
pod/perl5115delta.pod

index 569fc7b..19adb9b 100644 (file)
@@ -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<perl5114delta>, 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</Performance Enhancements> 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<hints/>
-directories, or new subdirectories and F<README> files at the top level of the
-source tree.
+The 32-bit limit on C<substr> arguments has now been removed. The full range
+of the system's signed and unsigned integers is now available for the C<pos>
+and C<len> arguments.
 
 =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
-
-=head2 Removed Modules and Pragmata
-
-=head1 Utility Changes
+=over 4
 
-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>.
+=item C<version>
 
-=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<XXX>
+The C<is_lax> and C<is_strict> 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<undef>.
 
 =back
 
-=head1 New Documentation
-
-XXX Changes which create B<new> files in F<pod/> go here.
+=head2 Updated Modules
 
 =over 4
 
-=item L<XXX>
-
-XXX
+=item C<CPAN>
 
-=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<make> after C<make clean> to fail, fixing RT #72218.
 
-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>.
+=item C<CPANPLUS::Dist::Build>
 
+Upgraded from version 0.44 to 0.46.
 
-=head1 Performance Enhancements
+=item C<Safe>
 
-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<podlators>
 
-XXX
+Upgraded from version 2.2.2 to 2.3.0.
 
 =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
+=head1 Changes to Existing Documentation
 
-XXX
+The syntax C<unless (EXPR) BLOCK else BLOCK> is now documented as valid, as
+is the syntax C<unless (EXPR) BLOCK elsif (EXPR) BLOCK ... else BLOCK>,
+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<dtrace> compatibility layer has been added and an
+issue with linking C<miniperl> has been fixed in the process.
 
-XXX
+C<less -R> is now used instead of C<less> for C<groff>'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<ext/> and F<lib/> are best summarised in
-L</Modules and Pragmata>.
-
 =over 4
 
 =item *
 
-XXX
-
-=back
-
-=head1 New or Changed Diagnostics
-
-XXX New or changed warnings emitted by the core's C<C> code go here.
-
-=over 4
+Arbitrary whitespace is now allowed between C<NAME> and C<VERSION> in
+C<package NAME VERSION;> statements. (Fixes RT #72432)
 
-=item C<XXX>
+=item *
 
-XXX
+A panic caused by trying to load C<charnames> when the parser is already in
+error (e.g. by a missing C<my> under C<use strict;>) 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</\N{...}/> has been fixed. This was a regression since
+Perl 5.10.
 
-XXX Changes which affect the interface available to C<XS> code go here.
+=item *
 
-=over 4
+A possible SEGV when freeing a scalar that was upgraded to an C<SVt_REGEXP>
+type from a simple(r) scalar has been fixed.
 
 =item *
 
-XXX
+A type conversion bug in C<gmtime64> that caused it to break around C<2**48>
+has been fixed.
 
-=back
+=item *
 
-=head1 New Tests
+Filehandles are now always blessed into C<IO::File>, 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<IO::Handle>
+rather than checking for C<FileHandle> first.
 
-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.
+=item *
 
-=over 4
+A change in C<warnings::register>'s behaviour in Perl 5.10.0 that wasn't
+documented at the time is now documented in L<perl5100delta>. (Fixes RT
+#62522)
 
-=item F<XXX>
+=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 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.
+=head1 New or Changed Diagnostics
 
 =over 4
 
 =item *
 
-XXX
+C<gmtime> and C<localtime> called with numbers smaller than they can reliably
+handle will now issue the warnings C<gmtime(%.0f) too small> and
+C<localtime(%.0f) too small>.
 
 =back
 
-=head1 Deprecations
-
-XXX Add any new known deprecations here.
-
-The following items are now deprecated.
+=head1 New Tests
 
 =over 4
 
-=item *
+=item F<t/op/filehandle.t>
 
-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<t/op/time_loop.t>
 
-=head1 Platform Specific Notes
+Tests that times greater than C<2**63>, which can now be handed to C<gmtime>
+and C<localtime>, 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<perlbug>
 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<perl -V>, 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