From fbd6e49f8fd89d9fd7824aaea48aa504a518ebb5 Mon Sep 17 00:00:00 2001 From: Johan Malm Date: Mon, 1 Jan 2024 20:04:48 +0000 Subject: [PATCH] labwc-config(5): update libinput section --- docs/labwc-config.5.scd | 73 ++++++++++++++++++++++++++++++----------- docs/rc.xml.all | 6 ++-- 2 files changed, 57 insertions(+), 22 deletions(-) diff --git a/docs/labwc-config.5.scd b/docs/labwc-config.5.scd index db01c469..94b13239 100644 --- a/docs/labwc-config.5.scd +++ b/docs/labwc-config.5.scd @@ -435,55 +435,90 @@ windows using the mouse. ## LIBINPUT -** - Define a category of devices to use the configuration values that - follow. The category can be set to touch (devices that define a width - and height), touchpad, non-touch, default, or the name of a device. You - can obtain your devices name by running *libinput list-devices* (you may - need to be root or a part of the input group to perform this.) Any - members of this category that are not set use the default for the - device. With the exception of tap-to-click, which is enabled by default. - -** [yes|no] +``` + + + + + + + yes + + + + + + + +``` + +** + Define a new libinput configuration category (profile). + + *CATEGORY* Defines a category of devices (by type or name) to apply the + settings that follow. The category attribute as optional. If no category + attribute is provided, a 'default' device profile will created that will + act as the fallback for all libinput devices. Category can be set to any + of the following types: + - *touch* - Devices which have a defined width/height, but do not + support multitouch (i.e. they cannot track multiple locations where + the screen has been touched). Drawing tablets typically fall into this + type. + - *touchpad* - Same as 'touch' but support multitouch. This typically + includes laptop track pads with two-finger scroll and swipe gestures. + - *non-touch* - Anything not described above, for example traditional + mouse pointers. + - *default* - Defines a device-category applicable to all devices not + matched by anything else. This can be useful for a fallback, or if you + want the same settings to be applied to all devices. + + If the provided category value is different from all of the above key + words, it will be used to match the device name directly. + + A list of device names can be obtained by running + *libinput list-devices* (you may need to be root or a part of the input + group to perform this.) + +** [yes|no] Use natural scrolling for this category if available. -** [yes|no] +** [yes|no] Use your devices left-handed mode if available. -** [\-1.0 to 1.0] +** [\-1.0 to 1.0] Set the pointer speed for this category. The speed is a number between \-1.0 and 1.0, with 0.0 being the default in most cases, and 1.0 being the fastest. -** [flat|adaptive] +** [flat|adaptive] Set the pointer's acceleration profile for this category. Flat applies no acceleration (the pointers velocity is constant), while adaptive changes the pointers speed based the actual speed of your mouse or finger on your touchpad. -** [yes|no] +** [yes|no] Enable or disable tap-to-click for this category. This is enabled by default for all categories. -** [lrm|lmr] +** [lrm|lmr] Set the buttons mapped to one-, two-, and three-finger taps to the left button, right button, and middle button, respectively (lrm) (the default), or to left button, middle button, and right button (lmr). -** [yes|no] +** [yes|no] Enable or disable tap-and-drag for this category. Tap-and-drag processes a tap immediately followed by a finger down as the start of a drag. -** [yes|no] +** [yes|no] Enable or disable drag lock for this category. Drag lock ignores a momentary release of a finger during tap-and-dragging. -** [yes|no] +** [yes|no] Enable or disable middle button emulation for this category. Middle emulation processes a simultaneous left and right click as a press of the middle mouse button (scroll wheel). -** [yes|no] +** [yes|no] Enable or disable disable while typing for this category. DWT ignores any motion events while a keyboard is typing, and for a short while after as well. diff --git a/docs/rc.xml.all b/docs/rc.xml.all index c4c1ef31..7e6d6530 100644 --- a/docs/rc.xml.all +++ b/docs/rc.xml.all @@ -408,9 +408,9 @@