/*****************************************************************************
SoundWorks:  README.TXT
Copyright  1994 - 1995, Michael K. Schumell
All Rights Reserved
*****************************************************************************/

INTRODUCTION
OS/2 Warp has a peculiar bug: system sounds drop out of seamless Win-OS/2
sessions shortly after they have started.  This situation can be identified
by receiving a "Can't play selected sound" error from the Control Panel.  IBM
has informed me that this is a known problem (APAR PJ16129), and that they
"are working on it."  SoundWorks remedies this situation until IBM can find
the cause and an adequate solution.

INSTALLATION
If you are upgrading from an earlier version, you need to first remove the 
currently installed version and restart Win-OS/2.
1.  Start Control Panel.
2.  Start the "Drivers" applet.
3.  Click the "Add..." button.
4.  Select "Unlisted or Updated Driver" and click "OK".
5.  When prompted for the disk, specify the name of the drive or directory
    containing the bundled files, OEMSETUP.INF and SNDWORKS.DRV, and click 
    "OK".
6.  Select "SoundWorks" and click "OK".
7.  Restart Win-OS/2.
(Note that Control Panel will modify your Windows' SYSTEM.INI file.)

CONFIGURATION
With some sound cards, a Win-OS/2 session may not close properly.  If you
experience this problem, use the following procedure.
1.  Close all Windows programs; if possible, end the Win-OS/2 session.
2.  Start Control Panel in a seamless Win-OS/2 session.
3.  Start the "Drivers" applet.
4.  Select "SoundWorks".
5.  Click "Setup...".
6.  In the "Potential problem-causing modules" listbox, no entries should 
    appear.  If	any entries are shown, the Win-OS/2 session may not close 
    correctly.  Select each entry and click the "Add..." button.
(Note that SoundWorks cannot be configured if system sounds are not 
functioning.  Therefore you must restart your Win-OS/2 session after first-
time installation.  Also note that this problem seems to plague PAS16 users,
and is caused by WINMM16.DLL and MMMIXER.DLL.)

VERSION HISTORY
1.1    Bug: Seamless Win-OS/2 session does not close.
       Fix: Add user-controled "Window Finder".
       Bug: Incorrect return value possible in message filters.
       Fix: Correct code.

1.0a   Bug: Norton Desktop 3.0's Quick Access menu not responding properly
       to right-mouse button under DOS+Windows.
       Fix: Detect type of session; do not install message filters if not a
       seamless Win-OS/2 session.
       Bug: Previously installed message filters not called; some CD-ROM and
       modem applications not functioning correctly.
       Fix: Add code to call previously installed message filters.

LICENSE
The author grants you a royalty-free right to use the program.  You may
redistribute the program in its original, unaltered condition provided you
accept no fee other than reasonable distribution costs.  Although this
software is free, it is not public domain; the author retains title to the
program.

WARRANTY
The program is distributed "as-is", without warranty, express or implied, as 
to merchantability or fitness for a particular purpose.  In no event shall 
the author be held liable for any damages, including consequential and 
incidental damages, without limitation, arising from the use or inability to 
use the software, even if the author has been advised of the possibility of 
such damages.  All warranties are hereby disclaimed.

CONTACTING THE AUTHOR
Have a suggestion or comment or found a bug?  You can contact the author at:
E-mail: schumm@rpi.edu
Mail:   Michael K. Schumell
        408A BARH, RPI
        Troy, NY  12180

FROM THE LEGAL DEPARTMENT
IBM is a registered trademark, and OS/2 Warp and Win-OS/2 are trademarks of 
the International Business Machines Corporation.  Windows is a trademark of 
Microsoft Corporation.  Other trademarks are property of their respective
holders.
