diff options
author | Gaetan Nadon <memsize@videotron.ca> | 2010-05-13 15:59:24 -0400 |
---|---|---|
committer | Gaetan Nadon <memsize@videotron.ca> | 2010-05-16 16:27:42 -0400 |
commit | 9a9344e66d2e03ee44bf6fe6a1c1d97082a74c20 (patch) | |
tree | 0f620385ed63fe083de2b7b9f3774040beb709a7 | |
parent | 9711c050e6d2a7c7c89ddc26775d819b5bc41ad3 (diff) |
README: keep the text version of README, discard the sgml version
The linuxdoc doc tool is deprecated.
README files are exclusively text files.
The file had not been updated for 5 years.
Reviewed-by: RĂ©mi Cardona <remi@gentoo.org>
Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
-rw-r--r-- | Makefile.am | 7 | ||||
-rw-r--r-- | README.sgml | 1122 | ||||
-rw-r--r-- | configure.ac | 1 |
3 files changed, 0 insertions, 1130 deletions
diff --git a/Makefile.am b/Makefile.am index 381a0f4..f73a7ce 100644 --- a/Makefile.am +++ b/Makefile.am @@ -21,13 +21,6 @@ SUBDIRS = src man MAINTAINERCLEANFILES = ChangeLog INSTALL -if BUILD_LINUXDOC -README: README.sgml - $(MAKE_TEXT) README.sgml && mv README.txt README -endif - -EXTRA_DIST = README.sgml - .PHONY: ChangeLog INSTALL INSTALL: diff --git a/README.sgml b/README.sgml deleted file mode 100644 index 6dbe8f7..0000000 --- a/README.sgml +++ /dev/null @@ -1,1122 +0,0 @@ -<!DOCTYPE linuxdoc PUBLIC "-//Xorg//DTD linuxdoc//EN" [ -<!ENTITY % defs SYSTEM "X11/defs.ent"> %defs; -]> - -<article> -<title>Mouse Support in X11R&relvers; -<author>Kazutaka Yokota -<date>17 December 2002 - -<toc> - -<sect>Introduction <p> - -This document describes mouse support in X.Org Foundation's X11R&relvers; server. - -Mouse configuration has often been mysterious task for -novice users. -However, once you learn several basics, it is straightforward -to write the mouse <tt>"InputDevice"</tt> -section in the <tt>xorg.conf</tt> file by hand. - -<sect>Supported Hardware <p> - -The X.Org Foundation X server supports four classes of mice: -serial, bus and PS/2 mice, and additional mouse types supported by -specific operating systems, such as USB mice. - -<descrip> -<tag>Serial mouse</tag> -The serial mouse has been the most popular pointing device for -PCs. -There have been numerous serial mouse models from a number of -manufactures. -Despite the wide range of variations, there have been relatively -few protocols (data format) with which the serial mouse talks -to the host computer. - -The modern serial mouse conforms to the PnP COM device specification -so that the host computer can automatically detect the mouse -and load an appropriate driver. -The X server supports this specification and can detect -popular PnP serial mouse models on most platforms. - -<tag>Bus mouse</tag> -The bus mouse connects to a dedicated interface card in an expansion -slot. -Some video cards, notably those from ATI, and integrated I/O -cards may also have a bus mouse connector. -Some bus mice are known as `InPort mouse'. - -Note that some mouse manufactures have sold a package including a serial mouse -and a serial interface card. -Don't confuse this type of products with the genuine bus mouse. - -<tag>PS/2 mouse</tag> -They are sometimes called `Mouse-port mouse'. -The PS/2 mouse is becoming increasingly common and popular. - -The PS/2 mouse is an intelligent device and may have more than -three buttons and a wheel or a roller. -The PS/2 mouse is usually compatible with the original PS/2 mouse from IBM -immediately after power up. -The PS/2 mouse with additional features requires a specialized -initialization procedure to enable these features. -Without proper initialization, it behaves as though it were an ordinary -two or three button mouse. - -<tag>USB mouse </tag> -USB (Universal Serial Bus) ports are present on most modern -computers. Several devices can be plugged into this bus, including -mice and keyboards. - -The server includes support for USB mice on some systems. -</descrip> - -Many mice nowadays can be used both as a serial mouse and as a PS/2 mouse. -They has a logic to distinguish which interface it is connected to. -However, the mouse which is not marketed as compatible with both -serial and PS/2 mouse interface lacks this logic and cannot be -used in such a way, even if you can find an appropriate -adapter with which you can connect the PS/2 mouse to a serial port -or visa versa. - -X11R&relvers; supports the mouse with a wheel, a roller or a knob. -Its action is detected as the Z (third) axis motion of the mouse. -As the X server or clients normally do not use the Z axis movement of the -pointing device, a configuration option, <tt>"ZAxisMapping"</tt>, -is provided to assign the Z axis movement to another axis or a pair -of buttons (see below). - -<sect>OS Support for Mice <p> - -<sect1>Summary of Supported Mouse Protocol Types <p> -<verb> - Protocol Types - serial PnP BusMouse PS/2 Extended PS/2 -OS platforms protocols serial protocol protocol protocols - "Auto" "BusMouse" "PS/2" "xxxPS/2" USB -------------------------------------------------------------------------- -BSD/OS Ok ? ? ? ? ? -FreeBSD Ok Ok Ok Ok SP*1 SP*1 -FreeBSD(98) Ok ? Ok NA NA ? -Interactive Unix Ok NA ?*1 ?*1 NA ? -Linux Ok Ok Ok Ok Ok ? -Linux/98 Ok ? Ok NA NA ? -LynxOS Ok NA Ok Ok NA ? -NetBSD Ok Ok Ok SP*1 SP*1 SP*1 -NetBSD/pc98 Ok ? Ok NA NA NA -OpenBSD Ok Ok Ok Ok*1 Ok*1 Ok*1 -OS/2 SP*2 SP*2 SP*2 SP*2 SP*2 ? -SCO Ok ? SP*1 SP*1 NA ? -Solaris 2.x Ok NA*1 ?*1 Ok Ok SP*1 -SVR4 Ok NA*1 SP*1 SP*1 NA ? -PANIX Ok ? SP*1 SP*1 NA ? - -Ok: support is available, NA: not available, ?: untested or unknown. -SP: support is available in a different form - -*1 Refer to the following sections for details. -*2 X11R&relvers;/OS2 will support any type of mouse that the OS supports, - whether it is serial, bus mouse, or PnP type. - -</verb> - -<sect1>BSD/OS <p> -No testing has been done with BSD/OS. - -<sect1>FreeBSD <p> -FreeBSD supports the <tt>"SysMouse"</tt> protocol which must be -specified when the <tt>moused</tt> daemon is running in versions 2.2.1 -or later. - -When running the <tt>moused</tt>daemon, you must always specify the -<tt>/dev/sysmouse</tt> device and the <tt>"SysMouse"</tt> protocol -to the X server, regardless of the actual type of your mouse. - -FreeBSD versions 2.2.6 or later include the kernel-level -support for extended PS/2 mouse protocols and there is no need to specify -the exact protocol name to the X server. -Instead specify the <tt>"PS/2"</tt> or <tt>"Auto"</tt> protocol and -the X server will automatically make use of the kernel-level support. - -In fact, <tt>"Auto"</tt> protocol support is really efficient in these -versions. -You may always specify <tt>"Auto"</tt> to any mouse, serial, -bus or PS/2, unless the mouse is an old serial model which doesn't -support PnP. - -FreeBSD versions 2.2.5 or earlier do not support extended PS/2 -mouse protocols (<tt>"xxxPS/2"</tt>). -Always specify the <tt>"PS/2"</tt> protocol for any PS/2 mouse -in these versions regardless of the brand of the mouse. - -FreeBSD versions 3.1 or later have support for USB mice. -Specify the <tt>"Auto"</tt> protocol for the <tt>/dev/ums0</tt> device. -(If the <tt>moused</tt> daemon is running for the USB mouse, -you must use <tt>/dev/sysmouse</tt> instead of <tt>/dev/ums0</tt> -as explained above.) See the <em>ums(4)</em> manual page for details. - -<sect1>FreeBSD(98) <p> -The PS/2 mouse is not supported. - -<sect1>Interactive Unix <p> -The PnP serial mouse support (the <tt>"Auto"</tt> protocol) is not -supported for the moment. - -The bus mouse and PS/2 mouse should be supported by using the -appropriate device drivers. -Use <tt>/dev/mouse</tt> for the <tt>"BusMouse"</tt> protocol -and <tt>/dev/kdmouse</tt> for the <tt>"PS/2"</tt> protocol. -These protocols are untested but may work. -Please send success/failure reports to -<url url="mailto:michael.rohleder@stadt-frankfurt.de"> - -<sect1>Linux <p> -All protocol types should work. - -<sect1>Linux/98 <p> -The PS/2 mouse is not supported. - -<sect1>LynxOS <p> -The PnP serial mouse support (the <tt>"Auto"</tt> protocol) is disabled in -LynxOS, because of limited TTY device driver functionality. - -<sect1>NetBSD <p> -NetBSD 1.3.x and former does not support extended PS/2 mouse protocols -(<tt>"xxxPS/2"</tt>). -The PS/2 mouse device driver <tt>/dev/pms</tt> emulates the bus mouse. -Therefore, you should always specify the <tt>"BusMouse"</tt> protocol for -any PS/2 mouse regardless of the brand of the mouse. -<p> -The <tt>"wsmouse"</tt> protocol introduced in NetBSD -1.4 along with the wscons console driver is supported. You need to run binaries -compiled on NetBSD 1.4 to have support -for it though. Use <tt>"/dev/wsmouse0"</tt> for the device. Refer to the -<em>wsmouse(4)</em> manual page for kernel configuration informations. -<p> -This driver also provides support for USB mice. See the -<em>ums(4)</em> manual page for details. - -<sect1>NetBSD/pc98 <p> -The PS/2 mouse is not supported. - -<sect1>OpenBSD <p> -The raw PS/2 mouse device driver <tt>/dev/psm0</tt> uses the raw PS/2 -mouse protocol. - -OpenBSD 2.2 and earlier does not support extended PS/2 mouse protocols -(<tt>"xxxPS/2"</tt>) . Therefore, you should specify the -<tt>"PS/2"</tt> protocol for any PS/2 mouse regardless of the brand of -the mouse. - -OpenBSD 2.3 and later support all extended PS/2 mouse protocols. -You can select the <tt>"Auto"</tt> protocol for PnP PS/2 -mice or any specific extended (<tt>"xxxPS/2"</tt>) protocol -for non PnP mice. - -There is also a cooked PS/2 mouse device driver <tt>/dev/pms0</tt> -which emulates the bus mouse. Specify the <tt>"BusMouse"</tt> -protocol for any PS/2 mouse regardless of the brand of the mouse when -using this device. -<p> -XFree86 3.3.6 support USB mice on OpenBSD 2.6 and later though the -generic Human Interface Device (hid) <tt>/dev/uhid*</tt>. Select the -<tt>"usb"</tt> protocol and the <tt>/dev/uhid*</tt> instance -corresponding to your mouse as the device name. - -<sect1>OS/2 <p> -X11R&relvers;/OS2 always uses the native mouse driver of the operating system -and will support any type of pointer that the OS supports, whether it is -serial, bus mouse, or PnP type. -If the mouse works under Presentation Manager, -it will also work under X11R&relvers;/OS2. - -Always specify <tt>"OSMouse"</tt> as the protocol type. - -<sect1>SCO <p> -The bus and PS/2 mouse are supported with the <tt>"OSMouse"</tt> -protocol type. - -The <tt>"OSMouse"</tt> may also be used with the serial mouse. - -<sect1>Solaris <p> -Testing has been done with Solaris 2.5.1, 2.6, 7, 8, 9 and 10. - -On Solaris 10 1/06 and later versions with "virtual mouse" support, -all PS/2 and USB mice connected to the system can be accessed via -the /dev/mouse device using the VUID protocol, including USB mice -plugged in after the X server is started. On older releases or -to address mice individually, specific devices and protocols may -be used. - -Logitech and Microsoft bus mice -have not been tested, but might work with the <tt>/dev/logi</tt> and -<tt>/dev/msm</tt> devices. -Standard 2 and 3 button PS/2 mice work with the <tt>"PS/2"</tt> protocol -type and the <tt>/dev/kdmouse</tt> device. -USB mice work with the <tt>"VUID"</tt> protocol type and the -<tt>/dev/mouse</tt> device. -The PnP serial mouse support via the <tt>"Auto"</tt> protocol has been tested -and does not work. The <tt>"Auto"</tt> protocol can however detect PS/2 and -USB mice correctly. - -Additional USB mice can be connected using the <tt>"VUID"</tt> protocol type -and the appropriate <tt>"/dev/usb/hid"</tt> device with the <tt>Option "StreamsModule" "usbms"</tt> line included in the associated <tt>"InputDevice"</tt> -section. - -<sect1>SVR4 <p> -The bus and PS/2 mouse may be supported with the <tt>"Xqueue"</tt> -protocol type. - -The <tt>"Xqueue"</tt> may also be used with the serial mouse. - -The PnP serial mouse support (the <tt>"Auto"</tt> protocol) is not -tested. - -<sect1>PANIX <p> -The PC/AT version of PANIX supports the bus and PS/2 mouse with the -<tt>"Xqueue"</tt> protocol type. -The PC-98 version of PANIX supports the bus mouse with the -<tt>"Xqueue"</tt> protocol type. - -<sect>Configuring Your Mouse <p> - -Before using the <tt>xorgconfig</tt> program -to set up mouse configuration, you must identify the interface type, -the device name and the protocol type of your mouse. -Blindly trying every possible combination of mouse settings -will lead you nowhere. - -The first thing you need to know is the interface type -of the mouse you are going to use. -It can be determined by looking at the connector of the mouse. -The serial mouse has a D-Sub female 9- or 25-pin connector. -The bus mice have either a D-Sub male 9-pin connector -or a round DIN 9-pin connector. -The PS/2 mouse is equipped with a small, round DIN 6-pin connector. -USB mice have a thin rectangular connector. -Some mice come with adapters with which the connector can -be converted to another. If you are to use such an adapter, -remember that the connector at the very end of the mouse/adapter pair is -what matters. - -The next thing to decide is a device node to use for the given interface. -For the bus and PS/2 mice, there is little choice; -your OS most possibly offers just one device node each -for the bus mouse and PS/2 mouse. -There may be more than one serial port to which the serial -mouse can be attached. - -The next step is to guess the appropriate protocol type for the mouse. -The X server may be able to select a protocol type for the given mouse -automatically in some cases. -Otherwise, the user has to choose one manually. -Follow the guidelines below. - -<descrip> -<tag>Bus mouse</tag> -The bus and InPort mice always use <tt>"BusMouse"</tt> -protocol regardless of the brand of the mouse. - -Some OSs may allow you to specify <tt>"Auto"</tt> as the -protocol type for the bus mouse. - -<tag>PS/2 mouse</tag> -The <tt>"PS/2"</tt> protocol should always be tried first for the PS/2 mouse -regardless of the brand of the mouse. -Any PS/2 mouse should work with this protocol type, although -wheels and other additional features are unavailable in the -X server. - -After verifying the mouse works with this protocol, -you may choose to specify one of <tt>"xxxPS/2"</tt> protocols so that -extra features are made available in the X server. -However, support for these PS/2 mice assumes certain behavior of -the underlying OS and may not always work as expected. -Support for some PS/2 mouse models may be disabled all together -for some OS platforms for this reason. - -Some OSs may allow you to specify <tt>"Auto"</tt> as the -protocol type for the PS/2 mouse and the X server will automatically -adjust itself. - -<tag>Serial mouse</tag> -The server supports a wide range of mice, both old and new. -If your mouse is of a relatively new model, it may conform to the -PnP COM device specification and the X server may be able to -detect an appropriate protocol type for the mouse automatically. - -Specify <tt>"Auto"</tt> as the protocol type and start the X server. -If the mouse is not a PnP mouse, or the X server cannot determine -a suitable protocol type, the server will print the following -error message and abort. - -<verb> -<mousename>: cannot determine the mouse protocol -</verb> - -If the X server generates the above error message, you need to -manually specify a protocol type for your mouse. -Choose one from the following list: - -<itemize> - <item><tt>GlidePoint</tt> - <item><tt>IntelliMouse</tt> - <item><tt>Logitech</tt> - <item><tt>Microsoft</tt> - <item><tt>MMHittab</tt> - <item><tt>MMSeries</tt> - <item><tt>MouseMan</tt> - <item><tt>MouseSystems</tt> - <item><tt>ThinkingMouse</tt> -</itemize> - -When you choose, keep in mind the following rule of thumb: - -<enum> -<item><tt>"Logitech"</tt> protocol is for old serial mouse models -from Logitech. -Modern Logitech mice use either <tt>"MouseMan"</tt> or <tt>"Microsoft"</tt> -protocol. -<item>Most 2-button serial mice support the <tt>"Microsoft"</tt> protocol. -<item>3-button serial mice may work with the <tt>"Mousesystems"</tt> -protocol. If it doesn't, it may work instead with the -<tt>"Microsoft"</tt> protocol although the third (middle) button won't -function. -3-button serial mice may also work with the <tt>"Mouseman"</tt> -protocol under which the third button may function as expected. -<item>3-button serial mice may have a small switch at the bottom -of the mouse to choose between ``MS'' and ``PC'', or ``2'' and ``3''. -``MS'' or ``2'' usually mean the <tt>"Microsoft"</tt> protocol. -``PC'' or ``3'' will choose the <tt>"MouseSystems"</tt> protocol. -<item>If the serial mouse has a roller or a wheel, it may be compatible -with the <tt>"IntelliMouse"</tt> protocol. -<item>If the serial mouse has a roller or a wheel and it doesn't work -with the <tt>"IntelliMouse"</tt> protocol, you have to use it -as a regular 2- or 3-button serial mouse. -</enum> - -If the <tt>"Auto"</tt> protocol is specified and the mouse seems to be working, -but you find that not all features of the mouse are available, that is -because the X server does not have native support for that model of mouse -and is using a ``compatible'' protocol according to PnP information. - -If you suspect this is the case with your mouse, please enter a -bug report at http://bugzilla.freedesktop.org, using the xorg product. - -<tag>USB mouse</tag> -If your mouse is connected to the USB port, it can either be supported -by the <tt>"Auto"</tt> protocol, or by an OS-specific protocol (see below), -or as a generic Human Interface Device by the <tt>"usb"</tt> protocol. - -<tag>Standardized protocols</tag> -Mouse device drivers in your OS may use the standardized protocol -regardless of the model or the class of the mouse. -For example, SVR4 systems may support <tt>"Xqueue"</tt> protocol. -In FreeBSD the system mouse device <tt>/dev/sysmouse</tt> -uses the <tt>"SysMouse"</tt> protocol. -Please refer to the OS support section of this file for more information. - -</descrip> - -<sect>xorg.conf Options <p> - -The old <tt>Pointer</tt> section has been replaced by a more general -<tt>InputDevice</tt> section. The following is a minimal example -of an <tt>InputDevice</tt> section for a mouse: - -<verb> -Section "InputDevice" - Identifier "Mouse 1" - Driver "mouse" - Option "Device" "/dev/mouse" - Option "Protocol" "Auto" -EndSection -</verb> - -The <tt>mouse</tt> driver supports the following config file options: - -<sect1>Buttons <p> -This option tells the X server the number of buttons on the mouse. -Currently there is no reliable way to automatically detect the correct -number. -This option is the only means for the X server to obtain it. -The default value is three. - -Note that if you intend to assign Z axis movement to button events -using the <tt>ZAxisMapping</tt> option below, you need to take account -of those buttons into <tt>N</tt> too. - -<verb> - Option "Buttons" "N" -</verb> - -<sect1>ZAxisMapping <p> -This option maps the Z axis (wheel) motion to buttons or to -another axis. - -<verb> - Option "ZAxisMapping" "X" - Option "ZAxisMapping" "Y" - Option "ZAxisMapping" "N1 N2" - Option "ZAxisMapping" "N1 N2 N3 N4" -</verb> - -The first example will map the Z axis motion to the X axis motion. -Whenever the user moves the wheel/roller, its movement is reported as -the X axis motion. When the wheel/roller stays still, the real X axis -motion is reported as is. The third example will map negative Z axis -motion to the button <tt>N1</tt> and positive Z axis motion to -the button <tt>N2</tt>. If this option is used and the buttons <tt>N1</tt> -or <tt>N2</tt> actually exists in the mouse, -their actions won't be detected by the X server. - -The last example is useful for the mouse with two wheels of which -the second wheel is used to generate horizontal scroll action, -and the mouse which has a knob or a stick which can detect the horizontal -force applied by the user. -The motion of the second wheel will be mapped to the buttons <tt>N3</tt>, -for the negative direction, and <tt>N4</tt>, for the positive direction. -If the buttons <tt>N3</tt> and <tt>N4</tt> actually exist in this mouse, -their actions won't be detected by the X server. - -NOTE #1: horizontal movement may not always be detected -by the current version of the X11R&relvers; X servers, -because there appears to be no accepted standard as to how the horizontal -direction is encoded in mouse data. - -NOTE #2: Some mice think left is the negative horizontal direction, -others may think otherwise. -Moreover, there are some mice whose two wheels are both mounted vertically, -and the direction of the second vertical wheel does not match the -first one's. - -You need to edit the <tt>xorg.conf</tt> file by hand to change this option if -the default value of "4 5 6 7" does not match the needs of your configuration. - -<sect1>Resolution <p> -The following option will set the mouse device resolution to <tt>N</tt> -counts per inch, if possible: - -<verb> - Option "Resolution" "N" -</verb> - -Not all mice and OSs can support this option. - -<sect1>Drag Lock Buttons <p> -Some people find it difficult or inconvenient to hold a trackball -button down, while at the same time moving the ball. Drag lock buttons -simulate the holding down of another button. When a drag lock button -is first pressed, its target buttons is "locked" down until the -second time the lock button is released, or until the button itself -is pressed and released. This allows the starting of a drag, the movement -of the trackball, and the ending of the drag to be separate operations. - -<verb> - Option "DragLockButtons" "W X Y Z" -</verb> - -This option consists of pairs of buttons. Each lock button number -is followed by the number of the button that it locks. In the above, -button number "W" is a drag lock button for button "X" and button number -"Y" is a drag lock button for button "Z". - -It may not be desirable to use multiple buttons as drag locks. -Instead, a "master drag lock button" may be defined. A master drag -lock button acts as a "META" key. After a master lock button is released, -the next button pressed is "locked" and not released until the -second time the real button is released. - -<verb> - Option "DragLockButtons" "M" -</verb> - -Since button "M" is unpaired it is a master drag lock button. - -<sect>Mouse Gallery <p> - -In all of the examples below, it is assumed that <tt>/dev/mouse</tt> is -a link to the appropriate serial port or PS/2 mouse device. - -<sect1>MS IntelliMouse (serial, PS/2) <p> -This mouse has a wheel which also acts as the button 2 (middle button). -The wheel movement is recognized as the Z axis motion. -This behavior is not compatible with XFree86 versions prior to 3.3.2, -but is more consistent with the support for other mice with -wheels or rollers. -If you want to make the wheel behave like before, -you can use the <tt>"ZAxisMapping"</tt> option as described above. -<p> -IntelliMouse supports the PnP COM device specification. -<p> -To use this mouse as a serial device: -<verb> - Option "Protocol" "Auto" -</verb> -or: -<verb> - Option "Protocol" "IntelliMouse" -</verb> - -To use this mouse as the PS/2 device and the OS supports PS/2 mouse -initialization: -<verb> - Option "Protocol" "IMPS/2" -</verb> - -To use this mouse as the PS/2 device but the OS does not support PS/2 mouse -initialization (the wheel won't work in this case): -<verb> - Option "Protocol" "PS/2" -</verb> - -To use this mouse as the PS/2 device and the OS supports automatic -PS/2 mouse detection: -<verb> - Option "Protocol" "Auto" -</verb> - -<sect1>MS IntelliMouse Explorer (PS/2, USB) <p> -This mouse has a wheel which also acts as the button 2 (middle button). -There are two side buttons; they are recognized as the buttons 4 and 5. -The wheel movement is recognized as the Z axis motion. -<p> -To use this mouse as the PS/2 device and the OS supports PS/2 mouse -initialization: -<verb> - Option "Protocol" "ExplorerPS/2" -</verb> - -To use this mouse as the PS/2 device but the OS does not support PS/2 mouse -initialization (the wheel and the side buttons won't work in this case): -<verb> - Option "Protocol" "PS/2" -</verb> - -To use this mouse as the PS/2 device and the OS supports automatic -PS/2 mouse detection: -<verb> - Option "Protocol" "Auto" -</verb> - -To use this mouse as the USB device and the OS supports the generic -HID protocol: -<verb> - Option "Protocol" "usb" -</verb> - -To use this mouse as the USB device and the OS supports automatic -mouse detection: -<verb> - Option "Protocol" "Auto" -</verb> - -<sect1>Kensington Thinking Mouse and Kensington Expert Mouse (serial, PS/2) <p> -These mice have four buttons. -The Kensington Expert Mouse is really a trackball. -Both Thinking mice support the PnP COM device specification. -<p> -To use this mouse as a serial device: -<verb> - Option "Protocol" "Auto" -</verb> -or: -<verb> - Option "Protocol" "ThinkingMouse" -</verb> - -To use this mouse as the PS/2 device and the OS supports PS/2 mouse -initialization: -<verb> - Option "Protocol" "ThinkingMousePS/2" -</verb> - -To use this mouse as the PS/2 device but the OS does not support PS/2 mouse -initialization (the third and the fourth buttons act as though they -were the first and the second buttons): -<verb> - Option "Protocol" "PS/2" -</verb> - -To use this mouse as the PS/2 device and the OS supports automatic -PS/2 mouse detection: -<verb> - Option "Protocol" "Auto" -</verb> - -<sect1>Genius NetScroll (PS/2) <p> -This mouse has four buttons and a roller. The roller movement is -recognized as the Z axis motion. -<p> -To use this mouse as the PS/2 device and the OS supports PS/2 mouse -initialization: -<verb> - Option "Protocol" "NetScrollPS/2" -</verb> - -To use this mouse as the PS/2 device but the OS does not support PS/2 mouse -initialization (the roller and the fourth button won't work): -<verb> - Option "Protocol" "PS/2" -</verb> - -To use this mouse as the PS/2 device and the OS supports automatic -PS/2 mouse detection: -<verb> - Option "Protocol" "Auto" -</verb> - -<sect1>Genius NetMouse and NetMouse Pro (serial, PS/2) <p> -These mice have a "magic button" which is used like a wheel or a -roller. The "magic button" action is recognized as the Z axis motion. -NetMouse Pro is identical to NetMouse except that it has the third -button on the left hand side. -<p> -NetMouse and NetMouse Pro support the PnP COM device specification. -When used as a serial mouse, they are compatible with MS IntelliMouse. -<p> -To use these mice as a serial device: -<verb> - Option "Protocol" "Auto" -</verb> -or: -<verb> - Option "Protocol" "IntelliMouse" -</verb> - -To use this mouse as the PS/2 device and the OS supports PS/2 mouse -initialization: -<verb> - Option "Protocol" "NetMousePS/2" -</verb> - -To use this mouse as the PS/2 device but the OS does not support PS/2 mouse -initialization (the "magic button" and the third button won't work): -<verb> - Option "Protocol" "PS/2" -</verb> - -To use this mouse as the PS/2 device and the OS supports automatic -PS/2 mouse detection: -<verb> - Option "Protocol" "Auto" -</verb> - -<sect1>Genius NetScroll Optical (PS/2, USB) <p> -This mouse has a wheel which also acts as the button 2 (middle button), -and two side buttons which are recognized as the buttons 4 and 5. -It is compatible with NetMouse and NetMouse Pro. -<p> -To use this mouse as the PS/2 device and the OS supports PS/2 mouse -initialization: -<verb> - Option "Protocol" "NetMousePS/2" -</verb> - -To use this mouse as the PS/2 device but the OS does not support PS/2 mouse -initialization (the wheel and the side buttons won't work): -<verb> - Option "Protocol" "PS/2" -</verb> - -To use this mouse as the PS/2 device and the OS supports automatic -PS/2 mouse detection: -<verb> - Option "Protocol" "Auto" -</verb> - -To use this mouse as the USB device and the OS supports the generic -HID protocol: -<verb> - Option "Protocol" "usb" -</verb> - -To use this mouse as the USB device and the OS supports automatic -mouse detection: -<verb> - Option "Protocol" "Auto" -</verb> - -<sect1>ALPS GlidePoint (serial, PS/2) <p> -The serial version of this pad device has been supported since XFree86 -3.2. `Tapping' action is interpreted as the fourth button press. -(IMHO, the fourth button of GlidePoint should always be mapped to the first -button in order to make this pad behave like the other pad products.) -<p> -To use this pad as a serial device: -<verb> - Option "Protocol" "GlidePoint" -</verb> - -To use this mouse as the PS/2 device and the OS supports PS/2 mouse -initialization: -<verb> - Option "Protocol" "GlidePointPS/2" -</verb> - -To use this mouse as the PS/2 device but the OS does not support PS/2 mouse -initialization: -<verb> - Option "Protocol" "PS/2" -</verb> - -To use this mouse as the PS/2 device and the OS supports automatic -PS/2 mouse detection: -<verb> - Option "Protocol" "Auto" -</verb> - -<sect1>ASCII MieMouse (serial, PS/2) <p> -This mouse appears to be OEM from Genius. Although its shape is -quite different, it works like Genius NetMouse Pro. This mouse has a -"knob" which is used like a wheel or a roller. The "knob" action is -recognized as the Z axis motion. -<p> -MieMouse supports the PnP COM device specification. When used as a -serial mouse, it is compatible with MS IntelliMouse. -<p> -To use this mouse as a serial device: -<verb> - Option "Protocol" "Auto" -</verb> -or: -<verb> - Option "Protocol" "IntelliMouse" -</verb> - -To use this mouse as the PS/2 device and the OS supports PS/2 mouse -initialization: -<verb> - Option "Protocol" "NetMousePS/2" -</verb> - -To use this mouse as the PS/2 device but the OS does not support PS/2 mouse -initialization (the knob and the third button won't work): -<verb> - Option "Protocol" "PS/2" -</verb> - -To use this mouse as the PS/2 device and the OS supports automatic -PS/2 mouse detection: -<verb> - Option "Protocol" "Auto" -</verb> - -<sect1>Logitech MouseMan+ and FirstMouse+ (serial, PS/2) <p> -MouseMan+ has two buttons on top, one side button and a roller. -FirstMouse+ has two buttons and a roller. The roller movement is -recognized as the Z axis motion. The roller also acts as the third -button. The side button is recognized as the fourth button. -<p> -MouseMan+ and FirstMouse+ support the PnP COM device specification. -They have MS IntelliMouse compatible mode when used as a serial mouse. -<p> -To use these mice as a serial device: -<verb> - Option "Protocol" "Auto" -</verb> -or: -<verb> - Option "Protocol" "IntelliMouse" -</verb> - -To use this mouse as the PS/2 device and the OS supports PS/2 mouse -initialization: -<verb> - Option "Protocol" "MouseManPlusPS/2" -</verb> - -To use this mouse as the PS/2 device but the OS does not support PS/2 mouse -initialization (the wheel and the fourth button won't work): -<verb> - Option "Protocol" "PS/2" -</verb> - -To use this mouse as the PS/2 device and the OS supports automatic -PS/2 mouse detection: -<verb> - Option "Protocol" "Auto" -</verb> - -<sect1>IBM ScrollPoint (PS/2) <p> -ScrollPoint has a "stick" in between the two buttons. -This "stick" is the same as the stick-shaped pointing device often -found on notebook computers, on which you move the mouse cursor by -pushing the stick. -The stick movement is recognized as the Z axis motion. -You can push the stick to right and left, as well as forward and -backward. Give four numbers to <tt>ZAxisMapping</tt> option -to map movement along all these four directions to button actions. -<p> -This mouse is compatible with Logitech MouseMan+. -To use this mouse as the PS/2 device and the OS supports PS/2 mouse -initialization: -<verb> - Option "Protocol" "MouseManPlusPS/2" -</verb> - -To use this mouse as the PS/2 device but the OS does not support PS/2 mouse -initialization (the stick won't work): -<verb> - Option "Protocol" "PS/2" -</verb> - -To use this mouse as the PS/2 device and the OS supports automatic -PS/2 mouse detection: -<verb> - Option "Protocol" "Auto" -</verb> - -<sect1>8D ScrollMouse (serial, PS/2) <p> -ScrollMouse, also known as GyroMouse, has a "stick" similar to -IBM ScrollPoint. -The stick movement is recognized as the Z axis motion. -You can push the stick to right and left, as well as forward and -backward. Give four numbers to <tt>ZAxisMapping</tt> option -to map movement along all these four directions to button actions. -<p> -ScrollMouse supports the PnP COM device specification. When used as a -serial mouse, it is compatible with MS IntelliMouse. -<p> -To use this mouse as a serial device: -<verb> - Option "Protocol" "Auto" -</verb> -or: -<verb> - Option "Protocol" "IntelliMouse" -</verb> - -To use this mouse as the PS/2 device and the OS supports PS/2 mouse -initialization: -<verb> - Option "Protocol" "IMPS/2" -</verb> - -To use this mouse as the PS/2 device but the OS does not support PS/2 mouse -initialization (the stick won't work): -<verb> - Option "Protocol" "PS/2" -</verb> - -To use this mouse as the PS/2 device and the OS supports automatic -PS/2 mouse detection: -<verb> - Option "Protocol" "Auto" -</verb> - -<sect1>A4 Tech 4D mice (serial, PS/2, USB) <p> -A4 Tech produces quit a number of mice with one or two wheels. -Their mice may have 2, 3, or 4 buttons. -The wheels movement is recognized as the Z axis motion. -Give four numbers to <tt>ZAxisMapping</tt> option -to map movement of both wheels to button actions. -<p> -4D mice support the PnP COM device specification. When used as a -serial mouse, it is compatible with MS IntelliMouse. -<p> -To use this mouse as a serial device: -<verb> - Option "Protocol" "Auto" -</verb> -or: -<verb> - Option "Protocol" "IntelliMouse" -</verb> - -To use this mouse as the PS/2 device and the OS supports PS/2 mouse -initialization: -<verb> - Option "Protocol" "IMPS/2" -</verb> - -To use this mouse as the PS/2 device but the OS does not support PS/2 mouse -initialization (the wheels won't work): -<verb> - Option "Protocol" "PS/2" -</verb> - -To use this mouse as the PS/2 device and the OS supports automatic -PS/2 mouse detection: -<verb> - Option "Protocol" "Auto" -</verb> - -To use this mouse as the USB device and the OS supports the generic -HID protocol: -<verb> - Option "Protocol" "usb" -</verb> - -To use this mouse as the USB device and the OS supports automatic -mouse detection: -<verb> - Option "Protocol" "Auto" -</verb> - -<sect>Configuration Examples <p> - -This section shows some example <tt>InputDevice</tt> section for -popular mice. All the examples assume that the mouse is connected to -the PS/2 mouse port, and the OS supports the PS/2 mouse initialization. -It is also assumed that <tt>/dev/mouse</tt> is -a link to the PS/2 mouse port. - -Logitech MouseMan+ has 4 buttons and a wheel. The following example -makes the wheel movement available as the button 5 and 6. - -<verb> -Section "InputDevice" - Identifier "MouseMan+" - Driver "mouse" - Option "Device" "/dev/mouse" - Option "Protocol" "MouseManPlusPS/2" - Option "Buttons" "6" - Option "ZAxisMapping" "5 6" -EndSection -</verb> - -You can change button number assignment using the <tt>xmodmap</tt> -command AFTER you start the X server with the above configuration. -You may not like to use the wheel as the button 2 and rather want -the side button (button 4) act like the button 2. You may also -want to map the wheel movement to the button 4 and 5. -This can be done by the following command: - -<verb> - xmodmap -e "pointer = 1 6 3 2 4 5" -</verb> - -After this command is run, the correspondence between the buttons and -button numbers will be as shown in the following table. - -<verb> -Physical Buttons Reported as: ------------------------------------- -1 Left Button Button 1 -2 Wheel Button Button 6 -3 Right Button Button 3 -4 Side Button Button 2 -5 Wheel Negative Move Button 4 -6 Wheel Positive Move Button 5 -</verb> - -Starting in the Xorg 6.9 release, you can also achieve this in your -configuration file by adding this to the "InputDevice" section in xorg.conf: -<verb> - Option "ButtonMapping" "1 6 3 2 4 5" -</verb> - - -For the MS IntelliMouse Explorer which as a wheel and 5 buttons, -you may have the following <tt>InputDevice</tt> section. - -<verb> -Section "InputDevice" - Identifier "IntelliMouse Explorer" - Driver "mouse" - Option "Device" "/dev/mouse" - Option "Protocol" "ExplorerPS/2" - Option "Buttons" "7" - Option "ZAxisMapping" "6 7" -EndSection -</verb> - -The IntelliMouse Explorer has 5 buttons, thus, you should give "7" -to the <tt>Buttons</tt> option if you want to map the wheel movement -to buttons (6 and 7). -With this configuration, the correspondence between the buttons and -button numbers will be as follows: - -<verb> -Physical Buttons Reported as: ------------------------------------- -1 Left Button Button 1 -2 Wheel Button Button 2 -3 Right Button Button 3 -4 Side Button 1 Button 4 -5 Side Button 2 Button 5 -6 Wheel Negative Move Button 6 -7 Wheel Positive Move Button 7 -</verb> - -You can change button number assignment using <tt>xmodmap</tt> -AFTER you started the X server with the above configuration. - -<verb> - xmodmap -e "pointer = 1 2 3 4 7 5 6" -</verb> - -The above command will moves the side button 2 to the button 7 and -make the wheel movement reported as the button 5 and 6. See -the table below. - -<verb> -Physical Buttons Reported as: ------------------------------------- -1 Left Button Button 1 -2 Wheel Button Button 2 -3 Right Button Button 3 -4 Side Button 1 Button 4 -5 Side Button 2 Button 7 -6 Wheel Negative Move Button 5 -7 Wheel Positive Move Button 6 -</verb> - -For the A4 Tech WinEasy mouse which has two wheels and 3 buttons, -you may have the following <tt>InputDevice</tt> section. - -<verb> -Section "InputDevice" - Identifier "WinEasy" - Driver "mouse" - Option "Device" "/dev/mouse" - Option "Protocol" "IMPS/2" - Option "Buttons" "7" - Option "ZAxisMapping" "4 5 6 7" -EndSection -</verb> - -The movement of the first wheel is mapped to the button 4 and 5. The -second wheel's movement will be reported as the buttons 6 and 7. - -The Kensington Expert mouse is really a trackball. It has 4 buttons -arranged in a rectangle around the ball. - -<verb> -Section "InputDevice" - Identifier "DLB" - Driver "mouse" - Option "Protocol" "ThinkingMousePS/2" - Option "Buttons" "3" - Option "Emulate3Buttons" - Option "Device" "/dev/mouse" - Option "DragLockButtons" "2 1 4 3" -EndSection -</verb> -In this example, button 2 is a drag lock button for button -number 1, and button 4 is a drag lock button for button 3. -Since button 2 is above button 1 and button 4 is above button 3 -in the layout of this trackball, this is reasonable. - -Because button 2 is being used as a drag lock, it can not be -used as an ordinary button. However, it can be activated by -using the "Emulate3Buttons" feature. However, some people my -be unable to press two buttons at the same time. They may -prefer the following <tt>InputDevice</tt> section which -defines button 4 as a master drag lock button, and leaves -button 2 free for ordinary use. -<verb> -Section "InputDevice" - Identifier "MasterDLB" - Driver "mouse" - Option "Protocol" "ThinkingMousePS/2" - Option "Buttons" "3" - Option "Device" "/dev/mouse" - Option "DragLockButtons" "4" -EndSection -</verb> - -</article> diff --git a/configure.ac b/configure.ac index 8b6b577..0cbac9d 100644 --- a/configure.ac +++ b/configure.ac @@ -44,7 +44,6 @@ m4_ifndef([XORG_MACROS_VERSION], XORG_MACROS_VERSION(1.4) XORG_DEFAULT_OPTIONS XORG_WITH_LINT -XORG_CHECK_LINUXDOC # Checks for programs. AC_PROG_INSTALL |