For Developers: Making Releases - linuxwacom/xf86-input-wacom GitHub Wiki

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. 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.
  3. Run make distcheck. If make distcheck fails, reset with git reset --hard HEAD~1 and resolve the bugs first.
  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
⚠️ **GitHub.com Fallback** ⚠️