HowTo make a new MXD2map release
================================

(replace the sample "0.2.0" with the apropriate version number)

1. Take care everything is checked in properly.
   Adjust version numbers in
   contrib/installer/MXD2map-installer.nsi (PRODUCT_VERSION)
   doku/source/conf.py (version und release)
   and commit and push! (analog previous releases in ChangeLog)

2. Create a source archive:
   $ export MXD2MAPVERSION=0.8
   $ hg archive -t tgz -X website -X HowToRelease.txt -X testdata-frida MXD2map-$MXD2MAPVERSION.tar.gz
   $ sha1sum MXD2map-$MXD2MAPVERSION.tar.gz > MXD2map-$MXD2MAPVERSION.tar.gz.sha1

3. Create PDF-file of Documentation: 
    Prerequisites: 
        python-sphinx inkscape texlive-latex-extra texlive-fonts-recommended
   $ cd doku && make latexpdf
   $ cp build/latex/MXD2map.pdf  build/latex/MXD2map-$MXD2MAPVERSION.pdf

4. Create new source-release on 0.8 on wald and upload Documentation-PDF and MXD2map-0.8.tar.gz

4.1 Create Windows-Binary Installer (needs Windows-NSIS-Version and complete build)

4.1.1 Copy the Source Archive to a Windows system and extract it.

4.1.2 Make the dependencies available in the lib subfolder (See INSTALL.txt)

4.1.3 Build MXD2map:

   $ ant jar-norevision

   Copy resulting mxd2map.jar into contrib/installer/bin/

   $ copy C:\tmp\build_sh\dist\mxd2map.jar contrib\installer\bin

4.1.4 Copy the dependendcies from lib to contrib/installer/bin/lib

   $ xcopy /s lib\* contrib\installer\bin\lib

4.1.5 Fill contrib/installer/bin/mapserver with the appropiate mapserver version

4.1.6 Download example-data

   $ cd contrib/installer/example/example/testdata-frida
   $ wget ftp://ftp.intevation.de/freegis/frida/frida-1.0.1-shp.tar.gz
   $ tar xvfz frida-1.0.1-shp.tar.gz
   $ rm -f frida-1.0.1-shp.tar.gz

4.1.7 Build the installer (requires NSIS >= 2.46-2):

   $ cd contrib/installer
   $ makensis -DVERSION_DATE=`date +%d.%m.%Y` MXD2map-installer.nsi
   $ sha1sum MXD2map-$MXD2MAPVERSION.exe > MXD2map-$MXD2MAPVERSION.exe.sha1

4.2 Test the installer by installing it on a Windows system and running the example.

4.3 Tag the release in HG:

   $ hg tag -m "Tagged as release 'release-$MXD2MAPVERSION'" release-$MXD2MAPVERSION && hg push

4.4 Create new binary-release on Wald and upload
    MXD2map-$MXD2MAPVERSION.exe and corresponding sha1 hash.

5. Update versions and URLs on the homepage (updates documentation as
   well!) [requires sphinx available in $PATH]

   $ cd website && edit header.m4, download-de.htm4, download.htm4
   $ hg commit -m "Updated Website to version $MXD2MAPVERSION, added download-links" && hg push
   $ make online

6. Announce the new release on the mailing lists.