Single Mouse README
Version 1.3
Support for OS/2
December 14, 2004


Contents
========
1. New in this release
2. Overview
3. Prerequisite support
4. Installation instructions
5. Uninstall instructions
6. Notes on supported hardware compatibility
7. Copyright and Trademark Information


1. New in this release
=======================

1.1. Support for Back/Forward buttons
This release adds support for Back and Forward buttons for pointing devices with 5 or more
buttons. Both PS/2 and USB versions are supported. You can use this functionality with
IBM Web Browser 2.0.4, Mozilla Application Suite 1.8 or Mozilla Firefox 1.0 to go back and
forth in visited page history.

1.2. Improved support for serial mice
Serial mice support was extended to support middle button for Logitech serial devices.
See section 6 for limitations.


2. 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 Single Mouse package combines the functionality of both these drivers into one.
Now all mouse and TrackPoint related preferences can be changed in the Mouse object
in [OS/2 System]-[System Setup] folder.


3. Prerequisite support
=========================

Single Mouse 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 Single Mouse installation.

ThinkPad T30 users should install the Single Mouse package to fix suspend/resume problem
with mouse drivers in Convenience Package for OS/2 Warp 4 or Convenience Package for
OS/2 Warp Server for e-business.


4. Single Mouse installation instructions
==========================================

Create a temporary directory and copy the self extracting package to the directory.
Run executable with -d switch to extract the installation files to your temporary directory.
Package contains following files:

  - INSTALL.EXE      Executable that installs the Single Mouse support
  - MOUSE.SYS        Universal mouse and TrackPoint driver
  - MOUSE2.SYS       Same as MOUSE.SYS
  - MOUSE.SYM        Debug symbol file for MOUSE.SYS
  - MULTIPT.EXE      Magnifying glass and scrolling support application
  - README.TXT       This file that you are reading
  - SMOUSE.RSP       Response file for unattended installation
  - USBMOUSE.SYS     USB mice driver
  - USBMOUSE.SYM     Debug symbol file for USBMOUSE.SYS
  - xx\SMOUSE.HLP    Help file for Single Mouse specific functions
  - xx\SMOUSE.MSG    Messages for installation application
  - xx\WPCONFIG.DLL  WorkPlace Shell functional DLL
  - xx\WPCONMRI.DLL  WorkPlace Shell informational DLL
  - xx\WPSTKMOU.DLL  WorkPlace Shell functional DLL
  - xx\WPSTKMRI.DLL  WorkPlace Shell informational DLL 

where xx is the name of NLV specific directory. Supported languages are:
BR, CX, DE, EN, ES, FR, IT, JP and TW.

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 Single Mouse 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 the response file
SMOUSE.RSP. When INSTALL.EXE is run with /X command line parameter, the installer
will perform an unattended installation of the mouse driver.

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.

Step-by-step instructions:

  1. Open an OS/2 command prompt (window or full screen) and go to the directory
     containing the self extracting package.
  2. Type SMOUSE.EXE -d at the command prompt (please note -d switch!).
  3. Type INSTALL.EXE at the command prompt.
  4. Installer will compare already installed files with files from package, to make sure
     that you are not overwriting them with an older version. If newer file is already
     installed on your machine it will ask whether to overwrite it. In most cases you
     should not - press 'N'.
  5. When all files are verified the program will ask whether to continue. Press 'Y'.
  6. After 'Installation completed' message, reboot the system.


5. Uninstall instructions
===========================

The installation program creates a log file SMOUSE.LOG in x:\OS2\ directory (where x is
our boot drive.) This file contains information about which files have been changed and
where the original files have been backed up.
To perform the uninstall, you should run INSTALL.EXE with the /a:d
command line parameter.


6. Notes on supported hardware compatibility
==============================================

The Single Mouse 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 "Information" 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 Single Mouse 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.


Simultaneous use of serial and PS/2 devices is not supported. If both types of devices are
present then PS/2 devices always take precedence. Keep in mind that TrackPoint is a PS/2
device. If you want to use external serial mouse with your notebook, then you should disable
TrackPoint in BIOS.
There is a similar problem on systems which have BIOS support for the USB mice enabled.
During system boot, the USB mouse will be handled by BIOS and the mouse will appear to be
a PS/2 mouse to the operating system. To enable both the serial and USB mice simultaneously,
disable the USB legacy device support in BIOS or attach the USB mouse only after the system
boot process has completed.


There are some Logitech serial mouse models that can not report 3rd button status changes
if mouse is moved at the same time. As a result of this hardware limitation you can get in
awkward situation when you already released the middle button, but computer still thinks that
it is pressed. For example, if you are using Magnifying Glass functionality and you release
the middle button while moving the mouse the computer will not receive this event and will
continue to move magnifying glass. To get back to normal state you should start moving mouse
and while still moving press middle button. Then stop mouse movement and release middle button.



7. 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, 2004. All rights reserved.
U.S. Government Users Restricted Rights -- Use, duplication or 
disclosure restricted by GSA ADP Schedule Contract with IBM Corp.