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

The build instructions for gnatmem 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 gnatmem but is not required to use it.

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

In order to build gnatmem executable you need first to build the binutils.
Indeed gnatmem is linked with libbfd and libiberty. Note also that in order to
compile some of the gnatmem C sources, we need access to some headers present
in that build tree. For that reason, it's not possible to build gnatmem only
with a libbfd and libiberty install. Once the binutils are built, you should
invoke configure the following way:

  ./configure --with-binutils-buildtree=<path to the binutils build dir>

With that parameter, the configure script should find automatically the
location of the binutils sources. If not you can use --with-binutils-sources
to set that location.

Building
========

Building gnatmem is done simply by calling:

  make

The gnatmem executable will be then locating in the obj subdirectory.

Cleaning your build environment
===============================

You can clean your build directory by doing either make clean (keep result of
configure step) or make distclean (complete reset of the build directory).

Updating the gnatmem version
============================

The version displayed by gnatmem can be updated by doing:

  make update_version VERSION="my_version" STAMP="my_date"

Using GPS
=========

If you use GPS IDE to edit gnatmem, you just need to run the configuration
step in order to get the gnatmem.gpr project file generated. Note that you
can then use the GPS default build functionalities to build gnatmem (Makefile
if just a wrapper around gprbuild).

