harfbuzz/RELEASING.md

73 lines
3.1 KiB
Markdown
Raw Normal View History

2017-10-01 18:05:24 +02:00
HarfBuzz release walk-through checklist:
1. Open gitk and review changes since last release.
2017-10-23 19:10:21 +02:00
* `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. Document
2018-06-13 01:32:04 +02:00
deprecations. Ensure all new API / deprecations are in listed correctly in
2018-10-30 23:52:26 +01:00
docs/harfbuzz-sections.txt. If release added new API, add entry for new
API index at the end of docs/harfbuzz-docs.xml.
2017-10-23 19:10:21 +02:00
If there's a backward-incompatible API change (including deletions for API
used anywhere), that's a release blocker. Do NOT release.
2. Based on severity of changes, decide whether it's a minor or micro release
number bump,
3. Search for REPLACEME on the repository and replace it with the chosen version
for the release.
2017-10-23 19:10:21 +02:00
4. Make sure you have correct date and new version at the top of NEWS file,
2017-10-23 19:10:21 +02:00
5. Bump version in configure.ac line 3,
6. Do "make distcheck", if it passes, you get a tarball.
2017-10-01 18:05:24 +02:00
Otherwise, fix things and commit them separately before making release,
2018-08-09 06:54:08 +02:00
Note: Check src/hb-version.h and make sure the new version number is
there. Sometimes, it does not get updated. If that's the case,
"touch configure.ac" and rebuild. Also check that there is no hb-version.h
in your build/src file. Typically it will fail the distcheck if there is.
That's what happened to 2.0.0 going out with 1.8.0 hb-version.h... So, that's
a clue.
2017-10-23 19:10:21 +02:00
2019-03-29 22:30:02 +01:00
7. Now that you have release files, commit NEWS, configure.ac, and src/hb-version.h,
2018-06-06 00:17:39 +02:00
as well as any REPLACEME changes you made. The commit message is simply the
release number. Eg. "1.4.7"
2017-10-23 19:10:21 +02:00
2019-03-29 22:30:02 +01:00
8. "make dist" again to get a tarball with your new commit in the ChangeLog. Then
"make release-files". Enter your GPG password. This creates a sha256 hash
and signs it. Check the size of the three resulting files.
9. Tag the release and sign it: Eg. "git tag -s 1.4.7 -m 1.4.7". Enter your
2017-10-23 19:10:21 +02:00
GPG password again.
10. Build win32 bundle.
2017-10-23 19:10:21 +02:00
a. Build Win32 binaries. See [README.mingw.md](README.mingw.md).
2017-10-23 19:10:21 +02:00
b. Run "make dist-win" to build Win32 bundle.
2017-10-23 19:10:21 +02:00
11. Copy all artefacts to users.freedesktop.org and move them into
2017-10-23 19:10:21 +02:00
`/srv/www.freedesktop.org/www/software/harfbuzz/release` There should be four
files. Eg.:
2017-10-01 18:05:24 +02:00
```
-rw-r--r-- 1 behdad eng 1592693 Jul 18 11:25 harfbuzz-1.4.7.tar.xz
-rw-r--r-- 1 behdad eng 89 Jul 18 11:34 harfbuzz-1.4.7.tar.xz.sha256
-rw-r--r-- 1 behdad eng 339 Jul 18 11:34 harfbuzz-1.4.7.tar.xz.sha256.asc
2017-10-01 18:05:24 +02:00
-rw-r--r-- 1 behdad eng 2895619 Jul 18 11:34 harfbuzz-1.4.7-win32.zip
```
2017-10-23 19:10:21 +02:00
12. While doing that, quickly double-check the size of the .tar.xz and .zip
2017-10-23 19:10:21 +02:00
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.
13. Push the commit and tag out: "git push --follow-tags". Make sure it's
2017-10-23 19:10:21 +02:00
pushed both to freedesktop repo and github.
14. Go to GitHub release page [here](https://github.com/harfbuzz/harfbuzz/releases),
2017-10-23 19:10:21 +02:00
edit the tag, upload artefacts and NEWS entry and save.