diff options
author | Jesse Vincent <jesse@bestpractical.com> | 2009-08-04 09:43:18 +0100 |
---|---|---|
committer | David Mitchell <davem@iabyn.com> | 2009-08-04 16:44:18 +0100 |
commit | 768fa90448787a4598c7b810da4d031b7649b260 (patch) | |
tree | 69130252f332bf74872f80019a3b49eda4c494fe | |
parent | 7766482c5b536b441f23805f7c9f5abf28b50a2c (diff) | |
download | perl-768fa90448787a4598c7b810da4d031b7649b260.tar.gz |
Improve the broken order of the release_managers_guide
From: Dave Mitchell <davem@iabyn.com>
To: jesse@fsck.com
Cc: perl5-porters@perl.org
Subject: recent changes to Porting/release_managers_guide.pod
Message-ID: <20090803225903.GA4204@iabyn.com>
(cherry picked from commit bfadf2baa9a35d168b478a571ac1865b2330ef7a)
-rw-r--r-- | Porting/release_managers_guide.pod | 176 |
1 files changed, 88 insertions, 88 deletions
diff --git a/Porting/release_managers_guide.pod b/Porting/release_managers_guide.pod index 14e32ba0f2..90f3206df1 100644 --- a/Porting/release_managers_guide.pod +++ b/Porting/release_managers_guide.pod @@ -405,6 +405,94 @@ Be sure to commit your changes: =item * + +I<You MAY SKIP this step for SNAPSHOT> + +Re-read the perldelta to try to find any embarrassing typos and thinkos; +remove any C<TODO> or C<XXX> flags; and run through pod and spell +checkers, e.g. + + podchecker -warnings -warnings pod/perl5101delta.pod + spell pod/perl5101delta.pod + +=item * + +I<You MUST SKIP this step for SNAPSHOT> + +Update patchlevel.h to add a C<-RC1>-or-whatever string; or, if this is a +final release, remove it. [ XXX how now?? see 34813 for old way ] + +=item * + +I<You MUST SKIP this step for SNAPSHOT> + +Update C<Module::Corelist>. + +Note that if this is a maint release, you should run the following actions +from the maint directory, but edit the C<Corelist.pm> in I<blead> and +subsequently cherry-pick it. + +corelist.pl uses ftp.funet.fi to verify information about dual-lifed +modules on CPAN. It can use a full, local CPAN mirror or fall back +to C<wget> or C<curl> to fetch only package metadata remotely. + +(If you'd prefer to have a full CPAN mirror, see +http://www.cpan.org/misc/cpan-faq.html#How_mirror_CPAN) + + +Then change to your perl checkout. + +If you have a local CPAN mirror, run: + + $ make perl + $ ./perl -Ilib Porting/corelist.pl ~/my-cpan-mirror + +Otherwise, run: + + $ make perl + $ ./perl -Ilib Porting/corelist.pl cpan + +This will chug for a while. Assuming all goes well, it will +update lib/Module/CoreList.pm. + +Check that file over carefully: + + $ git diff lib/Module/CoreList.pm + + +If necessary, bump C<$VERSION> (there's no need to do this for +every RC; in RC1, bump the version to a new clean number that will +appear in the final release, and leave as-is for the later RCs and final). + +Edit the version number in the new C<< 'Module::CoreList' => 'X.YZ' >> +entry, as that is likely to reflect the previous version number. + +If this is a final release (rather than a release candidate): + +=over 4 + +=item * + +Update this version's entry in the C<%released> hash with today's date. + +=item * + +Make sure that the script has correctly updated the C<CAVEATS> section + +=back + +Finally, commit the new version of Module::CoreList: + + $ git commit -m 'Updated Module::CoreList for the 5.x.y release' \ + lib/Module/Corelist.pm + + +=item * + +Disarm the patchlevel.h change [ XXX expand ] + +=item * + Build perl, then make sure it passes its own test suite, and installs: $ ./Configure -des -Dusedevel -Dprefix=/tmp/perl-5.x.y-pretest @@ -499,94 +587,6 @@ instead follow the further steps described later.) =item * - -I<You MAY SKIP this step for SNAPSHOT> - -Re-read the perldelta to try to find any embarrassing typos and thinkos; -remove any C<TODO> or C<XXX> flags; and run through pod and spell -checkers, e.g. - - podchecker -warnings -warnings pod/perl5101delta.pod - spell pod/perl5101delta.pod - -=item * - -I<You MUST SKIP this step for SNAPSHOT> - -Update patchlevel.h to add a C<-RC1>-or-whatever string; or, if this is a -final release, remove it. [ XXX how now?? see 34813 for old way ] - -=item * - -I<You MUST SKIP this step for SNAPSHOT> - -Update C<Module::Corelist>. - -Note that if this is a maint release, you should run the following actions -from the maint directory, but edit the C<Corelist.pm> in I<blead> and -subsequently cherry-pick it. - -corelist.pl uses ftp.funet.fi to verify information about dual-lifed -modules on CPAN. It can use a full, local CPAN mirror or fall back -to C<wget> or C<curl> to fetch only package metadata remotely. - -(If you'd prefer to have a full CPAN mirror, see -http://www.cpan.org/misc/cpan-faq.html#How_mirror_CPAN) - - -Then change to your perl checkout. - -If you have a local CPAN mirror, run: - - $ make perl - $ ./perl -Ilib Porting/corelist.pl ~/my-cpan-mirror - -Otherwise, run: - - $ make perl - $ ./perl -Ilib Porting/corelist.pl cpan - -This will chug for a while. Assuming all goes well, it will -update lib/Module/CoreList.pm. - -Check that file over carefully: - - $ git diff lib/Module/CoreList.pm - - -If necessary, bump C<$VERSION> (there's no need to do this for -every RC; in RC1, bump the version to a new clean number that will -appear in the final release, and leave as-is for the later RCs and final). - -Edit the version number in the new C<< 'Module::CoreList' => 'X.YZ' >> -entry, as that is likely to reflect the previous version number. - -If this is a final release (rather than a release candidate): - -=over 4 - -=item * - -Update this version's entry in the C<%released> hash with today's date. - -=item * - -Make sure that the script has correctly updated the C<CAVEATS> section - -=back - -Finally, commit the new version of Module::CoreList: - - $ git commit -m 'Updated Module::CoreList for the 5.x.y release' \ - lib/Module/Corelist.pm - - -=item * - -Disarm the patchlevel.h change [ XXX expand ] - -=item * - I<You MAY SKIP this step for SNAPSHOT> Wait for the smoke tests to catch up with the commit which this release is |