RELEASING

   1 Here are the steps to follow to create a new pixman release:
   2
   3 1) Ensure that there are no uncommitted changes or unpushed commits,
   4    and that you are up to date with the latest commits in the central
   5    repository. Here are a couple of useful commands:
   6
   7         git diff                        (no output)
   8
   9         git status                      (should report "nothing to commit")
  10
  11         git log master...origin         (no output; note: *3* dots)
  12
  13 2) Increment pixman_(major|minor|micro) in configure.ac according to
  14    the directions in that file.
  15
  16 3) Run
  17
  18         make PREV=<last version> release-check
  19
  20    and fix things until it passes. If your freedesktop username is
  21    different from your local username, then also set the variable
  22    USER on the commandline.
  23
  24    A very useful thing to do is to run the cairo test suite
  25    against pixman. This can be done by running the following
  26    commands in the "test" directory of the latest cairo release:
  27
  28         tar xzf cairo-X.Y.Z.tar.gz
  29         cd cairo
  30         CAIRO_TEST_TARGET=image make test
  31
  32 4) Use "git commit" to record any changes made in steps 2 and 3.
  33
  34 5) Generate and publish the tar files by running
  35
  36         make PREV=<last version> GPGKEY=<your gpg key id> release-publish
  37
  38 6) Run
  39
  40         make release-publish-message
  41
  42    to generate a draft release announcement. Edit it as appropriate and
  43    send it to
  44
  45         cairo-announce@cairographics.org
  46
  47    and
  48
  49         xorg-announce@lists.freedesktop.org
  50
  51 7) Increment pixman_micro to the next larger (odd) number in
  52    configure.ac. Commit this change, and push all commits created
  53    during this process using
  54
  55         git push
  56         git push --tags
  57
  58    You must use "--tags" here; otherwise the new tag will not
  59    be pushed out. This is because technobabble.
  60