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

[Peter Hutterer]

On Wed, Apr 29, 2015 at 07:21:05PM +0200, Uli Schlachter wrote:
> 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?

leftover, sorry. dropped now, thanks.

Cheers,
   Peter
 
> > +.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!"