michael@0: How to prepare a new release michael@0: ---------------------------- michael@0: michael@0: . include/freetype.h: Update FREETYPE_MAJOR, FREETYPE_MINOR, michael@0: and FREETYPE_PATCH. michael@0: michael@0: . Update version numbers in all files where necessary (for example, do michael@0: a grep for both `2.3.1' and `231' for release 2.3.1). michael@0: michael@0: . builds/unix/configure.raw: Update `version_info'. michael@0: michael@0: . docs/CHANGES: Document differences to last release. michael@0: michael@0: . README: Update. michael@0: michael@0: . docs/VERSION.DLL: Document changed `version_info'. michael@0: michael@0: . ChangeLog: Announce new release (both in the freetype2 and michael@0: freetype2-demos modules). michael@0: michael@0: . Clone the git archive to another directory with michael@0: michael@0: git clone -l -s . ../freetype2.test michael@0: michael@0: or something like this and run michael@0: michael@0: make distclean; make devel; make michael@0: make distclean; make devel; make multi michael@0: make distclean; make devel CC=g++; make CC=g++ michael@0: make distclean; make devel CC=g++; make multi CC=g++ michael@0: michael@0: sh autogen.sh michael@0: make distclean; ./configure; make michael@0: make distclean; ./configure CC=g++; make michael@0: michael@0: in the cloned repository to test compilation with both gcc and g++. michael@0: michael@0: . Test C++ compilation for freetype2-demos too (using `git clone' as michael@0: above). michael@0: michael@0: . Run src/tools/chktrcmp.py and check that there are no undefined michael@0: trace_XXXX macros. michael@0: michael@0: . Tag the git repositories (freetype2, freetype2-demos) with michael@0: michael@0: git tag VER- -m "" -u michael@0: michael@0: and push the tags with michael@0: michael@0: git push --tags michael@0: michael@0: . Check with michael@0: michael@0: git clean -ndx michael@0: michael@0: that the git directory is really clean (and remove extraneous files michael@0: if necessary). michael@0: michael@0: . Say `make dist' in both the freetype2 and freetype2-demos modules michael@0: to generate the .tar.gz, .tar.bz2, and .zip files. michael@0: michael@0: . Create the doc bundles (freetype-doc-.tar.gz, michael@0: freetype-doc-.tar.bz2, ftdoc.zip). This is michael@0: everything in michael@0: michael@0: /freetype2/docs michael@0: michael@0: except the `reference' subdirectory. Do *not* use option `-l' from michael@0: zip! michael@0: michael@0: . Run the following script (with updated `$VERSION', `$SAVANNAH_USER', michael@0: and $SOURCEFORGE_USER variables) to sign and upload the bundles to michael@0: both Savannah and SourceForge. The signing code has been taken from michael@0: the `gnupload' script (part of the automake bundle). michael@0: michael@0: #!/bin/sh michael@0: michael@0: VERSION=2.5.1 michael@0: SAVANNAH_USER=wl michael@0: SOURCEFORGE_USER=wlemb michael@0: michael@0: ##################################################################### michael@0: michael@0: GPG='/usr/bin/gpg --batch --no-tty' michael@0: michael@0: version=`echo $VERSION | sed "s/\\.//g"` michael@0: michael@0: FREETYPE_PACKAGES="freetype-$VERSION.tar.gz \ michael@0: freetype-$VERSION.tar.bz2 \ michael@0: ft$version.zip" michael@0: FT2DEMOS_PACKAGES="ft2demos-$VERSION.tar.gz \ michael@0: ft2demos-$VERSION.tar.bz2 \ michael@0: ftdmo$version.zip" michael@0: FTDOC_PACKAGES="freetype-doc-$VERSION.tar.gz \ michael@0: freetype-doc-$VERSION.tar.bz2 \ michael@0: ftdoc$version.zip" michael@0: michael@0: PACKAGE_LIST="$FREETYPE_PACKAGES \ michael@0: $FT2DEMOS_PACKAGES \ michael@0: $FTDOC_PACKAGES" michael@0: michael@0: set -e michael@0: unset passphrase michael@0: michael@0: PATH=/empty echo -n "Enter GPG passphrase: " michael@0: stty -echo michael@0: read -r passphrase michael@0: stty echo michael@0: echo michael@0: michael@0: for f in $PACKAGE_LIST; do michael@0: if test ! -f $f; then michael@0: echo "$0: Cannot find \`$f'" 1>&2 michael@0: exit 1 michael@0: else michael@0: : michael@0: fi michael@0: done michael@0: michael@0: for f in $PACKAGE_LIST; do michael@0: echo "Signing $f..." michael@0: rm -f $f.sig michael@0: echo $passphrase | $GPG --passphrase-fd 0 -ba -o $f.sig $f michael@0: done michael@0: michael@0: FREETYPE_SIGNATURES= michael@0: for i in $FREETYPE_PACKAGES; do michael@0: FREETYPE_SIGNATURES="$FREETYPE_SIGNATURES $i.sig" michael@0: done michael@0: michael@0: FT2DEMOS_SIGNATURES= michael@0: for i in $FT2DEMOS_PACKAGES; do michael@0: FT2DEMOS_SIGNATURES="$FT2DEMOS_SIGNATURES $i.sig" michael@0: done michael@0: michael@0: FTDOC_SIGNATURES= michael@0: for i in $FTDOC_PACKAGES; do michael@0: FTDOC_SIGNATURES="$FTDOC_SIGNATURES $i.sig" michael@0: done michael@0: michael@0: SIGNATURE_LIST="$FREETYPE_SIGNATURES \ michael@0: $FT2DEMOS_SIGNATURES \ michael@0: $FTDOC_SIGNATURES" michael@0: michael@0: scp $PACKAGE_LIST $SIGNATURE_LIST \ michael@0: $SAVANNAH_USER@dl.sv.nongnu.org:/releases/freetype/ michael@0: michael@0: rsync -avP -e ssh $FREETYPE_PACKAGES $FREETYPE_SIGNATURES \ michael@0: $SOURCEFORGE_USER,freetype@frs.sf.net:/home/frs/project/f/fr/freetype/freetype2/$VERSION/ michael@0: rsync -avP -e ssh $FT2DEMOS_PACKAGES $FT2DEMOS_SIGNATURES \ michael@0: $SOURCEFORGE_USER,freetype@frs.sf.net:/home/frs/project/f/fr/freetype/freetype-demos/$VERSION/ michael@0: rsync -avP -e ssh $FTDOC_PACKAGES $FTDOC_SIGNATURES \ michael@0: $SOURCEFORGE_USER,freetype@frs.sf.net:/home/frs/project/f/fr/freetype/freetype-docs/$VERSION/ michael@0: michael@0: # EOF michael@0: michael@0: . Prepare a README for SourceForge and upload it with the following michael@0: script (with updated `$VERSION' and $SOURCEFORGE_USER variables). michael@0: michael@0: #!/bin/sh michael@0: michael@0: VERSION=2.5.1 michael@0: SOURCEFORGE_USER=wlemb michael@0: michael@0: ##################################################################### michael@0: michael@0: rsync -avP -e ssh README \ michael@0: $SOURCEFORGE_USER,freetype@frs.sf.net:/home/frs/project/f/fr/freetype/freetype2/$VERSION/ michael@0: michael@0: # EOF michael@0: michael@0: . On SourceForge, tag the just uploaded `ftXXX.zip' and michael@0: `freetype-XXX.tar.bz2' files as the default files to download for michael@0: `Windows' and `Others', respectively. michael@0: michael@0: . Copy the reference files (generated by `make dist') to michael@0: michael@0: /freetype2/docs/reference michael@0: michael@0: . Update the `freetype-web' repository. `git push' then automatically michael@0: triggers an update of the public web pages within ten minutes, due michael@0: to a cron script (on wl@freedesktop.org) that rsyncs with michael@0: michael@0: freedesktop.org://srv/freetype.freedesktop.org/www michael@0: michael@0: . Announce new release on freetype-announce@nongnu.org and to relevant michael@0: newsgroups. michael@0: michael@0: ---------------------------------------------------------------------- michael@0: michael@0: Copyright 2003, 2005-2007, 2009, 2011-2013 by michael@0: David Turner, Robert Wilhelm, and Werner Lemberg. michael@0: michael@0: This file is part of the FreeType project, and may only be used, michael@0: modified, and distributed under the terms of the FreeType project michael@0: license, LICENSE.TXT. By continuing to use, modify, or distribute michael@0: this file you indicate that you have read the license and understand michael@0: and accept it fully. michael@0: michael@0: michael@0: --- end of release ---