From ac3dcac7e6d18b787fc65d02a3aa8db3eba805b4 Mon Sep 17 00:00:00 2001 From: Carl Worth Date: Fri, 16 Apr 2010 10:23:50 -0700 Subject: [PATCH] RELEASING: Add a (manual!) step to create a debian/changelog entry I'd like to have this be fully automated in the future, but for now, it's an extra step. --- RELEASING | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/RELEASING b/RELEASING index fbee322a..99c6d79e 100644 --- a/RELEASING +++ b/RELEASING @@ -35,7 +35,21 @@ repository. From here, there are just a few steps to release: Commit this change, if any. -3) Run "make VERSION=X.Y release" which will perform the following steps: +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. + + 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. @@ -58,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