[gpm] [PATCH 15/18] evdev-man-update.patch

[Dmitry Torokhov]

===================================================================


ChangeSet@1.19, 2004-08-10 00:53:53-05:00, dtor_core@ameritech.net
  Add evdev protocol documentation.


 doc.gpm.in |   38 ++++++++++++++++++++++++++++++++++++++
 1 files changed, 38 insertions(+)


===================================================================



diff -Nru a/doc/doc.gpm.in b/doc/doc.gpm.in
--- a/doc/doc.gpm.in	2004-08-10 01:18:01 -05:00
+++ b/doc/doc.gpm.in	2004-08-10 01:18:01 -05:00
@@ -810,6 +810,44 @@
 @item wp wizardpad
 	Genius WizardPad tablet
 
+@item evdev
+   A decoder for Linux event protocol, the preferred method for getting data
+   from input devices in Linux kernels starting with v.2.6. Evdev decoder
+   supports the following modes of operation: relative, absolute, touchpad,
+   synaptics. @t{relative} suits for devices reporting relative motion packets,
+   like regular PS/2 mouses. The decoder expects to receive REL_X, REL_Y,
+   REL_WHEEL, REL_HWHEEL and various BTN_* events from the kernel.
+   @t{absolute} suits for touchscreens and tablets reporting absolute coordinates.
+   The decoder expects ABS_X, ABS_Y and various BTN_* events from the kernel.
+   @t{touchpad} is a device reporting absolute coodrinates, but cursor should not move
+   if there is no touch. Also if you take your finger off and then touch the pad
+   in some other place cursor should not jump across the screen as in the case with
+   touchscreen or tablet. Supports tapping, distinguishes corner and normal taps.
+   Normal taps generate left button events, right-top corner tap generates middle
+   button event, right-bottom corner tap generates right button event. The decoder
+   expects ABS_X, ABS_Y, various BTN_* and ABS_PRESSURE events from the kernel.
+   @t{synaptics} - same as touchpad but recognizes multi-finger tapping. Two-finger
+   taps generate middle button events, three-finger taps generate right button events.
+   The decoder expects ABS_X, ABS_Y, various BTN_*, ABS_TOOL_* and ABS_PRESSURE
+   events from the kernel.
+   By default evdev protocol driver queries device and its capabilities and
+   automatically selects proper mode of operation and sets proper dimensions.
+
+	Options (via -o text):@*
+	@t{type=xxx} - relative, absolute, touchpad, synaptics, auto.@*
+	@t{left=lll, right=rrr, top=ttt, bottom=bbb} - allow to specify size of an
+   absolute device or define edges for touchpads and synaptics (to distinguish
+   corner taps). Not valid for relative devices, automatically retrieved for
+   absolute devices. Default values 1900, 5400, 1800 and 3900.@*
+   @t{touch_high=hhh, touch_low=lll} - minimum pressure to start (touch_high)
+   and continue (touch_low) tracking finger motion on the touch pad.
+   Not valid for relative or absolute devices. Default valies are 30 and 25.@*
+   @t{tap_time=ttt, tap_move=mmm} - maximum time and movement between finger
+   starting touching the pad and leaving it for a touch to be considered a tap.
+   Not valid for relative or absolute devices. Default valies are 180 and 220.@*
+   @t{y_inverted} - allows to adjust to devices whose Y axis is inverted.
+   Turned on by default for synaptics, off for everything else.@*
+
 @end table
 
 @ignore