Update information about mouse configuration, based on a patch from Peter Samuelson (for which thanks)

2 files changed, 59 insertions, 37 deletions

diff --git a/debian/changelog b/debian/changelog
index ed8cb3910..4b203db55 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,10 @@
+installation-guide (2007xxxx) UNRELEASED; urgency=low
+
+  * appendix/files: update information about mouse configuration, based on a
+    patch from Peter Samuelson (for which thanks). Closes: #406290.
+
+ -- Frans Pop <fjp@debian.org>  Mon, 22 Jan 2007 17:56:37 +0100
+
 installation-guide (20070122) unstable; urgency=low
 
   * Enable Catalan, Brazillian, Korean and Spanish again.
diff --git a/en/appendix/files.xml b/en/appendix/files.xml
index 8ee4b1e89..0f01b3d15 100644
--- a/en/appendix/files.xml
+++ b/en/appendix/files.xml
@@ -115,53 +115,68 @@ The most important device files are listed in the tables below.
 
 </para>
 
-  <sect2>
-<title>Setting Up Your Mouse</title>
-
+  <sect2 arch="not-s390" id="device-mouse">
+  <title>Setting Up Your Mouse</title>
 <para>
 
-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:
-
-<informalexample><screen>
-mouse =&gt; /dev/psaux  =&gt; gpm =&gt; /dev/gpmdata -&gt; /dev/mouse =&gt; X
-         /dev/ttyS0             (repeater)        (symlink)
-         /dev/ttyS1
-</screen></informalexample>
-
-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>.
+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
+<filename>/etc/X11/xorg.conf</filename>.
 
 </para><para>
 
-This approach to use gpm even in X has advantages when the mouse is
-unplugged inadvertently.  Simply restarting gpm with
-
-<informalexample><screen>
-# /etc/init.d/gpm restart
-</screen></informalexample>
-
-will re-connect the mouse in software without restarting X.
-
-</para><para>
+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<footnote>
 
-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
-<filename>/usr/share/doc/HOWTO/en-txt/mini/3-Button-Mouse.gz</filename>,
-<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>.
+<para>
+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.
+</para>
 
-</para><para arch="powerpc">
+</footnote>, which are quite rare except on very old computers. Summary
+of Linux kernel modules needed for different mouse types:
+ 
+<informaltable><tgroup cols="2"><thead>
+<row>
+  <entry>Module</entry>
+  <entry>Description</entry>
+</row>
+</thead><tbody>
+<row>
+  <entry>psmouse</entry>
+  <entry>PS/2 mice (should be autodetected)</entry>
+</row>
+<row>
+  <entry>usbhid</entry>
+  <entry>USB mice (should be autodetected)</entry>
+</row>
+<row>
+  <entry>sermouse</entry>
+  <entry>Most serial mice</entry>
+</row>
+<row>
+  <entry>logibm</entry>
+  <entry>Bus mouse connected to Logitech adapter card</entry>
+</row>
+<row>
+  <entry>inport</entry>
+  <entry>Bus mouse connected to ATI or Microsoft InPort card</entry>
+</row>
+</tbody></tgroup></informaltable>
 
-For PowerPC, in <filename>/etc/X11/XF86Config</filename> or
-<filename>/etc/X11/XF86Config-4</filename>, set the mouse device to
-<userinput>"/dev/input/mice"</userinput>.
+To load a mouse driver module, you can use the <command>modconf</command>
+command (from the package with the same name) and look in the category
+<userinput>kernel/drivers/input/mouse</userinput>.
 
 </para><para arch="powerpc">
+<!-- FJP 20070122: Unsure if this is still valid -->
 
 Modern kernels give you the capability to emulate a three-button mouse
 when your mouse only has one button. Just add the following lines to