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

The build instructions for gprbuild may have a slight UNIX flavor but they
can be used on Windows 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 subdirectory. In order to use GNAT sources from another location,
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

Two 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 of the above.

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 subdirectory.
It refers to concrete examples that are to be found in the
examples subdirectory. 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.