diff options
author | David Mitchell <davem@iabyn.com> | 2011-05-18 21:15:23 +0100 |
---|---|---|
committer | David Mitchell <davem@iabyn.com> | 2011-05-18 23:28:35 +0100 |
commit | b1288acc790a0d53bbcfb821fded7a8004b1f3ac (patch) | |
tree | 56acd50ee724f5fdb053cbaddb86a9007f2bf805 /Porting/release_managers_guide.pod | |
parent | f7010667d1407014dba2e28da79d92e9c090fd09 (diff) | |
download | perl-b1288acc790a0d53bbcfb821fded7a8004b1f3ac.tar.gz |
release_managers_guide: remove SNAPSHOT
Now that we make regular blead releases, we no longer need to make
snapshot releases. So remove the instructions for SNAPSHOT that
litter release_managers_guide.pod.
Diffstat (limited to 'Porting/release_managers_guide.pod')
-rw-r--r-- | Porting/release_managers_guide.pod | 62 |
1 files changed, 8 insertions, 54 deletions
diff --git a/Porting/release_managers_guide.pod b/Porting/release_managers_guide.pod index c1754a9b8a..c51b204c9f 100644 --- a/Porting/release_managers_guide.pod +++ b/Porting/release_managers_guide.pod @@ -30,11 +30,6 @@ The outline of a typical release cycle is as follows: ...time passes... - an occasional snapshot is released, that still identifies itself as - 5.10.1 - - ...time passes... - a few weeks before the release, a number of steps are performed, including bumping the version to 5.10.2 @@ -51,8 +46,8 @@ The outline of a typical release cycle is as follows: =head1 DETAILS -Some of the tasks described below apply to all four types of -release of Perl. (snapshot, RC, final release of maint, final +Some of the tasks described below apply to all three types of +release of Perl. (RC, final release of maint, final release of blead). Some of these tasks apply only to a subset of these release types. If a step does not apply to a given type of release, you will see a notation to that effect at @@ -62,13 +57,6 @@ the beginning of the step. =over 4 -=item Snapshot - -A snapshot is intended to encourage in-depth testing from time-to-time, -for example after a key point in the stabilisation of a branch. It -requires fewer steps than a full release, and the version number of perl in -the tarball will usually be the same as that of the previous release. - =item Release Candidate (RC) A release candidate is an attempt to produce a tarball that is a close as @@ -103,8 +91,6 @@ hoops you need to jump through: =item PAUSE account -I<SKIP this step for SNAPSHOT> - Make sure you have a PAUSE account suitable for uploading a perl release. If you don't have a PAUSE account, then request one: @@ -144,11 +130,10 @@ resolve the issue. =item Quotation for release announcement epigraph -I<SKIP this step for SNAPSHOT and RC> +I<SKIP this step for RC> For a numbered blead or maint release of perl, you will need a quotation -to use as an epigraph to your release announcement. (There's no harm -in having one for a snapshot, but it's not required). +to use as an epigraph to your release announcement. =back @@ -165,8 +150,6 @@ done in the run up to a release. =item * -I<You MAY SKIP this step for SNAPSHOT> - Ensure that dual-life CPAN modules are synchronised with CPAN. Basically, run the following: @@ -190,8 +173,6 @@ have some extra changes. =item * -I<You MAY SKIP this step for SNAPSHOT> - Ensure dual-life CPAN modules are stable, which comes down to: for each module that fails its regression tests on $current @@ -214,8 +195,6 @@ Ensure dual-life CPAN modules are stable, which comes down to: =item * -I<You MAY SKIP this step for SNAPSHOT> - Similarly, monitor the smoking of core tests, and try to fix. See L<http://doc.procura.nl/smoke/index.html> for a summary. See also L<http://www.nntp.perl.org/group/perl.daily-build.reports/> which has @@ -223,15 +202,11 @@ the raw reports. =item * -I<You MAY SKIP this step for SNAPSHOT> - Similarly, monitor the smoking of perl for compiler warnings, and try to fix. =item * -I<You MAY SKIP this step for SNAPSHOT> - Get perldelta in a mostly finished state. Read F<Porting/how_to_write_a_perldelta.pod>, and try to make sure that @@ -240,8 +215,6 @@ edit the whole document. =item * -I<You MUST SKIP this step for SNAPSHOT> - Bump the version number (e.g. from 5.12.0 to 5.12.1). For a blead release, this can happen on the day of the release. For a @@ -322,8 +295,6 @@ version number. =item * -I<You MUST SKIP this step for SNAPSHOT> - Review and update INSTALL to account for the change in version number; in particular, the "Coexistence with earlier versions of perl 5" section. @@ -334,8 +305,6 @@ release. =item * -I<You MUST SKIP this step for SNAPSHOT> - Update the F<Changes> file to contain the git log command which would show all the changes in this release. You will need assume the existence of a not-yet created tag for the forthcoming release; e.g. @@ -369,8 +338,6 @@ XXX think of other configurations that need testing. =item * -I<You MAY SKIP this step for SNAPSHOT> - L<perlport> has a section currently named I<Supported Platforms> that indicates which platforms are known to build in the current release. If necessary update the list and the indicated version number. @@ -379,8 +346,8 @@ If necessary update the list and the indicated version number. =head2 Building a release - on the day -This section describes the actions required to make a release (or snapshot -etc) that are performed on the actual day. +This section describes the actions required to make a release +that are performed on the actual day. =over 4 @@ -397,8 +364,6 @@ of I<advance actions>, do that now. =item * -I<You MAY SKIP this step for SNAPSHOT> - Finalize the perldelta. In particular, fill in the Acknowledgements section. You can generate a list of contributors with checkAUTHORS.pl. For example: @@ -449,8 +414,6 @@ and porting tools: =item * -I<You MUST SKIP this step for SNAPSHOT> - Update C<Module::CoreList> with module version data for the new release. Note that if this is a maint release, you should run the following actions @@ -548,8 +511,6 @@ If manicheck turns up anything wrong, update MANIFEST and begin this step again. =item * -I<You MUST SKIP this step for SNAPSHOT> - Add an entry to F<pod/perlhist.pod> with the current date, e.g.: David 5.10.1-RC1 2009-Aug-06 @@ -565,7 +526,7 @@ Be sure to commit your changes: =item * -I<You MUST SKIP this step for SNAPSHOT or BLEAD release> +I<You MUST SKIP this step for a BLEAD release> Update F<patchlevel.h> to add a C<-RC1>-or-whatever string; or, if this is a final release, remove it. For example: @@ -611,8 +572,6 @@ Push all your recent commits: =item * -I<You MUST SKIP this step for SNAPSHOT> - Tag the release (e.g.): $ git tag v5.11.0 -m "First release of the v5.11 series!" @@ -633,7 +592,6 @@ the tarball and directory name: $ git clean -xdf # make sure perl and git agree on files $ git status # and there's nothing lying around - $ perl Porting/makerel -b -s `git describe` # for a snapshot $ perl Porting/makerel -b -s RC1 # for a release candidate $ perl Porting/makerel -b # for a final release @@ -773,10 +731,6 @@ Install an XS module, for example: =item * -I<If you're building a SNAPSHOT, you should STOP HERE> - -=item * - Check that the L<perlbug> utility works. Try the following: $ bin/perlbug @@ -855,7 +809,7 @@ time to publish the tag you created earlier to the public git repo (e.g.): =item * -I<You MUST SKIP this step for SNAPSHOT or BLEAD release> +I<You MUST SKIP this step for BLEAD release> Disarm the F<patchlevel.h> change; for example, |