X-Git-Url: https://git.notmuchmail.org/git?p=notmuch;a=blobdiff_plain;f=RELEASING;h=5c9192c3b5132532b7219570e75cb9f2aedde554;hp=3a1c6ddbcad8522ebbf8b96874faf5503228d94d;hb=f3428823e5cfa8e524e3ea7be8b497020d0693ba;hpb=322eaebabe210c73dd631be1dd6a0a30c3e5e76f diff --git a/RELEASING b/RELEASING index 3a1c6ddb..5c9192c3 100644 --- a/RELEASING +++ b/RELEASING @@ -10,18 +10,7 @@ Here are the steps to follow to create a new notmuch release: not mentioned there. If so, pleas add them, (and ask the authors of the commits to update NEWS in the future). -3) Verify that the notmuch test suite passes. - - Currently this is by running: - - ./test/notmuch-test - - And manually verifying that every test says PASS. We plan to - fix this to automatically check the results and even to - automatically run the test suite as part of a Makefile target - described below. - -4) Increment the libnotmuch library version in lib/Makefile.local +3) Increment the libnotmuch library version in lib/Makefile.local See the instructions there for how to increment it. The command below can be useful for inspecting header-file changes @@ -37,16 +26,13 @@ Here are the steps to follow to create a new notmuch release: Commit this change. -5) Increment the notmuch version in Makefile.local - - For most releases we'll just increment the minor number. For - major milestones of usability we'll increment the major - number. - - Commit this change. +4) Run "make VERSION=X.Y release" which will perform the following steps: -6) Run "make 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. + * Compile the current notmuch code (aborting release if it fails) + * Run the notmuch test suite (aborting release if it fails) * Check that the notmuch version consists of only two components * Check that no release exists with the current version * Verify that "make dist" completes successfully @@ -60,12 +46,13 @@ Here are the steps to follow to create a new notmuch release: the tag with your GPG key (asks for your GPG password, and you may need to set GIT_COMMITTER_NAME and GIT_COMMITTER_EMAIL to match your public-key's setting or this fails.) + * Push that tag * Provide some text for the release announcement (see below). - If for some reason you lost this message, "make release-publish-message" - prints it for you. -7) Increment the notmuch version by adding a .1 micro number, commit, and push. +5) Increment the notmuch version by adding a .1 micro number, commit, and push. -8) Send a message to notmuch@notmuchmail.org to announce the release. +6) Send a message to notmuch@notmuchmail.org to announce the release. - Use the text from the new entry to NEWS. + Use the text provided from "make release" above, (if for some + reason you lose this message, "make release-message" prints + it again for you.