diff options
authorSimon Thum <>2010-01-06 19:43:59 +0100
committerPeter Hutterer <>2010-01-11 15:26:46 +1000
commit0722c287a4c8a6cdedca9756192547bfcf77ade5 (patch)
parent1aca2d757534879eb55faaee421cb972a9546712 (diff)
xfree86: document pointer acceleration in
Signed-off-by: Simon Thum <> Reviewed-by: Peter Hutterer <> Reviewed-by: Fernando Carrijo <> Signed-off-by: Peter Hutterer <>
1 files changed, 45 insertions, 0 deletions
diff --git a/hw/xfree86/doc/man/ b/hw/xfree86/doc/man/
index 9420dfe84..be0c67654 100644
--- a/hw/xfree86/doc/man/
+++ b/hw/xfree86/doc/man/
@@ -915,6 +915,51 @@ may be reattached or set floating at runtime.
.TP 7
.BI "Option \*qSendDragEvents\*q \*q" boolean \*q
Send core events while dragging. Enabled by default.
+For pointing devices, the following options control how the pointer
+is accelerated or decelerated with respect to physical device motion. Most of
+these can be adjusted at runtime, see the xinput(1) man page for details. Only
+the most important acceleration options are discussed here.
+.TP 7
+.BI "Option \*qAccelerationProfile\*q \*q" integer \*q
+Select the profile. In layman's terms, the profile constitutes the "feeling" of
+the acceleration. More formally, it defines how the transfer function (actual
+acceleration as a function of current device velocity and acceleration controls)
+is constructed. This is mainly a matter of personal preference.
+.RS 6
+.B " 0 classic (mostly compatible)"
+.B "-1 none (only constant deceleration is applied)"
+.B " 1 device-dependent"
+.B " 2 polynomial (polynomial function)"
+.B " 3 smooth linear (soft knee, then linear)"
+.B " 4 simple (normal when slow, otherwise accelerated)"
+.B " 5 power (power function)"
+.B " 6 linear (more speed, more acceleration)"
+.B " 7 limited (like linear, but maxes out at threshold)"
+.TP 7
+.BI "Option \*qConstantDeceleration\*q \*q" real \*q
+Makes the pointer go
+.B deceleration
+times slower than normal. Most useful for high-resolution devices.
+.TP 7
+.BI "Option \*qAdaptiveDeceleration\*q \*q" real \*q
+Allows to actually decelerate the pointer when going slow. At most, it will be
+.B adaptive deceleration
+times slower. Enables precise pointer placement without sacrificing speed.
+.TP 7
+.BI "Option \*qAccelerationScheme\*q \*q" string \*q
+Selects the scheme, which is the underlying algorithm.
+.RS 7
+.B "predictable default algorithm (behaving more predictable)"
+.B "lightweight old acceleration code (as specified in the X protocol spec)"
+.B "none no acceleration or deceleration"
The config file may have multiple
.B InputClass