Start moving out the docs to an appropriate directory.

We will provide the current documents in the docs directory. The interesting
stuff should be merged into the manpages though.

2 files changed, 461 insertions, 0 deletions

diff --git a/docs/COMPATIBILITY b/docs/COMPATIBILITY
new file mode 100644
index 0000000..c71fc34
--- /dev/null
+++ b/docs/COMPATIBILITY
@@ -0,0 +1,309 @@
+Acer 661 LCi
+Acer Aspire 1353LC
+Acer Aspire 1353XC
+Acer Aspire 1511 LMi
+Acer Aspire 1601LC
+Acer Aspire 1703SM
+Acer Aspire 2000		(Requires 2.6 kernel but *NOT* the ALPS patch)
+Acer Aspire 2010
+Acer Aspire 2020
+Acer Aspire 3003WLMi
+Acer Aspire 3023
+Acer Aspire 5670
+Acer Aspire 5672
+Acer Aspire 9301AWSMi
+Acer Extensa 3001 WLMi
+Acer Ferrari 3000LMi
+Acer Ferrari 3200
+Acer TravelMate 210TEV
+Acer TravelMate 220
+Acer TravelMate 2310
+Acer TravelMate 234LC
+Acer TravelMate 244LM
+Acer TravelMate 2501LC
+Acer TravelMate 280
+Acer TravelMate 290		(ALPS touchpad)
+Acer TravelMate 330T
+Acer TravelMate 340T
+Acer TravelMate 350TE
+Acer TravelMate 420DLC
+Acer TravelMate 451Cli
+Acer TravelMate 4672 WLMi
+Acer TravelMate 521TE
+Acer TravelMate 522TXV
+Acer TravelMate 525TE
+Acer TravelMate 533LCi
+Acer TravelMate 630
+Acer TravelMate 634LCi
+Acer TravelMate 739TL
+Acer TravelMate 800LCI
+Acer TravelMate 8104 WLMi
+Airis Diamond 630
+Airis Pragma 750
+Aopen Openbook 1545/1545D
+Apple iBook G4
+Arima A520-K7
+Aristo Smart 300
+ASUS A1000
+ASUS A2500
+ASUS A3500L
+ASUS A6000G
+ASUS A6Km-Q010H
+ASUS A6VA
+ASUS A7F
+ASUS B1500
+ASUS Degatto D1
+ASUS L2000B
+ASUS L2400D
+ASUS L3500D
+ASUS L3500H
+ASUS L3800C
+ASUS L8400 series
+ASUS M2400A
+ASUS M2400E
+ASUS M2400N
+ASUS M3000N
+ASUS M5N
+ASUS M6700N
+ASUS S1300
+ASUS S5200N
+ASUS Z62J
+ASUS Z71V
+BenQ JoyBook 2100E
+Clevo 5600P
+Clevo M375C
+Clevo M385C
+Compal CL56-15
+COMPAQ Armada 1750		(Requires reset hack)
+COMPAQ Armada M300
+COMPAQ Armada M700
+COMPAQ EVO N1015v
+COMPAQ EVO N1020v
+COMPAQ EVO N160
+COMPAQ EVO N180
+COMPAQ EVO N600c
+COMPAQ EVO N800v
+COMPAQ Presario 1200
+COMPAQ Presario 1213EA
+COMPAQ Presario 12XL125
+COMPAQ Presario 1510US
+COMPAQ Presario 1685
+COMPAQ Presario 1710T
+COMPAQ Presario 1723EA
+COMPAQ Presario 1800
+COMPAQ Presario 1800XL584
+COMPAQ Presario 18XL580
+COMPAQ Presario 2100Z
+COMPAQ Presario 2100US
+COMPAQ Presario 2155US
+COMPAQ Presario 2500
+COMPAQ Presario 2510EA
+COMPAQ Presario 2825EA
+COMPAQ Presario 700 (US/EA)
+COMPAQ Presario 711EA
+COMPAQ Presario 912RSH
+COMPAQ Presario 915US
+COMPAQ Presario R3000		(ALPS touchpad)
+Compaq Presario V5204NR
+DELL Inspiron 1100
+DELL Inspiron 2100
+DELL Inspiron 2200
+DELL Inspiron 2500
+DELL Inspiron 2600
+DELL Inspiron 2650
+DELL Inspiron 300m
+DELL Inspiron 3500
+DELL Inspiron 4000
+DELL Inspiron 4100 (but maybe not every model has a Synaptics touchpad, US models
+		    seem to have it, the German models don't)
+DELL Inspiron 4150
+DELL Inspiron 5000
+DELL Inspiron 500m		(ALPS touchpad)
+DELL Inspiron 5100
+DELL Inspiron 5150
+DELL Inspiron 6000		(ALPS touchpad)
+DELL Inspiron 7000
+DELL Inspiron 7500
+DELL Inspiron 8000
+DELL Inspiron 8100
+DELL Inspiron 8200		(ALPS touchpad)
+DELL Inspiron 8500		(ALPS touchpad)
+DELL Inspiron 8600		(ALPS touchpad)
+DELL Latitude C400
+DELL Latitude C600
+DELL Latitude C610
+DELL Latitude C640
+DELL Latitude C800
+DELL Latitude CSx
+DELL Latitude CPi
+DELL Latitude CPx		(ALPS touchpad)
+DELL Latitude D505		(ALPS touchpad)
+DELL Latitude D600		(ALPS touchpad)
+DELL Latitude D610		(ALPS touchpad)
+DELL Latitude D800		(ALPS touchpad)
+DELL Latitude L400
+DELL Latitude LS400
+DELL Latitude X1
+DELL Latitude X300
+Desknote A900
+Desknote A928
+ECS A-530 Transmeta 5600
+ECS Desknote i-Buddie A900
+EMachines M5305
+Fujitsu-Siemens AMILO A1667G
+Fujitsu-Siemens AMILO A 7600	(ALPS touchpad)
+Fujitsu-Siemens AMILO D P4 (FH2)
+Fujitsu-Siemens AMILO D 6800
+Fujitsu-Siemens AMILO D 7830
+Fujitsu-Siemens AMILO L 6810
+Fujitsu-Siemens AMILO L 7300	(ALPS touchpad)
+Fujitsu-Siemens Amilo M 1420
+Fujitsu-Siemens Amilo M 1425
+Fujitsu-Siemens AMILO M 6100
+Fujitsu-Siemens AMILO M 6300
+Fujitsu-Siemens AMILO M-6800
+Fujitsu-Siemens AMILO M-7400
+Fujitsu-Siemens AMILO M-7800
+Fujitsu-Siemens AMILO M-8800
+Fujitsu-Siemens AMILO Pro V2020
+Fujitsu-Siemens AMILO Si1520
+Fujitsu-Siemens LIFEBOOK C-1010 and C-1020
+Fujitsu-Siemens LIFEBOOK E7010	(ALPS touchpad)
+Fujitsu-Siemens LIFEBOOK P7010D
+Fujitsu-Siemens LIFEBOOK P7120D
+Fujitsu-Siemens LIFEBOOK S-2020	(ALPS touchpad)
+Fujitsu-Siemens LIFEBOOK S-4572	(ALPS touchpad)
+Gateway 200X
+Gateway 450XL
+Gateway 600S
+Gateway 7405GX
+Gateway MX 3228
+Gateway Solo 9300
+Gericom A2
+Gericom Cinema XXL
+Gericom Hummer 2430
+Gericom M6T
+Gericom Masterpiece 2030 (works partly)
+Gericom Webboy
+Gericom Webgine
+Gericom X5
+Gericom X5 Force
+HP Compaq NC6000
+HP Compaq nw8240
+HP Compaq NX6110
+HP Compaq NX6120
+HP Compaq NX7000
+HP Compaq NX7010
+HP Compaq NX9000
+HP Compaq NX9010
+HP N6395
+HP NW8000
+HP Omnibook 4150
+HP Omnibook 6000
+HP Omnibook 6100
+HP Omnibook XE3 500
+HP Omnibook XE3 GC (F2397)
+HP Omnibook XE3 GF
+HP Omnibook XE3L (F3446J)
+HP Omnibook XE4400
+HP Omnibook XT1000 (F3433)
+HP Pavilion DV1475EA
+HP Pavilion N3250
+HP Pavilion N3350
+HP Pavilion ZD7000
+HP Pavilion ZD8000
+HP Pavilion ZE4101
+HP Pavilion ZE4125
+HP Pavilion ZE4420us
+HP Pavilion ZE4521ea
+HP Pavilion ZE4610us
+HP Pavilion ZE5400
+HP Pavilion ZT3000
+HP Pavilion ZV5000		(ALPS touchpad)
+HP Special Edition L2000
+IBM ThinkPad R40
+IBM ThinkPad R50
+IBM ThinkPad T30
+IBM ThinkPad T40
+IBM ThinkPad T40p
+IBM ThinkPad T41
+IBM ThinkPad T42
+INote 88EPS
+IPC Powernote S
+Jewel Saffier 1500
+Lenovo 3000 C100
+LG LM50
+Los Alamos LUP4SA2
+MAXDATA Pro 5000X
+MAXDATA Pro 8000X
+MBO N.B.V.O. 1800+ (aka Mitac MiNote 8375)
+Medion 41700
+Medion MD40100
+Medion MD5400
+Medion MD9467 aka ASUS 8400K
+Medion MD9580-F - Aldi (Nord)
+Medion MD9626
+Mitac 6120N
+NEC Versa E400
+NEC Versa M400
+Packard Bell Easy Note E3259SE
+Panasonic CF-R1
+Panasonic CF-R3
+Panasonic Toughbook W2
+PowerPro C 3:16
+Prestigio Nobile 156
+RoverBook F219
+Samsung GT8800DXV
+Samsung P30
+Samsung Q10
+Samsung Q20
+Samsung V20
+Samsung X20
+Sharp Actius MM10
+Sharp Actius UM32W
+Sharp Muramasa PC-MV1-5CA
+Sharp PC-FS2518
+Siemens Nixdorf Scenic Mobile 710
+SONY VAIO FX405			(ALPS touchpad)
+SONY VAIO GR7/K
+SONY VAIO GRX570
+SONY VAIO PCG-FX701		(ALPS touchpad)
+SONY VAIO PCG-GRX650
+SONY VAIO PCG-NV105		(ALPS touchpad)
+SONY VAIO PCG-TR1A		(ALPS touchpad)
+SONY VAIO VGN-A115S		(ALPS touchpad)
+Sony VAIO VGN-S4XP		(ALPS touchpad)
+SONY VAIO VGN-SZ72B		(ALPS touchpad)
+SONY VAIO VGN-UX50		(ALPS dualpoint touchpad)
+SONY VAIO Z1			(ALPS touchpad)
+SONY VAIO Z505SX		(ALPS touchpad)
+Sotec 3120X
+Targa Visionary Pro
+Targa Visionary XP-210
+Toshiba 1105			(ALPS touchpad)
+Toshiba 1410-303		(ALPS touchpad)
+Toshiba A20			(ALPS touchpad)
+Toshiba A25			(ALPS touchpad)
+Toshiba EX1/524CDET		(ALPS touchpad)
+Toshiba Portege 2000		(ALPS touchpad)
+Toshiba Portege 3500		(ALPS touchpad)
+Toshiba Portege A100
+Toshiba Portege R200		(ALPS touchpad)
+Toshiba Qosmio E-15		(ALPS touchpad)
+Toshiba Satellite 1130-Z23	(ALPS touchpad)
+Toshiba Satellite 1400-103	(ALPS touchpad)
+Toshiba Satellite 1800
+Toshiba Satellite 2410		(ALPS touchpad)
+Toshiba Satellite A10		(ALPS touchpad)
+Toshiba Satellite A40		(ALPS touchpad)
+Toshiba Satellite A50-543	(ALPS touchpad)
+Toshiba Satellite A75-S209	(ALPS touchpad)
+Toshiba Satellite M30
+Toshiba Satellite P25-607
+Toshiba Satellite Pro 2100	(ALPS touchpad)
+Toshiba Satellite S3000-514	(ALPS touchpad)
+Toshiba Tecra A3		(ALPS touchpad)
+Toshiba Tecra A4
+Toshiba Tecra A8
+Toshiba Tecra M2		(ALPS touchpad)
+Vobis Highscreen XI 14-C1200	(Same as Yakumo Q5M 1.2GHz)
diff --git a/docs/trouble-shooting.txt b/docs/trouble-shooting.txt
new file mode 100644
index 0000000..3d2e012
--- /dev/null
+++ b/docs/trouble-shooting.txt
@@ -0,0 +1,152 @@
+Trouble-shooting guide
+----------------------
+
+Contents
+--------
+
+1. Check that the touchpad is correctly detected by the kernel
+2. Check that an external PS/2 mouse isn't causing problems
+3. Check if some other program is using the /dev/psaux device
+4. Check that the evdev kernel driver is available
+5. Check that the synaptics driver is properly loaded by the X server
+6. Check that the touchpad is enabled in the BIOS/hardware
+
+
+1. Check that the touchpad is correctly detected by the kernel
+--------------------------------------------------------------
+
+If you are using a 2.6 linux kernel, check the /proc/bus/input/devices
+file. The touchpad must be identified a "SynPS/2 Synaptics TouchPad"
+or an "AlpsPS/2 ALPS TouchPad". If it is identified as a "PS/2 Generic
+Mouse" or "PS/2 Synaptics TouchPad", something is wrong.
+
+Possible fixes:
+
+1. Check your BIOS settings. Some BIOSes can do USB -> PS/2 mouse
+   emulation which can interfere with the touchpad. There may be a way
+   to disable the legacy mouse emulation from the BIOS setup program.
+
+2. Arrange so that the kernel initializes the USB subsystem before the
+   PS/2 touchpad. Initializing the USB mouse sometimes disables the
+   BIOS emulation. Compiling psmouse as a module and loading it in
+   /etc/rc.d/rc.local usually assures the USB is initialized first.
+
+3. Disconnect the USB mouse and restart the computer. (Not really a fix,
+   but can help when trying to figure out what's wrong.)
+
+4. Make sure your boot loader doesn't pass any parameter to the kernel
+   that disables mouse extensions. ("psmouse_proto=bare" for example).
+   Alternatively, if psmouse is compiled as a module, make sure that
+   modprobe doesn't pass such parameters. Check /etc/modprobe.conf and
+   "rmmod psmouse; modprobe -v psmouse".
+
+If you run a 2.4 kernel or an non-linux kernel, the
+/proc/bus/input/devices file is not available, but the BIOS setting
+could be relevant anyway.
+
+
+2. Check that an external PS/2 mouse isn't causing problems
+-----------------------------------------------------------
+
+If you want to use an external PS/2 mouse at the same time as the
+synaptics touchpad driver, you must use a 2.6 linux kernel and your
+hardware (keyboard controller) must support active multiplexing. You
+should see something like this when the computer boots:
+
+       mice: PS/2 mouse device common for all mice
+       i8042.c: Detected active multiplexing controller, rev 1.1.
+       serio: i8042 AUX0 port at 0x60,0x64 irq 12
+       serio: i8042 AUX1 port at 0x60,0x64 irq 12
+       serio: i8042 AUX2 port at 0x60,0x64 irq 12
+       serio: i8042 AUX3 port at 0x60,0x64 irq 12
+
+If you don't use a 2.6 kernel or your hardware doesn't support active
+multiplexing, you can't use an external PS/2 mouse together with the
+touchpad driver.
+
+
+3. Check if some other program is using the /dev/psaux device
+-------------------------------------------------------------
+
+If you use a 2.4 linux kernel, only one program at a time can reliably
+read from /dev/psaux. This means that if you for example have GPM
+running, it will probably prevent the synaptics driver from working
+correctly. It also means that if you have a second InputDevice in your
+X configuration file, it must not read from /dev/psaux. You probably
+want it to read from /dev/input/mice instead, which will handle USB
+mice in both 2.4 and 2.6 linux kernels, and both USB and external PS/2
+mice if you use a 2.6 kernel.
+
+The 2.6 linux kernel fixes the /dev/psaux shortcoming, so that you can
+safely run GPM and the synaptics driver at the same time.
+
+
+4. Check that the evdev kernel driver is available
+--------------------------------------------------
+
+If you are using a 2.6 linux kernel, the evdev kernel driver is needed
+for the X driver to be able to communicate with the kernel driver.
+Check the /proc/bus/input/devices file. The Handlers= line should
+contain an event device name, like this:
+
+	H: Handlers=mouse0 event0
+
+If there is no event handler, you either have to load the evdev kernel
+module or recompile the kernel and build it into the kernel. If you
+don't want to recompile the kernel, adding "/sbin/modprobe evdev" to
+/etc/rc.d/rc.sysinit usually works.
+
+
+5. Check that the synaptics driver is properly loaded by the X server
+---------------------------------------------------------------------
+
+The X log file is usually called /var/log/XFree86.0.log or
+/var/log/Xorg.0.log. It should contain something like this:
+
+	(II) LoadModule: "synaptics"
+	(II) Loading /usr/X11R6/lib/modules/input/synaptics_drv.o
+	(II) Module synaptics: vendor="X.Org Foundation"
+	        compiled for 4.3.99.902, module version = 1.0.0
+	        Module class: X.Org XInput Driver
+	        ABI class: X.Org XInput driver, version 0.4
+
+If the LoadModule line is missing, you probably forgot to add
+
+	Load "synaptics"
+
+to the "Module" section in the X config file, or you modified the
+wrong config file. Some systems that have been upgraded from XFree86
+to Xorg or from XFree86 3.x to XFree86 4.x can have multiple config
+files in the /etc/X11/ directory, but only one is used.
+
+Next, check that the log file also contains a line like this:
+
+	(II) Synaptics touchpad driver version 0.13.4
+
+If there is no such line, there is probably a binary compatibility
+problem between the synaptics driver and the X server.
+
+Possible fixes:
+
+1. Try upgrading to the latest synaptics driver.
+
+2. Try installing the X SDK package if it is available for your
+   version of X. (In Fedora Core 2, that package is called
+   xorg-x11-sdk-6.7.0-2.i386.rpm.) Then re-compile the synaptics
+   driver and try again.
+
+3. Make sure the driver is compiled with the same compiler version as
+   the X server.
+
+
+6. Check that the touchpad is enabled in the BIOS/hardware
+----------------------------------------------------------
+
+On some computers, it is possible to disable the touchpad either with
+a special key combination, from the BIOS, or with a special touchpad
+on/off button. On some machines, cycling the power doesn't
+automatically reenable the touchpad.
+
+If the touchpad appears to be dead, try to enable it from the BIOS or
+using a key combination. One user also reported that he had to remove
+the computer battery to make his touchpad operational again.