diff --git a/Porting/release_managers_guide.pod b/Porting/release_managers_guide.pod index 102b460a4776..c7452a62e14c 100644 --- a/Porting/release_managers_guide.pod +++ b/Porting/release_managers_guide.pod @@ -717,55 +717,23 @@ 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: +In most cases, 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 + +The procedure for MAINT releases is not straighforward and implies to pick past +updates (e.g. from BLEAD-POINT) into the corelist. See +L. + =head4 Bump version in Module::CoreList F Also edit Module::CoreList's new version number in its F file. @@ -1567,13 +1535,13 @@ and F. =item * -If you have a local CPAN mirror, run: +In most cases, run: - $ ./perl -Ilib Porting/corelist.pl ~/my-cpan-mirror + $ ./perl -Ilib Porting/corelist.pl cpan -Otherwise, run: +If you have a L, run: - $ ./perl -Ilib Porting/corelist.pl cpan + $ ./perl -Ilib Porting/corelist.pl ~/my-cpan-mirror This will update F and F as it did before,