X Strike Force XFree86 SVN commit: r2069 - in trunk/debian: . local
Author: branden
Date: 2004-12-10 13:50:09 -0500 (Fri, 10 Dec 2004)
New Revision: 2069
Modified:
trunk/debian/CHANGESETS
trunk/debian/changelog
trunk/debian/local/FAQ.xhtml
Log:
Expand discussion of configuring the mouse for left-handed use in the FAQ.
Thanks to Marc-Aur?\195?\168le DARCHE for the information! (Closes: #281504)
Modified: trunk/debian/CHANGESETS
===================================================================
--- trunk/debian/CHANGESETS 2004-12-10 10:00:30 UTC (rev 2068)
+++ trunk/debian/CHANGESETS 2004-12-10 18:50:09 UTC (rev 2069)
@@ -42,4 +42,8 @@
(Closes: #279055)
2068
+Expand discussion of configuring the mouse for left-handed use in the FAQ.
+Thanks to Marc-Aurèle DARCHE for the information! (Closes: #281504)
+ 2069
+
vim:set ai et sts=4 sw=4 tw=80:
Modified: trunk/debian/changelog
===================================================================
--- trunk/debian/changelog 2004-12-10 10:00:30 UTC (rev 2068)
+++ trunk/debian/changelog 2004-12-10 18:50:09 UTC (rev 2069)
@@ -29,8 +29,11 @@
System?" FAQ entry based on feedback from Frank Murphy. Thanks, Frank!
(Closes: #279055)
- -- Branden Robinson <branden@debian.org> Fri, 10 Dec 2004 04:59:01 -0500
+ * Expand discussion of configuring the mouse for left-handed use in the FAQ.
+ Thanks to Marc-Aurèle DARCHE for the information! (Closes: #281504)
+ -- Branden Robinson <branden@debian.org> Fri, 10 Dec 2004 13:46:26 -0500
+
xfree86 (4.3.0.dfsg.1-9) unstable; urgency=high
* Security update release. Resolves CAN-2004-0914 (several Xpm library
Modified: trunk/debian/local/FAQ.xhtml
===================================================================
--- trunk/debian/local/FAQ.xhtml 2004-12-10 10:00:30 UTC (rev 2068)
+++ trunk/debian/local/FAQ.xhtml 2004-12-10 18:50:09 UTC (rev 2069)
@@ -1307,28 +1307,34 @@
<h3><a id="lefthandmouse">How do I set up the mouse buttons for left-handed
use?</a></h3>
-<p><em>Thanks to "ulisses" for suggesting this question for the FAQ, and
-providing some of the information given.</em></p>
+<p><em>Thanks to Osamu Aoki, Marc-Aurèle Darche and "ulisses" for
+providing much of the information in this entry.</em></p>
-<p>This depends on how many buttons your mouse has. If it has two or three, I
-have an answer. If it has more than three, and/or a wheel, I'd appreciate
-submissions from lefties with such mice who have gotten them reconfigured.</p>
+<p>For a quick fix in XFree86 3.<em>x</em>, you can use one of the following
+commands, depending on how many buttons your mouse has:</p>
-<p>For a quick fix, you can execute the following while in an X session:</p>
-
<table border="1">
<tr>
<td><kbd>xmodmap -e "pointer = 2 1"</kbd></td><td>(for two-button mice)</td>
</tr>
<tr>
- <td><kbd>xmodmap -e "pointer = 3 2 1"</kbd></td><td>(for three-button mice)</td>
+ <td><kbd>xmodmap -e "pointer = 3 2 1"</kbd></td><td>(for three-button
+ mice)</td>
</tr>
+ <tr>
+ <td><kbd>xmodmap -e "pointer = 3 2 1 4 5"</kbd></td><td>(for three-button
+ mice with a scroll wheel)</td>
+ </tr>
</table>
-<p>To have the pointer buttons remapped for all of your X sessions, add the
-following line to your <code class="filespec">$HOME/.Xmodmap</code> file
-(creating the file if necessary):</p>
+<p>Note that buttons 4 and 5 correspond to the "wheel up" and "wheel down"
+actions, and should not be modified for left-handed use.</p>
+<p>To remap the mouse buttons for all of your X sessions (under XFree86
+3.<em>x</em>, add the following line to your <code
+class="filespec">$HOME/.Xmodmap</code> file (creating the file if
+necessary):</p>
+
<table border="1">
<tr>
<td><samp>pointer = 2 1</samp></td><td>(for two-button mice)</td>
@@ -1336,9 +1342,13 @@
<tr>
<td><samp>pointer = 3 2 1</samp></td><td>(for three-button mice)</td>
</tr>
+ <tr>
+ <td><samp>pointer = 3 2 1 4 5</samp></td><td>(for three-button mice with a
+ scroll wheel)</td>
+ </tr>
</table>
-<p>and call <kbd>xmodmap $HOME/.Xmodmap</kbd> from your <code
+<p>...and call <kbd>xmodmap $HOME/.Xmodmap</kbd> from your <code
class="filespec"><var>$HOME</var>/.xsession</code> file. Note, however, that
the system administrator can configure the X Window System such that users'
<code class="filespec">.xsession</code> files in their <var>$HOME</var>
@@ -1348,16 +1358,61 @@
<p>For more information about <code class="command">xmodmap</code>, see <code
class="manpage">xmodmap(1x)</code>.</p>
-<p><em>The following information is courtesy of <a
-href="mailto:osamu@debian.org";>Osamu Aoki</a>.</em></p>
+<p>The above <code class="command">xmodmap</code>-based approach for setting up
+a left-handed mouse only works for the XFree86 3.<em>x</em> series. It results
+in bad behavior when used with the XFree86 4.<em>x</em> series and XOrg
+X11R6.7.0 and later. If you are using one of these more recent versions of the
+X Window System, use the <code class="command">gpm</code>-based approach,
+described below.</p>
-<p>There is a <code class="command">gpm</code>-based approach to solving this
-problem if the XFree86 X server is configured to use <code
-class="filespec">/dev/gpmdata</code> for a mouse device. The <kbd>-B</kbd>
-option to gpm should help. You can use it by adding it to the <code
-class="other">append</code> line in <code
-class="filespec">/etc/gpm.conf</code>.</p>
+<p>The <code class="command">gpm</code> approach is to feed X with the mouse data
+coming from <code class="command">gpm</code>, a cut-and-paste utility and mouse
+server for virtual consoles. The <code class="command">gpm</code> utility is of
+interest here because it can be configured to handle left-handed mouse devices.
+This approach has the drawback that all the users of the system have to share
+the same <code class="command">gpm</code> configuration, while with <code
+class="command">xmodmap</code> every user could have his or her own <code
+class="filespec">.Xmodmap</code> file.</p>
+<p>To use the <code class="command">gpm</code> approach, you must modify two
+files: your <code class="command">gpm</code> configuration and your X server
+configuration. The examples provided below are for a Logitech three-button
+mouse with a scroll wheel. One can easily adapt this configuration by changing
+<code class="other">device</code>, <code class="other">type</code> and <code
+class="other">Option "Protocol"</code> parameters according to the type of
+mouse device you are using.</p>
+
+<p><strong>Example: <code class="filespec">/etc/gpm.conf</code></strong></p>
+
+<pre>device=/dev/input/mice
+repeat_type=ms3
+type=imps2
+append='-B 321'</pre>
+
+<p><strong>Example: <code
+class="filespec">/etc/X11/XF86Config-4</code></strong></p>
+
+<pre>Section "InputDevice"
+ Identifier "GPM repeater"
+ Driver "mouse"
+ Option "CorePointer"
+ Option "Device" "/dev/gpmdata"
+ Option "Protocol" "IntelliMouse"
+ Option "ZAxisMapping" "4 5"
+EndSection</pre>
+
+<p>Note that in XFree86 4.3.0 (and therefore in X.Org X11R6.7.0 and later), the
+X server's mouse driver was rewritten in such a way that using any protocol
+other than <code class="other">IntelliMouse</code> on the XFree86 side and <code
+class="other">ms3</code> on the GPM side does not work well. If you are using
+anything other than <code class="other">ms3</code> as the repeating protocol
+(<code class="other">repeat_type</code>), you will likely want to change it to
+<code class="other">ms3</code>. If your <code
+class="filespec">XF86Config-4</code> file is automatically handled by <code
+class="other">debconf</code> and uses <code class="filespec">/dev/gpmdata</code>
+as the port for the configured mouse, the protocol will automatically be
+migrated to <code class="other">IntelliMouse</code> if necessary.</p>
+
<h3><a id="nostartxdm">How do I stop <code class="command">xdm</code> from
starting at boot?</a></h3>
@@ -3167,8 +3222,8 @@
<p>The author would like to thank Andreas Metzler, Guillem Jover, Ingo Saitz,
Osamu Aoki, Matthew Arnison, Colin Walters, Steve Swales, Adam Jackson, Thomas
Dickey, Paul Gotch, Albert Cahalan, Denis Barbier, Jeff Licquia, Fabio Massimo
-Di Nitto, Andrew Suffield, Frank Murphy, and "ulisses" for their contributions
-to this document.</p>
+Di Nitto, Andrew Suffield, Frank Murphy, Marc-Aurèle Darche, and "ulisses" for
+their contributions to this document.</p>
<hr />
<p class="x-small">$Id$</p>
Reply to: