[PATCH input-mouse 13/14] README: keep the text version of README, discard the sgml version

Gaetan Nadon memsize at videotron.ca
Fri May 14 13:50:35 PDT 2010


The linuxdoc doc tool is deprecated.
README files are exclusively text files.
The file had not been updated for 5 years.

Signed-off-by: Gaetan Nadon <memsize at videotron.ca>
---
 Makefile.am  |    7 -
 README.sgml  | 1122 ----------------------------------------------------------
 configure.ac |    1 -
 3 files changed, 0 insertions(+), 1130 deletions(-)
 delete mode 100644 README.sgml

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 at 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
-- 
1.6.0.4



More information about the xorg-devel mailing list