How to make a release

This is a short HOWTO for maintainers how to do a Fuego release.

1. Run make distcheck to check that the compilation, the unit tests, and a VPATH build work
2. Select a version number for the release. Since version 1.0, Fuego uses version numbers of the form x.y in which every major release (new release from the SVN trunk) increases x and sets y to 0, and every minor release (from a bugfix branch of a major release) increases y.
3. Change the version in the second argument of the AM_INIT_AUTOMAKE macro in configure.ac and update the current section header in NEWS
4. Commit the changes
5. Tag the current version. Example 1: for release 1.3 in the bugfix branch of version 1.0, the command would be:

   svn copy  \
   https://fuego.svn.sourceforge.net/svnroot/fuego/branches/VERSION_1_FIXES  \
   https://fuego.svn.sourceforge.net/svnroot/fuego/tags/VERSION_1_3 \
   -m "Tag release 1.3"
   @verbatim
   

   Example 2: for release 2.0 (a new major release), the command would be:

   svn copy  \
   https://fuego.svn.sourceforge.net/svnroot/fuego/trunk  \
   https://fuego.svn.sourceforge.net/svnroot/fuego/tags/VERSION_2_0 \
   -m "Tag release 2.0"
   

6. Run autoreconf -i in the root directory of Fuego and then make dist. The file release is now in the current directory
7. If the release is a new major release, create a bugfix branch. Example: for release 2.0, the command would be:

   svn copy  \
   https://fuego.svn.sourceforge.net/svnroot/fuego/trunk  \
   https://fuego.svn.sourceforge.net/svnroot/fuego/branches/VERSION_2_FIXES \
   -m "Create bugfix branch for version 2"
   

8. Change the version in configure.ac to a development version and add a new section header in NEWS ("Current development version"). The version string to be used for untagged development versions from the SVN repository is by convention the version of the last release with ".SVN" appended (e.g. 2.3.SVN; this indicates an undefined code revision somewhere in the SVN repository between release 2.3 and 2.4). After a new major release, you need to change the version string in both the trunk and the new bugfix branch. To distinguish between trunk and bugfix branch, the first development version in the bugfix branch has a ".0.SVN" appended (e.g. 3.0.0.SVN to distinguish it from undefined revisions in the trunk named 3.0.SVN)
9. Commit the changes.
10. Upload the file release to SourceForge