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
   $ md5sum MXD2map-$MXD2MAPVERSION.tar.gz > MXD2map-$MXD2MAPVERSION.tar.gz.md5sum

3. Create PDF-file of Documentation:
   $ 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 Build MXD2map:
   
   $ ant jar

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

4.1.2 Fill ms_6.1-dev-Folder with Binary-windows-build

4.1.3 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.4 Build the installer (requires NSIS >= 2.46-2):

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

4.2 Tag the release in HG:

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

4.3 Create new binary-release on Wald and upload
    MXD2map-$MXD2MAPVERSION.exe and corresponding MD5sum.

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.