---------------------------------------------------------------------
-------------- Zinc Application Framework 4.0 - READ.ME -------------
----------- COPYRIGHT (C) 1990-1994.  All Rights Reserved. ----------
------ Zinc Software Incorporated.  Pleasant Grove, Utah  USA -------
---------------------------------------------------------------------

Welcome to Zinc Application Framework 4.0!  This file contains some 
important information concerning this release.  Please read this file 
before installing the product.  It is divided into the following 
sections:
 
    ENVIRONMENT/OPERATING SYSTEM SUPPORT
    COMPILER SUPPORT
    INSTALLATION
    INTERNATIONAL LANGUAGE SUPPORT
    UNICODE SUPPORT
    REPORTING PROBLEMS
    CONTACTING ZINC


---------------------------------------------------------------------
---- ENVIRONMENT/OPERATING SYSTEM SUPPORT ---------------------------
---------------------------------------------------------------------

This version of Zinc provides support for the following environments. 
Note that to use all these environments would require the Zinc Engine
and all platform keys.

    MS-DOS, PC-DOS
    MS/PC-DOS/V (Japan, Korea, Taiwan, China)
    NEC PC9800
    Windows 3.x
    Windows 3.1 (Japan, Korea, Taiwan, China)
    WIN32s
    Windows NT 3.1
    OS/2 2.x
    OS/2 J 2.1
    HPUX 9.01 Motif 1.2
    SunOS 5.2/Solaris 2.2 Motif 1.2
    Apple Macintosh System 7
    NEXTSTEP 3.1 and later for Intel/Motorola (Pre-Release)
	

---------------------------------------------------------------------
---- COMPILER SUPPORT -----------------------------------------------
---------------------------------------------------------------------

There are three levels of compiler support provided by Zinc.  "Zinc
Certified" support indicates that Zinc has compiled and tested the
libraries, utilities, examples, and tutorials with that compiler and
is responsible for their compatibility.

"Vendor Certified" support means the compiler vendor has compiled
and tested the libraries, utilities, examples, and tutorials with
that compiler and is responsible for their compatibility.

"Supported" indicates that Zinc has compiled the library with that
compiler but has done minimal testing.  A compiler at this level of
support receives low-priority attention.

Zinc will work with the following compilers:

DOS:	1) Borland C++ Version 4.0 (Zinc Certified)
               DOS real mode
               DOS VROOMM overlay
               DOS 16-bit extender, Phar Lap 3.04
               DOS/V real mode text only
               DOS/V 16-bit extender text and GFX, Phar Lap 3.04
               NEC 9800 series real mode text only
        2) Borland C++ Version 3.1 (Supported)
               DOS real mode
               DOS 16-bit extender, Phar Lap 2.5
        3) Microsoft Visual C++ Version 1.50 (Zinc Certified)
               DOS real mode
               DOS MOVE overlay
               DOS 16-bit extender, Phar Lap 3.04
        4) Microsoft Visual C++ Version 1.0 (Zinc Certified)
               DOS 32-bit extender, text mode only, Phar Lap TNT 6.1
        5) Microsoft Visual C++ Version 1.0 (Supported)
               DOS real mode
               DOS 16-bit extender, text mode only, Phar Lap 2.5
        6) Symantec Version 6.1 (Zinc Certified)
               DOS real mode
               DOS VCM overlay
               DOS 32-bit extender, FlashTek X model
        7) Symantec Version 6.0 (Supported)
               DOS real mode
               DOS 32-bit extender, FlashTek X model
        8) Watcom C++ 10.0 (Zinc Certified)
               DOS 32-bit extender, 4GW
        9) Watcom C++ 9.5b (Supported)
               DOS 32-bit extender, 4GW

