GNAT User's Guide

GNAT, The GNU Ada 95 Compiler

Document revision level Document revision level 1.242 $

GNAT Version 3.12p

Date: $Date: 1999/06/28 18:09:34 $

• About This Guide
  • What This Guide Contains
  • What You Should Know Before Reading This Guide
  • Related Information
  • Conventions
• Getting Started With GNAT
  • Running GNAT
  • Running a Simple Ada Program
  • Running a Program With Multiple Units
  • Using the gnatmake Utility
• The GNAT Compilation Model
  • Source Representation
  • Foreign Language Representation
    • Latin-1
    • Other 8-Bit Codes
    • Wide Character Encodings
  • File Naming Rules
  • Using Other File Names
  • Generating Object Files
  • Source Dependencies
  • The Ada Library Information Files
  • Representation of Time Stamps
  • Binding an Ada Program
  • Mixed Language Programming
    • Interfacing to C
    • Calling Conventions
  • Building mixed Ada & C++ programs
    • Interfacing to C++
    • Linking a mixed C++ & Ada program
    • Adapting the runtime to a new C++ compiler
  • Comparison between GNAT and C/C++ Compilation Models
  • Comparison between GNAT and Conventional Ada Library Models
• Compiling Using gcc
  • Compiling Programs
  • Switches for gcc
    • Output and Error Message Control
    • Debugging and Assertion Control
    • Style Checking
    • Run-time Checks
    • Using gcc for Syntax Checking
    • Using gcc for Semantic Checking
    • Compiling Ada 83 Programs
    • Reference Manual Style Checking
    • Character Set Control
    • File Naming Control
    • Subprogram Inlining Control
    • Auxiliary Output Control
    • Debugging Control
  • Search Paths and the Run-Time Library (RTL)
  • Order of Compilation Issues
  • Examples
• Binding Using gnatbind
  • Running gnatbind
  • Consistency-Checking Modes
  • Binder Error Message Control
  • Elaboration Control
  • Output Control
  • Binding with Non-Ada Main Programs
  • Binding Programs with no Main Subprogram
  • Summary of Binder Switches
  • Command-Line Access
  • Search Paths for gnatbind
  • Examples of gnatbind Usage
• Linking Using gnatlink
  • Running gnatlink
  • Switches for gnatlink
• The GNAT Make Program gnatmake
  • Running gnatmake
  • Switches for gnatmake
  • Mode switches for gnatmake
  • Notes on the Command Line
  • How gnatmake Works
  • Examples of gnatmake Usage
  • Gnatmake in makefiles
• Renaming Files Using gnatchop
  • Handling Files with Multiple Units
  • Operating gnatchop in Compilation Mode
  • Command Line for gnatchop
  • Switches for gnatchop
  • Examples of gnatchop Usage
• Configuration Pragmas
  • Handling of Configuration Pragmas
  • The Configuration Pragmas file
• Elaboration Order Handling in GNAT
  • Elaboration Code in Ada 95
  • Checking the Elaboration Order in Ada 95
  • Controlling the Elaboration Order in Ada 95
  • Controlling Elaboration in GNAT - Internal Calls
  • Controlling Elaboration in GNAT - External Calls
  • Default Behavior in GNAT - Ensuring Safety
  • What to do if the Default Elaboration Behavior Fails
  • Elaboration for Access-to-Subprogram Values
  • Summary of Procedures for Elaboration Control
• The cross-referencing tools gnatxref and gnatfind
  • Gnatxref switches
  • Gnatfind switches
  • Project files
  • Regular expressions in gnatfind and gnatxref
  • Examples of gnatxref usage
    • General usage
    • Using gnatxref with vi
  • Examples of gnatfind usage
• File Name Krunching Using gnatkr
  • About gnatkr
  • Using gnatkr
  • Krunching Method
  • Examples of gnatkr Usage
• Preprocessing Using gnatprep
  • Using gnatprep
  • Switches for gnatprep
  • Form of definitions file
  • Form of input text for gnatprep
• The GNAT library browser gnatls
  • Running gnatls
  • Switches for gnatls
  • Example of gnatls Usage
• Rebuilding the GNAT Library
• Finding memory problems with gnatmem
  • Running gnatmem
  • Switches for gnatmem
  • Example of gnatmem Usage
  • Implementation note
• ASIS-Based Tools
  • The ASIS Implementation for GNAT (ASIS-for-GNAT)
  • Tree Files
• Creating Sample Bodies Using gnatstub
  • Running gnatstub
  • Switches for gnatstub
• Minimizing Executables for Ada Programs Using gnatelim
  • About gnatelim
  • Eliminate pragma
  • Preparing Tree and Bind Files for gnatelim
  • Running gnatelim
  • Correcting the List of Eliminate Pragmas
  • Making your Executables smaller
  • Summary of the gnatelim Usage Cycle
• Other Utility Programs
  • Using Other Utility Programs With GNAT
  • The gnatpsys Utility Program
  • The gnatpsta Utility Program
  • The External Symbol Naming Scheme of GNAT
  • Ada Mode for emacs
  • General features:
  • Ada mode features that help understanding code:
  • Emacs support for writing Ada code:
  • Converting Ada files to html using gnathtml
  • Installing gnathtml
• Running and Debugging Ada Programs
  • The GNAT Debugger GDB
  • Running GDB
  • Introduction to GDB Commands
  • Using Ada Expressions
  • Calling User-Defined Subprograms
  • Breaking on Ada Exceptions
  • Ada Tasks
  • Debugging Generic Units
  • GNAT Abnormal Termination
  • Naming Conventions for GNAT Source Files
  • Getting Internal Debugging Information
• Performance Considerations
  • Controlling Run-time Checks
  • Optimization Levels
  • Inlining of Subprograms
• Index

This document was generated on 2 July 1999 using the texi2html translator version 1.51.