Steps for Making a libspatialindex Release
==============================================================================

:Author: Howard Butler
:Contact: howard@hobu.co

This document describes the process for releasing a new version of libspatialindex.

General Notes
------------------------------------------------------------------------------

Release Process

1) Increment Version Numbers

  - configure.ac
    * sidx_version_major
    * sidx_version_minor
    * sidx_version_micro
  - include/spatialindex/Version.h
    * SIDX_VERSION_MAJOR
    * SIDX_VERSION_MINOR
    * SIDX_VERSION_REV
    * SIDX_RELEASE_NAME
  - CMakeLists.txt
    * SET(SIDX_VERSION_MAJOR "1")
    * SET(SIDX_VERSION_MINOR "7")
    * SET(SIDX_VERSION_PATCH "0")
    * SET(SIDX_LIB_VERSION "4.0.0")
    * SET(SIDX_LIB_SOVERSION "4")
  - Makefile.am
    * version-info 3:2:0
  - Update SO versions
    * https://github.com/libspatialindex/libspatialindex/pull/44#issuecomment-57088783

2) Update README to include any relevant info about the release that
   might have changed.

3) Update ChangeLog with git2cl

  * git2cl . > ChangeLog

4) Run the regression tests.  Really.

5) Build Windows version

    * 64 bit 2010 project
        - Delete CMakeCache.txt
        - Regenerate with cmake-gui
        - Build project
        - Copy files to safe place
            * bin\Release\spatialindex-64.dll
            * bin\Release\spatialindex-64.lib
            * bin\Release\spatialindex_c-64.dll
            * bin\Release\spatialindex_c-64.lib

    * 32 bit 2008 project
        - Delete CMakeCache.txt
        - Regenerate with cmake-gui
        - Build project
        - Copy files to safe place
            * bin\Release\spatialindex-32.dll
            * bin\Release\spatialindex-32.lib
            * bin\Release\spatialindex_c-32.dll
            * bin\Release\spatialindex_c-32.lib


    * 64 bit 2008 project
        - Delete CMakeCache.txt
        - Regenerate with cmake-gui
        - Build project
        - Copy files to safe place
            * bin\Release\spatialindex-64.dll
            * bin\Release\spatialindex-64.lib
            * bin\Release\spatialindex_c-64.dll
            * bin\Release\spatialindex_c-64.lib

    * 32 bit 2008 project
        - Delete CMakeCache.txt
        - Regenerate with cmake-gui
        - Build project
        - Copy files to safe place
            * bin\Release\spatialindex-32.dll
            * bin\Release\spatialindex-32.lib
            * bin\Release\spatialindex_c-32.dll
            * bin\Release\spatialindex_c-32.lib



6) Make the source distribution

  ::

      make dist


7) Generate MD5 sums

  ::

      md5 spatialindex-src-1.5.0.tar.bz2 > spatialindex-src-1.5.0.tar.bz2.md5
      md5 spatialindex-src-1.5.0.tar.gz > spatialindex-src-1.5.0.tar.gz.md5
      md5 liblas-1.3.1-win32.zip > liblas-1.3.1-win32.zip.md5

8) Update http://trac.gispython.org/spatialindex/wiki/Releases

9) Upload windows and source package as attachments to the new release page.

10) Tag the release.  Use the ``-f`` switch if you are retagging because you
   missed something.

  ::

      svn cp http://svn.gispython.org/svn/spatialindex/spatialindex/trunk http://svn.gispython.org/svn/spatialindex/spatialindex/tags/1.5.0

11) Write the release notes.  Place a copy of the release notes on the release
   page you created as well as send an email to spatalindex list announcing the
   new release.