For Developers: input wacom development process

If you are developing support for new devices, please develop against upstream kernels first.

Developing

The input-wacom driver is available through git for developers to hack on. Before using it, you should install your distribution's git, autoconf, and automake tools. Afterwards, you may clone the repository as follows:

$ git clone https://github.com/linuxwacom/input-wacom.git
$ cd input-wacom

Please see our guide for submitting patches. Also review installing input wacom from source for info on how to build and install the driver.

Submitting Upstream

We try to keep the 4.5 and 3.17 drivers as close to upstream as possible. Therefore, patches to input-wacom which touch the 4.5/3.17 folders must be accepted to the Linux kernel first.

To do this, submit them to [email protected] where they must be approved by Jiri Kosina or Benjamin Tissoires. After Jiri or Benjamin accepts them into one of their trees, they can be (backported and) applied to input-wacom.

A rough guide to doing this is:

1. Subscribe to the LKML's "linux-input" mailinglist by sending a plain-text email to [email protected]. The subject can be anything, but the body should only contain subscribe linux-input
2. Clone the upstream kernel (or HID) source tree:
   • https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
   • https://git.kernel.org/pub/scm/linux/kernel/git/hid/hid.git
3. Create a branch for your changes: git checkout master -b mybranch
4. Make and commit your changes: git commit <changed-files>
5. Create a patch set: git format-patch master
6. Send your patch to the "linux-input" mailinglist for review:

   $ git send-email --to [email protected] \
     --to "Jiri Kosina <[email protected]>" \
     --to "Benjamin Tissoires <[email protected]>" \
     --cc "Ping Cheng <[email protected]>" \
     --cc "Aaron Armstrong Skomra <[email protected]>" \
     --cc "Jason Gerecke <[email protected]>" \
     --cc "Joshua Dickens <[email protected]>" \
     <list-of-patch-files>
   

7. Monitor the "linux-input" mailinglist for replies to your patches and provide feedback if required.
8. Once the patches have been merged, backport them to the linux-input repository and create a pull request (see below).

Resources for submitting upstream patches

• http://nickdesaulniers.github.io/blog/2017/05/16/submitting-your-first-patch-to-the-linux-kernel-and-responding-to-feedback/
• http://elixir.free-electrons.com/linux/latest/source/Documentation/process
• https://kernelnewbies.org/FirstKernelPatch

input-wacom and backport support

Upstream patches should be quickly backported and merged into input-wacom to ensure the project stays up-to-date. The process for creating backports is as follows:

backport them to input-wacom and create a pull request here on Github. The

submit patches for backported support using pull requests on Github. Please see Submitting Patches for the linuxwacom project's guidelines for the submission process.