• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1HarfBuzz release walk-through checklist:
2
31. Open gitk and review changes since last release.
4
5   * `git diff $(git describe | sed 's/-.*//').. src/*.h` prints all public API
6     changes.
7
8     Document them in NEWS.  All API and API semantic changes should be clearly
9     marked as API additions, API changes, or API deletions.  Document
10     deprecations.
11
12     If there's a backward-incompatible API change (including deletions for API
13     used anywhere), that's a release blocker.  Do NOT release.
14
152. Based on severity of changes, decide whether it's a minor or micro release
16   number bump,
17
183. Make sure you have correct date and new version at the top of NEWS file,
19
204. Bump version in configure.ac line 3,
21
225. Do "make distcheck", if it passes, you get a tarball.
23   Otherwise, fix things and commit them separately before making release,
24
256. "make release-files".  Enter your GPG password.  This creates a sha256 hash
26   and signs it.
27
287. Now that you have release files built, commit NEWS and configure.ac changes.
29   The commit message is simply the release number.  Eg. "1.4.7"
30
318. Tag the release and sign it: Eg. "git tag -s 1.4.7 -m 1.4.7".  Enter your
32   GPG password again.
33
349. Build win32 bundle.
35
36   a. Put contents of [this](https://drive.google.com/open?id=0B3_fQkxDZZXXbWltRGd5bjVrUDQ) on your `~/.local/i686-w64-mingw32`,
37
38   b. Run `./MING32 --with-uniscribe` script (available below) to configure harfbuzz with mingw in a subdirector (eg. winbuild/),
39
40   c. make
41
42   d. Back in the parent directory, run `./UPDATE.sh` (available below) to build win32 bundle.
43
4410. Copy all artefacts to users.freedesktop.org and move them into
45    `/srv/www.freedesktop.org/www/software/harfbuzz/release` There should be four
46    files.  Eg.:
47 ```
48-rw-r--r--  1 behdad eng 1592693 Jul 18 11:25 harfbuzz-1.4.7.tar.bz2
49-rw-r--r--  1 behdad eng      89 Jul 18 11:34 harfbuzz-1.4.7.tar.bz2.sha256
50-rw-r--r--  1 behdad eng     339 Jul 18 11:34 harfbuzz-1.4.7.tar.bz2.sha256.asc
51-rw-r--r--  1 behdad eng 2895619 Jul 18 11:34 harfbuzz-1.4.7-win32.zip
52```
53
5411. While doing that, quickly double-check the size of the .tar.bz2 and .zip
55    files against their previous releases to make sure nothing bad happened.
56    They should be in the ballpark, perhaps slightly larger.  Sometimes they
57    do shrink, that's not by itself a stopper.
58
5912. Push the commit and tag out: "git push --follow-tags".  Make sure it's
60    pushed both to freedesktop repo and github.
61
6213. Go to GitHub release page [here](https://github.com/harfbuzz/harfbuzz/releases),
63    edit the tag, upload artefacts and NEWS entry and save.
64
65
66## MING32
67```bash
68#!/bin/bash
69
70target=i686-w64-mingw32
71
72unset CC
73unset CXX
74unset CPP
75unset LD
76unset LDFLAGS
77unset CFLAGS
78unset CXXFLAGS
79unset PKG_CONFIG_PATH
80
81# Removed -static from the following
82export CFLAGS="-static-libgcc"
83export CXXFLAGS="-static-libgcc -static-libstdc++"
84export CPPFLAGS=-I$HOME/.local/$target/include
85export LDFLAGS=-L$HOME/.local/$target/lib
86export PKG_CONFIG_LIBDIR=$HOME/.local/$target/lib/pkgconfig
87export PATH=$HOME/.local/$target/bin:$PATH
88
89../configure --build=`../config.guess` --host=$target --prefix=$HOME/.local/$target "$@"
90```
91
92## UPDATE.sh
93```bash
94#!/bin/bash
95
96v=$1
97
98if test "x$v" = x; then
99	echo "usage: UPDATE.sh micro-version"
100	exit 1
101fi
102
103dir_prefix=harfbuzz-1.4.
104dir_suffix=-win32
105dir=$dir_prefix$v$dir_suffix
106dir_old=$dir_prefix$((v-1))$dir_suffix
107if test -d "$dir"; then
108	echo "New dir $dir exists; not overwriting"
109	exit 1
110fi
111if ! test -d "$dir_old"; then
112	echo "Old dir $dir_old does NOT exist; aborting"
113	exit 1
114fi
115set -ex
116cp -a "$dir_old" "$dir.tmp"
117rm -f "$dir.tmp"/GDX32.dll
118rm -f "$dir.tmp"/usp10.dll
119cp ../winbuild/src/.libs/libharfbuzz-0.dll{,.def} $dir.tmp/
120cp ../winbuild/util/.libs/hb-{shape,view}.exe $dir.tmp/
121i686-w64-mingw32-strip $dir.tmp/{hb-shape.exe,hb-view.exe,libharfbuzz-0.dll}
122mv $dir.tmp $dir
123zip -r $dir.zip $dir
124echo Bundle $dir.zip ready
125```
126