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 Making Patches for general patch format. See Installing 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 thier trees, they can be (backported and) applied to input-wacom.

A rough guide to doing this is:

0. Clone the kernel source tree

    https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux-stable.git 

1. Make and commit your changes

    git commit drivers/hid/wacom... 

2. Create a patch

    git format-patch HEAD~ # for one commit

3. Send your patch to the list for review

    git send-email --to [email protected] 0001-patch-name.patch

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

Once a device is supported upstream, feel free to submit patches for backported support using pull requests on Github. Please see Submitting Patches for the linuxwacom project's guidelines for the submission process.