-----------------------------------------------------------------------------
-------- Zinc Application Framework - README.TXT ----------------------------
-------- COPYRIGHT (C) 1990-1997.  All Rights Reserved. ---------------------
-------- Zinc Software Incorporated.  Pleasant Grove, Utah  USA -------------
-----------------------------------------------------------------------------

ZAF 5, Build #837
(Beta 3)

-----------------------------------------------------------------------------
-------- Warning ------------------------------------------------------------
-----------------------------------------------------------------------------

ZAF 5 Beta 3 is appropriate for advanced C++ users and API-level ZAF users.
It does not include pre-built libraries, and includes few example programs.
Documentation is incomplete and reference-only. Zinc Designer is incomplete.
If you rely on Zinc Designer you may wish to wait until Beta 4 to begin using
ZAF 5 exclusively.

ZAF 5 is currently very stable at the library level. (In fact, most of ZAF 5
is more stable than the currently shipping version of ZAF 4!) If you meet the
criteria above, you will find ZAF 5 to be a pleasure to use and a great
improvement over previous versions of Zinc Application Framework.

We look forward to hearing from you, and to delivering the best application
framework ever!

-----------------------------------------------------------------------------
-------- Contents -----------------------------------------------------------
-----------------------------------------------------------------------------

This file (README.TXT) contains general information about ZAF 5. It also
contains information about where more specific information may be found. Be
sure to read this file before installing ZAF.

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

The README directory contains valuable information about ZAF 5. Here is a
list of the files there with a short description of each file.

BETASITE.TXT    Essential beta test site information
BUGREPT.TXT     Bug report form (used to report bugs or request enhancements)
DISCLAIM.TXT    Features and functionality not complete in this build
UPGRADE.TXT     Differences between ZAF 4 and ZAF 5
WHATSNEW.TXT    What's new in this build
LICENSE.TXT     ZAF 5 license agreement with beta test addendum

-----------------------------------------------------------------------------
-------- Supported Platforms and Compilers ----------------------------------
-----------------------------------------------------------------------------

Microsoft Windows 32-bit DLL
	Borland C++ 5.0
	Microsoft C++ 4.2

Microsoft Windows 32-bit
	Borland C++ 5.0
	Microsoft C++ 4.2
	Watcom C++ 11

Microsoft Windows 16-bit
	Borland C++ 5.0
	Watcom C++ 11

AIX 4.1.x (Motif 1.2, X11R5)
	Native C++ compiler (IBM CSet for AIX)
	GNU C++ 2.7.2

Digital Unix (DEC) 3.2 (Motif 1.2, X11R5)
	Native C++ compiler
	GNU C++ 2.7.2

HP-UX 9.05 (Motif 1.2, X11R5)
HP-UX 10.20 (Motif 2.0, X11R6)
	Native C++ compiler
	GNU C++ 2.7.2

Linux 2.0.27 (Red Hat version 4.1, Motif 2.0, X11R6)
    GNU C++ 2.7.2

Solaris 2.x (Motif 1.2, X11R5)
SunOS 4.1.3 (Motif 1.2, X11R5)
	SparCompiler C++ 4.0
	GNU C++ 2.7.2

SGI Irix 5.3 (Motif 1.2, X11R5)
	Native C++ compiler 4.0
	GNU C++ 2.7.2

QNX 4.22 (Motif 1.2, X11R5)
	Watcom C++ 10.5

DesqView/X 2.0 (Motif 1.2, X11R5)
	Watcom C++ 11.0

-----------------------------------------------------------------------------
-------- What to Download ---------------------------------------------------
-----------------------------------------------------------------------------

All beta files must be downloaded via ftp from ftp.zinc.com. Passwords are
required (which you should have received in a separate communication).

WINDOWS
-------
If you are testing ZAF 5 for Microsoft Windows, you will need to login as
zaf_core_beta and download:
    core_src.zip    Shared source code for all platforms
    include.zip     Include files common to all platforms
    util.zip        Utility application source code
    doc.zip         Documentation in Adobe Acrobat format
    attrtest.zip    Attribute test suite source code
    test.zip        Single-object test program source code
    example.zip     Example program source code

then login as zaf_win_beta and download:
    win_src.zip     Windows-specific source code (both 16 and 32 bit)
    bin.zip         Binary files for Windows (includes Zinc Designer)

you may also wish to download:
    acrobt32.exe    Adobe Acrobat 3.0 Reader/Search for Windows (view docs)
or  acrobt16.exe    16 bit version of above

Note that you must use the binary transfer mode when downloading *.zip files
with FTP. (Type the command "BINARY" at the ftp> prompt before getting the
files.)

When unzipping the *.zip files, create your ZAF directory, make the ZAF
directory your current directory, then make sure to use the pkunzip '-d'
option while inside the ZAF directory.

MOTIF
-----
If you are testing ZAF 5 for Motif, you will need to login as zaf_core_beta
and download:
    core.tar.Z      Shared source code for all platforms
    include.tar.Z   Include files common to all platforms
    util.tar.Z      Utility application source code
    doc.tar         Documentation in Adobe Acrobat format
    attrtest.tar.Z  Attribute test suite source code
    test.tar.Z      Single-object test program source code
    example.tar.Z   Example program source code

then login as zaf_mtf_beta and download:
    motif.tar.Z     Motif-specific source code
    bin.tar.Z       Binary files common to all unix platforms
    bin_*.tar.Z     Platform-specific binaries (replace * with your OS)

You may also wish to download an Adobe Acrobat Reader to view or print ZAF 5
documentation. Please visit www.adobe.com to obtain the free reader for your
specific unix platform.

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

Before building the libraries, we recommend that you print some or all of the
documentation provided with ZAF 5. You will need Adobe Acrobat reader (free)
for this purpose.

z5matrix.pdf is a short document that lists all the supported attributes
for each of the major base classes. It is essential for proper understanding
of ZAF 5.

zafrefer.pdf includes reference documentation on a many ZAF 5 classes.
Documentation for ZafWindowObject is of particular importance, and we
recommend that you print this as well.

Additional documentation updates will be posted frequently (more frequently
than new beta code) and you will be notified of these postings via email.

-----------------------------------------------------------------------------
-------- Building the Libraries ---------------------------------------------
-----------------------------------------------------------------------------

Since library files are not included in this beta, be sure to read the
README.WIN or README.MTF file (in the README directory) included with the
platform you are testing for information about building the libraries and
other platform-specific information.

-----------------------------------------------------------------------------
-------- Testing Tools ------------------------------------------------------
-----------------------------------------------------------------------------

ATTRTEST contains source and make files for building programs that you may
wish to use to test different features of ZAF 5. ATTRTEST applications are
used internally by Zinc as the primary test suite for ZAF 5.

** ATTRTEST applications were created for this purpose and are NOT intended
as examples of proper ZAF 5 application development technique! **

-----------------------------------------------------------------------------
-------- Sample Code --------------------------------------------------------
-----------------------------------------------------------------------------

TEST contains source and make files for building other small, single-object
applications that may be used to learn how to manipulate various objects.

EXAMPLE 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.

