diff options
author | Sascha Hlusiak <saschahlusiak@arcor.de> | 2012-10-03 17:39:55 +0200 |
---|---|---|
committer | Sascha Hlusiak <saschahlusiak@arcor.de> | 2012-10-03 17:45:00 +0200 |
commit | c473c8bd7985441d8264f8f48537d39dbe0c874e (patch) | |
tree | cc7a5683dcb4503f8988cb5af979b82c2fff9d81 | |
parent | 56ebbd899f709b3fae7e382ac3429a4c87867c63 (diff) |
man: mention use cases for when to use the module and when not to
-rw-r--r-- | man/joystick.man | 39 |
1 files changed, 30 insertions, 9 deletions
diff --git a/man/joystick.man b/man/joystick.man index 97479fc..3696319 100644 --- a/man/joystick.man +++ b/man/joystick.man @@ -9,7 +9,7 @@ Snipped for xorg.conf.d(5): .nf .B "Section \*qInputClass\*q" .BI " Identifier \*q" joystick-all \*q -.BI " Driver \*q" joystick \*q +.BI " Driver \*q" joystick \*q .BI " Option \*qMatchIsJoystick\*q \*q" on \*q .BI " Option \*qMatchDevicePath \*q" /dev/input/event* \*q \ \ ... @@ -20,11 +20,32 @@ Snipped for xorg.conf.d(5): .SH DESCRIPTION .B joystick is an __xservername__ input driver for controlling the pointer with a -joystick device. It is -.B not a joystick driver for games, -the -.B evdev +joystick device. +.TP 3 +Use this driver, if you want to +- generate +.IR "cursor movement" , +perform button or key events to control desktop and applications + +- generate +.I "cursor key events" +for playing legacy games, that have no native joystick support + +.TP 3 +.B Do not use, if you want to +- play games, that have native joystick support + +- use XI2 applications. The +.B evdev(4) driver will suffice for those in most cases. + +.PP +You may mix above scenarios by setting the device +.IR floating . +The driver reports relative cursor movement, button and key events, +as well as raw axis values through valuators. + +.SH SUPPORTED HARDWARE The joystick input module can be used on top of the following kernel devices: .nf @@ -33,10 +54,6 @@ The joystick input module can be used on top of the following kernel devices: .B - BSD's usbhid device .fi -The driver reports cursor movement -as well as raw axis values through valuators. - -.SH SUPPORTED HARDWARE Every joystick supported by the kernel should be supported by the .B joystick input driver. The joystick is assumed to be calibrated and reporting axis values @@ -44,6 +61,10 @@ between .IR "-32768 " and " 32768" . See the Linux kernel documentation for a complete list of supported devices. +There is no support for +.B force feedback +at the moment. + .SH CONFIGURATION DETAILS Please refer to __xconfigfile__(__filemansuffix__) for general configuration details. This section only covers configuration details specific to this |