This file is a release HOWTO, more or less a reminder before releasing a new version of Hamlib. TODO: With the switch to Git SCM discuss the use of branches for releases and point 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 version freeze on hamlib-developer mailing list, so developers have time to check in their contributions. In order to provide for a timely release schedule with the popular Ubuntu distribution, announcing a freeze around January 1 and July 1 of each year will provide about a month of testing before release. * Update the configuration: clean the tree sh ./autogen.sh Releasing Hamlib: ---------------- In the master branch of your local repository (the key to working with Git is that all work is committed to the local repository and then pushed to the remote repository, "origin"): * Assure the local repository is sync'ed with origin/master: git fetch git status At this point Git may produce a message such as: $ git status # On branch master # Your branch is behind 'origin/master' by 2 commits, and can be fast-forwarded. # nothing to commit (working directory clean) As there appear to be no conflicts, the following command will sync your local repository to origin/master: $ git reset --hard origin/master HEAD is now at 522229d chmod +x autogen.sh Thanks, Kamal Mostafa, KA6MAL * Update NEWS, TODO, AUTHORS * Commit the changes to master: git status # Assure that only the previous files are modified git commit -a # Commit all modified files locally * Create a new branch for the release: git branch Hamlib-1.2.14 * Push the changes (check for validity): git push origin # pushes previous commit to sf.net repository git push origin Hamlib-1.2.14 # push the branch * Update the version in the macro AC_INIT of configure.ac (advance to next version, e.g. 1.2.15~git) and the libhamlib_la_LDFLAGS value in src/Makefile.am and c++/Makefile.am to match. e.g.: libhamlib_la_LDFLAGS = $(WINLDFLAGS) $(OSXLDFLAGS) -no-undefined -version-info @ABI_VERSION@:15:0 Note that -version-info is a libtool flag and reflects ABI compatibility. In @ABI_VERSION@:15:0, ABI_VERSION is set in configure.ac, 15 is the revision, and :0 should remain 0. When the API is changed, ABI_VERSION will be advanced, and revision (e.g. :15) will be reset to 0. Format is ABI version:revision:age. Setting age to other than 0 causes strange DLL naming in Win32 cross-compile builds. * Commit the changes to configure.ac and src/Makefile.am and push them to the remote repository. At this point the master branch is ahead of the new release branch, however, the version in the branch's version needs to have the "~git" changed to "~rc1" which will be advanced for the next release candidate or stripped for final release: * Checkout the release branch: git checkout Hamlib-1.2.14 * Edit config.ac, commit it and push it. The branch is now ready for rc testing/release. * Build source tarball from a clean clone (anonymous clone is fine): git clone -b Hamlib-1.2.14 git://hamlib.git.sourceforge.net/gitroot/hamlib/hamlib cd hamlib sh autogen.sh --prefix=/usr/local make dist Win32 binary build release -------------------------- In these steps the release or daily snapshot tarball is unpacked in ~/temp for the Win32 build and all operations are done from there unless otherwise noted. Under Linux you need the mingw32 package to cross-compile it, an internal copy of libltdl (configured and built as below), zip to create the archive, the tofrodos or dos2unix package installed to convert to DOS text format, and Wine plus the free MVC++Toolkit available from: http://uploading.com/files/HNH73WB3/VCToolkitSetup%28v1.01%29%282004.07.06%29.zip.html to create the Win32 .LIB file (unzip and then install it with Wine in the usual way). NB: Debian Squeeze and later users will need an updated mingw32-runtime package and can manually install the Ubuntu version from: http://packages.ubuntu.com/maverick/devel/mingw32-runtime Finally, the Win32 version of libusb must be available for the USB backends to be built. Download the latest libusb-win32-bin-1.2.4.0.zip from: https://sourceforge.net/projects/libusb-win32/files/libusb-win32-releases/1.2.4.0/ and unzip the archive in ~/temp/libusb-win32-bin-1.2.4.0 and then copy the following into libusb-win32-bin-1.2.4.0/lib/pkgconfig/libusb.pc ---------------CUT----------------------------- prefix=/home/USER/temp/libusb-win32-bin-1.2.4.0 exec_prefix=${prefix} libdir=${exec_prefix}/lib/gcc bindir=${exec_prefix}/bin includedir=${prefix}/include Name: libusb Description: USB access library Version: 1.2.4.0 Libs: -L${libdir} -L${bindir} -lusb Cflags: -I${includedir} ---------------CUT----------------------------- * Build Windows DLL from previous tarball, and .LIB, then create .zip file make distwin32 * 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/projects/hamlib/files/ - Select Hamlib - Click Add Folder, name it X.Y.Z[.a] - Select X.Y.Z[.a] - Click Add File button - Click Choose File button - Click Upload - Click on (i) icon, select appropriate OS for "Default Download" * 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/project-web/h/ha/hamlib/htdocs/manuals/x-y-z scp -r doc/html shell.sourceforge.net:/home/project-web/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/* USER,hamlib@shell.sourceforge.net:/home/project-web/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