From a3c12f4ccfda470574bfe8b7796c0b90237dabe0 Mon Sep 17 00:00:00 2001 From: =?utf8?q?S=C3=B8ren=20Sandmann=20Pedersen?= Date: Wed, 25 Jun 2008 09:36:13 -0400 Subject: [PATCH] Update release instructions --- RELEASING | 67 +++++++++++++++++++++++++++++++++++++-------------------------- 1 file changed, 39 insertions(+), 28 deletions(-) diff --git a/RELEASING b/RELEASING index 34d549b..5e7cec1 100644 --- a/RELEASING +++ b/RELEASING @@ -4,46 +4,57 @@ Here are the steps to follow to create a new pixman release: and that you are up to date with the latest commits in the central repository. Here are a couple of useful commands: - # This should report "nothing to commit (working directory clean") - git status + git diff (no output) + + git status (should report "nothing to commit") - # This should give no output, (note there are *3* dots) - git log master...origin + git log master...origin (no output; note: *3* dots) -2) Verify that the code passes "make distcheck". +2) Increment pixman_(major|minor|micro) in configure.ac according to + the directions in that file. - NOTE: There is some test code in the test directory, but it's - not yet integrated into "make distcheck" yet. It might be - useful to run those programs, (but I don't know how to - interpret those results). Another very useful thing to do is - to run the cairo test suite against pixman. This can be done - by running the following commands with the latest cairo - release: +3) Run - tar xzf cairo-X.Y.Z.tar.gz - cd cairo - CAIRO_TEST_TARGET=image make test + make PREV= release-check -4) Increment pixman_{major|minor|micro} in configure.ac according to - the directions in that file. Also note that if there is an ABI - change then there is further work to be done, (also described in - configure.in). + and fix things until it passes. -5) Use "git commit" record any changes made in steps 3 and 4. + A very useful thing to do is to run the cairo test suite + against pixman. This can be done by running the following + commands in the "test" directory of the latest cairo release: -6) Generate the final tar files with + tar xzf cairo-X.Y.Z.tar.gz + cd cairo + CAIRO_TEST_TARGET=image make test + +4) Use "git commit" to record any changes made in steps 2 and 3. + +5) Generate the final tar files with make distcheck - And publish the tar files to everywhere appropriate. + and publish the tar files by running - Note: There's a "make release-publish" target to help with this - step, (creating the tar file and publishing it), but it depends on - getting gpg setup first. It's probably the right way to go in the - future, though. + make GPGKEY= release-publish 7) Increment pixman_micro to the next larger (odd) number in configure.ac. Commit this change, and push all commits created - during this process. + during this process using + + git push --tags + + You must use "--tags" here; otherwise the new tag will not + be pushed out. This is because technobable. + +8) Run + + make release-publish-message + + to generate a draft release announcement. Edit it as appropriate and + send it to + + cairo-announce@cairographics.org + + and -8) Send email announcements of the release to everywhere appropriate. + xorg-announce@lists.freedesktop.org -- 2.7.4