GNATbench for Eclipse User’s Guide

• 1. Getting Started
  • 1.1. Prior Required Tool Installations
  • 1.2. Conflicting Plug-In Removal
  • 1.3. Installing GNATbench
  • 1.4. Before Browsing and Navigating the Code
  • 1.5. Verifying Correct GNATbench Installation
  • 1.6. Introduction
  • 1.7. Intended Audience
  • 1.8. Scope
  • 1.9. For Additional Information and Help
  • 1.10. Creating and Building A Basic Native Project
    • 1.10.1. Creating and Configuring the Project
    • 1.10.2. Building the Project
    • 1.10.3. Congratulations!
  • 1.11. Creating and Building An Embedded Computer Project
    • 1.11.1. Creating and Configuring the Project
    • 1.11.2. Modifying the GNAT Project File
    • 1.11.3. Importing the Script and Sources
    • 1.11.4. Adding A Command
    • 1.11.5. Invoking the User-Defined Command
    • 1.11.6. Building the Project
    • 1.11.7. Congratulations!
  • 1.12. Using GPRbuild To Build An Embedded Computer Project
    • 1.12.1. Creating and Configuring the Project
    • 1.12.2. Modifying the GNAT Project File
    • 1.12.3. The Source Files
    • 1.12.4. Modifying the Main Subprogram Source File
    • 1.12.5. Building the Project
    • 1.12.6. Congratulations!
• 2. Concepts
  • 2.1. GNAT Pro
    • 2.1.1. GNAT Projects
    • 2.1.2. Foreign Ada Source Files
    • 2.1.3. Project Files
    • 2.1.4. GNAT Project Manager
    • 2.1.5. Scenario Variables
  • 2.2. GNATbench
    • 2.2.1. Ada Perspective
    • 2.2.2. Ada Perspective Menus
    • 2.2.3. Ada Perspective Wizards
    • 2.2.4. GNATbench Project File Editor
    • 2.2.5. GNAT Project Properties Editor
    • 2.2.6. Outline View
    • 2.2.7. Scenario Variables View
    • 2.2.8. Call Hierarchy View
    • 2.2.9. GNAT Project Explorer
    • 2.2.10. Metrics View
    • 2.2.11. Opening GNATbench Views
    • 2.2.12. Ada Build Console
  • 2.3. Allocating Enough Memory and Solving OutOfMemoryErrors
• 3. Setting Preferences
  • 3.1. GNATbench Preferences
  • 3.2. Builder Targets
    • 3.2.1. The Targets Tree
    • 3.2.2. The Properties Dialog
    • 3.2.3. The Command Line Dialog
  • 3.3. Syntax Coloring
  • 3.4. Editors’ Font
  • 3.5. Coding Style
  • 3.6. Editor
  • 3.7. General Preferences
    • 3.7.1. Multi-language Builder
    • 3.7.2. Fast Project Loading
    • 3.7.3. Removal Policy When Fixing Code
  • 3.8. GNATbench Trace Log
  • 3.9. Toolchains
  • 3.10. External Commands
  • 3.11. Tools
• 4. Creating and Configuring Projects
  • 4.1. Importing Existing GNAT Projects
  • 4.2. Creating New Projects
    • 4.2.1. Invoking the New-Project Wizard
    • 4.2.2. Walking Through the Wizard Pages
  • 4.3. Creating New Ada Source Files
    • 4.3.1. Invoking the New-File Wizards
    • 4.3.2. New Ada Source File Wizard
    • 4.3.3. Linked Source Files
    • 4.3.4. Header Text Insertion
    • 4.3.5. File Naming Conformance
  • 4.4. Creating New Ada Source Folders
    • 4.4.1. Invoking the New-Folder Wizards
    • 4.4.2. New Ada Source Folder Wizard
  • 4.5. Converting Existing Projects To GNATbench
  • 4.6. Using Non-Default Ada Source File Names
    • 4.6.1. Specifying the Naming Scheme In the Project File
    • 4.6.2. Associating the File Name Extension with the Ada Editor
