This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Release engineering work on perldelta
authorChris 'BinGOs' Williams <chris@bingosnet.co.uk>
Wed, 20 Nov 2013 12:48:25 +0000 (12:48 +0000)
committerChris 'BinGOs' Williams <chris@bingosnet.co.uk>
Wed, 20 Nov 2013 13:10:07 +0000 (13:10 +0000)
pod/perldelta.pod

index 7f9d3e2..1003f92 100644 (file)
@@ -1,14 +1,7 @@
-=for todo
-35e037e846 Commit 1735f6f started to escape all...
-9b4bdfd44e fix chop formats with non PV vars
-
 =encoding utf8
 
 =head1 NAME
 
 =encoding utf8
 
 =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.19.6
 
 =head1 DESCRIPTION
 perldelta - what is new for perl v5.19.6
 
 =head1 DESCRIPTION
@@ -19,18 +12,8 @@ release.
 If you are upgrading from an earlier release such as 5.19.4, first read
 L<perl5195delta>, which describes differences between 5.19.4 and 5.19.5.
 
 If you are upgrading from an earlier release such as 5.19.4, first read
 L<perl5195delta>, which describes differences between 5.19.4 and 5.19.5.
 
-=head1 Notice
-
-XXX Any important notices here
-
 =head1 Core Enhancements
 
 =head1 Core Enhancements
 
-XXX New core language features go here.  Summarize user-visible core language
-enhancements.  Particularly prominent performance optimisations could go
-here, but most should go in the L</Performance Enhancements> section.
-
-[ List each enhancement as a =head2 entry ]
-
 =head2 $a and $b warnings exemption
 
 The special variables $a and $b, used in C<sort>, are now exempt from "used
 =head2 $a and $b warnings exemption
 
 The special variables $a and $b, used in C<sort>, are now exempt from "used
