ZORTECH C++ 3.1
===============
Copyright (c) 1992 Symantec Corporation. All Rights Reserved.
December 3, 1992


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

     The Zortech C++ 3.1 installation program will work most efficiently if 
ran on a clean computer system.  It requires that at least 150K of memory be 
available at the time that it goes to copy diskettes.  If you do not have this 
much available, it will not operate.  The best thing to do is to is reboot 
your machine with clean system, and you should have no problems.  


Installing Zortech C++ 3.1 for DOS, WINDOWS 3.1, and OS/2 1.X
-------------------------------------------------------------

     The entire Zortech C++ development system takes up 31.2 Mg of disk space 
This installer will allow you to only select those portions of the Zortech C++ 
System that you need.  For detail on what is contained in this version please 
read the file "README.1ST" found on Disk #1.  


HOW YOU WOULD LIKE THE INSTALLER TO OPERATE
-------------------------------------------
              
    The first choice that the installer gives you is what "mode" you want 
the installer to operate in.  Selecting "M" at the prompt, informs the 
installer to install the minimal Zortech C++ System.  This will involve only
installing the system to compile for DOS, and the small memory model. This 
will take up only 8Mg of Disk Space.  Select this option if you want a 
minimal Zortech system.  Selecting "A" at this prompt, will cause the 
installer to go ahead and install the entire Zortech System.  This will take
up 30.5 Mg of disk space.  You should take care to make sure you have enough 
space to install prior to making this choice.  The final choice is "C".  
Select  "C" if you would like to go through a series of choices to selectively 
install the parts of the Zortech C++ System that you need.  This is the 
default option for installer program.  


SELECTING OPTIONS
-----------------

    If you chose to put the installer in selection mode, you will be asked 
to specify the options to be installed into your C++ programming system, as 
well as the drives to use.  A short explanation of each option will be 
displayed so that you may decide whether or not you require it to be 
installed.  When possible, the options will present to you the necessary disk 
space for that option.  


Zortech C++ For DOS
-------------------

    The first series of choices that you are presented concern the Zortech
C++ 3.1 Development System for DOS.  The first options is if you wish to 
install Zortech C++ for DOS.  Selecting Yes will inform the installer
to install the Zortech C++ DOS development system.  This includes the 
compiler (ZTC), Zortech Debugger for DOS (ZDB), and our Integrated WorkFrame 
(ZWB).  You should select yes if you plan to do any programming for DOS.  

    Zortech C++ contains support for 7 different memory models.  Each model
contains a different level of addressibilty, and hardware requirements.  You 
will be presented with a menu containing information for each model, including 
the amount of disk space required for the libraries etc. for that particular 
model.  Scroll through the options by pressing either the arrow keys, or the 
Spacebar.  To toggle an option, press the enter key (NOTE: an arrow next to a 
choice indicates that it will be installed).  Once you have chosen all the 
choices that you wish to install, select "Accept and Continue", and press 
return.  


Zortech C++ For WINDOWS 3.X
---------------------------

    The next series of choices concern the Zortech C++ 3.1 development 
system for Windows 3.X.  The first options is if you wish to install Zortech
C++ for Windows 3.X.  Selecting YES, will inform the installer to install
the Zortech C++ Windows 3.X development System.  Included with this system
are the  headers and libraries necessary to generate Windows 3.X
applications.  Also included is the Multiscope 2.0 Windows hosted debugger,
the Whitewater Resource Toolkit, and executables to run the Zortech C++ 
compiler (ZTC) and the Workbench (ZWB) from within Windows.  You should select 
yes if you plan to develop any Windows 3.X hosted applications.  

    Zortech C++ contains support for 4 different memory models for Windows
applications.  These models provide a different level of addressibilty, 
and hardware requirements.  You will be prevented with a menu describing
each model, along with the required disk space for the libraries etc. for 
that model.  Scroll through the menu choices by using the arrow keys or
spacebar.  Toggle a choice by pressing the enter key (NOTE: an arrow next to a 
choice indicates that choice will be installed).  Once you have made all you 
selections, select "Accept and Continue" and press return.  

     As part of the Zortech C++ 3.1 package, you receive the Multiscope 
Debuggers for Windows.  By selecting yes to install Windows 3.X support, you 
receive the Multiscope Windows Interface Debugger and Multiscope tutorials by 
default.  In addition to these, there are other versions of the Multiscope 
Debugger that you can install for debugging.  For details on these, please 
refer to the "Multiscope Debuggers User Manual" included in  your package.   

     Along with memory models  and Multiscope you also will have the choice of 
