fdo-mirrors/libinput
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/libinput/libinput.git synced 2025-12-20 17:20:04 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions
libinput/tools/libinput-list-devices.man

42 lines
1.3 KiB
Groff
Raw Permalink Normal View History

tools: add the libinput version to the man pages Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Eric Engestrom <eric.engestrom@imgtec.com>
2017-06-29 08:40:28 +10:00
.TH libinput-list-devices "1" "" "libinput @LIBINPUT_VERSION@" "libinput Manual"
tools: add a tool to list local devices and the default configurations xinput or an equivalent isn't available under wayland, but the majority of use-cases of "why doesn't my device work" or "why does feature X not work" should be covered by simply listing the local devices and their config options. Example output: Device: SynPS/2 Synaptics TouchPad Kernel: /dev/input/event4 Group: 9 Seat: seat0, default Size: 97.33x62.40mm Capabilities: pointer Tap-to-click: disabled Left-handed: disabled Nat.scrolling: disabled Calibration: n/a Scroll methods: *two-finger Click methods: *button-areas clickfinger Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Hans de Goede <hdegoede@redhat.com>
2015-04-15 11:44:54 +10:00
.SH NAME
libinput-list-devices: be more explicit about only listing defaults Signed-off-by: Konstantin Kharlamov <Hi-Angel@yandex.ru>
2019-10-26 23:10:59 +03:00
libinput\-list\-devices \- list local devices as recognized by libinput and
default values of their configuration
tools: add a tool to list local devices and the default configurations xinput or an equivalent isn't available under wayland, but the majority of use-cases of "why doesn't my device work" or "why does feature X not work" should be covered by simply listing the local devices and their config options. Example output: Device: SynPS/2 Synaptics TouchPad Kernel: /dev/input/event4 Group: 9 Seat: seat0, default Size: 97.33x62.40mm Capabilities: pointer Tap-to-click: disabled Left-handed: disabled Nat.scrolling: disabled Calibration: n/a Scroll methods: *two-finger Click methods: *button-areas clickfinger Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Hans de Goede <hdegoede@redhat.com>
2015-04-15 11:44:54 +10:00
.SH SYNOPSIS
tools: escape all dashes in man pages (for commands and options) Apparently the rule is that if a dash may end up being copy/pasted, it needs to be escaped. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2017-06-02 12:15:50 +10:00
.B libinput list\-devices [\-\-help]
tools: add a tool to list local devices and the default configurations xinput or an equivalent isn't available under wayland, but the majority of use-cases of "why doesn't my device work" or "why does feature X not work" should be covered by simply listing the local devices and their config options. Example output: Device: SynPS/2 Synaptics TouchPad Kernel: /dev/input/event4 Group: 9 Seat: seat0, default Size: 97.33x62.40mm Capabilities: pointer Tap-to-click: disabled Left-handed: disabled Nat.scrolling: disabled Calibration: n/a Scroll methods: *two-finger Click methods: *button-areas clickfinger Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Hans de Goede <hdegoede@redhat.com>
2015-04-15 11:44:54 +10:00
.SH DESCRIPTION
.PP
The
tools: escape all dashes in man pages (for commands and options) Apparently the rule is that if a dash may end up being copy/pasted, it needs to be escaped. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2017-06-02 12:15:50 +10:00
.B "libinput list\-devices"
tools: add a tool to list local devices and the default configurations xinput or an equivalent isn't available under wayland, but the majority of use-cases of "why doesn't my device work" or "why does feature X not work" should be covered by simply listing the local devices and their config options. Example output: Device: SynPS/2 Synaptics TouchPad Kernel: /dev/input/event4 Group: 9 Seat: seat0, default Size: 97.33x62.40mm Capabilities: pointer Tap-to-click: disabled Left-handed: disabled Nat.scrolling: disabled Calibration: n/a Scroll methods: *two-finger Click methods: *button-areas clickfinger Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Hans de Goede <hdegoede@redhat.com>
2015-04-15 11:44:54 +10:00
tool creates a libinput context on the default seat "seat0" and lists all
tools: fix typo in list-devices man page Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2017-04-20 10:43:01 +10:00
devices recognized by libinput. Each device shows available configurations
tools: add a tool to list local devices and the default configurations xinput or an equivalent isn't available under wayland, but the majority of use-cases of "why doesn't my device work" or "why does feature X not work" should be covered by simply listing the local devices and their config options. Example output: Device: SynPS/2 Synaptics TouchPad Kernel: /dev/input/event4 Group: 9 Seat: seat0, default Size: 97.33x62.40mm Capabilities: pointer Tap-to-click: disabled Left-handed: disabled Nat.scrolling: disabled Calibration: n/a Scroll methods: *two-finger Click methods: *button-areas clickfinger Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Hans de Goede <hdegoede@redhat.com>
2015-04-15 11:44:54 +10:00
the respective default configuration setting.
.PP
libinput-list-devices: make paragraph about different settings terser Changes are: 1. "configuration options" is same as "options" 2. The clarification "e.g. scrolling" doesn't clarify anything because a user don't necessarily knows there're "2-finger scroll" and "edge-scroll"; and even if they do, they can imagine the settings to be represented by "0" and "1" values, which then begs a question: why aren't all "Enabled/Disabled" settings are prefixed with "*" too. Instead, replace the vague `multiple different settings` with more specific `more settings than "enabled/disabled"`. 3. "ones" is shorter than "settings" and makes sure a user haven't lost context. Signed-off-by: Konstantin Kharlamov <Hi-Angel@yandex.ru>
2019-10-26 23:14:42 +03:00
For options that allow more settings than "enabled/disabled", all available ones
are listed. The default setting is prefixed by an asterisk (*).
tools: add a tool to list local devices and the default configurations xinput or an equivalent isn't available under wayland, but the majority of use-cases of "why doesn't my device work" or "why does feature X not work" should be covered by simply listing the local devices and their config options. Example output: Device: SynPS/2 Synaptics TouchPad Kernel: /dev/input/event4 Group: 9 Seat: seat0, default Size: 97.33x62.40mm Capabilities: pointer Tap-to-click: disabled Left-handed: disabled Nat.scrolling: disabled Calibration: n/a Scroll methods: *two-finger Click methods: *button-areas clickfinger Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Hans de Goede <hdegoede@redhat.com>
2015-04-15 11:44:54 +10:00
.PP
This tool usually needs to be run as root to have access to the
/dev/input/eventX nodes.
.SH OPTIONS
.TP 8
tools: escape all dashes in man pages (for commands and options) Apparently the rule is that if a dash may end up being copy/pasted, it needs to be escaped. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2017-06-02 12:15:50 +10:00
.B \-\-help
tools: add a tool to list local devices and the default configurations xinput or an equivalent isn't available under wayland, but the majority of use-cases of "why doesn't my device work" or "why does feature X not work" should be covered by simply listing the local devices and their config options. Example output: Device: SynPS/2 Synaptics TouchPad Kernel: /dev/input/event4 Group: 9 Seat: seat0, default Size: 97.33x62.40mm Capabilities: pointer Tap-to-click: disabled Left-handed: disabled Nat.scrolling: disabled Calibration: n/a Scroll methods: *two-finger Click methods: *button-areas clickfinger Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Hans de Goede <hdegoede@redhat.com>
2015-04-15 11:44:54 +10:00
Print help
.SH NOTES
.PP
Some specific feature may still be available on a device even when
no configuration is exposed, a lack of a configuration option does not
necessarily mean that this feature does not work.
.PP
A device may be recognized by libinput but not handled by the X.Org libinput
driver or the Wayland compositor.
.PP
An xorg.conf(5) configuration entry or Wayland compositor setting may have
changed configurations on a device. The
tools: escape all dashes in man pages (for commands and options) Apparently the rule is that if a dash may end up being copy/pasted, it needs to be escaped. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2017-06-02 12:15:50 +10:00
.B "libinput list\-devices"
tools: add a tool to list local devices and the default configurations xinput or an equivalent isn't available under wayland, but the majority of use-cases of "why doesn't my device work" or "why does feature X not work" should be covered by simply listing the local devices and their config options. Example output: Device: SynPS/2 Synaptics TouchPad Kernel: /dev/input/event4 Group: 9 Seat: seat0, default Size: 97.33x62.40mm Capabilities: pointer Tap-to-click: disabled Left-handed: disabled Nat.scrolling: disabled Calibration: n/a Scroll methods: *two-finger Click methods: *button-areas clickfinger Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> Reviewed-by: Hans de Goede <hdegoede@redhat.com>
2015-04-15 11:44:54 +10:00
tool only shows the device's default configuration, not the current
configuration.
tools: switch the libinput tool to be an exec-ing tool Chaining args together inside a single binary would be nice, but it gets nasty quickly (as I found out adding 3, 4 extra commands). Switch over to using a git-style exec-ing command where libinput merely changes argv[0] and then executes whatever it assembled. And those binaries can hide in libexec so they don't clutter up the global namespace. This also makes it a lot easier to write man pages, adopt the same style as git uses. Compatibilty wrapper scripts are provided for libinput-list-devices and libinput-debug events. These warn the user about the changed command, then exec the new one. Expect these wrappers to be removed at some point in the future. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2017-05-25 10:12:26 +10:00
.SH LIBINPUT
Part of the
.B libinput(1)
suite
Reference in a new issue Copy permalink