4.3.10 Compiling Different Versions of Ada

The switches described in this section allow you to explicitly specify the version of the Ada language that your programs are written in. The default mode is Ada 2012, but you can also specify Ada 95, Ada 2005 mode, or indicate Ada 83 compatibility mode.

-gnat83 (Ada 83 Compatibility Mode)

Although GNAT is primarily an Ada 95 / Ada 2005 compiler, this switch specifies that the program is to be compiled in Ada 83 mode. With -gnat83, GNAT rejects most post-Ada 83 extensions and applies Ada 83 semantics where this can be done easily. It is not possible to guarantee this switch does a perfect job; some subtle tests, such as are found in earlier ACVC tests (and that have been removed from the ACATS suite for Ada 95), might not compile correctly. Nevertheless, this switch may be useful in some circumstances, for example where, due to contractual reasons, existing code needs to be maintained using only Ada 83 features.

With few exceptions (most notably the need to use <> on unconstrained generic formal parameters, the use of the new Ada 95 / Ada 2005 reserved words, and the use of packages with optional bodies), it is not necessary to specify the -gnat83 switch when compiling Ada 83 programs, because, with rare exceptions, Ada 95 and Ada 2005 are upwardly compatible with Ada 83. Thus a correct Ada 83 program is usually also a correct program in these later versions of the language standard. For further information please refer to the ‘Compatibility and Porting Guide’ chapter in the GNAT Reference Manual.

-gnat95 (Ada 95 mode)

This switch directs the compiler to implement the Ada 95 version of the language. Since Ada 95 is almost completely upwards compatible with Ada 83, Ada 83 programs may generally be compiled using this switch (see the description of the -gnat83 switch for further information about Ada 83 mode). If an Ada 2005 program is compiled in Ada 95 mode, uses of the new Ada 2005 features will cause error messages or warnings.

This switch also can be used to cancel the effect of a previous -gnat83, -gnat05/2005, or -gnat12/2012 switch earlier in the command line.

-gnat05 or -gnat2005 (Ada 2005 mode)

This switch directs the compiler to implement the Ada 2005 version of the language, as documented in the official Ada standards document. Since Ada 2005 is almost completely upwards compatible with Ada 95 (and thus also with Ada 83), Ada 83 and Ada 95 programs may generally be compiled using this switch (see the description of the -gnat83 and -gnat95 switches for further information).

-gnat12 or -gnat2012 (Ada 2012 mode)

This switch directs the compiler to implement the Ada 2012 version of the language (also the default). Since Ada 2012 is almost completely upwards compatible with Ada 2005 (and thus also with Ada 83, and Ada 95), Ada 83 and Ada 95 programs may generally be compiled using this switch (see the description of the -gnat83, -gnat95, and -gnat05/2005 switches for further information).

-gnat2022 (Ada 2022 mode)

This switch directs the compiler to implement the Ada 2022 version of the language.

-gnatX0 (Enable GNAT Extensions)

This switch directs the compiler to implement the latest version of the language (currently Ada 2022) and also to enable certain GNAT implementation extensions that are not part of any Ada standard. For a full list of these extensions, see the GNAT reference manual, Pragma Extensions_Allowed.

-gnatX (Enable core GNAT Extensions)

This switch is similar to -gnatX0 except that only some, not all, of the GNAT-defined language extensions are enabled. For a list of the extensions enabled by this switch, see the GNAT reference manual Pragma Extensions_Allowed and the description of that pragma’s “On” (as opposed to “All”) argument.