File U_man-add-a-warning-that-wheel-emu-inertia-must... of Package xf86-input-evdev

Overview Repositories Revisions Requests Users Attributes Meta

File U_man-add-a-warning-that-wheel-emu-inertia-must-be-set-and-it-isn-t-inertia.patch of Package xf86-input-evdev (Revision b267cf0dfbfb38741466977480bc26f7)

Currently displaying revision b267cf0dfbfb38741466977480bc26f7 , Show latest

From: Peter Hutterer <peter.hutterer@who-t.net>
Date: Thu Jan 14 11:18:56 2016 +1000
Subject: [PATCH]man: add a warning that wheel emu inertia must be set and it isn't inertia
Patch-mainline: Upstream
Git-repo: git://anongit.freedesktop.org/git/xorg/driver/xf86-input-evdev
Git-commit: ce7d8fdebc0123227be91ba5d89126a36f089ff5
References: FATE#320263
Signed-off-by: Egbert Eich <eich@suse.com>

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>
---
 man/evdev.man | 13 +++++++++++++
 1 file changed, 13 insertions(+)

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

Places

File U_man-add-a-warning-that-wheel-emu-inertia-must-be-set-and-it-isn-t-inertia.patch of Package xf86-input-evdev (Revision b267cf0dfbfb38741466977480bc26f7)

Places