modules/freetype2/docs/release

   1 How to prepare a new release
   2 ----------------------------
   3
   4 . include/freetype/freetype.h:  Update FREETYPE_MAJOR, FREETYPE_MINOR,
   5   and FREETYPE_PATCH.
   6
   7 . Update version numbers in all files where necessary (for example, do
   8   a grep for both `2.3.1' and `231' for release 2.3.1).
   9
  10 . builds/unix/configure.raw: Update `version_info'.
  11
  12 . docs/CHANGES: Document differences to last release.
  13
  14 . README: Update.
  15
  16 . docs/VERSION.DLL: Document changed `version_info'.
  17
  18 . ChangeLog: Announce  new release  (both in  freetype2  and  ft2demos
  19   modules).
  20
  21 . Copy the CVS archive to another directory and run
  22
  23     make distclean; make devel; make
  24     make distclean; make devel; make multi
  25     make distclean; make devel CC=g++; make CC=g++
  26     make distclean; make devel CC=g++; make multi CC=g++
  27
  28     sh autogen.sh
  29     make distclean; ./configure; make
  30     make distclean; ./configure CC=g++; make
  31
  32   to test compilation with both gcc and g++.
  33
  34 . Test C++ compilation for ft2demos too.
  35
  36 . Tag the CVS (freetype2, ft2demos).
  37
  38   TODO: Tag the home page CVS on savannah.nongnu.org.
  39
  40 . Say `make  dist'  in both  the  freetype2 and  ft2demos  modules  to
  41   generate the .tar.gz, .tar.bz2, and .zip files.
  42
  43 . Create     the     doc    bundles    (freetype-doc-<version>.tar.gz,
  44   freetype-doc-<version>.tar.bz2,    ftdoc<version>.zip).    This   is
  45   everything below
  46
  47     freetype.freedesktop.org:/srv/freetype.freedesktop.org/www/freetype2/docs/
  48
  49   except the `reference' subdirectory.   Do *not* use option `-l' from
  50   zip!
  51
  52 . Run the following script (with updated `$VERSION', `$SAVANNAH_USER',
  53   and $SOURCEFORGE_USER  variables) to sign and upload the  bundles to
  54   both Savannah and SourceForge.  The signing code has been taken from
  55   the `gnupload' script (part of the automake bundle).
  56
  57     #!/bin/sh
  58
  59     VERSION=2.3.7
  60     SAVANNAH_USER=wl
  61     SOURCEFORGE_USER=wlemb
  62
  63     #####################################################################
  64
  65     GPG='/usr/bin/gpg --batch --no-tty'
  66
  67     version=`echo $VERSION | sed "s/\\.//g"`
  68
  69     UNIX_PACKAGES="freetype ft2demos freetype-doc"
  70     WINDOWS_PACKAGES="ft ftdmo ftdoc"
  71     UNIX_ZIP="tar.gz tar.bz2"
  72     WINDOWS_ZIP="zip"
  73
  74     PACKAGE_LIST=
  75     for i in $UNIX_PACKAGES; do
  76       for j in $UNIX_ZIP; do
  77         PACKAGE_LIST="$PACKAGE_LIST $i-$VERSION.$j"
  78       done
  79     done
  80     for i in $WINDOWS_PACKAGES; do
  81       for j in $WINDOWS_ZIP; do
  82         PACKAGE_LIST="$PACKAGE_LIST $i$version.$j"
  83       done
  84     done
  85
  86     set -e
  87     unset passphrase
  88
  89     PATH=/empty echo -n "Enter GPG passphrase: "
  90     stty -echo
  91     read -r passphrase
  92     stty echo
  93     echo
  94
  95     for f in $PACKAGE_LIST; do
  96       if test ! -f $f; then
  97         echo "$0: Cannot find \`$f'" 1>&2
  98         exit 1
  99       else
 100         :
 101       fi
 102     done
 103
 104     for f in $PACKAGE_LIST; do
 105       echo "Signing $f..."
 106       rm -f $f.sig
 107       echo $passphrase | $GPG --passphrase-fd 0 -ba -o $f.sig $f
 108     done
 109
 110     SIGNATURE_LIST=
 111     for i in $PACKAGE_LIST; do
 112       SIGNATURE_LIST="$SIGNATURE_LIST $i.sig"
 113     done
 114
 115     scp $PACKAGE_LIST $SIGNATURE_LIST \
 116       $SAVANNAH_USER@dl.sv.nongnu.org:/releases/freetype/
 117
 118     rsync -avP -e ssh $PACKAGE_LIST $SIGNATURE_LIST \
 119       $SOURCEFORGE_USER@frs.sf.net:uploads/
 120
 121     # EOF
 122
 123 . While files on savannah.gnu.org are automatically moved to the right
 124   directory, it must be done manually on SourceForge.  Do that now.
 125
 126 . Update the FreeType release notes on SourceForge.
 127
 128 . Copy the reference files (generated by `make dist') to
 129
 130     freetype.freedesktop.org:/srv/freetype.freedesktop.org/www/freetype2/docs/reference
 131
 132   and
 133
 134     shell.sf.net:/home/groups/f/fr/freetype/htdocs/freetype2/docs/reference
 135
 136   TODO: Create  FreeType  home  page  CVS  on savannah.nongnu.org  and
 137         update it accordingly.
 138
 139         Write script to automatically do this.
 140
 141         Mirror FreeType's savannah home page everywhere.
 142
 143 . Update
 144
 145     freetype.freedesktop.org:/srv/freetype.freedesktop.org/www/index2.html
 146
 147   and copy it to
 148
 149     shell.sf.net:/home/groups/f/fr/freetype/htdocs/index2.html
 150
 151 . Announce new release on freetype-announce@nongnu.org and to relevant
 152   newsgroups.
 153
 154 ----------------------------------------------------------------------
 155
 156 Copyright 2003, 2005, 2006, 2007 by
 157 David Turner, Robert Wilhelm, and Werner Lemberg.
 158
 159 This  file is  part of  the FreeType  project, and  may only  be used,
 160 modified,  and distributed  under the  terms of  the  FreeType project
 161 license,  LICENSE.TXT.  By  continuing to  use, modify,  or distribute
 162 this file you  indicate that you have read  the license and understand
 163 and accept it fully.
 164
 165
 166 --- end of release ---