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    USERNAME 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 the final tar files with
  35
  36         make distcheck
  37
  38    and publish the tar files by running
  39
  40         make GPGKEY=<your gpg key id> release-publish
  41
  42 6) Run
  43
  44         make release-publish-message
  45
  46    to generate a draft release announcement. Edit it as appropriate and
  47    send it to
  48
  49         cairo-announce@cairographics.org
  50
  51    and
  52
  53         xorg-announce@lists.freedesktop.org
  54
  55
  56 7) Increment pixman_micro to the next larger (odd) number in
  57    configure.ac. Commit this change, and push all commits created
  58    during this process using
  59
  60         git push --tags
  61
  62    You must use "--tags" here; otherwise the new tag will not
  63    be pushed out. This is because technobabble.
  64