[PATCH 2/2] some wording changes aimed at simplification

Simon Thum simon.thum at gmx.de
Thu Jan 7 04:03:05 PST 2010


also, the hockey function seemingly has been taken to mean something
else.

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
--- a/hw/xfree86/doc/man/xorg.conf.man.pre
+++ b/hw/xfree86/doc/man/xorg.conf.man.pre
@@ -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.
 .TP 7
 .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.
 .PP
 .RS 6
 .nf
@@ -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.
 .TP 7
 .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.
 .RE
 .TP 7
 .BI "Option \*qAccelerationNumerator\*q  \*q" integer \*q
-Set the numerator of the acceleration factor.
 .TP 7
 .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
 .B simple
 and
 .B limited
 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.
 .TP 7
 .BI "Option \*qAccelerationThreshold\*q  \*q" integer \*q
 Set the threshold, which is roughly the velocity (usually device units per 10
-- 
1.6.4.4


--------------070901020200070007090600--


More information about the xorg-devel mailing list