Steps to follow to create a new pycairo release
-----------------------------------------------

1) Add a new NEWS entry
Sift through the information in 'git log' since the last release. Summarize
major changes briefly in a style similar to other entries in NEWS.


2) Increment pycairo and cairo version numbers in:
   doc/conf.py
   README
   wscript


3) Create the archive
$ cd doc
$ make clean; make html  # view docs and ensure version number is correct

$ cd ..
$ ./waf distcheck  # ensure there are no errors
$ rm -rf py2cairo-X.X.X*

$ ./waf clean distclean
$ ./waf dist       # to create pycairo-x.x.x.tar.bz2
                   # create sha1 sum
$ sha1sum pycairo-x.x.x.tar.bz2 > pycairo-x.x.x.tar.bz2.sha1
  # ensure html docs are present in the archive

$ mv pycairo-X.X.X* /tmp
  # install from the archive, run tests and examples.


4) git commit  # the changes to NEWS, etc.
It's especially important to mention the new version number in the git commit
comment.
Add a '=== Pycairo x.x.x ===' header.

$ git tag X.Y.Z
  push the changes to the freedesktop server.
$ git push origin master


5) Copy the archive to the cairo download server
$ chmod a+r /tmp/pycairo*
$ scp pycairo-x.x.x.tar.bz2 pycairo-x.x.x.tar.bz2.sha1 cairographics.org:/srv/cairo.freedesktop.org/www/releases


6) Verify that the tar file arrived at the website.
   Check tar file has read permissions for all.
   Update the pycairo webpage to reference the new release.
   Update http://cheeseshop.python.org entry for pycairo.


7) Send a message to cairo-announce@cairographics.org
              and CC python-announce-list@python.org
   to announce the new release using the template below

Subject: ANN: pycairo release X.X.X now available

Pycairo is a set of Python 3.x bindings for the multi-platform 2D
graphics library cairo.
  http://cairographics.org
  http://cairographics.org/pycairo

Pycairo release X.X.X is available from:
  http://cairographics.org/releases/pycairo-X.X.X.tar.bz2
  http://cairographics.org/releases/pycairo-X.X.X.tar.bz2.sha1

<insert NEWS here ...>


8) Generate documentation and copy to cairo web server
$ cd doc/_build/html
$ tar cjf /tmp/html.tar.bz2 *  # adds files to top level of archive
$ scp /tmp/html.tar.bz2 cairographics.org:/srv/cairo.freedesktop.org/www/documentation/pycairo/3
$ ssh cairographics.org
  # login and untar the file
  # test pycairo docs can be read from web
  # check everyone has read permission (and 'x' for dirs)


9) Increment pycairo version number, to next odd number in:
   doc/conf.py
   wscript
$ git commit
$ git push origin master
