GPR Reference Manual

Version 28.0w

Date: Oct 29, 2026

• Introduction
  • What is GPR?
  • Tools covered
  • Document structure
  • LibGPR2
  • Related documents

GPR Project Language

• Project File Language
  • Overview
  • Lexical Elements
  • Project File Structure
  • Declarations
  • Values
  • Built-in Functions
  • Expressions
  • Typed String Declaration
  • Variables
  • Attribute Declarations
  • Packages
  • Case Constructions
• Project Tree
  • Project tree structure
  • The with clause
  • The limited with clause
• Project Kinds
  • Formal syntax
  • Standard Project
  • Abstract Project
  • Library Project
  • Aggregate Project
  • Aggregate Library Project
  • Configuration Project
• Project Extension
  • Simple Extension
  • Extension Hierarchies
  • extends all
  • Restriction
• Source Resolution
  • Source discovery
  • Basename uniqueness
  • Extending projects and source shadowing
  • extends all
  • Multi-unit Ada sources
• Attributes
  • Project Level Attributes
  • Package Binder Attributes
  • Package Builder Attributes
  • Package Cargo Attributes
  • Package Clean Attributes
  • Package Compiler Attributes
  • Package Gnatls Attributes
  • Package Install Attributes
  • Package Linker Attributes
  • Package Naming Attributes

GPR Tools

• Knowledge Base
  • Embedded KB
  • KB structure
  • Target normalization
  • Run-time KB selection
  • Customizing the KB
  • KB validation
• Common Command-Line Options
  • Project file
  • Project and configuration switches
  • Output and diagnostics
• Out-of-Tree Builds
• GPRbuild Reference
  • Build Engine Selection
  • Command Line
  • Switches
  • Build Execution
  • Project package
  • Exit Codes
• GPRconfig Reference
  • Command Line
  • Switches
  • Interactive mode
  • Configuration file format
  • Exit Codes
• GPRclean Reference
  • Command Line
  • Switches
  • Project package
  • What is cleaned
  • Rust projects
  • Exit Codes
• GPRinstall Reference
  • Command Line
  • Operating modes
  • Switches
  • Installation layout
  • Project package
  • Exit Codes
• GPRname Reference
  • Command Line
  • Switches
  • Generated files
  • Exit Codes
• GPRls Reference
  • Command Line
  • Switches
  • Status indicators
  • Output layout
  • Exit Codes
• GPRinspect Reference
  • Command Line
  • Switches
  • Output structure
  • Exit Codes

Appendices

• Environment Variables
• Glossary
• GNU Free Documentation License