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.
  21
  22    A very useful thing to do is to run the cairo test suite
  23    against pixman. This can be done by running the following
  24    commands in the "test" directory of the latest cairo release:
  25
  26         tar xzf cairo-X.Y.Z.tar.gz
  27         cd cairo
  28         CAIRO_TEST_TARGET=image make test
  29
  30 4) Use "git commit" to record any changes made in steps 2 and 3.
  31
  32 5) Generate the final tar files with
  33
  34         make distcheck
  35
  36    and publish the tar files by running
  37
  38         make GPGKEY=<your gpg key id> release-publish
  39
  40 6) Run
  41
  42         make release-publish-message
  43
  44    to generate a draft release announcement. Edit it as appropriate and
  45    send it to
  46
  47         cairo-announce@cairographics.org
  48
  49    and
  50
  51         xorg-announce@lists.freedesktop.org
  52
  53
  54 7) Increment pixman_micro to the next larger (odd) number in
  55    configure.ac. Commit this change, and push all commits created
  56    during this process using
  57
  58         git push --tags
  59
  60    You must use "--tags" here; otherwise the new tag will not
  61    be pushed out. This is because technobabble.
  62