[PATCH 2/2] some wording changes aimed at simplification
simon.thum at gmx.de
Thu Jan 7 04:03:05 PST 2010
also, the hockey function seemingly has been taken to mean something
Signed-off-by: Simon Thum <simon.thum at gmx.de>
hw/xfree86/doc/man/xorg.conf.man.pre | 21 +++++++++++----------
1 files changed, 11 insertions(+), 10 deletions(-)
diff --git a/hw/xfree86/doc/man/xorg.conf.man.pre b/hw/xfree86/doc/man/xorg.conf.man.pre
index a21bcf0..84d0d09 100644
@@ -922,9 +922,10 @@ these can be adjusted at runtime, see the xinput(1) man page for details. Only
the most important acceleration options are discussed here.
.BI "Option \*qAccelerationProfile\*q \*q" integer \*q
-Select the profile, which determines actual acceleration as a function of
-device velocity and acceleration controls (acceleration and threshold, dubbed
-pointer feedback). This is mainly a matter of personal preference.
+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.
@@ -932,7 +933,7 @@ pointer feedback). This is mainly a matter of personal preference.
.B "-1 none (only constant deceleration is applied)"
.B " 1 device-dependent"
.B " 2 polynomial (polynomial function)"
-.B " 3 smooth linear (hockey)"
+.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)"
@@ -948,7 +949,7 @@ times slower than normal. Most useful for high-resolution devices.
.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. Use this for very accurate hit-the-pixel work.
+times slower. Enables precise pointer placement without sacrificing speed.
.BI "Option \*qAccelerationScheme\*q \*q" string \*q
Selects the scheme, which is the underlying algorithm.
@@ -962,17 +963,17 @@ Selects the scheme, which is the underlying algorithm.
.BI "Option \*qAccelerationNumerator\*q \*q" integer \*q
-Set the numerator of the acceleration factor.
.BI "Option \*qAccelerationDenominator\*q \*q" integer \*q
-Set the denominator of the acceleration factor. The acceleration factor is a
-rational which, together with threshold, can be used to tweak profiles to suit
-the users needs. The
+Set numerator and denominator of the acceleration factor. The acceleration
+factor is a rational which, together with threshold, can be used to tweak
+profiles to suit the users needs. The
profiles use it directly (i.e. they accelerate by the factor), for other
-profiles it should hold that higher acceleration leads to more acceleration.
+profiles it should hold that a higher acceleration factor leads to a faster
+pointer. Typically, 1 is unaccelerated and values up to 5 are sensible.
.BI "Option \*qAccelerationThreshold\*q \*q" integer \*q
Set the threshold, which is roughly the velocity (usually device units per 10
More information about the xorg-devel