
Wake up!!  CandyBarZ is here!  CandyBarZ is THE titlebar replacement for
OS/2.  CandyBarZ' primary feature is gradient-filled titlebars; you choose
the top and bottom colors, and it does the rest.  Both active and inactive
colors are supported, and CandyBarZ will not muck up your titlebar text
colors or fonts.  Custom colors for individual programs are also supported.

PLEASE read the instructions thoroughly before proceeding with installation.
As CandyBarZ REPLACES PART OF OS/2, failure to follow the instructions
accurately may result in severe problems.

Extensive online help is also available.

The Files
---------
Just to make sure everything is in order before you start, check that the
following files were extracted from the CandyBarZ archive:

CandyBar.dll
PSRT.DLL
CBSetup.exe
CBSetup.hlp
CandyBar.txt (since you're reading it now...)

Requirements
------------
OS/2.  CandyBarZ has been tested with OS/2 Warp 3 and Warp 4.  It
should work on any 32-bit OS/2 platform, however.

MMOS/2.  Though MMOS/2 is not used by CandyBarZ, the PSRT dll requires
that it be installed.  I am looking into removing this requirement.

New Installation
----------------
Start the CBSetup program.  Until CandyBarZ is installed, the setup
notebook has only one page, Install/Uninstall.  This page will let you
select the destination directories for CandyBar.dll, PSRT.dll and
CandyBar.ini (note that CandyBar.ini is NOT included in the archive, it
will be created when CandyBarZ is first loaded).  Context sensitive help
is available for all controls on this page (tab to the control and hit
F1).

When the installation is complete, you must reboot so that OS/2 can
load CandyBar.dll.

NOTE: Whack-A-Mole uses a previous version of PSRT.DLL.  If you have
Whack-A-Mole installed, please remove the version of PSRT.DLL that came
with Whack-A-Mole.

NOTE: CandyBar.dll and PSRT.DLL MUST reside in a directory specified in
your LIBPATH line in CONFIG.SYS.

Upgrade
-------
Start the CBSetup program and turn to the Install/Uninstall page.  Press
the "Uninstall" button.  Reboot and delete the old DLLs.  It is not
necessary to delete the INI file.  It is compatible with the new version
of CandyBarZ.  Start the CBSetup program again and proceed as with a new
installation.

NOTE: It is important that you delete the old DLLs.  If you install the
new version to a different directory from the old version without
deleting the old DLLs, and the old DLLs are earlier in your LIBPATH than
the new, then you haven't upgraded.

NOTE: If you previously removed the CandyBarZ DLLs without using CBSetup,
CandyBarZ information remains in your OS2.INI (unless you removed it).
If this is the case, the "Install" button will be disabled.  Conduct the
uninstall as instructed above to remove the INI information and restart
CBSetup.  It is not necessary to reboot in this instance.

The above method is the only supported method.  With that said, you can
reduce the process to a single reboot by using the unlock utility that
is included with the freeware package lxlite by taking the following
steps:

- open an OS/2 command prompt and change to the directory containing the
  already installed DLLs
- type "unlock candybar.dll"
- type "unlock psrt.dll"
- copy the new DLLs over the old DLLs

NOTE: THIS IS NOT SUPPORTED!

Customization
-------------
Once CandyBarZ is installed, two additional pages are added to the setup
notebook, one for the default color scheme, and one for custom colors.
The Default Colors page will let you set up the scheme that CandyBarZ uses
for all titlebars which don't have an explicit custom scheme.  The Custom
Colors page, of course, lets you choose custom colors program by program,
as well as disable CandyBarZ program by program.

Online help is available for all fields on these pages.

Potential Problems
---------------------
Some programs may either have problems with CandyBarZ or completely ignore
CandyBarZ.

A list of known problems is included in the online help, as well as
instructions for selectively disabling CandyBarZ.

There may be additional problems not listed in the online help.  Please
report them to me at

    erlkonig@alum.mit.edu

Registration
------------
If you like CandyBarZ, you must register it after 14 days.  The cost is
only $7.00 US (check or money order only, for your safety), sent to:

Matthew Wagner
PsychoSemantic Software
6001 TRACY VALLEY DR
NORCROSS GA 30093

Note: Please make payments out to Matthew Wagner, as I do not have a
bank account in the PsychoSemantic name.

CandyBarZ is not crippled in any way, so a registration key is not
necessary.  However, if you would like to be notified of future releases,
please provide your email address with your registration.

Your registration is valid for all future shareware releases of CandyBarZ.
If a large wealthy company buys the rights from me, you're at their whim.
However, I promise not to sell it to Microsoft unless they offer me a LOT
of money.

License and Disclaimer
----------------------
By using this software, you agree to the following terms.

CandyBarZ is not free.  The shareware version is licensed to you to try
for 14 days.  At the end of that period, you must register the software or
remove all copies from your system.  Upon registering, you are licensed to
install CandyBarZ on a single computer.  You are encouraged to distribute the
CandyBarZ archive, provided that you distribute the entire archive, original
and unmodified, including this documentation.  You may not alter, disassemble,
or otherwise reverse engineer CandyBarZ.

If you are dissatisfied with CandyBarZ, I will be happy to refund your
registration fee.  There are no other warranties, express or implied.  The
author and PsychoSemantic Software are not responsible for any damage,
direct or indirect, caused to your computer, productivity, or anything
else by this software.  This software is not warranted to be free of bugs.

This software may not be used for military purposes.  It may be used by
military personnel in a civilian setting for civilian purposes only.

History
-------
24 July, 1997   1.00    Initial release
02 August, 1997 1.01    Fix lots of bugs, probably introduce some others

