BlackBook v1.00c by Viet-Tam Luu  96/08/04
================================

Introduction
============

BlackBook is an address book program for OS/2 Warp 3.0 Presentation
Manager (or later versions).  In addition to the usual address book
database functions, BlackBook adds a phone dialer, an Internet
sendmail (SMTP) client for sending E-mail, interoperability with IBM
WebExplorer or other WorldWide Web (WWW) browsers, and a birthday
notification (reminder) program.

BlackBook is freeware.  You are not required to pay for its use so
long as it is for your own private use.  Use of BlackBook by any
organization (including schools and businesses) requires that a
separate software license be purchased from the author.  Please see
the license agreement below for further details.


System Requirements
===================

The following are the (conjectured) minimum system requirements needed
to install and use all of BlackBook's features, on OS/2 Warp and OS/2
Warp Connect:

 - i386 CPU.
 - 8MB of RAM.
 - 4MB of free disk space on an HPFS filesystem.
 - 1200bps modem.

Additionally, the following software must be installed for you to take
advantage of all of BlackBook's features:

 - IBM OS/2 Warp or Warp Connect (Win-OS/2 support not required) (or
   later).
 - IBM TCP/IP 2.0 (or later) for OS/2.
 - A WorldWide Web broser (e.g., IBM WebExplorer, Lynx, etc.).
 - MMOS/2 installed (required for BlackBook Birthday Notification).


Installation
============

0.  Extract the BlackBook archive (bbk100c.zip) into a temporary
    directory.  e.g., "unzip bbk100c.zip -d C:\TEMP"

    You should use Info-ZIP's unzip to extract files from the
    archive, *not* PKUnzip for DOS (not tested with PKUnzip for OS/2).
    Info-ZIP is freely available at most OS/2 FTP sites.  A copy of
    unzip is also available at the BlackBook Home Page.

    NOTE:  BlackBook uses "long" (non-8.3) filenames, and therefore
    requires a non-FAT filesystem such as HPFS to install.  If you
    wish to install to a non-HPFS partition, you will have to rename
    some files (which will break the installation script, unless you
    also edit Install.dat), including the documentation files (which
    will no longer be accessible from BlackBook).  FAT is an archaic,
    outdated filesystem that belongs in the back pages of computing
    history.  If you are masochistic enough to be still using it, you
    deserve whatever terrible fate befalls your data.

1.  Read the License Agreement, below.  If you do not agree to comply
    with the terms and conditions set out in the License Agreement,
    stop here.

2.  Run the install program, Install.exe.  Specify where you want to
    install the BlackBook files, and install the components you wish
    to use.

3.  Run BlackBook and set configuration options as necessary. Once
    you've created a BlackBook database file, and if you have
    installed BlackBook Birthday Notification, set the parameters for
    the Birthday Notification object to the full path of your database
    file (Birthday Notification will not run without it).

4.  Delete the installation files from the temporary directory, as
    needed.

5.  Explore, experiment, and enjoy!


Removing BlackBook
==================

0.  Run the install program, Install.exe (or using the BlackBook
    Installation object created in the BlackBook folder).

1.  If necessary, enter the directory in which BlackBook is installed.
    (If you are running Install using the BlackBook Installation
    object, the directory will be set to the one you specified when
    installing BlackBook.)

2.  Under Installation Type, select ``Uninstall.'' Click on the
    ``Uninstall'' button. The uninstall process will proceed.

3.  If there are any files or directories left over after the
    uninstall procress, remove them.


Revision History
================

BlackBook v1.00
---------------
  - First public release (96/07/19).

BlackBook v1.00a
----------------
  - First maintenance release (96/07/27): no changes to BlackBook, bug
    fixes to BlackBook Birthday Notification, documentation updates.
  - Assertion failure (harmless) when specifying a non-existent or
    invalid file to BlackBook Notify. (fixed)
  - On certain video cards and/or drivers, the list in BlackBook
    Notify appeared in incorrect colours (black on black). The
    ``Hardwired colours'' option has been added to address this
    problem. (fixed)
  - BlackBook Notify did not update the list (days until birthdays)
    when notification was disabled. (fixed)
  - BlackBook Notify failed to notify if the ``no notification before''
    time was anything other than midnight. (fixed)
  - BlackBook Notify failed to recalculate days until birthdays under
    certain conditions. (fixed)
  - BlackBook Notify now notifies, regardless of the ``no notification
    before'' time, when notification for all records is enabled.
  - Version number updated in Product Information window.
  - Documentation updates.

BlackBook Birthday Notification v1.00b
--------------------------------------
  - Released as an upgrade to Notify only, not as a whole package.
    Fixes to BlackBook Notify for users with display problems (notably
    with Cirrus Logic cards and drivers).
  - Certain details were missed in implementing the ``Hardwired
    colours'' fix/workaround for those with display problems, and
    so it may or may not have worked at all. (fixed)

