stephan@263: HowTo make a new MXD2map release
stephan@263: ================================
stephan@263: 
stephan@263: (replace the sample "0.2.0" with the apropriate version number)
stephan@263: 
stephan@263: 1. Take care everything is checked in properly.
stephan@263:    Adjust version numbers in
stephan@263:    contrib/installer/MXD2map-installer.nsi (PRODUCT_VERSION)
stephan@263:    doku/source/conf.py (version und release)
stephan@263:    and commit and push! (analog previous releases in ChangeLog)
stephan@263: 
stephan@263: 2. Create a source archive:
stephan@263:    $ export MXD2MAPVERSION=0.8
stephan@263:    $ hg archive -t tgz -X website -X HowToRelease.txt -X testdata-frida MXD2map-$MXD2MAPVERSION.tar.gz
aheinecke@325:    $ sha1sum MXD2map-$MXD2MAPVERSION.tar.gz > MXD2map-$MXD2MAPVERSION.tar.gz.sha1
stephan@263: 
aheinecke@325: 3. Create PDF-file of Documentation: 
aheinecke@325:     Prerequisites: 
aheinecke@325:         python-sphinx inkscape texlive-latex-extra texlive-fonts-recommended
stephan@263:    $ cd doku && make latexpdf
stephan@269:    $ cp build/latex/MXD2map.pdf  build/latex/MXD2map-$MXD2MAPVERSION.pdf
stephan@263: 
stephan@263: 4. Create new source-release on 0.8 on wald and upload Documentation-PDF and MXD2map-0.8.tar.gz
stephan@263: 
stephan@263: 4.1 Create Windows-Binary Installer (needs Windows-NSIS-Version and complete build)
stephan@263: 
aheinecke@325: 4.1.1 Copy the Source Archive to a Windows system and extract it.
aheinecke@325: 
aheinecke@325: 4.1.2 Make the dependencies available in the lib subfolder (See INSTALL.txt)
aheinecke@325: 
aheinecke@325: 4.1.3 Build MXD2map:
aheinecke@325: 
aheinecke@325:    $ ant jar-norevision
stephan@263: 
stephan@263:    Copy resulting mxd2map.jar into contrib/installer/bin/
stephan@263: 
aheinecke@325:    $ copy C:\tmp\build_sh\dist\mxd2map.jar contrib\installer\bin
stephan@263: 
aheinecke@325: 4.1.4 Copy the dependendcies from lib to contrib/installer/bin/lib
aheinecke@325: 
aheinecke@325:    $ xcopy /s lib\* contrib\installer\bin\lib
aheinecke@325: 
aheinecke@325: 4.1.5 Fill contrib/installer/bin/mapserver with the appropiate mapserver version
aheinecke@325: 
aheinecke@325: 4.1.6 Download example-data
stephan@263: 
stephan@263:    $ cd contrib/installer/example/example/testdata-frida
stephan@263:    $ wget ftp://ftp.intevation.de/freegis/frida/frida-1.0.1-shp.tar.gz
stephan@263:    $ tar xvfz frida-1.0.1-shp.tar.gz
stephan@263:    $ rm -f frida-1.0.1-shp.tar.gz
stephan@263: 
aheinecke@325: 4.1.7 Build the installer (requires NSIS >= 2.46-2):
stephan@263: 
stephan@263:    $ cd contrib/installer
stephan@263:    $ makensis -DVERSION_DATE=`date +%d.%m.%Y` MXD2map-installer.nsi
aheinecke@325:    $ sha1sum MXD2map-$MXD2MAPVERSION.exe > MXD2map-$MXD2MAPVERSION.exe.sha1
stephan@263: 
aheinecke@325: 4.2 Test the installer by installing it on a Windows system and running the example.
aheinecke@325: 
aheinecke@325: 4.3 Tag the release in HG:
stephan@263: 
stephan@271:    $ hg tag -m "Tagged as release 'release-$MXD2MAPVERSION'" release-$MXD2MAPVERSION && hg push
stephan@263: 
aheinecke@325: 4.4 Create new binary-release on Wald and upload
aheinecke@325:     MXD2map-$MXD2MAPVERSION.exe and corresponding sha1 hash.
stephan@269: 
stephan@263: 5. Update versions and URLs on the homepage (updates documentation as
stephan@263:    well!) [requires sphinx available in $PATH]
stephan@263: 
stephan@269:    $ cd website && edit header.m4, download-de.htm4, download.htm4
stephan@263:    $ hg commit -m "Updated Website to version $MXD2MAPVERSION, added download-links" && hg push
stephan@263:    $ make online
stephan@263: 
stephan@263: 6. Announce the new release on the mailing lists.