WINDOWS, WIN32s, and WINNT:
        1) Borland C++ Version 4.0 (Zinc Certified)
               Windows 3.x
               Windows NT 3.1
               Win32s
        2) Borland C++ Version 3.1 (Supported)
               Windows 3.x
        3) Microsoft Visual C++ Version 1.5 (Zinc Certified)
               Windows 3.x
               Windows J 3.1
        4) Microsoft Visual C++ Version 1.0 (Zinc Certified)
               Win32s
               Windows NT 3.1
        5) Microsoft Visual C++ Version 1.0 (Supported)
               Windows 3.x
        6) Symantec Version 6.1 (Zinc Certified)
               Windows 3.x
        7) Symantec Version 6.0 (Supported)
               Windows 3.x
        8) Watcom C++ 10.0 (Zinc Certified)
               Windows NT 3.1
               Win32s
        9) Watcom C++ 9.5b (Supported)
               Windows NT 3.1
               Win32s
        10)Watcom C++ 10.0 (Supported)
               Windows 3.x
        11)Watcom C++ 9.5b (Supported)
               Windows 3.x
        12)Symantec C++ 6.1 (Supported)
               Windows 3.x

OS/2:	1) IBM C-Set C++ Version 2.1 (Zinc Certified)
               OS/2 2.x
               OS/2 J 2.1
        2) Borland C++ for OS/2 Version 1.5 (Zinc Certified)
               OS/2	2.x
        3) Watcom C++ 10.0 (Zinc Certified)
               OS/2	2.x

Motif:	1) HPUX 9.0x, X11R5/Motif 1.2 (Zinc Certified)
        2) SunOS 5.x/Solaris 2.x, X11R5/Motif 1.2 (Zinc Certified)

Macintosh:
        1) Symantec C++ for Macintosh Version 7.0
	
NEXTSTEP:
	1) GNU CC 2.2.2 
		Included with NEXTSTEP 3.x for Intel/Motorola Developer Release (Zinc Certified)
	2) GNU CC 2.5.8 
		Included with NEXTSTEP 3.2 for HP-PA/RISC Developer Release (Supported)

In general, only the top 3 compilers get "Certified" support from Zinc.
When a "Certified" compiler vendor releases a new version of their
compiler, Zinc will usually provide support for the new compiler in
its next maintenance release.  If you are working with a "non-supported"
compiler, call our technical support to see if Zinc or the vendor plans
to certify the compiler.

NOTE: When using Borland C++ 4.0 or Microsoft Visual C++ 1.5 to build
DOS protected mode applications, you will need Phar Lap 3.04.  Previous
versions of Phar Lap do not support these compilers.  When upgrading
to Phar Lap 3.04, take care to properly set up any necessary
environment variables and configuration files.  With Borland, you
will need to update the TURBOC.CFG and TLINK.CFG files so that the
new BC4 subdirectory in your Phar Lap directory is referenced.  With
Microsoft, the environment LIB and INCLUDE variables will need to be
set to reference the MSVC subdirectory in the Phar Lap directory. 
Refer to the Phar Lap documentation for specific instructions on
installing and configuring the Phar Lap Dos Extender.

NOTE: When using Microsoft's Visual Workbench, the compiler may generate
errors when attempting to locate some Motif include files.  These files 
are included in Motif-specific code in a Zinc header file, but 
Microsoft's dependency scan still attempts to use them.  To eliminate 
the problem, either comment out the offending lines in the Zinc header
file or place the names of the offending header file names in Microsoft's
SYSINCL.DAT file, which is used to exclude header files from the 
dependency scan.  For more information about SYSINCL.DAT see Microsoft's
"Visual Workbench User's Guide."

The following makefiles are supported for each compiler:

MAKEFILE   	- General makefile with compiler specific information.

BTCPP400.MAK	- Borland C++ Version 4.0
BTCPP310.MAK	- Borland C++ Version 3.1
BCCPP100.MAK	- Borland C++ for OS/2 Version 1.0
BCCPP150.MAK	- Borland C++ for OS/2 Version 1.5
MVCPP150.MAK	- Microsoft Visual C++ Version 1.5
MVCPP100.MAK	- Microsoft Visual C++ Version 1.0
SCCPP600.MAK	- Symantec Version 6.0
ICCPP200.MAK	- IBM C-Set C++ for OS/2 Version 2.0
WCCPP.MAK       - Watcom C++ Versions 9.5b and 10.0
posix.mak       - All Motif compilers
Makefile        - All Motif compilers
SCCPP700.scr    - AppleScript for Symantec for Macintosh Version 7.0
makefile.nxt	- NEXTSTEP

