[PATCH xf86-input-libinput 4/4] Add option "ButtonMapping" (#9206)

[Uli Schlachter]

Hi,

Am 29.04.2015 um 01:51 schrieb Peter Hutterer:
> With a long entry in the man page to detail what this option does.
> Specifically, it's the xorg.conf equivalent to XSetPointerMapping(3), it
> doesn't do any physical button remappings, merely the logical ones. If the
> physical button isn't mapped to the right logical button by default, that's
> either a libiput bug or an xkcd 1172 issue.
> 
> X.Org Bug 9206 <http://bugs.freedesktop.org/show_bug.cgi?id=9206>
> 
> Signed-off-by: Peter Hutterer <peter.hutterer at who-t.net>
> ---
>  man/libinput.man | 38 +++++++++++++++++++++++++++++++++++++
>  src/libinput.c   | 57 +++++++++++++++++++++++++++++++++++++++++++++++++-------
>  2 files changed, 88 insertions(+), 7 deletions(-)
> 
> diff --git a/man/libinput.man b/man/libinput.man
> index c5eaea5..3b2697e 100644
> --- a/man/libinput.man
> +++ b/man/libinput.man
[...]
> @@ -167,6 +180,31 @@ The above properties have a
>  .BI "libinput <property name> Default"
>  equivalent that indicates the default value for this setting on this device.
>  
> +.SH BUTTON MAPPING
> +X clients receive events with logical button numbers, where 1, 2, 3
> +are usually interpreted as left, middle, right and logical buttons 4, 5, 6,
> +7 are usually interpreted as scroll up, down, left, right. The fourth and
> +fifth physical buttons on a device will thus send logical buttons 8 and 9.
> +The
> +.B ButtonMapping
> +option adjusts the logical button mapping, it does not affect how a physical
> +button is mapped to a logical button.
> +.PP
> +Traditionally, a device was set to left-handed button mode by applying a
> +button mapping of
> +.B "\*q3 2 1 ...\*q"
> +On systems using the
> +.B libinput
> +__xservername__ input driver it is recommended to use the
> +.B LeftHanded
> +option instead. Adjusting the

Adjusting the what?

> +.PP
> +The
> +.B libinput
> +__xservername__ input driver does not use the button mapping after setup.
> +Use XSetPointerMapping(__libmansuffix__) to modify the button mapping at
> +runtime.
> +
>  .SH AUTHORS
>  Peter Hutterer
>  .SH "SEE ALSO"
[...]

Cheers,
Uli

-- 
"For saving the Earth.. and eating cheesecake!"