receiving documentation online for Windows. This is in the form of Windows 
help files.  These files  contain information from the "Zortech C++ Microsoft 
Windows Function Reference" as well as the "Zortech C++ Function Reference", 
and all the Multi-Media help files.  These files are very useful for viewing 
documentation online throught Windows Help.  These files are quite large, and 
take up 5 Mb of disk space.  

**NOTE**: The Windows help files will not be placed into the Zortech group by 
this version of the installer.  To add these too your group, simply add a new 
item to your shell as is documented in your shell's manual, using the form: 

   d:\winpath\winhelp.exe d:\zorpath\bindos\zcref.hlp

for the program command line.  The Windows help files are:

        mcistrwh.hlp            penapiwh.hlp
        win31mwh.hlp            win31wh.hlp
        zcppref.hlp             zcref.hlp
  
Zortech C++ For OS/2 1.X
------------------------

    The next series of choices concerns the Zortech C++ Development System for 
OS/2 1.X.  The first option is to ask if you wish to install Zortech C++ for 
OS/2 1.X.  Selecting YES, will inform the installer to install Zortech C++ for 
OS/2 1.X.  Including with this is the necessary headers and libraries to 
create OS/2 1.X executables.  You will also receive executables necessary to 
run the Workbench (ZWB) and our debugger (ZDB) from OS/2.  NOTE: there is no 
executables provided for the compiler for OS/2 1.X, to do command line 
compilation, you must do so from a DOS box.  

    Zortech C++ provides support for 2 different memory models for OS/2 1.X.  
Each memory model provides a different level of addressibility, and hardware 
requirements.  You will be presented with a menu containing complete 
descriptions for each model.  Scroll through the choices by pressing the arrow 
keys, or space bar.  Toggle a choice by pressing the return key. (NOTE: an 
arrow next to a model indicates that model will be installed.)  Once you have 
made all your choices, scroll to "Accept and Continue" and press return.  


Zortech C++ Tools and Library Source Code
-----------------------------------------

    The final 2 options contain choices to install the C++ Tools, and 
Library Source code.

    Zortech C++ contains a rich set of C++ Tools.  These tools are a set of 
class libraries that provide a useful set of low level programming structures 
and techniques.  For a complete list of what is contained, refer to the manual 
"C++ Tools".  Selecting YES, will cause the C++ Tools to be installed.  These 
are very useful libraries of container classes for Array Manipulation, etc.  
These come complete with full source code and libraries that you can link 
directly into your application.  This option takes up 2 Mg of disk space.  

    Zortech C++ also provides all the source code, and makefiles necessary to 
build its libraries.  These are useful for understanding how a particular 
routine operates, and for customizing the libraries for your needs.  It is 
usually not necessary to modify the standard libraries, thus, if you really do 
not need to customize anything, then you should select no to this prompt.  
These sources take up approximately 1.5 Mg of disk space.  

Copying Files
-----------------

    Based upon your selections, the installer will prompt you for the 
appropriate disks.  The installer will automatically copy and dearchive all 
necessary archives to your harddisk.  


Modifying Autoexec.bat
----------------------

     Zortech C++ makes use of 3 environment variables during its compilation 
process.  These variables contain paths for the compiler to search for 
included header files, linked in libraries, and for default arguements to pass 
to the command line compiler.  

     The installation program will modify your autoexec.bat automatically for 
you.  If you decide not to have it do so, it will create a temporary file for 
you called Sampauto.bat in the root Zortech directory for you to use as a 
guide to modify your own Autoexec.bat.  

Windows Setup
-------------
     
     As part of Zortech C++ 3.1, there are several executables that you can 
run from within Windows.  These are executables for the Multiscope Debuggers, 
the Zortech C++ Workbench, and the Zortech C++ command line compiler.  In 
order to use these under Windows, you need to create a group file for them.  
The installer will create these group files for you and install it into 
windows for you.  If you decide not to have it do so, then it will create a 
file titled Woodford on the root directory of your C drive.  (I know this name 
sounds kind of funny, but it has special meaning to the author of the 
installer).  This file will contain detailed instructions on how to create the 
group files yourself.  

     In order for the Multiscope Debuggers to work properly, there must be 
certain modifications done to your System.ini file.   As with Autoexec, the 
installer will modify this file for you.  If you choose not to have it do so, 
then the installer will create a sample called Sampsys.ini for you in the root 
Zortech Directory.  You should make the modifications depicted in this file, 
prior to attempting to use Multiscope under windows.  

     
In Closing
----------

     That's it.  You now have a brand new Zortech C++.  The directory Readme, 
contains the latest information concerning Zortech C++ 3.1.  You should refer 
to these files prior to using Zortech C++.  

Enjoy.

EOF
