libinput/tools/libinput.1
Peter Hutterer 328bc99d3b tools: add "libinput measure touchpad-tap"
This is the first tool of many more to come to enable users to gather
information aobut their devices and/or usage of these devices. Previously,
these required the users to record events, submit them to a bugzilla, have me
run various scripts over it and then decree that the scripts have spoken.
Push some of this into the hands of the users so they can query the numbers
locally and start investigating (or at least get an idea of what's happening).

This tool measures the time deltas between touch up and touch down and prints
a basic summary, together with the ability to print a dat file with the data
for visualization by e.g. gnuplot. Eventually, more of the current analysis
scripts will be moved into this or other helpers.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2017-06-02 12:21:35 +10:00

62 lines
1.5 KiB
Groff

.TH LIBINPUT "1"
.SH NAME
libinput \- tool to interface with libinput
.SH SYNOPSIS
.B libinput [--help] [--version] <command> [<args>]
.SH DESCRIPTION
.PP
The
.B "libinput"
tool creates a libinput context on the default seat "seat0" and interacts
with that libinput context.
.PP
This tool usually needs to be run as root to have access to the
/dev/input/eventX nodes.
.PP
The context created by this tool is a new libinput context and independent
of that created by the X.Org libinput driver, the Wayland compositor or any
other process that utilizes libinput (henceforth called "the caller").
Configuration options set in this context do not affect any other libinput
contexts.
.PP
Note that a device may be recognized by this tool but not handled by the
X.Org libinput driver or the Wayland compositor.
.SH OPTIONS
.TP 8
.B --help
Print help and exit
.TP 8
.B --version
Print the version and exit
.SH COMMANDS
All commands support a
.B --help
argument that prints command-specific usage
information, e.g.
.B "libinput debug-events --help".
.TP 8
.B libinput-debug-events(1)
Print all events as seen by libinput.
.TP 8
.B libinput-debug-gui(1)
Show a GUI to visualize libinput's events.
.TP 8
.B libinput-list-devices(1)
List all devices recognized by libinput.
.TP 8
.B libinput-measure(1)
Measure various properties of devices.
.TP 8
.B libinput-measure-touchpad-tap(1)
Measure tap-to-click time.
.SH LIBINPUT
Part of the
.B libinput(1)
suite
.PP
.SH SEE ALSO
libinput(4)
.PP
libinput's online documentation
.I https://wayland.freedesktop.org/libinput/doc/latest/