GPRbuild and GPR Companion Tools User’s Guide

Version 23.0w

Date: Oct 26, 2021

AdaCore

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled GNU Free Documentation License.

• 1. Introduction
• 2. GNAT Project Manager
  • 2.1. Introduction
  • 2.2. Building with Projects
    • 2.2.1. Source Files and Directories
    • 2.2.2. Duplicate Sources in Projects
    • 2.2.3. Object and Exec Directory
    • 2.2.4. Main Subprograms
    • 2.2.5. Tools Options in Project Files
    • 2.2.6. Compiling with Project Files
    • 2.2.7. Executable File Names
    • 2.2.8. Using Variables to Avoid Duplication
    • 2.2.9. Naming Schemes
  • 2.3. Organizing Projects into Subsystems
    • 2.3.1. Importing Projects
    • 2.3.2. Cyclic Project Dependencies
    • 2.3.3. Sharing between Projects
    • 2.3.4. Global Attributes
  • 2.4. Scenarios in Projects
  • 2.5. Library Projects
    • 2.5.1. Building Libraries
    • 2.5.2. Using Library Projects
    • 2.5.3. Stand-alone Library Projects
    • 2.5.4. Installing a Library with Project Files
  • 2.6. Project Extension
    • 2.6.1. Importing and Project Extension
  • 2.7. Child Projects
  • 2.8. Aggregate Projects
    • 2.8.1. Building all main programs from a single project closure
    • 2.8.2. Building a set of projects with a single command
    • 2.8.3. Defining a build environment
    • 2.8.4. Improving builder performance
    • 2.8.5. Syntax of aggregate projects
    • 2.8.6. package Builder in aggregate projects
  • 2.9. Aggregate Library Projects
    • 2.9.1. Building aggregate library projects
    • 2.9.2. Syntax of aggregate library projects
  • 2.10. Project File Reference
    • 2.10.1. Project Declaration
    • 2.10.2. Qualified Projects
    • 2.10.3. Declarations
    • 2.10.4. Packages
    • 2.10.5. Expressions
    • 2.10.6. Built-in Functions
    • 2.10.7. Typed String Declaration
    • 2.10.8. Variables
    • 2.10.9. Case Constructions
    • 2.10.10. Attributes
  • 2.11. Glossary
• 3. Building with GPRbuild
  • 3.1. Introduction
  • 3.2. Command Line
  • 3.3. Switches
  • 3.4. Initialization
  • 3.5. Compilation of one or several sources
  • 3.6. Compilation Phase
  • 3.7. Post-Compilation Phase
  • 3.8. Linking Phase
  • 3.9. Distributed compilation
    • 3.9.1. Introduction to distributed compilation
    • 3.9.2. Setup build environments
    • 3.9.3. GPRslave
• 4. GPRbuild Companion Tools
  • 4.1. Configuring with GPRconfig
    • 4.1.1. Configuration
    • 4.1.2. Using GPRconfig
    • 4.1.3. The GPRconfig knowledge base
  • 4.2. Configuration File Reference
    • 4.2.1. Project Level Configuration Attributes
    • 4.2.2. Package Naming
    • 4.2.3. Package Builder
    • 4.2.4. Package Compiler
    • 4.2.5. Package Binder
    • 4.2.6. Package Linker
  • 4.3. Cleaning up with GPRclean
    • 4.3.1. Switches for GPRclean
  • 4.4. Installing with GPRinstall
    • 4.4.1. Switches for GPRinstall
  • 4.5. Specifying a Naming Scheme with GPRname
    • 4.5.1. Running gprname
    • 4.5.2. Switches for GPRname
    • 4.5.3. Example of gprname Usage
  • 4.6. The Library Browser GPRls
    • 4.6.1. Running gprls
    • 4.6.2. Switches for GPRls
    • 4.6.3. Examples of gprls Usage

• GNU Free Documentation License