doc: update release procedure
authorJim Meyering <meyering@redhat.com>
Fri, 18 Mar 2011 09:18:01 +0000 (10:18 +0100)
committerJim Meyering <meyering@redhat.com>
Fri, 18 Mar 2011 09:18:01 +0000 (10:18 +0100)
* README-release: Resync from coreutils' file by the same name.

README-release

index f336ac8e8910db8c2bea5b3c3e51723d27d59e3f..3b26e5addcb9a387591723af0f44a4469d2a2ca4 100644 (file)
@@ -13,6 +13,11 @@ Here are most of the steps we (maintainers) follow when making a release.
 * Ensure that you're on "master" with no uncommitted diffs.
   This should produce no output: git checkout master; git diff
 
+* Ensure that you've pushed all changes that belong in the release
+  and that the NixOS/Hydra autobuilder is reporting all is well:
+
+      http://hydra.nixos.org/jobset/gnu/gzip-master
+
 * Run bootstrap one last time.  This downloads any new translations:
 
     ./bootstrap
@@ -25,7 +30,7 @@ Here are most of the steps we (maintainers) follow when making a release.
 * Set the date, version number, and release type [stable/alpha/beta] on
   line 3 of NEWS, commit that, and tag the release by running e.g.,
 
-    build-aux/do-release-commit-and-tag 8.1 beta
+    build-aux/do-release-commit-and-tag X.Y stable
 
 * Run the following to create release tarballs.  Your choice selects the
   corresponding upload-to destination in the emitted gnupload command.
@@ -39,7 +44,8 @@ Here are most of the steps we (maintainers) follow when making a release.
   it builds and passes all tests.
 
 * While that's happening, write the release announcement that you will
-  soon post.
+  soon post.  Start with the template, $HOME/announce-gzip-X.Y
+  that was just created by that "make" command.
 
 Once all the builds and tests have passed,
 
@@ -54,13 +60,9 @@ Once all the builds and tests have passed,
     v=$(cat .prev-version)
     git push origin master tag v$v
 
-* Send the gpg-signed announcement mail, e.g.,
-
-    To: info-gnu@gnu.org
-    Cc: coordinator@translationproject.org, bug-gzip@gnu.org
-    Subject: gzip-1.3.13 released [stable]
+* Announce it on Savannah first, so you can include the preferable
+  savannah.org announcement link in the email message.
 
-* Announce it on Savannah, too:
   From here:
     https://savannah.gnu.org/projects/gzip/
   click on the "submit news", then write something like the following:
@@ -68,13 +70,19 @@ Once all the builds and tests have passed,
    the Main -> "Select Features" menu item, or via this link:
    https://savannah.gnu.org/project/admin/editgroupfeatures.php?group=gzip)
 
-    Subject: gzip-1.3.13 released [stable]
-    The announcement is here:
-      http://article.gmane.org/gmane.comp.gnu.gzip.bugs/258
+    Subject: gzip-X.Y released [stable]
+    +verbatim+
+    ...paste the announcement here...
+    -verbatim-
 
   Then go here to approve it:
     https://savannah.gnu.org/news/approve.php?group=gzip
 
+* Send the announcement email message.
+
+* Approve the announcement here:
+  http://lists.gnu.org/mailman/admindb/gzip-announce
+
 * After each non-alpha release, update the on-line manual accessible via
 
     http://www.gnu.org/software/gzip/manual/