@@ -38,32 +21,10 @@ once" warnings, even where C<sort> is not used.  This makes it easier for
 CPAN modules to provide functions using $a and $b for similar purposes.
 [perl #120462]
 
 CPAN modules to provide functions using $a and $b for similar purposes.
 [perl #120462]
 
-=head1 Security
-
-XXX Any security-related notices go here.  In particular, any security
-vulnerabilities closed should be noted here rather than in the
-L</Selected Bug Fixes> section.
-
-[ List each security issue as a =head2 entry ]
-
-=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 we request that you submit a
-    report.  See L</Reporting Bugs> below.
-
-[ List each incompatible change as a =head2 entry ]
-
 =head1 Deprecations
 
 =head1 Deprecations
 
-XXX Any deprecated features, syntax, modules etc. should be listed here.
-
 =head2 Module removals
 
 =head2 Module removals
 
-XXX Remove this section if inapplicable.
-
 The following modules will be removed from the core distribution in a
 future release, and will at that time need to be installed from CPAN.
 Distributions on CPAN which require these modules will need to list them as
 The following modules will be removed from the core distribution in a
 future release, and will at that time need to be installed from CPAN.
 Distributions on CPAN which require these modules will need to list them as
@@ -84,15 +45,8 @@ not usually on concerns over their design.
 
 =back
 
 
 =back
 
-[ List each other deprecation as a =head2 entry ]
-
 =head1 Performance Enhancements
 
 =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 *
 =over 4
 
 =item *
@@ -112,26 +66,6 @@ short circuit directly to the end of the statement. [perl #120128]
 
 =head1 Modules and Pragmata
 
 
 =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.
-
-[ Within each section, list entries as a =item entry ]
-
-=head2 New Modules and Pragmata
-
-=over 4
-
-=item *
-
-XXX
-
-=back
-
 =head2 Updated Modules and Pragmata
 
 =over 4
 =head2 Updated Modules and Pragmata
 
 =over 4
@@ -176,6 +110,13 @@ updates its internal state and returns the correct value.  [perl #75156]
 
 =item *
 
 
 =item *
 
+L<Locale::Maketext> has been upgraded from version 1.24 to 1.25.
+
+An issue with escaped backslashes if the literal is compiled as
+function argument has been resolved.
+
+=item *
+
 L<Module::CoreList> has been upgraded from version 3.00 to 3.01.
 
 The list of Perl versions covered has been updated.
 L<Module::CoreList> has been upgraded from version 3.00 to 3.01.
 
 The list of Perl versions covered has been updated.
@@ -198,82 +139,37 @@ It no longer ignores the offset passed to C<syswrite>.
 
 =back
 
 
 =back
 
-=head2 Removed Modules and Pragmata
-
-=over 4
-
-=item *
-
-XXX
-
-=back
-
 =head1 Documentation
 
 =head1 Documentation
 
-XXX Changes to files in F<pod/> go here.  Consider grouping entries by
-file and be sure to link to the appropriate page, e.g. L<perlfunc>.
-
-=head2 New Documentation
-
-XXX Changes which create B<new> files in F<pod/> go here.
-
-=head3 L<XXX>
-
-XXX Description of the purpose of the new file here
-
 =head2 Changes to Existing Documentation
 
 =head2 Changes to Existing Documentation
 
-XXX Changes which significantly change existing files in F<pod/> go here.
-However, any changes to F<pod/perldiag.pod> should go in the L</Diagnostics>
-section.
-
-=head3 L<XXX>
-
 =over 4
 
 =item *
 
 =over 4
 
 =item *
 
-XXX Description of the change here
-
-=back
-
-=head1 Diagnostics
-
-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<perldiag>.
+L<perlhacktips> has been updated to include some more examples of C<gdb> usage.
 
 
-XXX New or changed warnings emitted by the core's C<C> code go here.  Also
-include any changes in L<perldiag> that reconcile it to the C<C> code.
-
-=head2 New Diagnostics
+=item *
 
 
-XXX Newly added diagnostic messages go under here, separated into New Errors
-and New Warnings
+L<perlfunc>:
 
 
-=head3 New Errors
+C<each>, clarify hash "modify while iterating".
 
 
-=over 4
+C<pack>, the documentation for verbatim tables has been clarified.
 
 =item *
 
 
 =item *
 
-XXX L<message|perldiag/"message">
-
-=back
-
-=head3 New Warnings
-
-=over 4
+L<perlre>, the documentation for C</x> and C<(?# comment)> has been expanded and clarified.
 
 =item *
 
 
 =item *
 
-XXX L<message|perldiag/"message">
+L<perllexwarn>, a note has been added to users of C<FATAL> warnings of the risk of upgrades.
 
 =back
 
 
 =back
 
-=head2 Changes to Existing Diagnostics
+=head1 Diagnostics
 
 
-XXX Changes (i.e. rewording) of diagnostic messages go here
+=head2 Changes to Existing Diagnostics
 
 =over 4
 
 
 =over 4
 
@@ -285,54 +181,17 @@ This warning now occurs for any C<%array[$index]> or C<%hash{key}> known to
 be in scalar context at compile time.  Previously it was worded "Scalar
 value %%s[%s] better written as $%s[%s]".
 
 be in scalar context at compile time.  Previously it was worded "Scalar
 value %%s[%s] better written as $%s[%s]".
 
-=back
-
-=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>.
-
-[ List utility changes as a =head3 entry for each utility and =item
-entries for each change
-Use L<XXX> with program names to get proper documentation linking. ]
-
-=head3 L<XXX>
-
-=over 4
-
 =item *
 
 =item *
 
-XXX
+L<Switch condition not recognized in regex; marked by <-- HERE in mE<sol>%sE<sol>|perldiag/"Switch condition not recognized in regex; marked by <-- HERE in m/%s/">:
 
 
-=back
-
-=head1 Configuration and Compilation
-
-XXX Changes to F<Configure>, F<installperl>, F<installman>, and analogous tools
-go here.  Any other changes to the Perl build process should be listed here.
-However, any platform-specific changes should be listed in the
-L</Platform Support> section, instead.
-
-[ List changes as a =item entry ].
-
-=over 4
-
-=item *
-
-XXX
+The description for this diagnostic has been extended to cover all cases where the warning may occur.
+Issues with the positioning of the arrow indicator have also been resolved.
 
 =back
 
 =head1 Testing
 
 
 =back
 
 =head1 Testing
 
-XXX Any significant changes to the testing of a freshly built perl should be
-listed here.  Changes which create B<new> files in F<t/> go here as do any
-large changes to the testing harness (e.g. when parallel testing was added).
-Changes to existing files in F<t/> aren't worth summarizing, although the bugs
-that they represent may be covered elsewhere.
-
-[ List each test improvement as a =item entry ]
-
 =over 4
 
 =item *
 =over 4
 
 =item *
@@ -358,25 +217,8 @@ should build now. The basic problems are the non-standard location for tools.
 
 =back
 
 
 =back
 
-=head2 Discontinued Platforms
-
-XXX List any platforms that this version of perl no longer compiles on.
-
-=over 4
-
-=item XXX-some-platform
-
-XXX
-
-=back
-
 =head2 Platform-Specific Notes
 
 =head2 Platform-Specific Notes
 
-XXX List any changes for specific platforms.  This could include configuration
-and compilation changes or changes in portability/compatibility.  However,
-changes within modules for platforms should generally be listed in the
-L</Modules and Pragmata> section.
-
 =over 4
 
 =item Windows
 =over 4
 
 =item Windows
@@ -401,12 +243,6 @@ can also be built using Smart Devices for Visual C++ 2005 or 2008.
 
 =head1 Internal Changes
 
 
 =head1 Internal Changes
 
-XXX Changes which affect the interface available to C<XS> code go here.  Other
-significant internal changes for future core maintainers should be noted as
-well.
-
-[ List each change as a =item entry ]
-
 =over 4
 
 =item *
 =over 4
 
 =item *
@@ -419,11 +255,6 @@ C89 compilers.  [perl #120314]
 
 =head1 Selected Bug Fixes
 
 
 =head1 Selected Bug Fixes
 
-XXX Important bug fixes in the core language are summarized here.  Bug fixes in
-files in F<ext/> and F<lib/> are best summarized in L</Modules and Pragmata>.
-
-[ List each fix as a =item entry ]
-
 =over 4
 
 =item *
 =over 4
 
 =item *
@@ -606,15 +437,16 @@ Some cases of unterminated (?...) sequences in regular expressions (e.g.,
 C</(?</>) have been fixed to produce the proper error message instead of
 "panic: memory wrap".  Other cases (e.g., C</(?(/>) have yet to be fixed.
 
 C</(?</>) have been fixed to produce the proper error message instead of
 "panic: memory wrap".  Other cases (e.g., C</(?(/>) have yet to be fixed.
 
-=back
+=item *
 
 
-=head1 Known Problems
+Strange vars like ties, overloads, or stringified refs (and in recent
+perls, pure NOK vars) would generally do the wrong thing in formats
+when the var is treated as a string and repeatedly chopped, as in
+^<<<~~ and similar. This has now been resolved.
 
 
-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.  Unfixed
-platform specific bugs also go here.
+=back
 
 
-[ List each fix as a =item entry ]
+=head1 Known Problems
 
 =over 4
 
 
 =over 4
 
@@ -627,11 +459,6 @@ I<bareword>()> is inconsistent.)  This will likely be changed back.
 
 =back
 
 
 =back
 
-=head1 Obituary
-
-XXX If any significant core contributor has died, we've added a short obituary
-here.
-
 =head1 Acknowledgements
 
 XXX Generate this with:
 =head1 Acknowledgements
 
 XXX Generate this with: