
              GNAT v3.12p for OS/2 - Installation README
              ------------------------------------------

Welcome to GNAT for OS/2*. GNAT is an industrial-quality Ada 95 compiler, 
integrated into the GCC retargetable compiler system. GNAT is not public 
domain software. GNAT, like GCC, is covered by the GPL (GNU Public License). 
For more information see the documentation in gnatinfo.txt.

GNAT was originally developed by the GNAT team at New York University.
It is now maintained by Ada Core Technologies Inc (http://www.gnat.com).
If you intend to evaluate GNAT for industrial or commercial use please get 
in touch with `sales@gnat.com'.

This file contains information you need to install GNAT, and 
additional information not included in the product documentation.

This README file is divided into the following sections:
   -  Before You Install GNAT
       -Software Requirements
       -Hardware Requirements
   -  Getting Help
   -  Installing GNAT
   -  Late-Breaking News
   -  Your Comments
   -  Trademarks

Before You Install GNAT
-----------------------

   Software Requirements
   ---------------------
   
   The following software should be installed in order to use GNAT:
      * OS/2* v3.0 or later, including these components
         - Presentation Manager*
   Versions of OS/2 before v3.0 might also work but have not been
   tested. Version v4.0 of OS/2 has been tested with GNAT.

   The following files should be copied to the installation
   directory before installation:
      gnat-3.12p-os2-bin.zip - GNAT v3.12p binary distribution
      emxrt.zip	             - EMX v0.9d archives
      emxdev1.zip	     - EMX v0.9d archives
      emxdev2.zip	     - EMX v0.9d archives
      gnudev1.zip	     - EMX v0.9d archives
      gnudev2.zip	     - EMX v0.9d archives

   The emx*.zip and gnu*.zip archives contain the original EMX v0.9d
   distribution as distributed on the ftp sites listed below.

   The GNAT distribution is available at:
      ftp://cs.nyu.edu/pub/gnat 
   The original EMX v0.9d release is available at:
      ftp://ftp.leo.org/pub/comp/os/os2/devtools/emx+gcc
      ftp://ftp.leo.org/pub/comp/os/os2/leo/gnu/emx+gcc/
      ftp://ftp-os2.cdrom.com/pub/os2/emx09d/
      ftp://ftp-os2.nmsu.edu/pub/os2/dev/emx/v0.9d/

   Please make sure you have the correct versions of the ZIP-files 
   before trying to install. 
   Spaces or special characters in directory names are not supported.

   When you are already using a previous EMX, make sure no programs using one
   of the EMX executables or DLLs are running when installing GNAT. 

   Hardware Requirements
   ---------------------
   The free diskspace requirements for each component are listed
   below. 
   
   Component            Size 
    * EMX 0.9d           - 10.0 MB
    * GNAT v3.12p        - 13.4 MB  (also requires EMX 0.9d)

   Depending on usage you will also need 10 to 20 MB extra
   virtual memory for compiling Ada programs. Make sure the
   partition containing the OS/2 swap file (SWAPPER.DAT) has 
   enough free space. Although there is no clear minimum, 32 MB 
   or more physical memory is recommended for using GNAT.

Getting Help
------------

   1. Documentation

   Please be sure to read the documentation, including README files, 
   before reporting problems.
   
   2. Service and Technical Support

   For the GNAT compiler technical support is available from
   Ada Core Technologies on a commercial basis. Mail to
   sales@gnat.com for more information.

   3. Defect Reporting

   When you do have any problems with this product, please make sure
   you've followed all instructions and have correctly installed all
   required software (check the versions). Also check that you 
   correctly updated your CONFIG.SYS when you chose not to let the 
   installation program do it for you.

   If the problem still persists you should mail a problem report 
   to report@gnat.com. When installation did fail, please include a 
   directory listing of your EMX, GNAT and installation directories 
   and a copy of your CONFIG.SYS. Otherwise see the GNAT User's
   Manual for details on reporting bugs.

   Note that for unsupported users there is no guarantee that
   the bug report will be responded to.


Installing GNAT
---------------
When you have checked the software requirements including the
presence of all needed archives (see above), you can extract 
the installation files by typing the following commands from
the drive where you want to install GNAT and EMX:
   unzip emxdev1.zip
   unzip emxdev2.zip
   unzip emxrt.zip
   unzip gnudev1.zip
   unzip gnudev2.zip
   unzip gnat-3.12p-os2-bin.zip

When unzipping the last file, you will be asked whether you want
to overwrite gcov.exe and gdb.exe. Anser both questions with yes
to get the Ada aware versions.

As last step you need to set the following environment variables
in CONFIG.SYS:
   SET ADA_INCLUDE_PATH=x:\emx\gnatlib
   SET ADA_OBJECTS_PATH=x:\emx\gnatlib
   LIBPATH=x:\emx\dll;...    (add original contents on the dots)
   PATH=x:\emx\bin;...    (add original contents on the dots)
   SET C_INCLUDE_PATH=x:/emx/include
   SET LIBRARY_PATH=x:/emx/lib;... (add original contents, if any, on the dots)

Trademarks
----------
Terms marked with a * are trademarks of International Business Machines, Inc.
