[HarfBuzz] harfbuzz: Branch 'master'

[Behdad Esfahbod]

 RELEASING.md |   96 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 96 insertions(+)

New commits:
commit 933a81d74fee0d5856fc7b15b58a16e0e0168e48
Author: ebraminio <ebrahim at gnu.org>
Date:   Sun Oct 1 19:35:24 2017 +0330

    Add release checklist (#529)

diff --git a/RELEASING.md b/RELEASING.md
new file mode 100644
index 00000000..34f64988
--- /dev/null
+++ b/RELEASING.md
@@ -0,0 +1,96 @@
+HarfBuzz release walk-through checklist:
+
+1. Open gitk and review changes since last release.
+   * `git diff $(git describe | sed 's/-.*//').. src/*.h` prints all public API changes.
+
+     Document them in NEWS,  All API and API semantic changes should be clearly
+     marked as API additions, API changes, or API deletions.
+     If there's a backward-incompatible API change (including deletions for API used anywhere),
+     that's a release blocker.  Do NOT release.  Document deprecations.
+2. Based on severity of changes, decide whether it's a minor or micro release number bump,
+3. Make sure you have correct date and new version at the top of NEWS file,
+4. Bump version in configure.ac line 3,
+5. Do "make distcheck", if it passes, you get a tarball.
+   Otherwise, fix things and commit them separately before making release,
+6. "make release-files". Enter your GPG password again.  This creates a sha256 hash and signs it.
+7. Now that you have a tarball built, commit NEWS and configure.ac changes.  The commit message
+   is simply the release number.  Eg. "1.4.7"
+8. Tag the release and sign it: Eg. "git tag -s 1.4.7 -m 1.4.7".  Enter your GPG password.
+9. Build win32 bundle.
+   1. Put contents of [this](https://drive.google.com/open?id=0B3_fQkxDZZXXbWltRGd5bjVrUDQ) on your `~/.local/i686-w64-mingw32`
+   2. Run `./MING32 --with-uniscribe` script (available below) to config harfbuzz with mingw
+   3. make
+   4. `./UPDATE.sh` (available below)
+10. Copy all artefacts to users.freedesktop.org and move them into `/srv/www.freedesktop.org/www/software/harfbuzz/release`
+    There should be four files.  Eg.:
+ ```
+-rw-r--r--  1 behdad eng 1592693 Jul 18 11:25 harfbuzz-1.4.7.tar.bz2
+-rw-r--r--  1 behdad eng      89 Jul 18 11:34 harfbuzz-1.4.7.tar.bz2.sha256
+-rw-r--r--  1 behdad eng     339 Jul 18 11:34 harfbuzz-1.4.7.tar.bz2.sha256.asc
+-rw-r--r--  1 behdad eng 2895619 Jul 18 11:34 harfbuzz-1.4.7-win32.zip
+```
+11. While doing that, quickly double-check the size of the .tar.bz2 and .zip files against their previous releases to make sure nothing bad happened.  They should be in the ballpark, perhaps slightly larger.  Sometimes they do shrink, that's not by itself a stopper.
+12. Push the commit and tag out: "git push --follow-tags".  Make sure it's pushed both to freedesktop repo and github.
+13. Upload artefacts and NEWS entry on the github release.
+
+
+## MING32
+```bash
+#!/bin/bash
+
+target=i686-w64-mingw32
+
+unset CC
+unset CXX
+unset CPP
+unset LD
+unset LDFLAGS
+unset CFLAGS
+unset CXXFLAGS
+unset PKG_CONFIG_PATH
+
+# Removed -static from the following
+export CFLAGS="-static-libgcc"
+export CXXFLAGS="-static-libgcc -static-libstdc++"
+export CPPFLAGS=-I$HOME/.local/$target/include
+export LDFLAGS=-L$HOME/.local/$target/lib
+export PKG_CONFIG_LIBDIR=$HOME/.local/$target/lib/pkgconfig
+export PATH=$HOME/.local/$target/bin:$PATH
+
+../configure --build=`~/script/config.guess` --host=$target --prefix=/home/behdad/.local/$target "$@"
+```
+
+## UPDATE.sh
+```bash
+#!/bin/bash
+
+v=$1
+
+if test "x$v" = x; then
+	echo "usage: UPDATE.sh micro-version"
+	exit 1
+fi
+
+dir_prefix=harfbuzz-1.4.
+dir_suffix=-win32
+dir=$dir_prefix$v$dir_suffix
+dir_old=$dir_prefix$((v-1))$dir_suffix
+if test -d "$dir"; then
+	echo "New dir $dir exists; not overwriting"
+	exit 1
+fi
+if ! test -d "$dir_old"; then
+	echo "Old dir $dir_old does NOT exist; aborting"
+	exit 1
+fi
+set -ex
+cp -a "$dir_old" "$dir.tmp"
+rm -f "$dir.tmp"/GDX32.dll
+rm -f "$dir.tmp"/usp10.dll
+cp ../winbuild/src/.libs/libharfbuzz-0.dll{,.def} $dir.tmp/
+cp ../winbuild/util/.libs/hb-{shape,view}.exe $dir.tmp/
+i686-w64-mingw32-strip $dir.tmp/{hb-shape.exe,hb-view.exe,libharfbuzz-0.dll}
+mv $dir.tmp $dir
+zip -r $dir.zip $dir
+echo Bundle $dir.zip ready
+```