NOTE: The Symantec compiler for the Macintosh uses project files.  A
project file is provided with each example and tutorial program and for
the library.


---------------------------------------------------------------------
---- INSTALLATION ---------------------------------------------------
---------------------------------------------------------------------

To install Zinc Application Framework on systems running DOS, Windows,
or OS/2, insert the first "Zinc Engine" diskette into the desired drive
(e.g., drive A) and type:

  a:<Enter>
  install<Enter>

The installation program will ask you to select the drive to install
to as well as which parts of the Framework you wish to install.  The
install program requires 450K free memory.  Please refer to "Chapter 
1 - Installing Zinc" of the Getting Started manual for more information 
on installation procedures.

To install for Motif, refer to the file "motif.txt."

To install for Macintosh, refer to the file "mac.txt."

To install for NEXTSTEP, refer to the file "nextstep.txt"

---------------------------------------------------------------------
---- INTERNATIONAL LANGUAGE SUPPORT ---------------------------------
---------------------------------------------------------------------

The base product of Zinc supports multiple languages.  In this
release we have library support (dos_zil, win_zil, etc..) for the
following languages (data and source files located in the
\ZINC\BIN and \ZINC\SOURCE\INTL directories):

	Catalan 
	Danish  
	Dutch   
	English 
	Finnish 
	French  
	German  
	Greek   
	Italian
	Japanese
	Korean
	Norwegian
	Spanish 
	Swedish 

Other languages will be supported in the future.

Note: The Japanese and Korean language support requires the Unicode key.

The product also supports multiple locales (the locale affects
formatting for objects like dates, times, etc.).  In this release we
have support for the following locales:

	Austria        
	Canada (English, French)
	China          
	Denmark        
	Finland        
	France         
	Germany        
	Greece         
	Italy          
	Japan          
	Korea          
	Mexico         
	Netherlands    
	Norway
	Spain          
	Sweden         
	Taiwan         
	United Kingdom 
	United States  

For information on using the international language support features
of Zinc Application Framework 4.0, see "The Programmer's Reference 
Volume One."

Currently, the example programs, most tutorials, and Designer only 
run in English mode.  We hope to get other language support for these 
applications in the future.


---------------------------------------------------------------------
---- UNICODE SUPPORT ------------------------------------------------
---------------------------------------------------------------------

This version of Zinc runs in either an 8-bit standard mode (available
as the default in all previous versions of the library) or a Unicode 
mode.  Unicode mode requires the Unicode key.  Unicode mode is turned 
on by setting the ZIL_UNICODE switch located in the ui_env.hpp file 
and recompiling the library and your application.

Unicode modes of operation are Certified for the following
compiler/environment configurations:

    DOS:     1) Borland C++ Version 4.0
             2) Microsoft Visual C++ Version 1.5

    WINDOWS: 1) Borland C++ Version 4.0

    WIN32s:  1) Microsoft Visual C++ Version 1.0

    WINNT:   1) Microsoft Visual C++ Version 1.0

    OS/2:    1) IBM C-Set C++ Version 2.0

    Motif:   1) SunOS 5.2/Solaris 2.2, X11R5/Motif 1.2

As of this writing, we support the Unicode mode of operation on
most versions of DOS and DOS/V, most versions of Windows,
Windows NT, OS/2 J and Japanese Solaris 2.2.  Other systems will
be added.  Check with technical support for any additions.

