summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPeter Hutterer <peter.hutterer@who-t.net>2016-01-14 11:18:56 +1000
committerPeter Hutterer <peter.hutterer@who-t.net>2016-01-14 11:53:56 +1000
commitce7d8fdebc0123227be91ba5d89126a36f089ff5 (patch)
tree5897c58e432455330de81042be778ed53223a87e
parent6a3beab6137b262fc847093ed5fa51ff70df6a21 (diff)
man: add a warning that wheel emu inertia must be set and it isn't inertia
First, it's not actually inertia, it's simply the scroll distance, yay for the misnomer. And it needs to be set for any device that is more fine-grained than a mouse, especially absolute devices. For example the VirtualBox device has an abs max of 32767, so a simple motion may have a delta of to 2000 units and that results in 200 scroll events. That's a bit excessive. Related to: https://bugs.freedesktop.org/show_bug.cgi?id=93617 Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
-rw-r--r--man/evdev.man13
1 files changed, 13 insertions, 0 deletions
diff --git a/man/evdev.man b/man/evdev.man
index e70ae1f..8d84364 100644
--- a/man/evdev.man
+++ b/man/evdev.man
@@ -125,6 +125,19 @@ Property: "Evdev Wheel Emulation Button".
Specifies how far (in pixels) the pointer must move to generate button
press/release events in wheel emulation mode. Default: 10. Property: "Evdev
Wheel Emulation Inertia".
+.IP
+This value must be set for any device does not resemble a standard mouse.
+Specifically, on absolute devices such as tablets the value should be set to
+a reasonable fraction of the expected movement to avoid excess scroll events.
+.IP
+.B WARNING:
+the name \*qinertia\*q is a misnomer. This option defines the distance
+required to generate one scroll event similar to the
+.B VertScrollDelta
+and
+.B HorizScrollDelta
+options. It does not enable inertia in the
+physical sense, scrolling stops immediately once the movement has stopped.
.TP 7
.BI "Option \*qEmulateWheelTimeout\*q \*q" integer \*q
Specifies the time in milliseconds the