BlackBook v1.00c
----------------
  - Second maintenance release (96/08/04): bug fixes in BlackBook,
    minor features added to BlackBook and Notify, documentation
    updates.
  - BlackBook saved the filenames of photo files incorrectly if they
    were added to the database when it was first created (i.e. before
    the database was saved and re-opened). This prevented the photos
    from displaying correctly, and prevented the user from
    re-specifying the photo files. (fixed)
  - As a consequence of the above fix, BlackBook now recalculates any
    ``relative paths'' to photo files whenever the database file is
    saved. If the photo can be found with the same sub-path relative
    to the database's new directory, the relative path is unchanged.
    Otherwise, the photo's path is set to its old location, relative
    to the new one if possible.
  - New feature: you can know enter an illegal or zero year for a
    person's birthdate, in case you don't know the year of a person's
    birth; this results in "??" being displayed for the year of
    birth, both in BlackBook and in Notify.
  - Version number updated in Product Information window.
  - Documentation updates.


Additional Notes
================

Please consult the BlackBook User's Guide, doc\BlackBook.html (or
using the BlackBook User's Guide object), for further information on
configuring and using BlackBook.

Also visit the BlackBook Home Page at
  http://www.csclub.uwaterloo.ca/u/vtluu/BlackBook/

for the latest version of BlackBook, troubleshooting tips, frequently-
asked questions, and more!


License Agreement
=================

Please read this section in full before installing BlackBook.

In the following text, "BlackBook" refers to this software package and
all accompanying files and utilities.  "The author" refers to Viet-Tam
Luu, creator of BlackBook and owner of the copyright to BlackBook.

BlackBook is freeware.  This means that you do not have to pay for the
right to use and distribute it, with the following terms, conditions
and restrictions:

1.  As freeware, BlackBook may only be used for your own personal
    (non-work or business-related) use.  If you are a charity, please
    apply with the author for a free license.

2.  If the above condition does not apply to you, i.e. if you are a
    business, non-charity organization, or if you otherwise plan to
    use BlackBook for commercial purposes, you must additionally abide
    by the terms of the Commercial License Agreement, below.

3.  As freeware, no fee may be charged for the distribution of the
    BlackBook license.  In other words, the only fee that you are
    allowed to charge when distributing BlackBook is a modest fee to
    cover the cost of the media or other means of distribution (e.g.
    on-line time).

4.  You may only distribute BlackBook in its original distribution
    package form, i.e. in the form released by the author (either a
    single archive file, e.g. bbk100c.zip or a single self-extracting
    archive, e.g. bbk100c.exe).  You may not distribute modified
    versions of the distribution file.  If you need a special form of
    distribution, please contact the author for authorization.  You
    may, however, include the distribution file (unmodified) as part
    of another archive.  You may also rename the distribution file, as
    long as it still contains some representation of the name
    "BlackBook" (e.g. "BB," "BBook", etc.) and the version number (the
    actual version number, e.g. "1.00c" or without the decimal point,
    e.g. "100C").

5.  You may not modify any executable files included with BlackBook.
    This includes BlackBook.exe, BBNotify.exe, BBNotif.exe, and
    Install.exe, and any other executables.  You may not distribute
    as part of the BlackBook package any modified versions of other
    files in the distribution.

6.  In using BlackBook, you agree that you cannot hold the author
    responsible or liable for any damages and losses (monetary,
    material, or otherwise) caused directly or indirectly by the use,
    installation, or distribution of BlackBook.  This includes damages
    and losses that may caused by agents such as computer viruses that
    may become attached to the distribution file.

7.  By installing and/or using BlackBook, you have stated your
    implicit agreement to this and all above terms.  Upon violation
    of these terms and conditions, the author reserves the right to
    withdraw your license to use and/or distribute BlackBook, and to
    take further legal action should he feel it necessary.


Commercial License Agreement
============================

If you are using BlackBook for commercial, governmental, or
educational purposes, or in such a setting, or for any purposes that
would not be considered "personal use," the following additional
terms apply to you:

1.  All terms of the above License Agreement apply, except those
    pertaining to free use.

2.  You may distribute BlackBook freely to other parties.  Those
    parties must also comply with the terms of both the License
    Agreement and the Commercial License Agreement (if applicable),
    including additional licensing fees, etc.

3.  License fees: You must pay the author of BlackBook a license fee.
    Note that you are not paying for the software itself; you are
    paying for the *right* to use the software. Payment of a license
    fee gives you the right for an indefinite period of time to use
    BlackBook for whatever purposes you see fit.

    License fees are calculated according to the number of BlackBook
    installations or users (whatever is smallest) at your site, as follows:

        Number of Users                 Fee per User
        ---------------                 ------------
            1 to 5                       CDN $30.00
            6 to 25                      CDN $26.00
           26 to 100                     CDN $23.00
          101 or more                    CDN $20.00

    Prices are listed in Canadian dollars.  Prices in other currencies
    are the same amount in Canadian dollars, calculated according to
    current (at the time of payment) exchange rates.

    Please contact the author about methods of payment accepted.

    Payment of license fee gives you the right for an indefinite
    period of time to use BlackBook for whatever purposes you see fit.


Contacting the Author
=====================

The author welcomes any comments, feedback, bug reports, etc.
Money, postcards, trinkets, and other various tokens of appreciation
are also accepted.  :-)

Viet-Tam Luu can be reached by E-mail at:  vtluu@uwaterloo.ca

His homepage on the WorldWide Web is located at:
  http://www.csclub.uwaterloo.ca/u/vtluu/

