diff --git a/Porting/release_managers_guide.pod b/Porting/release_managers_guide.pod index 102b460a47..76d291bea2 100644 --- a/Porting/release_managers_guide.pod +++ b/Porting/release_managers_guide.pod @@ -717,55 +717,33 @@ F =head4 Update C with module version data for the new release -Note that if this is a MAINT release, you should run the following actions -from the maint branch, but commit the C changes in -I and subsequently cherry-pick any releases since the last -maint release and then your recent commit. XXX need a better example - -[ Note that the procedure for handling Module::CoreList in maint branches -is a bit complex, and the RMG currently don't describe a full and -workable approach. The main issue is keeping Module::CoreList -and its version number synchronised across all maint branches, blead and -CPAN, while having to bump its version number for every RC release. -See this brief p5p thread: - - Message-ID: <20130311174402.GZ2294@iabyn.com> - -If you can devise a workable system, feel free to try it out, and to -update the RMG accordingly! - -DAPM May 2013 ] - -F uses www.cpan.org to verify information about dual-lived -modules on CPAN. It can use a full, local CPAN mirror and/or fall back -on HTTP::Tiny to fetch package metadata remotely. - -(If you'd prefer to have a full CPAN mirror, see -L) - -Change to your perl checkout, and if necessary, - - $ make - -Then, If you have a local CPAN mirror, run: - - $ ./perl -Ilib Porting/corelist.pl ~/my-cpan-mirror - -Otherwise, run: +For BLEAD-POINT, RC and BLEAD-FINAL, run: $ ./perl -Ilib Porting/corelist.pl cpan -This will chug for a while, possibly reporting various warnings about -badly-indexed CPAN modules unrelated to the modules actually in core. -Assuming all goes well, it will update -F and possibly -F. - Check those files over carefully: $ git diff dist/Module-CoreList/lib/Module/CoreList.pm $ git diff dist/Module-CoreList/lib/Module/CoreList/Utils.pm +If you have a L, run: + + $ ./perl -Ilib Porting/corelist.pl ~/my-cpan-mirror + +For MAINT, the prodecure is not straightforward and implies to pick past +updates (e.g. from BLEAD-POINT) into the corelist. + +In practice, you should run the previous actions +from the maint branch, but commit the C changes in +I and subsequently cherry-pick any releases since the last +maint release and then your recent commit. + +The main issue is keeping Module::CoreList +and its version number synchronised across all maint branches, blead and +CPAN, while having to bump its version number for every RC release. + +See L. + =head4 Bump version in Module::CoreList F Also edit Module::CoreList's new version number in its F file. @@ -1567,14 +1545,14 @@ and F. =item * -If you have a local CPAN mirror, run: - - $ ./perl -Ilib Porting/corelist.pl ~/my-cpan-mirror - -Otherwise, run: +In most cases, run: $ ./perl -Ilib Porting/corelist.pl cpan +If you have a L, run: + + $ ./perl -Ilib Porting/corelist.pl ~/my-cpan-mirror + This will update F and F as it did before, but this time adding new sections for the next BLEAD-POINT release.