• 5. Browsing and Navigation
  • 5.1. Crucial Setup Requirement
    • 5.1.1. The cross-reference database
    • 5.1.2. Cross-references and partially compiled projects
  • 5.2. Browsing via Source Code Hyperlinks
    • 5.2.1. Configuring C/C++ Source Code Hyperlinks navigation
  • 5.3. Editor Tooltips
  • 5.4. Visiting Declarations and Bodies
  • 5.5. Visiting Declaration and Body Files
  • 5.6. Traversing Within Source Files
  • 5.7. Browsing via Reference Searching
    • 5.7.1. Advanced Options
• 6. Developing Ada Source Code
  • 6.1. Language-Sensitive Editing
    • 6.1.1. Invoking the Ada Language-Sensitive Editor
    • 6.1.2. Syntax Coloring
    • 6.1.3. Formatting Source Code
    • 6.1.4. Block Folding
    • 6.1.5. Managing Comments
    • 6.1.6. Parentheses Highlighting
    • 6.1.7. Automatic Construct Closing
    • 6.1.8. Smart Enter Key
    • 6.1.9. Smart Space Key
    • 6.1.10. Smart Tab Key
    • 6.1.11. Smart Home Key
    • 6.1.12. Smart End Key
  • 6.2. Code Assist
    • 6.2.1. Code Assist
    • 6.2.2. Enabling Code Assist
    • 6.2.3. Invoking Code Assist
    • 6.2.4. Simple Name Completion
    • 6.2.5. Dotted Name Completion
    • 6.2.6. Formal Parameter Completion
    • 6.2.7. Limitations
    • 6.2.8. Ada Templates
  • 6.3. Quick Fix
• 7. Building
  • 7.1. Project Builder Command Menus
    • 7.1.1. Project Menu
    • 7.1.2. Contextual Menus
  • 7.2. Project Builder Command Semantics
    • 7.2.1. Standard Eclipse Build Commands
    • 7.2.2. GNATbench Project-Specific Builder Commands
  • 7.3. Project Builder Key Bindings
  • 7.4. About the Build Automatically Option…
  • 7.5. Ada Build Console
  • 7.6. Compiling Individual Files
    • 7.6.1. Within the Ada Editor
    • 7.6.2. Within the GNAT Project Explorer
  • 7.7. Analyzing Individual Files
  • 7.8. Removing Compilation Artifacts
  • 7.9. Building Projects with Scenarios
  • 7.10. Cross Compiling
  • 7.11. Using Multiple Toolchains
  • 7.12. Building with Makefiles
    • 7.12.1. Modifying the “make” utility name
    • 7.12.2. Modifying the Makefile
    • 7.12.3. Makefile Name and Location
  • 7.13. User-Defined Builder Commands
    • 7.13.1. Defining Commands
    • 7.13.2. Invoking User-Defined Commands
  • 7.14. Build Mode
  • 7.15. Build Menu
    • 7.15.1. Check Syntax
    • 7.15.2. Check Semantic
    • 7.15.3. Compile File
    • 7.15.4. Project
    • 7.15.5. Clean
    • 7.15.6. Run
  • 7.16. Troubleshooting Builder Problems
    • 7.16.1. Eclipse and CDT Version Mismatch or Missing
    • 7.16.2. Conflicting Plug-Ins
• 8. Executing
  • 8.1. Creating Launch Configurations for Native Ada Applications
    • 8.1.1. Creating A C++ Launch Configuration
    • 8.1.2. Creating an External Tools Launch Configuration
  • 8.2. Executing Native Ada Applications
    • 8.2.1. Using A C++ Launch Configuration
    • 8.2.2. Using An External Tool Launch Configuration
  • 8.3. Executing Embedded Ada Applications
• 9. Debugging
  • 9.1. Introduction to Debugging with GNATbench
    • 9.1.1. Preparing to Debug
    • 9.1.2. Other Resources
    • 9.1.3. Overview
  • 9.2. Creating A Debug Configuration
    • 9.2.1. Quick Configuration Creation
  • 9.3. Launching A Debug Session
    • 9.3.1. Potential Trouble
    • 9.3.2. Build Prior to Launch
  • 9.4. Setting Breakpoints
  • 9.5. Breaking On Exceptions
  • 9.6. Controlling Execution
  • 9.7. Examining Data
    • 9.7.1. Examining Variables Declared in Subprograms and Tasks
    • 9.7.2. Examining Variables Declared in Packages
  • 9.8. Debugging Tasks
  • 9.9. Ending A Debug Session
  • 9.10. Using the GNAT Studio Debugger
  • 9.11. Troubleshooting
