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) Make sure that new version works, including
  17
  18         - make distcheck passes
  19
  20         - the X server still works with the new pixman version
  21           installed
  22
  23         - the cairo test suite hasn't gained any new failures compared
  24           to last pixman version.
  25
  26 4) Use "git commit" to record the changes made in step 2 and 3.
  27
  28 5) Generate and publish the tar files by running
  29
  30         make PREV=<last version> GPGKEY=<your gpg key id> release-publish
  31
  32    If your freedesktop user name is different from your local one,
  33    then also set the variable USER to your freedesktop user name.
  34
  35 6) Run
  36
  37         make release-publish-message
  38
  39    to generate a draft release announcement. Edit it as appropriate and
  40    send it to
  41
  42         cairo-announce@cairographics.org
  43
  44         pixman@lists.freedesktop.org
  45
  46         xorg-announce@lists.freedesktop.org
  47
  48 7) Increment pixman_micro to the next larger (odd) number in
  49    configure.ac. Commit this change, and push all commits created
  50    during this process using
  51
  52         git push
  53         git push --tags
  54
  55    You must use "--tags" here; otherwise the new tag will not
  56    be pushed out.
  57