From 51fdc112b3b656dad3b728027bb9de5e7b63c41a Mon Sep 17 00:00:00 2001 From: hugo303 Date: Mon, 22 Oct 2012 15:50:50 +0000 Subject: [PATCH] Updated release instructions git-svn-id: svn+ssh://svn.code.sf.net/p/check/code/trunk@640 64e312b2-a51f-0410-8e61-82d0ca0eb02a --- HACKING | 21 ++++++++++++++++----- Makefile.am | 40 +++++++++++++++++++--------------------- NEWS | 4 ++++ 3 files changed, 39 insertions(+), 26 deletions(-) diff --git a/HACKING b/HACKING index b188752..c833e6e 100644 --- a/HACKING +++ b/HACKING @@ -29,12 +29,23 @@ Release Process You need 'release tech' access within the project to do this. Start in a configured in-place build of trunk. - -1. Decide on a X.Y.Z revision suitable for release. -2. make SF_USERNAME=username RELEASE_VERSION=X.Y.Z preparerelease +If you are behind a proxy remember to "socksify" (or similar) your +'make' and 'sftp' commands. Make sure svn works. + +1. Fix your ssh connectivity and accept ssh-keys: + 'sftp @web.sourceforge.net' + 'sftp @frs.sourceforge.net' +2. Decide on a X.Y.Z revision suitable for release. +3. Update configure.ac with new versions and run + 'svn commit -m "Update for release" configure.ac' +4. Update NEWS with new version number. Use this format: + "Mon, Oct 22, 2012: Released Check 0.9.9 + based on r637 (2012-10-22 13:54:14 +0200)" + Now 'svn commit -m "* Update for release" NEWS' +5. make SF_USERNAME=username RELEASE_VERSION=X.Y.Z preparerelease This will tag trunk as https://svn.sourceforge.net/svnroot/check/tags/check-X.Y.Z -3. Follow the prompts. If anything goes wrong see Makefile.am and complete it by hand. -4. Use the following template to announce the release: +6. Follow the prompts. If anything goes wrong see Makefile.am and complete it by hand. +7. Use the following template to announce the release: ===== Subject: check-X.Y.Z released Hi, diff --git a/Makefile.am b/Makefile.am index 78f041e..b8e2d7e 100644 --- a/Makefile.am +++ b/Makefile.am @@ -66,21 +66,15 @@ releasevars: svn st -u | grep "Status against revision:" | awk '{ print $$4 }' > $@ preparerelease: releasevars .svnrelease prereleasecheck - @echo checking we have can connect properly to do release tasks before tagging: - sftp -b /dev/null ${SF_USERNAME}@web.sourceforge.net - sftp -b /dev/null ${SF_USERNAME}@frs.sourceforge.net @echo tagging release from `cat .svnrelease` - svn cp -m "Tagging for check-${RELEASE_VERSION}" -r`cat .svnrelease` https://svn.sourceforge.net/svnroot/check/trunk https://svn.sourceforge.net/svnroot/check/tags/check-${RELEASE_VERSION} - svn co https://svn.sourceforge.net/svnroot/check/tags/check-${RELEASE_VERSION} check-${RELEASE_VERSION} - @echo "You need to:" - @echo "Update the version number in NEWS." - @echo "Update TODO to mark off any completed items." - @echo "Update configure.ac with new version numbers." + svn cp -m "Tagging for check-${RELEASE_VERSION}" -r`cat .svnrelease` https://check.svn.sourceforge.net/svnroot/check/trunk https://check.svn.sourceforge.net/svnroot/check/tags/check-${RELEASE_VERSION} + svn co https://check.svn.sourceforge.net/svnroot/check/tags/check-${RELEASE_VERSION} check-${RELEASE_VERSION} + @echo "Any last minute changes? This is your final chance." @echo "CTRL-D when finished or 'exit 1' to abort." @echo "aborting will leave the partially prepared release in" `pwd` cd check-${RELEASE_VERSION} && ${SHELL} && svn ci -m "Release check-${RELEASE_VERSION}" && autoreconf -i && ./configure $(MAKE) -C check-${RELEASE_VERSION} dorelease - -svn merge -r`cat .svnrelease`:`svn st -u check-${RELEASE_VERSION} | grep "Status against revision:" | awk '{ print $4 }'` check-${RELEASE_VERSION} . + -svn merge -r`cat .svnrelease`:`svn st -u check-${RELEASE_VERSION} | grep "Status against revision:" | awk '{ print $$4 }'` check-${RELEASE_VERSION} . @echo "Please resolve any conflicts. Be sure to also restore the 'In Development:' line to NEWS." ${SHELL} svn ci -m "Merge back release ${RELEASE_VERSION}" @@ -97,21 +91,25 @@ dorelease: releasevars doc/check_html prereleasecheck @echo uploading... rsync -e ssh NEWS-${RELEASE_VERSION}.txt ${SF_USERNAME},check@frs.sourceforge.net:/home/frs/project/c/ch/check/check/${RELEASE_VERSION}/ rsync -e ssh check-${RELEASE_VERSION}.tar.gz ${SF_USERNAME},check@frs.sourceforge.net:/home/frs/project/c/ch/check/check/${RELEASE_VERSION}/ - rsync -rlvC . ${SF_USERNAME},check@web.sourceforge.net:htdocs + rsync -e ssh -rlvC . ${SF_USERNAME},check@web.sourceforge.net:htdocs @echo - @echo Uploaded... - @echo "visit https://sourceforge.net/project/admin/explorer.php?group_id=28255" - @echo "Mark the NEWS file in check/${RELEASE_VERSION} as being a release note." - @echo "And the tar.gz file as being 'all platforms', using the NEWS file for release notes." + @echo "Uploaded..." + @echo "visit https://sourceforge.net/projects/check/files/" + @echo "Mark the NEWS file in check/${RELEASE_VERSION} as being a" + @echo "README by clicking the 'i' by the file and change the name to" + @echo "NEWS-README-${RELEASE_VERSION}." + @echo "Click 'i' by the tar.gz file and at 'Default download for:'" + @echo "click 'select all', then save." @echo "visit https://sourceforge.net/projects/check/files/" @echo "Check it looks ok. It may take 15 minutes to show up." - @echo Finally, mail check-devel ,announce and users at lists dot sourceforge dot net - @echo 'an email (template is in HACKING) about this announcement.' - @echo NEWS-release can be found at `pwd`/NEWS-${RELEASE_VERSION}.txt - @echo Note that with the tarballs, docs amd NEWS up, the release is done :P - @echo "so you'll have to manually roll back if you abort." + @echo "Finally, mail" + @echo "check-devel ,announce and users at lists dot sourceforge dot net" + @echo "an announcement (template is in HACKING) about this release." + @echo "NEWS-release can be found at `pwd`/NEWS-${RELEASE_VERSION}.txt" + @echo "Note that with the tarballs, docs amd NEWS up, the release" + @echo "is done :P so you'll have to manually roll back if you abort." @echo "CTRL-D to complete, or exit 1 to abort." ${SHELL} - + .PHONY: releasevars prereleasecheck preparerelease dorelease .svnrelease diff --git a/NEWS b/NEWS index e782f9e..e044873 100644 --- a/NEWS +++ b/NEWS @@ -1,3 +1,7 @@ +In development: + +* Updated HACKING and release procedure in Makefile.am. + Mon, Oct 22, 2012: Released Check 0.9.9 based on r637 (2012-10-22 13:54:14 +0200) -- 2.40.0