This is the core module of the GNAT Components Collection. Please refer to the documentation in the docs/ directory.

Build status with GNAT GPL 2017

Platform	Status
Linux
Windows

GNATCOLL only depends on a recent GNAT compiler. Building it also requires GPRbuild.

The following variables can be used to configure the build process:

General:

• prefix: location of the installation, the default is the running GNAT installation root.

• BUILD: control the build options: PROD (default) or DEBUG

• PROCESSORS : parallel compilation (default is 0, which uses all available cores)

• TARGET: for cross-compilation, auto-detected for native platforms

• SOURCE_DIR: for out-of-tree build

• INTEGRATED: treat prefix as compiler installation (yes/no) this is so that installed gnatcoll project can later be referenced as predefined project of this compiler; this adds a normalized target subdir to prefix default is "no"

Module-specific:

• GNATCOLL_MMAP: whether MMAP is supported (yes/no) default is "yes"; has no effect on Windows
• GNATCOLL_MADVISE: whether MADVISE is supported (yes/no) default is "yes"; has no effect on Windows

To use the default options:

$ make setup

For example, to setup GNATcoll to install a debug version in /opt/libgnatcoll:

$ make prefix=/opt/libgnatcoll BUILD=DEBUG install

Building all versions of the GNATCOLL Core Packages (static, relocatable and static-pic) is as easy as running make in the top directory. Then, to install it:

$ make install

Note that underneath, this Makefile uses a GPR project file: gnatcoll.gpr. You can build GNATCOLL using it with GPRbuild, but make sure to use the same command-line options.

Please send questions and bug reports to [email protected] following the same procedures used to submit reports with the GNAT toolset itself.