Contents
- First things first
- Tagging
- Make the source release
- Create the release on sourceforge
- Announcing the release
- Publicise by mail
This is a checklist of things that need to be done in order to carry out a source and binary release of openModeller Desktop.
First things first
- Change the version id in src/gui/omgaboutbase.ui
- Make sure the change log is updated (an easy way to do this is to run the svn log command and cull the important entries from the commit log)
- Update the version number in Doxyfile
- Update the version number in omgversion.h
- Change the version in top level CMakeLists.txt - at the top of the file and in the APPLE section
- Check there are no uncommitted changes
- Check it builds successfully on linux, mac and windows
Build Binary for Windows
- Change the version number in installer openModellerDesktop.nsi
- Right click on openModellerDesktop.nsi in installer/ directory and choose build
- Test the installer
Upload to ftp://upload.sf.net/incoming
Build Binary for Linux
Follow the directions described here: http://wiki.qgis.org/qgiswiki/BuildingDistroIndependentLinuxBundle
- Update the version number in bitrock
- Update the launcher script to use the version bundle dir name
- Create and test the bitrock installer
- Make sure the file is named in the form:
openModellerDesktop-1.0.4-linux-installer.bin
Upload to ftp://upload.sf.net/incoming
Build Binary for Mac
- edit mac/1-release-extra.sh and update anything as needed.
make install && ../mac/1-release-extra.sh; ../mac/2-release-extra-qt.sh && ../mac/test_bundle.sh
The last argument above will launch the application in test mode - you should verify it works properly and ideally also test on a 'clean' machine.
- Update mac/README.mac.txt file as needed
- Zip the application bundle and mac/README.mac.txt together into a zip file named in the form:
openModellerDesktop-1.0.4-mac.zip
Upload to ftp://upload.sf.net/incoming
Tagging
- Tag the copy in SVN in the format release-1-0-8 (e.g. for 1.0.8 release) e.g.
svn cp https://openmodeller.svn.sourceforge.net/svnroot/openmodeller/trunk/openModellerDesktop \
https://openmodeller.svn.sourceforge.net/svnroot/openmodeller/tags/openModellerDesktop_release_1_0_8
Make the source release
cd /tmp
svn export https://openmodeller.svn.sourceforge.net/svnroot/openmodeller/tags/openModellerDesktop_release_1_0_5 \
openModellerDesktopSource.v1.0.5
- Now zip the file (I did this in konqueror using the compress file option).
Upload the source archve to ftp://upload.sf.net/incoming
Create the release on sourceforge
- Use the following link to create the release:
https://sourceforge.net/project/admin/newrelease.php?package_id=142057&group_id=101808
Name the release e.g. 1.0.5
- Set the status as 'hidden' until you are ready to make it public
- Fill in the release notes e.g.:
This is release 1.0.5 of openModeller Desktop.
Tim Sutton
18 April 2007
Fill in the changelog by cut & pasting it from the changelog created above
- Add the three platform specific binaries + the source zip to the file list for the release.
Announcing the release
Create an announcement template
An annoucement templace will save you retypping the same text at the various places of announcement. The following text can be used as a basis:
A Generic release subject
Announcing the release of openModeller Desktop version 1.0.5
A generic 20 word summary
openModeller Desktop application provides a user friendly GUI for carrying out niche modelling experiments such as modelling species distribution.
A generic short html announcement
It is our great pleasure to announce the immediate availability of openModeller Desktop Version 1.X.X. <a href="http://openmodeller.sf.net">openModeller</a> is a generic framework for carrying out fundamental niche modelling experiments - typically used to predict species distribution given a set of environmental raster layers. The openModeller Desktop application builds on the openModeller library by providing a user friendly graphical user interface for carrying out niche modelling experiments.
This release introduces several new features including xxxx. xxxx. xxxx. The release also includes numerous bug fixes and stability improvements. openModeller Desktop is available is source form, and as binary executables for Microsoft Windows, Mac OS X, and as a GNU/Linux distribution independent application bundle. All versions can be obtained from our <a href="http://sourceforge.net/project/platformdownload.php?group_id=101808&sel_platform=4998">download page</a>.
As an open source project, we provide support for using openModeller via our mailing lists and bug tracker:
<ul>
<li>For general enquiries <a href="http://lists.sourceforge.net/mailman/listinfo/openmodeller-users">subscribe</a> to our users mailing list.</li>
<li>For developer related enquiries <a href="http://lists.sourceforge.net/mailman/listinfo/openmodeller-devel">subscribe</a> to our separate developers list.</li>
<li>If you think you have found a bug, please report it using our <a href="http://sourceforge.net/tracker/?group_id=101808&atid=631036">bug tracker</a>. When reporting bugs, please include some contact information in case we need help with replicating your issue.</li>
</ul>
A generic short plain text announcement
It is our great pleasure to announce the immediate availability of openModeller Desktop Version 1.X.X. openModeller (http://openmodeller.sf.net) is a generic framework for carrying out fundamental niche modelling experiments - typically used to predict species distribution given a set of environmental raster layers. The openModeller Desktop application builds on the openModeller library by providing a user friendly graphical user interface for carrying out niche modelling experiments.
This release introduces several new features including xxxx. xxxx. xxxx. The release also includes numerous bug fixes and stability improvements. openModeller Desktop is available is source form, and as binary executables for Microsoft Windows, Mac OS X, and as a GNU/Linux distribution independent application bundle. All versions can be obtained from our download page at http://sourceforge.net/project/platformdownload.php?group_id=101808&sel_platform=4998
As an open source project, we provide support for using openModeller via our mailing lists and bug tracker:
- For general enquiries subscribe to our users mailing list at http://lists.sourceforge.net/mailman/listinfo/openmodeller-users
- For developer related enquiries subscribe to our separate developers list at http://lists.sourceforge.net/mailman/listinfo/openmodeller-devel
- If you think you have found a bug, please report it using our <a href="http://sourceforge.net/tracker/?group_id=101808&atid=631036">bug tracker</a>. When reporting bugs, please include some contact information in case we need help with replicating your issue.
For a longer annoucement, include the changelog text and a screenshot of some shiny new feature.
A generic product description
openModeller is a generic framework for carrying out fundamental niche modelling experiments - typically used to predict species distribution given a set of environmental raster layers. The openModeller Desktop application builds on the openModeller library by providing a user friendly graphical user interface for carrying out niche modelling experiments.
A generic features list
* A layerset manager. This is for creating named collections of layers for use in modelling experiments. Having layers organised in named sets removes the tedium of repeatedly having to select layers from the file system for different model runs.
* An algorithm profile manager. Algorithm profiles let you store the custom parameters you use for running models in a reusable way.
* An experiment designer. The experiment designer allows you to set up an experiment consisting of multiple species and algorithm profiles.
* An experiment browser. Once an experiment is completed the experiment browser presents the list of algorithm profiles and the species names in a tree view. Clicking on an item in the experiment tree shows a detailed report for that model. The report includes all the details of which algorithm was used, which parameters for the algorithm were changed, which layers were used, the model duration and so on.
* A map browser. The map browser allows you to pan and zoom on the model's map image.
* Translations. The openModeller Desktop application is available with Brazillian Portuguese and English translations.
* Modelling Plugins. The actual modelling work is managed by plugins. This includes a 'local' plugin openModeller library, and a 'web service' plugin that allows models to be run on a remote server.
SF news
Add an entry to the http://sourceforge.net/news/submit.php?group_id=101808 sourceforge news page
It is our great pleasure to announce the immediate availability of openModeller Desktop Version 1.0.5 openModeller is a generic framework for carrying out fundamental niche modelling experiments - typically used to predict species distribution given a set of environmental raster layers. The openModeller Desktop application builds on the openModeller library by providing a user friendly graphical user interface for carrying out niche modelling experiments.
Home Page : http://openmodeller.sf.net
Download : http://sourceforge.net/project/platformdownload.php?group_id=101808&sel_platform=4998
openModeller Home Page
http://openmodeller.sourceforge.net/administrator/index2.php?option=com_content
Apple Downloads
https://adcweb.apple.com/downloads/
Freshmeat
http://freshmeat.net/add-release/64308/69403/
Slashgeo
LXER.com
http://lxer.com/module/newswire/stories/add.php
kde-apps
Good source of downloads - 50 in the first days of 1.0.5 release announcement Dont use this anymore - use qt apps rather.
http://kde-apps.org/content/add.php
Qt-apps
last release : http://www.qt-apps.org/content/show.php?content=56986
announce a new release : http://www.qt-apps.org/content/add.php
Freemacware.com
http://www.freemacware.com/let-us-know/
OSNews
http://www.osnews.com/submit.php
Publicise by mail
On mailing lists
- openModeller Users and Developers
- FAPESP openModeller list
- QGIS Users
- Desktop GARP mailing list
Selected people
Neil Caithness, Alastair Culham, Prof Larry Zietsman, Adriaan van Niekerk, Ernst Baard, Aimee Stewart, Dave Vieglas,
Hi All
Just a quick note to let you know that openModeller Desktop version 1.0.5 is now available. openModeller Desktop provides a user friendly GUI environment for carrying out fundamental niche modelling experiments (usually used to predict and visualise potential species distribution). The software is free and open source. Binaries are available for windows, mac osx and linux. For more info, visit:
http://openmodeller.sourceforge.net/<replace with actual link>
Regards
--
Tim Sutton
openModeller Desktop Geek :-)