SingleMouse README
Version 1.0
Support for OS/2
July 15, 2002


Contents
========
1. Overview
2. SingleMouse installation instructions
3. Notes on supported hardware compatibility
4. Copyright and Trademark Information


1. Overview
=============

This INSTALL.EXE driver package provides you with IBM's most current support
for Mouse and TrackPoint devices on the OS/2 Operating System.

In the past there were two separate drivers - generic mouse driver MOUSE.SYS
(automatically installed during OS/2 installation) and optional TrackPoint
driver MOUSE2.SYS (located in the \OPTIONS\TP4\ directory on your OS/2
installation CD-ROM).

The SingleMouse package combines the functionality of both these drivers into one.
Now all mouse and TrackPoint related preferences could be changed in the Mouse object
in [OS/2 System]-[System setup] folder.

This is a required update for ThinkPad T30 owners to fix problems with TrackPoint
that may stop working after suspend/resume with CP2 drivers.


2. SingleMouse installation instructions
==========================================

Create a temporary directory and copy the self extracting package to the directory.
Run executable to extract the installation files to your temporary directory.
Run the installer INSTALL.EXE which will verify that all files required for
installation are present and automatically upgrade installed files to the
latest version.

If the file in SingleMouse package is older than file already installed the
user will be asked whether to use file from package or leave original file
unchanged. Unattended installation can be performed by providing response file
SMOUSE.RSP and running INSTALL.EXE with /X command line parameter.

A list of files copied/replaced/backed-up is created in the file \OS2\SMOUSE.LOG
on your system drive. This file is updated each time you run the mouse installer. 
For changes to become effective a system reboot is required.

SingleMouse will not work with Warp3 or older systems. On Warp4 systems, you must
install XR_M005 (revision 9.029) or later fixpak before you can proceed
with SingleMouse installation.


3. Notes on supported hardware compatibility
==============================================

The SingleMouse package is designed to support both an external mouse and the 
built-in TrackPoint mouse on IBM ThinkPads. When the Mouse Properties is opened, the 
"Mouse information" section on the "SingleMouse" page will indicate what was 
detected (TrackPoint, TrackPoint and Mouse, or Mouse). 
In some situations, the driver may apply some limitations on functionality to allow these
two devices to coexist on the same machine.  
For example, Microsoft IntelliMouse compatible devices with scrolling wheel or 
mice with a joystick are not hardware compatible with TrackPoint and as a result the
TrackPoint will be automatically disabled in favor of the external mouse on these
configurations.  This is necessary in order to use the scrolling wheel or joystick features
of the external mouse. The TrackPoint is automatically enabled once the incompatible 
mouse is detached.  If the TrackPoint is disabled after booting the system with a 
compatible (simple two or three button ) mouse attached, you may be able to change the
TrackPoint BIOS setting from "AutoDisable" to "Enabled" to correct this behavior.
The Mouse Properties page is displayed based on the specific mouse
that is attached at the time the Mouse Properties is opened.

The SingleMouse Hot-Plug feature may not work for all hardware configurations.  Device 
specific hardware compatibility may cause incorrect device detection or extended mouse
features may not be enabled.  If  Hot-Plug detection fails, the following sequence may
enable detection:
 1. Suspend the system.
 2. Attach the external mouse.
 3. Resume the system. 

Failure of the external mouse following this sequence indicates Hot-Plug is not supported
for your hardware configuration. 


If the external mouse is detected as a generic PS/2 pointing device there is no way to
determine whether it has two or three buttons. In that case it will be reported to the
operating system that you have three button mouse. As a result some options in the property
pages that are relevant only for three button pointing devices might be displayed even if
your hardware does not support them. If you do not have a three button mouse then the Scrolling
page should be ignored.

There are some mice that are not able to work in combination with TrackPoint even in
compatibility mode. For example, some Kensington mice may only be used when the
TrackPoint is disabled in BIOS.


4. Copyright and Trademark Information
========================================

The following terms are trademarks of International Business Machines
Corporation in the United States and/or other countries:
        IBM		TrackPoint
        OS/2
Other company, product, and service names may be trademarks or service
marks of others.

THE INFORMATION PROVIDED IN THIS README IS PROVIDED "AS IS" WITHOUT 
WARRANTY OF ANY KIND.  IBM DISCLAIMS ALL WARRANTIES, WHETHER 
EXPRESSED OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED 
WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY 
WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING
THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS.

(C) Copyright IBM Corporation, 2001, 2002. All rights reserved.
U.S. Government Users Restricted Rights -- Use, duplication or 
disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
