HOWTO_RELEASE

   1 - Verify that the versions currently set (see 10 and 11 below) make
   2    sense for this release.
   3
   4 - Run 'make distcheck', fix any problem with it.
   5
   6 - Update the NEWS file (extract most important things from the
   7   repository log). Make sure to update the release date
   8
   9 - Commit the changes in the NEWS file.
  10
  11 - Tag the release:
  12    $ base=https://svn.osgeo.org/geos/
  13    $ svn copy -m "Tagged release MAJOR.MINOR.PATCH" \
  14                 $base/trunk $base/tags/MAJOR.MINOR.PATCH
  15
  16 - Export the tag and 'make dist-bzip2'.
  17   $ svn export $base/tags/$rev
  18   $ cd $rev
  19   $ ./autogen.sh && ./configure && make dist-bzip2
  20
  21 - Verify that you can unpack and build the tarball
  22
  23 - Copy the tarball to upload.osgeo.org:/osgeo/download/geos
  24
  25 - Increment all the version numbers for the next release, as below.
  26
  27 - Increment CAPI_INTERFACE_X in configure.in
  28    - For a release with no interface changes just bump REVISION.
  29      [ Even if *nothing* changed in CAPI ]
  30    - Adding interfaces, bump CURRENT/AGE, set REVISION to 0.
  31    - Deleting interfaces / compatibility issues - bump CURRENT, others to zero
  32      [ THIS MUST BE CAREFULLY AVOIDED ]
  33
  34 - Increment release version:
  35    - In configure.in
  36    - In include/geos/version.h.vc
  37    - In capi/geos_c.h.in
  38      - VERSION_PATCH for bugfixes/improvements (even breaking C++ API)
  39      - VERSION_MINOR for NEW interfaces in the C lib
  40      - VERSION_MAJOR for SUBSTANTIAL additions or C lib ABI break
  41        [ THIS MUST BE CAREFULLY AVOIDED ]
  42    - In main CMakeLists.txt main one
  43       - VERSION_MAJOR, VERSION_MINOR, VERSION_PATCH
  44       - CAPI_INTERFACE_*
  45
  46 - Update wiki page https://trac.osgeo.org/geos/ at Download section
  47     - Add latest release
  48     - Remove previos patch level release (if any)
  49
  50 - Announce
  51