man: replace the various suffixes with their actual numbers
These don't change, iirc they exist because of some unixes having
different man pages but at this point really on Solaris is left and that
uses the same suffixes as everyone else.
And the __xservername__ is a leftover from the Xfree86 vs Xorg days - if
you're still running Xfree86, you're not using this driver.
Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
Peter Hutterer authored 2 years ago
Timo Aaltonen committed 9 months ago
| 0 | 0 | .\" shorthand for double quote that works everywhere. |
| 1 | 1 | .ds q \N'34' |
| 2 | .TH LIBINPUT __drivermansuffix__ __vendorversion__ | |
| 2 | .TH LIBINPUT 4 __vendorversion__ | |
| 3 | 3 | .SH NAME |
| 4 | 4 | libinput \- libinput-based X.Org input driver |
| 5 | 5 | .SH SYNOPSIS |
| 19 | 19 | |
| 20 | 20 | .SH DESCRIPTION |
| 21 | 21 | .B libinput |
| 22 | is an __xservername__ input driver based on libinput. It | |
| 22 | is an Xorg input driver based on libinput. It | |
| 23 | 23 | therefore supports all input devices that libinput can handle, including |
| 24 | 24 | most mice, keyboards, tablets and touchscreens. |
| 25 | 25 | .PP |
| 27 | 27 | .B libinput |
| 28 | 28 | devices are configured through the |
| 29 | 29 | .B InputClass |
| 30 | directive (refer to __xconfigfile__(__filemansuffix__)) instead of manual | |
| 30 | directive (refer to xorg.conf(5)) instead of manual | |
| 31 | 31 | per-device configuration. Devices configured in the |
| 32 | __xconfigfile__(__filemansuffix__) are not hot-plug capable. | |
| 32 | xorg.conf(5) are not hot-plug capable. | |
| 33 | 33 | |
| 34 | 34 | .SH CONFIGURATION DETAILS |
| 35 | Please refer to __xconfigfile__(__filemansuffix__) for general configuration | |
| 35 | Please refer to xorg.conf(5) for general configuration | |
| 36 | 36 | details and for options that can be used with all input drivers. This |
| 37 | 37 | section only covers configuration details specific to this driver. |
| 38 | 38 | .PP |
| 54 | 54 | .TP 7 |
| 55 | 55 | .BI "Option \*qButtonMapping\*q \*q" string \*q |
| 56 | 56 | Sets the logical button mapping for this device, see |
| 57 | XSetPointerMapping(__libmansuffix__). The string must be a | |
| 57 | XSetPointerMapping(3). The string must be a | |
| 58 | 58 | space-separated list of button mappings in the order of the |
| 59 | 59 | logical buttons on the device, starting with button 1. |
| 60 | 60 | The default mapping is "1 2 3 ... 32". A mapping of 0 |
| 354 | 354 | .B "\*q3 2 1 ...\*q" |
| 355 | 355 | On systems using the |
| 356 | 356 | .B libinput |
| 357 | __xservername__ input driver it is recommended to use the | |
| 357 | Xorg input driver it is recommended to use the | |
| 358 | 358 | .B LeftHanded |
| 359 | 359 | option instead. |
| 360 | 360 | .PP |
| 361 | 361 | The |
| 362 | 362 | .B libinput |
| 363 | __xservername__ input driver does not use the button mapping after setup. | |
| 364 | Use XSetPointerMapping(__libmansuffix__) to modify the button mapping at | |
| 363 | Xorg input driver does not use the button mapping after setup. | |
| 364 | Use XSetPointerMapping(3) to modify the button mapping at | |
| 365 | 365 | runtime. |
| 366 | 366 | |
| 367 | 367 | .SH BUTTON DRAG LOCK |
| 433 | 433 | This driver does not work with \fBOption \*qDevice\*q\fR set to an event |
| 434 | 434 | node in \fI/dev/input/by-id\fR and \fI/dev/input/by-path\fR. This can be |
| 435 | 435 | usually be worked by using \fBSection \*qInputClass\*q\fR with an |
| 436 | appropriate \fBMatch*\fR statement in the __xconfigfile__(__filemansuffix__). | |
| 436 | appropriate \fBMatch*\fR statement in the xorg.conf(5). | |
| 437 | 437 | |
| 438 | 438 | .SH AUTHORS |
| 439 | 439 | Peter Hutterer |
| 440 | 440 | .SH "SEE ALSO" |
| 441 | __xservername__(__appmansuffix__), __xconfigfile__(__filemansuffix__), Xserver(__appmansuffix__), X(__miscmansuffix__) | |
| 441 | Xorg(1), xorg.conf(5), Xserver(1), X(7) | |