This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Get perldelta into mostly finished state
authorFlorian Ragwitz <rafl@debian.org>
Thu, 20 Oct 2011 15:58:47 +0000 (08:58 -0700)
committerFlorian Ragwitz <rafl@debian.org>
Thu, 20 Oct 2011 19:18:23 +0000 (12:18 -0700)
pod/perldelta.pod

index d8036fb..1ad59a0 100644 (file)
@@ -1,18 +1,7 @@
 =encoding utf8
 
 =encoding utf8
 
-=for comment
-This has been completed up to c19fd8b40, except for:
-d9018cbe5b480ba29cc6151aba8f5102a7e009c4 (Eric Brine)
-    -- while I (use git blame to find out who) see how this change within
-       lex_read_unichar is correct, I cannot tell at a glance what visible
-       effects this bug has at the Perl level or through the lexer API.
-be48bbe8d671b6841c3ec7cb734b98071afe3cd9 (Chip)
-
 =head1 NAME
 
 =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.4
 
 =head1 DESCRIPTION
 perldelta - what is new for perl v5.15.4
 
 =head1 DESCRIPTION
@@ -24,10 +13,6 @@ If you are upgrading from an earlier release such as 5.15.3, first read
 L<perl5153delta>, which describes differences between 5.15.3 and
 5.15.4.
 
 L<perl5153delta>, which describes differences between 5.15.3 and
 5.15.4.
 
-=head1 Notice
-
-XXX Any important notices here
-
 =head1 Core Enhancements
 
 =head2 $^X converted to an absolute path on FreeBSD, OS X and Solaris
 =head1 Core Enhancements
 
 =head2 $^X converted to an absolute path on FreeBSD, OS X and Solaris
@@ -192,38 +177,8 @@ in your C<TYPEMAP> section:
 
   HV*  T_HVREF_REFCOUNT_FIXED
 
 
   HV*  T_HVREF_REFCOUNT_FIXED
 
-=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 reports are welcome.
-
-[ List each incompatible change as a =head2 entry ]
-
-=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</Modules and Pragmata> section.
-
-[ List each 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 *
@@ -235,26 +190,6 @@ context.
 
 =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
@@ -315,35 +250,10 @@ Newly supported locales: as, fi__phonebook, gu, hi, kn, kok and ln.
 
 =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<perlfunc>, L<open>
 
 =over 4
 =head3 L<perlfunc>, L<open>
 
 =over 4
@@ -366,6 +276,10 @@ it has been documented in L<perlfunc|perlfunc/open> and L<open>.
 The HV API has long accepted negative lengths to indicate that the key is
 in UTF8.  Now this is documented.
 
 The HV API has long accepted negative lengths to indicate that the key is
 in UTF8.  Now this is documented.
 
+=item *
+
+The C<boolSV()> macro is now documented.
+
 =back
 
 =head3 L<perlguts>
 =back
 
 =head3 L<perlguts>
@@ -386,45 +300,8 @@ 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>.
 
 including warnings and fatal error messages.  For the complete list of
 diagnostic messages, see L<perldiag>.
 
-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.
-
-[ Within each section, list entries as a =item entry that links to perldiag,
-  e.g.
-
-  =item *
-
-  L<Invalid version object|perldiag/"Invalid version object">
-]
-
-=head2 New Diagnostics
-
-XXX Newly added diagnostic messages go here
-
-=head3 New Errors
-
-=over 4
-
-=item *
-
-XXX L<message|perldiag/"message">
-
-=back
-
-=head3 New Warnings
-
-=over 4
-
-=item *
-
-XXX L<message|perldiag/"message">
-
-=back
-
 =head2 Changes to Existing Diagnostics
 
 =head2 Changes to Existing Diagnostics
 
-XXX Changes (i.e. rewording) of diagnostic messages go here
-
 =over 4
 
 =item *
 =over 4
 
 =item *
@@ -434,55 +311,10 @@ The message,
 prop erties do" has been changed to "Code point 0x%X is not Unicode, all
 \p{} matches fail; all \P{} matches succeed"
 
 prop erties do" has been changed to "Code point 0x%X is not Unicode, all
 \p{} matches fail; all \P{} matches succeed"
 
-
-=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 *
-
-XXX
-
-=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
-
 =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 summarising, although the bugs
-that they represent may be covered elsewhere.
-
-[ List each test improvement as a =item entry ]
-
 =over 4
 
 =item *
 =over 4
 
 =item *
@@ -493,63 +325,8 @@ F<config.h>, and an incomplete input file will generate invalid output.
 
 =back
 
 
 =back
 
-=head1 Platform Support
-
-XXX Any changes to platform support should be listed in the sections below.
-
-[ Within the sections, list each platform as a =item entry with specific
-changes as paragraphs below it. ]
-
-=head2 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.
-
-=over 4
-
-=item XXX-some-platform
-
-XXX
-
-=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
-
-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 XXX-some-platform
-
-XXX
-
-=back
-
 =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 *
@@ -632,12 +409,6 @@ MRO plugin provided [perl #94306].
 
 =head1 Selected Bug Fixes
 
 
 =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>.
-
-[ List each fix as a =item entry ]
-
 =over 4
 
 =item *
 =over 4
 
 =item *
@@ -738,31 +509,6 @@ C<..> and C<...> in list context now mention the name of the variable in
 
 =back
 
 
 =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.
-
-[ List each fix as a =item entry ]
-
-=over 4
-
-=item *
-
-XXX A couple of modules were broken by stdbool.h changes, or was that in
-5.15.3?
-
-=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: