MapnikReleaseSteps

Steps for Mapnik Releases

Prepare

• Ensure the CHANGELOG is up to date.

• Set release date after checkins with development team

• Announce release plans to group list

• Ensure milestone is closed out

Bundled fonts and scons

• Consider updating Scons-local to latest release.
  The last SCons update was 2.1.0.alpha

    wget http://prdownloads.sourceforge.net/scons/scons-local-2.1.0.alpha.20101125.zip
    rm -rf scons
    unzip -o scons-local-2.1.0.alpha.20101125.zip -d scons/
    rm scons-local-2.1.0.alpha.20101125.zip
  

• Consider updating DeJaVu Fonts:
  The last version updated was 2.33

    cd fonts
    svn rm dejavu-fonts-ttf-
    wget http://sourceforge.net/projects/dejavu/files/dejavu/2.33/dejavu-fonts-ttf-2.33.tar.bz2
    tar xvf dejavu-fonts-ttf-2.33.tar.bz2
    svn add dejavu-fonts-ttf-2.33
  

• And unifont from: http://unifoundry.com/unifont.html

Pre-tag updates

• Update version number in version.hpp
• Set MAPNIK_VERSION_IS_RELEASE to 1 in version.hpp
• Update abi_fallback in SConstruct
• make install, then:

MAPNIK_VERSION=`mapnik-config --version`
git commit -a -m "setting up for mapnik v${MAPNIK_VERSION} release" 
git push

• Update CHANGELOG with the git hash of latest commit: git rev-parse --verify HEAD

• Then, push change:

git ci -a -m "update CHANGELOG"
git push

Tagging

MAPNIK_VERSION=`mapnik-config --version`
git tag "v${MAPNIK_VERSION}" -m "tagging v${MAPNIK_VERSION}"
git push --tags

Now, edit version.hpp again, incrementing version # and changing MAPNIK_VERSION_IS_RELEASE back to 0 to set up for the next release:

./configure
make install
MAPNIK_VERSION=`mapnik-config --version`
git ci include/mapnik/version.hpp -m "now working on mapnik v${MAPNIK_VERSION}"
git push

Post tag updates

• Update CHANGELOG in master entries from release (if relevant).

• Generate Python API docs:

sudo pip install epydoc
cd utils/epydoc_config
./build_epydoc.sh

• Then upload these docs - TODO (where should they go?)

Packaging

• Source package - use auto-created downloads via github: https://github.com/mapnik/mapnik/tags and upload to downloads

Builds

• Package binaries for Windows, Mac, and Ubuntu Linux (PPA)

• Submit patch for updated Mapnik Portfile and homebrew Formula

Web

• New icon for release at media.mapnik.org/images/release-VERSION.png
• Add a new 'release' item in the admin to update all links on mapnik.org

Wiki Post-Release

• Update Mapnik-Installation, MacInstallation, LinuxInstallation and WindowsInstallation links
• Create a release page from the relevant section of CHANGELOG like this page Release0.7.1
• Update MapnikReleases, a starting page for users to learn about Mapnik development

Announce

• Notify Packagers for Linux distros (PackageBuilding)
• Notify Packagers for OSGEO4w: http://norbit.de/
• Mapnik lists
• Mapnik.org news
• OSGEO News item: http://www.osgeo.org/content/news/submit_news.html
• Freshmeat : http://freshmeat.net/projects/mapnik
• FreeGIS : http://www.freegis.org
• SlashGeo : http://slashgeo.org/
• OpenStreetMap : [OSM-Dev] [OSM-Talk] ??