Upgrade to CGI.pm 3.49
[p5sagit/p5-mst-13.2.git] / Porting / perldelta_template.pod
index 59ccaf5..1bf8c57 100644 (file)
@@ -1,3 +1,5 @@
+=encoding utf8
+
 =head1 NAME
 
 [ this is a template for a new perldelta file. Any text flagged as
@@ -11,8 +13,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 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
 
@@ -42,40 +44,20 @@ source tree.
 =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
 
-=over 4
-
-=item C<XXX>
-
-XXX
-
-=back
-
 =head2 Pragmata Changes
 
-=over 4
-
-=item C<XXX>
-
-XXX
-
-=back
-
 =head2 Updated Modules
 
-=over 4
-
-=item C<XXX>
-
-XXX
-
-=back
+=head2 Removed Modules and Pragmata
 
 =head1 Utility Changes