---------------------------------------------------------------------
----------- Zinc Application Framework 5.3 - README.TXT -------------
----------- COPYRIGHT (C) 1990-1999. All Rights Reserved. -----------
-------- Wind River Systems Incorporated. Alameda, CA, USA ----------
---------------------------------------------------------------------

Welcome to Zinc Application Framework 5.3! This file contains general
information about Zinc. (More specific information can be found in
the ~/readme directory.) Please read this file before installing Zinc.
It contains the following sections:

    Where to Look
    Getting Started
    Technical Support
    Reporting Problems
    Contacting Zinc

---------------------------------------------------------------------
--- Where to Look ---------------------------------------------------
---------------------------------------------------------------------

    1. The ~/readme directory (created during installation) contains
valuable information about Zinc. Following is a list of the files
located in this directory along with a short description:

    license.txt     Zinc license agreements
    download.txt    Zinc download instructions
    support.txt     Zinc platform/compiler/language/... support matrix
    readme.win      Important information for Zinc users on MS Windows
    readme.mtf      Important information for Zinc users on Motif
    whatsnew.txt    What's new in this build
    upgrade.txt     Differences between Zinc 4 and 5
    disclaim.txt    Features/functionality not complete in this build

    2. The ~/doc directory (also created during installation)
contains the documentation provided with Zinc 5.3. NOTE: You will need
Adobe Acrobat Reader [FREE] to view/search these files. (Some or all
of these files are also printable.)

    zafinst.pdf     Zinc Installation Guide manual
    zafstart.pdf    Zinc Getting Started manual
    zafrefer.pdf    Zinc Programmer's Reference manual

    3. The ~/example directory contains source and make files for
building small, representative applications that demonstrate correct
implementation of various essential techniques. Some of these
programs supply useful objects that may be used in end-user
applications.

    4. The ~/attrtest directory contains source and make files for
building a suite of test programs used internally by Zinc to test
Zinc. NOTE: The attrtest applications were created for sophisticated
internal testing purposes only and are NOT intended as examples of
typical Zinc application development techniques!

---------------------------------------------------------------------
--- Getting Started -------------------------------------------------
---------------------------------------------------------------------

We recommend that you review and follow the instructions found in the
Zinc Installation Guide (~/doc/zafinst.pdf). At a high level, these
instructions include:

    1. Copy the Zinc 5.3 distribution files (e.g., .zip files for PC
and .tar files for Unix) to an area on your hard disk and decompress
them. When unzipping .zip files, be sure to use the -d option so that
the correct directory structure will be created. If you have the
professional version, be sure to download the professional files in
the professional directory and decompress the professional files
last (since they replace existing files in the free version).

    2. Run the installation script (e.g., ~/winstall.bat for Windows,
~/minstall for Motif, and ~/install.bat for DOS). The installation
script confirms acceptance of the appropriate Zinc Software License
Agreement and configures the Zinc software for use.

    3. Build the Zinc libraries. Since pre-compiled library files are
not included in the Zinc distribution, be sure to read the platform-
specific readme file(s):

    readme.win is for Windows developers
    readme.mtf is for Motif developers

These files contain information on how to build Zinc libraries and
example programs as well as other platform-specific information.

    4. Read and follow the tutorial information found in the Zinc
Getting Started manual.

