[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#406290: installation-guide: [patch] update info about mouse configuration

Package: installation-guide
Version: 20060726
Tags: patch

Anders Lennartsson brought it to my attention that the information
about gpm in the installation guide is terribly out-of-date.  I think
the following is a lot more helpful.

Peter, with "gpm co-maintainer" hat

Index: manual/en/appendix/files.xml
--- manual/en/appendix/files.xml	(revisione 44084)
+++ manual/en/appendix/files.xml	(copia locale)
@@ -120,46 +120,63 @@
-The mouse can be used in both the Linux console (with gpm) and the X window
-environment. The two uses can be made compatible if the gpm repeater is used
-to allow the signal to flow to the X server as shown:
+The mouse can be used in both the Linux console (with gpm) and the X
+window environment. Normally, this is a simple matter of installing
+<filename>gpm</filename> and the X server itself.  Both should be
+configured to use <filename>/dev/input/mice</filename> as the mouse
+device.  The correct mouse protocol is named
+<userinput>exps2</userinput> in gpm, and
+<userinput>ExplorerPS/2</userinput> in X.  The respective configuration
+files are <filename>/etc/gpm.conf</filename> and
-mouse =&gt; /dev/psaux  =&gt; gpm =&gt; /dev/gpmdata -&gt; /dev/mouse =&gt; X
-         /dev/ttyS0             (repeater)        (symlink)
-         /dev/ttyS1
-Set the repeater protocol to be raw (in <filename>/etc/gpm.conf</filename>) while
-setting X to the original mouse protocol in <filename>/etc/X11/XF86Config</filename>
-or <filename>/etc/X11/XF86Config-4</filename>.
+Certain kernel modules must be loaded in order for your mouse to work.
+In most cases the correct modules are autodetected, but not always for
+old-style serial and bus mice, which are quite rare except on very old
+computers.  (Serial mice usually have a 9-hole D-shaped connector; bus
+mice have an 8-pin round connector, not to be confused with the 6-pin
+round connector of a PS/2 mouse or the 4-pin round connector of an ADB
+mouse.)  Summary of Linux kernel modules needed for different mouse
+<informaltable><tgroup cols="2"><thead>
+  <entry>Module</entry>
+  <entry>Description</entry>
-This approach to use gpm even in X has advantages when the mouse is
-unplugged inadvertently.  Simply restarting gpm with
+  <entry>sermouse</entry>
+  <entry>Most serial mice</entry>
-# /etc/init.d/gpm restart
+  <entry>logibm</entry>
+  <entry>Bus mouse connected to Logitech adapter card</entry>
-will re-connect the mouse in software without restarting X.
+  <entry>inport</entry>
+  <entry>Bus mouse connected to ATI or Microsoft InPort card</entry>
+  <entry>psmouse</entry>
+  <entry>PS/2 mice (should be autodetected)</entry>
-If gpm is disabled or not installed for some reason, make sure to set X to
-read directly from a mouse device such as /dev/psaux. For details, refer
-to the 3-Button Mouse mini-Howto at
-<userinput>man gpm</userinput>,
-<filename>/usr/share/doc/gpm/FAQ.gz</filename>, and
-<ulink url="&url-xorg;current/doc/html/mouse.html">README.mouse</ulink>.
+  <entry>usbhid</entry>
+  <entry>USB mice (should be autodetected)</entry>
-</para><para arch="powerpc">
-For PowerPC, in <filename>/etc/X11/XF86Config</filename> or
-<filename>/etc/X11/XF86Config-4</filename>, set the mouse device to
+To load a kernel module, run <userinput>modconf</userinput>, and look
+in the category <userinput>kernel/drivers/input/mouse</userinput>.
 </para><para arch="powerpc">

Attachment: signature.asc
Description: Digital signature

Reply to: