This is the README file from the binary distribution of GNAT.

This directory contains the files needed for installing and running GNAT.
It includes the C compiler also.

INSTALLING

The quick way to install GNAT is to first run the script 'doconfig' contained
in this directory.  This will not modify any directories or files in your
system, but will create a file called 'doinstall'.  This is a script
containing the commands to actually do the installation according to the
configuration you choose when running 'doconfig'.  Run it to do the
installation.

USE

The main documentation for GNAT is the GNAT User's Guide and the GNAT Reference
Guide which can be found at the same location as the GNAT binaries and sources.
A much older and very brief guide can be found in this distribution called
gnatinfo.txt.

EXPLANATION of installation

Since GCC is normally built from sources, the procedures for installing
GCC can (and do) build default directory names into several of the
executables at the time of building and installation.  At present, it
is difficult to provide ways for modifying these directories in this
binary distribution.  Instead, the binaries here are built with the standard
defaults, and directions are provided for working with them even if
they cannot be installed in the standard locations.  The first option
in the configuration script places the binaries in the standard locations
assuming no existing GCC installation.

Having the files in the standard locations means that the programs can use
their builtin directory names to locate files that are needed.  For example,
the driver program (gcc) can find the directory containing the compilers
and the linker that it calls, and the Ada compiler can find the directories
containing the Run Time Library (RTL) sources and objects.  If the files
in this distribution cannot be installed in the standard locations, then
the programs cannot use the built in values, so the user defines environment
variables that the programs can use, or specifies directories on the command
lines of the various programs.  When choosing such an installation, 'doconfig'
will also generate a file containing csh commands to set the appropriate
environment variables.  For further explanation of using environment
variables or command line switches, see the documentation in 'gnatinfo.txt'.

If you cannot put things in standard directories, you will choose option
3 in the configuration script.  After installation, you can permanently
work with the installation you have done, or use this binary distribution
to build a distribution from the sources -- in which case, you will be
able to build in the directories that you choose.

The configuration program creates make commands to install the system.
The Makefile allows more flexibility than is utilized by 'doconfig'.
No more help is provided here -- you must know what you are doing --
except to suggest that a possibly helpful option would be to define
'bindir' separately on the make commmand line.

EXAMPLES

The examples directory contains simple examples.

MEMORY REQUIREMENTS
It is suggested that at least 64 megabytes of memory be available if GNAT is
going to be used to compile large programs.
