This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Nits in perldelta template
[perl5.git] / Porting / perldelta_template.pod
index 59ccaf5..c9d9986 100644 (file)
@@ -11,8 +11,8 @@ This document describes differences between the 5.XXX.XXX release and
 the 5.XXX.XXX release.
 
 If you are upgrading from an earlier release such as 5.XXX.XXX, first read
 the 5.XXX.XXX release.
 
 If you are upgrading from an earlier release such as 5.XXX.XXX, first read
-the L<perl5XXXdelta>, which describes differences between 5.XXX.XXX and
-5.10.0
+L<perl5XXXdelta>, which describes differences between 5.XXX.XXX and
+5.XXX.XXX.
 
 =head1 Notice
 
 
 =head1 Notice
 
@@ -42,40 +42,20 @@ source tree.
 =head1 Modules and Pragmata
 
 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
 =head1 Modules and Pragmata
 
 XXX All changes to installed files in F<cpan/>, F<dist/>, F<ext/> and F<lib/>
-go here, in a list ordered by distribution name. Minimally it should be the
-module version, but it's more useful to the end user to give a paragraph's
-summary of the module's changes. In an ideal world, dual-life modules would
-have a F<Changes> file that could be cribbed.
+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 New Modules and Pragmata
 
-=over 4
-
-=item C<XXX>
-
-XXX
-
-=back
-
 =head2 Pragmata Changes
 
 =head2 Pragmata Changes
 
-=over 4
-
-=item C<XXX>
-
-XXX
-
-=back
-
 =head2 Updated Modules
 
 =head2 Updated Modules
 
-=over 4
-
-=item C<XXX>
-
-XXX
-
-=back
+=head2 Removed Modules and Pragmata
 
 =head1 Utility Changes
 
 
 =head1 Utility Changes