summaryrefslogtreecommitdiff
path: root/Porting
diff options
context:
space:
mode:
authorDavid Golden <dagolden@cpan.org>2009-12-20 12:29:04 -0500
committerDavid Golden <dagolden@cpan.org>2009-12-20 12:29:04 -0500
commit60984f2fcd55c5a3b23a8abcf5049087f55e5182 (patch)
tree787b209b36b33789676fe7f4d5a07718653faf4b /Porting
parentdb2ed548ed5bb926f271558911ed4d47671ac64b (diff)
downloadperl-60984f2fcd55c5a3b23a8abcf5049087f55e5182.tar.gz
mention Porting/corelist-perldelta.pl in perldelta instructions
Diffstat (limited to 'Porting')
-rw-r--r--Porting/how_to_write_a_perldelta.pod21
-rw-r--r--Porting/perldelta_template.pod3
2 files changed, 11 insertions, 13 deletions
diff --git a/Porting/how_to_write_a_perldelta.pod b/Porting/how_to_write_a_perldelta.pod
index 5627812aca..7ce86d28ce 100644
--- a/Porting/how_to_write_a_perldelta.pod
+++ b/Porting/how_to_write_a_perldelta.pod
@@ -129,23 +129,18 @@ collate changes to F<ext/> and F<lib/> by module, and then summarise all
changes to a module as a group. This can be done by partitioning directories
within F<ext/> and F<lib/> to a number of people.
-B<FIXME> - this could be automated, although the two below would be easier
-to start with.
+B<FIXME> - this could be automated better
-Start with F<Porting/cmpVERSION.pl>
+If Module::CoreList has been updated, then F<Porting/corelist-perldelta.pl>
+will automatically print out this section following a template like this:
-Augment it with a flag, so that instead of reporting which modules are
-different but have the same version, report on modules which I<are> different.
-Grab the old version from the exploded tarball, and the new version from
-the git checkout, and output the line
+ =item C<less>
- =item *
+ Upgraded from version 0.01 to 0.02
- C<less> upgraded from version 0.01 to 0.02
+That's a start and the output can be copied/inserted into the perldelta.
-That's a start.
-
-Once that's done, a more adventurous enhancement is to automate grabbing
+A more adventurous enhancement would be to automate grabbing
the changelogs for dual lived modules. For each of them, grab the relevant
changes files from CPAN for the old and new versions, and if the old one is
a strict subset of the new one, splice the extra lines right into the output,
@@ -208,7 +203,7 @@ For each file only in the newer F<MANIFEST>
=over
-=item 1
+=item 1
Use F<git> to determine its Author
diff --git a/Porting/perldelta_template.pod b/Porting/perldelta_template.pod
index 59ccaf540b..997c0eb203 100644
--- a/Porting/perldelta_template.pod
+++ b/Porting/perldelta_template.pod
@@ -69,6 +69,9 @@ XXX
=head2 Updated Modules
+XXX If Module::CoreList is updated, generate this section using
+F<Porting/corelist-perldelta.pl>
+
=over 4
=item C<XXX>