This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
release_managers_guide: remove SNAPSHOT
authorDavid Mitchell <davem@iabyn.com>
Wed, 18 May 2011 20:15:23 +0000 (21:15 +0100)
committerDavid Mitchell <davem@iabyn.com>
Wed, 18 May 2011 22:28:35 +0000 (23:28 +0100)
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.

Porting/release_managers_guide.pod

index c1754a9..c51b204 100644 (file)
@@ -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,