Creating a JaxMe release | ![]() |
This page provides information about the steps required to create a JaxMe release.
Creating a release
- Update the "version" property in "build.xml".
- Make sure that you have the file jimi-1.0.jar in src/documentation/lib. This file is required for generating PDF's including PNG images. Unfortunately it cannot be added to the repository, due to licensing issues. See the Forrest FAQ on how to obtain the file.
- Update the file src/documentation/content/xdocs/news.xml in the ws-jaxme repository.
- Make sure that you have gpg or a similar tool installed. The easiest way is via the CygWin installer (Windows) or using a RPM package provided by your vendor (Linux). If you haven't yet created a secret key, do so using "gpg --gen-key". Also, create a KEYS file using "gpg --list-sigs jochen@apache.org" >>KEYS" "gpg --armor --export jochen@apache.org" >> KEYS. Add the contents of the KEYS file to "etc/KEYS" in the CVS directory.
- Create the distribution files using "ant dist". This will create, for example, four files called "ws-jaxme-0.3-bin.tar.gz", "ws-jaxme-0.3-bin.tar.gz.MD5", "ws-jaxme-0.3-src.tar.gz", and "ws-jaxme-0.3-src.tar.gz.MD5". The extension .MD5 indicates that these are no true distribution files, but simply contain an MD5 checksum over the others.
- Sign all distribution files, creating additional files with the same names and an ending ".asc". For example: "gpg --output ws-jaxme-0.3-bin.tar.gz.asc --detach-sig --armor ws-jaxme-0.3-bin.tar.gz"
- Upload all the files to minotaur.apache.org using scp. For example: "scp etc/KEYS dist/ws-jaxme-0.3* jochen@minotaur.apache.org:"
- Move the files to the directory /www/www.apache.org/dist/ws/jaxme and ensure proper permissions: "chgrp ws KEYS ws-jaxme-0.3*" "chmod 664 KEYS ws-jaxme-0.3*" "mv KEYS ws-jaxme-0.3* /www/www.apache.org/dist/ws/jaxme"
- Update the file "/www/www.apache.org/dist/ws/jaxme/README.html".
- Wait one day, until the Apache mirrors are in sync.
- Update the files mirrors.ehtml and news.xml in the directory src/documentation/content/xdocs of the ws-site repository.
- Announce the new release on FreshMeat. There are three projects that might need notifications: JaxMe, JaxMeJS, and JaxMeXS. Creating an announcement on freshmeat requires that you have an account and be administrator for the respective projects. If you aren't yet, contact Jochen Wiedmann.
Creating the online site
The online site is created by simply invoking the ant target "doc" on build.xml, the main build script. There is only a single thing to note: In order to get the links on the download page right, you have to use the parameter -Dbuild.online.site=true. This will activate the ant target "replace".