X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=RELEASING;h=99c6d79ecb86812471fab6adefe795ce42ace68a;hb=ac3dcac7e6d18b787fc65d02a3aa8db3eba805b4;hp=f47ba39c520b7d0272a2044d72c94361019a9566;hpb=00263dd1a9e08ab1fa947fa58d1c2ad62e8b9653;p=notmuch

diff --git a/RELEASING b/RELEASING
index f47ba39c..99c6d79e 100644
--- a/RELEASING
+++ b/RELEASING
@@ -16,13 +16,16 @@ repository. From here, there are just a few steps to release:
 	not mentioned there. If so, pleas add them, (and ask the
 	authors of the commits to update NEWS in the future).
 
-2) Increment the libnotmuch library version in lib/Makefile.local
+2) Verify that the library version in lib/Makefile.local is correct
 
-	See the instructions there for how to increment it. The
-	command below can be useful for inspecting header-file changes
-	since the last release X.Y.Z:
+	See the instructions there for how to increment it.
 
-		git diff X.Y.Z..HEAD -- lib/notmuch.h
+	The version should have been updated with any commits that
+	added API, but do check that that is the case. The command
+	below can be useful for inspecting header-file changes since
+	the last release X.Y:
+
+		git diff X.Y..HEAD -- lib/notmuch.h
 
 	Note: We currently don't plan to increment
 	LIBNOTMUCH_VERSION_MAJOR beyond 1, so if there *are*
@@ -30,9 +33,23 @@ repository. From here, there are just a few steps to release:
 	stop. Don't release. Figure out the plan on the notmuch
 	mailing list.
 
+	Commit this change, if any.
+
+3) Create an entry for the new release in debian/changelog
+
+	The syntax of this file is tightly restricted, but the
+	available emacs mode (see the dpkg-dev-el package helps).  The
+	entries here will be the Debian-relevant single-line
+	description of changes from the NEWS entry. And the version
+	must match the version in the next step.
+
 	Commit this change.
 
-3) Run "make VERSION=X.Y release" which will perform the following steps:
+	XXX: It would be great if this step were automated as part of
+	release, (taking entries from NEWS and the version from the
+	VERSION, and creating a new commit).
+
+4) Run "make VERSION=X.Y release" which will perform the following steps:
 
    For the X.Y version, we'll generally just increment Y. But for
    major milestones of usability we're increment X as well.
@@ -55,7 +72,7 @@ repository. From here, there are just a few steps to release:
 	* Push that tag
 	* Provide some text for the release announcement (see below).
 
-4) Send a message to notmuch@notmuchmail.org to announce the release.
+5) Send a message to notmuch@notmuchmail.org to announce the release.
 
 	Use the text provided from "make release" above, (if for some
 	reason you lose this message, "make release-message" prints