225 lines
6.6 KiB
Plaintext
225 lines
6.6 KiB
Plaintext
How to prepare a new release
|
|
----------------------------
|
|
|
|
. include/freetype/freetype.h: Update `FREETYPE_MAJOR`,
|
|
`FREETYPE_MINOR`, and `FREETYPE_PATCH`.
|
|
|
|
. Update version numbers in all files where necessary (for example, do
|
|
a grep for both '2.13.2' and '2132' for release 2.13.2).
|
|
|
|
. builds/unix/configure.raw: Update `version_info`.
|
|
|
|
. docs/CHANGES: Document differences to last release.
|
|
|
|
. README: Update.
|
|
|
|
. docs/VERSIONS.TXT: Document changed `version_info`.
|
|
|
|
. Update the 'dlg' submodule with
|
|
|
|
git submodule foreach git pull origin master
|
|
|
|
. Copy the submodule code with
|
|
|
|
make copy_submodule
|
|
|
|
and run
|
|
|
|
make distclean && make devel && make
|
|
make distclean && make devel && make multi
|
|
make distclean && make devel CC=g++ && make CC=g++ ANSIFLAGS=""
|
|
make distclean && make devel CC=g++ && make multi CC=g++ ANSIFLAGS=""
|
|
|
|
sh autogen.sh
|
|
make distclean && ./configure CC=g++ && make ANSIFLAGS=""
|
|
|
|
to test compilation with both gcc and g++ (you might also add the `-j`
|
|
flag to `make` for parallel compilation).
|
|
|
|
Note that it is normally not necessary to test standard C
|
|
compilation with the `configure`, `meson`, and `cmake` build tools
|
|
since this is done by the CI process of 'gitlab.freedesktop.org' for
|
|
every commit.
|
|
|
|
. Test C++ compilation for 'freetype-demos' too; this needs a compiled
|
|
FreeType library as described in the `README` file.
|
|
|
|
make distclean && make
|
|
make distclean && make CC=g++ ANSIFLAGS=""
|
|
|
|
. Run `src/tools/chktrcmp.py` and check that there are no undefined
|
|
`trace_XXXX` macros.
|
|
|
|
. Update meson subproject files (for both the 'freetype' and
|
|
'freetype-demos' git repositories) with
|
|
|
|
meson subprojects update
|
|
|
|
. Test meson compilation (for both the 'freetype' and 'freetype-demos'
|
|
git repositories) with
|
|
|
|
meson setup builddir && meson compile -C builddir
|
|
|
|
. Commit everything.
|
|
|
|
. After pushing the new release, tag the git repositories ('freetype',
|
|
'freetype-demos') with
|
|
|
|
git tag VER-<version> -m "" -u <committer>
|
|
|
|
and push the tags with
|
|
|
|
git push --tags
|
|
|
|
. Check with
|
|
|
|
git clean -ndx
|
|
|
|
that the git directory is really clean (and remove extraneous files
|
|
if necessary).
|
|
|
|
. Say `make dist` in both the 'freetype' and 'freetype-demos'
|
|
repositories to generate the `.tar.gz`, `.tar.xz`, and `.zip` files.
|
|
|
|
. Create the doc bundles (`freetype-doc-<version>.tar.gz`,
|
|
`freetype-doc-<version>.tar.xz`, `ftdoc<version>.zip`). This is
|
|
everything in
|
|
|
|
<freetype-web git repository>/freetype2/docs
|
|
|
|
except the `reference` subdirectory. Do *not* use option `-l` from
|
|
zip!
|
|
|
|
. Run the following script (with updated `$VERSION`, `$SAVANNAH_USER`,
|
|
`$SOURCEFORGE_USER`, and `GPG_KEY_ID` variables) to sign and upload
|
|
the bundles to both Savannah and SourceForge. The signing code has
|
|
been taken from the `gnupload` script (part of the 'automake'
|
|
bundle).
|
|
|
|
#!/bin/sh
|
|
|
|
VERSION=2.13.2
|
|
SAVANNAH_USER=wl
|
|
SOURCEFORGE_USER=wlemb
|
|
GPG_KEY_ID=BE6C3AAC63AD8E3F
|
|
|
|
#####################################################################
|
|
|
|
GPG="/usr/bin/gpg --batch --no-tty --local-user $GPG_KEY_ID"
|
|
|
|
version=`echo $VERSION | sed "s/\\.//g"`
|
|
|
|
FREETYPE_PACKAGES="freetype-$VERSION.tar.gz \
|
|
freetype-$VERSION.tar.xz \
|
|
ft$version.zip"
|
|
FT2DEMOS_PACKAGES="ft2demos-$VERSION.tar.gz \
|
|
ft2demos-$VERSION.tar.xz \
|
|
ftdmo$version.zip"
|
|
FTDOC_PACKAGES="freetype-doc-$VERSION.tar.gz \
|
|
freetype-doc-$VERSION.tar.xz \
|
|
ftdoc$version.zip"
|
|
|
|
PACKAGE_LIST="$FREETYPE_PACKAGES \
|
|
$FT2DEMOS_PACKAGES \
|
|
$FTDOC_PACKAGES"
|
|
|
|
set -e
|
|
unset passphrase
|
|
|
|
PATH=/empty echo -n "Enter GPG passphrase: "
|
|
stty -echo
|
|
read -r passphrase
|
|
stty echo
|
|
echo
|
|
|
|
for f in $PACKAGE_LIST; do
|
|
if test ! -f $f; then
|
|
echo "$0: Cannot find \`$f'" 1>&2
|
|
exit 1
|
|
else
|
|
:
|
|
fi
|
|
done
|
|
|
|
for f in $PACKAGE_LIST; do
|
|
echo "Signing $f..."
|
|
rm -f $f.sig
|
|
echo $passphrase | $GPG --passphrase-fd 0 -ba -o $f.sig $f
|
|
done
|
|
|
|
FREETYPE_SIGNATURES=
|
|
for i in $FREETYPE_PACKAGES; do
|
|
FREETYPE_SIGNATURES="$FREETYPE_SIGNATURES $i.sig"
|
|
done
|
|
|
|
FT2DEMOS_SIGNATURES=
|
|
for i in $FT2DEMOS_PACKAGES; do
|
|
FT2DEMOS_SIGNATURES="$FT2DEMOS_SIGNATURES $i.sig"
|
|
done
|
|
|
|
FTDOC_SIGNATURES=
|
|
for i in $FTDOC_PACKAGES; do
|
|
FTDOC_SIGNATURES="$FTDOC_SIGNATURES $i.sig"
|
|
done
|
|
|
|
SIGNATURE_LIST="$FREETYPE_SIGNATURES \
|
|
$FT2DEMOS_SIGNATURES \
|
|
$FTDOC_SIGNATURES"
|
|
|
|
scp $PACKAGE_LIST $SIGNATURE_LIST \
|
|
$SAVANNAH_USER@dl.sv.nongnu.org:/releases/freetype/
|
|
|
|
rsync -avP -e ssh $FREETYPE_PACKAGES $FREETYPE_SIGNATURES \
|
|
$SOURCEFORGE_USER,freetype@frs.sf.net:/home/frs/project/f/fr/freetype/freetype2/$VERSION/
|
|
rsync -avP -e ssh $FT2DEMOS_PACKAGES $FT2DEMOS_SIGNATURES \
|
|
$SOURCEFORGE_USER,freetype@frs.sf.net:/home/frs/project/f/fr/freetype/freetype-demos/$VERSION/
|
|
rsync -avP -e ssh $FTDOC_PACKAGES $FTDOC_SIGNATURES \
|
|
$SOURCEFORGE_USER,freetype@frs.sf.net:/home/frs/project/f/fr/freetype/freetype-docs/$VERSION/
|
|
|
|
# EOF
|
|
|
|
. Prepare a `README` file for SourceForge and upload it with the
|
|
following script (with updated `$VERSION` and `$SOURCEFORGE_USER`
|
|
variables).
|
|
|
|
#!/bin/sh
|
|
|
|
VERSION=2.13.2
|
|
SOURCEFORGE_USER=wlemb
|
|
|
|
#####################################################################
|
|
|
|
rsync -avP -e ssh README \
|
|
$SOURCEFORGE_USER,freetype@frs.sf.net:/home/frs/project/f/fr/freetype/freetype2/$VERSION/
|
|
|
|
# EOF
|
|
|
|
. On SourceForge, tag the just uploaded `ftXXX.zip` and
|
|
`freetype-XXX.tar.xz` files as the default files to download for
|
|
'Windows' and 'Others', respectively.
|
|
|
|
. Trigger the automatic generation of the online API reference by
|
|
updating the `FT_VERSION` variable in file `.gitlab-ci.yml` of the
|
|
'freetype-web' repository.
|
|
|
|
. Announce new release on 'freetype-announce@nongnu.org' and to
|
|
relevant newsgroups. The text should include
|
|
|
|
- SHA256 checksums of all files,
|
|
- instructions how to verify the bundles using the `.sig` file data,
|
|
- the PGP public key used to sign the archives.
|
|
|
|
----------------------------------------------------------------------
|
|
|
|
Copyright (C) 2003-2024 by
|
|
David Turner, Robert Wilhelm, and Werner Lemberg.
|
|
|
|
This file is part of the FreeType project, and may only be used,
|
|
modified, and distributed under the terms of the FreeType project
|
|
license, LICENSE.TXT. By continuing to use, modify, or distribute
|
|
this file you indicate that you have read the license and understand
|
|
and accept it fully.
|
|
|
|
|
|
--- end of release ---
|