• 10. Tool Integrations
  • 10.1. Pretty Printer
  • 10.2. Metrics Analysis
    • 10.2.1. Controls
    • 10.2.2. Results
  • 10.3. Style Checking
    • 10.3.1. Controls
    • 10.3.2. Results
• 11. Using AJIS
  • 11.1. Creating and Building an AJIS Project
    • 11.1.1. Audience
    • 11.1.2. Before You Begin
    • 11.1.3. Create an Ada Project for AJIS
    • 11.1.4. Final Project Setup Steps
    • 11.1.5. Building the Ada Project
  • 11.2. Using AJIS Examples
    • 11.2.1. Before You Begin
    • 11.2.2. Import AJIS examples for GNATbench projects into workspace
    • 11.2.3. Build AJIS examples for GNATbench projects
    • 11.2.4. Run or Debug AJIS examples for GNATbench projects
  • 11.3. Using the AJIS Integration
    • 11.3.1. Installing the Required Tools
    • 11.3.2. Creating a Library and Sources
    • 11.3.3. Using the Library and Java Sources
  • 11.4. Manual Configuration of Java Build Path
    • 11.4.1. Setup
    • 11.4.2. Teardown
  • 11.5. Usage Notes
    • 11.5.1. Versions
    • 11.5.2. Modifying the Ada Sources
    • 11.5.3. Exporting the Java Project
    • 11.5.4. Optional additional arguments to ada2java
    • 11.5.5. Cleaning
    • 11.5.6. Limitations
• 12. Developing Ada Applications for QNX
  • 12.1. Creating QNX projects containing Ada code
    • 12.1.1. Audience
    • 12.1.2. Before You Begin
    • 12.1.3. Create the Empty QNX Project that will contain Ada code
    • 12.1.4. Convert the empty QNX project to use Ada language
• 13. Developing Ada Applications for DDC-I Deos
  • 13.1. Installing GNATbench
    • 13.1.1. Requirements
    • 13.1.2. Downloading GNATbench
    • 13.1.3. Installing
    • 13.1.4. Documentation
  • 13.2. Creating an Ada Application for Deos Processes
    • 13.2.1. Create a new DDC-I Executable Project
    • 13.2.2. Convert DDC-I Executable Project
    • 13.2.3. Add Deos Component Dependencies
    • 13.2.4. Deos Process Developer XML file
    • 13.2.5. Build the project
    • 13.2.6. Create the DDC-I Deos Platform Project
    • 13.2.7. Run the Deos project
  • 13.3. Creating an Ada 653 Partition
    • 13.3.1. Create a new DDC-I Executable Project
    • 13.3.2. Convert DDC-I Executable Project
    • 13.3.3. Add Deos Component Dependencies
    • 13.3.4. Deos Feature Provider XML file
    • 13.3.5. Build the project
    • 13.3.6. Create the Deos 653 Configuration Project
    • 13.3.7. Update the Deos Component Dependencies
    • 13.3.8. Create the Deos 653 Configuration File
    • 13.3.9. Create the DDC-I Deos Platform Project
    • 13.3.10. Run the Deos project
• 14. Developing Ada Applications in Xilinx Vitis
  • 14.1. Installing GNATbench
    • 14.1.1. Requirements
    • 14.1.2. Downloading GNATbench
    • 14.1.3. Installing
  • 14.2. Creating an Ada Application in Xilinx Vitis
    • 14.2.1. Create a new Platform Project
    • 14.2.2. Create a new Application Project
    • 14.2.3. Convert the Application Project
    • 14.2.4. Build the Project
    • 14.2.5. Running and Debugging the Project

Version 26.0.20250724.w

Date: 2025-07-25

Copyright (c) 2006-2025 AdaCore

This document may be copied, in whole or in part, in any form or by any means, as is or with alterations, provided that (1) alterations are clearly marked as alterations and (2) this copyright notice is included unmodified in any copy.