NOTE:  When using Borland 3.1 or earlier with the NEC PC 9800 it may
be necessary to modify the startup code produced by the Borland
compiler.  If you have the Borland compiler for the NEC 9800
series you will not need to make any modifications to the startup
code.  Otherwise, the startup code makes several BIOS calls which will
produce undesired effects since the NEC PC 9800 is not
ISA-compatible.  The following steps can be taken to modify the
startup code:

    1) Locate the C0.ASM file.  This should be in the
       \BORLANDC\LIB\STARTUP directory.  Bring this file up in a text
       editor.

    2) At about line 310 there will be a comment that says
         ;prepare main arguments
       Comment out all lines after this comment to the line that says
         @@NotMidnight
       Do not comment out the "@@NotMidnight" line.

    3) Using the BUILD-CO.BAT file in that same directory, rebuild
       the C0.OBJ file and make sure it is placed in the
       \BORLANDC\LIB directory.

Most Zinc classes are derived, at one point or another, from the
ZIL_INTERNATIONAL base class.  You will find overloaded functions in
this class for standard ANSI ctype functions, file functions, and
string functions.  We were unable to convert ctype functions
(isupper, islower, etc.) because most libraries define them to be
#define macros.  Thus, alternate functions with a similar name are 
provided (isupper -> IsUpper, tolower -> ToLower, etc.).

The reason we overload ctype, string and file functions is to give
us an automatic inheritance capability of these functions for 8-bit
and 16-bit strings.  You may have noticed compiler vendors that
supply a strlen() and wstrlen() function.  We just overload the same
function to take either an 8-bit or 16-bit string.

The DOS Unicode font is in a file called UNICODE.FNT which ships with 
the Unicode key.  Some utilities and source files for use with the
UNICODE.FNT file are available on the BBS.  Call technical support
for assistance in obtaining these files.


---------------------------------------------------------------------
---- REPORTING PROBLEMS ---------------------------------------------
---------------------------------------------------------------------

If you are upgrading from Zinc Application Framework 3.6, you
should be able to re-compile and re-link your existing code with no
changes to your code if ZIL_OLD_DEFS is defined in ui_env.hpp. 
Refer to the file "upgrade.txt" for a list of changes made from 3.6
to 4.0.

If you do encounter a problem with the library, either in trying to
recompile your existing application or in trying to use some
functionality, please let us know about it.  We want to do everything 
we can to provide you with the best product possible.

When reporting a problem, please be as specific as possible in your
description of the problem.  The more details you can give us, the
more likely it is that we will be able to accurately reproduce the
problem and fix it.  At a minimum, in addition to the description of
the problem, we need to know which environment you were running in
(e.g., Windows, OS/2, etc.), which compiler you were using, and which 
version of the product--both the version number and the maintenance 
revision number--the problem was in.

The appropriate numbers/addresses for reporting problems are given 
below.

---------------------------------------------------------------------
---- CONTACTING ZINC ------------------------------------------------
---------------------------------------------------------------------

Zinc now has offices in North America, Europe, and Asia.  The 
addresses and phone numbers are:

World wide                Internet:          info@zinc.com
                                             tech@zinc.com
                          Ftp Server:        ftp.zinc.com
                          Web Server:        http://www.zinc.com/
                          CompuServe:        GO ZINC

North America             Zinc Software Incorporated
                          405 South 100 East, 2nd Floor
                          Pleasant Grove, UT 84062
                          Corporate Offices: +1 801 785 8900
                          Technical Support: +1 801 785 8998
                          FAX:               +1 801 785 8996
                          BBS:               +1 801 785 8997

Europe                    Zinc Software (UK) Limited
                          106-108 Powis Street
                          London, SE18 6LU United Kingdom
                          European Sales and 
                          Technical Support: +44 (0)181 855 9918
                          FAX:               +44 (0)181 316 7778
                          BBS:               +44 (0)181 317 2310

Asia                      Zinc Software (Japan)
                          1-10-26 Nakata Chikusaku
                          Nagoya, Japan 464
                          Asian Sales and Technical 
                          Support:           +81 (052) 733 4301
                          FAX:               +81 (052) 733 4328
                          BBS:               +81 (052) 733 4359


