This file is a release HOWTO, more or less a reminder before releasing a new version of Hamlib. TODO: With the switch to SVN SCM discuss the use of tags and branches for releases. Before deciding release: ----------------------- * Anticipate what problems would users experience with the new release, so you can fix the problems before making the release. Basically, this is making sure the package will compile on a whole breed of systems (arch,OS,library,gcc,etc. combo), that there's no regression, and the API evolution is managed well. * Announce SVN/version freeze on hamlib-developer mailing list, so developers have time to check in their contributions. * Update libtool: macros/{ltdl,libtool}.m4 ltmain.sh libltdl/ A postfix of libtool in libltdl/Makefile.in may be needed: empty am__aclocal_m4_deps Releasing Hamlib: ---------------- * Update NEWS, TODO, AUTHORS * Update the version in the macro AC_INIT of configure.ac (remove 'svn') * Regenerate ChangeLog with: TZ=UTC svn2cl * svn commit -m "release X.Y.Z" ChangeLog configure.ac NEWS Note the revision number (N). * Tag the SVN rep with version 'HAMLIB-x-y-z' svn copy -r N https://hamlib.svn.sourceforge.net/svnroot/hamlib/trunk \ https://hamlib.svn.sourceforge.net/svnroot/hamlib/tags/HAMLIB-x-y-z \ -m "release x.y.z" * Build source tarball: svn co -r N https://hamlib.svn.sourceforge.net/svnroot/hamlib/trunk hamlib sh autogen.sh --enable-maintainer-mode # (Would the above command be better invoked as: # sh autogen.sh --disable-maintainer-mode --prefix=/usr/local CFLAGS="-g -O0" # ?? comments please.) make dist * Build Windows DLL from previous tarball, and .LIB, then create .zip file Rem: under Linux, you need the package mingw32 to cross-compile it, and free MVC++Toolkit to create .lib file: ./configure --disable-static \ --host=i586-mingw32msvc \ --prefix=/tmp/mingw-inst \ --without-rpc-backends \ --enable-xmltest PKG_CONFIG_LIBDIR= ac_cv_path_PKG_CONFIG=no make install new_ver="x.y.z" mkdir -p /tmp/mingw-inst/hamlib-${new_ver}/lib/msvc /tmp/mingw-inst/hamlib-${new_ver}/lib/gcc cp src/libhamlib.def /tmp/mingw-inst/hamlib-${new_ver}/lib/msvc/libhamlib-2.def cd /tmp/mingw-inst/hamlib-${new_ver}/lib/msvc/ unix2dos *.def wine /media/sda1/Program\ Files/Microsoft\ Visual\ C++\ Toolkit\ 2003/bin/link.exe /lib /machine:i386 /def:libhamlib-2.def cd ../.. unix2dos include/hamlib/*.h cp lib/libhamlib.dll.a /tmp/mingw-inst/hamlib-${new_ver}/lib/gcc zip -r hamlib-win32-${new_ver}.zip hamlib-win32-${new_ver} Edit Release, i386, .zip * Build Windows DLL with stdcall convention: Ditto but with HAMLIB_API set to __stdcall in include/hamlib/rig_dll.h before re-compiling. Subsitute cdecl by stdcall in README.txt. * Release the file(s) - https://sourceforge.net/project/admin/explorer.php?group_id=8305 - Select subdirectory hamlib, left click on the grey gear, "New folder", x.y.z - Select subdirectory hamlib/x.y.z - Left click on the grey gear of the folder, "Upload here" - Letf click on file name, on right side, set platform as default for download. Save. * Update http://www.hamlib.org Wiki - Download section https://sourceforge.net/apps/mediawiki/hamlib/index.php?title=Download - Documentation (requires doxygen) make -C doc doc ssh shell.sourceforge.net mkdir /home/groups/h/ha/hamlib/htdocs/manuals/x-y-z scp -r doc/html shell.sourceforge.net:/home/groups/h/ha/hamlib/htdocs/manuals/x-y-z/. Edit Wiki Documentation section - Supported Radios/Rotators make -C tests rigmatrix.html ssh -t USER,hamlib@shell.sourceforge.net create scp -r tests/sup-info/* shell.sourceforge.net:/home/groups/h/ha/hamlib/htdocs/sup-info/. * Notify various sites: - Sourceforge/News: https://sourceforge.net/news/submit.php?group_id=8305 - Freshmeat: http://freshmeat.net/projects/hamlib - http://radio.linux.org.au/pkgdetail.phtml?pkgid=243 Linux Hamradio App: rigctl category * Send announce to mailing lists: [ANN] hamlib-announce, linux-ham To advertise: - list the rigs supported so far, - what was major work achieved, - where we're heading, - what kind of support we need Get ready for the next round: * Bump version number and append 'svn' to it in macro AC_INIT of configure.ac * Update src/Makefile.am revision of -version-info