For Developers: Making Releases

xf86-input-wacom and libwacom

This section describes how to do a new xf86-input-wacom release. VERSION stands for the new version (e.g. 0.10.3), OLDVERSION for the previous version (e.g. 0.10.2). The release process is identical for libwacom, just replace "xf86-input-wacom" with "libwacom".

1. Edit configure.ac and change the version number. Commit with git commit -sm "wacom VERSION" configure.ac You must not have uncommitted changes when releasing a new version.
2. Run make distcheck. If make distcheck fails, reset with git reset --hard HEAD~1 and resolve the bugs first.
3. Follow our wiki's installation instructions to build and install the driver from the tarball generated in the previous step. Verify that the new version shows in ~/.local/share/xorg/Xorg.0.log.
4. Tag the module: git tag -m "xf86-input-wacom VERSION" -s xf86-input-wacom-VERSION. This will ask for your gpg key to do a signed tag.
5. Push to the remote: git push origin master
6. Create a GitHub Personal Access Token with the permissions repo and write:packages. Save the token value in the $TOKEN environment variable (e.g. save token in a file, then TOKEN=$(cat path/to/token.txt) so the value never shows up in the shell history).
7. Run the release script: sh release.sh --token $TOKEN . (note the '.' path). This script pushes the tag, generates and uploads the tarballs to the remote, and generates an announcement. Run with --dry-run for testing purposes where needed. Also see below.
8. Edit the release announcement on Github, adding a few paragraphs which summarize the new features in this version. If this is an RC release, be sure to check the "This is a pre-release" item at the bottom of the page.
9. Close all Github issues that were fixed in this release by setting the status to "closed-fixed" and posting the following message: "Fix available in xf86-input-wacom "

Note that it may take a while until the uploaded tarballs are available through the download links.

Release script Parameters

Parameter	Value	Exaplanation
--token	<your Github access token value>	The token can be generated here: https://github.com/settings/tokens
	'dot' (.)	takes the place of the project name