Preliminary note for Windows users
==================================

The build instructions for GPRBUILD may have a slight Unix flavor but they
can be used on Winodws platforms with a full
CYGWIN installation. The latter makes it simpler to build gprbuild but
is not required to use it.

Using alternate GNAT Sources
============================

gprbuild uses some sources of the GNAT package. They are found by
default in the gnat dir. If one want to use other GNAT sources, the
recommended procedure is to create a link called gnat_src and call the
Makefile target copy_gnat_src
   $ ln -s path_to_gnat_sources gnat_src
   $ make copy_gnat_src -f Makefile.in

Configuring
===========

You must install XML/Ada before compiling gprconfig.

Configuring is usually done simply as:
  ./configure
2 parameters may be worth specifying: --prefix for specifying the
installation root and --build for specifying the build host. In particular,
on Windows, when using cygwin to build, it is necessary to configure with
--build=pentium-mingw32msv if one wants to use mingw based compilers
such as GNAT Pro or GNAT GPL. Here is an example of such a command:
./configure --build=pentium-mingw32msv  --prefix=$HOME/local

Building and Installing
=======================

Building the main executables is done simply with
   make all

When compiling, you can choose whether you want to link statically with
XML/Ada (the default), or dynamically. To compile dynamically, you should
run
   make LIBRARY_TYPE=relocatable all
instead

Installation is done with
  make install

You can bootstrap grpbuild (compile it with itself) with the following command:
   make bootstrap

Doc & Examples
==============
The documention is provided in various formats in the doc subdir.
It refers to concrete examples that are to be found in the
examples directory.  Each example can be built easily using the
simple attached Makefile:
   make all    # build the example
   make run    # run the executable(s)
   make clean  # cleanup

all the examples can be built/run/cleaned using the same targets and
the toplevel examples Makefile
