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 7) Increment pixman_micro to the next larger (odd) number in
  41    configure.ac. Commit this change, and push all commits created
  42    during this process using
  43
  44         git push --tags
  45
  46    You must use "--tags" here; otherwise the new tag will not
  47    be pushed out. This is because technobable.
  48
  49 8) Run
  50
  51         make release-publish-message
  52
  53    to generate a draft release announcement. Edit it as appropriate and
  54    send it to
  55
  56         cairo-announce@cairographics.org
  57
  58    and
  59
  60         xorg-announce@lists.freedesktop.org