From 637535d736f4d09948b1d86495487c617cfc98f7 Mon Sep 17 00:00:00 2001 From: Arnaud Charlet Date: Thu, 12 Nov 2015 12:03:35 +0100 Subject: [PATCH] gnat_rm.texi, [...]: Update documentation. * gnat_rm.texi, gnat_ugn.texi, doc/gnat_ugn/platform_specific_information.rst, doc/gnat_ugn/gnat_and_program_execution.rst, doc/gnat_ugn/the_gnat_compilation_model.rst, doc/gnat_rm/standard_and_implementation_defined_restrictions.rst, doc/gnat_rm/implementation_defined_pragmas.rst: Update documentation. From-SVN: r230232 --- .../implementation_defined_pragmas.rst | 19 +- ...nd_implementation_defined_restrictions.rst | 38 +- .../gnat_ugn/gnat_and_program_execution.rst | 2 +- .../platform_specific_information.rst | 307 ++-- .../gnat_ugn/the_gnat_compilation_model.rst | 2 +- gcc/ada/gnat_rm.texi | 1291 +++++++++-------- gcc/ada/gnat_ugn.texi | 367 +++-- 7 files changed, 1186 insertions(+), 840 deletions(-) diff --git a/gcc/ada/doc/gnat_rm/implementation_defined_pragmas.rst b/gcc/ada/doc/gnat_rm/implementation_defined_pragmas.rst index 7bde3f38f29..4984d832d9d 100644 --- a/gcc/ada/doc/gnat_rm/implementation_defined_pragmas.rst +++ b/gcc/ada/doc/gnat_rm/implementation_defined_pragmas.rst @@ -4456,7 +4456,7 @@ the effect is identical to the following Ada 2012 code: Dynamic_Predicate => F(Q) or G(Q); -Note that there is are no pragmas `Dynamic_Predicate` +Note that there are no pragmas `Dynamic_Predicate` or `Static_Predicate`. That is because these pragmas would affect legality and semantics of the program and thus do not have a neutral effect if ignored. @@ -4471,6 +4471,23 @@ fundamentally changed (for example a membership test defined for subtype B). When following this approach, the use of predicates should be avoided. +Pragma Predicate_Failure +======================== + +Syntax: + + +:: + + pragma Predicate_Failure + ([Entity =>] type_LOCAL_NAME, + [Message =>] String_Expression); + + +The `Predicate_Failure` pragma is intended to be an exact replacement for +the language-defined +`Predicate_Failure` aspect, and shares its restrictions and semantics. + Pragma Preelaborable_Initialization =================================== diff --git a/gcc/ada/doc/gnat_rm/standard_and_implementation_defined_restrictions.rst b/gcc/ada/doc/gnat_rm/standard_and_implementation_defined_restrictions.rst index c820cb7877d..621f0208e9b 100644 --- a/gcc/ada/doc/gnat_rm/standard_and_implementation_defined_restrictions.rst +++ b/gcc/ada/doc/gnat_rm/standard_and_implementation_defined_restrictions.rst @@ -261,7 +261,7 @@ The following example indicates constructs that violate this restriction. null; end if; end Example; - + No_Dynamic_Attachment --------------------- @@ -319,7 +319,7 @@ must define with the following profile: (Source_Location : System.Address; Line : Integer); pragma Export (C, Last_Chance_Handler, "__gnat_last_chance_handler"); - + The parameter is a C null-terminated string representing a message to be associated with the exception (typically the source location of the raise @@ -367,19 +367,19 @@ chapter 7.6 of the Ada 2005 RM as well as all form of code generation performed by the compiler to support these features. The following types are no longer considered controlled when this restriction is in effect: -* +* `Ada.Finalization.Controlled` -* +* `Ada.Finalization.Limited_Controlled` -* +* Derivations from `Controlled` or `Limited_Controlled` -* +* Class-wide types -* +* Protected types -* +* Task types -* +* Array and record types with controlled components The compiler no longer generates code to initialize, finalize or adjust an @@ -844,7 +844,7 @@ example, if the source contains a declaration: .. code-block:: ada Val : constant Integer := X; - + where X is not a static constant, it may be possible, depending on complex optimization circuitry, for the compiler to figure @@ -857,6 +857,21 @@ Note that this the implementation of this restriction requires full code generation. If it is used in conjunction with "semantics only" checking, then some cases of violations may be missed. +No_Dynamic_Sized_Objects +-------------- +.. index:: No_Dynamic_Sized_Objects + +[GNAT] This restriction disallows certain constructs that might lead to the +creation of dynamic-sized composite objects (or array or discriminated type). +An array subtype indication is illegal if the bounds are not static +or references to discriminants of an enclosing type. +A discriminated subtype indication is illegal if the type has +discriminant-dependent array components or a variant part, and the +discriminants are not static. In addition, array and record aggregates are +illegal in corresponding cases. Note that this restriction does not forbid +access discriminants. It is often a good idea to combine this restriction +with No_Secondary_Stack. + No_Entry_Queue -------------- .. index:: No_Entry_Queue @@ -960,7 +975,7 @@ SPARK restriction have the form: violation of restriction "SPARK_05" at - + .. index:: SPARK @@ -1097,4 +1112,3 @@ currently checked by the SPARK_05 restriction: Note that if a unit is compiled in Ada 95 mode with the SPARK restriction, violations will be reported for constructs forbidden in SPARK 95, instead of SPARK 2005. - diff --git a/gcc/ada/doc/gnat_ugn/gnat_and_program_execution.rst b/gcc/ada/doc/gnat_ugn/gnat_and_program_execution.rst index 6f33d0b4ce3..892ac5761cf 100644 --- a/gcc/ada/doc/gnat_ugn/gnat_and_program_execution.rst +++ b/gcc/ada/doc/gnat_ugn/gnat_and_program_execution.rst @@ -3884,7 +3884,7 @@ execution of this erroneous program: it to obtain accurate dynamic memory usage history at a minimal cost to the execution speed. Note however, that `gnatmem` is not supported on all platforms (currently, it is supported on AIX, HP-UX, GNU/Linux, Solaris and - Windows NT/2000/XP (x86). + Windows. The `gnatmem` command has the form diff --git a/gcc/ada/doc/gnat_ugn/platform_specific_information.rst b/gcc/ada/doc/gnat_ugn/platform_specific_information.rst index b31670c6125..f8ba2aae059 100644 --- a/gcc/ada/doc/gnat_ugn/platform_specific_information.rst +++ b/gcc/ada/doc/gnat_ugn/platform_specific_information.rst @@ -1,7 +1,7 @@ .. -- Non-breaking space in running text -- E.g. Ada |nbsp| 95 -.. |nbsp| unicode:: 0xA0 +.. |nbsp| unicode:: 0xA0 :trim: .. _Platform_Specific_Information: @@ -155,8 +155,8 @@ For example on x86-linux:: -- +--- adainclude -- | -- +--- adalib - - + + If the *rts-sjlj* library is to be selected on a permanent basis, these soft links can be modified with the following commands: @@ -166,7 +166,7 @@ these soft links can be modified with the following commands: $ rm -f adainclude adalib $ ln -s rts-sjlj/adainclude adainclude $ ln -s rts-sjlj/adalib adalib - + Alternatively, you can specify :file:`rts-sjlj/adainclude` in the file :file:`$target/ada_source_path` and :file:`rts-sjlj/adalib` in :file:`$target/ada_object_path`. @@ -267,7 +267,7 @@ to one of the following: *-2* Use the default configuration (run the program on all available processors) - this is the same as having `GNAT_PROCESSOR` unset - *-1* Let the run-time implementation choose one processor and run the + *-1* Let the run-time implementation choose one processor and run the program on that processor *0 .. Last_Proc* Run the program on the specified processor. `Last_Proc` is equal to `_SC_NPROCESSORS_CONF - 1` @@ -318,7 +318,7 @@ platforms. the installation path and similar information, and then guides you through the installation process. It is also possible to perform silent installations using the command-line interface. - + In order to install one of the GNAT installers from the command line you should pass parameter `/S` (and, optionally, `/D=`) as command-line arguments. @@ -332,7 +332,7 @@ platforms. :: gnatpro-7.0.2-i686-pc-mingw32-bin.exe /S - + To install into a custom directory, say, `C:\\TOOLS\\GNATPRO\\7.0.2`: :: @@ -347,7 +347,7 @@ platforms. :: gnat-gpl-2012-i686-pc-mingw32-bin /S /D=C:\GNAT\2012 - + .. only:: PRO or GPL You can use the same syntax for all installers. @@ -436,7 +436,7 @@ called :file:`c-drive` on a machine :file:`LOKI`, the following command will make it available: :: - + $ path \\loki\c-drive\gnat\bin;%path%` Be aware that every compilation using the network installation results in the @@ -462,7 +462,7 @@ the *-mwindows* linker option must be specified. :: $ gnatmake winprog -largs -mwindows - + .. _Temporary_Files: Temporary Files @@ -542,7 +542,7 @@ setup the SEH context. For this the C main must looks like this: adafinal(); } - + Note that this is not needed on x86_64-windows where the Windows native SEH support is used. @@ -596,14 +596,14 @@ instance the C function: :: int get_val (long); - + should be imported from Ada as follows: .. code-block:: ada function Get_Val (V : Interfaces.C.long) return Interfaces.C.int; pragma Import (C, Get_Val, External_Name => "get_val"); - + Note that in this particular case the `External_Name` parameter could have been omitted since, when missing, this parameter is taken to be the name of the Ada entity in lower case. When the `Link_Name` parameter @@ -642,7 +642,7 @@ the compiler. For instance the Win32 function: :: APIENTRY int get_val (long); - + should be imported from Ada as follows: .. code-block:: ada @@ -650,7 +650,7 @@ should be imported from Ada as follows: function Get_Val (V : Interfaces.C.long) return Interfaces.C.int; pragma Import (Stdcall, Get_Val); -- On the x86 a long is 4 bytes, so the Link_Name is "_get_val@4" - + As for the `C` calling convention, when the `External_Name` parameter is missing, it is taken to be the name of the Ada entity in lower case. If instead of writing the above import pragma you write: @@ -659,7 +659,7 @@ case. If instead of writing the above import pragma you write: function Get_Val (V : Interfaces.C.long) return Interfaces.C.int; pragma Import (Stdcall, Get_Val, External_Name => "retrieve_val"); - + then the imported routine is `_retrieve_val@4`. However, if instead of specifying the `External_Name` parameter you specify the `Link_Name` as in the following example: @@ -668,7 +668,7 @@ of specifying the `External_Name` parameter you specify the function Get_Val (V : Interfaces.C.long) return Interfaces.C.int; pragma Import (Stdcall, Get_Val, Link_Name => "retrieve_val"); - + then the imported routine is `retrieve_val`, that is, there is no decoration at all. No leading underscore and no Stdcall suffix :samp:`@{nn}`. @@ -684,14 +684,14 @@ variable defined as: .. code-block:: c int my_var; - + then, to access this variable from Ada you should write: .. code-block:: ada My_Var : Interfaces.C.int; pragma Import (Stdcall, My_Var); - + Note that to ease building cross-platform bindings this convention will be handled as a `C` calling convention on non-Windows platforms. @@ -814,7 +814,7 @@ you simply issue the command :: $ gnatmake my_ada_app -largs -lAPI - + The argument *-largs -lAPI* at the end of the *gnatmake* command tells the GNAT linker to look for an import library. The linker will look for a library name in this specific order: @@ -835,7 +835,7 @@ following pragma .. code-block:: ada pragma Linker_Options ("-lAPI"); - + you do not have to add *-largs -lAPI* at the end of the *gnatmake* command. @@ -861,7 +861,7 @@ following two definitions: int some_var; int get (char *); - + then the equivalent Ada spec could be: .. code-block:: ada @@ -869,7 +869,7 @@ then the equivalent Ada spec could be: with Interfaces.C.Strings; package API is use Interfaces; - + Some_Var : C.int; function Get (Str : C.Strings.Chars_Ptr) return C.int; @@ -877,7 +877,7 @@ then the equivalent Ada spec could be: pragma Import (C, Get); pragma Import (DLL, Some_Var); end API; - + .. _Creating_an_Import_Library: @@ -914,7 +914,7 @@ suffix) has the following structure: `symbol1` `symbol2` ... - + *LIBRARY `name`* This section, which is optional, gives the name of the DLL. @@ -934,7 +934,7 @@ suffix) has the following structure: EXPORTS some_var get - + Note that you must specify the correct suffix (:samp:`@{nn}`) (see :ref:`Windows_Calling_Conventions`) for a Stdcall calling convention function in the exported symbols list. @@ -943,24 +943,19 @@ There can actually be other sections in a definition file, but these sections are not relevant to the discussion at hand. -.. rubric:: GNAT-Style Import Library +.. _Create_Def_File_Automatically: -.. _GNAT-Style_Import_Library: +.. rubric:: Creating a Definition File Automatically -To create a static import library from :file:`API.dll` with the GNAT tools -you should proceed as follows: - -* Create the definition file :file:`API.def` - (see :ref:`The Definition File `). - For that use the `dll2def` tool as follows: +You can automatically create the definition file :file:`API.def` +(see :ref:`The Definition File `) from a DLL. +For that use the `dlltool` program as follows: :: - $ dll2def API.dll > API.def - - `dll2def` is a very simple tool: it takes as input a DLL and prints - to standard output the list of entry points in the DLL. Note that if - some routines in the DLL have the `Stdcall` convention + $ dlltool API.dll -z API.def --export-all-symbols + + Note that if some routines in the DLL have the `Stdcall` convention (:ref:`Windows_Calling_Conventions`) with stripped :samp:`@{nn}` suffix then you'll have to edit :file:`api.def` to add it, and specify *-k* to *gnatdll* when creating the import library. @@ -972,20 +967,26 @@ you should proceed as follows: corresponding Microsoft documentation for further details). :: - + $ dumpbin /exports api.lib - + - If you have a message about a missing symbol at link time the compiler tells you what symbol is expected. You just have to go back to the definition file and add the right suffix. -* Build the import library `libAPI.dll.a`, using `gnatdll` - (see :ref:`Using_gnatdll`) as follows: + +.. _GNAT-Style_Import_Library: + +.. rubric:: GNAT-Style Import Library + +To create a static import library from :file:`API.dll` with the GNAT tools +you should create the .def file, then use `gnatdll` tool +(see :ref:`Using_gnatdll`) as follows: :: $ gnatdll -e API.def -d API.dll - + `gnatdll` takes as input a definition file :file:`API.def` and the name of the DLL containing the services listed in the definition file :file:`API.dll`. The name of the static import library generated is @@ -997,33 +998,29 @@ you should proceed as follows: DLL (:ref:`Using_gnatdll` for more information about `gnatdll`). +.. _MSVS-Style_Import_Library: + .. rubric:: Microsoft-Style Import Library -With GNAT you can either use a GNAT-style or Microsoft-style import -library. A Microsoft import library is needed only if you plan to make an +A Microsoft import library is needed only if you plan to make an Ada DLL available to applications developed with Microsoft tools (:ref:`Mixed-Language_Programming_on_Windows`). To create a Microsoft-style import library for :file:`API.dll` you -should proceed as follows: - -* Create the definition file :file:`API.def` from the DLL. For this use either - the `dll2def` tool as described above or the Microsoft `dumpbin` - tool (see the corresponding Microsoft documentation for further details). - -* Build the actual import library using Microsoft's `lib` utility: +should create the .def file, then build the actual import library using +Microsoft's `lib` utility: :: $ lib -machine:IX86 -def:API.def -out:API.lib - + If you use the above command the definition file :file:`API.def` must contain a line giving the name of the DLL: :: LIBRARY "API" - + See the Microsoft documentation for further details about the usage of `lib`. @@ -1066,7 +1063,7 @@ and use DLLs with GNAT. :: $ gcc -shared -shared-libgcc -o api.dll obj1.o obj2.o ... - + It is important to note that in this case all symbols found in the object files are automatically exported. It is possible to restrict the set of symbols to export by passing to *gcc* a definition @@ -1076,7 +1073,7 @@ and use DLLs with GNAT. :: $ gcc -shared -shared-libgcc -o api.dll api.def obj1.o obj2.o ... - + If you use a definition file you must export the elaboration procedures for every package that required one. Elaboration procedures are named using the package name followed by "_E". @@ -1092,7 +1089,7 @@ and use DLLs with GNAT. $ mkdir apilib $ copy *.ads *.ali api.dll apilib $ attrib +R apilib\\*.ali - + At this point it is possible to use the DLL by directly linking against it. Note that you must use the GNAT shared runtime when using GNAT shared libraries. This is achieved by using *-shared* binder's @@ -1101,7 +1098,7 @@ option. :: $ gnatmake main -Iapilib -bargs -shared -largs -Lapilib -lAPI - + .. _Building_DLLs_with_gnatdll: @@ -1207,7 +1204,7 @@ variable: pragma Export (C, Count); pragma Export (C, Factorial); end API; - + .. code-block:: ada package body API is @@ -1235,7 +1232,7 @@ variable: Adafinal; end Finalize_API; end API; - + If the Ada DLL you are building will only be used by Ada applications you do not have to export Ada entities with a `C` or `Stdcall` convention. As an example, the previous package could be written as @@ -1251,9 +1248,9 @@ follows: procedure Finalize_API; -- Initialization and Finalization routines. end API; - + .. code-block:: ada - + package body API is function Factorial (Val : Integer) return Integer is Fact : Integer := 1; @@ -1268,7 +1265,7 @@ follows: ... -- The remainder of this package body is unchanged. end API; - + Note that if you do not export the Ada entities with a `C` or `Stdcall` convention you will have to provide the mangled Ada names in the definition file of the Ada DLL @@ -1341,7 +1338,7 @@ the corresponding C header file could look like: extern int *_imp__count; #define count (*_imp__count) int factorial (int); - + It is important to understand that when building an Ada DLL to be used by other Ada applications, you need two different specs for the packages contained in the DLL: one for building the DLL and the other for using @@ -1357,7 +1354,7 @@ example consider a DLL comprising the following package `API`: ... -- Remainder of the package omitted. end API; - + After producing a DLL containing package `API`, the spec that must be used to import `API.Count` from Ada code outside of the DLL is: @@ -1368,7 +1365,7 @@ DLL is: Count : Integer; pragma Import (DLL, Count); end API; - + .. _Creating_the_Definition_File: @@ -1399,7 +1396,7 @@ entities, which in this case are: api__factorial api__finalize_api api__initialize_api - + .. _Using_gnatdll: @@ -1417,7 +1414,7 @@ static import library for the DLL and the actual DLL. The form of the :: $ gnatdll [`switches`] `list-of-files` [-largs `opts`] - + where `list-of-files` is a list of ALI and object files. The object file list must be the exact list of objects corresponding to the non-Ada sources whose services are to be included in the DLL. The ALI file list @@ -1545,7 +1542,7 @@ once :file:`api.adb` has been compiled and :file:`api.def` created is :: $ gnatdll -d api.dll api.ali - + The above command creates two files: :file:`libapi.dll.a` (the import library) and :file:`api.dll` (the actual DLL). If you want to create only the DLL, just type: @@ -1553,13 +1550,13 @@ only the DLL, just type: :: $ gnatdll -d api.dll -n api.ali - + Alternatively if you want to create just the import library, type: :: $ gnatdll -d api.dll - + .. rubric:: `gnatdll` behind the Scenes @@ -1608,7 +1605,7 @@ the following: $ gnatbind -n api $ gnatlink api -o api.jnk api.exp -mdll -Wl,--base-file,api.base - + * `gnatdll` builds the new export table using the new base file and generates the DLL import library :file:`libAPI.dll.a`. @@ -1640,7 +1637,7 @@ is :: $ dlltool [`switches`] - + `dlltool` switches include: @@ -1766,7 +1763,7 @@ resource: VALUE "Translation", 0x809, 1252 END END - + The value `0809` (langID) is for the U.K English language and `04E4` (charsetID), which is equal to `1252` decimal, for multilingual. @@ -1812,7 +1809,7 @@ containing the resources. This is done using the Resource Compiler :: $ windres -i myres.rc -o myres.o - + By default `windres` will run *gcc* to preprocess the :file:`.rc` file. You can specify an alternate preprocessor (usually named :file:`cpp.exe`) using the `windres` *--preprocessor* @@ -1828,7 +1825,7 @@ GNAT-compatible object file as follows: :: $ windres -i myres.res -o myres.o - + .. _Using_Resources: @@ -1845,7 +1842,59 @@ option: :: $ gnatmake myprog -largs myres.o - + + +.. _Using_GNAT_DLL_from_MSVS: + +Using GNAT DLLs from Microsoft Visual Studio Applications +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. index:: Microsoft Visual Studio, use with GNAT DLLs + +This section describes a common case of mixed GNAT/Microsoft Visual Studio +application development, where the main program is developed using MSVS, and +is linked with a DLL developed using GNAT. Such a mixed application should +be developed following the general guidelines outlined above; below is the +cookbook-style sequence of steps to follow: + +1. First develop and build the GNAT shared library using a library project + (let's assume the project is `mylib.gpr`, producing the library `libmylib.dll`): + + :: + + $ gprbuild -p mylib.gpr + +2. Produce a .def file for the symbols you need to interface with, either by + hand or automatically with possibly some manual adjustments + (see :ref:`Creating Definition File Automatically `): + + :: + + $ dlltool libmylib.dll -z libmylib.def --export-all-symbols + +3. Make sure that MSVS command-line tools are accessible on the path. + +4. Create the Microsoft-style import library (see :ref:`MSVS-Style Import Library `): + + :: + + $ lib -machine:IX86 -def:libmylib.def -out:libmylib.lib + +If you are using a 64-bit toolchain, the above becomes... + + :: + + $ lib -machine:X64 -def:libmylib.def -out:libmylib.lib + +5. Build the C main + + :: + + $ cl /O2 /MD main.c libmylib.lib + +6. Before running the executable, make sure you have set the PATH to the DLL, + or copy the DLL into into the directory containing the .exe. + .. _Debugging_a_DLL: @@ -1890,13 +1939,13 @@ switch). Here are the step-by-step instructions for debugging it: :: $ gdb -nw ada_main - + * Start the program and stop at the beginning of the main procedure :: (gdb) start - + This step is required to be able to set a breakpoint inside the DLL. As long as the program is not run, the DLL is not loaded. This has the consequence that the DLL debugging information is also not loaded, so it is not @@ -1908,7 +1957,7 @@ switch). Here are the step-by-step instructions for debugging it: (gdb) break ada_dll (gdb) cont - + At this stage a breakpoint is set inside the DLL. From there on you can use the standard approach to debug the whole program (:ref:`Running_and_Debugging_Ada_Programs`). @@ -1943,7 +1992,7 @@ been built with debugging information (see GNAT `-g` option). :: $ objdump --file-header main.exe - + The starting address is reported on the last line. For example: :: @@ -1952,13 +2001,13 @@ been built with debugging information (see GNAT `-g` option). architecture: i386, flags 0x0000010a: EXEC_P, HAS_DEBUG, D_PAGED start address 0x00401010 - + * Launch the debugger on the executable. :: $ gdb main.exe - + * Set a breakpoint at the starting address, and launch the program. :: @@ -1973,7 +2022,7 @@ been built with debugging information (see GNAT `-g` option). :: (gdb) break ada_dll.adb:45 - + Or if you want to break using a symbol on the DLL, you need first to select the Ada language (language used by the DLL). @@ -1981,13 +2030,13 @@ been built with debugging information (see GNAT `-g` option). (gdb) set language ada (gdb) break ada_dll - + * Continue the program. :: (gdb) cont - + This will run the program until it reaches the breakpoint that has been set. From that point you can use the standard way to debug a program as described in (:ref:`Running_and_Debugging_Ada_Programs`). @@ -2010,7 +2059,7 @@ loop in the code of the DLL to meet this criterion. :: $ main - + * Use the Windows *Task Manager* to find the process ID. Let's say that the process PID for :file:`main.exe` is 208. @@ -2019,31 +2068,31 @@ loop in the code of the DLL to meet this criterion. :: $ gdb - + * Attach to the running process to be debugged. :: (gdb) attach 208 - + * Load the process debugging information. :: (gdb) symbol-file main.exe - + * Break somewhere in the DLL. :: (gdb) break ada_dll - + * Continue process execution. :: (gdb) cont - + This last step will resume the process execution, and stop at the breakpoint we have set. From there you can use the standard approach to debug a program as described in @@ -2074,7 +2123,7 @@ This setting can be done with *gnatlink* using either of the following: :: $ gnatlink hello -Xlinker --stack=0x10000,0x1000 - + This sets the stack reserve size to 0x10000 bytes and the stack commit size to 0x1000 bytes. @@ -2084,7 +2133,7 @@ This setting can be done with *gnatlink* using either of the following: :: $ gnatlink hello -Wl,--stack=0x1000000 - + This sets the stack reserve size to 0x1000000 bytes. Note that with *-Wl* option it is not possible to set the stack commit size because the coma is a separator for this option. @@ -2103,7 +2152,7 @@ Under Windows systems, it is possible to specify the program heap size from :: $ gnatlink hello -Xlinker --heap=0x10000,0x1000 - + This sets the heap reserve size to 0x10000 bytes and the heap commit size to 0x1000 bytes. @@ -2112,13 +2161,73 @@ Under Windows systems, it is possible to specify the program heap size from :: $ gnatlink hello -Wl,--heap=0x1000000 - + This sets the heap reserve size to 0x1000000 bytes. Note that with *-Wl* option it is not possible to set the heap commit size because the coma is a separator for this option. +.. _Win32_Specific_Addons: + +Windows Specific Add-Ons +------------------------- + +This section describes the Windows specific add-ons. + +.. _Win32Ada: + +Win32Ada +^^^^^^^^ + +Win32Ada is a binding for the Microsoft Win32 API. This binding can be +easily installed from the provided installer. To use the Win32Ada +binding you need to use a project file, and adding a single with_clause +will give you full access to the Win32Ada binding sources and ensure +that the proper libraries are passed to the linker. + + .. code-block:: ada-project + + with "win32ada"; + project P is + for Sources use ...; + end P; + +To build the application you just need to call gprbuild for the +application's project, here p.gpr: + + .. code-block:: sh + + gprbuild p.gpr + +.. _wPOSIX: + +wPOSIX +^^^^^^ + +wPOSIX is a minimal POSIX binding whose goal is to help with building +cross-platforms applications. This binding is not complete though, as +the Win32 API does not provide the necessary support for all POSIX APIs. + +To use the wPOSIX binding you need to use a project file, and adding +a single with_clause will give you full access to the wPOSIX binding +sources and ensure that the proper libraries are passed to the linker. + + .. code-block:: ada-project + + with "wposix"; + project P is + for Sources use ...; + end P; + +To build the application you just need to call gprbuild for the +application's project, here p.gpr: + + .. code-block:: sh + + gprbuild p.gpr + + .. _Mac_OS_Topics: Mac OS Topics @@ -2180,10 +2289,8 @@ as follow. In a Terminal, run the following command: :: $ codesign -f -s "gdb-cert" /bin/gdb - + where "gdb-cert" should be replaced by the actual certificate name chosen above, and should be replaced by the location where you installed GNAT. Also, be sure that users are in the Unix group ``_developer``. - - diff --git a/gcc/ada/doc/gnat_ugn/the_gnat_compilation_model.rst b/gcc/ada/doc/gnat_ugn/the_gnat_compilation_model.rst index 80634d0eec7..60a2ce2edf7 100644 --- a/gcc/ada/doc/gnat_ugn/the_gnat_compilation_model.rst +++ b/gcc/ada/doc/gnat_ugn/the_gnat_compilation_model.rst @@ -3665,7 +3665,7 @@ Convention identifiers are recognized by GNAT: .. index:: Convention Stdcall *Stdcall* - This is relevant only to Windows XP/2000/NT implementations of GNAT, + This is relevant only to Windows implementations of GNAT, and specifies that the `Stdcall` calling sequence will be used, as defined by the NT API. Nevertheless, to ease building cross-platform bindings this convention will be handled as a `C` calling diff --git a/gcc/ada/gnat_rm.texi b/gcc/ada/gnat_rm.texi index d3eb6a90c57..ed7947d2cb7 100644 --- a/gcc/ada/gnat_rm.texi +++ b/gcc/ada/gnat_rm.texi @@ -21,7 +21,7 @@ @copying @quotation -GNAT Reference Manual , October 23, 2015 +GNAT Reference Manual , November 12, 2015 AdaCore @@ -224,6 +224,7 @@ Implementation Defined Pragmas * Pragma Pre:: * Pragma Precondition:: * Pragma Predicate:: +* Pragma Predicate_Failure:: * Pragma Preelaborable_Initialization:: * Pragma Prefix_Exception_Messages:: * Pragma Pre_Class:: @@ -511,6 +512,7 @@ Partition-Wide Restrictions Program Unit Level Restrictions * No_Elaboration_Code:: +* No_Dynamic_Sized_Objects:: * No_Entry_Queue:: * No_Implementation_Aspect_Specifications:: * No_Implementation_Attributes:: @@ -1272,6 +1274,7 @@ consideration, the use of these pragmas should be minimized. * Pragma Pre:: * Pragma Precondition:: * Pragma Predicate:: +* Pragma Predicate_Failure:: * Pragma Preelaborable_Initialization:: * Pragma Prefix_Exception_Messages:: * Pragma Pre_Class:: @@ -5815,7 +5818,7 @@ use of the pragma identifier @cite{Check}. Historically, pragma Ada 2012, and has been retained in its original form for compatibility purposes. -@node Pragma Predicate,Pragma Preelaborable_Initialization,Pragma Precondition,Implementation Defined Pragmas +@node Pragma Predicate,Pragma Predicate_Failure,Pragma Precondition,Implementation Defined Pragmas @anchor{gnat_rm/implementation_defined_pragmas pragma-predicate}@anchor{9d} @section Pragma Predicate @@ -5854,7 +5857,7 @@ subtype Q is R with Dynamic_Predicate => F(Q) or G(Q); @end example -Note that there is are no pragmas @cite{Dynamic_Predicate} +Note that there are no pragmas @cite{Dynamic_Predicate} or @cite{Static_Predicate}. That is because these pragmas would affect legality and semantics of the program and thus do not have a neutral effect if ignored. @@ -5869,8 +5872,25 @@ fundamentally changed (for example a membership test defined for subtype B). When following this approach, the use of predicates should be avoided. -@node Pragma Preelaborable_Initialization,Pragma Prefix_Exception_Messages,Pragma Predicate,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-preelaborable-initialization}@anchor{9e} +@node Pragma Predicate_Failure,Pragma Preelaborable_Initialization,Pragma Predicate,Implementation Defined Pragmas +@anchor{gnat_rm/implementation_defined_pragmas pragma-predicate-failure}@anchor{9e} +@section Pragma Predicate_Failure + + +Syntax: + +@example +pragma Predicate_Failure + ([Entity =>] type_LOCAL_NAME, + [Message =>] String_Expression); +@end example + +The @cite{Predicate_Failure} pragma is intended to be an exact replacement for +the language-defined +@cite{Predicate_Failure} aspect, and shares its restrictions and semantics. + +@node Pragma Preelaborable_Initialization,Pragma Prefix_Exception_Messages,Pragma Predicate_Failure,Implementation Defined Pragmas +@anchor{gnat_rm/implementation_defined_pragmas pragma-preelaborable-initialization}@anchor{9f} @section Pragma Preelaborable_Initialization @@ -5885,7 +5905,7 @@ versions of Ada as an implementation-defined pragma. See Ada 2012 Reference Manual for details. @node Pragma Prefix_Exception_Messages,Pragma Pre_Class,Pragma Preelaborable_Initialization,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-prefix-exception-messages}@anchor{9f} +@anchor{gnat_rm/implementation_defined_pragmas pragma-prefix-exception-messages}@anchor{a0} @section Pragma Prefix_Exception_Messages @@ -5916,7 +5936,7 @@ prefixing in this case, you can always call @cite{GNAT.Source_Info.Enclosing_Entity} and prepend the string manually. @node Pragma Pre_Class,Pragma Priority_Specific_Dispatching,Pragma Prefix_Exception_Messages,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-pre-class}@anchor{a0} +@anchor{gnat_rm/implementation_defined_pragmas pragma-pre-class}@anchor{a1} @section Pragma Pre_Class @@ -5951,7 +5971,7 @@ policy that controls this pragma is @cite{Pre'Class}, not @cite{Pre_Class}. @node Pragma Priority_Specific_Dispatching,Pragma Profile,Pragma Pre_Class,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-priority-specific-dispatching}@anchor{a1} +@anchor{gnat_rm/implementation_defined_pragmas pragma-priority-specific-dispatching}@anchor{a2} @section Pragma Priority_Specific_Dispatching @@ -5975,7 +5995,7 @@ versions of Ada as an implementation-defined pragma. See Ada 2012 Reference Manual for details. @node Pragma Profile,Pragma Profile_Warnings,Pragma Priority_Specific_Dispatching,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-profile}@anchor{a2} +@anchor{gnat_rm/implementation_defined_pragmas pragma-profile}@anchor{a3} @section Pragma Profile @@ -6223,7 +6243,7 @@ conforming Ada constructs. The profile enables the following three pragmas: @end itemize @node Pragma Profile_Warnings,Pragma Propagate_Exceptions,Pragma Profile,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-profile-warnings}@anchor{a3} +@anchor{gnat_rm/implementation_defined_pragmas pragma-profile-warnings}@anchor{a4} @section Pragma Profile_Warnings @@ -6241,7 +6261,7 @@ violations of the profile generate warning messages instead of error messages. @node Pragma Propagate_Exceptions,Pragma Provide_Shift_Operators,Pragma Profile_Warnings,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-propagate-exceptions}@anchor{a4} +@anchor{gnat_rm/implementation_defined_pragmas pragma-propagate-exceptions}@anchor{a5} @section Pragma Propagate_Exceptions @@ -6260,7 +6280,7 @@ purposes. It used to be used in connection with optimization of a now-obsolete mechanism for implementation of exceptions. @node Pragma Provide_Shift_Operators,Pragma Psect_Object,Pragma Propagate_Exceptions,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-provide-shift-operators}@anchor{a5} +@anchor{gnat_rm/implementation_defined_pragmas pragma-provide-shift-operators}@anchor{a6} @section Pragma Provide_Shift_Operators @@ -6280,7 +6300,7 @@ including the function declarations for these five operators, together with the pragma Import (Intrinsic, ...) statements. @node Pragma Psect_Object,Pragma Pure_Function,Pragma Provide_Shift_Operators,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-psect-object}@anchor{a6} +@anchor{gnat_rm/implementation_defined_pragmas pragma-psect-object}@anchor{a7} @section Pragma Psect_Object @@ -6300,7 +6320,7 @@ EXTERNAL_SYMBOL ::= This pragma is identical in effect to pragma @cite{Common_Object}. @node Pragma Pure_Function,Pragma Rational,Pragma Psect_Object,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-pure-function}@anchor{a7} +@anchor{gnat_rm/implementation_defined_pragmas pragma-pure-function}@anchor{a8} @section Pragma Pure_Function @@ -6362,7 +6382,7 @@ unit is not a Pure unit in the categorization sense. So for example, a function thus marked is free to @cite{with} non-pure units. @node Pragma Rational,Pragma Ravenscar,Pragma Pure_Function,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-rational}@anchor{a8} +@anchor{gnat_rm/implementation_defined_pragmas pragma-rational}@anchor{a9} @section Pragma Rational @@ -6380,7 +6400,7 @@ pragma Profile (Rational); @end example @node Pragma Ravenscar,Pragma Refined_Depends,Pragma Rational,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-ravenscar}@anchor{a9} +@anchor{gnat_rm/implementation_defined_pragmas pragma-ravenscar}@anchor{aa} @section Pragma Ravenscar @@ -6400,7 +6420,7 @@ pragma Profile (Ravenscar); which is the preferred method of setting the @cite{Ravenscar} profile. @node Pragma Refined_Depends,Pragma Refined_Global,Pragma Ravenscar,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-refined-depends}@anchor{aa} +@anchor{gnat_rm/implementation_defined_pragmas pragma-refined-depends}@anchor{ab} @section Pragma Refined_Depends @@ -6408,7 +6428,7 @@ For the description of this pragma, see SPARK 2014 Reference Manual, section 6.1.5. @node Pragma Refined_Global,Pragma Refined_Post,Pragma Refined_Depends,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-refined-global}@anchor{ab} +@anchor{gnat_rm/implementation_defined_pragmas pragma-refined-global}@anchor{ac} @section Pragma Refined_Global @@ -6416,7 +6436,7 @@ For the description of this pragma, see SPARK 2014 Reference Manual, section 6.1.4. @node Pragma Refined_Post,Pragma Refined_State,Pragma Refined_Global,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-refined-post}@anchor{ac} +@anchor{gnat_rm/implementation_defined_pragmas pragma-refined-post}@anchor{ad} @section Pragma Refined_Post @@ -6424,7 +6444,7 @@ For the description of this pragma, see SPARK 2014 Reference Manual, section 7.2.7. @node Pragma Refined_State,Pragma Relative_Deadline,Pragma Refined_Post,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-refined-state}@anchor{ad} +@anchor{gnat_rm/implementation_defined_pragmas pragma-refined-state}@anchor{ae} @section Pragma Refined_State @@ -6432,7 +6452,7 @@ For the description of this pragma, see SPARK 2014 Reference Manual, section 7.2.2. @node Pragma Relative_Deadline,Pragma Remote_Access_Type,Pragma Refined_State,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-relative-deadline}@anchor{ae} +@anchor{gnat_rm/implementation_defined_pragmas pragma-relative-deadline}@anchor{af} @section Pragma Relative_Deadline @@ -6447,7 +6467,7 @@ versions of Ada as an implementation-defined pragma. See Ada 2012 Reference Manual for details. @node Pragma Remote_Access_Type,Pragma Restricted_Run_Time,Pragma Relative_Deadline,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-remote-access-type}@anchor{af} +@anchor{gnat_rm/implementation_defined_pragmas pragma-remote-access-type}@anchor{b0} @section Pragma Remote_Access_Type @@ -6473,7 +6493,7 @@ pertaining to remote access to class-wide types. At instantiation, the actual type must be a remote access to class-wide type. @node Pragma Restricted_Run_Time,Pragma Restriction_Warnings,Pragma Remote_Access_Type,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-restricted-run-time}@anchor{b0} +@anchor{gnat_rm/implementation_defined_pragmas pragma-restricted-run-time}@anchor{b1} @section Pragma Restricted_Run_Time @@ -6494,7 +6514,7 @@ which is the preferred method of setting the restricted run time profile. @node Pragma Restriction_Warnings,Pragma Reviewable,Pragma Restricted_Run_Time,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-restriction-warnings}@anchor{b1} +@anchor{gnat_rm/implementation_defined_pragmas pragma-restriction-warnings}@anchor{b2} @section Pragma Restriction_Warnings @@ -6532,7 +6552,7 @@ generating a warning, but any other use of implementation defined pragmas will cause a warning to be generated. @node Pragma Reviewable,Pragma Share_Generic,Pragma Restriction_Warnings,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-reviewable}@anchor{b2} +@anchor{gnat_rm/implementation_defined_pragmas pragma-reviewable}@anchor{b3} @section Pragma Reviewable @@ -6636,7 +6656,7 @@ comprehensive messages identifying possible problems based on this information. @node Pragma Share_Generic,Pragma Shared,Pragma Reviewable,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-share-generic}@anchor{b3} +@anchor{gnat_rm/implementation_defined_pragmas pragma-share-generic}@anchor{b4} @section Pragma Share_Generic @@ -6654,7 +6674,7 @@ than to check that the given names are all names of generic units or generic instances. @node Pragma Shared,Pragma Short_Circuit_And_Or,Pragma Share_Generic,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-shared}@anchor{b4} +@anchor{gnat_rm/implementation_defined_pragmas pragma-shared}@anchor{b5} @section Pragma Shared @@ -6662,7 +6682,7 @@ This pragma is provided for compatibility with Ada 83. The syntax and semantics are identical to pragma Atomic. @node Pragma Short_Circuit_And_Or,Pragma Short_Descriptors,Pragma Shared,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-short-circuit-and-or}@anchor{b5} +@anchor{gnat_rm/implementation_defined_pragmas pragma-short-circuit-and-or}@anchor{b6} @section Pragma Short_Circuit_And_Or @@ -6681,7 +6701,7 @@ within the file being compiled, it applies only to the file being compiled. There is no requirement that all units in a partition use this option. @node Pragma Short_Descriptors,Pragma Simple_Storage_Pool_Type,Pragma Short_Circuit_And_Or,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-short-descriptors}@anchor{b6} +@anchor{gnat_rm/implementation_defined_pragmas pragma-short-descriptors}@anchor{b7} @section Pragma Short_Descriptors @@ -6695,7 +6715,7 @@ This pragma is provided for compatibility with other Ada implementations. It is recognized but ignored by all current versions of GNAT. @node Pragma Simple_Storage_Pool_Type,Pragma Source_File_Name,Pragma Short_Descriptors,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-simple-storage-pool-type}@anchor{b7} +@anchor{gnat_rm/implementation_defined_pragmas pragma-simple-storage-pool-type}@anchor{b8} @section Pragma Simple_Storage_Pool_Type @@ -6749,7 +6769,7 @@ storage-management discipline). An object of a simple storage pool type can be associated with an access type by specifying the attribute -@ref{b8,,Simple_Storage_Pool}. For example: +@ref{b9,,Simple_Storage_Pool}. For example: @example My_Pool : My_Simple_Storage_Pool_Type; @@ -6759,11 +6779,11 @@ type Acc is access My_Data_Type; for Acc'Simple_Storage_Pool use My_Pool; @end example -See attribute @ref{b8,,Simple_Storage_Pool} +See attribute @ref{b9,,Simple_Storage_Pool} for further details. @node Pragma Source_File_Name,Pragma Source_File_Name_Project,Pragma Simple_Storage_Pool_Type,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-source-file-name}@anchor{b9}@anchor{gnat_rm/implementation_defined_pragmas id3}@anchor{ba} +@anchor{gnat_rm/implementation_defined_pragmas pragma-source-file-name}@anchor{ba}@anchor{gnat_rm/implementation_defined_pragmas id3}@anchor{bb} @section Pragma Source_File_Name @@ -6855,19 +6875,19 @@ aware of these pragmas, and so other tools that use the projet file would not be aware of the intended naming conventions. If you are using project files, file naming is controlled by Source_File_Name_Project pragmas, which are usually supplied automatically by the project manager. A pragma -Source_File_Name cannot appear after a @ref{bb,,Pragma Source_File_Name_Project}. +Source_File_Name cannot appear after a @ref{bc,,Pragma Source_File_Name_Project}. For more details on the use of the @cite{Source_File_Name} pragma, see the sections on @cite{Using Other File Names} and @cite{Alternative File Naming Schemes' in the :title:`GNAT User's Guide}. @node Pragma Source_File_Name_Project,Pragma Source_Reference,Pragma Source_File_Name,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas id4}@anchor{bc}@anchor{gnat_rm/implementation_defined_pragmas pragma-source-file-name-project}@anchor{bb} +@anchor{gnat_rm/implementation_defined_pragmas id4}@anchor{bd}@anchor{gnat_rm/implementation_defined_pragmas pragma-source-file-name-project}@anchor{bc} @section Pragma Source_File_Name_Project This pragma has the same syntax and semantics as pragma Source_File_Name. It is only allowed as a stand-alone configuration pragma. -It cannot appear after a @ref{b9,,Pragma Source_File_Name}, and +It cannot appear after a @ref{ba,,Pragma Source_File_Name}, and most importantly, once pragma Source_File_Name_Project appears, no further Source_File_Name pragmas are allowed. @@ -6879,7 +6899,7 @@ Source_File_Name or Source_File_Name_Project pragmas (which would not be known to the project manager). @node Pragma Source_Reference,Pragma SPARK_Mode,Pragma Source_File_Name_Project,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-source-reference}@anchor{bd} +@anchor{gnat_rm/implementation_defined_pragmas pragma-source-reference}@anchor{be} @section Pragma Source_Reference @@ -6903,7 +6923,7 @@ string expression other than a string literal. This is because its value is needed for error messages issued by all phases of the compiler. @node Pragma SPARK_Mode,Pragma Static_Elaboration_Desired,Pragma Source_Reference,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-spark-mode}@anchor{be} +@anchor{gnat_rm/implementation_defined_pragmas pragma-spark-mode}@anchor{bf} @section Pragma SPARK_Mode @@ -6985,7 +7005,7 @@ SPARK_Mode (@cite{Off}), then that pragma will need to be repeated in the package body. @node Pragma Static_Elaboration_Desired,Pragma Stream_Convert,Pragma SPARK_Mode,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-static-elaboration-desired}@anchor{bf} +@anchor{gnat_rm/implementation_defined_pragmas pragma-static-elaboration-desired}@anchor{c0} @section Pragma Static_Elaboration_Desired @@ -7009,7 +7029,7 @@ construction of larger aggregates with static components that include an others choice.) @node Pragma Stream_Convert,Pragma Style_Checks,Pragma Static_Elaboration_Desired,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-stream-convert}@anchor{c0} +@anchor{gnat_rm/implementation_defined_pragmas pragma-stream-convert}@anchor{c1} @section Pragma Stream_Convert @@ -7086,7 +7106,7 @@ the pragma is silently ignored, and the default implementation of the stream attributes is used instead. @node Pragma Style_Checks,Pragma Subtitle,Pragma Stream_Convert,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-style-checks}@anchor{c1} +@anchor{gnat_rm/implementation_defined_pragmas pragma-style-checks}@anchor{c2} @section Pragma Style_Checks @@ -7159,7 +7179,7 @@ Rf2 : Integer := ARG; -- OK, no error @end example @node Pragma Subtitle,Pragma Suppress,Pragma Style_Checks,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-subtitle}@anchor{c2} +@anchor{gnat_rm/implementation_defined_pragmas pragma-subtitle}@anchor{c3} @section Pragma Subtitle @@ -7173,7 +7193,7 @@ This pragma is recognized for compatibility with other Ada compilers but is ignored by GNAT. @node Pragma Suppress,Pragma Suppress_All,Pragma Subtitle,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-suppress}@anchor{c3} +@anchor{gnat_rm/implementation_defined_pragmas pragma-suppress}@anchor{c4} @section Pragma Suppress @@ -7246,7 +7266,7 @@ Of course, run-time checks are omitted whenever the compiler can prove that they will not fail, whether or not checks are suppressed. @node Pragma Suppress_All,Pragma Suppress_Debug_Info,Pragma Suppress,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-suppress-all}@anchor{c4} +@anchor{gnat_rm/implementation_defined_pragmas pragma-suppress-all}@anchor{c5} @section Pragma Suppress_All @@ -7265,7 +7285,7 @@ The use of the standard Ada pragma @cite{Suppress (All_Checks)} as a normal configuration pragma is the preferred usage in GNAT. @node Pragma Suppress_Debug_Info,Pragma Suppress_Exception_Locations,Pragma Suppress_All,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-suppress-debug-info}@anchor{c5} +@anchor{gnat_rm/implementation_defined_pragmas pragma-suppress-debug-info}@anchor{c6} @section Pragma Suppress_Debug_Info @@ -7280,7 +7300,7 @@ for the specified entity. It is intended primarily for use in debugging the debugger, and navigating around debugger problems. @node Pragma Suppress_Exception_Locations,Pragma Suppress_Initialization,Pragma Suppress_Debug_Info,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-suppress-exception-locations}@anchor{c6} +@anchor{gnat_rm/implementation_defined_pragmas pragma-suppress-exception-locations}@anchor{c7} @section Pragma Suppress_Exception_Locations @@ -7303,7 +7323,7 @@ a partition, so it is fine to have some units within a partition compiled with this pragma and others compiled in normal mode without it. @node Pragma Suppress_Initialization,Pragma Task_Name,Pragma Suppress_Exception_Locations,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-suppress-initialization}@anchor{c7} +@anchor{gnat_rm/implementation_defined_pragmas pragma-suppress-initialization}@anchor{c8} @section Pragma Suppress_Initialization @@ -7348,7 +7368,7 @@ is suppressed, just as though its subtype had been given in a pragma Suppress_Initialization, as described above. @node Pragma Task_Name,Pragma Task_Storage,Pragma Suppress_Initialization,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-task-name}@anchor{c8} +@anchor{gnat_rm/implementation_defined_pragmas pragma-task-name}@anchor{c9} @section Pragma Task_Name @@ -7404,7 +7424,7 @@ end; @end example @node Pragma Task_Storage,Pragma Test_Case,Pragma Task_Name,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-task-storage}@anchor{c9} +@anchor{gnat_rm/implementation_defined_pragmas pragma-task-storage}@anchor{ca} @section Pragma Task_Storage @@ -7424,7 +7444,7 @@ created, depending on the target. This pragma can appear anywhere a type. @node Pragma Test_Case,Pragma Thread_Local_Storage,Pragma Task_Storage,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-test-case}@anchor{ca} +@anchor{gnat_rm/implementation_defined_pragmas pragma-test-case}@anchor{cb} @section Pragma Test_Case @@ -7480,7 +7500,7 @@ postcondition. Mode @cite{Robustness} indicates that the precondition and postcondition of the subprogram should be ignored for this test case. @node Pragma Thread_Local_Storage,Pragma Time_Slice,Pragma Test_Case,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-thread-local-storage}@anchor{cb} +@anchor{gnat_rm/implementation_defined_pragmas pragma-thread-local-storage}@anchor{cc} @section Pragma Thread_Local_Storage @@ -7514,7 +7534,7 @@ If this pragma is used on a system where @cite{TLS} is not supported, then an error message will be generated and the program will be rejected. @node Pragma Time_Slice,Pragma Title,Pragma Thread_Local_Storage,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-time-slice}@anchor{cc} +@anchor{gnat_rm/implementation_defined_pragmas pragma-time-slice}@anchor{cd} @section Pragma Time_Slice @@ -7530,7 +7550,7 @@ It is ignored if it is used in a system that does not allow this control, or if it appears in other than the main program unit. @node Pragma Title,Pragma Type_Invariant,Pragma Time_Slice,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-title}@anchor{cd} +@anchor{gnat_rm/implementation_defined_pragmas pragma-title}@anchor{ce} @section Pragma Title @@ -7555,7 +7575,7 @@ notation is used, and named and positional notation can be mixed following the normal rules for procedure calls in Ada. @node Pragma Type_Invariant,Pragma Type_Invariant_Class,Pragma Title,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-type-invariant}@anchor{ce} +@anchor{gnat_rm/implementation_defined_pragmas pragma-type-invariant}@anchor{cf} @section Pragma Type_Invariant @@ -7576,7 +7596,7 @@ controlled by the assertion identifier @cite{Type_Invariant} rather than @cite{Invariant}. @node Pragma Type_Invariant_Class,Pragma Unchecked_Union,Pragma Type_Invariant,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-type-invariant-class}@anchor{cf} +@anchor{gnat_rm/implementation_defined_pragmas pragma-type-invariant-class}@anchor{d0} @section Pragma Type_Invariant_Class @@ -7603,7 +7623,7 @@ policy that controls this pragma is @cite{Type_Invariant'Class}, not @cite{Type_Invariant_Class}. @node Pragma Unchecked_Union,Pragma Unevaluated_Use_Of_Old,Pragma Type_Invariant_Class,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-unchecked-union}@anchor{d0} +@anchor{gnat_rm/implementation_defined_pragmas pragma-unchecked-union}@anchor{d1} @section Pragma Unchecked_Union @@ -7623,7 +7643,7 @@ version in all language modes (Ada 83, Ada 95, and Ada 2005). For full details, consult the Ada 2012 Reference Manual, section B.3.3. @node Pragma Unevaluated_Use_Of_Old,Pragma Unimplemented_Unit,Pragma Unchecked_Union,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-unevaluated-use-of-old}@anchor{d1} +@anchor{gnat_rm/implementation_defined_pragmas pragma-unevaluated-use-of-old}@anchor{d2} @section Pragma Unevaluated_Use_Of_Old @@ -7678,7 +7698,7 @@ uses up to the end of the corresponding statement sequence or sequence of package declarations. @node Pragma Unimplemented_Unit,Pragma Universal_Aliasing,Pragma Unevaluated_Use_Of_Old,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-unimplemented-unit}@anchor{d2} +@anchor{gnat_rm/implementation_defined_pragmas pragma-unimplemented-unit}@anchor{d3} @section Pragma Unimplemented_Unit @@ -7698,7 +7718,7 @@ The abort only happens if code is being generated. Thus you can use specs of unimplemented packages in syntax or semantic checking mode. @node Pragma Universal_Aliasing,Pragma Universal_Data,Pragma Unimplemented_Unit,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-universal-aliasing}@anchor{d3} +@anchor{gnat_rm/implementation_defined_pragmas pragma-universal-aliasing}@anchor{d4} @section Pragma Universal_Aliasing @@ -7717,7 +7737,7 @@ situations in which it must be suppressed, see the section on @cite{Optimization and Strict Aliasing} in the @cite{GNAT User's Guide}. @node Pragma Universal_Data,Pragma Unmodified,Pragma Universal_Aliasing,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-universal-data}@anchor{d4} +@anchor{gnat_rm/implementation_defined_pragmas pragma-universal-data}@anchor{d5} @section Pragma Universal_Data @@ -7741,7 +7761,7 @@ of this pragma is also available by applying the -univ switch on the compilations of units where universal addressing of the data is desired. @node Pragma Unmodified,Pragma Unreferenced,Pragma Universal_Data,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-unmodified}@anchor{d5} +@anchor{gnat_rm/implementation_defined_pragmas pragma-unmodified}@anchor{d6} @section Pragma Unmodified @@ -7775,7 +7795,7 @@ Thus it is never necessary to use @cite{pragma Unmodified} for such variables, though it is harmless to do so. @node Pragma Unreferenced,Pragma Unreferenced_Objects,Pragma Unmodified,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-unreferenced}@anchor{d6} +@anchor{gnat_rm/implementation_defined_pragmas pragma-unreferenced}@anchor{d7} @section Pragma Unreferenced @@ -7835,7 +7855,7 @@ Thus it is never necessary to use @cite{pragma Unreferenced} for such variables, though it is harmless to do so. @node Pragma Unreferenced_Objects,Pragma Unreserve_All_Interrupts,Pragma Unreferenced,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-unreferenced-objects}@anchor{d7} +@anchor{gnat_rm/implementation_defined_pragmas pragma-unreferenced-objects}@anchor{d8} @section Pragma Unreferenced_Objects @@ -7860,7 +7880,7 @@ compiler will automatically suppress unwanted warnings about these variables not being referenced. @node Pragma Unreserve_All_Interrupts,Pragma Unsuppress,Pragma Unreferenced_Objects,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-unreserve-all-interrupts}@anchor{d8} +@anchor{gnat_rm/implementation_defined_pragmas pragma-unreserve-all-interrupts}@anchor{d9} @section Pragma Unreserve_All_Interrupts @@ -7896,7 +7916,7 @@ handled, see pragma @cite{Interrupt_State}, which subsumes the functionality of the @cite{Unreserve_All_Interrupts} pragma. @node Pragma Unsuppress,Pragma Use_VADS_Size,Pragma Unreserve_All_Interrupts,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-unsuppress}@anchor{d9} +@anchor{gnat_rm/implementation_defined_pragmas pragma-unsuppress}@anchor{da} @section Pragma Unsuppress @@ -7932,7 +7952,7 @@ number of implementation-defined check names. See the description of pragma @cite{Suppress} for full details. @node Pragma Use_VADS_Size,Pragma Validity_Checks,Pragma Unsuppress,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-use-vads-size}@anchor{da} +@anchor{gnat_rm/implementation_defined_pragmas pragma-use-vads-size}@anchor{db} @section Pragma Use_VADS_Size @@ -7956,7 +7976,7 @@ as implemented in the VADS compiler. See description of the VADS_Size attribute for further details. @node Pragma Validity_Checks,Pragma Volatile,Pragma Use_VADS_Size,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-validity-checks}@anchor{db} +@anchor{gnat_rm/implementation_defined_pragmas pragma-validity-checks}@anchor{dc} @section Pragma Validity_Checks @@ -8013,7 +8033,7 @@ A := C; -- C will be validity checked @end example @node Pragma Volatile,Pragma Volatile_Full_Access,Pragma Validity_Checks,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-volatile}@anchor{dc} +@anchor{gnat_rm/implementation_defined_pragmas pragma-volatile}@anchor{dd} @section Pragma Volatile @@ -8031,7 +8051,7 @@ implementation of pragma Volatile is upwards compatible with the implementation in DEC Ada 83. @node Pragma Volatile_Full_Access,Pragma Volatile_Function,Pragma Volatile,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-volatile-full-access}@anchor{dd} +@anchor{gnat_rm/implementation_defined_pragmas pragma-volatile-full-access}@anchor{de} @section Pragma Volatile_Full_Access @@ -8063,7 +8083,7 @@ It is not permissible to specify @cite{Volatile_Full_Access} for a composite (record or array) type or object that has at least one @cite{Aliased} component. @node Pragma Volatile_Function,Pragma Warning_As_Error,Pragma Volatile_Full_Access,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-volatile-function}@anchor{de} +@anchor{gnat_rm/implementation_defined_pragmas pragma-volatile-function}@anchor{df} @section Pragma Volatile_Function @@ -8071,7 +8091,7 @@ For the description of this pragma, see SPARK 2014 Reference Manual, section 7.1.2. @node Pragma Warning_As_Error,Pragma Warnings,Pragma Volatile_Function,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-warning-as-error}@anchor{df} +@anchor{gnat_rm/implementation_defined_pragmas pragma-warning-as-error}@anchor{e0} @section Pragma Warning_As_Error @@ -8106,7 +8126,7 @@ as shown in the example below, to treat a class of warnings as errors. The above use of patterns to match the message applies only to warning messages generated by the front end. This pragma can also be applied to -warnings provided by the back end and mentioned in @ref{e0,,Pragma Warnings}. +warnings provided by the back end and mentioned in @ref{e1,,Pragma Warnings}. By using a single full @emph{-Wxxx} switch in the pragma, such warnings can also be treated as errors. @@ -8156,7 +8176,7 @@ the tag is changed from "warning:" to "error:" and the string "[warning-as-error]" is appended to the end of the message. @node Pragma Warnings,Pragma Weak_External,Pragma Warning_As_Error,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas id5}@anchor{e1}@anchor{gnat_rm/implementation_defined_pragmas pragma-warnings}@anchor{e0} +@anchor{gnat_rm/implementation_defined_pragmas id5}@anchor{e2}@anchor{gnat_rm/implementation_defined_pragmas pragma-warnings}@anchor{e1} @section Pragma Warnings @@ -8308,7 +8328,7 @@ selectively for each tool, and as a consequence to detect useless pragma Warnings with switch @cite{-gnatw.w}. @node Pragma Weak_External,Pragma Wide_Character_Encoding,Pragma Warnings,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-weak-external}@anchor{e2} +@anchor{gnat_rm/implementation_defined_pragmas pragma-weak-external}@anchor{e3} @section Pragma Weak_External @@ -8359,7 +8379,7 @@ end External_Module; @end example @node Pragma Wide_Character_Encoding,,Pragma Weak_External,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-wide-character-encoding}@anchor{e3} +@anchor{gnat_rm/implementation_defined_pragmas pragma-wide-character-encoding}@anchor{e4} @section Pragma Wide_Character_Encoding @@ -8386,7 +8406,7 @@ encoding within that file, and does not affect withed units, specs, or subunits. @node Implementation Defined Aspects,Implementation Defined Attributes,Implementation Defined Pragmas,Top -@anchor{gnat_rm/implementation_defined_aspects implementation-defined-aspects}@anchor{e4}@anchor{gnat_rm/implementation_defined_aspects doc}@anchor{e5}@anchor{gnat_rm/implementation_defined_aspects id1}@anchor{e6} +@anchor{gnat_rm/implementation_defined_aspects implementation-defined-aspects}@anchor{e5}@anchor{gnat_rm/implementation_defined_aspects doc}@anchor{e6}@anchor{gnat_rm/implementation_defined_aspects id1}@anchor{e7} @chapter Implementation Defined Aspects @@ -8501,7 +8521,7 @@ or attribute definition clause. @end menu @node Aspect Abstract_State,Annotate,,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-abstract-state}@anchor{e7} +@anchor{gnat_rm/implementation_defined_aspects aspect-abstract-state}@anchor{e8} @section Aspect Abstract_State @@ -8510,7 +8530,7 @@ or attribute definition clause. This aspect is equivalent to pragma @cite{Abstract_State}. @node Annotate,Aspect Async_Readers,Aspect Abstract_State,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects annotate}@anchor{e8} +@anchor{gnat_rm/implementation_defined_aspects annotate}@anchor{e9} @section Annotate @@ -8536,7 +8556,7 @@ Equivalent to @cite{pragma Annotate (ID@comma{} ID @{@comma{} ARG@}@comma{} Enti @end table @node Aspect Async_Readers,Aspect Async_Writers,Annotate,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-async-readers}@anchor{e9} +@anchor{gnat_rm/implementation_defined_aspects aspect-async-readers}@anchor{ea} @section Aspect Async_Readers @@ -8545,7 +8565,7 @@ Equivalent to @cite{pragma Annotate (ID@comma{} ID @{@comma{} ARG@}@comma{} Enti This boolean aspect is equivalent to pragma @cite{Async_Readers}. @node Aspect Async_Writers,Aspect Constant_After_Elaboration,Aspect Async_Readers,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-async-writers}@anchor{ea} +@anchor{gnat_rm/implementation_defined_aspects aspect-async-writers}@anchor{eb} @section Aspect Async_Writers @@ -8554,7 +8574,7 @@ This boolean aspect is equivalent to pragma @cite{Async_Readers}. This boolean aspect is equivalent to pragma @cite{Async_Writers}. @node Aspect Constant_After_Elaboration,Aspect Contract_Cases,Aspect Async_Writers,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-constant-after-elaboration}@anchor{eb} +@anchor{gnat_rm/implementation_defined_aspects aspect-constant-after-elaboration}@anchor{ec} @section Aspect Constant_After_Elaboration @@ -8563,7 +8583,7 @@ This boolean aspect is equivalent to pragma @cite{Async_Writers}. This aspect is equivalent to pragma @cite{Constant_After_Elaboration}. @node Aspect Contract_Cases,Aspect Depends,Aspect Constant_After_Elaboration,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-contract-cases}@anchor{ec} +@anchor{gnat_rm/implementation_defined_aspects aspect-contract-cases}@anchor{ed} @section Aspect Contract_Cases @@ -8574,7 +8594,7 @@ of clauses being enclosed in parentheses so that syntactically it is an aggregate. @node Aspect Depends,Aspect Default_Initial_Condition,Aspect Contract_Cases,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-depends}@anchor{ed} +@anchor{gnat_rm/implementation_defined_aspects aspect-depends}@anchor{ee} @section Aspect Depends @@ -8583,7 +8603,7 @@ aggregate. This aspect is equivalent to pragma @cite{Depends}. @node Aspect Default_Initial_Condition,Aspect Dimension,Aspect Depends,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-default-initial-condition}@anchor{ee} +@anchor{gnat_rm/implementation_defined_aspects aspect-default-initial-condition}@anchor{ef} @section Aspect Default_Initial_Condition @@ -8592,7 +8612,7 @@ This aspect is equivalent to pragma @cite{Depends}. This aspect is equivalent to pragma @cite{Default_Initial_Condition}. @node Aspect Dimension,Aspect Dimension_System,Aspect Default_Initial_Condition,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-dimension}@anchor{ef} +@anchor{gnat_rm/implementation_defined_aspects aspect-dimension}@anchor{f0} @section Aspect Dimension @@ -8628,7 +8648,7 @@ Note that when the dimensioned type is an integer type, then any dimension value must be an integer literal. @node Aspect Dimension_System,Aspect Disable_Controlled,Aspect Dimension,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-dimension-system}@anchor{f0} +@anchor{gnat_rm/implementation_defined_aspects aspect-dimension-system}@anchor{f1} @section Aspect Dimension_System @@ -8688,7 +8708,7 @@ See section 'Performing Dimensionality Analysis in GNAT' in the GNAT Users Guide for detailed examples of use of the dimension system. @node Aspect Disable_Controlled,Aspect Effective_Reads,Aspect Dimension_System,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-disable-controlled}@anchor{f1} +@anchor{gnat_rm/implementation_defined_aspects aspect-disable-controlled}@anchor{f2} @section Aspect Disable_Controlled @@ -8701,7 +8721,7 @@ where for example you might want a record to be controlled or not depending on whether some run-time check is enabled or suppressed. @node Aspect Effective_Reads,Aspect Effective_Writes,Aspect Disable_Controlled,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-effective-reads}@anchor{f2} +@anchor{gnat_rm/implementation_defined_aspects aspect-effective-reads}@anchor{f3} @section Aspect Effective_Reads @@ -8710,7 +8730,7 @@ whether some run-time check is enabled or suppressed. This aspect is equivalent to pragma @cite{Effective_Reads}. @node Aspect Effective_Writes,Aspect Extensions_Visible,Aspect Effective_Reads,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-effective-writes}@anchor{f3} +@anchor{gnat_rm/implementation_defined_aspects aspect-effective-writes}@anchor{f4} @section Aspect Effective_Writes @@ -8719,7 +8739,7 @@ This aspect is equivalent to pragma @cite{Effective_Reads}. This aspect is equivalent to pragma @cite{Effective_Writes}. @node Aspect Extensions_Visible,Aspect Favor_Top_Level,Aspect Effective_Writes,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-extensions-visible}@anchor{f4} +@anchor{gnat_rm/implementation_defined_aspects aspect-extensions-visible}@anchor{f5} @section Aspect Extensions_Visible @@ -8728,7 +8748,7 @@ This aspect is equivalent to pragma @cite{Effective_Writes}. This aspect is equivalent to pragma @cite{Extensions_Visible}. @node Aspect Favor_Top_Level,Aspect Ghost,Aspect Extensions_Visible,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-favor-top-level}@anchor{f5} +@anchor{gnat_rm/implementation_defined_aspects aspect-favor-top-level}@anchor{f6} @section Aspect Favor_Top_Level @@ -8737,7 +8757,7 @@ This aspect is equivalent to pragma @cite{Extensions_Visible}. This boolean aspect is equivalent to pragma @cite{Favor_Top_Level}. @node Aspect Ghost,Aspect Global,Aspect Favor_Top_Level,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-ghost}@anchor{f6} +@anchor{gnat_rm/implementation_defined_aspects aspect-ghost}@anchor{f7} @section Aspect Ghost @@ -8746,7 +8766,7 @@ This boolean aspect is equivalent to pragma @cite{Favor_Top_Level}. This aspect is equivalent to pragma @cite{Ghost}. @node Aspect Global,Aspect Initial_Condition,Aspect Ghost,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-global}@anchor{f7} +@anchor{gnat_rm/implementation_defined_aspects aspect-global}@anchor{f8} @section Aspect Global @@ -8755,7 +8775,7 @@ This aspect is equivalent to pragma @cite{Ghost}. This aspect is equivalent to pragma @cite{Global}. @node Aspect Initial_Condition,Aspect Initializes,Aspect Global,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-initial-condition}@anchor{f8} +@anchor{gnat_rm/implementation_defined_aspects aspect-initial-condition}@anchor{f9} @section Aspect Initial_Condition @@ -8764,7 +8784,7 @@ This aspect is equivalent to pragma @cite{Global}. This aspect is equivalent to pragma @cite{Initial_Condition}. @node Aspect Initializes,Aspect Inline_Always,Aspect Initial_Condition,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-initializes}@anchor{f9} +@anchor{gnat_rm/implementation_defined_aspects aspect-initializes}@anchor{fa} @section Aspect Initializes @@ -8773,7 +8793,7 @@ This aspect is equivalent to pragma @cite{Initial_Condition}. This aspect is equivalent to pragma @cite{Initializes}. @node Aspect Inline_Always,Aspect Invariant,Aspect Initializes,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-inline-always}@anchor{fa} +@anchor{gnat_rm/implementation_defined_aspects aspect-inline-always}@anchor{fb} @section Aspect Inline_Always @@ -8782,7 +8802,7 @@ This aspect is equivalent to pragma @cite{Initializes}. This boolean aspect is equivalent to pragma @cite{Inline_Always}. @node Aspect Invariant,Aspect Invariant'Class,Aspect Inline_Always,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-invariant}@anchor{fb} +@anchor{gnat_rm/implementation_defined_aspects aspect-invariant}@anchor{fc} @section Aspect Invariant @@ -8793,7 +8813,7 @@ synonym for the language defined aspect @cite{Type_Invariant} except that it is separately controllable using pragma @cite{Assertion_Policy}. @node Aspect Invariant'Class,Aspect Iterable,Aspect Invariant,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-invariant-class}@anchor{fc} +@anchor{gnat_rm/implementation_defined_aspects aspect-invariant-class}@anchor{fd} @section Aspect Invariant'Class @@ -8804,7 +8824,7 @@ synonym for the language defined aspect @cite{Type_Invariant'Class} except that it is separately controllable using pragma @cite{Assertion_Policy}. @node Aspect Iterable,Aspect Linker_Section,Aspect Invariant'Class,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-iterable}@anchor{fd} +@anchor{gnat_rm/implementation_defined_aspects aspect-iterable}@anchor{fe} @section Aspect Iterable @@ -8880,7 +8900,7 @@ function Get_Element (Cont : Container; Position : Cursor) return Element_Type; This aspect is used in the GNAT-defined formal container packages. @node Aspect Linker_Section,Aspect Lock_Free,Aspect Iterable,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-linker-section}@anchor{fe} +@anchor{gnat_rm/implementation_defined_aspects aspect-linker-section}@anchor{ff} @section Aspect Linker_Section @@ -8889,7 +8909,7 @@ This aspect is used in the GNAT-defined formal container packages. This aspect is equivalent to an @cite{Linker_Section} pragma. @node Aspect Lock_Free,Aspect No_Elaboration_Code_All,Aspect Linker_Section,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-lock-free}@anchor{ff} +@anchor{gnat_rm/implementation_defined_aspects aspect-lock-free}@anchor{100} @section Aspect Lock_Free @@ -8898,7 +8918,7 @@ This aspect is equivalent to an @cite{Linker_Section} pragma. This boolean aspect is equivalent to pragma @cite{Lock_Free}. @node Aspect No_Elaboration_Code_All,Aspect No_Tagged_Streams,Aspect Lock_Free,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-no-elaboration-code-all}@anchor{100} +@anchor{gnat_rm/implementation_defined_aspects aspect-no-elaboration-code-all}@anchor{101} @section Aspect No_Elaboration_Code_All @@ -8908,7 +8928,7 @@ This aspect is equivalent to a @cite{pragma No_Elaboration_Code_All} statement for a program unit. @node Aspect No_Tagged_Streams,Aspect Object_Size,Aspect No_Elaboration_Code_All,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-no-tagged-streams}@anchor{101} +@anchor{gnat_rm/implementation_defined_aspects aspect-no-tagged-streams}@anchor{102} @section Aspect No_Tagged_Streams @@ -8919,7 +8939,7 @@ argument specifying a root tagged type (thus this aspect can only be applied to such a type). @node Aspect Object_Size,Aspect Obsolescent,Aspect No_Tagged_Streams,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-object-size}@anchor{102} +@anchor{gnat_rm/implementation_defined_aspects aspect-object-size}@anchor{103} @section Aspect Object_Size @@ -8929,7 +8949,7 @@ This aspect is equivalent to an @cite{Object_Size} attribute definition clause. @node Aspect Obsolescent,Aspect Part_Of,Aspect Object_Size,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-obsolescent}@anchor{103} +@anchor{gnat_rm/implementation_defined_aspects aspect-obsolescent}@anchor{104} @section Aspect Obsolescent @@ -8940,7 +8960,7 @@ evaluation of this aspect happens at the point of occurrence, it is not delayed until the freeze point. @node Aspect Part_Of,Aspect Persistent_BSS,Aspect Obsolescent,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-part-of}@anchor{104} +@anchor{gnat_rm/implementation_defined_aspects aspect-part-of}@anchor{105} @section Aspect Part_Of @@ -8949,7 +8969,7 @@ delayed until the freeze point. This aspect is equivalent to pragma @cite{Part_Of}. @node Aspect Persistent_BSS,Aspect Predicate,Aspect Part_Of,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-persistent-bss}@anchor{105} +@anchor{gnat_rm/implementation_defined_aspects aspect-persistent-bss}@anchor{106} @section Aspect Persistent_BSS @@ -8958,7 +8978,7 @@ This aspect is equivalent to pragma @cite{Part_Of}. This boolean aspect is equivalent to pragma @cite{Persistent_BSS}. @node Aspect Predicate,Aspect Pure_Function,Aspect Persistent_BSS,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-predicate}@anchor{106} +@anchor{gnat_rm/implementation_defined_aspects aspect-predicate}@anchor{107} @section Aspect Predicate @@ -8972,7 +8992,7 @@ expression. It is also separately controllable using pragma @cite{Assertion_Policy}. @node Aspect Pure_Function,Aspect Refined_Depends,Aspect Predicate,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-pure-function}@anchor{107} +@anchor{gnat_rm/implementation_defined_aspects aspect-pure-function}@anchor{108} @section Aspect Pure_Function @@ -8981,7 +9001,7 @@ expression. It is also separately controllable using pragma This boolean aspect is equivalent to pragma @cite{Pure_Function}. @node Aspect Refined_Depends,Aspect Refined_Global,Aspect Pure_Function,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-refined-depends}@anchor{108} +@anchor{gnat_rm/implementation_defined_aspects aspect-refined-depends}@anchor{109} @section Aspect Refined_Depends @@ -8990,7 +9010,7 @@ This boolean aspect is equivalent to pragma @cite{Pure_Function}. This aspect is equivalent to pragma @cite{Refined_Depends}. @node Aspect Refined_Global,Aspect Refined_Post,Aspect Refined_Depends,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-refined-global}@anchor{109} +@anchor{gnat_rm/implementation_defined_aspects aspect-refined-global}@anchor{10a} @section Aspect Refined_Global @@ -8999,7 +9019,7 @@ This aspect is equivalent to pragma @cite{Refined_Depends}. This aspect is equivalent to pragma @cite{Refined_Global}. @node Aspect Refined_Post,Aspect Refined_State,Aspect Refined_Global,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-refined-post}@anchor{10a} +@anchor{gnat_rm/implementation_defined_aspects aspect-refined-post}@anchor{10b} @section Aspect Refined_Post @@ -9008,7 +9028,7 @@ This aspect is equivalent to pragma @cite{Refined_Global}. This aspect is equivalent to pragma @cite{Refined_Post}. @node Aspect Refined_State,Aspect Remote_Access_Type,Aspect Refined_Post,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-refined-state}@anchor{10b} +@anchor{gnat_rm/implementation_defined_aspects aspect-refined-state}@anchor{10c} @section Aspect Refined_State @@ -9017,7 +9037,7 @@ This aspect is equivalent to pragma @cite{Refined_Post}. This aspect is equivalent to pragma @cite{Refined_State}. @node Aspect Remote_Access_Type,Aspect Scalar_Storage_Order,Aspect Refined_State,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-remote-access-type}@anchor{10c} +@anchor{gnat_rm/implementation_defined_aspects aspect-remote-access-type}@anchor{10d} @section Aspect Remote_Access_Type @@ -9026,7 +9046,7 @@ This aspect is equivalent to pragma @cite{Refined_State}. This aspect is equivalent to pragma @cite{Remote_Access_Type}. @node Aspect Scalar_Storage_Order,Aspect Shared,Aspect Remote_Access_Type,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-scalar-storage-order}@anchor{10d} +@anchor{gnat_rm/implementation_defined_aspects aspect-scalar-storage-order}@anchor{10e} @section Aspect Scalar_Storage_Order @@ -9036,7 +9056,7 @@ This aspect is equivalent to a @cite{Scalar_Storage_Order} attribute definition clause. @node Aspect Shared,Aspect Simple_Storage_Pool,Aspect Scalar_Storage_Order,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-shared}@anchor{10e} +@anchor{gnat_rm/implementation_defined_aspects aspect-shared}@anchor{10f} @section Aspect Shared @@ -9046,7 +9066,7 @@ This boolean aspect is equivalent to pragma @cite{Shared}, and is thus a synonym for aspect @cite{Atomic}. @node Aspect Simple_Storage_Pool,Aspect Simple_Storage_Pool_Type,Aspect Shared,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-simple-storage-pool}@anchor{10f} +@anchor{gnat_rm/implementation_defined_aspects aspect-simple-storage-pool}@anchor{110} @section Aspect Simple_Storage_Pool @@ -9056,7 +9076,7 @@ This aspect is equivalent to a @cite{Simple_Storage_Pool} attribute definition clause. @node Aspect Simple_Storage_Pool_Type,Aspect SPARK_Mode,Aspect Simple_Storage_Pool,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-simple-storage-pool-type}@anchor{110} +@anchor{gnat_rm/implementation_defined_aspects aspect-simple-storage-pool-type}@anchor{111} @section Aspect Simple_Storage_Pool_Type @@ -9065,7 +9085,7 @@ attribute definition clause. This boolean aspect is equivalent to pragma @cite{Simple_Storage_Pool_Type}. @node Aspect SPARK_Mode,Aspect Suppress_Debug_Info,Aspect Simple_Storage_Pool_Type,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-spark-mode}@anchor{111} +@anchor{gnat_rm/implementation_defined_aspects aspect-spark-mode}@anchor{112} @section Aspect SPARK_Mode @@ -9076,7 +9096,7 @@ may be specified for either or both of the specification and body of a subprogram or package. @node Aspect Suppress_Debug_Info,Aspect Suppress_Initialization,Aspect SPARK_Mode,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-suppress-debug-info}@anchor{112} +@anchor{gnat_rm/implementation_defined_aspects aspect-suppress-debug-info}@anchor{113} @section Aspect Suppress_Debug_Info @@ -9085,7 +9105,7 @@ of a subprogram or package. This boolean aspect is equivalent to pragma @cite{Suppress_Debug_Info}. @node Aspect Suppress_Initialization,Aspect Test_Case,Aspect Suppress_Debug_Info,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-suppress-initialization}@anchor{113} +@anchor{gnat_rm/implementation_defined_aspects aspect-suppress-initialization}@anchor{114} @section Aspect Suppress_Initialization @@ -9094,7 +9114,7 @@ This boolean aspect is equivalent to pragma @cite{Suppress_Debug_Info}. This boolean aspect is equivalent to pragma @cite{Suppress_Initialization}. @node Aspect Test_Case,Aspect Thread_Local_Storage,Aspect Suppress_Initialization,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-test-case}@anchor{114} +@anchor{gnat_rm/implementation_defined_aspects aspect-test-case}@anchor{115} @section Aspect Test_Case @@ -9103,7 +9123,7 @@ This boolean aspect is equivalent to pragma @cite{Suppress_Initialization}. This aspect is equivalent to pragma @cite{Test_Case}. @node Aspect Thread_Local_Storage,Aspect Universal_Aliasing,Aspect Test_Case,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-thread-local-storage}@anchor{115} +@anchor{gnat_rm/implementation_defined_aspects aspect-thread-local-storage}@anchor{116} @section Aspect Thread_Local_Storage @@ -9112,7 +9132,7 @@ This aspect is equivalent to pragma @cite{Test_Case}. This boolean aspect is equivalent to pragma @cite{Thread_Local_Storage}. @node Aspect Universal_Aliasing,Aspect Universal_Data,Aspect Thread_Local_Storage,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-universal-aliasing}@anchor{116} +@anchor{gnat_rm/implementation_defined_aspects aspect-universal-aliasing}@anchor{117} @section Aspect Universal_Aliasing @@ -9121,7 +9141,7 @@ This boolean aspect is equivalent to pragma @cite{Thread_Local_Storage}. This boolean aspect is equivalent to pragma @cite{Universal_Aliasing}. @node Aspect Universal_Data,Aspect Unmodified,Aspect Universal_Aliasing,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-universal-data}@anchor{117} +@anchor{gnat_rm/implementation_defined_aspects aspect-universal-data}@anchor{118} @section Aspect Universal_Data @@ -9130,7 +9150,7 @@ This boolean aspect is equivalent to pragma @cite{Universal_Aliasing}. This aspect is equivalent to pragma @cite{Universal_Data}. @node Aspect Unmodified,Aspect Unreferenced,Aspect Universal_Data,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-unmodified}@anchor{118} +@anchor{gnat_rm/implementation_defined_aspects aspect-unmodified}@anchor{119} @section Aspect Unmodified @@ -9139,7 +9159,7 @@ This aspect is equivalent to pragma @cite{Universal_Data}. This boolean aspect is equivalent to pragma @cite{Unmodified}. @node Aspect Unreferenced,Aspect Unreferenced_Objects,Aspect Unmodified,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-unreferenced}@anchor{119} +@anchor{gnat_rm/implementation_defined_aspects aspect-unreferenced}@anchor{11a} @section Aspect Unreferenced @@ -9150,7 +9170,7 @@ in the case of formal parameters, it is not permitted to have aspects for a formal parameter, so in this case the pragma form must be used. @node Aspect Unreferenced_Objects,Aspect Value_Size,Aspect Unreferenced,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-unreferenced-objects}@anchor{11a} +@anchor{gnat_rm/implementation_defined_aspects aspect-unreferenced-objects}@anchor{11b} @section Aspect Unreferenced_Objects @@ -9159,7 +9179,7 @@ a formal parameter, so in this case the pragma form must be used. This boolean aspect is equivalent to pragma @cite{Unreferenced_Objects}. @node Aspect Value_Size,Aspect Volatile_Full_Access,Aspect Unreferenced_Objects,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-value-size}@anchor{11b} +@anchor{gnat_rm/implementation_defined_aspects aspect-value-size}@anchor{11c} @section Aspect Value_Size @@ -9169,7 +9189,7 @@ This aspect is equivalent to a @cite{Value_Size} attribute definition clause. @node Aspect Volatile_Full_Access,Aspect Volatile_Function,Aspect Value_Size,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-volatile-full-access}@anchor{11c} +@anchor{gnat_rm/implementation_defined_aspects aspect-volatile-full-access}@anchor{11d} @section Aspect Volatile_Full_Access @@ -9178,7 +9198,7 @@ attribute definition clause. This boolean aspect is equivalent to pragma @cite{Volatile_Full_Access}. @node Aspect Volatile_Function,Aspect Warnings,Aspect Volatile_Full_Access,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-volatile-function}@anchor{11d} +@anchor{gnat_rm/implementation_defined_aspects aspect-volatile-function}@anchor{11e} @section Aspect Volatile_Function @@ -9187,7 +9207,7 @@ This boolean aspect is equivalent to pragma @cite{Volatile_Full_Access}. This boolean aspect is equivalent to pragma @cite{Volatile_Function}. @node Aspect Warnings,,Aspect Volatile_Function,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-warnings}@anchor{11e} +@anchor{gnat_rm/implementation_defined_aspects aspect-warnings}@anchor{11f} @section Aspect Warnings @@ -9198,7 +9218,7 @@ where the first argument is @cite{ON} or @cite{OFF} and the second argument is the entity. @node Implementation Defined Attributes,Standard and Implementation Defined Restrictions,Implementation Defined Aspects,Top -@anchor{gnat_rm/implementation_defined_attributes doc}@anchor{11f}@anchor{gnat_rm/implementation_defined_attributes implementation-defined-attributes}@anchor{8}@anchor{gnat_rm/implementation_defined_attributes id1}@anchor{120} +@anchor{gnat_rm/implementation_defined_attributes doc}@anchor{120}@anchor{gnat_rm/implementation_defined_attributes implementation-defined-attributes}@anchor{8}@anchor{gnat_rm/implementation_defined_attributes id1}@anchor{121} @chapter Implementation Defined Attributes @@ -9298,7 +9318,7 @@ consideration, you should minimize the use of these attributes. @end menu @node Attribute Abort_Signal,Attribute Address_Size,,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-abort-signal}@anchor{121} +@anchor{gnat_rm/implementation_defined_attributes attribute-abort-signal}@anchor{122} @section Attribute Abort_Signal @@ -9312,7 +9332,7 @@ completely outside the normal semantics of Ada, for a user program to intercept the abort exception). @node Attribute Address_Size,Attribute Asm_Input,Attribute Abort_Signal,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-address-size}@anchor{122} +@anchor{gnat_rm/implementation_defined_attributes attribute-address-size}@anchor{123} @section Attribute Address_Size @@ -9328,7 +9348,7 @@ reference to System.Address'Size is nonstatic because Address is a private type. @node Attribute Asm_Input,Attribute Asm_Output,Attribute Address_Size,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-asm-input}@anchor{123} +@anchor{gnat_rm/implementation_defined_attributes attribute-asm-input}@anchor{124} @section Attribute Asm_Input @@ -9342,10 +9362,10 @@ to be a static expression, and is the constraint for the parameter, value to be used as the input argument. The possible values for the constant are the same as those used in the RTL, and are dependent on the configuration file used to built the GCC back end. -@ref{124,,Machine Code Insertions} +@ref{125,,Machine Code Insertions} @node Attribute Asm_Output,Attribute Atomic_Always_Lock_Free,Attribute Asm_Input,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-asm-output}@anchor{125} +@anchor{gnat_rm/implementation_defined_attributes attribute-asm-output}@anchor{126} @section Attribute Asm_Output @@ -9361,10 +9381,10 @@ result. The possible values for constraint are the same as those used in the RTL, and are dependent on the configuration file used to build the GCC back end. If there are no output operands, then this argument may either be omitted, or explicitly given as @cite{No_Output_Operands}. -@ref{124,,Machine Code Insertions} +@ref{125,,Machine Code Insertions} @node Attribute Atomic_Always_Lock_Free,Attribute Bit,Attribute Asm_Output,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-atomic-always-lock-free}@anchor{126} +@anchor{gnat_rm/implementation_defined_attributes attribute-atomic-always-lock-free}@anchor{127} @section Attribute Atomic_Always_Lock_Free @@ -9376,7 +9396,7 @@ and False otherwise. The result indicate whether atomic operations are supported by the target for the given type. @node Attribute Bit,Attribute Bit_Position,Attribute Atomic_Always_Lock_Free,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-bit}@anchor{127} +@anchor{gnat_rm/implementation_defined_attributes attribute-bit}@anchor{128} @section Attribute Bit @@ -9407,7 +9427,7 @@ This attribute is designed to be compatible with the DEC Ada 83 definition and implementation of the @cite{Bit} attribute. @node Attribute Bit_Position,Attribute Code_Address,Attribute Bit,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-bit-position}@anchor{128} +@anchor{gnat_rm/implementation_defined_attributes attribute-bit-position}@anchor{129} @section Attribute Bit_Position @@ -9422,7 +9442,7 @@ type @cite{Universal_Integer}. The value depends only on the field the containing record @cite{R}. @node Attribute Code_Address,Attribute Compiler_Version,Attribute Bit_Position,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-code-address}@anchor{129} +@anchor{gnat_rm/implementation_defined_attributes attribute-code-address}@anchor{12a} @section Attribute Code_Address @@ -9465,7 +9485,7 @@ the same value as is returned by the corresponding @cite{'Address} attribute. @node Attribute Compiler_Version,Attribute Constrained,Attribute Code_Address,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-compiler-version}@anchor{12a} +@anchor{gnat_rm/implementation_defined_attributes attribute-compiler-version}@anchor{12b} @section Attribute Compiler_Version @@ -9476,7 +9496,7 @@ prefix) yields a static string identifying the version of the compiler being used to compile the unit containing the attribute reference. @node Attribute Constrained,Attribute Default_Bit_Order,Attribute Compiler_Version,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-constrained}@anchor{12b} +@anchor{gnat_rm/implementation_defined_attributes attribute-constrained}@anchor{12c} @section Attribute Constrained @@ -9491,7 +9511,7 @@ record type without discriminants is always @cite{True}. This usage is compatible with older Ada compilers, including notably DEC Ada. @node Attribute Default_Bit_Order,Attribute Default_Scalar_Storage_Order,Attribute Constrained,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-default-bit-order}@anchor{12c} +@anchor{gnat_rm/implementation_defined_attributes attribute-default-bit-order}@anchor{12d} @section Attribute Default_Bit_Order @@ -9508,7 +9528,7 @@ as a @cite{Pos} value (0 for @cite{High_Order_First}, 1 for @cite{Default_Bit_Order} in package @cite{System}. @node Attribute Default_Scalar_Storage_Order,Attribute Deref,Attribute Default_Bit_Order,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-default-scalar-storage-order}@anchor{12d} +@anchor{gnat_rm/implementation_defined_attributes attribute-default-scalar-storage-order}@anchor{12e} @section Attribute Default_Scalar_Storage_Order @@ -9525,7 +9545,7 @@ equal to @cite{Default_Bit_Order} if unspecified) as a @cite{System.Bit_Order} value. This is a static attribute. @node Attribute Deref,Attribute Descriptor_Size,Attribute Default_Scalar_Storage_Order,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-deref}@anchor{12e} +@anchor{gnat_rm/implementation_defined_attributes attribute-deref}@anchor{12f} @section Attribute Deref @@ -9538,7 +9558,7 @@ a named access-to-@cite{typ} type, except that it yields a variable, so it can b used on the left side of an assignment. @node Attribute Descriptor_Size,Attribute Elaborated,Attribute Deref,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-descriptor-size}@anchor{12f} +@anchor{gnat_rm/implementation_defined_attributes attribute-descriptor-size}@anchor{130} @section Attribute Descriptor_Size @@ -9565,7 +9585,7 @@ In the example above, the descriptor contains two values of type a size of 31 bits and an alignment of 4, the descriptor size is @cite{2 * Positive'Size + 2} or 64 bits. @node Attribute Elaborated,Attribute Elab_Body,Attribute Descriptor_Size,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-elaborated}@anchor{130} +@anchor{gnat_rm/implementation_defined_attributes attribute-elaborated}@anchor{131} @section Attribute Elaborated @@ -9580,7 +9600,7 @@ units has been completed. An exception is for units which need no elaboration, the value is always False for such units. @node Attribute Elab_Body,Attribute Elab_Spec,Attribute Elaborated,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-elab-body}@anchor{131} +@anchor{gnat_rm/implementation_defined_attributes attribute-elab-body}@anchor{132} @section Attribute Elab_Body @@ -9596,7 +9616,7 @@ e.g., if it is necessary to do selective re-elaboration to fix some error. @node Attribute Elab_Spec,Attribute Elab_Subp_Body,Attribute Elab_Body,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-elab-spec}@anchor{132} +@anchor{gnat_rm/implementation_defined_attributes attribute-elab-spec}@anchor{133} @section Attribute Elab_Spec @@ -9612,7 +9632,7 @@ Ada code, e.g., if it is necessary to do selective re-elaboration to fix some error. @node Attribute Elab_Subp_Body,Attribute Emax,Attribute Elab_Spec,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-elab-subp-body}@anchor{133} +@anchor{gnat_rm/implementation_defined_attributes attribute-elab-subp-body}@anchor{134} @section Attribute Elab_Subp_Body @@ -9626,7 +9646,7 @@ elaboration procedure by the binder in CodePeer mode only and is unrecognized otherwise. @node Attribute Emax,Attribute Enabled,Attribute Elab_Subp_Body,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-emax}@anchor{134} +@anchor{gnat_rm/implementation_defined_attributes attribute-emax}@anchor{135} @section Attribute Emax @@ -9639,7 +9659,7 @@ the Ada 83 reference manual for an exact description of the semantics of this attribute. @node Attribute Enabled,Attribute Enum_Rep,Attribute Emax,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-enabled}@anchor{135} +@anchor{gnat_rm/implementation_defined_attributes attribute-enabled}@anchor{136} @section Attribute Enabled @@ -9663,7 +9683,7 @@ a @cite{pragma Suppress} or @cite{pragma Unsuppress} before instantiating the package or subprogram, controlling whether the check will be present. @node Attribute Enum_Rep,Attribute Enum_Val,Attribute Enabled,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-enum-rep}@anchor{136} +@anchor{gnat_rm/implementation_defined_attributes attribute-enum-rep}@anchor{137} @section Attribute Enum_Rep @@ -9700,7 +9720,7 @@ integer calculation is done at run time, then the call to @cite{Enum_Rep} may raise @cite{Constraint_Error}. @node Attribute Enum_Val,Attribute Epsilon,Attribute Enum_Rep,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-enum-val}@anchor{137} +@anchor{gnat_rm/implementation_defined_attributes attribute-enum-val}@anchor{138} @section Attribute Enum_Val @@ -9723,7 +9743,7 @@ absence of an enumeration representation clause. This is a static attribute (i.e., the result is static if the argument is static). @node Attribute Epsilon,Attribute Fast_Math,Attribute Enum_Val,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-epsilon}@anchor{138} +@anchor{gnat_rm/implementation_defined_attributes attribute-epsilon}@anchor{139} @section Attribute Epsilon @@ -9736,7 +9756,7 @@ the Ada 83 reference manual for an exact description of the semantics of this attribute. @node Attribute Fast_Math,Attribute Fixed_Value,Attribute Epsilon,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-fast-math}@anchor{139} +@anchor{gnat_rm/implementation_defined_attributes attribute-fast-math}@anchor{13a} @section Attribute Fast_Math @@ -9747,7 +9767,7 @@ prefix) yields a static Boolean value that is True if pragma @cite{Fast_Math} is active, and False otherwise. @node Attribute Fixed_Value,Attribute From_Any,Attribute Fast_Math,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-fixed-value}@anchor{13a} +@anchor{gnat_rm/implementation_defined_attributes attribute-fixed-value}@anchor{13b} @section Attribute Fixed_Value @@ -9774,7 +9794,7 @@ This attribute is primarily intended for use in implementation of the input-output functions for fixed-point values. @node Attribute From_Any,Attribute Has_Access_Values,Attribute Fixed_Value,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-from-any}@anchor{13b} +@anchor{gnat_rm/implementation_defined_attributes attribute-from-any}@anchor{13c} @section Attribute From_Any @@ -9784,7 +9804,7 @@ This internal attribute is used for the generation of remote subprogram stubs in the context of the Distributed Systems Annex. @node Attribute Has_Access_Values,Attribute Has_Discriminants,Attribute From_Any,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-has-access-values}@anchor{13c} +@anchor{gnat_rm/implementation_defined_attributes attribute-has-access-values}@anchor{13d} @section Attribute Has_Access_Values @@ -9802,7 +9822,7 @@ definitions. If the attribute is applied to a generic private type, it indicates whether or not the corresponding actual type has access values. @node Attribute Has_Discriminants,Attribute Img,Attribute Has_Access_Values,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-has-discriminants}@anchor{13d} +@anchor{gnat_rm/implementation_defined_attributes attribute-has-discriminants}@anchor{13e} @section Attribute Has_Discriminants @@ -9818,7 +9838,7 @@ definitions. If the attribute is applied to a generic private type, it indicates whether or not the corresponding actual type has discriminants. @node Attribute Img,Attribute Integer_Value,Attribute Has_Discriminants,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-img}@anchor{13e} +@anchor{gnat_rm/implementation_defined_attributes attribute-img}@anchor{13f} @section Attribute Img @@ -9848,7 +9868,7 @@ that returns the appropriate string when called. This means that in an instantiation as a function parameter. @node Attribute Integer_Value,Attribute Invalid_Value,Attribute Img,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-integer-value}@anchor{13f} +@anchor{gnat_rm/implementation_defined_attributes attribute-integer-value}@anchor{140} @section Attribute Integer_Value @@ -9876,7 +9896,7 @@ This attribute is primarily intended for use in implementation of the standard input-output functions for fixed-point values. @node Attribute Invalid_Value,Attribute Iterable,Attribute Integer_Value,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-invalid-value}@anchor{140} +@anchor{gnat_rm/implementation_defined_attributes attribute-invalid-value}@anchor{141} @section Attribute Invalid_Value @@ -9890,7 +9910,7 @@ including the ability to modify the value with the binder -Sxx flag and relevant environment variables at run time. @node Attribute Iterable,Attribute Large,Attribute Invalid_Value,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-iterable}@anchor{141} +@anchor{gnat_rm/implementation_defined_attributes attribute-iterable}@anchor{142} @section Attribute Iterable @@ -9899,7 +9919,7 @@ relevant environment variables at run time. Equivalent to Aspect Iterable. @node Attribute Large,Attribute Library_Level,Attribute Iterable,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-large}@anchor{142} +@anchor{gnat_rm/implementation_defined_attributes attribute-large}@anchor{143} @section Attribute Large @@ -9912,7 +9932,7 @@ the Ada 83 reference manual for an exact description of the semantics of this attribute. @node Attribute Library_Level,Attribute Lock_Free,Attribute Large,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-library-level}@anchor{143} +@anchor{gnat_rm/implementation_defined_attributes attribute-library-level}@anchor{144} @section Attribute Library_Level @@ -9938,7 +9958,7 @@ end Gen; @end example @node Attribute Lock_Free,Attribute Loop_Entry,Attribute Library_Level,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-lock-free}@anchor{144} +@anchor{gnat_rm/implementation_defined_attributes attribute-lock-free}@anchor{145} @section Attribute Lock_Free @@ -9948,7 +9968,7 @@ end Gen; pragma @cite{Lock_Free} applies to P. @node Attribute Loop_Entry,Attribute Machine_Size,Attribute Lock_Free,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-loop-entry}@anchor{145} +@anchor{gnat_rm/implementation_defined_attributes attribute-loop-entry}@anchor{146} @section Attribute Loop_Entry @@ -9978,7 +9998,7 @@ entry. This copy is not performed if the loop is not entered, or if the corresponding pragmas are ignored or disabled. @node Attribute Machine_Size,Attribute Mantissa,Attribute Loop_Entry,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-machine-size}@anchor{146} +@anchor{gnat_rm/implementation_defined_attributes attribute-machine-size}@anchor{147} @section Attribute Machine_Size @@ -9988,7 +10008,7 @@ This attribute is identical to the @cite{Object_Size} attribute. It is provided for compatibility with the DEC Ada 83 attribute of this name. @node Attribute Mantissa,Attribute Maximum_Alignment,Attribute Machine_Size,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-mantissa}@anchor{147} +@anchor{gnat_rm/implementation_defined_attributes attribute-mantissa}@anchor{148} @section Attribute Mantissa @@ -10001,7 +10021,7 @@ the Ada 83 reference manual for an exact description of the semantics of this attribute. @node Attribute Maximum_Alignment,Attribute Mechanism_Code,Attribute Mantissa,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-maximum-alignment}@anchor{148}@anchor{gnat_rm/implementation_defined_attributes id2}@anchor{149} +@anchor{gnat_rm/implementation_defined_attributes attribute-maximum-alignment}@anchor{149}@anchor{gnat_rm/implementation_defined_attributes id2}@anchor{14a} @section Attribute Maximum_Alignment @@ -10017,7 +10037,7 @@ for an object, guaranteeing that it is properly aligned in all cases. @node Attribute Mechanism_Code,Attribute Null_Parameter,Attribute Maximum_Alignment,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-mechanism-code}@anchor{14a} +@anchor{gnat_rm/implementation_defined_attributes attribute-mechanism-code}@anchor{14b} @section Attribute Mechanism_Code @@ -10048,7 +10068,7 @@ by reference @end table @node Attribute Null_Parameter,Attribute Object_Size,Attribute Mechanism_Code,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-null-parameter}@anchor{14b} +@anchor{gnat_rm/implementation_defined_attributes attribute-null-parameter}@anchor{14c} @section Attribute Null_Parameter @@ -10073,7 +10093,7 @@ There is no way of indicating this without the @cite{Null_Parameter} attribute. @node Attribute Object_Size,Attribute Old,Attribute Null_Parameter,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-object-size}@anchor{14c} +@anchor{gnat_rm/implementation_defined_attributes attribute-object-size}@anchor{14d} @section Attribute Object_Size @@ -10143,7 +10163,7 @@ Similar additional checks are performed in other contexts requiring statically matching subtypes. @node Attribute Old,Attribute Passed_By_Reference,Attribute Object_Size,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-old}@anchor{14d} +@anchor{gnat_rm/implementation_defined_attributes attribute-old}@anchor{14e} @section Attribute Old @@ -10158,7 +10178,7 @@ definition are allowed under control of implementation defined pragma @cite{Unevaluated_Use_Of_Old}. @node Attribute Passed_By_Reference,Attribute Pool_Address,Attribute Old,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-passed-by-reference}@anchor{14e} +@anchor{gnat_rm/implementation_defined_attributes attribute-passed-by-reference}@anchor{14f} @section Attribute Passed_By_Reference @@ -10174,7 +10194,7 @@ passed by copy in calls. For scalar types, the result is always @cite{False} and is static. For non-scalar types, the result is nonstatic. @node Attribute Pool_Address,Attribute Range_Length,Attribute Passed_By_Reference,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-pool-address}@anchor{14f} +@anchor{gnat_rm/implementation_defined_attributes attribute-pool-address}@anchor{150} @section Attribute Pool_Address @@ -10199,7 +10219,7 @@ For an object created by @cite{new}, @code{Ptr.all'Pool_Address} is what is passed to @cite{Allocate} and returned from @cite{Deallocate}. @node Attribute Range_Length,Attribute Restriction_Set,Attribute Pool_Address,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-range-length}@anchor{150} +@anchor{gnat_rm/implementation_defined_attributes attribute-range-length}@anchor{151} @section Attribute Range_Length @@ -10212,7 +10232,7 @@ applied to the index subtype of a one dimensional array always gives the same result as @cite{Length} applied to the array itself. @node Attribute Restriction_Set,Attribute Result,Attribute Range_Length,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-restriction-set}@anchor{151} +@anchor{gnat_rm/implementation_defined_attributes attribute-restriction-set}@anchor{152} @section Attribute Restriction_Set @@ -10282,7 +10302,7 @@ Restrictions pragma, they are not analyzed semantically, so they do not have a type. @node Attribute Result,Attribute Safe_Emax,Attribute Restriction_Set,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-result}@anchor{152} +@anchor{gnat_rm/implementation_defined_attributes attribute-result}@anchor{153} @section Attribute Result @@ -10295,7 +10315,7 @@ For a further discussion of the use of this attribute and examples of its use, see the description of pragma Postcondition. @node Attribute Safe_Emax,Attribute Safe_Large,Attribute Result,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-safe-emax}@anchor{153} +@anchor{gnat_rm/implementation_defined_attributes attribute-safe-emax}@anchor{154} @section Attribute Safe_Emax @@ -10308,7 +10328,7 @@ the Ada 83 reference manual for an exact description of the semantics of this attribute. @node Attribute Safe_Large,Attribute Safe_Small,Attribute Safe_Emax,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-safe-large}@anchor{154} +@anchor{gnat_rm/implementation_defined_attributes attribute-safe-large}@anchor{155} @section Attribute Safe_Large @@ -10321,7 +10341,7 @@ the Ada 83 reference manual for an exact description of the semantics of this attribute. @node Attribute Safe_Small,Attribute Scalar_Storage_Order,Attribute Safe_Large,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-safe-small}@anchor{155} +@anchor{gnat_rm/implementation_defined_attributes attribute-safe-small}@anchor{156} @section Attribute Safe_Small @@ -10334,7 +10354,7 @@ the Ada 83 reference manual for an exact description of the semantics of this attribute. @node Attribute Scalar_Storage_Order,Attribute Simple_Storage_Pool,Attribute Safe_Small,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-scalar-storage-order}@anchor{156} +@anchor{gnat_rm/implementation_defined_attributes attribute-scalar-storage-order}@anchor{157} @section Attribute Scalar_Storage_Order @@ -10451,7 +10471,7 @@ representation. It has no effect on the representation used by stream attributes. @node Attribute Simple_Storage_Pool,Attribute Small,Attribute Scalar_Storage_Order,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-simple-storage-pool}@anchor{b8}@anchor{gnat_rm/implementation_defined_attributes id3}@anchor{157} +@anchor{gnat_rm/implementation_defined_attributes attribute-simple-storage-pool}@anchor{b9}@anchor{gnat_rm/implementation_defined_attributes id3}@anchor{158} @section Attribute Simple_Storage_Pool @@ -10514,7 +10534,7 @@ as defined in section 13.11.2 of the Ada Reference Manual, except that the term 'simple storage pool' is substituted for 'storage pool'. @node Attribute Small,Attribute Storage_Unit,Attribute Simple_Storage_Pool,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-small}@anchor{158} +@anchor{gnat_rm/implementation_defined_attributes attribute-small}@anchor{159} @section Attribute Small @@ -10530,7 +10550,7 @@ the Ada 83 reference manual for an exact description of the semantics of this attribute when applied to floating-point types. @node Attribute Storage_Unit,Attribute Stub_Type,Attribute Small,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-storage-unit}@anchor{159} +@anchor{gnat_rm/implementation_defined_attributes attribute-storage-unit}@anchor{15a} @section Attribute Storage_Unit @@ -10540,7 +10560,7 @@ this attribute when applied to floating-point types. prefix) provides the same value as @cite{System.Storage_Unit}. @node Attribute Stub_Type,Attribute System_Allocator_Alignment,Attribute Storage_Unit,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-stub-type}@anchor{15a} +@anchor{gnat_rm/implementation_defined_attributes attribute-stub-type}@anchor{15b} @section Attribute Stub_Type @@ -10564,7 +10584,7 @@ unit @cite{System.Partition_Interface}. Use of this attribute will create an implicit dependency on this unit. @node Attribute System_Allocator_Alignment,Attribute Target_Name,Attribute Stub_Type,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-system-allocator-alignment}@anchor{15b} +@anchor{gnat_rm/implementation_defined_attributes attribute-system-allocator-alignment}@anchor{15c} @section Attribute System_Allocator_Alignment @@ -10581,7 +10601,7 @@ with alignment too large or to enable a realignment circuitry if the alignment request is larger than this value. @node Attribute Target_Name,Attribute To_Address,Attribute System_Allocator_Alignment,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-target-name}@anchor{15c} +@anchor{gnat_rm/implementation_defined_attributes attribute-target-name}@anchor{15d} @section Attribute Target_Name @@ -10594,7 +10614,7 @@ standard gcc target name without the terminating slash (for example, GNAT 5.0 on windows yields "i586-pc-mingw32msv"). @node Attribute To_Address,Attribute To_Any,Attribute Target_Name,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-to-address}@anchor{15d} +@anchor{gnat_rm/implementation_defined_attributes attribute-to-address}@anchor{15e} @section Attribute To_Address @@ -10617,7 +10637,7 @@ modular manner (e.g., -1 means the same as 16#FFFF_FFFF# on a 32 bits machine). @node Attribute To_Any,Attribute Type_Class,Attribute To_Address,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-to-any}@anchor{15e} +@anchor{gnat_rm/implementation_defined_attributes attribute-to-any}@anchor{15f} @section Attribute To_Any @@ -10627,7 +10647,7 @@ This internal attribute is used for the generation of remote subprogram stubs in the context of the Distributed Systems Annex. @node Attribute Type_Class,Attribute Type_Key,Attribute To_Any,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-type-class}@anchor{15f} +@anchor{gnat_rm/implementation_defined_attributes attribute-type-class}@anchor{160} @section Attribute Type_Class @@ -10657,7 +10677,7 @@ applies to all concurrent types. This attribute is designed to be compatible with the DEC Ada 83 attribute of the same name. @node Attribute Type_Key,Attribute TypeCode,Attribute Type_Class,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-type-key}@anchor{160} +@anchor{gnat_rm/implementation_defined_attributes attribute-type-key}@anchor{161} @section Attribute Type_Key @@ -10669,7 +10689,7 @@ about the type or subtype. This provides improved compatibility with other implementations that support this attribute. @node Attribute TypeCode,Attribute Unconstrained_Array,Attribute Type_Key,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-typecode}@anchor{161} +@anchor{gnat_rm/implementation_defined_attributes attribute-typecode}@anchor{162} @section Attribute TypeCode @@ -10679,7 +10699,7 @@ This internal attribute is used for the generation of remote subprogram stubs in the context of the Distributed Systems Annex. @node Attribute Unconstrained_Array,Attribute Universal_Literal_String,Attribute TypeCode,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-unconstrained-array}@anchor{162} +@anchor{gnat_rm/implementation_defined_attributes attribute-unconstrained-array}@anchor{163} @section Attribute Unconstrained_Array @@ -10693,7 +10713,7 @@ still static, and yields the result of applying this test to the generic actual. @node Attribute Universal_Literal_String,Attribute Unrestricted_Access,Attribute Unconstrained_Array,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-universal-literal-string}@anchor{163} +@anchor{gnat_rm/implementation_defined_attributes attribute-universal-literal-string}@anchor{164} @section Attribute Universal_Literal_String @@ -10721,7 +10741,7 @@ end; @end example @node Attribute Unrestricted_Access,Attribute Update,Attribute Universal_Literal_String,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-unrestricted-access}@anchor{164} +@anchor{gnat_rm/implementation_defined_attributes attribute-unrestricted-access}@anchor{165} @section Attribute Unrestricted_Access @@ -10908,7 +10928,7 @@ In general this is a risky approach. It may appear to "work" but such uses of of @cite{GNAT} to another, so are best avoided if possible. @node Attribute Update,Attribute Valid_Scalars,Attribute Unrestricted_Access,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-update}@anchor{165} +@anchor{gnat_rm/implementation_defined_attributes attribute-update}@anchor{166} @section Attribute Update @@ -10989,7 +11009,7 @@ A := A'Update ((1, 2) => 20, (3, 4) => 30); which changes element (1,2) to 20 and (3,4) to 30. @node Attribute Valid_Scalars,Attribute VADS_Size,Attribute Update,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-valid-scalars}@anchor{166} +@anchor{gnat_rm/implementation_defined_attributes attribute-valid-scalars}@anchor{167} @section Attribute Valid_Scalars @@ -11024,7 +11044,7 @@ to write a function with a single use of the attribute, and then call that function from multiple places. @node Attribute VADS_Size,Attribute Value_Size,Attribute Valid_Scalars,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-vads-size}@anchor{167} +@anchor{gnat_rm/implementation_defined_attributes attribute-vads-size}@anchor{168} @section Attribute VADS_Size @@ -11044,7 +11064,7 @@ gives the result that would be obtained by applying the attribute to the corresponding type. @node Attribute Value_Size,Attribute Wchar_T_Size,Attribute VADS_Size,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-value-size}@anchor{168} +@anchor{gnat_rm/implementation_defined_attributes attribute-value-size}@anchor{169} @section Attribute Value_Size @@ -11058,7 +11078,7 @@ a value of the given subtype. It is the same as @code{type'Size}, but, unlike @cite{Size}, may be set for non-first subtypes. @node Attribute Wchar_T_Size,Attribute Word_Size,Attribute Value_Size,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-wchar-t-size}@anchor{169} +@anchor{gnat_rm/implementation_defined_attributes attribute-wchar-t-size}@anchor{16a} @section Attribute Wchar_T_Size @@ -11070,7 +11090,7 @@ primarily for constructing the definition of this type in package @cite{Interfaces.C}. The result is a static constant. @node Attribute Word_Size,,Attribute Wchar_T_Size,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-word-size}@anchor{16a} +@anchor{gnat_rm/implementation_defined_attributes attribute-word-size}@anchor{16b} @section Attribute Word_Size @@ -11081,7 +11101,7 @@ prefix) provides the value @cite{System.Word_Size}. The result is a static constant. @node Standard and Implementation Defined Restrictions,Implementation Advice,Implementation Defined Attributes,Top -@anchor{gnat_rm/standard_and_implementation_defined_restrictions standard-and-implementation-defined-restrictions}@anchor{9}@anchor{gnat_rm/standard_and_implementation_defined_restrictions doc}@anchor{16b}@anchor{gnat_rm/standard_and_implementation_defined_restrictions id1}@anchor{16c} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions standard-and-implementation-defined-restrictions}@anchor{9}@anchor{gnat_rm/standard_and_implementation_defined_restrictions doc}@anchor{16c}@anchor{gnat_rm/standard_and_implementation_defined_restrictions id1}@anchor{16d} @chapter Standard and Implementation Defined Restrictions @@ -11110,7 +11130,7 @@ language defined or GNAT-specific, are listed in the following. @end menu @node Partition-Wide Restrictions,Program Unit Level Restrictions,,Standard and Implementation Defined Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions partition-wide-restrictions}@anchor{16d}@anchor{gnat_rm/standard_and_implementation_defined_restrictions id2}@anchor{16e} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions partition-wide-restrictions}@anchor{16e}@anchor{gnat_rm/standard_and_implementation_defined_restrictions id2}@anchor{16f} @section Partition-Wide Restrictions @@ -11199,7 +11219,7 @@ then all compilation units in the partition must obey the restriction). @end menu @node Immediate_Reclamation,Max_Asynchronous_Select_Nesting,,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions immediate-reclamation}@anchor{16f} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions immediate-reclamation}@anchor{170} @subsection Immediate_Reclamation @@ -11211,7 +11231,7 @@ deallocation, any storage reserved at run time for an object is immediately reclaimed when the object no longer exists. @node Max_Asynchronous_Select_Nesting,Max_Entry_Queue_Length,Immediate_Reclamation,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions max-asynchronous-select-nesting}@anchor{170} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions max-asynchronous-select-nesting}@anchor{171} @subsection Max_Asynchronous_Select_Nesting @@ -11223,7 +11243,7 @@ detected at compile time. Violations of this restriction with values other than zero cause Storage_Error to be raised. @node Max_Entry_Queue_Length,Max_Protected_Entries,Max_Asynchronous_Select_Nesting,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions max-entry-queue-length}@anchor{171} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions max-entry-queue-length}@anchor{172} @subsection Max_Entry_Queue_Length @@ -11244,7 +11264,7 @@ compatibility purposes (and a warning will be generated for its use if warnings on obsolescent features are activated). @node Max_Protected_Entries,Max_Select_Alternatives,Max_Entry_Queue_Length,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions max-protected-entries}@anchor{172} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions max-protected-entries}@anchor{173} @subsection Max_Protected_Entries @@ -11255,7 +11275,7 @@ bounds of every entry family of a protected unit shall be static, or shall be defined by a discriminant of a subtype whose corresponding bound is static. @node Max_Select_Alternatives,Max_Storage_At_Blocking,Max_Protected_Entries,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions max-select-alternatives}@anchor{173} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions max-select-alternatives}@anchor{174} @subsection Max_Select_Alternatives @@ -11264,7 +11284,7 @@ defined by a discriminant of a subtype whose corresponding bound is static. [RM D.7] Specifies the maximum number of alternatives in a selective accept. @node Max_Storage_At_Blocking,Max_Task_Entries,Max_Select_Alternatives,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions max-storage-at-blocking}@anchor{174} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions max-storage-at-blocking}@anchor{175} @subsection Max_Storage_At_Blocking @@ -11275,7 +11295,7 @@ Storage_Size that can be retained by a blocked task. A violation of this restriction causes Storage_Error to be raised. @node Max_Task_Entries,Max_Tasks,Max_Storage_At_Blocking,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions max-task-entries}@anchor{175} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions max-task-entries}@anchor{176} @subsection Max_Task_Entries @@ -11288,7 +11308,7 @@ defined by a discriminant of a subtype whose corresponding bound is static. @node Max_Tasks,No_Abort_Statements,Max_Task_Entries,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions max-tasks}@anchor{176} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions max-tasks}@anchor{177} @subsection Max_Tasks @@ -11301,7 +11321,7 @@ time. Violations of this restriction with values other than zero cause Storage_Error to be raised. @node No_Abort_Statements,No_Access_Parameter_Allocators,Max_Tasks,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-abort-statements}@anchor{177} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-abort-statements}@anchor{178} @subsection No_Abort_Statements @@ -11311,7 +11331,7 @@ Storage_Error to be raised. no calls to Task_Identification.Abort_Task. @node No_Access_Parameter_Allocators,No_Access_Subprograms,No_Abort_Statements,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-access-parameter-allocators}@anchor{178} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-access-parameter-allocators}@anchor{179} @subsection No_Access_Parameter_Allocators @@ -11322,7 +11342,7 @@ occurrences of an allocator as the actual parameter to an access parameter. @node No_Access_Subprograms,No_Allocators,No_Access_Parameter_Allocators,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-access-subprograms}@anchor{179} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-access-subprograms}@anchor{17a} @subsection No_Access_Subprograms @@ -11332,7 +11352,7 @@ parameter. declarations of access-to-subprogram types. @node No_Allocators,No_Anonymous_Allocators,No_Access_Subprograms,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-allocators}@anchor{17a} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-allocators}@anchor{17b} @subsection No_Allocators @@ -11342,7 +11362,7 @@ declarations of access-to-subprogram types. occurrences of an allocator. @node No_Anonymous_Allocators,No_Asynchronous_Control,No_Allocators,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-anonymous-allocators}@anchor{17b} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-anonymous-allocators}@anchor{17c} @subsection No_Anonymous_Allocators @@ -11352,7 +11372,7 @@ occurrences of an allocator. occurrences of an allocator of anonymous access type. @node No_Asynchronous_Control,No_Calendar,No_Anonymous_Allocators,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-asynchronous-control}@anchor{17c} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-asynchronous-control}@anchor{17d} @subsection No_Asynchronous_Control @@ -11362,7 +11382,7 @@ occurrences of an allocator of anonymous access type. dependences on the predefined package Asynchronous_Task_Control. @node No_Calendar,No_Coextensions,No_Asynchronous_Control,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-calendar}@anchor{17d} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-calendar}@anchor{17e} @subsection No_Calendar @@ -11372,7 +11392,7 @@ dependences on the predefined package Asynchronous_Task_Control. dependences on package Calendar. @node No_Coextensions,No_Default_Initialization,No_Calendar,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-coextensions}@anchor{17e} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-coextensions}@anchor{17f} @subsection No_Coextensions @@ -11382,7 +11402,7 @@ dependences on package Calendar. coextensions. See 3.10.2. @node No_Default_Initialization,No_Delay,No_Coextensions,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-default-initialization}@anchor{17f} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-default-initialization}@anchor{180} @subsection No_Default_Initialization @@ -11399,7 +11419,7 @@ is to prohibit all cases of variables declared without a specific initializer (including the case of OUT scalar parameters). @node No_Delay,No_Dependence,No_Default_Initialization,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-delay}@anchor{180} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-delay}@anchor{181} @subsection No_Delay @@ -11409,7 +11429,7 @@ initializer (including the case of OUT scalar parameters). delay statements and no semantic dependences on package Calendar. @node No_Dependence,No_Direct_Boolean_Operators,No_Delay,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-dependence}@anchor{181} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-dependence}@anchor{182} @subsection No_Dependence @@ -11419,7 +11439,7 @@ delay statements and no semantic dependences on package Calendar. dependences on a library unit. @node No_Direct_Boolean_Operators,No_Dispatch,No_Dependence,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-direct-boolean-operators}@anchor{182} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-direct-boolean-operators}@anchor{183} @subsection No_Direct_Boolean_Operators @@ -11432,7 +11452,7 @@ protocol requires the use of short-circuit (and then, or else) forms for all composite boolean operations. @node No_Dispatch,No_Dispatching_Calls,No_Direct_Boolean_Operators,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-dispatch}@anchor{183} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-dispatch}@anchor{184} @subsection No_Dispatch @@ -11442,7 +11462,7 @@ composite boolean operations. occurrences of @cite{T'Class}, for any (tagged) subtype @cite{T}. @node No_Dispatching_Calls,No_Dynamic_Attachment,No_Dispatch,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-dispatching-calls}@anchor{184} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-dispatching-calls}@anchor{185} @subsection No_Dispatching_Calls @@ -11503,7 +11523,7 @@ end Example; @end example @node No_Dynamic_Attachment,No_Dynamic_Priorities,No_Dispatching_Calls,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-dynamic-attachment}@anchor{185} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-dynamic-attachment}@anchor{186} @subsection No_Dynamic_Attachment @@ -11522,7 +11542,7 @@ compatibility purposes (and a warning will be generated for its use if warnings on obsolescent features are activated). @node No_Dynamic_Priorities,No_Entry_Calls_In_Elaboration_Code,No_Dynamic_Attachment,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-dynamic-priorities}@anchor{186} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-dynamic-priorities}@anchor{187} @subsection No_Dynamic_Priorities @@ -11531,7 +11551,7 @@ warnings on obsolescent features are activated). [RM D.7] There are no semantic dependencies on the package Dynamic_Priorities. @node No_Entry_Calls_In_Elaboration_Code,No_Enumeration_Maps,No_Dynamic_Priorities,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-entry-calls-in-elaboration-code}@anchor{187} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-entry-calls-in-elaboration-code}@anchor{188} @subsection No_Entry_Calls_In_Elaboration_Code @@ -11543,7 +11563,7 @@ restriction, the compiler can assume that no code past an accept statement in a task can be executed at elaboration time. @node No_Enumeration_Maps,No_Exception_Handlers,No_Entry_Calls_In_Elaboration_Code,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-enumeration-maps}@anchor{188} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-enumeration-maps}@anchor{189} @subsection No_Enumeration_Maps @@ -11554,7 +11574,7 @@ enumeration maps are used (that is Image and Value attributes applied to enumeration types). @node No_Exception_Handlers,No_Exception_Propagation,No_Enumeration_Maps,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-exception-handlers}@anchor{189} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-exception-handlers}@anchor{18a} @subsection No_Exception_Handlers @@ -11579,7 +11599,7 @@ statement generated by the compiler). The Line parameter when nonzero represents the line number in the source program where the raise occurs. @node No_Exception_Propagation,No_Exception_Registration,No_Exception_Handlers,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-exception-propagation}@anchor{18a} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-exception-propagation}@anchor{18b} @subsection No_Exception_Propagation @@ -11596,7 +11616,7 @@ the package GNAT.Current_Exception is not permitted, and reraise statements (raise with no operand) are not permitted. @node No_Exception_Registration,No_Exceptions,No_Exception_Propagation,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-exception-registration}@anchor{18b} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-exception-registration}@anchor{18c} @subsection No_Exception_Registration @@ -11610,7 +11630,7 @@ code is simplified by omitting the otherwise-required global registration of exceptions when they are declared. @node No_Exceptions,No_Finalization,No_Exception_Registration,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-exceptions}@anchor{18c} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-exceptions}@anchor{18d} @subsection No_Exceptions @@ -11620,7 +11640,7 @@ of exceptions when they are declared. raise statements and no exception handlers. @node No_Finalization,No_Fixed_Point,No_Exceptions,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-finalization}@anchor{18d} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-finalization}@anchor{18e} @subsection No_Finalization @@ -11661,7 +11681,7 @@ object or a nested component, either declared on the stack or on the heap. The deallocation of a controlled object no longer finalizes its contents. @node No_Fixed_Point,No_Floating_Point,No_Finalization,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-fixed-point}@anchor{18e} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-fixed-point}@anchor{18f} @subsection No_Fixed_Point @@ -11671,7 +11691,7 @@ deallocation of a controlled object no longer finalizes its contents. occurrences of fixed point types and operations. @node No_Floating_Point,No_Implicit_Conditionals,No_Fixed_Point,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-floating-point}@anchor{18f} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-floating-point}@anchor{190} @subsection No_Floating_Point @@ -11681,7 +11701,7 @@ occurrences of fixed point types and operations. occurrences of floating point types and operations. @node No_Implicit_Conditionals,No_Implicit_Dynamic_Code,No_Floating_Point,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-conditionals}@anchor{190} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-conditionals}@anchor{191} @subsection No_Implicit_Conditionals @@ -11697,7 +11717,7 @@ normal manner. Constructs generating implicit conditionals include comparisons of composite objects and the Max/Min attributes. @node No_Implicit_Dynamic_Code,No_Implicit_Heap_Allocations,No_Implicit_Conditionals,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-dynamic-code}@anchor{191} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-dynamic-code}@anchor{192} @subsection No_Implicit_Dynamic_Code @@ -11727,7 +11747,7 @@ foreign-language convention; primitive operations of nested tagged types. @node No_Implicit_Heap_Allocations,No_Implicit_Loops,No_Implicit_Dynamic_Code,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-heap-allocations}@anchor{192} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-heap-allocations}@anchor{193} @subsection No_Implicit_Heap_Allocations @@ -11736,7 +11756,7 @@ types. [RM D.7] No constructs are allowed to cause implicit heap allocation. @node No_Implicit_Loops,No_Implicit_Protected_Object_Allocations,No_Implicit_Heap_Allocations,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-loops}@anchor{193} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-loops}@anchor{194} @subsection No_Implicit_Loops @@ -11753,7 +11773,7 @@ components. Otherwise, a loop is created for arrays larger than about 5000 scalar components. @node No_Implicit_Protected_Object_Allocations,No_Implicit_Task_Allocations,No_Implicit_Loops,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-protected-object-allocations}@anchor{194} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-protected-object-allocations}@anchor{195} @subsection No_Implicit_Protected_Object_Allocations @@ -11763,7 +11783,7 @@ scalar components. protected object. @node No_Implicit_Task_Allocations,No_Initialize_Scalars,No_Implicit_Protected_Object_Allocations,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-task-allocations}@anchor{195} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-task-allocations}@anchor{196} @subsection No_Implicit_Task_Allocations @@ -11772,7 +11792,7 @@ protected object. [GNAT] No constructs are allowed to cause implicit heap allocation of a task. @node No_Initialize_Scalars,No_IO,No_Implicit_Task_Allocations,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-initialize-scalars}@anchor{196} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-initialize-scalars}@anchor{197} @subsection No_Initialize_Scalars @@ -11784,7 +11804,7 @@ code, and in particular eliminates dummy null initialization routines that are otherwise generated for some record and array types. @node No_IO,No_Local_Allocators,No_Initialize_Scalars,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-io}@anchor{197} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-io}@anchor{198} @subsection No_IO @@ -11795,7 +11815,7 @@ dependences on any of the library units Sequential_IO, Direct_IO, Text_IO, Wide_Text_IO, Wide_Wide_Text_IO, or Stream_IO. @node No_Local_Allocators,No_Local_Protected_Objects,No_IO,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-local-allocators}@anchor{198} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-local-allocators}@anchor{199} @subsection No_Local_Allocators @@ -11806,7 +11826,7 @@ occurrences of an allocator in subprograms, generic subprograms, tasks, and entry bodies. @node No_Local_Protected_Objects,No_Local_Timing_Events,No_Local_Allocators,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-local-protected-objects}@anchor{199} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-local-protected-objects}@anchor{19a} @subsection No_Local_Protected_Objects @@ -11816,7 +11836,7 @@ and entry bodies. only declared at the library level. @node No_Local_Timing_Events,No_Long_Long_Integers,No_Local_Protected_Objects,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-local-timing-events}@anchor{19a} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-local-timing-events}@anchor{19b} @subsection No_Local_Timing_Events @@ -11826,7 +11846,7 @@ only declared at the library level. declared at the library level. @node No_Long_Long_Integers,No_Multiple_Elaboration,No_Local_Timing_Events,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-long-long-integers}@anchor{19b} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-long-long-integers}@anchor{19c} @subsection No_Long_Long_Integers @@ -11838,7 +11858,7 @@ implicit base type is Long_Long_Integer, and modular types whose size exceeds Long_Integer'Size. @node No_Multiple_Elaboration,No_Nested_Finalization,No_Long_Long_Integers,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-multiple-elaboration}@anchor{19c} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-multiple-elaboration}@anchor{19d} @subsection No_Multiple_Elaboration @@ -11859,7 +11879,7 @@ possible, including non-Ada main programs, and Stand Alone libraries, are not permitted, and will be diagnosed by the binder. @node No_Nested_Finalization,No_Protected_Type_Allocators,No_Multiple_Elaboration,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-nested-finalization}@anchor{19d} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-nested-finalization}@anchor{19e} @subsection No_Nested_Finalization @@ -11868,7 +11888,7 @@ permitted, and will be diagnosed by the binder. [RM D.7] All objects requiring finalization are declared at the library level. @node No_Protected_Type_Allocators,No_Protected_Types,No_Nested_Finalization,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-protected-type-allocators}@anchor{19e} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-protected-type-allocators}@anchor{19f} @subsection No_Protected_Type_Allocators @@ -11878,7 +11898,7 @@ permitted, and will be diagnosed by the binder. expressions that attempt to allocate protected objects. @node No_Protected_Types,No_Recursion,No_Protected_Type_Allocators,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-protected-types}@anchor{19f} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-protected-types}@anchor{1a0} @subsection No_Protected_Types @@ -11888,7 +11908,7 @@ expressions that attempt to allocate protected objects. declarations of protected types or protected objects. @node No_Recursion,No_Reentrancy,No_Protected_Types,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-recursion}@anchor{1a0} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-recursion}@anchor{1a1} @subsection No_Recursion @@ -11898,7 +11918,7 @@ declarations of protected types or protected objects. part of its execution. @node No_Reentrancy,No_Relative_Delay,No_Recursion,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-reentrancy}@anchor{1a1} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-reentrancy}@anchor{1a2} @subsection No_Reentrancy @@ -11908,7 +11928,7 @@ part of its execution. two tasks at the same time. @node No_Relative_Delay,No_Requeue_Statements,No_Reentrancy,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-relative-delay}@anchor{1a2} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-relative-delay}@anchor{1a3} @subsection No_Relative_Delay @@ -11919,7 +11939,7 @@ relative statements and prevents expressions such as @cite{delay 1.23;} from appearing in source code. @node No_Requeue_Statements,No_Secondary_Stack,No_Relative_Delay,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-requeue-statements}@anchor{1a3} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-requeue-statements}@anchor{1a4} @subsection No_Requeue_Statements @@ -11937,7 +11957,7 @@ compatibility purposes (and a warning will be generated for its use if warnings on oNobsolescent features are activated). @node No_Secondary_Stack,No_Select_Statements,No_Requeue_Statements,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-secondary-stack}@anchor{1a4} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-secondary-stack}@anchor{1a5} @subsection No_Secondary_Stack @@ -11949,7 +11969,7 @@ stack is used to implement functions returning unconstrained objects (arrays or records) on some targets. @node No_Select_Statements,No_Specific_Termination_Handlers,No_Secondary_Stack,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-select-statements}@anchor{1a5} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-select-statements}@anchor{1a6} @subsection No_Select_Statements @@ -11959,7 +11979,7 @@ stack is used to implement functions returning unconstrained objects kind are permitted, that is the keyword @cite{select} may not appear. @node No_Specific_Termination_Handlers,No_Specification_of_Aspect,No_Select_Statements,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-specific-termination-handlers}@anchor{1a6} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-specific-termination-handlers}@anchor{1a7} @subsection No_Specific_Termination_Handlers @@ -11969,7 +11989,7 @@ kind are permitted, that is the keyword @cite{select} may not appear. or to Ada.Task_Termination.Specific_Handler. @node No_Specification_of_Aspect,No_Standard_Allocators_After_Elaboration,No_Specific_Termination_Handlers,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-specification-of-aspect}@anchor{1a7} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-specification-of-aspect}@anchor{1a8} @subsection No_Specification_of_Aspect @@ -11980,7 +12000,7 @@ specification, attribute definition clause, or pragma is given for a given aspect. @node No_Standard_Allocators_After_Elaboration,No_Standard_Storage_Pools,No_Specification_of_Aspect,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-standard-allocators-after-elaboration}@anchor{1a8} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-standard-allocators-after-elaboration}@anchor{1a9} @subsection No_Standard_Allocators_After_Elaboration @@ -11992,7 +12012,7 @@ library items of the partition has completed. Otherwise, Storage_Error is raised. @node No_Standard_Storage_Pools,No_Stream_Optimizations,No_Standard_Allocators_After_Elaboration,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-standard-storage-pools}@anchor{1a9} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-standard-storage-pools}@anchor{1aa} @subsection No_Standard_Storage_Pools @@ -12004,7 +12024,7 @@ have an explicit Storage_Pool attribute defined specifying a user-defined storage pool. @node No_Stream_Optimizations,No_Streams,No_Standard_Storage_Pools,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-stream-optimizations}@anchor{1aa} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-stream-optimizations}@anchor{1ab} @subsection No_Stream_Optimizations @@ -12017,7 +12037,7 @@ due to their supperior performance. When this restriction is in effect, the compiler performs all IO operations on a per-character basis. @node No_Streams,No_Task_Allocators,No_Stream_Optimizations,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-streams}@anchor{1ab} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-streams}@anchor{1ac} @subsection No_Streams @@ -12038,7 +12058,7 @@ unit declaring a tagged type should be compiled with the restriction, though this is not required. @node No_Task_Allocators,No_Task_At_Interrupt_Priority,No_Streams,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-task-allocators}@anchor{1ac} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-task-allocators}@anchor{1ad} @subsection No_Task_Allocators @@ -12048,7 +12068,7 @@ though this is not required. or types containing task subcomponents. @node No_Task_At_Interrupt_Priority,No_Task_Attributes_Package,No_Task_Allocators,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-task-at-interrupt-priority}@anchor{1ad} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-task-at-interrupt-priority}@anchor{1ae} @subsection No_Task_At_Interrupt_Priority @@ -12060,7 +12080,7 @@ a consequence, the tasks are always created with a priority below that an interrupt priority. @node No_Task_Attributes_Package,No_Task_Hierarchy,No_Task_At_Interrupt_Priority,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-task-attributes-package}@anchor{1ae} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-task-attributes-package}@anchor{1af} @subsection No_Task_Attributes_Package @@ -12077,7 +12097,7 @@ compatibility purposes (and a warning will be generated for its use if warnings on obsolescent features are activated). @node No_Task_Hierarchy,No_Task_Termination,No_Task_Attributes_Package,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-task-hierarchy}@anchor{1af} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-task-hierarchy}@anchor{1b0} @subsection No_Task_Hierarchy @@ -12087,7 +12107,7 @@ warnings on obsolescent features are activated). directly on the environment task of the partition. @node No_Task_Termination,No_Tasking,No_Task_Hierarchy,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-task-termination}@anchor{1b0} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-task-termination}@anchor{1b1} @subsection No_Task_Termination @@ -12096,7 +12116,7 @@ directly on the environment task of the partition. [RM D.7] Tasks that terminate are erroneous. @node No_Tasking,No_Terminate_Alternatives,No_Task_Termination,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-tasking}@anchor{1b1} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-tasking}@anchor{1b2} @subsection No_Tasking @@ -12109,7 +12129,7 @@ and cause an error message to be output either by the compiler or binder. @node No_Terminate_Alternatives,No_Unchecked_Access,No_Tasking,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-terminate-alternatives}@anchor{1b2} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-terminate-alternatives}@anchor{1b3} @subsection No_Terminate_Alternatives @@ -12118,7 +12138,7 @@ binder. [RM D.7] There are no selective accepts with terminate alternatives. @node No_Unchecked_Access,No_Unchecked_Conversion,No_Terminate_Alternatives,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-unchecked-access}@anchor{1b3} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-unchecked-access}@anchor{1b4} @subsection No_Unchecked_Access @@ -12128,7 +12148,7 @@ binder. occurrences of the Unchecked_Access attribute. @node No_Unchecked_Conversion,No_Unchecked_Deallocation,No_Unchecked_Access,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-unchecked-conversion}@anchor{1b4} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-unchecked-conversion}@anchor{1b5} @subsection No_Unchecked_Conversion @@ -12138,7 +12158,7 @@ occurrences of the Unchecked_Access attribute. dependences on the predefined generic function Unchecked_Conversion. @node No_Unchecked_Deallocation,No_Use_Of_Entity,No_Unchecked_Conversion,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-unchecked-deallocation}@anchor{1b5} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-unchecked-deallocation}@anchor{1b6} @subsection No_Unchecked_Deallocation @@ -12148,7 +12168,7 @@ dependences on the predefined generic function Unchecked_Conversion. dependences on the predefined generic procedure Unchecked_Deallocation. @node No_Use_Of_Entity,Simple_Barriers,No_Unchecked_Deallocation,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-use-of-entity}@anchor{1b6} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-use-of-entity}@anchor{1b7} @subsection No_Use_Of_Entity @@ -12168,7 +12188,7 @@ No_Use_Of_Entity => Ada.Text_IO.Put_Line @end example @node Simple_Barriers,Static_Priorities,No_Use_Of_Entity,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions simple-barriers}@anchor{1b7} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions simple-barriers}@anchor{1b8} @subsection Simple_Barriers @@ -12187,7 +12207,7 @@ compatibility purposes (and a warning will be generated for its use if warnings on obsolescent features are activated). @node Static_Priorities,Static_Storage_Size,Simple_Barriers,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions static-priorities}@anchor{1b8} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions static-priorities}@anchor{1b9} @subsection Static_Priorities @@ -12198,7 +12218,7 @@ are static, and that there are no dependences on the package @cite{Ada.Dynamic_Priorities}. @node Static_Storage_Size,,Static_Priorities,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions static-storage-size}@anchor{1b9} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions static-storage-size}@anchor{1ba} @subsection Static_Storage_Size @@ -12208,7 +12228,7 @@ are static, and that there are no dependences on the package in a Storage_Size pragma or attribute definition clause is static. @node Program Unit Level Restrictions,,Partition-Wide Restrictions,Standard and Implementation Defined Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions program-unit-level-restrictions}@anchor{1ba}@anchor{gnat_rm/standard_and_implementation_defined_restrictions id3}@anchor{1bb} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions program-unit-level-restrictions}@anchor{1bb}@anchor{gnat_rm/standard_and_implementation_defined_restrictions id3}@anchor{1bc} @section Program Unit Level Restrictions @@ -12220,6 +12240,7 @@ other compilation units in the partition. @menu * No_Elaboration_Code:: +* No_Dynamic_Sized_Objects:: * No_Entry_Queue:: * No_Implementation_Aspect_Specifications:: * No_Implementation_Attributes:: @@ -12234,8 +12255,8 @@ other compilation units in the partition. @end menu -@node No_Elaboration_Code,No_Entry_Queue,,Program Unit Level Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-elaboration-code}@anchor{1bc} +@node No_Elaboration_Code,No_Dynamic_Sized_Objects,,Program Unit Level Restrictions +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-elaboration-code}@anchor{1bd} @subsection No_Elaboration_Code @@ -12284,8 +12305,26 @@ Note that this the implementation of this restriction requires full code generation. If it is used in conjunction with "semantics only" checking, then some cases of violations may be missed. -@node No_Entry_Queue,No_Implementation_Aspect_Specifications,No_Elaboration_Code,Program Unit Level Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-entry-queue}@anchor{1bd} +@node No_Dynamic_Sized_Objects,No_Entry_Queue,No_Elaboration_Code,Program Unit Level Restrictions +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-dynamic-sized-objects}@anchor{1be} +@subsection No_Dynamic_Sized_Objects + + +@geindex No_Dynamic_Sized_Objects + +[GNAT] This restriction disallows certain constructs that might lead to the +creation of dynamic-sized composite objects (or array or discriminated type). +An array subtype indication is illegal if the bounds are not static +or references to discriminants of an enclosing type. +A discriminated subtype indication is illegal if the type has +discriminant-dependent array components or a variant part, and the +discriminants are not static. In addition, array and record aggregates are +illegal in corresponding cases. Note that this restriction does not forbid +access discriminants. It is often a good idea to combine this restriction +with No_Secondary_Stack. + +@node No_Entry_Queue,No_Implementation_Aspect_Specifications,No_Dynamic_Sized_Objects,Program Unit Level Restrictions +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-entry-queue}@anchor{1bf} @subsection No_Entry_Queue @@ -12298,7 +12337,7 @@ checked at compile time. A program execution is erroneous if an attempt is made to queue a second task on such an entry. @node No_Implementation_Aspect_Specifications,No_Implementation_Attributes,No_Entry_Queue,Program Unit Level Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implementation-aspect-specifications}@anchor{1be} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implementation-aspect-specifications}@anchor{1c0} @subsection No_Implementation_Aspect_Specifications @@ -12309,7 +12348,7 @@ GNAT-defined aspects are present. With this restriction, the only aspects that can be used are those defined in the Ada Reference Manual. @node No_Implementation_Attributes,No_Implementation_Identifiers,No_Implementation_Aspect_Specifications,Program Unit Level Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implementation-attributes}@anchor{1bf} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implementation-attributes}@anchor{1c1} @subsection No_Implementation_Attributes @@ -12321,7 +12360,7 @@ attributes that can be used are those defined in the Ada Reference Manual. @node No_Implementation_Identifiers,No_Implementation_Pragmas,No_Implementation_Attributes,Program Unit Level Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implementation-identifiers}@anchor{1c0} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implementation-identifiers}@anchor{1c2} @subsection No_Implementation_Identifiers @@ -12332,7 +12371,7 @@ implementation-defined identifiers (marked with pragma Implementation_Defined) occur within language-defined packages. @node No_Implementation_Pragmas,No_Implementation_Restrictions,No_Implementation_Identifiers,Program Unit Level Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implementation-pragmas}@anchor{1c1} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implementation-pragmas}@anchor{1c3} @subsection No_Implementation_Pragmas @@ -12343,7 +12382,7 @@ GNAT-defined pragmas are present. With this restriction, the only pragmas that can be used are those defined in the Ada Reference Manual. @node No_Implementation_Restrictions,No_Implementation_Units,No_Implementation_Pragmas,Program Unit Level Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implementation-restrictions}@anchor{1c2} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implementation-restrictions}@anchor{1c4} @subsection No_Implementation_Restrictions @@ -12355,7 +12394,7 @@ are present. With this restriction, the only other restriction identifiers that can be used are those defined in the Ada Reference Manual. @node No_Implementation_Units,No_Implicit_Aliasing,No_Implementation_Restrictions,Program Unit Level Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implementation-units}@anchor{1c3} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implementation-units}@anchor{1c5} @subsection No_Implementation_Units @@ -12366,7 +12405,7 @@ mention in the context clause of any implementation-defined descendants of packages Ada, Interfaces, or System. @node No_Implicit_Aliasing,No_Obsolescent_Features,No_Implementation_Units,Program Unit Level Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-aliasing}@anchor{1c4} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-aliasing}@anchor{1c6} @subsection No_Implicit_Aliasing @@ -12381,7 +12420,7 @@ to be aliased, and in such cases, it can always be replaced by the standard attribute Unchecked_Access which is preferable. @node No_Obsolescent_Features,No_Wide_Characters,No_Implicit_Aliasing,Program Unit Level Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-obsolescent-features}@anchor{1c5} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-obsolescent-features}@anchor{1c7} @subsection No_Obsolescent_Features @@ -12391,7 +12430,7 @@ the standard attribute Unchecked_Access which is preferable. features are used, as defined in Annex J of the Ada Reference Manual. @node No_Wide_Characters,SPARK_05,No_Obsolescent_Features,Program Unit Level Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-wide-characters}@anchor{1c6} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-wide-characters}@anchor{1c8} @subsection No_Wide_Characters @@ -12405,7 +12444,7 @@ appear in the program (that is literals representing characters not in type @cite{Character}). @node SPARK_05,,No_Wide_Characters,Program Unit Level Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions spark-05}@anchor{1c7} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions spark-05}@anchor{1c9} @subsection SPARK_05 @@ -12764,7 +12803,7 @@ violations will be reported for constructs forbidden in SPARK 95, instead of SPARK 2005. @node Implementation Advice,Implementation Defined Characteristics,Standard and Implementation Defined Restrictions,Top -@anchor{gnat_rm/implementation_advice doc}@anchor{1c8}@anchor{gnat_rm/implementation_advice implementation-advice}@anchor{a}@anchor{gnat_rm/implementation_advice id1}@anchor{1c9} +@anchor{gnat_rm/implementation_advice doc}@anchor{1ca}@anchor{gnat_rm/implementation_advice implementation-advice}@anchor{a}@anchor{gnat_rm/implementation_advice id1}@anchor{1cb} @chapter Implementation Advice @@ -12861,7 +12900,7 @@ case the text describes what GNAT does and why. @end menu @node RM 1 1 3 20 Error Detection,RM 1 1 3 31 Child Units,,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-1-1-3-20-error-detection}@anchor{1ca} +@anchor{gnat_rm/implementation_advice rm-1-1-3-20-error-detection}@anchor{1cc} @section RM 1.1.3(20): Error Detection @@ -12878,7 +12917,7 @@ or diagnosed at compile time. @geindex Child Units @node RM 1 1 3 31 Child Units,RM 1 1 5 12 Bounded Errors,RM 1 1 3 20 Error Detection,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-1-1-3-31-child-units}@anchor{1cb} +@anchor{gnat_rm/implementation_advice rm-1-1-3-31-child-units}@anchor{1cd} @section RM 1.1.3(31): Child Units @@ -12894,7 +12933,7 @@ Followed. @geindex Bounded errors @node RM 1 1 5 12 Bounded Errors,RM 2 8 16 Pragmas,RM 1 1 3 31 Child Units,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-1-1-5-12-bounded-errors}@anchor{1cc} +@anchor{gnat_rm/implementation_advice rm-1-1-5-12-bounded-errors}@anchor{1ce} @section RM 1.1.5(12): Bounded Errors @@ -12911,7 +12950,7 @@ runtime. @geindex Pragmas @node RM 2 8 16 Pragmas,RM 2 8 17-19 Pragmas,RM 1 1 5 12 Bounded Errors,Implementation Advice -@anchor{gnat_rm/implementation_advice id2}@anchor{1cd}@anchor{gnat_rm/implementation_advice rm-2-8-16-pragmas}@anchor{1ce} +@anchor{gnat_rm/implementation_advice id2}@anchor{1cf}@anchor{gnat_rm/implementation_advice rm-2-8-16-pragmas}@anchor{1d0} @section RM 2.8(16): Pragmas @@ -13024,7 +13063,7 @@ that this advice not be followed. For details see @ref{7,,Implementation Defined Pragmas}. @node RM 2 8 17-19 Pragmas,RM 3 5 2 5 Alternative Character Sets,RM 2 8 16 Pragmas,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-2-8-17-19-pragmas}@anchor{1cf} +@anchor{gnat_rm/implementation_advice rm-2-8-17-19-pragmas}@anchor{1d1} @section RM 2.8(17-19): Pragmas @@ -13045,14 +13084,14 @@ replacing @cite{library_items}." @end itemize @end quotation -See @ref{1ce,,RM 2.8(16); Pragmas}. +See @ref{1d0,,RM 2.8(16); Pragmas}. @geindex Character Sets @geindex Alternative Character Sets @node RM 3 5 2 5 Alternative Character Sets,RM 3 5 4 28 Integer Types,RM 2 8 17-19 Pragmas,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-3-5-2-5-alternative-character-sets}@anchor{1d0} +@anchor{gnat_rm/implementation_advice rm-3-5-2-5-alternative-character-sets}@anchor{1d2} @section RM 3.5.2(5): Alternative Character Sets @@ -13080,7 +13119,7 @@ there is no such restriction. @geindex Integer types @node RM 3 5 4 28 Integer Types,RM 3 5 4 29 Integer Types,RM 3 5 2 5 Alternative Character Sets,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-3-5-4-28-integer-types}@anchor{1d1} +@anchor{gnat_rm/implementation_advice rm-3-5-4-28-integer-types}@anchor{1d3} @section RM 3.5.4(28): Integer Types @@ -13099,7 +13138,7 @@ are supported for convenient interface to C, and so that all hardware types of the machine are easily available. @node RM 3 5 4 29 Integer Types,RM 3 5 5 8 Enumeration Values,RM 3 5 4 28 Integer Types,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-3-5-4-29-integer-types}@anchor{1d2} +@anchor{gnat_rm/implementation_advice rm-3-5-4-29-integer-types}@anchor{1d4} @section RM 3.5.4(29): Integer Types @@ -13115,7 +13154,7 @@ Followed. @geindex Enumeration values @node RM 3 5 5 8 Enumeration Values,RM 3 5 7 17 Float Types,RM 3 5 4 29 Integer Types,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-3-5-5-8-enumeration-values}@anchor{1d3} +@anchor{gnat_rm/implementation_advice rm-3-5-5-8-enumeration-values}@anchor{1d5} @section RM 3.5.5(8): Enumeration Values @@ -13135,7 +13174,7 @@ Followed. @geindex Float types @node RM 3 5 7 17 Float Types,RM 3 6 2 11 Multidimensional Arrays,RM 3 5 5 8 Enumeration Values,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-3-5-7-17-float-types}@anchor{1d4} +@anchor{gnat_rm/implementation_advice rm-3-5-7-17-float-types}@anchor{1d6} @section RM 3.5.7(17): Float Types @@ -13165,7 +13204,7 @@ since this is a software rather than a hardware format. @geindex multidimensional @node RM 3 6 2 11 Multidimensional Arrays,RM 9 6 30-31 Duration'Small,RM 3 5 7 17 Float Types,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-3-6-2-11-multidimensional-arrays}@anchor{1d5} +@anchor{gnat_rm/implementation_advice rm-3-6-2-11-multidimensional-arrays}@anchor{1d7} @section RM 3.6.2(11): Multidimensional Arrays @@ -13183,7 +13222,7 @@ Followed. @geindex Duration'Small @node RM 9 6 30-31 Duration'Small,RM 10 2 1 12 Consistent Representation,RM 3 6 2 11 Multidimensional Arrays,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-9-6-30-31-duration-small}@anchor{1d6} +@anchor{gnat_rm/implementation_advice rm-9-6-30-31-duration-small}@anchor{1d8} @section RM 9.6(30-31): Duration'Small @@ -13204,7 +13243,7 @@ it need not be the same time base as used for @cite{Calendar.Clock}." Followed. @node RM 10 2 1 12 Consistent Representation,RM 11 4 1 19 Exception Information,RM 9 6 30-31 Duration'Small,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-10-2-1-12-consistent-representation}@anchor{1d7} +@anchor{gnat_rm/implementation_advice rm-10-2-1-12-consistent-representation}@anchor{1d9} @section RM 10.2.1(12): Consistent Representation @@ -13226,7 +13265,7 @@ advice without severely impacting efficiency of execution. @geindex Exception information @node RM 11 4 1 19 Exception Information,RM 11 5 28 Suppression of Checks,RM 10 2 1 12 Consistent Representation,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-11-4-1-19-exception-information}@anchor{1d8} +@anchor{gnat_rm/implementation_advice rm-11-4-1-19-exception-information}@anchor{1da} @section RM 11.4.1(19): Exception Information @@ -13257,7 +13296,7 @@ Pragma @cite{Discard_Names}. @geindex suppression of @node RM 11 5 28 Suppression of Checks,RM 13 1 21-24 Representation Clauses,RM 11 4 1 19 Exception Information,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-11-5-28-suppression-of-checks}@anchor{1d9} +@anchor{gnat_rm/implementation_advice rm-11-5-28-suppression-of-checks}@anchor{1db} @section RM 11.5(28): Suppression of Checks @@ -13272,7 +13311,7 @@ Followed. @geindex Representation clauses @node RM 13 1 21-24 Representation Clauses,RM 13 2 6-8 Packed Types,RM 11 5 28 Suppression of Checks,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-13-1-21-24-representation-clauses}@anchor{1da} +@anchor{gnat_rm/implementation_advice rm-13-1-21-24-representation-clauses}@anchor{1dc} @section RM 13.1 (21-24): Representation Clauses @@ -13321,7 +13360,7 @@ Followed. @geindex Packed types @node RM 13 2 6-8 Packed Types,RM 13 3 14-19 Address Clauses,RM 13 1 21-24 Representation Clauses,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-13-2-6-8-packed-types}@anchor{1db} +@anchor{gnat_rm/implementation_advice rm-13-2-6-8-packed-types}@anchor{1dd} @section RM 13.2(6-8): Packed Types @@ -13360,7 +13399,7 @@ Followed. @geindex Address clauses @node RM 13 3 14-19 Address Clauses,RM 13 3 29-35 Alignment Clauses,RM 13 2 6-8 Packed Types,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-13-3-14-19-address-clauses}@anchor{1dc} +@anchor{gnat_rm/implementation_advice rm-13-3-14-19-address-clauses}@anchor{1de} @section RM 13.3(14-19): Address Clauses @@ -13413,7 +13452,7 @@ Followed. @geindex Alignment clauses @node RM 13 3 29-35 Alignment Clauses,RM 13 3 42-43 Size Clauses,RM 13 3 14-19 Address Clauses,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-13-3-29-35-alignment-clauses}@anchor{1dd} +@anchor{gnat_rm/implementation_advice rm-13-3-29-35-alignment-clauses}@anchor{1df} @section RM 13.3(29-35): Alignment Clauses @@ -13470,7 +13509,7 @@ Followed. @geindex Size clauses @node RM 13 3 42-43 Size Clauses,RM 13 3 50-56 Size Clauses,RM 13 3 29-35 Alignment Clauses,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-13-3-42-43-size-clauses}@anchor{1de} +@anchor{gnat_rm/implementation_advice rm-13-3-42-43-size-clauses}@anchor{1e0} @section RM 13.3(42-43): Size Clauses @@ -13488,7 +13527,7 @@ object's @cite{Alignment} (if the @cite{Alignment} is nonzero)." Followed. @node RM 13 3 50-56 Size Clauses,RM 13 3 71-73 Component Size Clauses,RM 13 3 42-43 Size Clauses,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-13-3-50-56-size-clauses}@anchor{1df} +@anchor{gnat_rm/implementation_advice rm-13-3-50-56-size-clauses}@anchor{1e1} @section RM 13.3(50-56): Size Clauses @@ -13539,7 +13578,7 @@ Followed. @geindex Component_Size clauses @node RM 13 3 71-73 Component Size Clauses,RM 13 4 9-10 Enumeration Representation Clauses,RM 13 3 50-56 Size Clauses,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-13-3-71-73-component-size-clauses}@anchor{1e0} +@anchor{gnat_rm/implementation_advice rm-13-3-71-73-component-size-clauses}@anchor{1e2} @section RM 13.3(71-73): Component Size Clauses @@ -13573,7 +13612,7 @@ Followed. @geindex enumeration @node RM 13 4 9-10 Enumeration Representation Clauses,RM 13 5 1 17-22 Record Representation Clauses,RM 13 3 71-73 Component Size Clauses,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-13-4-9-10-enumeration-representation-clauses}@anchor{1e1} +@anchor{gnat_rm/implementation_advice rm-13-4-9-10-enumeration-representation-clauses}@anchor{1e3} @section RM 13.4(9-10): Enumeration Representation Clauses @@ -13595,7 +13634,7 @@ Followed. @geindex records @node RM 13 5 1 17-22 Record Representation Clauses,RM 13 5 2 5 Storage Place Attributes,RM 13 4 9-10 Enumeration Representation Clauses,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-13-5-1-17-22-record-representation-clauses}@anchor{1e2} +@anchor{gnat_rm/implementation_advice rm-13-5-1-17-22-record-representation-clauses}@anchor{1e4} @section RM 13.5.1(17-22): Record Representation Clauses @@ -13655,7 +13694,7 @@ and all mentioned features are implemented. @geindex Storage place attributes @node RM 13 5 2 5 Storage Place Attributes,RM 13 5 3 7-8 Bit Ordering,RM 13 5 1 17-22 Record Representation Clauses,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-13-5-2-5-storage-place-attributes}@anchor{1e3} +@anchor{gnat_rm/implementation_advice rm-13-5-2-5-storage-place-attributes}@anchor{1e5} @section RM 13.5.2(5): Storage Place Attributes @@ -13675,7 +13714,7 @@ Followed. There are no such components in GNAT. @geindex Bit ordering @node RM 13 5 3 7-8 Bit Ordering,RM 13 7 37 Address as Private,RM 13 5 2 5 Storage Place Attributes,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-13-5-3-7-8-bit-ordering}@anchor{1e4} +@anchor{gnat_rm/implementation_advice rm-13-5-3-7-8-bit-ordering}@anchor{1e6} @section RM 13.5.3(7-8): Bit Ordering @@ -13695,7 +13734,7 @@ Thus non-default bit ordering is not supported. @geindex as private type @node RM 13 7 37 Address as Private,RM 13 7 1 16 Address Operations,RM 13 5 3 7-8 Bit Ordering,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-13-7-37-address-as-private}@anchor{1e5} +@anchor{gnat_rm/implementation_advice rm-13-7-37-address-as-private}@anchor{1e7} @section RM 13.7(37): Address as Private @@ -13713,7 +13752,7 @@ Followed. @geindex operations of @node RM 13 7 1 16 Address Operations,RM 13 9 14-17 Unchecked Conversion,RM 13 7 37 Address as Private,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-13-7-1-16-address-operations}@anchor{1e6} +@anchor{gnat_rm/implementation_advice rm-13-7-1-16-address-operations}@anchor{1e8} @section RM 13.7.1(16): Address Operations @@ -13731,7 +13770,7 @@ operation raises @cite{Program_Error}, since all operations make sense. @geindex Unchecked conversion @node RM 13 9 14-17 Unchecked Conversion,RM 13 11 23-25 Implicit Heap Usage,RM 13 7 1 16 Address Operations,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-13-9-14-17-unchecked-conversion}@anchor{1e7} +@anchor{gnat_rm/implementation_advice rm-13-9-14-17-unchecked-conversion}@anchor{1e9} @section RM 13.9(14-17): Unchecked Conversion @@ -13775,7 +13814,7 @@ Followed. @geindex implicit @node RM 13 11 23-25 Implicit Heap Usage,RM 13 11 2 17 Unchecked Deallocation,RM 13 9 14-17 Unchecked Conversion,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-13-11-23-25-implicit-heap-usage}@anchor{1e8} +@anchor{gnat_rm/implementation_advice rm-13-11-23-25-implicit-heap-usage}@anchor{1ea} @section RM 13.11(23-25): Implicit Heap Usage @@ -13826,7 +13865,7 @@ Followed. @geindex Unchecked deallocation @node RM 13 11 2 17 Unchecked Deallocation,RM 13 13 2 17 Stream Oriented Attributes,RM 13 11 23-25 Implicit Heap Usage,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-13-11-2-17-unchecked-deallocation}@anchor{1e9} +@anchor{gnat_rm/implementation_advice rm-13-11-2-17-unchecked-deallocation}@anchor{1eb} @section RM 13.11.2(17): Unchecked Deallocation @@ -13841,7 +13880,7 @@ Followed. @geindex Stream oriented attributes @node RM 13 13 2 17 Stream Oriented Attributes,RM A 1 52 Names of Predefined Numeric Types,RM 13 11 2 17 Unchecked Deallocation,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-13-13-2-17-stream-oriented-attributes}@anchor{1ea} +@anchor{gnat_rm/implementation_advice rm-13-13-2-17-stream-oriented-attributes}@anchor{1ec} @section RM 13.13.2(17): Stream Oriented Attributes @@ -13896,7 +13935,7 @@ the @cite{GNAT and Libraries} section of the @cite{GNAT User's Guide}. @end itemize @node RM A 1 52 Names of Predefined Numeric Types,RM A 3 2 49 Ada Characters Handling,RM 13 13 2 17 Stream Oriented Attributes,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-a-1-52-names-of-predefined-numeric-types}@anchor{1eb} +@anchor{gnat_rm/implementation_advice rm-a-1-52-names-of-predefined-numeric-types}@anchor{1ed} @section RM A.1(52): Names of Predefined Numeric Types @@ -13914,7 +13953,7 @@ Followed. @geindex Ada.Characters.Handling @node RM A 3 2 49 Ada Characters Handling,RM A 4 4 106 Bounded-Length String Handling,RM A 1 52 Names of Predefined Numeric Types,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-a-3-2-49-ada-characters-handling}@anchor{1ec} +@anchor{gnat_rm/implementation_advice rm-a-3-2-49-ada-characters-handling}@anchor{1ee} @section RM A.3.2(49): @cite{Ada.Characters.Handling} @@ -13931,7 +13970,7 @@ Followed. GNAT provides no such localized definitions. @geindex Bounded-length strings @node RM A 4 4 106 Bounded-Length String Handling,RM A 5 2 46-47 Random Number Generation,RM A 3 2 49 Ada Characters Handling,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-a-4-4-106-bounded-length-string-handling}@anchor{1ed} +@anchor{gnat_rm/implementation_advice rm-a-4-4-106-bounded-length-string-handling}@anchor{1ef} @section RM A.4.4(106): Bounded-Length String Handling @@ -13946,7 +13985,7 @@ Followed. No implicit pointers or dynamic allocation are used. @geindex Random number generation @node RM A 5 2 46-47 Random Number Generation,RM A 10 7 23 Get_Immediate,RM A 4 4 106 Bounded-Length String Handling,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-a-5-2-46-47-random-number-generation}@anchor{1ee} +@anchor{gnat_rm/implementation_advice rm-a-5-2-46-47-random-number-generation}@anchor{1f0} @section RM A.5.2(46-47): Random Number Generation @@ -13975,7 +14014,7 @@ condition here to hold true. @geindex Get_Immediate @node RM A 10 7 23 Get_Immediate,RM B 1 39-41 Pragma Export,RM A 5 2 46-47 Random Number Generation,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-a-10-7-23-get-immediate}@anchor{1ef} +@anchor{gnat_rm/implementation_advice rm-a-10-7-23-get-immediate}@anchor{1f1} @section RM A.10.7(23): @cite{Get_Immediate} @@ -13999,7 +14038,7 @@ this functionality. @geindex Export @node RM B 1 39-41 Pragma Export,RM B 2 12-13 Package Interfaces,RM A 10 7 23 Get_Immediate,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-b-1-39-41-pragma-export}@anchor{1f0} +@anchor{gnat_rm/implementation_advice rm-b-1-39-41-pragma-export}@anchor{1f2} @section RM B.1(39-41): Pragma @cite{Export} @@ -14047,7 +14086,7 @@ Followed. @geindex Interfaces @node RM B 2 12-13 Package Interfaces,RM B 3 63-71 Interfacing with C,RM B 1 39-41 Pragma Export,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-b-2-12-13-package-interfaces}@anchor{1f1} +@anchor{gnat_rm/implementation_advice rm-b-2-12-13-package-interfaces}@anchor{1f3} @section RM B.2(12-13): Package @cite{Interfaces} @@ -14077,7 +14116,7 @@ Followed. GNAT provides all the packages described in this section. @geindex interfacing with @node RM B 3 63-71 Interfacing with C,RM B 4 95-98 Interfacing with COBOL,RM B 2 12-13 Package Interfaces,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-b-3-63-71-interfacing-with-c}@anchor{1f2} +@anchor{gnat_rm/implementation_advice rm-b-3-63-71-interfacing-with-c}@anchor{1f4} @section RM B.3(63-71): Interfacing with C @@ -14165,7 +14204,7 @@ Followed. @geindex interfacing with @node RM B 4 95-98 Interfacing with COBOL,RM B 5 22-26 Interfacing with Fortran,RM B 3 63-71 Interfacing with C,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-b-4-95-98-interfacing-with-cobol}@anchor{1f3} +@anchor{gnat_rm/implementation_advice rm-b-4-95-98-interfacing-with-cobol}@anchor{1f5} @section RM B.4(95-98): Interfacing with COBOL @@ -14206,7 +14245,7 @@ Followed. @geindex interfacing with @node RM B 5 22-26 Interfacing with Fortran,RM C 1 3-5 Access to Machine Operations,RM B 4 95-98 Interfacing with COBOL,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-b-5-22-26-interfacing-with-fortran}@anchor{1f4} +@anchor{gnat_rm/implementation_advice rm-b-5-22-26-interfacing-with-fortran}@anchor{1f6} @section RM B.5(22-26): Interfacing with Fortran @@ -14257,7 +14296,7 @@ Followed. @geindex Machine operations @node RM C 1 3-5 Access to Machine Operations,RM C 1 10-16 Access to Machine Operations,RM B 5 22-26 Interfacing with Fortran,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-c-1-3-5-access-to-machine-operations}@anchor{1f5} +@anchor{gnat_rm/implementation_advice rm-c-1-3-5-access-to-machine-operations}@anchor{1f7} @section RM C.1(3-5): Access to Machine Operations @@ -14292,7 +14331,7 @@ object that is specified as exported." Followed. @node RM C 1 10-16 Access to Machine Operations,RM C 3 28 Interrupt Support,RM C 1 3-5 Access to Machine Operations,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-c-1-10-16-access-to-machine-operations}@anchor{1f6} +@anchor{gnat_rm/implementation_advice rm-c-1-10-16-access-to-machine-operations}@anchor{1f8} @section RM C.1(10-16): Access to Machine Operations @@ -14353,7 +14392,7 @@ Followed on any target supporting such operations. @geindex Interrupt support @node RM C 3 28 Interrupt Support,RM C 3 1 20-21 Protected Procedure Handlers,RM C 1 10-16 Access to Machine Operations,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-c-3-28-interrupt-support}@anchor{1f7} +@anchor{gnat_rm/implementation_advice rm-c-3-28-interrupt-support}@anchor{1f9} @section RM C.3(28): Interrupt Support @@ -14371,7 +14410,7 @@ of interrupt blocking. @geindex Protected procedure handlers @node RM C 3 1 20-21 Protected Procedure Handlers,RM C 3 2 25 Package Interrupts,RM C 3 28 Interrupt Support,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-c-3-1-20-21-protected-procedure-handlers}@anchor{1f8} +@anchor{gnat_rm/implementation_advice rm-c-3-1-20-21-protected-procedure-handlers}@anchor{1fa} @section RM C.3.1(20-21): Protected Procedure Handlers @@ -14397,7 +14436,7 @@ Followed. Compile time warnings are given when possible. @geindex Interrupts @node RM C 3 2 25 Package Interrupts,RM C 4 14 Pre-elaboration Requirements,RM C 3 1 20-21 Protected Procedure Handlers,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-c-3-2-25-package-interrupts}@anchor{1f9} +@anchor{gnat_rm/implementation_advice rm-c-3-2-25-package-interrupts}@anchor{1fb} @section RM C.3.2(25): Package @cite{Interrupts} @@ -14415,7 +14454,7 @@ Followed. @geindex Pre-elaboration requirements @node RM C 4 14 Pre-elaboration Requirements,RM C 5 8 Pragma Discard_Names,RM C 3 2 25 Package Interrupts,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-c-4-14-pre-elaboration-requirements}@anchor{1fa} +@anchor{gnat_rm/implementation_advice rm-c-4-14-pre-elaboration-requirements}@anchor{1fc} @section RM C.4(14): Pre-elaboration Requirements @@ -14431,7 +14470,7 @@ Followed. Executable code is generated in some cases, e.g., loops to initialize large arrays. @node RM C 5 8 Pragma Discard_Names,RM C 7 2 30 The Package Task_Attributes,RM C 4 14 Pre-elaboration Requirements,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-c-5-8-pragma-discard-names}@anchor{1fb} +@anchor{gnat_rm/implementation_advice rm-c-5-8-pragma-discard-names}@anchor{1fd} @section RM C.5(8): Pragma @cite{Discard_Names} @@ -14449,7 +14488,7 @@ Followed. @geindex Task_Attributes @node RM C 7 2 30 The Package Task_Attributes,RM D 3 17 Locking Policies,RM C 5 8 Pragma Discard_Names,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-c-7-2-30-the-package-task-attributes}@anchor{1fc} +@anchor{gnat_rm/implementation_advice rm-c-7-2-30-the-package-task-attributes}@anchor{1fe} @section RM C.7.2(30): The Package Task_Attributes @@ -14470,7 +14509,7 @@ Not followed. This implementation is not targeted to such a domain. @geindex Locking Policies @node RM D 3 17 Locking Policies,RM D 4 16 Entry Queuing Policies,RM C 7 2 30 The Package Task_Attributes,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-d-3-17-locking-policies}@anchor{1fd} +@anchor{gnat_rm/implementation_advice rm-d-3-17-locking-policies}@anchor{1ff} @section RM D.3(17): Locking Policies @@ -14487,7 +14526,7 @@ whose names (@cite{Inheritance_Locking} and @geindex Entry queuing policies @node RM D 4 16 Entry Queuing Policies,RM D 6 9-10 Preemptive Abort,RM D 3 17 Locking Policies,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-d-4-16-entry-queuing-policies}@anchor{1fe} +@anchor{gnat_rm/implementation_advice rm-d-4-16-entry-queuing-policies}@anchor{200} @section RM D.4(16): Entry Queuing Policies @@ -14502,7 +14541,7 @@ Followed. No such implementation-defined queuing policies exist. @geindex Preemptive abort @node RM D 6 9-10 Preemptive Abort,RM D 7 21 Tasking Restrictions,RM D 4 16 Entry Queuing Policies,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-d-6-9-10-preemptive-abort}@anchor{1ff} +@anchor{gnat_rm/implementation_advice rm-d-6-9-10-preemptive-abort}@anchor{201} @section RM D.6(9-10): Preemptive Abort @@ -14528,7 +14567,7 @@ Followed. @geindex Tasking restrictions @node RM D 7 21 Tasking Restrictions,RM D 8 47-49 Monotonic Time,RM D 6 9-10 Preemptive Abort,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-d-7-21-tasking-restrictions}@anchor{200} +@anchor{gnat_rm/implementation_advice rm-d-7-21-tasking-restrictions}@anchor{202} @section RM D.7(21): Tasking Restrictions @@ -14547,7 +14586,7 @@ pragma @cite{Profile (Restricted)} for more details. @geindex monotonic @node RM D 8 47-49 Monotonic Time,RM E 5 28-29 Partition Communication Subsystem,RM D 7 21 Tasking Restrictions,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-d-8-47-49-monotonic-time}@anchor{201} +@anchor{gnat_rm/implementation_advice rm-d-8-47-49-monotonic-time}@anchor{203} @section RM D.8(47-49): Monotonic Time @@ -14582,7 +14621,7 @@ Followed. @geindex PCS @node RM E 5 28-29 Partition Communication Subsystem,RM F 7 COBOL Support,RM D 8 47-49 Monotonic Time,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-e-5-28-29-partition-communication-subsystem}@anchor{202} +@anchor{gnat_rm/implementation_advice rm-e-5-28-29-partition-communication-subsystem}@anchor{204} @section RM E.5(28-29): Partition Communication Subsystem @@ -14610,7 +14649,7 @@ GNAT. @geindex COBOL support @node RM F 7 COBOL Support,RM F 1 2 Decimal Radix Support,RM E 5 28-29 Partition Communication Subsystem,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-f-7-cobol-support}@anchor{203} +@anchor{gnat_rm/implementation_advice rm-f-7-cobol-support}@anchor{205} @section RM F(7): COBOL Support @@ -14630,7 +14669,7 @@ Followed. @geindex Decimal radix support @node RM F 1 2 Decimal Radix Support,RM G Numerics,RM F 7 COBOL Support,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-f-1-2-decimal-radix-support}@anchor{204} +@anchor{gnat_rm/implementation_advice rm-f-1-2-decimal-radix-support}@anchor{206} @section RM F.1(2): Decimal Radix Support @@ -14646,7 +14685,7 @@ representations. @geindex Numerics @node RM G Numerics,RM G 1 1 56-58 Complex Types,RM F 1 2 Decimal Radix Support,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-g-numerics}@anchor{205} +@anchor{gnat_rm/implementation_advice rm-g-numerics}@anchor{207} @section RM G: Numerics @@ -14666,7 +14705,7 @@ Followed. @geindex Complex types @node RM G 1 1 56-58 Complex Types,RM G 1 2 49 Complex Elementary Functions,RM G Numerics,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-g-1-1-56-58-complex-types}@anchor{206} +@anchor{gnat_rm/implementation_advice rm-g-1-1-56-58-complex-types}@anchor{208} @section RM G.1.1(56-58): Complex Types @@ -14728,7 +14767,7 @@ Followed. @geindex Complex elementary functions @node RM G 1 2 49 Complex Elementary Functions,RM G 2 4 19 Accuracy Requirements,RM G 1 1 56-58 Complex Types,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-g-1-2-49-complex-elementary-functions}@anchor{207} +@anchor{gnat_rm/implementation_advice rm-g-1-2-49-complex-elementary-functions}@anchor{209} @section RM G.1.2(49): Complex Elementary Functions @@ -14750,7 +14789,7 @@ Followed. @geindex Accuracy requirements @node RM G 2 4 19 Accuracy Requirements,RM G 2 6 15 Complex Arithmetic Accuracy,RM G 1 2 49 Complex Elementary Functions,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-g-2-4-19-accuracy-requirements}@anchor{208} +@anchor{gnat_rm/implementation_advice rm-g-2-4-19-accuracy-requirements}@anchor{20a} @section RM G.2.4(19): Accuracy Requirements @@ -14774,7 +14813,7 @@ Followed. @geindex complex arithmetic @node RM G 2 6 15 Complex Arithmetic Accuracy,RM H 6 15/2 Pragma Partition_Elaboration_Policy,RM G 2 4 19 Accuracy Requirements,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-g-2-6-15-complex-arithmetic-accuracy}@anchor{209} +@anchor{gnat_rm/implementation_advice rm-g-2-6-15-complex-arithmetic-accuracy}@anchor{20b} @section RM G.2.6(15): Complex Arithmetic Accuracy @@ -14792,7 +14831,7 @@ Followed. @geindex Sequential elaboration policy @node RM H 6 15/2 Pragma Partition_Elaboration_Policy,,RM G 2 6 15 Complex Arithmetic Accuracy,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-h-6-15-2-pragma-partition-elaboration-policy}@anchor{20a} +@anchor{gnat_rm/implementation_advice rm-h-6-15-2-pragma-partition-elaboration-policy}@anchor{20c} @section RM H.6(15/2): Pragma Partition_Elaboration_Policy @@ -14807,7 +14846,7 @@ immediately terminated." Not followed. @node Implementation Defined Characteristics,Intrinsic Subprograms,Implementation Advice,Top -@anchor{gnat_rm/implementation_defined_characteristics implementation-defined-characteristics}@anchor{b}@anchor{gnat_rm/implementation_defined_characteristics doc}@anchor{20b}@anchor{gnat_rm/implementation_defined_characteristics id1}@anchor{20c} +@anchor{gnat_rm/implementation_defined_characteristics implementation-defined-characteristics}@anchor{b}@anchor{gnat_rm/implementation_defined_characteristics doc}@anchor{20d}@anchor{gnat_rm/implementation_defined_characteristics id1}@anchor{20e} @chapter Implementation Defined Characteristics @@ -16002,7 +16041,7 @@ When the @cite{Pattern} parameter is not the null string, it is interpreted according to the syntax of regular expressions as defined in the @cite{GNAT.Regexp} package. -See @ref{20d,,GNAT.Regexp (g-regexp.ads)}. +See @ref{20f,,GNAT.Regexp (g-regexp.ads)}. @itemize * @@ -17044,7 +17083,7 @@ H.4(27)." There are no restrictions on pragma @cite{Restrictions}. @node Intrinsic Subprograms,Representation Clauses and Pragmas,Implementation Defined Characteristics,Top -@anchor{gnat_rm/intrinsic_subprograms doc}@anchor{20e}@anchor{gnat_rm/intrinsic_subprograms intrinsic-subprograms}@anchor{c}@anchor{gnat_rm/intrinsic_subprograms id1}@anchor{20f} +@anchor{gnat_rm/intrinsic_subprograms doc}@anchor{210}@anchor{gnat_rm/intrinsic_subprograms intrinsic-subprograms}@anchor{c}@anchor{gnat_rm/intrinsic_subprograms id1}@anchor{211} @chapter Intrinsic Subprograms @@ -17081,7 +17120,7 @@ Ada standard does not require Ada compilers to implement this feature. @end menu @node Intrinsic Operators,Compilation_Date,,Intrinsic Subprograms -@anchor{gnat_rm/intrinsic_subprograms id2}@anchor{210}@anchor{gnat_rm/intrinsic_subprograms intrinsic-operators}@anchor{211} +@anchor{gnat_rm/intrinsic_subprograms id2}@anchor{212}@anchor{gnat_rm/intrinsic_subprograms intrinsic-operators}@anchor{213} @section Intrinsic Operators @@ -17112,7 +17151,7 @@ It is also possible to specify such operators for private types, if the full views are appropriate arithmetic types. @node Compilation_Date,Compilation_Time,Intrinsic Operators,Intrinsic Subprograms -@anchor{gnat_rm/intrinsic_subprograms compilation-date}@anchor{212}@anchor{gnat_rm/intrinsic_subprograms id3}@anchor{213} +@anchor{gnat_rm/intrinsic_subprograms compilation-date}@anchor{214}@anchor{gnat_rm/intrinsic_subprograms id3}@anchor{215} @section Compilation_Date @@ -17126,7 +17165,7 @@ application program should simply call the function the current compilation (in local time format MMM DD YYYY). @node Compilation_Time,Enclosing_Entity,Compilation_Date,Intrinsic Subprograms -@anchor{gnat_rm/intrinsic_subprograms compilation-time}@anchor{214}@anchor{gnat_rm/intrinsic_subprograms id4}@anchor{215} +@anchor{gnat_rm/intrinsic_subprograms compilation-time}@anchor{216}@anchor{gnat_rm/intrinsic_subprograms id4}@anchor{217} @section Compilation_Time @@ -17140,7 +17179,7 @@ application program should simply call the function the current compilation (in local time format HH:MM:SS). @node Enclosing_Entity,Exception_Information,Compilation_Time,Intrinsic Subprograms -@anchor{gnat_rm/intrinsic_subprograms id5}@anchor{216}@anchor{gnat_rm/intrinsic_subprograms enclosing-entity}@anchor{217} +@anchor{gnat_rm/intrinsic_subprograms id5}@anchor{218}@anchor{gnat_rm/intrinsic_subprograms enclosing-entity}@anchor{219} @section Enclosing_Entity @@ -17154,7 +17193,7 @@ application program should simply call the function the current subprogram, package, task, entry, or protected subprogram. @node Exception_Information,Exception_Message,Enclosing_Entity,Intrinsic Subprograms -@anchor{gnat_rm/intrinsic_subprograms id6}@anchor{218}@anchor{gnat_rm/intrinsic_subprograms exception-information}@anchor{219} +@anchor{gnat_rm/intrinsic_subprograms id6}@anchor{21a}@anchor{gnat_rm/intrinsic_subprograms exception-information}@anchor{21b} @section Exception_Information @@ -17168,7 +17207,7 @@ so an application program should simply call the function the exception information associated with the current exception. @node Exception_Message,Exception_Name,Exception_Information,Intrinsic Subprograms -@anchor{gnat_rm/intrinsic_subprograms exception-message}@anchor{21a}@anchor{gnat_rm/intrinsic_subprograms id7}@anchor{21b} +@anchor{gnat_rm/intrinsic_subprograms exception-message}@anchor{21c}@anchor{gnat_rm/intrinsic_subprograms id7}@anchor{21d} @section Exception_Message @@ -17182,7 +17221,7 @@ so an application program should simply call the function the message associated with the current exception. @node Exception_Name,File,Exception_Message,Intrinsic Subprograms -@anchor{gnat_rm/intrinsic_subprograms exception-name}@anchor{21c}@anchor{gnat_rm/intrinsic_subprograms id8}@anchor{21d} +@anchor{gnat_rm/intrinsic_subprograms exception-name}@anchor{21e}@anchor{gnat_rm/intrinsic_subprograms id8}@anchor{21f} @section Exception_Name @@ -17196,7 +17235,7 @@ so an application program should simply call the function the name of the current exception. @node File,Line,Exception_Name,Intrinsic Subprograms -@anchor{gnat_rm/intrinsic_subprograms file}@anchor{21e}@anchor{gnat_rm/intrinsic_subprograms id9}@anchor{21f} +@anchor{gnat_rm/intrinsic_subprograms file}@anchor{220}@anchor{gnat_rm/intrinsic_subprograms id9}@anchor{221} @section File @@ -17210,7 +17249,7 @@ application program should simply call the function file. @node Line,Shifts and Rotates,File,Intrinsic Subprograms -@anchor{gnat_rm/intrinsic_subprograms id10}@anchor{220}@anchor{gnat_rm/intrinsic_subprograms line}@anchor{221} +@anchor{gnat_rm/intrinsic_subprograms id10}@anchor{222}@anchor{gnat_rm/intrinsic_subprograms line}@anchor{223} @section Line @@ -17224,7 +17263,7 @@ application program should simply call the function source line. @node Shifts and Rotates,Source_Location,Line,Intrinsic Subprograms -@anchor{gnat_rm/intrinsic_subprograms id11}@anchor{222}@anchor{gnat_rm/intrinsic_subprograms shifts-and-rotates}@anchor{223} +@anchor{gnat_rm/intrinsic_subprograms id11}@anchor{224}@anchor{gnat_rm/intrinsic_subprograms shifts-and-rotates}@anchor{225} @section Shifts and Rotates @@ -17263,7 +17302,7 @@ the Provide_Shift_Operators pragma, which provides the function declarations and corresponding pragma Import's for all five shift functions. @node Source_Location,,Shifts and Rotates,Intrinsic Subprograms -@anchor{gnat_rm/intrinsic_subprograms source-location}@anchor{224}@anchor{gnat_rm/intrinsic_subprograms id12}@anchor{225} +@anchor{gnat_rm/intrinsic_subprograms source-location}@anchor{226}@anchor{gnat_rm/intrinsic_subprograms id12}@anchor{227} @section Source_Location @@ -17277,7 +17316,7 @@ application program should simply call the function source file location. @node Representation Clauses and Pragmas,Standard Library Routines,Intrinsic Subprograms,Top -@anchor{gnat_rm/representation_clauses_and_pragmas representation-clauses-and-pragmas}@anchor{d}@anchor{gnat_rm/representation_clauses_and_pragmas doc}@anchor{226}@anchor{gnat_rm/representation_clauses_and_pragmas id1}@anchor{227} +@anchor{gnat_rm/representation_clauses_and_pragmas representation-clauses-and-pragmas}@anchor{d}@anchor{gnat_rm/representation_clauses_and_pragmas doc}@anchor{228}@anchor{gnat_rm/representation_clauses_and_pragmas id1}@anchor{229} @chapter Representation Clauses and Pragmas @@ -17323,7 +17362,7 @@ and this section describes the additional capabilities provided. @end menu @node Alignment Clauses,Size Clauses,,Representation Clauses and Pragmas -@anchor{gnat_rm/representation_clauses_and_pragmas id2}@anchor{228}@anchor{gnat_rm/representation_clauses_and_pragmas alignment-clauses}@anchor{229} +@anchor{gnat_rm/representation_clauses_and_pragmas id2}@anchor{22a}@anchor{gnat_rm/representation_clauses_and_pragmas alignment-clauses}@anchor{22b} @section Alignment Clauses @@ -17343,7 +17382,7 @@ For primitive types, the alignment is the minimum of the actual size of objects of the type divided by @cite{Storage_Unit}, and the maximum alignment supported by the target. (This maximum alignment is given by the GNAT-specific attribute -@cite{Standard'Maximum_Alignment}; see @ref{148,,Attribute Maximum_Alignment}.) +@cite{Standard'Maximum_Alignment}; see @ref{149,,Attribute Maximum_Alignment}.) @geindex Maximum_Alignment attribute @@ -17451,7 +17490,7 @@ assumption is non-portable, and other compilers may choose different alignments for the subtype @cite{RS}. @node Size Clauses,Storage_Size Clauses,Alignment Clauses,Representation Clauses and Pragmas -@anchor{gnat_rm/representation_clauses_and_pragmas id3}@anchor{22a}@anchor{gnat_rm/representation_clauses_and_pragmas size-clauses}@anchor{22b} +@anchor{gnat_rm/representation_clauses_and_pragmas id3}@anchor{22c}@anchor{gnat_rm/representation_clauses_and_pragmas size-clauses}@anchor{22d} @section Size Clauses @@ -17528,7 +17567,7 @@ if it is known that a Size value can be accommodated in an object of type Integer. @node Storage_Size Clauses,Size of Variant Record Objects,Size Clauses,Representation Clauses and Pragmas -@anchor{gnat_rm/representation_clauses_and_pragmas storage-size-clauses}@anchor{22c}@anchor{gnat_rm/representation_clauses_and_pragmas id4}@anchor{22d} +@anchor{gnat_rm/representation_clauses_and_pragmas storage-size-clauses}@anchor{22e}@anchor{gnat_rm/representation_clauses_and_pragmas id4}@anchor{22f} @section Storage_Size Clauses @@ -17601,7 +17640,7 @@ Of course in practice, there will not be any explicit allocators in the case of such an access declaration. @node Size of Variant Record Objects,Biased Representation,Storage_Size Clauses,Representation Clauses and Pragmas -@anchor{gnat_rm/representation_clauses_and_pragmas id5}@anchor{22e}@anchor{gnat_rm/representation_clauses_and_pragmas size-of-variant-record-objects}@anchor{22f} +@anchor{gnat_rm/representation_clauses_and_pragmas id5}@anchor{230}@anchor{gnat_rm/representation_clauses_and_pragmas size-of-variant-record-objects}@anchor{231} @section Size of Variant Record Objects @@ -17711,7 +17750,7 @@ the maximum size, regardless of the current variant value, the variant value. @node Biased Representation,Value_Size and Object_Size Clauses,Size of Variant Record Objects,Representation Clauses and Pragmas -@anchor{gnat_rm/representation_clauses_and_pragmas id6}@anchor{230}@anchor{gnat_rm/representation_clauses_and_pragmas biased-representation}@anchor{231} +@anchor{gnat_rm/representation_clauses_and_pragmas id6}@anchor{232}@anchor{gnat_rm/representation_clauses_and_pragmas biased-representation}@anchor{233} @section Biased Representation @@ -17749,7 +17788,7 @@ biased representation can be used for all discrete types except for enumeration types for which a representation clause is given. @node Value_Size and Object_Size Clauses,Component_Size Clauses,Biased Representation,Representation Clauses and Pragmas -@anchor{gnat_rm/representation_clauses_and_pragmas id7}@anchor{232}@anchor{gnat_rm/representation_clauses_and_pragmas value-size-and-object-size-clauses}@anchor{233} +@anchor{gnat_rm/representation_clauses_and_pragmas id7}@anchor{234}@anchor{gnat_rm/representation_clauses_and_pragmas value-size-and-object-size-clauses}@anchor{235} @section Value_Size and Object_Size Clauses @@ -18056,7 +18095,7 @@ definition clause forces biased representation. This warning can be turned off using @cite{-gnatw.B}. @node Component_Size Clauses,Bit_Order Clauses,Value_Size and Object_Size Clauses,Representation Clauses and Pragmas -@anchor{gnat_rm/representation_clauses_and_pragmas id8}@anchor{234}@anchor{gnat_rm/representation_clauses_and_pragmas component-size-clauses}@anchor{235} +@anchor{gnat_rm/representation_clauses_and_pragmas id8}@anchor{236}@anchor{gnat_rm/representation_clauses_and_pragmas component-size-clauses}@anchor{237} @section Component_Size Clauses @@ -18103,7 +18142,7 @@ and a pragma Pack for the same array type. if such duplicate clauses are given, the pragma Pack will be ignored. @node Bit_Order Clauses,Effect of Bit_Order on Byte Ordering,Component_Size Clauses,Representation Clauses and Pragmas -@anchor{gnat_rm/representation_clauses_and_pragmas bit-order-clauses}@anchor{236}@anchor{gnat_rm/representation_clauses_and_pragmas id9}@anchor{237} +@anchor{gnat_rm/representation_clauses_and_pragmas bit-order-clauses}@anchor{238}@anchor{gnat_rm/representation_clauses_and_pragmas id9}@anchor{239} @section Bit_Order Clauses @@ -18209,7 +18248,7 @@ if desired. The following section contains additional details regarding the issue of byte ordering. @node Effect of Bit_Order on Byte Ordering,Pragma Pack for Arrays,Bit_Order Clauses,Representation Clauses and Pragmas -@anchor{gnat_rm/representation_clauses_and_pragmas id10}@anchor{238}@anchor{gnat_rm/representation_clauses_and_pragmas effect-of-bit-order-on-byte-ordering}@anchor{239} +@anchor{gnat_rm/representation_clauses_and_pragmas id10}@anchor{23a}@anchor{gnat_rm/representation_clauses_and_pragmas effect-of-bit-order-on-byte-ordering}@anchor{23b} @section Effect of Bit_Order on Byte Ordering @@ -18466,7 +18505,7 @@ to set the boolean constant @cite{Master_Byte_First} in an appropriate manner. @node Pragma Pack for Arrays,Pragma Pack for Records,Effect of Bit_Order on Byte Ordering,Representation Clauses and Pragmas -@anchor{gnat_rm/representation_clauses_and_pragmas pragma-pack-for-arrays}@anchor{23a}@anchor{gnat_rm/representation_clauses_and_pragmas id11}@anchor{23b} +@anchor{gnat_rm/representation_clauses_and_pragmas pragma-pack-for-arrays}@anchor{23c}@anchor{gnat_rm/representation_clauses_and_pragmas id11}@anchor{23d} @section Pragma Pack for Arrays @@ -18582,7 +18621,7 @@ Here 31-bit packing is achieved as required, and no warning is generated, since in this case the programmer intention is clear. @node Pragma Pack for Records,Record Representation Clauses,Pragma Pack for Arrays,Representation Clauses and Pragmas -@anchor{gnat_rm/representation_clauses_and_pragmas pragma-pack-for-records}@anchor{23c}@anchor{gnat_rm/representation_clauses_and_pragmas id12}@anchor{23d} +@anchor{gnat_rm/representation_clauses_and_pragmas pragma-pack-for-records}@anchor{23e}@anchor{gnat_rm/representation_clauses_and_pragmas id12}@anchor{23f} @section Pragma Pack for Records @@ -18665,7 +18704,7 @@ the @cite{L6} field is aligned to the next byte boundary, and takes an integral number of bytes, i.e., 72 bits. @node Record Representation Clauses,Handling of Records with Holes,Pragma Pack for Records,Representation Clauses and Pragmas -@anchor{gnat_rm/representation_clauses_and_pragmas id13}@anchor{23e}@anchor{gnat_rm/representation_clauses_and_pragmas record-representation-clauses}@anchor{23f} +@anchor{gnat_rm/representation_clauses_and_pragmas id13}@anchor{240}@anchor{gnat_rm/representation_clauses_and_pragmas record-representation-clauses}@anchor{241} @section Record Representation Clauses @@ -18750,7 +18789,7 @@ type, in particular, always starting on a byte boundary, and the length must be a multiple of the storage unit. @node Handling of Records with Holes,Enumeration Clauses,Record Representation Clauses,Representation Clauses and Pragmas -@anchor{gnat_rm/representation_clauses_and_pragmas handling-of-records-with-holes}@anchor{240}@anchor{gnat_rm/representation_clauses_and_pragmas id14}@anchor{241} +@anchor{gnat_rm/representation_clauses_and_pragmas handling-of-records-with-holes}@anchor{242}@anchor{gnat_rm/representation_clauses_and_pragmas id14}@anchor{243} @section Handling of Records with Holes @@ -18827,7 +18866,7 @@ for Hrec'Size use 64; @end example @node Enumeration Clauses,Address Clauses,Handling of Records with Holes,Representation Clauses and Pragmas -@anchor{gnat_rm/representation_clauses_and_pragmas enumeration-clauses}@anchor{242}@anchor{gnat_rm/representation_clauses_and_pragmas id15}@anchor{243} +@anchor{gnat_rm/representation_clauses_and_pragmas enumeration-clauses}@anchor{244}@anchor{gnat_rm/representation_clauses_and_pragmas id15}@anchor{245} @section Enumeration Clauses @@ -18870,7 +18909,7 @@ the overhead of converting representation values to the corresponding positional values, (i.e., the value delivered by the @cite{Pos} attribute). @node Address Clauses,Use of Address Clauses for Memory-Mapped I/O,Enumeration Clauses,Representation Clauses and Pragmas -@anchor{gnat_rm/representation_clauses_and_pragmas id16}@anchor{244}@anchor{gnat_rm/representation_clauses_and_pragmas address-clauses}@anchor{245} +@anchor{gnat_rm/representation_clauses_and_pragmas id16}@anchor{246}@anchor{gnat_rm/representation_clauses_and_pragmas address-clauses}@anchor{247} @section Address Clauses @@ -19197,7 +19236,7 @@ then the program compiles without the warning and when run will generate the output @cite{X was not clobbered}. @node Use of Address Clauses for Memory-Mapped I/O,Effect of Convention on Representation,Address Clauses,Representation Clauses and Pragmas -@anchor{gnat_rm/representation_clauses_and_pragmas id17}@anchor{246}@anchor{gnat_rm/representation_clauses_and_pragmas use-of-address-clauses-for-memory-mapped-i-o}@anchor{247} +@anchor{gnat_rm/representation_clauses_and_pragmas id17}@anchor{248}@anchor{gnat_rm/representation_clauses_and_pragmas use-of-address-clauses-for-memory-mapped-i-o}@anchor{249} @section Use of Address Clauses for Memory-Mapped I/O @@ -19255,7 +19294,7 @@ components to be atomic if you want the byte store, or explicitly writing the full word access sequence if that is what the hardware requires. @node Effect of Convention on Representation,Conventions and Anonymous Access Types,Use of Address Clauses for Memory-Mapped I/O,Representation Clauses and Pragmas -@anchor{gnat_rm/representation_clauses_and_pragmas id18}@anchor{248}@anchor{gnat_rm/representation_clauses_and_pragmas effect-of-convention-on-representation}@anchor{249} +@anchor{gnat_rm/representation_clauses_and_pragmas id18}@anchor{24a}@anchor{gnat_rm/representation_clauses_and_pragmas effect-of-convention-on-representation}@anchor{24b} @section Effect of Convention on Representation @@ -19333,7 +19372,7 @@ when one of these values is read, any nonzero value is treated as True. @end itemize @node Conventions and Anonymous Access Types,Determining the Representations chosen by GNAT,Effect of Convention on Representation,Representation Clauses and Pragmas -@anchor{gnat_rm/representation_clauses_and_pragmas conventions-and-anonymous-access-types}@anchor{24a}@anchor{gnat_rm/representation_clauses_and_pragmas id19}@anchor{24b} +@anchor{gnat_rm/representation_clauses_and_pragmas conventions-and-anonymous-access-types}@anchor{24c}@anchor{gnat_rm/representation_clauses_and_pragmas id19}@anchor{24d} @section Conventions and Anonymous Access Types @@ -19409,7 +19448,7 @@ package ConvComp is @end example @node Determining the Representations chosen by GNAT,,Conventions and Anonymous Access Types,Representation Clauses and Pragmas -@anchor{gnat_rm/representation_clauses_and_pragmas id20}@anchor{24c}@anchor{gnat_rm/representation_clauses_and_pragmas determining-the-representations-chosen-by-gnat}@anchor{24d} +@anchor{gnat_rm/representation_clauses_and_pragmas id20}@anchor{24e}@anchor{gnat_rm/representation_clauses_and_pragmas determining-the-representations-chosen-by-gnat}@anchor{24f} @section Determining the Representations chosen by GNAT @@ -19561,7 +19600,7 @@ generated by the compiler into the original source to fix and guarantee the actual representation to be used. @node Standard Library Routines,The Implementation of Standard I/O,Representation Clauses and Pragmas,Top -@anchor{gnat_rm/standard_library_routines standard-library-routines}@anchor{e}@anchor{gnat_rm/standard_library_routines doc}@anchor{24e}@anchor{gnat_rm/standard_library_routines id1}@anchor{24f} +@anchor{gnat_rm/standard_library_routines standard-library-routines}@anchor{e}@anchor{gnat_rm/standard_library_routines doc}@anchor{250}@anchor{gnat_rm/standard_library_routines id1}@anchor{251} @chapter Standard Library Routines @@ -20384,7 +20423,7 @@ For packages in Interfaces and System, all the RM defined packages are available in GNAT, see the Ada 2012 RM for full details. @node The Implementation of Standard I/O,The GNAT Library,Standard Library Routines,Top -@anchor{gnat_rm/the_implementation_of_standard_i_o the-implementation-of-standard-i-o}@anchor{f}@anchor{gnat_rm/the_implementation_of_standard_i_o doc}@anchor{250}@anchor{gnat_rm/the_implementation_of_standard_i_o id1}@anchor{251} +@anchor{gnat_rm/the_implementation_of_standard_i_o the-implementation-of-standard-i-o}@anchor{f}@anchor{gnat_rm/the_implementation_of_standard_i_o doc}@anchor{252}@anchor{gnat_rm/the_implementation_of_standard_i_o id1}@anchor{253} @chapter The Implementation of Standard I/O @@ -20436,7 +20475,7 @@ these additional facilities are also described in this chapter. @end menu @node Standard I/O Packages,FORM Strings,,The Implementation of Standard I/O -@anchor{gnat_rm/the_implementation_of_standard_i_o standard-i-o-packages}@anchor{252}@anchor{gnat_rm/the_implementation_of_standard_i_o id2}@anchor{253} +@anchor{gnat_rm/the_implementation_of_standard_i_o standard-i-o-packages}@anchor{254}@anchor{gnat_rm/the_implementation_of_standard_i_o id2}@anchor{255} @section Standard I/O Packages @@ -20507,7 +20546,7 @@ flush the common I/O streams and in particular Standard_Output before elaborating the Ada code. @node FORM Strings,Direct_IO,Standard I/O Packages,The Implementation of Standard I/O -@anchor{gnat_rm/the_implementation_of_standard_i_o form-strings}@anchor{254}@anchor{gnat_rm/the_implementation_of_standard_i_o id3}@anchor{255} +@anchor{gnat_rm/the_implementation_of_standard_i_o form-strings}@anchor{256}@anchor{gnat_rm/the_implementation_of_standard_i_o id3}@anchor{257} @section FORM Strings @@ -20533,7 +20572,7 @@ unrecognized keyword appears in a form string, it is silently ignored and not considered invalid. @node Direct_IO,Sequential_IO,FORM Strings,The Implementation of Standard I/O -@anchor{gnat_rm/the_implementation_of_standard_i_o direct-io}@anchor{256}@anchor{gnat_rm/the_implementation_of_standard_i_o id4}@anchor{257} +@anchor{gnat_rm/the_implementation_of_standard_i_o direct-io}@anchor{258}@anchor{gnat_rm/the_implementation_of_standard_i_o id4}@anchor{259} @section Direct_IO @@ -20553,7 +20592,7 @@ There is no limit on the size of Direct_IO files, they are expanded as necessary to accommodate whatever records are written to the file. @node Sequential_IO,Text_IO,Direct_IO,The Implementation of Standard I/O -@anchor{gnat_rm/the_implementation_of_standard_i_o sequential-io}@anchor{258}@anchor{gnat_rm/the_implementation_of_standard_i_o id5}@anchor{259} +@anchor{gnat_rm/the_implementation_of_standard_i_o sequential-io}@anchor{25a}@anchor{gnat_rm/the_implementation_of_standard_i_o id5}@anchor{25b} @section Sequential_IO @@ -20600,7 +20639,7 @@ using Stream_IO, and this is the preferred mechanism. In particular, the above program fragment rewritten to use Stream_IO will work correctly. @node Text_IO,Wide_Text_IO,Sequential_IO,The Implementation of Standard I/O -@anchor{gnat_rm/the_implementation_of_standard_i_o id6}@anchor{25a}@anchor{gnat_rm/the_implementation_of_standard_i_o text-io}@anchor{25b} +@anchor{gnat_rm/the_implementation_of_standard_i_o id6}@anchor{25c}@anchor{gnat_rm/the_implementation_of_standard_i_o text-io}@anchor{25d} @section Text_IO @@ -20683,7 +20722,7 @@ the file. @end menu @node Stream Pointer Positioning,Reading and Writing Non-Regular Files,,Text_IO -@anchor{gnat_rm/the_implementation_of_standard_i_o id7}@anchor{25c}@anchor{gnat_rm/the_implementation_of_standard_i_o stream-pointer-positioning}@anchor{25d} +@anchor{gnat_rm/the_implementation_of_standard_i_o id7}@anchor{25e}@anchor{gnat_rm/the_implementation_of_standard_i_o stream-pointer-positioning}@anchor{25f} @subsection Stream Pointer Positioning @@ -20719,7 +20758,7 @@ between two Ada files, then the difference may be observable in some situations. @node Reading and Writing Non-Regular Files,Get_Immediate,Stream Pointer Positioning,Text_IO -@anchor{gnat_rm/the_implementation_of_standard_i_o reading-and-writing-non-regular-files}@anchor{25e}@anchor{gnat_rm/the_implementation_of_standard_i_o id8}@anchor{25f} +@anchor{gnat_rm/the_implementation_of_standard_i_o reading-and-writing-non-regular-files}@anchor{260}@anchor{gnat_rm/the_implementation_of_standard_i_o id8}@anchor{261} @subsection Reading and Writing Non-Regular Files @@ -20770,7 +20809,7 @@ to read data past that end of file indication, until another end of file indication is entered. @node Get_Immediate,Treating Text_IO Files as Streams,Reading and Writing Non-Regular Files,Text_IO -@anchor{gnat_rm/the_implementation_of_standard_i_o get-immediate}@anchor{260}@anchor{gnat_rm/the_implementation_of_standard_i_o id9}@anchor{261} +@anchor{gnat_rm/the_implementation_of_standard_i_o get-immediate}@anchor{262}@anchor{gnat_rm/the_implementation_of_standard_i_o id9}@anchor{263} @subsection Get_Immediate @@ -20788,7 +20827,7 @@ possible), it is undefined whether the FF character will be treated as a page mark. @node Treating Text_IO Files as Streams,Text_IO Extensions,Get_Immediate,Text_IO -@anchor{gnat_rm/the_implementation_of_standard_i_o id10}@anchor{262}@anchor{gnat_rm/the_implementation_of_standard_i_o treating-text-io-files-as-streams}@anchor{263} +@anchor{gnat_rm/the_implementation_of_standard_i_o id10}@anchor{264}@anchor{gnat_rm/the_implementation_of_standard_i_o treating-text-io-files-as-streams}@anchor{265} @subsection Treating Text_IO Files as Streams @@ -20804,7 +20843,7 @@ skipped and the effect is similar to that described above for @cite{Get_Immediate}. @node Text_IO Extensions,Text_IO Facilities for Unbounded Strings,Treating Text_IO Files as Streams,Text_IO -@anchor{gnat_rm/the_implementation_of_standard_i_o id11}@anchor{264}@anchor{gnat_rm/the_implementation_of_standard_i_o text-io-extensions}@anchor{265} +@anchor{gnat_rm/the_implementation_of_standard_i_o id11}@anchor{266}@anchor{gnat_rm/the_implementation_of_standard_i_o text-io-extensions}@anchor{267} @subsection Text_IO Extensions @@ -20832,7 +20871,7 @@ the string is to be read. @end itemize @node Text_IO Facilities for Unbounded Strings,,Text_IO Extensions,Text_IO -@anchor{gnat_rm/the_implementation_of_standard_i_o text-io-facilities-for-unbounded-strings}@anchor{266}@anchor{gnat_rm/the_implementation_of_standard_i_o id12}@anchor{267} +@anchor{gnat_rm/the_implementation_of_standard_i_o text-io-facilities-for-unbounded-strings}@anchor{268}@anchor{gnat_rm/the_implementation_of_standard_i_o id12}@anchor{269} @subsection Text_IO Facilities for Unbounded Strings @@ -20880,7 +20919,7 @@ files @code{a-szuzti.ads} and @code{a-szuzti.adb} provides similar extended @cite{Wide_Wide_Text_IO} functionality for unbounded wide wide strings. @node Wide_Text_IO,Wide_Wide_Text_IO,Text_IO,The Implementation of Standard I/O -@anchor{gnat_rm/the_implementation_of_standard_i_o wide-text-io}@anchor{268}@anchor{gnat_rm/the_implementation_of_standard_i_o id13}@anchor{269} +@anchor{gnat_rm/the_implementation_of_standard_i_o wide-text-io}@anchor{26a}@anchor{gnat_rm/the_implementation_of_standard_i_o id13}@anchor{26b} @section Wide_Text_IO @@ -21127,12 +21166,12 @@ input also causes Constraint_Error to be raised. @end menu @node Stream Pointer Positioning<2>,Reading and Writing Non-Regular Files<2>,,Wide_Text_IO -@anchor{gnat_rm/the_implementation_of_standard_i_o stream-pointer-positioning-1}@anchor{26a}@anchor{gnat_rm/the_implementation_of_standard_i_o id14}@anchor{26b} +@anchor{gnat_rm/the_implementation_of_standard_i_o stream-pointer-positioning-1}@anchor{26c}@anchor{gnat_rm/the_implementation_of_standard_i_o id14}@anchor{26d} @subsection Stream Pointer Positioning @cite{Ada.Wide_Text_IO} is similar to @cite{Ada.Text_IO} in its handling -of stream pointer positioning (@ref{25b,,Text_IO}). There is one additional +of stream pointer positioning (@ref{25d,,Text_IO}). There is one additional case: If @cite{Ada.Wide_Text_IO.Look_Ahead} reads a character outside the @@ -21151,7 +21190,7 @@ to a normal program using @cite{Wide_Text_IO}. However, this discrepancy can be observed if the wide text file shares a stream with another file. @node Reading and Writing Non-Regular Files<2>,,Stream Pointer Positioning<2>,Wide_Text_IO -@anchor{gnat_rm/the_implementation_of_standard_i_o reading-and-writing-non-regular-files-1}@anchor{26c}@anchor{gnat_rm/the_implementation_of_standard_i_o id15}@anchor{26d} +@anchor{gnat_rm/the_implementation_of_standard_i_o reading-and-writing-non-regular-files-1}@anchor{26e}@anchor{gnat_rm/the_implementation_of_standard_i_o id15}@anchor{26f} @subsection Reading and Writing Non-Regular Files @@ -21162,7 +21201,7 @@ treated as data characters), and @cite{End_Of_Page} always returns it is possible to read beyond an end of file. @node Wide_Wide_Text_IO,Stream_IO,Wide_Text_IO,The Implementation of Standard I/O -@anchor{gnat_rm/the_implementation_of_standard_i_o id16}@anchor{26e}@anchor{gnat_rm/the_implementation_of_standard_i_o wide-wide-text-io}@anchor{26f} +@anchor{gnat_rm/the_implementation_of_standard_i_o id16}@anchor{270}@anchor{gnat_rm/the_implementation_of_standard_i_o wide-wide-text-io}@anchor{271} @section Wide_Wide_Text_IO @@ -21331,12 +21370,12 @@ input also causes Constraint_Error to be raised. @end menu @node Stream Pointer Positioning<3>,Reading and Writing Non-Regular Files<3>,,Wide_Wide_Text_IO -@anchor{gnat_rm/the_implementation_of_standard_i_o stream-pointer-positioning-2}@anchor{270}@anchor{gnat_rm/the_implementation_of_standard_i_o id17}@anchor{271} +@anchor{gnat_rm/the_implementation_of_standard_i_o stream-pointer-positioning-2}@anchor{272}@anchor{gnat_rm/the_implementation_of_standard_i_o id17}@anchor{273} @subsection Stream Pointer Positioning @cite{Ada.Wide_Wide_Text_IO} is similar to @cite{Ada.Text_IO} in its handling -of stream pointer positioning (@ref{25b,,Text_IO}). There is one additional +of stream pointer positioning (@ref{25d,,Text_IO}). There is one additional case: If @cite{Ada.Wide_Wide_Text_IO.Look_Ahead} reads a character outside the @@ -21355,7 +21394,7 @@ to a normal program using @cite{Wide_Wide_Text_IO}. However, this discrepancy can be observed if the wide text file shares a stream with another file. @node Reading and Writing Non-Regular Files<3>,,Stream Pointer Positioning<3>,Wide_Wide_Text_IO -@anchor{gnat_rm/the_implementation_of_standard_i_o id18}@anchor{272}@anchor{gnat_rm/the_implementation_of_standard_i_o reading-and-writing-non-regular-files-2}@anchor{273} +@anchor{gnat_rm/the_implementation_of_standard_i_o id18}@anchor{274}@anchor{gnat_rm/the_implementation_of_standard_i_o reading-and-writing-non-regular-files-2}@anchor{275} @subsection Reading and Writing Non-Regular Files @@ -21366,7 +21405,7 @@ treated as data characters), and @cite{End_Of_Page} always returns it is possible to read beyond an end of file. @node Stream_IO,Text Translation,Wide_Wide_Text_IO,The Implementation of Standard I/O -@anchor{gnat_rm/the_implementation_of_standard_i_o id19}@anchor{274}@anchor{gnat_rm/the_implementation_of_standard_i_o stream-io}@anchor{275} +@anchor{gnat_rm/the_implementation_of_standard_i_o id19}@anchor{276}@anchor{gnat_rm/the_implementation_of_standard_i_o stream-io}@anchor{277} @section Stream_IO @@ -21388,7 +21427,7 @@ manner described for stream attributes. @end itemize @node Text Translation,Shared Files,Stream_IO,The Implementation of Standard I/O -@anchor{gnat_rm/the_implementation_of_standard_i_o id20}@anchor{276}@anchor{gnat_rm/the_implementation_of_standard_i_o text-translation}@anchor{277} +@anchor{gnat_rm/the_implementation_of_standard_i_o id20}@anchor{278}@anchor{gnat_rm/the_implementation_of_standard_i_o text-translation}@anchor{279} @section Text Translation @@ -21422,7 +21461,7 @@ mode. (corresponds to_O_U16TEXT). @end itemize @node Shared Files,Filenames encoding,Text Translation,The Implementation of Standard I/O -@anchor{gnat_rm/the_implementation_of_standard_i_o id21}@anchor{278}@anchor{gnat_rm/the_implementation_of_standard_i_o shared-files}@anchor{279} +@anchor{gnat_rm/the_implementation_of_standard_i_o id21}@anchor{27a}@anchor{gnat_rm/the_implementation_of_standard_i_o shared-files}@anchor{27b} @section Shared Files @@ -21485,7 +21524,7 @@ heterogeneous input-output. Although this approach will work in GNAT if for this purpose (using the stream attributes) @node Filenames encoding,File content encoding,Shared Files,The Implementation of Standard I/O -@anchor{gnat_rm/the_implementation_of_standard_i_o filenames-encoding}@anchor{27a}@anchor{gnat_rm/the_implementation_of_standard_i_o id22}@anchor{27b} +@anchor{gnat_rm/the_implementation_of_standard_i_o filenames-encoding}@anchor{27c}@anchor{gnat_rm/the_implementation_of_standard_i_o id22}@anchor{27d} @section Filenames encoding @@ -21525,7 +21564,7 @@ platform. On the other Operating Systems the run-time is supporting UTF-8 natively. @node File content encoding,Open Modes,Filenames encoding,The Implementation of Standard I/O -@anchor{gnat_rm/the_implementation_of_standard_i_o file-content-encoding}@anchor{27c}@anchor{gnat_rm/the_implementation_of_standard_i_o id23}@anchor{27d} +@anchor{gnat_rm/the_implementation_of_standard_i_o file-content-encoding}@anchor{27e}@anchor{gnat_rm/the_implementation_of_standard_i_o id23}@anchor{27f} @section File content encoding @@ -21558,7 +21597,7 @@ Unicode 8-bit encoding This encoding is only supported on the Windows platform. @node Open Modes,Operations on C Streams,File content encoding,The Implementation of Standard I/O -@anchor{gnat_rm/the_implementation_of_standard_i_o open-modes}@anchor{27e}@anchor{gnat_rm/the_implementation_of_standard_i_o id24}@anchor{27f} +@anchor{gnat_rm/the_implementation_of_standard_i_o open-modes}@anchor{280}@anchor{gnat_rm/the_implementation_of_standard_i_o id24}@anchor{281} @section Open Modes @@ -21661,7 +21700,7 @@ subsequently requires switching from reading to writing or vice-versa, then the file is reopened in @code{r+} mode to permit the required operation. @node Operations on C Streams,Interfacing to C Streams,Open Modes,The Implementation of Standard I/O -@anchor{gnat_rm/the_implementation_of_standard_i_o operations-on-c-streams}@anchor{280}@anchor{gnat_rm/the_implementation_of_standard_i_o id25}@anchor{281} +@anchor{gnat_rm/the_implementation_of_standard_i_o operations-on-c-streams}@anchor{282}@anchor{gnat_rm/the_implementation_of_standard_i_o id25}@anchor{283} @section Operations on C Streams @@ -21821,7 +21860,7 @@ end Interfaces.C_Streams; @end example @node Interfacing to C Streams,,Operations on C Streams,The Implementation of Standard I/O -@anchor{gnat_rm/the_implementation_of_standard_i_o interfacing-to-c-streams}@anchor{282}@anchor{gnat_rm/the_implementation_of_standard_i_o id26}@anchor{283} +@anchor{gnat_rm/the_implementation_of_standard_i_o interfacing-to-c-streams}@anchor{284}@anchor{gnat_rm/the_implementation_of_standard_i_o id26}@anchor{285} @section Interfacing to C Streams @@ -21914,7 +21953,7 @@ imported from a C program, allowing an Ada file to operate on an existing C file. @node The GNAT Library,Interfacing to Other Languages,The Implementation of Standard I/O,Top -@anchor{gnat_rm/the_gnat_library the-gnat-library}@anchor{10}@anchor{gnat_rm/the_gnat_library doc}@anchor{284}@anchor{gnat_rm/the_gnat_library id1}@anchor{285} +@anchor{gnat_rm/the_gnat_library the-gnat-library}@anchor{10}@anchor{gnat_rm/the_gnat_library doc}@anchor{286}@anchor{gnat_rm/the_gnat_library id1}@anchor{287} @chapter The GNAT Library @@ -22101,7 +22140,7 @@ of GNAT, and will generate a warning message. @end menu @node Ada Characters Latin_9 a-chlat9 ads,Ada Characters Wide_Latin_1 a-cwila1 ads,,The GNAT Library -@anchor{gnat_rm/the_gnat_library id2}@anchor{286}@anchor{gnat_rm/the_gnat_library ada-characters-latin-9-a-chlat9-ads}@anchor{287} +@anchor{gnat_rm/the_gnat_library id2}@anchor{288}@anchor{gnat_rm/the_gnat_library ada-characters-latin-9-a-chlat9-ads}@anchor{289} @section @cite{Ada.Characters.Latin_9} (@code{a-chlat9.ads}) @@ -22118,7 +22157,7 @@ is specifically authorized by the Ada Reference Manual (RM A.3.3(27)). @node Ada Characters Wide_Latin_1 a-cwila1 ads,Ada Characters Wide_Latin_9 a-cwila1 ads,Ada Characters Latin_9 a-chlat9 ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library ada-characters-wide-latin-1-a-cwila1-ads}@anchor{288}@anchor{gnat_rm/the_gnat_library id3}@anchor{289} +@anchor{gnat_rm/the_gnat_library ada-characters-wide-latin-1-a-cwila1-ads}@anchor{28a}@anchor{gnat_rm/the_gnat_library id3}@anchor{28b} @section @cite{Ada.Characters.Wide_Latin_1} (@code{a-cwila1.ads}) @@ -22135,7 +22174,7 @@ is specifically authorized by the Ada Reference Manual (RM A.3.3(27)). @node Ada Characters Wide_Latin_9 a-cwila1 ads,Ada Characters Wide_Wide_Latin_1 a-chzla1 ads,Ada Characters Wide_Latin_1 a-cwila1 ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id4}@anchor{28a}@anchor{gnat_rm/the_gnat_library ada-characters-wide-latin-9-a-cwila1-ads}@anchor{28b} +@anchor{gnat_rm/the_gnat_library id4}@anchor{28c}@anchor{gnat_rm/the_gnat_library ada-characters-wide-latin-9-a-cwila1-ads}@anchor{28d} @section @cite{Ada.Characters.Wide_Latin_9} (@code{a-cwila1.ads}) @@ -22152,7 +22191,7 @@ is specifically authorized by the Ada Reference Manual (RM A.3.3(27)). @node Ada Characters Wide_Wide_Latin_1 a-chzla1 ads,Ada Characters Wide_Wide_Latin_9 a-chzla9 ads,Ada Characters Wide_Latin_9 a-cwila1 ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library ada-characters-wide-wide-latin-1-a-chzla1-ads}@anchor{28c}@anchor{gnat_rm/the_gnat_library id5}@anchor{28d} +@anchor{gnat_rm/the_gnat_library ada-characters-wide-wide-latin-1-a-chzla1-ads}@anchor{28e}@anchor{gnat_rm/the_gnat_library id5}@anchor{28f} @section @cite{Ada.Characters.Wide_Wide_Latin_1} (@code{a-chzla1.ads}) @@ -22169,7 +22208,7 @@ is specifically authorized by the Ada Reference Manual (RM A.3.3(27)). @node Ada Characters Wide_Wide_Latin_9 a-chzla9 ads,Ada Containers Formal_Doubly_Linked_Lists a-cfdlli ads,Ada Characters Wide_Wide_Latin_1 a-chzla1 ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library ada-characters-wide-wide-latin-9-a-chzla9-ads}@anchor{28e}@anchor{gnat_rm/the_gnat_library id6}@anchor{28f} +@anchor{gnat_rm/the_gnat_library ada-characters-wide-wide-latin-9-a-chzla9-ads}@anchor{290}@anchor{gnat_rm/the_gnat_library id6}@anchor{291} @section @cite{Ada.Characters.Wide_Wide_Latin_9} (@code{a-chzla9.ads}) @@ -22186,7 +22225,7 @@ is specifically authorized by the Ada Reference Manual (RM A.3.3(27)). @node Ada Containers Formal_Doubly_Linked_Lists a-cfdlli ads,Ada Containers Formal_Hashed_Maps a-cfhama ads,Ada Characters Wide_Wide_Latin_9 a-chzla9 ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id7}@anchor{290}@anchor{gnat_rm/the_gnat_library ada-containers-formal-doubly-linked-lists-a-cfdlli-ads}@anchor{291} +@anchor{gnat_rm/the_gnat_library id7}@anchor{292}@anchor{gnat_rm/the_gnat_library ada-containers-formal-doubly-linked-lists-a-cfdlli-ads}@anchor{293} @section @cite{Ada.Containers.Formal_Doubly_Linked_Lists} (@code{a-cfdlli.ads}) @@ -22205,7 +22244,7 @@ efficient version than the one defined in the standard. In particular it does not have the complex overhead required to detect cursor tampering. @node Ada Containers Formal_Hashed_Maps a-cfhama ads,Ada Containers Formal_Hashed_Sets a-cfhase ads,Ada Containers Formal_Doubly_Linked_Lists a-cfdlli ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id8}@anchor{292}@anchor{gnat_rm/the_gnat_library ada-containers-formal-hashed-maps-a-cfhama-ads}@anchor{293} +@anchor{gnat_rm/the_gnat_library id8}@anchor{294}@anchor{gnat_rm/the_gnat_library ada-containers-formal-hashed-maps-a-cfhama-ads}@anchor{295} @section @cite{Ada.Containers.Formal_Hashed_Maps} (@code{a-cfhama.ads}) @@ -22224,7 +22263,7 @@ efficient version than the one defined in the standard. In particular it does not have the complex overhead required to detect cursor tampering. @node Ada Containers Formal_Hashed_Sets a-cfhase ads,Ada Containers Formal_Ordered_Maps a-cforma ads,Ada Containers Formal_Hashed_Maps a-cfhama ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id9}@anchor{294}@anchor{gnat_rm/the_gnat_library ada-containers-formal-hashed-sets-a-cfhase-ads}@anchor{295} +@anchor{gnat_rm/the_gnat_library id9}@anchor{296}@anchor{gnat_rm/the_gnat_library ada-containers-formal-hashed-sets-a-cfhase-ads}@anchor{297} @section @cite{Ada.Containers.Formal_Hashed_Sets} (@code{a-cfhase.ads}) @@ -22243,7 +22282,7 @@ efficient version than the one defined in the standard. In particular it does not have the complex overhead required to detect cursor tampering. @node Ada Containers Formal_Ordered_Maps a-cforma ads,Ada Containers Formal_Ordered_Sets a-cforse ads,Ada Containers Formal_Hashed_Sets a-cfhase ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id10}@anchor{296}@anchor{gnat_rm/the_gnat_library ada-containers-formal-ordered-maps-a-cforma-ads}@anchor{297} +@anchor{gnat_rm/the_gnat_library id10}@anchor{298}@anchor{gnat_rm/the_gnat_library ada-containers-formal-ordered-maps-a-cforma-ads}@anchor{299} @section @cite{Ada.Containers.Formal_Ordered_Maps} (@code{a-cforma.ads}) @@ -22262,7 +22301,7 @@ efficient version than the one defined in the standard. In particular it does not have the complex overhead required to detect cursor tampering. @node Ada Containers Formal_Ordered_Sets a-cforse ads,Ada Containers Formal_Vectors a-cofove ads,Ada Containers Formal_Ordered_Maps a-cforma ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library ada-containers-formal-ordered-sets-a-cforse-ads}@anchor{298}@anchor{gnat_rm/the_gnat_library id11}@anchor{299} +@anchor{gnat_rm/the_gnat_library ada-containers-formal-ordered-sets-a-cforse-ads}@anchor{29a}@anchor{gnat_rm/the_gnat_library id11}@anchor{29b} @section @cite{Ada.Containers.Formal_Ordered_Sets} (@code{a-cforse.ads}) @@ -22281,7 +22320,7 @@ efficient version than the one defined in the standard. In particular it does not have the complex overhead required to detect cursor tampering. @node Ada Containers Formal_Vectors a-cofove ads,Ada Containers Formal_Indefinite_Vectors a-cfinve ads,Ada Containers Formal_Ordered_Sets a-cforse ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id12}@anchor{29a}@anchor{gnat_rm/the_gnat_library ada-containers-formal-vectors-a-cofove-ads}@anchor{29b} +@anchor{gnat_rm/the_gnat_library id12}@anchor{29c}@anchor{gnat_rm/the_gnat_library ada-containers-formal-vectors-a-cofove-ads}@anchor{29d} @section @cite{Ada.Containers.Formal_Vectors} (@code{a-cofove.ads}) @@ -22300,7 +22339,7 @@ efficient version than the one defined in the standard. In particular it does not have the complex overhead required to detect cursor tampering. @node Ada Containers Formal_Indefinite_Vectors a-cfinve ads,Ada Containers Bounded_Holders a-coboho ads,Ada Containers Formal_Vectors a-cofove ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id13}@anchor{29c}@anchor{gnat_rm/the_gnat_library ada-containers-formal-indefinite-vectors-a-cfinve-ads}@anchor{29d} +@anchor{gnat_rm/the_gnat_library id13}@anchor{29e}@anchor{gnat_rm/the_gnat_library ada-containers-formal-indefinite-vectors-a-cfinve-ads}@anchor{29f} @section @cite{Ada.Containers.Formal_Indefinite_Vectors} (@code{a-cfinve.ads}) @@ -22319,7 +22358,7 @@ efficient version than the one defined in the standard. In particular it does not have the complex overhead required to detect cursor tampering. @node Ada Containers Bounded_Holders a-coboho ads,Ada Command_Line Environment a-colien ads,Ada Containers Formal_Indefinite_Vectors a-cfinve ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id14}@anchor{29e}@anchor{gnat_rm/the_gnat_library ada-containers-bounded-holders-a-coboho-ads}@anchor{29f} +@anchor{gnat_rm/the_gnat_library id14}@anchor{2a0}@anchor{gnat_rm/the_gnat_library ada-containers-bounded-holders-a-coboho-ads}@anchor{2a1} @section @cite{Ada.Containers.Bounded_Holders} (@code{a-coboho.ads}) @@ -22331,7 +22370,7 @@ This child of @cite{Ada.Containers} defines a modified version of Indefinite_Holders that avoids heap allocation. @node Ada Command_Line Environment a-colien ads,Ada Command_Line Remove a-colire ads,Ada Containers Bounded_Holders a-coboho ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library ada-command-line-environment-a-colien-ads}@anchor{2a0}@anchor{gnat_rm/the_gnat_library id15}@anchor{2a1} +@anchor{gnat_rm/the_gnat_library ada-command-line-environment-a-colien-ads}@anchor{2a2}@anchor{gnat_rm/the_gnat_library id15}@anchor{2a3} @section @cite{Ada.Command_Line.Environment} (@code{a-colien.ads}) @@ -22344,7 +22383,7 @@ provides a mechanism for obtaining environment values on systems where this concept makes sense. @node Ada Command_Line Remove a-colire ads,Ada Command_Line Response_File a-clrefi ads,Ada Command_Line Environment a-colien ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id16}@anchor{2a2}@anchor{gnat_rm/the_gnat_library ada-command-line-remove-a-colire-ads}@anchor{2a3} +@anchor{gnat_rm/the_gnat_library id16}@anchor{2a4}@anchor{gnat_rm/the_gnat_library ada-command-line-remove-a-colire-ads}@anchor{2a5} @section @cite{Ada.Command_Line.Remove} (@code{a-colire.ads}) @@ -22362,7 +22401,7 @@ to further calls on the subprograms in @cite{Ada.Command_Line} will not see the removed argument. @node Ada Command_Line Response_File a-clrefi ads,Ada Direct_IO C_Streams a-diocst ads,Ada Command_Line Remove a-colire ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library ada-command-line-response-file-a-clrefi-ads}@anchor{2a4}@anchor{gnat_rm/the_gnat_library id17}@anchor{2a5} +@anchor{gnat_rm/the_gnat_library ada-command-line-response-file-a-clrefi-ads}@anchor{2a6}@anchor{gnat_rm/the_gnat_library id17}@anchor{2a7} @section @cite{Ada.Command_Line.Response_File} (@code{a-clrefi.ads}) @@ -22382,7 +22421,7 @@ Using a response file allow passing a set of arguments to an executable longer than the maximum allowed by the system on the command line. @node Ada Direct_IO C_Streams a-diocst ads,Ada Exceptions Is_Null_Occurrence a-einuoc ads,Ada Command_Line Response_File a-clrefi ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id18}@anchor{2a6}@anchor{gnat_rm/the_gnat_library ada-direct-io-c-streams-a-diocst-ads}@anchor{2a7} +@anchor{gnat_rm/the_gnat_library id18}@anchor{2a8}@anchor{gnat_rm/the_gnat_library ada-direct-io-c-streams-a-diocst-ads}@anchor{2a9} @section @cite{Ada.Direct_IO.C_Streams} (@code{a-diocst.ads}) @@ -22397,7 +22436,7 @@ extracted from a file opened on the Ada side, and an Ada file can be constructed from a stream opened on the C side. @node Ada Exceptions Is_Null_Occurrence a-einuoc ads,Ada Exceptions Last_Chance_Handler a-elchha ads,Ada Direct_IO C_Streams a-diocst ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id19}@anchor{2a8}@anchor{gnat_rm/the_gnat_library ada-exceptions-is-null-occurrence-a-einuoc-ads}@anchor{2a9} +@anchor{gnat_rm/the_gnat_library id19}@anchor{2aa}@anchor{gnat_rm/the_gnat_library ada-exceptions-is-null-occurrence-a-einuoc-ads}@anchor{2ab} @section @cite{Ada.Exceptions.Is_Null_Occurrence} (@code{a-einuoc.ads}) @@ -22411,7 +22450,7 @@ exception occurrence (@cite{Null_Occurrence}) without raising an exception. @node Ada Exceptions Last_Chance_Handler a-elchha ads,Ada Exceptions Traceback a-exctra ads,Ada Exceptions Is_Null_Occurrence a-einuoc ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id20}@anchor{2aa}@anchor{gnat_rm/the_gnat_library ada-exceptions-last-chance-handler-a-elchha-ads}@anchor{2ab} +@anchor{gnat_rm/the_gnat_library id20}@anchor{2ac}@anchor{gnat_rm/the_gnat_library ada-exceptions-last-chance-handler-a-elchha-ads}@anchor{2ad} @section @cite{Ada.Exceptions.Last_Chance_Handler} (@code{a-elchha.ads}) @@ -22425,7 +22464,7 @@ exceptions (hence the name last chance), and perform clean ups before terminating the program. Note that this subprogram never returns. @node Ada Exceptions Traceback a-exctra ads,Ada Sequential_IO C_Streams a-siocst ads,Ada Exceptions Last_Chance_Handler a-elchha ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library ada-exceptions-traceback-a-exctra-ads}@anchor{2ac}@anchor{gnat_rm/the_gnat_library id21}@anchor{2ad} +@anchor{gnat_rm/the_gnat_library ada-exceptions-traceback-a-exctra-ads}@anchor{2ae}@anchor{gnat_rm/the_gnat_library id21}@anchor{2af} @section @cite{Ada.Exceptions.Traceback} (@code{a-exctra.ads}) @@ -22438,7 +22477,7 @@ give a traceback array of addresses based on an exception occurrence. @node Ada Sequential_IO C_Streams a-siocst ads,Ada Streams Stream_IO C_Streams a-ssicst ads,Ada Exceptions Traceback a-exctra ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library ada-sequential-io-c-streams-a-siocst-ads}@anchor{2ae}@anchor{gnat_rm/the_gnat_library id22}@anchor{2af} +@anchor{gnat_rm/the_gnat_library ada-sequential-io-c-streams-a-siocst-ads}@anchor{2b0}@anchor{gnat_rm/the_gnat_library id22}@anchor{2b1} @section @cite{Ada.Sequential_IO.C_Streams} (@code{a-siocst.ads}) @@ -22453,7 +22492,7 @@ extracted from a file opened on the Ada side, and an Ada file can be constructed from a stream opened on the C side. @node Ada Streams Stream_IO C_Streams a-ssicst ads,Ada Strings Unbounded Text_IO a-suteio ads,Ada Sequential_IO C_Streams a-siocst ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id23}@anchor{2b0}@anchor{gnat_rm/the_gnat_library ada-streams-stream-io-c-streams-a-ssicst-ads}@anchor{2b1} +@anchor{gnat_rm/the_gnat_library id23}@anchor{2b2}@anchor{gnat_rm/the_gnat_library ada-streams-stream-io-c-streams-a-ssicst-ads}@anchor{2b3} @section @cite{Ada.Streams.Stream_IO.C_Streams} (@code{a-ssicst.ads}) @@ -22468,7 +22507,7 @@ extracted from a file opened on the Ada side, and an Ada file can be constructed from a stream opened on the C side. @node Ada Strings Unbounded Text_IO a-suteio ads,Ada Strings Wide_Unbounded Wide_Text_IO a-swuwti ads,Ada Streams Stream_IO C_Streams a-ssicst ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library ada-strings-unbounded-text-io-a-suteio-ads}@anchor{2b2}@anchor{gnat_rm/the_gnat_library id24}@anchor{2b3} +@anchor{gnat_rm/the_gnat_library ada-strings-unbounded-text-io-a-suteio-ads}@anchor{2b4}@anchor{gnat_rm/the_gnat_library id24}@anchor{2b5} @section @cite{Ada.Strings.Unbounded.Text_IO} (@code{a-suteio.ads}) @@ -22485,7 +22524,7 @@ strings, avoiding the necessity for an intermediate operation with ordinary strings. @node Ada Strings Wide_Unbounded Wide_Text_IO a-swuwti ads,Ada Strings Wide_Wide_Unbounded Wide_Wide_Text_IO a-szuzti ads,Ada Strings Unbounded Text_IO a-suteio ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id25}@anchor{2b4}@anchor{gnat_rm/the_gnat_library ada-strings-wide-unbounded-wide-text-io-a-swuwti-ads}@anchor{2b5} +@anchor{gnat_rm/the_gnat_library id25}@anchor{2b6}@anchor{gnat_rm/the_gnat_library ada-strings-wide-unbounded-wide-text-io-a-swuwti-ads}@anchor{2b7} @section @cite{Ada.Strings.Wide_Unbounded.Wide_Text_IO} (@code{a-swuwti.ads}) @@ -22502,7 +22541,7 @@ wide strings, avoiding the necessity for an intermediate operation with ordinary wide strings. @node Ada Strings Wide_Wide_Unbounded Wide_Wide_Text_IO a-szuzti ads,Ada Text_IO C_Streams a-tiocst ads,Ada Strings Wide_Unbounded Wide_Text_IO a-swuwti ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library ada-strings-wide-wide-unbounded-wide-wide-text-io-a-szuzti-ads}@anchor{2b6}@anchor{gnat_rm/the_gnat_library id26}@anchor{2b7} +@anchor{gnat_rm/the_gnat_library ada-strings-wide-wide-unbounded-wide-wide-text-io-a-szuzti-ads}@anchor{2b8}@anchor{gnat_rm/the_gnat_library id26}@anchor{2b9} @section @cite{Ada.Strings.Wide_Wide_Unbounded.Wide_Wide_Text_IO} (@code{a-szuzti.ads}) @@ -22519,7 +22558,7 @@ wide wide strings, avoiding the necessity for an intermediate operation with ordinary wide wide strings. @node Ada Text_IO C_Streams a-tiocst ads,Ada Text_IO Reset_Standard_Files a-tirsfi ads,Ada Strings Wide_Wide_Unbounded Wide_Wide_Text_IO a-szuzti ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library ada-text-io-c-streams-a-tiocst-ads}@anchor{2b8}@anchor{gnat_rm/the_gnat_library id27}@anchor{2b9} +@anchor{gnat_rm/the_gnat_library ada-text-io-c-streams-a-tiocst-ads}@anchor{2ba}@anchor{gnat_rm/the_gnat_library id27}@anchor{2bb} @section @cite{Ada.Text_IO.C_Streams} (@code{a-tiocst.ads}) @@ -22534,7 +22573,7 @@ extracted from a file opened on the Ada side, and an Ada file can be constructed from a stream opened on the C side. @node Ada Text_IO Reset_Standard_Files a-tirsfi ads,Ada Wide_Characters Unicode a-wichun ads,Ada Text_IO C_Streams a-tiocst ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id28}@anchor{2ba}@anchor{gnat_rm/the_gnat_library ada-text-io-reset-standard-files-a-tirsfi-ads}@anchor{2bb} +@anchor{gnat_rm/the_gnat_library id28}@anchor{2bc}@anchor{gnat_rm/the_gnat_library ada-text-io-reset-standard-files-a-tirsfi-ads}@anchor{2bd} @section @cite{Ada.Text_IO.Reset_Standard_Files} (@code{a-tirsfi.ads}) @@ -22549,7 +22588,7 @@ execution (for example a standard input file may be redefined to be interactive). @node Ada Wide_Characters Unicode a-wichun ads,Ada Wide_Text_IO C_Streams a-wtcstr ads,Ada Text_IO Reset_Standard_Files a-tirsfi ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id29}@anchor{2bc}@anchor{gnat_rm/the_gnat_library ada-wide-characters-unicode-a-wichun-ads}@anchor{2bd} +@anchor{gnat_rm/the_gnat_library id29}@anchor{2be}@anchor{gnat_rm/the_gnat_library ada-wide-characters-unicode-a-wichun-ads}@anchor{2bf} @section @cite{Ada.Wide_Characters.Unicode} (@code{a-wichun.ads}) @@ -22562,7 +22601,7 @@ This package provides subprograms that allow categorization of Wide_Character values according to Unicode categories. @node Ada Wide_Text_IO C_Streams a-wtcstr ads,Ada Wide_Text_IO Reset_Standard_Files a-wrstfi ads,Ada Wide_Characters Unicode a-wichun ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library ada-wide-text-io-c-streams-a-wtcstr-ads}@anchor{2be}@anchor{gnat_rm/the_gnat_library id30}@anchor{2bf} +@anchor{gnat_rm/the_gnat_library ada-wide-text-io-c-streams-a-wtcstr-ads}@anchor{2c0}@anchor{gnat_rm/the_gnat_library id30}@anchor{2c1} @section @cite{Ada.Wide_Text_IO.C_Streams} (@code{a-wtcstr.ads}) @@ -22577,7 +22616,7 @@ extracted from a file opened on the Ada side, and an Ada file can be constructed from a stream opened on the C side. @node Ada Wide_Text_IO Reset_Standard_Files a-wrstfi ads,Ada Wide_Wide_Characters Unicode a-zchuni ads,Ada Wide_Text_IO C_Streams a-wtcstr ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library ada-wide-text-io-reset-standard-files-a-wrstfi-ads}@anchor{2c0}@anchor{gnat_rm/the_gnat_library id31}@anchor{2c1} +@anchor{gnat_rm/the_gnat_library ada-wide-text-io-reset-standard-files-a-wrstfi-ads}@anchor{2c2}@anchor{gnat_rm/the_gnat_library id31}@anchor{2c3} @section @cite{Ada.Wide_Text_IO.Reset_Standard_Files} (@code{a-wrstfi.ads}) @@ -22592,7 +22631,7 @@ execution (for example a standard input file may be redefined to be interactive). @node Ada Wide_Wide_Characters Unicode a-zchuni ads,Ada Wide_Wide_Text_IO C_Streams a-ztcstr ads,Ada Wide_Text_IO Reset_Standard_Files a-wrstfi ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id32}@anchor{2c2}@anchor{gnat_rm/the_gnat_library ada-wide-wide-characters-unicode-a-zchuni-ads}@anchor{2c3} +@anchor{gnat_rm/the_gnat_library id32}@anchor{2c4}@anchor{gnat_rm/the_gnat_library ada-wide-wide-characters-unicode-a-zchuni-ads}@anchor{2c5} @section @cite{Ada.Wide_Wide_Characters.Unicode} (@code{a-zchuni.ads}) @@ -22605,7 +22644,7 @@ This package provides subprograms that allow categorization of Wide_Wide_Character values according to Unicode categories. @node Ada Wide_Wide_Text_IO C_Streams a-ztcstr ads,Ada Wide_Wide_Text_IO Reset_Standard_Files a-zrstfi ads,Ada Wide_Wide_Characters Unicode a-zchuni ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id33}@anchor{2c4}@anchor{gnat_rm/the_gnat_library ada-wide-wide-text-io-c-streams-a-ztcstr-ads}@anchor{2c5} +@anchor{gnat_rm/the_gnat_library id33}@anchor{2c6}@anchor{gnat_rm/the_gnat_library ada-wide-wide-text-io-c-streams-a-ztcstr-ads}@anchor{2c7} @section @cite{Ada.Wide_Wide_Text_IO.C_Streams} (@code{a-ztcstr.ads}) @@ -22620,7 +22659,7 @@ extracted from a file opened on the Ada side, and an Ada file can be constructed from a stream opened on the C side. @node Ada Wide_Wide_Text_IO Reset_Standard_Files a-zrstfi ads,GNAT Altivec g-altive ads,Ada Wide_Wide_Text_IO C_Streams a-ztcstr ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id34}@anchor{2c6}@anchor{gnat_rm/the_gnat_library ada-wide-wide-text-io-reset-standard-files-a-zrstfi-ads}@anchor{2c7} +@anchor{gnat_rm/the_gnat_library id34}@anchor{2c8}@anchor{gnat_rm/the_gnat_library ada-wide-wide-text-io-reset-standard-files-a-zrstfi-ads}@anchor{2c9} @section @cite{Ada.Wide_Wide_Text_IO.Reset_Standard_Files} (@code{a-zrstfi.ads}) @@ -22635,7 +22674,7 @@ change during execution (for example a standard input file may be redefined to be interactive). @node GNAT Altivec g-altive ads,GNAT Altivec Conversions g-altcon ads,Ada Wide_Wide_Text_IO Reset_Standard_Files a-zrstfi ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-altivec-g-altive-ads}@anchor{2c8}@anchor{gnat_rm/the_gnat_library id35}@anchor{2c9} +@anchor{gnat_rm/the_gnat_library gnat-altivec-g-altive-ads}@anchor{2ca}@anchor{gnat_rm/the_gnat_library id35}@anchor{2cb} @section @cite{GNAT.Altivec} (@code{g-altive.ads}) @@ -22648,7 +22687,7 @@ definitions of constants and types common to all the versions of the binding. @node GNAT Altivec Conversions g-altcon ads,GNAT Altivec Vector_Operations g-alveop ads,GNAT Altivec g-altive ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id36}@anchor{2ca}@anchor{gnat_rm/the_gnat_library gnat-altivec-conversions-g-altcon-ads}@anchor{2cb} +@anchor{gnat_rm/the_gnat_library id36}@anchor{2cc}@anchor{gnat_rm/the_gnat_library gnat-altivec-conversions-g-altcon-ads}@anchor{2cd} @section @cite{GNAT.Altivec.Conversions} (@code{g-altcon.ads}) @@ -22659,7 +22698,7 @@ binding. This package provides the Vector/View conversion routines. @node GNAT Altivec Vector_Operations g-alveop ads,GNAT Altivec Vector_Types g-alvety ads,GNAT Altivec Conversions g-altcon ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id37}@anchor{2cc}@anchor{gnat_rm/the_gnat_library gnat-altivec-vector-operations-g-alveop-ads}@anchor{2cd} +@anchor{gnat_rm/the_gnat_library id37}@anchor{2ce}@anchor{gnat_rm/the_gnat_library gnat-altivec-vector-operations-g-alveop-ads}@anchor{2cf} @section @cite{GNAT.Altivec.Vector_Operations} (@code{g-alveop.ads}) @@ -22673,7 +22712,7 @@ library. The hard binding is provided as a separate package. This unit is common to both bindings. @node GNAT Altivec Vector_Types g-alvety ads,GNAT Altivec Vector_Views g-alvevi ads,GNAT Altivec Vector_Operations g-alveop ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-altivec-vector-types-g-alvety-ads}@anchor{2ce}@anchor{gnat_rm/the_gnat_library id38}@anchor{2cf} +@anchor{gnat_rm/the_gnat_library gnat-altivec-vector-types-g-alvety-ads}@anchor{2d0}@anchor{gnat_rm/the_gnat_library id38}@anchor{2d1} @section @cite{GNAT.Altivec.Vector_Types} (@code{g-alvety.ads}) @@ -22685,7 +22724,7 @@ This package exposes the various vector types part of the Ada binding to AltiVec facilities. @node GNAT Altivec Vector_Views g-alvevi ads,GNAT Array_Split g-arrspl ads,GNAT Altivec Vector_Types g-alvety ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-altivec-vector-views-g-alvevi-ads}@anchor{2d0}@anchor{gnat_rm/the_gnat_library id39}@anchor{2d1} +@anchor{gnat_rm/the_gnat_library gnat-altivec-vector-views-g-alvevi-ads}@anchor{2d2}@anchor{gnat_rm/the_gnat_library id39}@anchor{2d3} @section @cite{GNAT.Altivec.Vector_Views} (@code{g-alvevi.ads}) @@ -22700,7 +22739,7 @@ vector elements and provides a simple way to initialize vector objects. @node GNAT Array_Split g-arrspl ads,GNAT AWK g-awk ads,GNAT Altivec Vector_Views g-alvevi ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-array-split-g-arrspl-ads}@anchor{2d2}@anchor{gnat_rm/the_gnat_library id40}@anchor{2d3} +@anchor{gnat_rm/the_gnat_library gnat-array-split-g-arrspl-ads}@anchor{2d4}@anchor{gnat_rm/the_gnat_library id40}@anchor{2d5} @section @cite{GNAT.Array_Split} (@code{g-arrspl.ads}) @@ -22713,7 +22752,7 @@ an array wherever the separators appear, and provide direct access to the resulting slices. @node GNAT AWK g-awk ads,GNAT Bind_Environment g-binenv ads,GNAT Array_Split g-arrspl ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id41}@anchor{2d4}@anchor{gnat_rm/the_gnat_library gnat-awk-g-awk-ads}@anchor{2d5} +@anchor{gnat_rm/the_gnat_library id41}@anchor{2d6}@anchor{gnat_rm/the_gnat_library gnat-awk-g-awk-ads}@anchor{2d7} @section @cite{GNAT.AWK} (@code{g-awk.ads}) @@ -22728,7 +22767,7 @@ or more files containing formatted data. The file is viewed as a database where each record is a line and a field is a data element in this line. @node GNAT Bind_Environment g-binenv ads,GNAT Bounded_Buffers g-boubuf ads,GNAT AWK g-awk ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-bind-environment-g-binenv-ads}@anchor{2d6}@anchor{gnat_rm/the_gnat_library id42}@anchor{2d7} +@anchor{gnat_rm/the_gnat_library gnat-bind-environment-g-binenv-ads}@anchor{2d8}@anchor{gnat_rm/the_gnat_library id42}@anchor{2d9} @section @cite{GNAT.Bind_Environment} (@code{g-binenv.ads}) @@ -22741,7 +22780,7 @@ These associations can be specified using the @cite{-V} binder command line switch. @node GNAT Bounded_Buffers g-boubuf ads,GNAT Bounded_Mailboxes g-boumai ads,GNAT Bind_Environment g-binenv ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-bounded-buffers-g-boubuf-ads}@anchor{2d8}@anchor{gnat_rm/the_gnat_library id43}@anchor{2d9} +@anchor{gnat_rm/the_gnat_library gnat-bounded-buffers-g-boubuf-ads}@anchor{2da}@anchor{gnat_rm/the_gnat_library id43}@anchor{2db} @section @cite{GNAT.Bounded_Buffers} (@code{g-boubuf.ads}) @@ -22756,7 +22795,7 @@ useful directly or as parts of the implementations of other abstractions, such as mailboxes. @node GNAT Bounded_Mailboxes g-boumai ads,GNAT Bubble_Sort g-bubsor ads,GNAT Bounded_Buffers g-boubuf ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id44}@anchor{2da}@anchor{gnat_rm/the_gnat_library gnat-bounded-mailboxes-g-boumai-ads}@anchor{2db} +@anchor{gnat_rm/the_gnat_library id44}@anchor{2dc}@anchor{gnat_rm/the_gnat_library gnat-bounded-mailboxes-g-boumai-ads}@anchor{2dd} @section @cite{GNAT.Bounded_Mailboxes} (@code{g-boumai.ads}) @@ -22769,7 +22808,7 @@ such as mailboxes. Provides a thread-safe asynchronous intertask mailbox communication facility. @node GNAT Bubble_Sort g-bubsor ads,GNAT Bubble_Sort_A g-busora ads,GNAT Bounded_Mailboxes g-boumai ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-bubble-sort-g-bubsor-ads}@anchor{2dc}@anchor{gnat_rm/the_gnat_library id45}@anchor{2dd} +@anchor{gnat_rm/the_gnat_library gnat-bubble-sort-g-bubsor-ads}@anchor{2de}@anchor{gnat_rm/the_gnat_library id45}@anchor{2df} @section @cite{GNAT.Bubble_Sort} (@code{g-bubsor.ads}) @@ -22784,7 +22823,7 @@ data items. Exchange and comparison procedures are provided by passing access-to-procedure values. @node GNAT Bubble_Sort_A g-busora ads,GNAT Bubble_Sort_G g-busorg ads,GNAT Bubble_Sort g-bubsor ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id46}@anchor{2de}@anchor{gnat_rm/the_gnat_library gnat-bubble-sort-a-g-busora-ads}@anchor{2df} +@anchor{gnat_rm/the_gnat_library id46}@anchor{2e0}@anchor{gnat_rm/the_gnat_library gnat-bubble-sort-a-g-busora-ads}@anchor{2e1} @section @cite{GNAT.Bubble_Sort_A} (@code{g-busora.ads}) @@ -22800,7 +22839,7 @@ access-to-procedure values. This is an older version, retained for compatibility. Usually @cite{GNAT.Bubble_Sort} will be preferable. @node GNAT Bubble_Sort_G g-busorg ads,GNAT Byte_Order_Mark g-byorma ads,GNAT Bubble_Sort_A g-busora ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id47}@anchor{2e0}@anchor{gnat_rm/the_gnat_library gnat-bubble-sort-g-g-busorg-ads}@anchor{2e1} +@anchor{gnat_rm/the_gnat_library id47}@anchor{2e2}@anchor{gnat_rm/the_gnat_library gnat-bubble-sort-g-g-busorg-ads}@anchor{2e3} @section @cite{GNAT.Bubble_Sort_G} (@code{g-busorg.ads}) @@ -22816,7 +22855,7 @@ if the procedures can be inlined, at the expense of duplicating code for multiple instantiations. @node GNAT Byte_Order_Mark g-byorma ads,GNAT Byte_Swapping g-bytswa ads,GNAT Bubble_Sort_G g-busorg ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-byte-order-mark-g-byorma-ads}@anchor{2e2}@anchor{gnat_rm/the_gnat_library id48}@anchor{2e3} +@anchor{gnat_rm/the_gnat_library gnat-byte-order-mark-g-byorma-ads}@anchor{2e4}@anchor{gnat_rm/the_gnat_library id48}@anchor{2e5} @section @cite{GNAT.Byte_Order_Mark} (@code{g-byorma.ads}) @@ -22832,7 +22871,7 @@ the encoding of the string. The routine includes detection of special XML sequences for various UCS input formats. @node GNAT Byte_Swapping g-bytswa ads,GNAT Calendar g-calend ads,GNAT Byte_Order_Mark g-byorma ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-byte-swapping-g-bytswa-ads}@anchor{2e4}@anchor{gnat_rm/the_gnat_library id49}@anchor{2e5} +@anchor{gnat_rm/the_gnat_library gnat-byte-swapping-g-bytswa-ads}@anchor{2e6}@anchor{gnat_rm/the_gnat_library id49}@anchor{2e7} @section @cite{GNAT.Byte_Swapping} (@code{g-bytswa.ads}) @@ -22846,7 +22885,7 @@ General routines for swapping the bytes in 2-, 4-, and 8-byte quantities. Machine-specific implementations are available in some cases. @node GNAT Calendar g-calend ads,GNAT Calendar Time_IO g-catiio ads,GNAT Byte_Swapping g-bytswa ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id50}@anchor{2e6}@anchor{gnat_rm/the_gnat_library gnat-calendar-g-calend-ads}@anchor{2e7} +@anchor{gnat_rm/the_gnat_library id50}@anchor{2e8}@anchor{gnat_rm/the_gnat_library gnat-calendar-g-calend-ads}@anchor{2e9} @section @cite{GNAT.Calendar} (@code{g-calend.ads}) @@ -22860,7 +22899,7 @@ Also provides conversion of @cite{Ada.Calendar.Time} values to and from the C @cite{timeval} format. @node GNAT Calendar Time_IO g-catiio ads,GNAT CRC32 g-crc32 ads,GNAT Calendar g-calend ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-calendar-time-io-g-catiio-ads}@anchor{2e8}@anchor{gnat_rm/the_gnat_library id51}@anchor{2e9} +@anchor{gnat_rm/the_gnat_library gnat-calendar-time-io-g-catiio-ads}@anchor{2ea}@anchor{gnat_rm/the_gnat_library id51}@anchor{2eb} @section @cite{GNAT.Calendar.Time_IO} (@code{g-catiio.ads}) @@ -22871,7 +22910,7 @@ C @cite{timeval} format. @geindex GNAT.Calendar.Time_IO (g-catiio.ads) @node GNAT CRC32 g-crc32 ads,GNAT Case_Util g-casuti ads,GNAT Calendar Time_IO g-catiio ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id52}@anchor{2ea}@anchor{gnat_rm/the_gnat_library gnat-crc32-g-crc32-ads}@anchor{2eb} +@anchor{gnat_rm/the_gnat_library id52}@anchor{2ec}@anchor{gnat_rm/the_gnat_library gnat-crc32-g-crc32-ads}@anchor{2ed} @section @cite{GNAT.CRC32} (@code{g-crc32.ads}) @@ -22888,7 +22927,7 @@ of this algorithm see Aug. 1988. Sarwate, D.V. @node GNAT Case_Util g-casuti ads,GNAT CGI g-cgi ads,GNAT CRC32 g-crc32 ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-case-util-g-casuti-ads}@anchor{2ec}@anchor{gnat_rm/the_gnat_library id53}@anchor{2ed} +@anchor{gnat_rm/the_gnat_library gnat-case-util-g-casuti-ads}@anchor{2ee}@anchor{gnat_rm/the_gnat_library id53}@anchor{2ef} @section @cite{GNAT.Case_Util} (@code{g-casuti.ads}) @@ -22903,7 +22942,7 @@ without the overhead of the full casing tables in @cite{Ada.Characters.Handling}. @node GNAT CGI g-cgi ads,GNAT CGI Cookie g-cgicoo ads,GNAT Case_Util g-casuti ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id54}@anchor{2ee}@anchor{gnat_rm/the_gnat_library gnat-cgi-g-cgi-ads}@anchor{2ef} +@anchor{gnat_rm/the_gnat_library id54}@anchor{2f0}@anchor{gnat_rm/the_gnat_library gnat-cgi-g-cgi-ads}@anchor{2f1} @section @cite{GNAT.CGI} (@code{g-cgi.ads}) @@ -22918,7 +22957,7 @@ builds a table whose index is the key and provides some services to deal with this table. @node GNAT CGI Cookie g-cgicoo ads,GNAT CGI Debug g-cgideb ads,GNAT CGI g-cgi ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-cgi-cookie-g-cgicoo-ads}@anchor{2f0}@anchor{gnat_rm/the_gnat_library id55}@anchor{2f1} +@anchor{gnat_rm/the_gnat_library gnat-cgi-cookie-g-cgicoo-ads}@anchor{2f2}@anchor{gnat_rm/the_gnat_library id55}@anchor{2f3} @section @cite{GNAT.CGI.Cookie} (@code{g-cgicoo.ads}) @@ -22933,7 +22972,7 @@ Common Gateway Interface (CGI). It exports services to deal with Web cookies (piece of information kept in the Web client software). @node GNAT CGI Debug g-cgideb ads,GNAT Command_Line g-comlin ads,GNAT CGI Cookie g-cgicoo ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-cgi-debug-g-cgideb-ads}@anchor{2f2}@anchor{gnat_rm/the_gnat_library id56}@anchor{2f3} +@anchor{gnat_rm/the_gnat_library gnat-cgi-debug-g-cgideb-ads}@anchor{2f4}@anchor{gnat_rm/the_gnat_library id56}@anchor{2f5} @section @cite{GNAT.CGI.Debug} (@code{g-cgideb.ads}) @@ -22945,7 +22984,7 @@ This is a package to help debugging CGI (Common Gateway Interface) programs written in Ada. @node GNAT Command_Line g-comlin ads,GNAT Compiler_Version g-comver ads,GNAT CGI Debug g-cgideb ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id57}@anchor{2f4}@anchor{gnat_rm/the_gnat_library gnat-command-line-g-comlin-ads}@anchor{2f5} +@anchor{gnat_rm/the_gnat_library id57}@anchor{2f6}@anchor{gnat_rm/the_gnat_library gnat-command-line-g-comlin-ads}@anchor{2f7} @section @cite{GNAT.Command_Line} (@code{g-comlin.ads}) @@ -22958,7 +22997,7 @@ including the ability to scan for named switches with optional parameters and expand file names using wild card notations. @node GNAT Compiler_Version g-comver ads,GNAT Ctrl_C g-ctrl_c ads,GNAT Command_Line g-comlin ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-compiler-version-g-comver-ads}@anchor{2f6}@anchor{gnat_rm/the_gnat_library id58}@anchor{2f7} +@anchor{gnat_rm/the_gnat_library gnat-compiler-version-g-comver-ads}@anchor{2f8}@anchor{gnat_rm/the_gnat_library id58}@anchor{2f9} @section @cite{GNAT.Compiler_Version} (@code{g-comver.ads}) @@ -22976,7 +23015,7 @@ of the compiler if a consistent tool set is used to compile all units of a partition). @node GNAT Ctrl_C g-ctrl_c ads,GNAT Current_Exception g-curexc ads,GNAT Compiler_Version g-comver ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-ctrl-c-g-ctrl-c-ads}@anchor{2f8}@anchor{gnat_rm/the_gnat_library id59}@anchor{2f9} +@anchor{gnat_rm/the_gnat_library gnat-ctrl-c-g-ctrl-c-ads}@anchor{2fa}@anchor{gnat_rm/the_gnat_library id59}@anchor{2fb} @section @cite{GNAT.Ctrl_C} (@code{g-ctrl_c.ads}) @@ -22987,7 +23026,7 @@ of a partition). Provides a simple interface to handle Ctrl-C keyboard events. @node GNAT Current_Exception g-curexc ads,GNAT Debug_Pools g-debpoo ads,GNAT Ctrl_C g-ctrl_c ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id60}@anchor{2fa}@anchor{gnat_rm/the_gnat_library gnat-current-exception-g-curexc-ads}@anchor{2fb} +@anchor{gnat_rm/the_gnat_library id60}@anchor{2fc}@anchor{gnat_rm/the_gnat_library gnat-current-exception-g-curexc-ads}@anchor{2fd} @section @cite{GNAT.Current_Exception} (@code{g-curexc.ads}) @@ -23004,7 +23043,7 @@ This is particularly useful in simulating typical facilities for obtaining information about exceptions provided by Ada 83 compilers. @node GNAT Debug_Pools g-debpoo ads,GNAT Debug_Utilities g-debuti ads,GNAT Current_Exception g-curexc ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-debug-pools-g-debpoo-ads}@anchor{2fc}@anchor{gnat_rm/the_gnat_library id61}@anchor{2fd} +@anchor{gnat_rm/the_gnat_library gnat-debug-pools-g-debpoo-ads}@anchor{2fe}@anchor{gnat_rm/the_gnat_library id61}@anchor{2ff} @section @cite{GNAT.Debug_Pools} (@code{g-debpoo.ads}) @@ -23021,7 +23060,7 @@ problems. See @cite{The GNAT Debug_Pool Facility} section in the @cite{GNAT User's Guide}. @node GNAT Debug_Utilities g-debuti ads,GNAT Decode_String g-decstr ads,GNAT Debug_Pools g-debpoo ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-debug-utilities-g-debuti-ads}@anchor{2fe}@anchor{gnat_rm/the_gnat_library id62}@anchor{2ff} +@anchor{gnat_rm/the_gnat_library gnat-debug-utilities-g-debuti-ads}@anchor{300}@anchor{gnat_rm/the_gnat_library id62}@anchor{301} @section @cite{GNAT.Debug_Utilities} (@code{g-debuti.ads}) @@ -23034,7 +23073,7 @@ to and from string images of address values. Supports both C and Ada formats for hexadecimal literals. @node GNAT Decode_String g-decstr ads,GNAT Decode_UTF8_String g-deutst ads,GNAT Debug_Utilities g-debuti ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-decode-string-g-decstr-ads}@anchor{300}@anchor{gnat_rm/the_gnat_library id63}@anchor{301} +@anchor{gnat_rm/the_gnat_library gnat-decode-string-g-decstr-ads}@anchor{302}@anchor{gnat_rm/the_gnat_library id63}@anchor{303} @section @cite{GNAT.Decode_String} (@code{g-decstr.ads}) @@ -23058,7 +23097,7 @@ Useful in conjunction with Unicode character coding. Note there is a preinstantiation for UTF-8. See next entry. @node GNAT Decode_UTF8_String g-deutst ads,GNAT Directory_Operations g-dirope ads,GNAT Decode_String g-decstr ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-decode-utf8-string-g-deutst-ads}@anchor{302}@anchor{gnat_rm/the_gnat_library id64}@anchor{303} +@anchor{gnat_rm/the_gnat_library gnat-decode-utf8-string-g-deutst-ads}@anchor{304}@anchor{gnat_rm/the_gnat_library id64}@anchor{305} @section @cite{GNAT.Decode_UTF8_String} (@code{g-deutst.ads}) @@ -23079,7 +23118,7 @@ preinstantiation for UTF-8. See next entry. A preinstantiation of GNAT.Decode_Strings for UTF-8 encoding. @node GNAT Directory_Operations g-dirope ads,GNAT Directory_Operations Iteration g-diopit ads,GNAT Decode_UTF8_String g-deutst ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id65}@anchor{304}@anchor{gnat_rm/the_gnat_library gnat-directory-operations-g-dirope-ads}@anchor{305} +@anchor{gnat_rm/the_gnat_library id65}@anchor{306}@anchor{gnat_rm/the_gnat_library gnat-directory-operations-g-dirope-ads}@anchor{307} @section @cite{GNAT.Directory_Operations} (@code{g-dirope.ads}) @@ -23092,7 +23131,7 @@ the current directory, making new directories, and scanning the files in a directory. @node GNAT Directory_Operations Iteration g-diopit ads,GNAT Dynamic_HTables g-dynhta ads,GNAT Directory_Operations g-dirope ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id66}@anchor{306}@anchor{gnat_rm/the_gnat_library gnat-directory-operations-iteration-g-diopit-ads}@anchor{307} +@anchor{gnat_rm/the_gnat_library id66}@anchor{308}@anchor{gnat_rm/the_gnat_library gnat-directory-operations-iteration-g-diopit-ads}@anchor{309} @section @cite{GNAT.Directory_Operations.Iteration} (@code{g-diopit.ads}) @@ -23104,7 +23143,7 @@ A child unit of GNAT.Directory_Operations providing additional operations for iterating through directories. @node GNAT Dynamic_HTables g-dynhta ads,GNAT Dynamic_Tables g-dyntab ads,GNAT Directory_Operations Iteration g-diopit ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id67}@anchor{308}@anchor{gnat_rm/the_gnat_library gnat-dynamic-htables-g-dynhta-ads}@anchor{309} +@anchor{gnat_rm/the_gnat_library id67}@anchor{30a}@anchor{gnat_rm/the_gnat_library gnat-dynamic-htables-g-dynhta-ads}@anchor{30b} @section @cite{GNAT.Dynamic_HTables} (@code{g-dynhta.ads}) @@ -23122,7 +23161,7 @@ dynamic instances of the hash table, while an instantiation of @cite{GNAT.HTable} creates a single instance of the hash table. @node GNAT Dynamic_Tables g-dyntab ads,GNAT Encode_String g-encstr ads,GNAT Dynamic_HTables g-dynhta ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-dynamic-tables-g-dyntab-ads}@anchor{30a}@anchor{gnat_rm/the_gnat_library id68}@anchor{30b} +@anchor{gnat_rm/the_gnat_library gnat-dynamic-tables-g-dyntab-ads}@anchor{30c}@anchor{gnat_rm/the_gnat_library id68}@anchor{30d} @section @cite{GNAT.Dynamic_Tables} (@code{g-dyntab.ads}) @@ -23142,7 +23181,7 @@ dynamic instances of the table, while an instantiation of @cite{GNAT.Table} creates a single instance of the table type. @node GNAT Encode_String g-encstr ads,GNAT Encode_UTF8_String g-enutst ads,GNAT Dynamic_Tables g-dyntab ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id69}@anchor{30c}@anchor{gnat_rm/the_gnat_library gnat-encode-string-g-encstr-ads}@anchor{30d} +@anchor{gnat_rm/the_gnat_library id69}@anchor{30e}@anchor{gnat_rm/the_gnat_library gnat-encode-string-g-encstr-ads}@anchor{30f} @section @cite{GNAT.Encode_String} (@code{g-encstr.ads}) @@ -23164,7 +23203,7 @@ encoding method. Useful in conjunction with Unicode character coding. Note there is a preinstantiation for UTF-8. See next entry. @node GNAT Encode_UTF8_String g-enutst ads,GNAT Exception_Actions g-excact ads,GNAT Encode_String g-encstr ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-encode-utf8-string-g-enutst-ads}@anchor{30e}@anchor{gnat_rm/the_gnat_library id70}@anchor{30f} +@anchor{gnat_rm/the_gnat_library gnat-encode-utf8-string-g-enutst-ads}@anchor{310}@anchor{gnat_rm/the_gnat_library id70}@anchor{311} @section @cite{GNAT.Encode_UTF8_String} (@code{g-enutst.ads}) @@ -23185,7 +23224,7 @@ Note there is a preinstantiation for UTF-8. See next entry. A preinstantiation of GNAT.Encode_Strings for UTF-8 encoding. @node GNAT Exception_Actions g-excact ads,GNAT Exception_Traces g-exctra ads,GNAT Encode_UTF8_String g-enutst ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id71}@anchor{310}@anchor{gnat_rm/the_gnat_library gnat-exception-actions-g-excact-ads}@anchor{311} +@anchor{gnat_rm/the_gnat_library id71}@anchor{312}@anchor{gnat_rm/the_gnat_library gnat-exception-actions-g-excact-ads}@anchor{313} @section @cite{GNAT.Exception_Actions} (@code{g-excact.ads}) @@ -23198,7 +23237,7 @@ for specific exceptions, or when any exception is raised. This can be used for instance to force a core dump to ease debugging. @node GNAT Exception_Traces g-exctra ads,GNAT Exceptions g-expect ads,GNAT Exception_Actions g-excact ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id72}@anchor{312}@anchor{gnat_rm/the_gnat_library gnat-exception-traces-g-exctra-ads}@anchor{313} +@anchor{gnat_rm/the_gnat_library id72}@anchor{314}@anchor{gnat_rm/the_gnat_library gnat-exception-traces-g-exctra-ads}@anchor{315} @section @cite{GNAT.Exception_Traces} (@code{g-exctra.ads}) @@ -23212,7 +23251,7 @@ Provides an interface allowing to control automatic output upon exception occurrences. @node GNAT Exceptions g-expect ads,GNAT Expect g-expect ads,GNAT Exception_Traces g-exctra ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id73}@anchor{314}@anchor{gnat_rm/the_gnat_library gnat-exceptions-g-expect-ads}@anchor{315} +@anchor{gnat_rm/the_gnat_library id73}@anchor{316}@anchor{gnat_rm/the_gnat_library gnat-exceptions-g-expect-ads}@anchor{317} @section @cite{GNAT.Exceptions} (@code{g-expect.ads}) @@ -23233,7 +23272,7 @@ predefined exceptions, and for example allow raising @cite{Constraint_Error} with a message from a pure subprogram. @node GNAT Expect g-expect ads,GNAT Expect TTY g-exptty ads,GNAT Exceptions g-expect ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-expect-g-expect-ads}@anchor{316}@anchor{gnat_rm/the_gnat_library id74}@anchor{317} +@anchor{gnat_rm/the_gnat_library gnat-expect-g-expect-ads}@anchor{318}@anchor{gnat_rm/the_gnat_library id74}@anchor{319} @section @cite{GNAT.Expect} (@code{g-expect.ads}) @@ -23249,7 +23288,7 @@ It is not implemented for cross ports, and in particular is not implemented for VxWorks or LynxOS. @node GNAT Expect TTY g-exptty ads,GNAT Float_Control g-flocon ads,GNAT Expect g-expect ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-expect-tty-g-exptty-ads}@anchor{318}@anchor{gnat_rm/the_gnat_library id75}@anchor{319} +@anchor{gnat_rm/the_gnat_library gnat-expect-tty-g-exptty-ads}@anchor{31a}@anchor{gnat_rm/the_gnat_library id75}@anchor{31b} @section @cite{GNAT.Expect.TTY} (@code{g-exptty.ads}) @@ -23261,7 +23300,7 @@ ports. It is not implemented for cross ports, and in particular is not implemented for VxWorks or LynxOS. @node GNAT Float_Control g-flocon ads,GNAT Formatted_String g-forstr ads,GNAT Expect TTY g-exptty ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id76}@anchor{31a}@anchor{gnat_rm/the_gnat_library gnat-float-control-g-flocon-ads}@anchor{31b} +@anchor{gnat_rm/the_gnat_library id76}@anchor{31c}@anchor{gnat_rm/the_gnat_library gnat-float-control-g-flocon-ads}@anchor{31d} @section @cite{GNAT.Float_Control} (@code{g-flocon.ads}) @@ -23275,7 +23314,7 @@ library calls may cause this mode to be modified, and the Reset procedure in this package can be used to reestablish the required mode. @node GNAT Formatted_String g-forstr ads,GNAT Heap_Sort g-heasor ads,GNAT Float_Control g-flocon ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-formatted-string-g-forstr-ads}@anchor{31c}@anchor{gnat_rm/the_gnat_library id77}@anchor{31d} +@anchor{gnat_rm/the_gnat_library gnat-formatted-string-g-forstr-ads}@anchor{31e}@anchor{gnat_rm/the_gnat_library id77}@anchor{31f} @section @cite{GNAT.Formatted_String} (@code{g-forstr.ads}) @@ -23290,7 +23329,7 @@ derived from Integer, Float or enumerations as values for the formatted string. @node GNAT Heap_Sort g-heasor ads,GNAT Heap_Sort_A g-hesora ads,GNAT Formatted_String g-forstr ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-heap-sort-g-heasor-ads}@anchor{31e}@anchor{gnat_rm/the_gnat_library id78}@anchor{31f} +@anchor{gnat_rm/the_gnat_library gnat-heap-sort-g-heasor-ads}@anchor{320}@anchor{gnat_rm/the_gnat_library id78}@anchor{321} @section @cite{GNAT.Heap_Sort} (@code{g-heasor.ads}) @@ -23304,7 +23343,7 @@ access-to-procedure values. The algorithm used is a modified heap sort that performs approximately N*log(N) comparisons in the worst case. @node GNAT Heap_Sort_A g-hesora ads,GNAT Heap_Sort_G g-hesorg ads,GNAT Heap_Sort g-heasor ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id79}@anchor{320}@anchor{gnat_rm/the_gnat_library gnat-heap-sort-a-g-hesora-ads}@anchor{321} +@anchor{gnat_rm/the_gnat_library id79}@anchor{322}@anchor{gnat_rm/the_gnat_library gnat-heap-sort-a-g-hesora-ads}@anchor{323} @section @cite{GNAT.Heap_Sort_A} (@code{g-hesora.ads}) @@ -23320,7 +23359,7 @@ This differs from @cite{GNAT.Heap_Sort} in having a less convenient interface, but may be slightly more efficient. @node GNAT Heap_Sort_G g-hesorg ads,GNAT HTable g-htable ads,GNAT Heap_Sort_A g-hesora ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id80}@anchor{322}@anchor{gnat_rm/the_gnat_library gnat-heap-sort-g-g-hesorg-ads}@anchor{323} +@anchor{gnat_rm/the_gnat_library id80}@anchor{324}@anchor{gnat_rm/the_gnat_library gnat-heap-sort-g-g-hesorg-ads}@anchor{325} @section @cite{GNAT.Heap_Sort_G} (@code{g-hesorg.ads}) @@ -23334,7 +23373,7 @@ if the procedures can be inlined, at the expense of duplicating code for multiple instantiations. @node GNAT HTable g-htable ads,GNAT IO g-io ads,GNAT Heap_Sort_G g-hesorg ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id81}@anchor{324}@anchor{gnat_rm/the_gnat_library gnat-htable-g-htable-ads}@anchor{325} +@anchor{gnat_rm/the_gnat_library id81}@anchor{326}@anchor{gnat_rm/the_gnat_library gnat-htable-g-htable-ads}@anchor{327} @section @cite{GNAT.HTable} (@code{g-htable.ads}) @@ -23347,7 +23386,7 @@ data. Provides two approaches, one a simple static approach, and the other allowing arbitrary dynamic hash tables. @node GNAT IO g-io ads,GNAT IO_Aux g-io_aux ads,GNAT HTable g-htable ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id82}@anchor{326}@anchor{gnat_rm/the_gnat_library gnat-io-g-io-ads}@anchor{327} +@anchor{gnat_rm/the_gnat_library id82}@anchor{328}@anchor{gnat_rm/the_gnat_library gnat-io-g-io-ads}@anchor{329} @section @cite{GNAT.IO} (@code{g-io.ads}) @@ -23363,7 +23402,7 @@ Standard_Input, and writing characters, strings and integers to either Standard_Output or Standard_Error. @node GNAT IO_Aux g-io_aux ads,GNAT Lock_Files g-locfil ads,GNAT IO g-io ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id83}@anchor{328}@anchor{gnat_rm/the_gnat_library gnat-io-aux-g-io-aux-ads}@anchor{329} +@anchor{gnat_rm/the_gnat_library id83}@anchor{32a}@anchor{gnat_rm/the_gnat_library gnat-io-aux-g-io-aux-ads}@anchor{32b} @section @cite{GNAT.IO_Aux} (@code{g-io_aux.ads}) @@ -23377,7 +23416,7 @@ Provides some auxiliary functions for use with Text_IO, including a test for whether a file exists, and functions for reading a line of text. @node GNAT Lock_Files g-locfil ads,GNAT MBBS_Discrete_Random g-mbdira ads,GNAT IO_Aux g-io_aux ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-lock-files-g-locfil-ads}@anchor{32a}@anchor{gnat_rm/the_gnat_library id84}@anchor{32b} +@anchor{gnat_rm/the_gnat_library gnat-lock-files-g-locfil-ads}@anchor{32c}@anchor{gnat_rm/the_gnat_library id84}@anchor{32d} @section @cite{GNAT.Lock_Files} (@code{g-locfil.ads}) @@ -23391,7 +23430,7 @@ Provides a general interface for using files as locks. Can be used for providing program level synchronization. @node GNAT MBBS_Discrete_Random g-mbdira ads,GNAT MBBS_Float_Random g-mbflra ads,GNAT Lock_Files g-locfil ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id85}@anchor{32c}@anchor{gnat_rm/the_gnat_library gnat-mbbs-discrete-random-g-mbdira-ads}@anchor{32d} +@anchor{gnat_rm/the_gnat_library id85}@anchor{32e}@anchor{gnat_rm/the_gnat_library gnat-mbbs-discrete-random-g-mbdira-ads}@anchor{32f} @section @cite{GNAT.MBBS_Discrete_Random} (@code{g-mbdira.ads}) @@ -23403,7 +23442,7 @@ The original implementation of @cite{Ada.Numerics.Discrete_Random}. Uses a modified version of the Blum-Blum-Shub generator. @node GNAT MBBS_Float_Random g-mbflra ads,GNAT MD5 g-md5 ads,GNAT MBBS_Discrete_Random g-mbdira ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id86}@anchor{32e}@anchor{gnat_rm/the_gnat_library gnat-mbbs-float-random-g-mbflra-ads}@anchor{32f} +@anchor{gnat_rm/the_gnat_library id86}@anchor{330}@anchor{gnat_rm/the_gnat_library gnat-mbbs-float-random-g-mbflra-ads}@anchor{331} @section @cite{GNAT.MBBS_Float_Random} (@code{g-mbflra.ads}) @@ -23415,7 +23454,7 @@ The original implementation of @cite{Ada.Numerics.Float_Random}. Uses a modified version of the Blum-Blum-Shub generator. @node GNAT MD5 g-md5 ads,GNAT Memory_Dump g-memdum ads,GNAT MBBS_Float_Random g-mbflra ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id87}@anchor{330}@anchor{gnat_rm/the_gnat_library gnat-md5-g-md5-ads}@anchor{331} +@anchor{gnat_rm/the_gnat_library id87}@anchor{332}@anchor{gnat_rm/the_gnat_library gnat-md5-g-md5-ads}@anchor{333} @section @cite{GNAT.MD5} (@code{g-md5.ads}) @@ -23428,7 +23467,7 @@ the HMAC-MD5 message authentication function as described in RFC 2104 and FIPS PUB 198. @node GNAT Memory_Dump g-memdum ads,GNAT Most_Recent_Exception g-moreex ads,GNAT MD5 g-md5 ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id88}@anchor{332}@anchor{gnat_rm/the_gnat_library gnat-memory-dump-g-memdum-ads}@anchor{333} +@anchor{gnat_rm/the_gnat_library id88}@anchor{334}@anchor{gnat_rm/the_gnat_library gnat-memory-dump-g-memdum-ads}@anchor{335} @section @cite{GNAT.Memory_Dump} (@code{g-memdum.ads}) @@ -23441,7 +23480,7 @@ standard output or standard error files. Uses GNAT.IO for actual output. @node GNAT Most_Recent_Exception g-moreex ads,GNAT OS_Lib g-os_lib ads,GNAT Memory_Dump g-memdum ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id89}@anchor{334}@anchor{gnat_rm/the_gnat_library gnat-most-recent-exception-g-moreex-ads}@anchor{335} +@anchor{gnat_rm/the_gnat_library id89}@anchor{336}@anchor{gnat_rm/the_gnat_library gnat-most-recent-exception-g-moreex-ads}@anchor{337} @section @cite{GNAT.Most_Recent_Exception} (@code{g-moreex.ads}) @@ -23455,7 +23494,7 @@ various logging purposes, including duplicating functionality of some Ada 83 implementation dependent extensions. @node GNAT OS_Lib g-os_lib ads,GNAT Perfect_Hash_Generators g-pehage ads,GNAT Most_Recent_Exception g-moreex ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id90}@anchor{336}@anchor{gnat_rm/the_gnat_library gnat-os-lib-g-os-lib-ads}@anchor{337} +@anchor{gnat_rm/the_gnat_library id90}@anchor{338}@anchor{gnat_rm/the_gnat_library gnat-os-lib-g-os-lib-ads}@anchor{339} @section @cite{GNAT.OS_Lib} (@code{g-os_lib.ads}) @@ -23471,7 +23510,7 @@ including a portable spawn procedure, and access to environment variables and error return codes. @node GNAT Perfect_Hash_Generators g-pehage ads,GNAT Random_Numbers g-rannum ads,GNAT OS_Lib g-os_lib ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-perfect-hash-generators-g-pehage-ads}@anchor{338}@anchor{gnat_rm/the_gnat_library id91}@anchor{339} +@anchor{gnat_rm/the_gnat_library gnat-perfect-hash-generators-g-pehage-ads}@anchor{33a}@anchor{gnat_rm/the_gnat_library id91}@anchor{33b} @section @cite{GNAT.Perfect_Hash_Generators} (@code{g-pehage.ads}) @@ -23489,7 +23528,7 @@ hashcode are in the same order. These hashing functions are very convenient for use with realtime applications. @node GNAT Random_Numbers g-rannum ads,GNAT Regexp g-regexp ads,GNAT Perfect_Hash_Generators g-pehage ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-random-numbers-g-rannum-ads}@anchor{33a}@anchor{gnat_rm/the_gnat_library id92}@anchor{33b} +@anchor{gnat_rm/the_gnat_library gnat-random-numbers-g-rannum-ads}@anchor{33c}@anchor{gnat_rm/the_gnat_library id92}@anchor{33d} @section @cite{GNAT.Random_Numbers} (@code{g-rannum.ads}) @@ -23501,7 +23540,7 @@ Provides random number capabilities which extend those available in the standard Ada library and are more convenient to use. @node GNAT Regexp g-regexp ads,GNAT Registry g-regist ads,GNAT Random_Numbers g-rannum ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-regexp-g-regexp-ads}@anchor{20d}@anchor{gnat_rm/the_gnat_library id93}@anchor{33c} +@anchor{gnat_rm/the_gnat_library gnat-regexp-g-regexp-ads}@anchor{20f}@anchor{gnat_rm/the_gnat_library id93}@anchor{33e} @section @cite{GNAT.Regexp} (@code{g-regexp.ads}) @@ -23517,7 +23556,7 @@ simplest of the three pattern matching packages provided, and is particularly suitable for 'file globbing' applications. @node GNAT Registry g-regist ads,GNAT Regpat g-regpat ads,GNAT Regexp g-regexp ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id94}@anchor{33d}@anchor{gnat_rm/the_gnat_library gnat-registry-g-regist-ads}@anchor{33e} +@anchor{gnat_rm/the_gnat_library id94}@anchor{33f}@anchor{gnat_rm/the_gnat_library gnat-registry-g-regist-ads}@anchor{340} @section @cite{GNAT.Registry} (@code{g-regist.ads}) @@ -23531,7 +23570,7 @@ registry API, but at a lower level of abstraction, refer to the Win32.Winreg package provided with the Win32Ada binding @node GNAT Regpat g-regpat ads,GNAT Rewrite_Data g-rewdat ads,GNAT Registry g-regist ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-regpat-g-regpat-ads}@anchor{33f}@anchor{gnat_rm/the_gnat_library id95}@anchor{340} +@anchor{gnat_rm/the_gnat_library gnat-regpat-g-regpat-ads}@anchor{341}@anchor{gnat_rm/the_gnat_library id95}@anchor{342} @section @cite{GNAT.Regpat} (@code{g-regpat.ads}) @@ -23546,7 +23585,7 @@ from the original V7 style regular expression library written in C by Henry Spencer (and binary compatible with this C library). @node GNAT Rewrite_Data g-rewdat ads,GNAT Secondary_Stack_Info g-sestin ads,GNAT Regpat g-regpat ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id96}@anchor{341}@anchor{gnat_rm/the_gnat_library gnat-rewrite-data-g-rewdat-ads}@anchor{342} +@anchor{gnat_rm/the_gnat_library id96}@anchor{343}@anchor{gnat_rm/the_gnat_library gnat-rewrite-data-g-rewdat-ads}@anchor{344} @section @cite{GNAT.Rewrite_Data} (@code{g-rewdat.ads}) @@ -23560,7 +23599,7 @@ full content to be processed is not loaded into memory all at once. This makes this interface usable for large files or socket streams. @node GNAT Secondary_Stack_Info g-sestin ads,GNAT Semaphores g-semaph ads,GNAT Rewrite_Data g-rewdat ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-secondary-stack-info-g-sestin-ads}@anchor{343}@anchor{gnat_rm/the_gnat_library id97}@anchor{344} +@anchor{gnat_rm/the_gnat_library gnat-secondary-stack-info-g-sestin-ads}@anchor{345}@anchor{gnat_rm/the_gnat_library id97}@anchor{346} @section @cite{GNAT.Secondary_Stack_Info} (@code{g-sestin.ads}) @@ -23572,7 +23611,7 @@ Provide the capability to query the high water mark of the current task's secondary stack. @node GNAT Semaphores g-semaph ads,GNAT Serial_Communications g-sercom ads,GNAT Secondary_Stack_Info g-sestin ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id98}@anchor{345}@anchor{gnat_rm/the_gnat_library gnat-semaphores-g-semaph-ads}@anchor{346} +@anchor{gnat_rm/the_gnat_library id98}@anchor{347}@anchor{gnat_rm/the_gnat_library gnat-semaphores-g-semaph-ads}@anchor{348} @section @cite{GNAT.Semaphores} (@code{g-semaph.ads}) @@ -23583,7 +23622,7 @@ secondary stack. Provides classic counting and binary semaphores using protected types. @node GNAT Serial_Communications g-sercom ads,GNAT SHA1 g-sha1 ads,GNAT Semaphores g-semaph ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-serial-communications-g-sercom-ads}@anchor{347}@anchor{gnat_rm/the_gnat_library id99}@anchor{348} +@anchor{gnat_rm/the_gnat_library gnat-serial-communications-g-sercom-ads}@anchor{349}@anchor{gnat_rm/the_gnat_library id99}@anchor{34a} @section @cite{GNAT.Serial_Communications} (@code{g-sercom.ads}) @@ -23595,7 +23634,7 @@ Provides a simple interface to send and receive data over a serial port. This is only supported on GNU/Linux and Windows. @node GNAT SHA1 g-sha1 ads,GNAT SHA224 g-sha224 ads,GNAT Serial_Communications g-sercom ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-sha1-g-sha1-ads}@anchor{349}@anchor{gnat_rm/the_gnat_library id100}@anchor{34a} +@anchor{gnat_rm/the_gnat_library gnat-sha1-g-sha1-ads}@anchor{34b}@anchor{gnat_rm/the_gnat_library id100}@anchor{34c} @section @cite{GNAT.SHA1} (@code{g-sha1.ads}) @@ -23608,7 +23647,7 @@ and RFC 3174, and the HMAC-SHA1 message authentication function as described in RFC 2104 and FIPS PUB 198. @node GNAT SHA224 g-sha224 ads,GNAT SHA256 g-sha256 ads,GNAT SHA1 g-sha1 ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id101}@anchor{34b}@anchor{gnat_rm/the_gnat_library gnat-sha224-g-sha224-ads}@anchor{34c} +@anchor{gnat_rm/the_gnat_library id101}@anchor{34d}@anchor{gnat_rm/the_gnat_library gnat-sha224-g-sha224-ads}@anchor{34e} @section @cite{GNAT.SHA224} (@code{g-sha224.ads}) @@ -23621,7 +23660,7 @@ and the HMAC-SHA224 message authentication function as described in RFC 2104 and FIPS PUB 198. @node GNAT SHA256 g-sha256 ads,GNAT SHA384 g-sha384 ads,GNAT SHA224 g-sha224 ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id102}@anchor{34d}@anchor{gnat_rm/the_gnat_library gnat-sha256-g-sha256-ads}@anchor{34e} +@anchor{gnat_rm/the_gnat_library id102}@anchor{34f}@anchor{gnat_rm/the_gnat_library gnat-sha256-g-sha256-ads}@anchor{350} @section @cite{GNAT.SHA256} (@code{g-sha256.ads}) @@ -23634,7 +23673,7 @@ and the HMAC-SHA256 message authentication function as described in RFC 2104 and FIPS PUB 198. @node GNAT SHA384 g-sha384 ads,GNAT SHA512 g-sha512 ads,GNAT SHA256 g-sha256 ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id103}@anchor{34f}@anchor{gnat_rm/the_gnat_library gnat-sha384-g-sha384-ads}@anchor{350} +@anchor{gnat_rm/the_gnat_library id103}@anchor{351}@anchor{gnat_rm/the_gnat_library gnat-sha384-g-sha384-ads}@anchor{352} @section @cite{GNAT.SHA384} (@code{g-sha384.ads}) @@ -23647,7 +23686,7 @@ and the HMAC-SHA384 message authentication function as described in RFC 2104 and FIPS PUB 198. @node GNAT SHA512 g-sha512 ads,GNAT Signals g-signal ads,GNAT SHA384 g-sha384 ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-sha512-g-sha512-ads}@anchor{351}@anchor{gnat_rm/the_gnat_library id104}@anchor{352} +@anchor{gnat_rm/the_gnat_library gnat-sha512-g-sha512-ads}@anchor{353}@anchor{gnat_rm/the_gnat_library id104}@anchor{354} @section @cite{GNAT.SHA512} (@code{g-sha512.ads}) @@ -23660,7 +23699,7 @@ and the HMAC-SHA512 message authentication function as described in RFC 2104 and FIPS PUB 198. @node GNAT Signals g-signal ads,GNAT Sockets g-socket ads,GNAT SHA512 g-sha512 ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-signals-g-signal-ads}@anchor{353}@anchor{gnat_rm/the_gnat_library id105}@anchor{354} +@anchor{gnat_rm/the_gnat_library gnat-signals-g-signal-ads}@anchor{355}@anchor{gnat_rm/the_gnat_library id105}@anchor{356} @section @cite{GNAT.Signals} (@code{g-signal.ads}) @@ -23672,7 +23711,7 @@ Provides the ability to manipulate the blocked status of signals on supported targets. @node GNAT Sockets g-socket ads,GNAT Source_Info g-souinf ads,GNAT Signals g-signal ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-sockets-g-socket-ads}@anchor{355}@anchor{gnat_rm/the_gnat_library id106}@anchor{356} +@anchor{gnat_rm/the_gnat_library gnat-sockets-g-socket-ads}@anchor{357}@anchor{gnat_rm/the_gnat_library id106}@anchor{358} @section @cite{GNAT.Sockets} (@code{g-socket.ads}) @@ -23687,7 +23726,7 @@ on all native GNAT ports and on VxWorks cross prots. It is not implemented for the LynxOS cross port. @node GNAT Source_Info g-souinf ads,GNAT Spelling_Checker g-speche ads,GNAT Sockets g-socket ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-source-info-g-souinf-ads}@anchor{357}@anchor{gnat_rm/the_gnat_library id107}@anchor{358} +@anchor{gnat_rm/the_gnat_library gnat-source-info-g-souinf-ads}@anchor{359}@anchor{gnat_rm/the_gnat_library id107}@anchor{35a} @section @cite{GNAT.Source_Info} (@code{g-souinf.ads}) @@ -23701,7 +23740,7 @@ subprograms yielding the date and time of the current compilation (like the C macros @cite{__DATE__} and @cite{__TIME__}) @node GNAT Spelling_Checker g-speche ads,GNAT Spelling_Checker_Generic g-spchge ads,GNAT Source_Info g-souinf ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-spelling-checker-g-speche-ads}@anchor{359}@anchor{gnat_rm/the_gnat_library id108}@anchor{35a} +@anchor{gnat_rm/the_gnat_library gnat-spelling-checker-g-speche-ads}@anchor{35b}@anchor{gnat_rm/the_gnat_library id108}@anchor{35c} @section @cite{GNAT.Spelling_Checker} (@code{g-speche.ads}) @@ -23713,7 +23752,7 @@ Provides a function for determining whether one string is a plausible near misspelling of another string. @node GNAT Spelling_Checker_Generic g-spchge ads,GNAT Spitbol Patterns g-spipat ads,GNAT Spelling_Checker g-speche ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id109}@anchor{35b}@anchor{gnat_rm/the_gnat_library gnat-spelling-checker-generic-g-spchge-ads}@anchor{35c} +@anchor{gnat_rm/the_gnat_library id109}@anchor{35d}@anchor{gnat_rm/the_gnat_library gnat-spelling-checker-generic-g-spchge-ads}@anchor{35e} @section @cite{GNAT.Spelling_Checker_Generic} (@code{g-spchge.ads}) @@ -23726,7 +23765,7 @@ determining whether one string is a plausible near misspelling of another string. @node GNAT Spitbol Patterns g-spipat ads,GNAT Spitbol g-spitbo ads,GNAT Spelling_Checker_Generic g-spchge ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id110}@anchor{35d}@anchor{gnat_rm/the_gnat_library gnat-spitbol-patterns-g-spipat-ads}@anchor{35e} +@anchor{gnat_rm/the_gnat_library id110}@anchor{35f}@anchor{gnat_rm/the_gnat_library gnat-spitbol-patterns-g-spipat-ads}@anchor{360} @section @cite{GNAT.Spitbol.Patterns} (@code{g-spipat.ads}) @@ -23742,7 +23781,7 @@ the SNOBOL4 dynamic pattern construction and matching capabilities, using the efficient algorithm developed by Robert Dewar for the SPITBOL system. @node GNAT Spitbol g-spitbo ads,GNAT Spitbol Table_Boolean g-sptabo ads,GNAT Spitbol Patterns g-spipat ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id111}@anchor{35f}@anchor{gnat_rm/the_gnat_library gnat-spitbol-g-spitbo-ads}@anchor{360} +@anchor{gnat_rm/the_gnat_library id111}@anchor{361}@anchor{gnat_rm/the_gnat_library gnat-spitbol-g-spitbo-ads}@anchor{362} @section @cite{GNAT.Spitbol} (@code{g-spitbo.ads}) @@ -23757,7 +23796,7 @@ useful for constructing arbitrary mappings from strings in the style of the SNOBOL4 TABLE function. @node GNAT Spitbol Table_Boolean g-sptabo ads,GNAT Spitbol Table_Integer g-sptain ads,GNAT Spitbol g-spitbo ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id112}@anchor{361}@anchor{gnat_rm/the_gnat_library gnat-spitbol-table-boolean-g-sptabo-ads}@anchor{362} +@anchor{gnat_rm/the_gnat_library id112}@anchor{363}@anchor{gnat_rm/the_gnat_library gnat-spitbol-table-boolean-g-sptabo-ads}@anchor{364} @section @cite{GNAT.Spitbol.Table_Boolean} (@code{g-sptabo.ads}) @@ -23772,7 +23811,7 @@ for type @cite{Standard.Boolean}, giving an implementation of sets of string values. @node GNAT Spitbol Table_Integer g-sptain ads,GNAT Spitbol Table_VString g-sptavs ads,GNAT Spitbol Table_Boolean g-sptabo ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id113}@anchor{363}@anchor{gnat_rm/the_gnat_library gnat-spitbol-table-integer-g-sptain-ads}@anchor{364} +@anchor{gnat_rm/the_gnat_library id113}@anchor{365}@anchor{gnat_rm/the_gnat_library gnat-spitbol-table-integer-g-sptain-ads}@anchor{366} @section @cite{GNAT.Spitbol.Table_Integer} (@code{g-sptain.ads}) @@ -23789,7 +23828,7 @@ for type @cite{Standard.Integer}, giving an implementation of maps from string to integer values. @node GNAT Spitbol Table_VString g-sptavs ads,GNAT SSE g-sse ads,GNAT Spitbol Table_Integer g-sptain ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id114}@anchor{365}@anchor{gnat_rm/the_gnat_library gnat-spitbol-table-vstring-g-sptavs-ads}@anchor{366} +@anchor{gnat_rm/the_gnat_library id114}@anchor{367}@anchor{gnat_rm/the_gnat_library gnat-spitbol-table-vstring-g-sptavs-ads}@anchor{368} @section @cite{GNAT.Spitbol.Table_VString} (@code{g-sptavs.ads}) @@ -23806,7 +23845,7 @@ a variable length string type, giving an implementation of general maps from strings to strings. @node GNAT SSE g-sse ads,GNAT SSE Vector_Types g-ssvety ads,GNAT Spitbol Table_VString g-sptavs ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id115}@anchor{367}@anchor{gnat_rm/the_gnat_library gnat-sse-g-sse-ads}@anchor{368} +@anchor{gnat_rm/the_gnat_library id115}@anchor{369}@anchor{gnat_rm/the_gnat_library gnat-sse-g-sse-ads}@anchor{36a} @section @cite{GNAT.SSE} (@code{g-sse.ads}) @@ -23818,7 +23857,7 @@ targets. It exposes vector component types together with a general introduction to the binding contents and use. @node GNAT SSE Vector_Types g-ssvety ads,GNAT Strings g-string ads,GNAT SSE g-sse ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-sse-vector-types-g-ssvety-ads}@anchor{369}@anchor{gnat_rm/the_gnat_library id116}@anchor{36a} +@anchor{gnat_rm/the_gnat_library gnat-sse-vector-types-g-ssvety-ads}@anchor{36b}@anchor{gnat_rm/the_gnat_library id116}@anchor{36c} @section @cite{GNAT.SSE.Vector_Types} (@code{g-ssvety.ads}) @@ -23827,7 +23866,7 @@ introduction to the binding contents and use. SSE vector types for use with SSE related intrinsics. @node GNAT Strings g-string ads,GNAT String_Split g-strspl ads,GNAT SSE Vector_Types g-ssvety ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-strings-g-string-ads}@anchor{36b}@anchor{gnat_rm/the_gnat_library id117}@anchor{36c} +@anchor{gnat_rm/the_gnat_library gnat-strings-g-string-ads}@anchor{36d}@anchor{gnat_rm/the_gnat_library id117}@anchor{36e} @section @cite{GNAT.Strings} (@code{g-string.ads}) @@ -23837,7 +23876,7 @@ Common String access types and related subprograms. Basically it defines a string access and an array of string access types. @node GNAT String_Split g-strspl ads,GNAT Table g-table ads,GNAT Strings g-string ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-string-split-g-strspl-ads}@anchor{36d}@anchor{gnat_rm/the_gnat_library id118}@anchor{36e} +@anchor{gnat_rm/the_gnat_library gnat-string-split-g-strspl-ads}@anchor{36f}@anchor{gnat_rm/the_gnat_library id118}@anchor{370} @section @cite{GNAT.String_Split} (@code{g-strspl.ads}) @@ -23851,7 +23890,7 @@ to the resulting slices. This package is instantiated from @cite{GNAT.Array_Split}. @node GNAT Table g-table ads,GNAT Task_Lock g-tasloc ads,GNAT String_Split g-strspl ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-table-g-table-ads}@anchor{36f}@anchor{gnat_rm/the_gnat_library id119}@anchor{370} +@anchor{gnat_rm/the_gnat_library gnat-table-g-table-ads}@anchor{371}@anchor{gnat_rm/the_gnat_library id119}@anchor{372} @section @cite{GNAT.Table} (@code{g-table.ads}) @@ -23871,7 +23910,7 @@ while an instantiation of @cite{GNAT.Dynamic_Tables} creates a type that can be used to define dynamic instances of the table. @node GNAT Task_Lock g-tasloc ads,GNAT Time_Stamp g-timsta ads,GNAT Table g-table ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-task-lock-g-tasloc-ads}@anchor{371}@anchor{gnat_rm/the_gnat_library id120}@anchor{372} +@anchor{gnat_rm/the_gnat_library gnat-task-lock-g-tasloc-ads}@anchor{373}@anchor{gnat_rm/the_gnat_library id120}@anchor{374} @section @cite{GNAT.Task_Lock} (@code{g-tasloc.ads}) @@ -23888,7 +23927,7 @@ single global task lock. Appropriate for use in situations where contention between tasks is very rarely expected. @node GNAT Time_Stamp g-timsta ads,GNAT Threads g-thread ads,GNAT Task_Lock g-tasloc ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-time-stamp-g-timsta-ads}@anchor{373}@anchor{gnat_rm/the_gnat_library id121}@anchor{374} +@anchor{gnat_rm/the_gnat_library gnat-time-stamp-g-timsta-ads}@anchor{375}@anchor{gnat_rm/the_gnat_library id121}@anchor{376} @section @cite{GNAT.Time_Stamp} (@code{g-timsta.ads}) @@ -23903,7 +23942,7 @@ represents the current date and time in ISO 8601 format. This is a very simple routine with minimal code and there are no dependencies on any other unit. @node GNAT Threads g-thread ads,GNAT Traceback g-traceb ads,GNAT Time_Stamp g-timsta ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-threads-g-thread-ads}@anchor{375}@anchor{gnat_rm/the_gnat_library id122}@anchor{376} +@anchor{gnat_rm/the_gnat_library gnat-threads-g-thread-ads}@anchor{377}@anchor{gnat_rm/the_gnat_library id122}@anchor{378} @section @cite{GNAT.Threads} (@code{g-thread.ads}) @@ -23920,7 +23959,7 @@ further details if your program has threads that are created by a non-Ada environment which then accesses Ada code. @node GNAT Traceback g-traceb ads,GNAT Traceback Symbolic g-trasym ads,GNAT Threads g-thread ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id123}@anchor{377}@anchor{gnat_rm/the_gnat_library gnat-traceback-g-traceb-ads}@anchor{378} +@anchor{gnat_rm/the_gnat_library id123}@anchor{379}@anchor{gnat_rm/the_gnat_library gnat-traceback-g-traceb-ads}@anchor{37a} @section @cite{GNAT.Traceback} (@code{g-traceb.ads}) @@ -23932,7 +23971,7 @@ Provides a facility for obtaining non-symbolic traceback information, useful in various debugging situations. @node GNAT Traceback Symbolic g-trasym ads,GNAT UTF_32 g-table ads,GNAT Traceback g-traceb ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-traceback-symbolic-g-trasym-ads}@anchor{379}@anchor{gnat_rm/the_gnat_library id124}@anchor{37a} +@anchor{gnat_rm/the_gnat_library gnat-traceback-symbolic-g-trasym-ads}@anchor{37b}@anchor{gnat_rm/the_gnat_library id124}@anchor{37c} @section @cite{GNAT.Traceback.Symbolic} (@code{g-trasym.ads}) @@ -23941,7 +23980,7 @@ in various debugging situations. @geindex Trace back facilities @node GNAT UTF_32 g-table ads,GNAT Wide_Spelling_Checker g-u3spch ads,GNAT Traceback Symbolic g-trasym ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id125}@anchor{37b}@anchor{gnat_rm/the_gnat_library gnat-utf-32-g-table-ads}@anchor{37c} +@anchor{gnat_rm/the_gnat_library id125}@anchor{37d}@anchor{gnat_rm/the_gnat_library gnat-utf-32-g-table-ads}@anchor{37e} @section @cite{GNAT.UTF_32} (@code{g-table.ads}) @@ -23960,7 +23999,7 @@ lower case to upper case fold routine corresponding to the Ada 2005 rules for identifier equivalence. @node GNAT Wide_Spelling_Checker g-u3spch ads,GNAT Wide_Spelling_Checker g-wispch ads,GNAT UTF_32 g-table ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-wide-spelling-checker-g-u3spch-ads}@anchor{37d}@anchor{gnat_rm/the_gnat_library id126}@anchor{37e} +@anchor{gnat_rm/the_gnat_library gnat-wide-spelling-checker-g-u3spch-ads}@anchor{37f}@anchor{gnat_rm/the_gnat_library id126}@anchor{380} @section @cite{GNAT.Wide_Spelling_Checker} (@code{g-u3spch.ads}) @@ -23973,7 +24012,7 @@ near misspelling of another wide wide string, where the strings are represented using the UTF_32_String type defined in System.Wch_Cnv. @node GNAT Wide_Spelling_Checker g-wispch ads,GNAT Wide_String_Split g-wistsp ads,GNAT Wide_Spelling_Checker g-u3spch ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-wide-spelling-checker-g-wispch-ads}@anchor{37f}@anchor{gnat_rm/the_gnat_library id127}@anchor{380} +@anchor{gnat_rm/the_gnat_library gnat-wide-spelling-checker-g-wispch-ads}@anchor{381}@anchor{gnat_rm/the_gnat_library id127}@anchor{382} @section @cite{GNAT.Wide_Spelling_Checker} (@code{g-wispch.ads}) @@ -23985,7 +24024,7 @@ Provides a function for determining whether one wide string is a plausible near misspelling of another wide string. @node GNAT Wide_String_Split g-wistsp ads,GNAT Wide_Wide_Spelling_Checker g-zspche ads,GNAT Wide_Spelling_Checker g-wispch ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-wide-string-split-g-wistsp-ads}@anchor{381}@anchor{gnat_rm/the_gnat_library id128}@anchor{382} +@anchor{gnat_rm/the_gnat_library gnat-wide-string-split-g-wistsp-ads}@anchor{383}@anchor{gnat_rm/the_gnat_library id128}@anchor{384} @section @cite{GNAT.Wide_String_Split} (@code{g-wistsp.ads}) @@ -23999,7 +24038,7 @@ to the resulting slices. This package is instantiated from @cite{GNAT.Array_Split}. @node GNAT Wide_Wide_Spelling_Checker g-zspche ads,GNAT Wide_Wide_String_Split g-zistsp ads,GNAT Wide_String_Split g-wistsp ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-wide-wide-spelling-checker-g-zspche-ads}@anchor{383}@anchor{gnat_rm/the_gnat_library id129}@anchor{384} +@anchor{gnat_rm/the_gnat_library gnat-wide-wide-spelling-checker-g-zspche-ads}@anchor{385}@anchor{gnat_rm/the_gnat_library id129}@anchor{386} @section @cite{GNAT.Wide_Wide_Spelling_Checker} (@code{g-zspche.ads}) @@ -24011,7 +24050,7 @@ Provides a function for determining whether one wide wide string is a plausible near misspelling of another wide wide string. @node GNAT Wide_Wide_String_Split g-zistsp ads,Interfaces C Extensions i-cexten ads,GNAT Wide_Wide_Spelling_Checker g-zspche ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-wide-wide-string-split-g-zistsp-ads}@anchor{385}@anchor{gnat_rm/the_gnat_library id130}@anchor{386} +@anchor{gnat_rm/the_gnat_library gnat-wide-wide-string-split-g-zistsp-ads}@anchor{387}@anchor{gnat_rm/the_gnat_library id130}@anchor{388} @section @cite{GNAT.Wide_Wide_String_Split} (@code{g-zistsp.ads}) @@ -24025,7 +24064,7 @@ to the resulting slices. This package is instantiated from @cite{GNAT.Array_Split}. @node Interfaces C Extensions i-cexten ads,Interfaces C Streams i-cstrea ads,GNAT Wide_Wide_String_Split g-zistsp ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id131}@anchor{387}@anchor{gnat_rm/the_gnat_library interfaces-c-extensions-i-cexten-ads}@anchor{388} +@anchor{gnat_rm/the_gnat_library id131}@anchor{389}@anchor{gnat_rm/the_gnat_library interfaces-c-extensions-i-cexten-ads}@anchor{38a} @section @cite{Interfaces.C.Extensions} (@code{i-cexten.ads}) @@ -24036,7 +24075,7 @@ for use with either manually or automatically generated bindings to C libraries. @node Interfaces C Streams i-cstrea ads,Interfaces Packed_Decimal i-pacdec ads,Interfaces C Extensions i-cexten ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id132}@anchor{389}@anchor{gnat_rm/the_gnat_library interfaces-c-streams-i-cstrea-ads}@anchor{38a} +@anchor{gnat_rm/the_gnat_library id132}@anchor{38b}@anchor{gnat_rm/the_gnat_library interfaces-c-streams-i-cstrea-ads}@anchor{38c} @section @cite{Interfaces.C.Streams} (@code{i-cstrea.ads}) @@ -24049,7 +24088,7 @@ This package is a binding for the most commonly used operations on C streams. @node Interfaces Packed_Decimal i-pacdec ads,Interfaces VxWorks i-vxwork ads,Interfaces C Streams i-cstrea ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library interfaces-packed-decimal-i-pacdec-ads}@anchor{38b}@anchor{gnat_rm/the_gnat_library id133}@anchor{38c} +@anchor{gnat_rm/the_gnat_library interfaces-packed-decimal-i-pacdec-ads}@anchor{38d}@anchor{gnat_rm/the_gnat_library id133}@anchor{38e} @section @cite{Interfaces.Packed_Decimal} (@code{i-pacdec.ads}) @@ -24064,7 +24103,7 @@ from a packed decimal format compatible with that used on IBM mainframes. @node Interfaces VxWorks i-vxwork ads,Interfaces VxWorks IO i-vxwoio ads,Interfaces Packed_Decimal i-pacdec ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id134}@anchor{38d}@anchor{gnat_rm/the_gnat_library interfaces-vxworks-i-vxwork-ads}@anchor{38e} +@anchor{gnat_rm/the_gnat_library id134}@anchor{38f}@anchor{gnat_rm/the_gnat_library interfaces-vxworks-i-vxwork-ads}@anchor{390} @section @cite{Interfaces.VxWorks} (@code{i-vxwork.ads}) @@ -24080,7 +24119,7 @@ In particular, it interfaces with the VxWorks hardware interrupt facilities. @node Interfaces VxWorks IO i-vxwoio ads,System Address_Image s-addima ads,Interfaces VxWorks i-vxwork ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library interfaces-vxworks-io-i-vxwoio-ads}@anchor{38f}@anchor{gnat_rm/the_gnat_library id135}@anchor{390} +@anchor{gnat_rm/the_gnat_library interfaces-vxworks-io-i-vxwoio-ads}@anchor{391}@anchor{gnat_rm/the_gnat_library id135}@anchor{392} @section @cite{Interfaces.VxWorks.IO} (@code{i-vxwoio.ads}) @@ -24103,7 +24142,7 @@ function codes. A particular use of this package is to enable the use of Get_Immediate under VxWorks. @node System Address_Image s-addima ads,System Assertions s-assert ads,Interfaces VxWorks IO i-vxwoio ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library system-address-image-s-addima-ads}@anchor{391}@anchor{gnat_rm/the_gnat_library id136}@anchor{392} +@anchor{gnat_rm/the_gnat_library system-address-image-s-addima-ads}@anchor{393}@anchor{gnat_rm/the_gnat_library id136}@anchor{394} @section @cite{System.Address_Image} (@code{s-addima.ads}) @@ -24119,7 +24158,7 @@ function that gives an (implementation dependent) string which identifies an address. @node System Assertions s-assert ads,System Atomic_Counters s-atocou ads,System Address_Image s-addima ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library system-assertions-s-assert-ads}@anchor{393}@anchor{gnat_rm/the_gnat_library id137}@anchor{394} +@anchor{gnat_rm/the_gnat_library system-assertions-s-assert-ads}@anchor{395}@anchor{gnat_rm/the_gnat_library id137}@anchor{396} @section @cite{System.Assertions} (@code{s-assert.ads}) @@ -24135,7 +24174,7 @@ by an run-time assertion failure, as well as the routine that is used internally to raise this assertion. @node System Atomic_Counters s-atocou ads,System Memory s-memory ads,System Assertions s-assert ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id138}@anchor{395}@anchor{gnat_rm/the_gnat_library system-atomic-counters-s-atocou-ads}@anchor{396} +@anchor{gnat_rm/the_gnat_library id138}@anchor{397}@anchor{gnat_rm/the_gnat_library system-atomic-counters-s-atocou-ads}@anchor{398} @section @cite{System.Atomic_Counters} (@code{s-atocou.ads}) @@ -24149,7 +24188,7 @@ on most targets, including all Alpha, ia64, PowerPC, SPARC V9, x86, and x86_64 platforms. @node System Memory s-memory ads,System Multiprocessors s-multip ads,System Atomic_Counters s-atocou ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library system-memory-s-memory-ads}@anchor{397}@anchor{gnat_rm/the_gnat_library id139}@anchor{398} +@anchor{gnat_rm/the_gnat_library system-memory-s-memory-ads}@anchor{399}@anchor{gnat_rm/the_gnat_library id139}@anchor{39a} @section @cite{System.Memory} (@code{s-memory.ads}) @@ -24167,7 +24206,7 @@ calls to this unit may be made for low level allocation uses (for example see the body of @cite{GNAT.Tables}). @node System Multiprocessors s-multip ads,System Multiprocessors Dispatching_Domains s-mudido ads,System Memory s-memory ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id140}@anchor{399}@anchor{gnat_rm/the_gnat_library system-multiprocessors-s-multip-ads}@anchor{39a} +@anchor{gnat_rm/the_gnat_library id140}@anchor{39b}@anchor{gnat_rm/the_gnat_library system-multiprocessors-s-multip-ads}@anchor{39c} @section @cite{System.Multiprocessors} (@code{s-multip.ads}) @@ -24180,7 +24219,7 @@ in GNAT we also make it available in Ada 95 and Ada 2005 (where it is technically an implementation-defined addition). @node System Multiprocessors Dispatching_Domains s-mudido ads,System Partition_Interface s-parint ads,System Multiprocessors s-multip ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library system-multiprocessors-dispatching-domains-s-mudido-ads}@anchor{39b}@anchor{gnat_rm/the_gnat_library id141}@anchor{39c} +@anchor{gnat_rm/the_gnat_library system-multiprocessors-dispatching-domains-s-mudido-ads}@anchor{39d}@anchor{gnat_rm/the_gnat_library id141}@anchor{39e} @section @cite{System.Multiprocessors.Dispatching_Domains} (@code{s-mudido.ads}) @@ -24193,7 +24232,7 @@ in GNAT we also make it available in Ada 95 and Ada 2005 (where it is technically an implementation-defined addition). @node System Partition_Interface s-parint ads,System Pool_Global s-pooglo ads,System Multiprocessors Dispatching_Domains s-mudido ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id142}@anchor{39d}@anchor{gnat_rm/the_gnat_library system-partition-interface-s-parint-ads}@anchor{39e} +@anchor{gnat_rm/the_gnat_library id142}@anchor{39f}@anchor{gnat_rm/the_gnat_library system-partition-interface-s-parint-ads}@anchor{3a0} @section @cite{System.Partition_Interface} (@code{s-parint.ads}) @@ -24206,7 +24245,7 @@ is used primarily in a distribution context when using Annex E with @cite{GLADE}. @node System Pool_Global s-pooglo ads,System Pool_Local s-pooloc ads,System Partition_Interface s-parint ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id143}@anchor{39f}@anchor{gnat_rm/the_gnat_library system-pool-global-s-pooglo-ads}@anchor{3a0} +@anchor{gnat_rm/the_gnat_library id143}@anchor{3a1}@anchor{gnat_rm/the_gnat_library system-pool-global-s-pooglo-ads}@anchor{3a2} @section @cite{System.Pool_Global} (@code{s-pooglo.ads}) @@ -24223,7 +24262,7 @@ declared. It uses malloc/free to allocate/free and does not attempt to do any automatic reclamation. @node System Pool_Local s-pooloc ads,System Restrictions s-restri ads,System Pool_Global s-pooglo ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id144}@anchor{3a1}@anchor{gnat_rm/the_gnat_library system-pool-local-s-pooloc-ads}@anchor{3a2} +@anchor{gnat_rm/the_gnat_library id144}@anchor{3a3}@anchor{gnat_rm/the_gnat_library system-pool-local-s-pooloc-ads}@anchor{3a4} @section @cite{System.Pool_Local} (@code{s-pooloc.ads}) @@ -24240,7 +24279,7 @@ a list of allocated blocks, so that all storage allocated for the pool can be freed automatically when the pool is finalized. @node System Restrictions s-restri ads,System Rident s-rident ads,System Pool_Local s-pooloc ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id145}@anchor{3a3}@anchor{gnat_rm/the_gnat_library system-restrictions-s-restri-ads}@anchor{3a4} +@anchor{gnat_rm/the_gnat_library id145}@anchor{3a5}@anchor{gnat_rm/the_gnat_library system-restrictions-s-restri-ads}@anchor{3a6} @section @cite{System.Restrictions} (@code{s-restri.ads}) @@ -24256,7 +24295,7 @@ compiler determined information on which restrictions are violated by one or more packages in the partition. @node System Rident s-rident ads,System Strings Stream_Ops s-ststop ads,System Restrictions s-restri ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library system-rident-s-rident-ads}@anchor{3a5}@anchor{gnat_rm/the_gnat_library id146}@anchor{3a6} +@anchor{gnat_rm/the_gnat_library system-rident-s-rident-ads}@anchor{3a7}@anchor{gnat_rm/the_gnat_library id146}@anchor{3a8} @section @cite{System.Rident} (@code{s-rident.ads}) @@ -24272,7 +24311,7 @@ since the necessary instantiation is included in package System.Restrictions. @node System Strings Stream_Ops s-ststop ads,System Unsigned_Types s-unstyp ads,System Rident s-rident ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id147}@anchor{3a7}@anchor{gnat_rm/the_gnat_library system-strings-stream-ops-s-ststop-ads}@anchor{3a8} +@anchor{gnat_rm/the_gnat_library id147}@anchor{3a9}@anchor{gnat_rm/the_gnat_library system-strings-stream-ops-s-ststop-ads}@anchor{3aa} @section @cite{System.Strings.Stream_Ops} (@code{s-ststop.ads}) @@ -24288,7 +24327,7 @@ stream attributes are applied to string types, but the subprograms in this package can be used directly by application programs. @node System Unsigned_Types s-unstyp ads,System Wch_Cnv s-wchcnv ads,System Strings Stream_Ops s-ststop ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library system-unsigned-types-s-unstyp-ads}@anchor{3a9}@anchor{gnat_rm/the_gnat_library id148}@anchor{3aa} +@anchor{gnat_rm/the_gnat_library system-unsigned-types-s-unstyp-ads}@anchor{3ab}@anchor{gnat_rm/the_gnat_library id148}@anchor{3ac} @section @cite{System.Unsigned_Types} (@code{s-unstyp.ads}) @@ -24301,7 +24340,7 @@ also contains some related definitions for other specialized types used by the compiler in connection with packed array types. @node System Wch_Cnv s-wchcnv ads,System Wch_Con s-wchcon ads,System Unsigned_Types s-unstyp ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library system-wch-cnv-s-wchcnv-ads}@anchor{3ab}@anchor{gnat_rm/the_gnat_library id149}@anchor{3ac} +@anchor{gnat_rm/the_gnat_library system-wch-cnv-s-wchcnv-ads}@anchor{3ad}@anchor{gnat_rm/the_gnat_library id149}@anchor{3ae} @section @cite{System.Wch_Cnv} (@code{s-wchcnv.ads}) @@ -24322,7 +24361,7 @@ encoding method. It uses definitions in package @cite{System.Wch_Con}. @node System Wch_Con s-wchcon ads,,System Wch_Cnv s-wchcnv ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library system-wch-con-s-wchcon-ads}@anchor{3ad}@anchor{gnat_rm/the_gnat_library id150}@anchor{3ae} +@anchor{gnat_rm/the_gnat_library system-wch-con-s-wchcon-ads}@anchor{3af}@anchor{gnat_rm/the_gnat_library id150}@anchor{3b0} @section @cite{System.Wch_Con} (@code{s-wchcon.ads}) @@ -24334,7 +24373,7 @@ in ordinary strings. These definitions are used by the package @cite{System.Wch_Cnv}. @node Interfacing to Other Languages,Specialized Needs Annexes,The GNAT Library,Top -@anchor{gnat_rm/interfacing_to_other_languages interfacing-to-other-languages}@anchor{11}@anchor{gnat_rm/interfacing_to_other_languages doc}@anchor{3af}@anchor{gnat_rm/interfacing_to_other_languages id1}@anchor{3b0} +@anchor{gnat_rm/interfacing_to_other_languages interfacing-to-other-languages}@anchor{11}@anchor{gnat_rm/interfacing_to_other_languages doc}@anchor{3b1}@anchor{gnat_rm/interfacing_to_other_languages id1}@anchor{3b2} @chapter Interfacing to Other Languages @@ -24352,7 +24391,7 @@ provided. @end menu @node Interfacing to C,Interfacing to C++,,Interfacing to Other Languages -@anchor{gnat_rm/interfacing_to_other_languages interfacing-to-c}@anchor{3b1}@anchor{gnat_rm/interfacing_to_other_languages id2}@anchor{3b2} +@anchor{gnat_rm/interfacing_to_other_languages interfacing-to-c}@anchor{3b3}@anchor{gnat_rm/interfacing_to_other_languages id2}@anchor{3b4} @section Interfacing to C @@ -24490,7 +24529,7 @@ of the length corresponding to the @code{type'Size} value in Ada. @end itemize @node Interfacing to C++,Interfacing to COBOL,Interfacing to C,Interfacing to Other Languages -@anchor{gnat_rm/interfacing_to_other_languages id4}@anchor{3b3}@anchor{gnat_rm/interfacing_to_other_languages id3}@anchor{3f} +@anchor{gnat_rm/interfacing_to_other_languages id4}@anchor{3b5}@anchor{gnat_rm/interfacing_to_other_languages id3}@anchor{3f} @section Interfacing to C++ @@ -24547,7 +24586,7 @@ The @cite{External_Name} is the name of the C++ RTTI symbol. You can then cover a specific C++ exception in an exception handler. @node Interfacing to COBOL,Interfacing to Fortran,Interfacing to C++,Interfacing to Other Languages -@anchor{gnat_rm/interfacing_to_other_languages id5}@anchor{3b4}@anchor{gnat_rm/interfacing_to_other_languages interfacing-to-cobol}@anchor{3b5} +@anchor{gnat_rm/interfacing_to_other_languages id5}@anchor{3b6}@anchor{gnat_rm/interfacing_to_other_languages interfacing-to-cobol}@anchor{3b7} @section Interfacing to COBOL @@ -24555,7 +24594,7 @@ Interfacing to COBOL is achieved as described in section B.4 of the Ada Reference Manual. @node Interfacing to Fortran,Interfacing to non-GNAT Ada code,Interfacing to COBOL,Interfacing to Other Languages -@anchor{gnat_rm/interfacing_to_other_languages id6}@anchor{3b6}@anchor{gnat_rm/interfacing_to_other_languages interfacing-to-fortran}@anchor{3b7} +@anchor{gnat_rm/interfacing_to_other_languages id6}@anchor{3b8}@anchor{gnat_rm/interfacing_to_other_languages interfacing-to-fortran}@anchor{3b9} @section Interfacing to Fortran @@ -24565,7 +24604,7 @@ multi-dimensional array causes the array to be stored in column-major order as required for convenient interface to Fortran. @node Interfacing to non-GNAT Ada code,,Interfacing to Fortran,Interfacing to Other Languages -@anchor{gnat_rm/interfacing_to_other_languages interfacing-to-non-gnat-ada-code}@anchor{3b8}@anchor{gnat_rm/interfacing_to_other_languages id7}@anchor{3b9} +@anchor{gnat_rm/interfacing_to_other_languages interfacing-to-non-gnat-ada-code}@anchor{3ba}@anchor{gnat_rm/interfacing_to_other_languages id7}@anchor{3bb} @section Interfacing to non-GNAT Ada code @@ -24589,7 +24628,7 @@ values or simple record types without variants, or simple array types with fixed bounds. @node Specialized Needs Annexes,Implementation of Specific Ada Features,Interfacing to Other Languages,Top -@anchor{gnat_rm/specialized_needs_annexes specialized-needs-annexes}@anchor{12}@anchor{gnat_rm/specialized_needs_annexes doc}@anchor{3ba}@anchor{gnat_rm/specialized_needs_annexes id1}@anchor{3bb} +@anchor{gnat_rm/specialized_needs_annexes specialized-needs-annexes}@anchor{12}@anchor{gnat_rm/specialized_needs_annexes doc}@anchor{3bc}@anchor{gnat_rm/specialized_needs_annexes id1}@anchor{3bd} @chapter Specialized Needs Annexes @@ -24630,7 +24669,7 @@ in Ada 2005) is fully implemented. @end table @node Implementation of Specific Ada Features,Implementation of Ada 2012 Features,Specialized Needs Annexes,Top -@anchor{gnat_rm/implementation_of_specific_ada_features implementation-of-specific-ada-features}@anchor{13}@anchor{gnat_rm/implementation_of_specific_ada_features doc}@anchor{3bc}@anchor{gnat_rm/implementation_of_specific_ada_features id1}@anchor{3bd} +@anchor{gnat_rm/implementation_of_specific_ada_features implementation-of-specific-ada-features}@anchor{13}@anchor{gnat_rm/implementation_of_specific_ada_features doc}@anchor{3be}@anchor{gnat_rm/implementation_of_specific_ada_features id1}@anchor{3bf} @chapter Implementation of Specific Ada Features @@ -24648,7 +24687,7 @@ facilities. @end menu @node Machine Code Insertions,GNAT Implementation of Tasking,,Implementation of Specific Ada Features -@anchor{gnat_rm/implementation_of_specific_ada_features machine-code-insertions}@anchor{124}@anchor{gnat_rm/implementation_of_specific_ada_features id2}@anchor{3be} +@anchor{gnat_rm/implementation_of_specific_ada_features machine-code-insertions}@anchor{125}@anchor{gnat_rm/implementation_of_specific_ada_features id2}@anchor{3c0} @section Machine Code Insertions @@ -24816,7 +24855,7 @@ according to normal visibility rules. In particular if there is no qualification is required. @node GNAT Implementation of Tasking,GNAT Implementation of Shared Passive Packages,Machine Code Insertions,Implementation of Specific Ada Features -@anchor{gnat_rm/implementation_of_specific_ada_features id3}@anchor{3bf}@anchor{gnat_rm/implementation_of_specific_ada_features gnat-implementation-of-tasking}@anchor{3c0} +@anchor{gnat_rm/implementation_of_specific_ada_features id3}@anchor{3c1}@anchor{gnat_rm/implementation_of_specific_ada_features gnat-implementation-of-tasking}@anchor{3c2} @section GNAT Implementation of Tasking @@ -24831,7 +24870,7 @@ to compliance with the Real-Time Systems Annex. @end menu @node Mapping Ada Tasks onto the Underlying Kernel Threads,Ensuring Compliance with the Real-Time Annex,,GNAT Implementation of Tasking -@anchor{gnat_rm/implementation_of_specific_ada_features mapping-ada-tasks-onto-the-underlying-kernel-threads}@anchor{3c1}@anchor{gnat_rm/implementation_of_specific_ada_features id4}@anchor{3c2} +@anchor{gnat_rm/implementation_of_specific_ada_features mapping-ada-tasks-onto-the-underlying-kernel-threads}@anchor{3c3}@anchor{gnat_rm/implementation_of_specific_ada_features id4}@anchor{3c4} @subsection Mapping Ada Tasks onto the Underlying Kernel Threads @@ -24900,7 +24939,7 @@ support this functionality when the parent contains more than one task. @geindex Forking a new process @node Ensuring Compliance with the Real-Time Annex,,Mapping Ada Tasks onto the Underlying Kernel Threads,GNAT Implementation of Tasking -@anchor{gnat_rm/implementation_of_specific_ada_features id5}@anchor{3c3}@anchor{gnat_rm/implementation_of_specific_ada_features ensuring-compliance-with-the-real-time-annex}@anchor{3c4} +@anchor{gnat_rm/implementation_of_specific_ada_features id5}@anchor{3c5}@anchor{gnat_rm/implementation_of_specific_ada_features ensuring-compliance-with-the-real-time-annex}@anchor{3c6} @subsection Ensuring Compliance with the Real-Time Annex @@ -24949,7 +24988,7 @@ that were ready to execute in the priority queue where R has been placed at the end. @node GNAT Implementation of Shared Passive Packages,Code Generation for Array Aggregates,GNAT Implementation of Tasking,Implementation of Specific Ada Features -@anchor{gnat_rm/implementation_of_specific_ada_features id6}@anchor{3c5}@anchor{gnat_rm/implementation_of_specific_ada_features gnat-implementation-of-shared-passive-packages}@anchor{3c6} +@anchor{gnat_rm/implementation_of_specific_ada_features id6}@anchor{3c7}@anchor{gnat_rm/implementation_of_specific_ada_features gnat-implementation-of-shared-passive-packages}@anchor{3c8} @section GNAT Implementation of Shared Passive Packages @@ -25050,7 +25089,7 @@ GNAT supports shared passive packages on all platforms except for OpenVMS. @node Code Generation for Array Aggregates,The Size of Discriminated Records with Default Discriminants,GNAT Implementation of Shared Passive Packages,Implementation of Specific Ada Features -@anchor{gnat_rm/implementation_of_specific_ada_features code-generation-for-array-aggregates}@anchor{3c7}@anchor{gnat_rm/implementation_of_specific_ada_features id7}@anchor{3c8} +@anchor{gnat_rm/implementation_of_specific_ada_features code-generation-for-array-aggregates}@anchor{3c9}@anchor{gnat_rm/implementation_of_specific_ada_features id7}@anchor{3ca} @section Code Generation for Array Aggregates @@ -25081,7 +25120,7 @@ component values and static subtypes also lead to simpler code. @end menu @node Static constant aggregates with static bounds,Constant aggregates with unconstrained nominal types,,Code Generation for Array Aggregates -@anchor{gnat_rm/implementation_of_specific_ada_features static-constant-aggregates-with-static-bounds}@anchor{3c9}@anchor{gnat_rm/implementation_of_specific_ada_features id8}@anchor{3ca} +@anchor{gnat_rm/implementation_of_specific_ada_features static-constant-aggregates-with-static-bounds}@anchor{3cb}@anchor{gnat_rm/implementation_of_specific_ada_features id8}@anchor{3cc} @subsection Static constant aggregates with static bounds @@ -25128,7 +25167,7 @@ Zero2: constant two_dim := (others => (others => 0)); @end example @node Constant aggregates with unconstrained nominal types,Aggregates with static bounds,Static constant aggregates with static bounds,Code Generation for Array Aggregates -@anchor{gnat_rm/implementation_of_specific_ada_features constant-aggregates-with-unconstrained-nominal-types}@anchor{3cb}@anchor{gnat_rm/implementation_of_specific_ada_features id9}@anchor{3cc} +@anchor{gnat_rm/implementation_of_specific_ada_features constant-aggregates-with-unconstrained-nominal-types}@anchor{3cd}@anchor{gnat_rm/implementation_of_specific_ada_features id9}@anchor{3ce} @subsection Constant aggregates with unconstrained nominal types @@ -25143,7 +25182,7 @@ Cr_Unc : constant One_Unc := (12,24,36); @end example @node Aggregates with static bounds,Aggregates with nonstatic bounds,Constant aggregates with unconstrained nominal types,Code Generation for Array Aggregates -@anchor{gnat_rm/implementation_of_specific_ada_features id10}@anchor{3cd}@anchor{gnat_rm/implementation_of_specific_ada_features aggregates-with-static-bounds}@anchor{3ce} +@anchor{gnat_rm/implementation_of_specific_ada_features id10}@anchor{3cf}@anchor{gnat_rm/implementation_of_specific_ada_features aggregates-with-static-bounds}@anchor{3d0} @subsection Aggregates with static bounds @@ -25171,7 +25210,7 @@ end loop; @end example @node Aggregates with nonstatic bounds,Aggregates in assignment statements,Aggregates with static bounds,Code Generation for Array Aggregates -@anchor{gnat_rm/implementation_of_specific_ada_features id11}@anchor{3cf}@anchor{gnat_rm/implementation_of_specific_ada_features aggregates-with-nonstatic-bounds}@anchor{3d0} +@anchor{gnat_rm/implementation_of_specific_ada_features id11}@anchor{3d1}@anchor{gnat_rm/implementation_of_specific_ada_features aggregates-with-nonstatic-bounds}@anchor{3d2} @subsection Aggregates with nonstatic bounds @@ -25182,7 +25221,7 @@ have to be applied to sub-arrays individually, if they do not have statically compatible subtypes. @node Aggregates in assignment statements,,Aggregates with nonstatic bounds,Code Generation for Array Aggregates -@anchor{gnat_rm/implementation_of_specific_ada_features id12}@anchor{3d1}@anchor{gnat_rm/implementation_of_specific_ada_features aggregates-in-assignment-statements}@anchor{3d2} +@anchor{gnat_rm/implementation_of_specific_ada_features id12}@anchor{3d3}@anchor{gnat_rm/implementation_of_specific_ada_features aggregates-in-assignment-statements}@anchor{3d4} @subsection Aggregates in assignment statements @@ -25224,7 +25263,7 @@ a temporary (created either by the front-end or the code generator) and then that temporary will be copied onto the target. @node The Size of Discriminated Records with Default Discriminants,Strict Conformance to the Ada Reference Manual,Code Generation for Array Aggregates,Implementation of Specific Ada Features -@anchor{gnat_rm/implementation_of_specific_ada_features id13}@anchor{3d3}@anchor{gnat_rm/implementation_of_specific_ada_features the-size-of-discriminated-records-with-default-discriminants}@anchor{3d4} +@anchor{gnat_rm/implementation_of_specific_ada_features id13}@anchor{3d5}@anchor{gnat_rm/implementation_of_specific_ada_features the-size-of-discriminated-records-with-default-discriminants}@anchor{3d6} @section The Size of Discriminated Records with Default Discriminants @@ -25304,7 +25343,7 @@ say) must be consistent, so it is imperative that the object, once created, remain invariant. @node Strict Conformance to the Ada Reference Manual,,The Size of Discriminated Records with Default Discriminants,Implementation of Specific Ada Features -@anchor{gnat_rm/implementation_of_specific_ada_features strict-conformance-to-the-ada-reference-manual}@anchor{3d5}@anchor{gnat_rm/implementation_of_specific_ada_features id14}@anchor{3d6} +@anchor{gnat_rm/implementation_of_specific_ada_features strict-conformance-to-the-ada-reference-manual}@anchor{3d7}@anchor{gnat_rm/implementation_of_specific_ada_features id14}@anchor{3d8} @section Strict Conformance to the Ada Reference Manual @@ -25331,7 +25370,7 @@ behavior (although at the cost of a significant performance penalty), so infinite and NaN values are properly generated. @node Implementation of Ada 2012 Features,Obsolescent Features,Implementation of Specific Ada Features,Top -@anchor{gnat_rm/implementation_of_ada_2012_features doc}@anchor{3d7}@anchor{gnat_rm/implementation_of_ada_2012_features implementation-of-ada-2012-features}@anchor{14}@anchor{gnat_rm/implementation_of_ada_2012_features id1}@anchor{3d8} +@anchor{gnat_rm/implementation_of_ada_2012_features doc}@anchor{3d9}@anchor{gnat_rm/implementation_of_ada_2012_features implementation-of-ada-2012-features}@anchor{14}@anchor{gnat_rm/implementation_of_ada_2012_features id1}@anchor{3da} @chapter Implementation of Ada 2012 Features @@ -27497,7 +27536,7 @@ RM References: H.04 (8/1) @end itemize @node Obsolescent Features,Compatibility and Porting Guide,Implementation of Ada 2012 Features,Top -@anchor{gnat_rm/obsolescent_features id1}@anchor{3d9}@anchor{gnat_rm/obsolescent_features doc}@anchor{3da}@anchor{gnat_rm/obsolescent_features obsolescent-features}@anchor{15} +@anchor{gnat_rm/obsolescent_features id1}@anchor{3db}@anchor{gnat_rm/obsolescent_features doc}@anchor{3dc}@anchor{gnat_rm/obsolescent_features obsolescent-features}@anchor{15} @chapter Obsolescent Features @@ -27516,7 +27555,7 @@ compatibility purposes. @end menu @node pragma No_Run_Time,pragma Ravenscar,,Obsolescent Features -@anchor{gnat_rm/obsolescent_features id2}@anchor{3db}@anchor{gnat_rm/obsolescent_features pragma-no-run-time}@anchor{3dc} +@anchor{gnat_rm/obsolescent_features id2}@anchor{3dd}@anchor{gnat_rm/obsolescent_features pragma-no-run-time}@anchor{3de} @section pragma No_Run_Time @@ -27529,7 +27568,7 @@ preferred usage is to use an appropriately configured run-time that includes just those features that are to be made accessible. @node pragma Ravenscar,pragma Restricted_Run_Time,pragma No_Run_Time,Obsolescent Features -@anchor{gnat_rm/obsolescent_features id3}@anchor{3dd}@anchor{gnat_rm/obsolescent_features pragma-ravenscar}@anchor{3de} +@anchor{gnat_rm/obsolescent_features id3}@anchor{3df}@anchor{gnat_rm/obsolescent_features pragma-ravenscar}@anchor{3e0} @section pragma Ravenscar @@ -27538,7 +27577,7 @@ The pragma @cite{Ravenscar} has exactly the same effect as pragma is part of the new Ada 2005 standard. @node pragma Restricted_Run_Time,pragma Task_Info,pragma Ravenscar,Obsolescent Features -@anchor{gnat_rm/obsolescent_features pragma-restricted-run-time}@anchor{3df}@anchor{gnat_rm/obsolescent_features id4}@anchor{3e0} +@anchor{gnat_rm/obsolescent_features pragma-restricted-run-time}@anchor{3e1}@anchor{gnat_rm/obsolescent_features id4}@anchor{3e2} @section pragma Restricted_Run_Time @@ -27548,7 +27587,7 @@ preferred since the Ada 2005 pragma @cite{Profile} is intended for this kind of implementation dependent addition. @node pragma Task_Info,package System Task_Info s-tasinf ads,pragma Restricted_Run_Time,Obsolescent Features -@anchor{gnat_rm/obsolescent_features pragma-task-info}@anchor{3e1}@anchor{gnat_rm/obsolescent_features id5}@anchor{3e2} +@anchor{gnat_rm/obsolescent_features pragma-task-info}@anchor{3e3}@anchor{gnat_rm/obsolescent_features id5}@anchor{3e4} @section pragma Task_Info @@ -27574,7 +27613,7 @@ in the spec of package System.Task_Info in the runtime library. @node package System Task_Info s-tasinf ads,,pragma Task_Info,Obsolescent Features -@anchor{gnat_rm/obsolescent_features package-system-task-info}@anchor{3e3}@anchor{gnat_rm/obsolescent_features package-system-task-info-s-tasinf-ads}@anchor{3e4} +@anchor{gnat_rm/obsolescent_features package-system-task-info}@anchor{3e5}@anchor{gnat_rm/obsolescent_features package-system-task-info-s-tasinf-ads}@anchor{3e6} @section package System.Task_Info (@code{s-tasinf.ads}) @@ -27584,7 +27623,7 @@ to support the @cite{Task_Info} pragma. The predefined Ada package standard replacement for GNAT's @cite{Task_Info} functionality. @node Compatibility and Porting Guide,GNU Free Documentation License,Obsolescent Features,Top -@anchor{gnat_rm/compatibility_and_porting_guide compatibility-and-porting-guide}@anchor{16}@anchor{gnat_rm/compatibility_and_porting_guide doc}@anchor{3e5}@anchor{gnat_rm/compatibility_and_porting_guide id1}@anchor{3e6} +@anchor{gnat_rm/compatibility_and_porting_guide compatibility-and-porting-guide}@anchor{16}@anchor{gnat_rm/compatibility_and_porting_guide doc}@anchor{3e7}@anchor{gnat_rm/compatibility_and_porting_guide id1}@anchor{3e8} @chapter Compatibility and Porting Guide @@ -27606,7 +27645,7 @@ applications developed in other Ada environments. @end menu @node Writing Portable Fixed-Point Declarations,Compatibility with Ada 83,,Compatibility and Porting Guide -@anchor{gnat_rm/compatibility_and_porting_guide id2}@anchor{3e7}@anchor{gnat_rm/compatibility_and_porting_guide writing-portable-fixed-point-declarations}@anchor{3e8} +@anchor{gnat_rm/compatibility_and_porting_guide id2}@anchor{3e9}@anchor{gnat_rm/compatibility_and_porting_guide writing-portable-fixed-point-declarations}@anchor{3ea} @section Writing Portable Fixed-Point Declarations @@ -27728,7 +27767,7 @@ If you follow this scheme you will be guaranteed that your fixed-point types will be portable. @node Compatibility with Ada 83,Compatibility between Ada 95 and Ada 2005,Writing Portable Fixed-Point Declarations,Compatibility and Porting Guide -@anchor{gnat_rm/compatibility_and_porting_guide compatibility-with-ada-83}@anchor{3e9}@anchor{gnat_rm/compatibility_and_porting_guide id3}@anchor{3ea} +@anchor{gnat_rm/compatibility_and_porting_guide compatibility-with-ada-83}@anchor{3eb}@anchor{gnat_rm/compatibility_and_porting_guide id3}@anchor{3ec} @section Compatibility with Ada 83 @@ -27756,7 +27795,7 @@ following subsections treat the most likely issues to be encountered. @end menu @node Legal Ada 83 programs that are illegal in Ada 95,More deterministic semantics,,Compatibility with Ada 83 -@anchor{gnat_rm/compatibility_and_porting_guide id4}@anchor{3eb}@anchor{gnat_rm/compatibility_and_porting_guide legal-ada-83-programs-that-are-illegal-in-ada-95}@anchor{3ec} +@anchor{gnat_rm/compatibility_and_porting_guide id4}@anchor{3ed}@anchor{gnat_rm/compatibility_and_porting_guide legal-ada-83-programs-that-are-illegal-in-ada-95}@anchor{3ee} @subsection Legal Ada 83 programs that are illegal in Ada 95 @@ -27856,7 +27895,7 @@ the fix is usually simply to add the @cite{(<>)} to the generic declaration. @end itemize @node More deterministic semantics,Changed semantics,Legal Ada 83 programs that are illegal in Ada 95,Compatibility with Ada 83 -@anchor{gnat_rm/compatibility_and_porting_guide more-deterministic-semantics}@anchor{3ed}@anchor{gnat_rm/compatibility_and_porting_guide id5}@anchor{3ee} +@anchor{gnat_rm/compatibility_and_porting_guide more-deterministic-semantics}@anchor{3ef}@anchor{gnat_rm/compatibility_and_porting_guide id5}@anchor{3f0} @subsection More deterministic semantics @@ -27884,7 +27923,7 @@ which open select branches are executed. @end itemize @node Changed semantics,Other language compatibility issues,More deterministic semantics,Compatibility with Ada 83 -@anchor{gnat_rm/compatibility_and_porting_guide id6}@anchor{3ef}@anchor{gnat_rm/compatibility_and_porting_guide changed-semantics}@anchor{3f0} +@anchor{gnat_rm/compatibility_and_porting_guide id6}@anchor{3f1}@anchor{gnat_rm/compatibility_and_porting_guide changed-semantics}@anchor{3f2} @subsection Changed semantics @@ -27926,7 +27965,7 @@ covers only the restricted range. @end itemize @node Other language compatibility issues,,Changed semantics,Compatibility with Ada 83 -@anchor{gnat_rm/compatibility_and_porting_guide other-language-compatibility-issues}@anchor{3f1}@anchor{gnat_rm/compatibility_and_porting_guide id7}@anchor{3f2} +@anchor{gnat_rm/compatibility_and_porting_guide other-language-compatibility-issues}@anchor{3f3}@anchor{gnat_rm/compatibility_and_porting_guide id7}@anchor{3f4} @subsection Other language compatibility issues @@ -27959,7 +27998,7 @@ include @cite{pragma Interface} and the floating point type attributes @end itemize @node Compatibility between Ada 95 and Ada 2005,Implementation-dependent characteristics,Compatibility with Ada 83,Compatibility and Porting Guide -@anchor{gnat_rm/compatibility_and_porting_guide compatibility-between-ada-95-and-ada-2005}@anchor{3f3}@anchor{gnat_rm/compatibility_and_porting_guide id8}@anchor{3f4} +@anchor{gnat_rm/compatibility_and_porting_guide compatibility-between-ada-95-and-ada-2005}@anchor{3f5}@anchor{gnat_rm/compatibility_and_porting_guide id8}@anchor{3f6} @section Compatibility between Ada 95 and Ada 2005 @@ -28031,7 +28070,7 @@ can declare a function returning a value from an anonymous access type. @end itemize @node Implementation-dependent characteristics,Compatibility with Other Ada Systems,Compatibility between Ada 95 and Ada 2005,Compatibility and Porting Guide -@anchor{gnat_rm/compatibility_and_porting_guide implementation-dependent-characteristics}@anchor{3f5}@anchor{gnat_rm/compatibility_and_porting_guide id9}@anchor{3f6} +@anchor{gnat_rm/compatibility_and_porting_guide implementation-dependent-characteristics}@anchor{3f7}@anchor{gnat_rm/compatibility_and_porting_guide id9}@anchor{3f8} @section Implementation-dependent characteristics @@ -28054,7 +28093,7 @@ transition from certain Ada 83 compilers. @end menu @node Implementation-defined pragmas,Implementation-defined attributes,,Implementation-dependent characteristics -@anchor{gnat_rm/compatibility_and_porting_guide implementation-defined-pragmas}@anchor{3f7}@anchor{gnat_rm/compatibility_and_porting_guide id10}@anchor{3f8} +@anchor{gnat_rm/compatibility_and_porting_guide implementation-defined-pragmas}@anchor{3f9}@anchor{gnat_rm/compatibility_and_porting_guide id10}@anchor{3fa} @subsection Implementation-defined pragmas @@ -28076,7 +28115,7 @@ avoiding compiler rejection of units that contain such pragmas; they are not relevant in a GNAT context and hence are not otherwise implemented. @node Implementation-defined attributes,Libraries,Implementation-defined pragmas,Implementation-dependent characteristics -@anchor{gnat_rm/compatibility_and_porting_guide id11}@anchor{3f9}@anchor{gnat_rm/compatibility_and_porting_guide implementation-defined-attributes}@anchor{3fa} +@anchor{gnat_rm/compatibility_and_porting_guide id11}@anchor{3fb}@anchor{gnat_rm/compatibility_and_porting_guide implementation-defined-attributes}@anchor{3fc} @subsection Implementation-defined attributes @@ -28090,7 +28129,7 @@ Ada 83, GNAT supplies the attributes @cite{Bit}, @cite{Machine_Size} and @cite{Type_Class}. @node Libraries,Elaboration order,Implementation-defined attributes,Implementation-dependent characteristics -@anchor{gnat_rm/compatibility_and_porting_guide libraries}@anchor{3fb}@anchor{gnat_rm/compatibility_and_porting_guide id12}@anchor{3fc} +@anchor{gnat_rm/compatibility_and_porting_guide libraries}@anchor{3fd}@anchor{gnat_rm/compatibility_and_porting_guide id12}@anchor{3fe} @subsection Libraries @@ -28119,7 +28158,7 @@ be preferable to retrofit the application using modular types. @end itemize @node Elaboration order,Target-specific aspects,Libraries,Implementation-dependent characteristics -@anchor{gnat_rm/compatibility_and_porting_guide elaboration-order}@anchor{3fd}@anchor{gnat_rm/compatibility_and_porting_guide id13}@anchor{3fe} +@anchor{gnat_rm/compatibility_and_porting_guide elaboration-order}@anchor{3ff}@anchor{gnat_rm/compatibility_and_porting_guide id13}@anchor{400} @subsection Elaboration order @@ -28155,7 +28194,7 @@ pragmas either globally (as an effect of the @emph{-gnatE} switch) or locally @end itemize @node Target-specific aspects,,Elaboration order,Implementation-dependent characteristics -@anchor{gnat_rm/compatibility_and_porting_guide target-specific-aspects}@anchor{3ff}@anchor{gnat_rm/compatibility_and_porting_guide id14}@anchor{400} +@anchor{gnat_rm/compatibility_and_porting_guide target-specific-aspects}@anchor{401}@anchor{gnat_rm/compatibility_and_porting_guide id14}@anchor{402} @subsection Target-specific aspects @@ -28168,10 +28207,10 @@ on the robustness of the original design. Moreover, Ada 95 (and thus Ada 2005 and Ada 2012) are sometimes incompatible with typical Ada 83 compiler practices regarding implicit packing, the meaning of the Size attribute, and the size of access values. -GNAT's approach to these issues is described in @ref{401,,Representation Clauses}. +GNAT's approach to these issues is described in @ref{403,,Representation Clauses}. @node Compatibility with Other Ada Systems,Representation Clauses,Implementation-dependent characteristics,Compatibility and Porting Guide -@anchor{gnat_rm/compatibility_and_porting_guide id15}@anchor{402}@anchor{gnat_rm/compatibility_and_porting_guide compatibility-with-other-ada-systems}@anchor{403} +@anchor{gnat_rm/compatibility_and_porting_guide id15}@anchor{404}@anchor{gnat_rm/compatibility_and_porting_guide compatibility-with-other-ada-systems}@anchor{405} @section Compatibility with Other Ada Systems @@ -28214,7 +28253,7 @@ far beyond this minimal set, as described in the next section. @end itemize @node Representation Clauses,Compatibility with HP Ada 83,Compatibility with Other Ada Systems,Compatibility and Porting Guide -@anchor{gnat_rm/compatibility_and_porting_guide representation-clauses}@anchor{401}@anchor{gnat_rm/compatibility_and_porting_guide id16}@anchor{404} +@anchor{gnat_rm/compatibility_and_porting_guide representation-clauses}@anchor{403}@anchor{gnat_rm/compatibility_and_porting_guide id16}@anchor{406} @section Representation Clauses @@ -28307,7 +28346,7 @@ with thin pointers. @end itemize @node Compatibility with HP Ada 83,,Representation Clauses,Compatibility and Porting Guide -@anchor{gnat_rm/compatibility_and_porting_guide compatibility-with-hp-ada-83}@anchor{405}@anchor{gnat_rm/compatibility_and_porting_guide id17}@anchor{406} +@anchor{gnat_rm/compatibility_and_porting_guide compatibility-with-hp-ada-83}@anchor{407}@anchor{gnat_rm/compatibility_and_porting_guide id17}@anchor{408} @section Compatibility with HP Ada 83 @@ -28337,7 +28376,7 @@ extension of package System. @end itemize @node GNU Free Documentation License,Index,Compatibility and Porting Guide,Top -@anchor{share/gnu_free_documentation_license gnu-fdl}@anchor{1}@anchor{share/gnu_free_documentation_license doc}@anchor{407}@anchor{share/gnu_free_documentation_license gnu-free-documentation-license}@anchor{408} +@anchor{share/gnu_free_documentation_license gnu-fdl}@anchor{1}@anchor{share/gnu_free_documentation_license doc}@anchor{409}@anchor{share/gnu_free_documentation_license gnu-free-documentation-license}@anchor{40a} @chapter GNU Free Documentation License diff --git a/gcc/ada/gnat_ugn.texi b/gcc/ada/gnat_ugn.texi index 1f465ae6035..07d3c0c2667 100644 --- a/gcc/ada/gnat_ugn.texi +++ b/gcc/ada/gnat_ugn.texi @@ -21,7 +21,7 @@ @copying @quotation -GNAT User's Guide for Native Platforms , October 23, 2015 +GNAT User's Guide for Native Platforms , November 12, 2015 AdaCore @@ -564,6 +564,7 @@ Microsoft Windows Topics * CONSOLE and WINDOWS subsystems:: * Temporary Files:: * Mixed-Language Programming on Windows:: +* Windows Specific Add-Ons:: Mixed-Language Programming on Windows @@ -576,6 +577,7 @@ Mixed-Language Programming on Windows * Ada DLLs and Finalization:: * Creating a Spec for Ada DLLs:: * GNAT and Windows Resources:: +* Using GNAT DLLs from Microsoft Visual Studio Applications:: * Debugging a DLL:: * Setting Stack Size from gnatlink:: * Setting Heap Size from gnatlink:: @@ -614,6 +616,11 @@ Debugging a DLL * Program and DLL Both Built with GCC/GNAT:: * Program Built with Foreign Tools and DLL Built with GCC/GNAT:: +Windows Specific Add-Ons + +* Win32Ada:: +* wPOSIX:: + Mac OS Topics * Codesigning the Debugger:: @@ -5758,7 +5765,7 @@ expectations. @item @emph{Stdcall} -This is relevant only to Windows XP/2000/NT implementations of GNAT, +This is relevant only to Windows implementations of GNAT, and specifies that the @cite{Stdcall} calling sequence will be used, as defined by the NT API. Nevertheless, to ease building cross-platform bindings this convention will be handled as a @cite{C} calling @@ -29878,6 +29885,7 @@ platforms. * CONSOLE and WINDOWS subsystems:: * Temporary Files:: * Mixed-Language Programming on Windows:: +* Windows Specific Add-Ons:: @end menu @@ -30049,7 +30057,7 @@ file will be created. This is particularly useful in networked environments where you may not have write access to some directories. -@node Mixed-Language Programming on Windows,,Temporary Files,Microsoft Windows Topics +@node Mixed-Language Programming on Windows,Windows Specific Add-Ons,Temporary Files,Microsoft Windows Topics @anchor{gnat_ugn/platform_specific_information mixed-language-programming-on-windows}@anchor{270}@anchor{gnat_ugn/platform_specific_information id14}@anchor{271} @subsection Mixed-Language Programming on Windows @@ -30126,6 +30134,7 @@ native SEH support is used. * Ada DLLs and Finalization:: * Creating a Spec for Ada DLLs:: * GNAT and Windows Resources:: +* Using GNAT DLLs from Microsoft Visual Studio Applications:: * Debugging a DLL:: * Setting Stack Size from gnatlink:: * Setting Heap Size from gnatlink:: @@ -30621,28 +30630,21 @@ calling convention function in the exported symbols list. There can actually be other sections in a definition file, but these sections are not relevant to the discussion at hand. +@anchor{gnat_ugn/platform_specific_information create-def-file-automatically}@anchor{286} +@subsubheading Creating a Definition File Automatically -@subsubheading GNAT-Style Import Library - -@anchor{gnat_ugn/platform_specific_information gnat-style-import-library}@anchor{286} -To create a static import library from @code{API.dll} with the GNAT tools -you should proceed as follows: +You can automatically create the definition file @code{API.def} +(see @ref{280,,The Definition File}) from a DLL. +For that use the @cite{dlltool} program as follows: -@itemize * - -@item -Create the definition file @code{API.def} -(see @ref{280,,The Definition File}). -For that use the @cite{dll2def} tool as follows: +@quotation @example -$ dll2def API.dll > API.def +$ dlltool API.dll -z API.def --export-all-symbols @end example -@cite{dll2def} is a very simple tool: it takes as input a DLL and prints -to standard output the list of entry points in the DLL. Note that if -some routines in the DLL have the @cite{Stdcall} convention +Note that if some routines in the DLL have the @cite{Stdcall} convention (@ref{274,,Windows Calling Conventions}) with stripped @code{@@@emph{nn}} suffix then you'll have to edit @code{api.def} to add it, and specify @emph{-k} to @emph{gnatdll} when creating the import library. @@ -30666,10 +30668,16 @@ If you have a message about a missing symbol at link time the compiler tells you what symbol is expected. You just have to go back to the definition file and add the right suffix. @end itemize +@end quotation +@anchor{gnat_ugn/platform_specific_information gnat-style-import-library}@anchor{287} +@subsubheading GNAT-Style Import Library -@item -Build the import library @cite{libAPI.dll.a}, using @cite{gnatdll} -(see @ref{287,,Using gnatdll}) as follows: + +To create a static import library from @code{API.dll} with the GNAT tools +you should create the .def file, then use @cite{gnatdll} tool +(see @ref{288,,Using gnatdll}) as follows: + +@quotation @example $ gnatdll -e API.def -d API.dll @@ -30683,30 +30691,21 @@ definition file name is @cite{xyz`}.def`, the import library name will be @cite{lib`@w{`}xyz`}.a`. Note that in the previous example option @emph{-e} could have been removed because the name of the definition file (before the '@cite{.def}' suffix) is the same as the name of the -DLL (@ref{287,,Using gnatdll} for more information about @cite{gnatdll}). -@end itemize - +DLL (@ref{288,,Using gnatdll} for more information about @cite{gnatdll}). +@end quotation +@anchor{gnat_ugn/platform_specific_information msvs-style-import-library}@anchor{289} @subsubheading Microsoft-Style Import Library -With GNAT you can either use a GNAT-style or Microsoft-style import -library. A Microsoft import library is needed only if you plan to make an +A Microsoft import library is needed only if you plan to make an Ada DLL available to applications developed with Microsoft tools (@ref{270,,Mixed-Language Programming on Windows}). To create a Microsoft-style import library for @code{API.dll} you -should proceed as follows: - - -@itemize * - -@item -Create the definition file @code{API.def} from the DLL. For this use either -the @cite{dll2def} tool as described above or the Microsoft @cite{dumpbin} -tool (see the corresponding Microsoft documentation for further details). +should create the .def file, then build the actual import library using +Microsoft's @cite{lib} utility: -@item -Build the actual import library using Microsoft's @cite{lib} utility: +@quotation @example $ lib -machine:IX86 -def:API.def -out:API.lib @@ -30721,10 +30720,10 @@ LIBRARY "API" See the Microsoft documentation for further details about the usage of @cite{lib}. -@end itemize +@end quotation @node Building DLLs with GNAT Project files,Building DLLs with GNAT,Using DLLs with GNAT,Mixed-Language Programming on Windows -@anchor{gnat_ugn/platform_specific_information id24}@anchor{288}@anchor{gnat_ugn/platform_specific_information building-dlls-with-gnat-project-files}@anchor{273} +@anchor{gnat_ugn/platform_specific_information id24}@anchor{28a}@anchor{gnat_ugn/platform_specific_information building-dlls-with-gnat-project-files}@anchor{273} @subsubsection Building DLLs with GNAT Project files @@ -30739,7 +30738,7 @@ when inside the @cite{DllMain} routine which is used for auto-initialization of shared libraries, so it is not possible to have library level tasks in SALs. @node Building DLLs with GNAT,Building DLLs with gnatdll,Building DLLs with GNAT Project files,Mixed-Language Programming on Windows -@anchor{gnat_ugn/platform_specific_information building-dlls-with-gnat}@anchor{289}@anchor{gnat_ugn/platform_specific_information id25}@anchor{28a} +@anchor{gnat_ugn/platform_specific_information building-dlls-with-gnat}@anchor{28b}@anchor{gnat_ugn/platform_specific_information id25}@anchor{28c} @subsubsection Building DLLs with GNAT @@ -30808,7 +30807,7 @@ $ gnatmake main -Iapilib -bargs -shared -largs -Lapilib -lAPI @end quotation @node Building DLLs with gnatdll,Ada DLLs and Finalization,Building DLLs with GNAT,Mixed-Language Programming on Windows -@anchor{gnat_ugn/platform_specific_information building-dlls-with-gnatdll}@anchor{28b}@anchor{gnat_ugn/platform_specific_information id26}@anchor{28c} +@anchor{gnat_ugn/platform_specific_information building-dlls-with-gnatdll}@anchor{28d}@anchor{gnat_ugn/platform_specific_information id26}@anchor{28e} @subsubsection Building DLLs with gnatdll @@ -30817,7 +30816,7 @@ $ gnatmake main -Iapilib -bargs -shared -largs -Lapilib -lAPI Note that it is preferred to use GNAT Project files (@ref{273,,Building DLLs with GNAT Project files}) or the built-in GNAT -DLL support (@ref{289,,Building DLLs with GNAT}) or to build DLLs. +DLL support (@ref{28b,,Building DLLs with GNAT}) or to build DLLs. This section explains how to build DLLs containing Ada code using @cite{gnatdll}. These DLLs will be referred to as Ada DLLs in the @@ -30833,20 +30832,20 @@ non-Ada applications are as follows: You need to mark each Ada @emph{entity} exported by the DLL with a @cite{C} or @cite{Stdcall} calling convention to avoid any Ada name mangling for the entities exported by the DLL -(see @ref{28d,,Exporting Ada Entities}). You can +(see @ref{28f,,Exporting Ada Entities}). You can skip this step if you plan to use the Ada DLL only from Ada applications. @item Your Ada code must export an initialization routine which calls the routine @cite{adainit} generated by @emph{gnatbind} to perform the elaboration of -the Ada code in the DLL (@ref{28e,,Ada DLLs and Elaboration}). The initialization +the Ada code in the DLL (@ref{290,,Ada DLLs and Elaboration}). The initialization routine exported by the Ada DLL must be invoked by the clients of the DLL to initialize the DLL. @item When useful, the DLL should also export a finalization routine which calls routine @cite{adafinal} generated by @emph{gnatbind} to perform the -finalization of the Ada code in the DLL (@ref{28f,,Ada DLLs and Finalization}). +finalization of the Ada code in the DLL (@ref{291,,Ada DLLs and Finalization}). The finalization routine exported by the Ada DLL must be invoked by the clients of the DLL when the DLL services are no further needed. @@ -30860,7 +30859,7 @@ You must provide a definition file listing the exported entities @item Finally you must use @cite{gnatdll} to produce the DLL and the import -library (@ref{287,,Using gnatdll}). +library (@ref{288,,Using gnatdll}). @end itemize Note that a relocatable DLL stripped using the @cite{strip} @@ -30879,7 +30878,7 @@ See @ref{8a,,Library Projects}. @end menu @node Limitations When Using Ada DLLs from Ada,Exporting Ada Entities,,Building DLLs with gnatdll -@anchor{gnat_ugn/platform_specific_information limitations-when-using-ada-dlls-from-ada}@anchor{290} +@anchor{gnat_ugn/platform_specific_information limitations-when-using-ada-dlls-from-ada}@anchor{292} @subsubsection Limitations When Using Ada DLLs from Ada @@ -30900,7 +30899,7 @@ It is completely safe to exchange plain elementary, array or record types, Windows object handles, etc. @node Exporting Ada Entities,Ada DLLs and Elaboration,Limitations When Using Ada DLLs from Ada,Building DLLs with gnatdll -@anchor{gnat_ugn/platform_specific_information exporting-ada-entities}@anchor{28d}@anchor{gnat_ugn/platform_specific_information id27}@anchor{291} +@anchor{gnat_ugn/platform_specific_information exporting-ada-entities}@anchor{28f}@anchor{gnat_ugn/platform_specific_information id27}@anchor{293} @subsubsection Exporting Ada Entities @@ -31000,10 +30999,10 @@ end API; Note that if you do not export the Ada entities with a @cite{C} or @cite{Stdcall} convention you will have to provide the mangled Ada names in the definition file of the Ada DLL -(@ref{292,,Creating the Definition File}). +(@ref{294,,Creating the Definition File}). @node Ada DLLs and Elaboration,,Exporting Ada Entities,Building DLLs with gnatdll -@anchor{gnat_ugn/platform_specific_information ada-dlls-and-elaboration}@anchor{28e}@anchor{gnat_ugn/platform_specific_information id28}@anchor{293} +@anchor{gnat_ugn/platform_specific_information ada-dlls-and-elaboration}@anchor{290}@anchor{gnat_ugn/platform_specific_information id28}@anchor{295} @subsubsection Ada DLLs and Elaboration @@ -31021,7 +31020,7 @@ the Ada elaboration routine @cite{adainit} generated by the GNAT binder (@ref{ba,,Binding with Non-Ada Main Programs}). See the body of @cite{Initialize_Api} for an example. Note that the GNAT binder is automatically invoked during the DLL build process by the @cite{gnatdll} -tool (@ref{287,,Using gnatdll}). +tool (@ref{288,,Using gnatdll}). When a DLL is loaded, Windows systematically invokes a routine called @cite{DllMain}. It would therefore be possible to call @cite{adainit} @@ -31034,7 +31033,7 @@ time), which means that the GNAT run time will deadlock waiting for the newly created task to complete its initialization. @node Ada DLLs and Finalization,Creating a Spec for Ada DLLs,Building DLLs with gnatdll,Mixed-Language Programming on Windows -@anchor{gnat_ugn/platform_specific_information id29}@anchor{294}@anchor{gnat_ugn/platform_specific_information ada-dlls-and-finalization}@anchor{28f} +@anchor{gnat_ugn/platform_specific_information id29}@anchor{296}@anchor{gnat_ugn/platform_specific_information ada-dlls-and-finalization}@anchor{291} @subsubsection Ada DLLs and Finalization @@ -31049,10 +31048,10 @@ routine @cite{adafinal} generated by the GNAT binder See the body of @cite{Finalize_Api} for an example. As already pointed out the GNAT binder is automatically invoked during the DLL build process by the @cite{gnatdll} tool -(@ref{287,,Using gnatdll}). +(@ref{288,,Using gnatdll}). @node Creating a Spec for Ada DLLs,GNAT and Windows Resources,Ada DLLs and Finalization,Mixed-Language Programming on Windows -@anchor{gnat_ugn/platform_specific_information id30}@anchor{295}@anchor{gnat_ugn/platform_specific_information creating-a-spec-for-ada-dlls}@anchor{296} +@anchor{gnat_ugn/platform_specific_information id30}@anchor{297}@anchor{gnat_ugn/platform_specific_information creating-a-spec-for-ada-dlls}@anchor{298} @subsubsection Creating a Spec for Ada DLLs @@ -31110,7 +31109,7 @@ end API; @end menu @node Creating the Definition File,Using gnatdll,,Creating a Spec for Ada DLLs -@anchor{gnat_ugn/platform_specific_information creating-the-definition-file}@anchor{292}@anchor{gnat_ugn/platform_specific_information id31}@anchor{297} +@anchor{gnat_ugn/platform_specific_information creating-the-definition-file}@anchor{294}@anchor{gnat_ugn/platform_specific_information id31}@anchor{299} @subsubsection Creating the Definition File @@ -31146,7 +31145,7 @@ EXPORTS @end quotation @node Using gnatdll,,Creating the Definition File,Creating a Spec for Ada DLLs -@anchor{gnat_ugn/platform_specific_information using-gnatdll}@anchor{287}@anchor{gnat_ugn/platform_specific_information id32}@anchor{298} +@anchor{gnat_ugn/platform_specific_information using-gnatdll}@anchor{288}@anchor{gnat_ugn/platform_specific_information id32}@anchor{29a} @subsubsection Using @cite{gnatdll} @@ -31357,7 +31356,7 @@ asks @emph{gnatlink} to generate the routines @cite{DllMain} and is loaded into memory. @item -@cite{gnatdll} uses @cite{dlltool} (see @ref{299,,Using dlltool}) to build the +@cite{gnatdll} uses @cite{dlltool} (see @ref{29b,,Using dlltool}) to build the export table (@code{api.exp}). The export table contains the relocation information in a form which can be used during the final link to ensure that the Windows loader is able to place the DLL anywhere in memory. @@ -31396,7 +31395,7 @@ $ gnatbind -n api $ gnatlink api api.exp -o api.dll -mdll @end example @end itemize -@anchor{gnat_ugn/platform_specific_information using-dlltool}@anchor{299} +@anchor{gnat_ugn/platform_specific_information using-dlltool}@anchor{29b} @subsubheading Using @cite{dlltool} @@ -31510,8 +31509,8 @@ Verbose mode. Use @cite{assembler-name} as the assembler. The default is @cite{as}. @end table -@node GNAT and Windows Resources,Debugging a DLL,Creating a Spec for Ada DLLs,Mixed-Language Programming on Windows -@anchor{gnat_ugn/platform_specific_information gnat-and-windows-resources}@anchor{29a}@anchor{gnat_ugn/platform_specific_information id33}@anchor{29b} +@node GNAT and Windows Resources,Using GNAT DLLs from Microsoft Visual Studio Applications,Creating a Spec for Ada DLLs,Mixed-Language Programming on Windows +@anchor{gnat_ugn/platform_specific_information gnat-and-windows-resources}@anchor{29c}@anchor{gnat_ugn/platform_specific_information id33}@anchor{29d} @subsubsection GNAT and Windows Resources @@ -31606,7 +31605,7 @@ the corresponding Microsoft documentation. @end menu @node Building Resources,Compiling Resources,,GNAT and Windows Resources -@anchor{gnat_ugn/platform_specific_information building-resources}@anchor{29c}@anchor{gnat_ugn/platform_specific_information id34}@anchor{29d} +@anchor{gnat_ugn/platform_specific_information building-resources}@anchor{29e}@anchor{gnat_ugn/platform_specific_information id34}@anchor{29f} @subsubsection Building Resources @@ -31626,7 +31625,7 @@ complete description of the resource script language can be found in the Microsoft documentation. @node Compiling Resources,Using Resources,Building Resources,GNAT and Windows Resources -@anchor{gnat_ugn/platform_specific_information compiling-resources}@anchor{29e}@anchor{gnat_ugn/platform_specific_information id35}@anchor{29f} +@anchor{gnat_ugn/platform_specific_information compiling-resources}@anchor{2a0}@anchor{gnat_ugn/platform_specific_information id35}@anchor{2a1} @subsubsection Compiling Resources @@ -31668,7 +31667,7 @@ $ windres -i myres.res -o myres.o @end quotation @node Using Resources,,Compiling Resources,GNAT and Windows Resources -@anchor{gnat_ugn/platform_specific_information id36}@anchor{2a0}@anchor{gnat_ugn/platform_specific_information using-resources}@anchor{2a1} +@anchor{gnat_ugn/platform_specific_information id36}@anchor{2a2}@anchor{gnat_ugn/platform_specific_information using-resources}@anchor{2a3} @subsubsection Using Resources @@ -31687,8 +31686,101 @@ $ gnatmake myprog -largs myres.o @end example @end quotation -@node Debugging a DLL,Setting Stack Size from gnatlink,GNAT and Windows Resources,Mixed-Language Programming on Windows -@anchor{gnat_ugn/platform_specific_information id37}@anchor{2a2}@anchor{gnat_ugn/platform_specific_information debugging-a-dll}@anchor{2a3} +@node Using GNAT DLLs from Microsoft Visual Studio Applications,Debugging a DLL,GNAT and Windows Resources,Mixed-Language Programming on Windows +@anchor{gnat_ugn/platform_specific_information using-gnat-dll-from-msvs}@anchor{2a4}@anchor{gnat_ugn/platform_specific_information using-gnat-dlls-from-microsoft-visual-studio-applications}@anchor{2a5} +@subsubsection Using GNAT DLLs from Microsoft Visual Studio Applications + + +@geindex Microsoft Visual Studio +@geindex use with GNAT DLLs + +This section describes a common case of mixed GNAT/Microsoft Visual Studio +application development, where the main program is developed using MSVS, and +is linked with a DLL developed using GNAT. Such a mixed application should +be developed following the general guidelines outlined above; below is the +cookbook-style sequence of steps to follow: + + +@enumerate + +@item +First develop and build the GNAT shared library using a library project +(let's assume the project is @cite{mylib.gpr}, producing the library @cite{libmylib.dll}): +@end enumerate + +@quotation + +@example +$ gprbuild -p mylib.gpr +@end example +@end quotation + + +@enumerate 2 + +@item +Produce a .def file for the symbols you need to interface with, either by +hand or automatically with possibly some manual adjustments +(see @ref{286,,Creating Definition File Automatically}): +@end enumerate + +@quotation + +@example +$ dlltool libmylib.dll -z libmylib.def --export-all-symbols +@end example +@end quotation + + +@enumerate 3 + +@item +Make sure that MSVS command-line tools are accessible on the path. + +@item +Create the Microsoft-style import library (see @ref{289,,MSVS-Style Import Library}): +@end enumerate + +@quotation + +@example +$ lib -machine:IX86 -def:libmylib.def -out:libmylib.lib +@end example +@end quotation + +If you are using a 64-bit toolchain, the above becomes... + +@quotation + +@example +$ lib -machine:X64 -def:libmylib.def -out:libmylib.lib +@end example +@end quotation + + +@enumerate 5 + +@item +Build the C main +@end enumerate + +@quotation + +@example +$ cl /O2 /MD main.c libmylib.lib +@end example +@end quotation + + +@enumerate 6 + +@item +Before running the executable, make sure you have set the PATH to the DLL, +or copy the DLL into into the directory containing the .exe. +@end enumerate + +@node Debugging a DLL,Setting Stack Size from gnatlink,Using GNAT DLLs from Microsoft Visual Studio Applications,Mixed-Language Programming on Windows +@anchor{gnat_ugn/platform_specific_information id37}@anchor{2a6}@anchor{gnat_ugn/platform_specific_information debugging-a-dll}@anchor{2a7} @subsubsection Debugging a DLL @@ -31726,7 +31818,7 @@ tools suite used to build the DLL. @end menu @node Program and DLL Both Built with GCC/GNAT,Program Built with Foreign Tools and DLL Built with GCC/GNAT,,Debugging a DLL -@anchor{gnat_ugn/platform_specific_information program-and-dll-both-built-with-gcc-gnat}@anchor{2a4}@anchor{gnat_ugn/platform_specific_information id38}@anchor{2a5} +@anchor{gnat_ugn/platform_specific_information program-and-dll-both-built-with-gcc-gnat}@anchor{2a8}@anchor{gnat_ugn/platform_specific_information id38}@anchor{2a9} @subsubsection Program and DLL Both Built with GCC/GNAT @@ -31776,7 +31868,7 @@ you can use the standard approach to debug the whole program (@ref{26,,Running and Debugging Ada Programs}). @node Program Built with Foreign Tools and DLL Built with GCC/GNAT,,Program and DLL Both Built with GCC/GNAT,Debugging a DLL -@anchor{gnat_ugn/platform_specific_information program-built-with-foreign-tools-and-dll-built-with-gcc-gnat}@anchor{2a6}@anchor{gnat_ugn/platform_specific_information id39}@anchor{2a7} +@anchor{gnat_ugn/platform_specific_information program-built-with-foreign-tools-and-dll-built-with-gcc-gnat}@anchor{2aa}@anchor{gnat_ugn/platform_specific_information id39}@anchor{2ab} @subsubsection Program Built with Foreign Tools and DLL Built with GCC/GNAT @@ -31932,7 +32024,7 @@ approach to debug a program as described in @ref{26,,Running and Debugging Ada Programs}. @node Setting Stack Size from gnatlink,Setting Heap Size from gnatlink,Debugging a DLL,Mixed-Language Programming on Windows -@anchor{gnat_ugn/platform_specific_information setting-stack-size-from-gnatlink}@anchor{13a}@anchor{gnat_ugn/platform_specific_information id40}@anchor{2a8} +@anchor{gnat_ugn/platform_specific_information setting-stack-size-from-gnatlink}@anchor{13a}@anchor{gnat_ugn/platform_specific_information id40}@anchor{2ac} @subsubsection Setting Stack Size from @emph{gnatlink} @@ -31975,7 +32067,7 @@ because the coma is a separator for this option. @end itemize @node Setting Heap Size from gnatlink,,Setting Stack Size from gnatlink,Mixed-Language Programming on Windows -@anchor{gnat_ugn/platform_specific_information setting-heap-size-from-gnatlink}@anchor{13b}@anchor{gnat_ugn/platform_specific_information id41}@anchor{2a9} +@anchor{gnat_ugn/platform_specific_information setting-heap-size-from-gnatlink}@anchor{13b}@anchor{gnat_ugn/platform_specific_information id41}@anchor{2ad} @subsubsection Setting Heap Size from @emph{gnatlink} @@ -32007,8 +32099,85 @@ This sets the heap reserve size to 0x1000000 bytes. Note that with because the coma is a separator for this option. @end itemize +@node Windows Specific Add-Ons,,Mixed-Language Programming on Windows,Microsoft Windows Topics +@anchor{gnat_ugn/platform_specific_information windows-specific-add-ons}@anchor{2ae}@anchor{gnat_ugn/platform_specific_information win32-specific-addons}@anchor{2af} +@subsection Windows Specific Add-Ons + + +This section describes the Windows specific add-ons. + +@menu +* Win32Ada:: +* wPOSIX:: + +@end menu + +@node Win32Ada,wPOSIX,,Windows Specific Add-Ons +@anchor{gnat_ugn/platform_specific_information win32ada}@anchor{2b0}@anchor{gnat_ugn/platform_specific_information id42}@anchor{2b1} +@subsubsection Win32Ada + + +Win32Ada is a binding for the Microsoft Win32 API. This binding can be +easily installed from the provided installer. To use the Win32Ada +binding you need to use a project file, and adding a single with_clause +will give you full access to the Win32Ada binding sources and ensure +that the proper libraries are passed to the linker. + +@quotation + +@example +with "win32ada"; +project P is + for Sources use ...; +end P; +@end example +@end quotation + +To build the application you just need to call gprbuild for the +application's project, here p.gpr: + +@quotation + +@example +gprbuild p.gpr +@end example +@end quotation + +@node wPOSIX,,Win32Ada,Windows Specific Add-Ons +@anchor{gnat_ugn/platform_specific_information id43}@anchor{2b2}@anchor{gnat_ugn/platform_specific_information wposix}@anchor{2b3} +@subsubsection wPOSIX + + +wPOSIX is a minimal POSIX binding whose goal is to help with building +cross-platforms applications. This binding is not complete though, as +the Win32 API does not provide the necessary support for all POSIX APIs. + +To use the wPOSIX binding you need to use a project file, and adding +a single with_clause will give you full access to the wPOSIX binding +sources and ensure that the proper libraries are passed to the linker. + +@quotation + +@example +with "wposix"; +project P is + for Sources use ...; +end P; +@end example +@end quotation + +To build the application you just need to call gprbuild for the +application's project, here p.gpr: + +@quotation + +@example +gprbuild p.gpr +@end example +@end quotation + @node Mac OS Topics,,Microsoft Windows Topics,Platform-Specific Information -@anchor{gnat_ugn/platform_specific_information mac-os-topics}@anchor{2f}@anchor{gnat_ugn/platform_specific_information id42}@anchor{2aa} +@anchor{gnat_ugn/platform_specific_information mac-os-topics}@anchor{2f}@anchor{gnat_ugn/platform_specific_information id44}@anchor{2b4} @section Mac OS Topics @@ -32023,7 +32192,7 @@ platform. @end menu @node Codesigning the Debugger,,,Mac OS Topics -@anchor{gnat_ugn/platform_specific_information codesigning-the-debugger}@anchor{2ab} +@anchor{gnat_ugn/platform_specific_information codesigning-the-debugger}@anchor{2b5} @subsection Codesigning the Debugger @@ -32104,7 +32273,7 @@ the location where you installed GNAT. Also, be sure that users are in the Unix group @code{_developer}. @node Example of Binder Output File,Elaboration Order Handling in GNAT,Platform-Specific Information,Top -@anchor{gnat_ugn/example_of_binder_output example-of-binder-output-file}@anchor{10}@anchor{gnat_ugn/example_of_binder_output doc}@anchor{2ac}@anchor{gnat_ugn/example_of_binder_output id1}@anchor{2ad} +@anchor{gnat_ugn/example_of_binder_output example-of-binder-output-file}@anchor{10}@anchor{gnat_ugn/example_of_binder_output doc}@anchor{2b6}@anchor{gnat_ugn/example_of_binder_output id1}@anchor{2b7} @chapter Example of Binder Output File @@ -32856,7 +33025,7 @@ elaboration code in your own application). @c -- Example: A |withing| unit has a |with| clause, it |withs| a |withed| unit @node Elaboration Order Handling in GNAT,Inline Assembler,Example of Binder Output File,Top -@anchor{gnat_ugn/elaboration_order_handling_in_gnat elaboration-order-handling-in-gnat}@anchor{11}@anchor{gnat_ugn/elaboration_order_handling_in_gnat doc}@anchor{2ae}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id1}@anchor{2af} +@anchor{gnat_ugn/elaboration_order_handling_in_gnat elaboration-order-handling-in-gnat}@anchor{11}@anchor{gnat_ugn/elaboration_order_handling_in_gnat doc}@anchor{2b8}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id1}@anchor{2b9} @chapter Elaboration Order Handling in GNAT @@ -32888,7 +33057,7 @@ features. @end menu @node Elaboration Code,Checking the Elaboration Order,,Elaboration Order Handling in GNAT -@anchor{gnat_ugn/elaboration_order_handling_in_gnat elaboration-code}@anchor{2b0}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id2}@anchor{2b1} +@anchor{gnat_ugn/elaboration_order_handling_in_gnat elaboration-code}@anchor{2ba}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id2}@anchor{2bb} @section Elaboration Code @@ -33038,7 +33207,7 @@ to figure out which of these expressions will be true, and hence it is impossible to guarantee a safe order of elaboration at run time. @node Checking the Elaboration Order,Controlling the Elaboration Order,Elaboration Code,Elaboration Order Handling in GNAT -@anchor{gnat_ugn/elaboration_order_handling_in_gnat checking-the-elaboration-order}@anchor{2b2}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id3}@anchor{2b3} +@anchor{gnat_ugn/elaboration_order_handling_in_gnat checking-the-elaboration-order}@anchor{2bc}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id3}@anchor{2bd} @section Checking the Elaboration Order @@ -33142,7 +33311,7 @@ does such optimizations, but still the easiest conceptual model is to think of there being one variable per subprogram. @node Controlling the Elaboration Order,Controlling Elaboration in GNAT - Internal Calls,Checking the Elaboration Order,Elaboration Order Handling in GNAT -@anchor{gnat_ugn/elaboration_order_handling_in_gnat id4}@anchor{2b4}@anchor{gnat_ugn/elaboration_order_handling_in_gnat controlling-the-elaboration-order}@anchor{2b5} +@anchor{gnat_ugn/elaboration_order_handling_in_gnat id4}@anchor{2be}@anchor{gnat_ugn/elaboration_order_handling_in_gnat controlling-the-elaboration-order}@anchor{2bf} @section Controlling the Elaboration Order @@ -33401,7 +33570,7 @@ code in the body makes calls to some other unit, so it is still necessary to use @cite{Elaborate_All} on such units. @node Controlling Elaboration in GNAT - Internal Calls,Controlling Elaboration in GNAT - External Calls,Controlling the Elaboration Order,Elaboration Order Handling in GNAT -@anchor{gnat_ugn/elaboration_order_handling_in_gnat id5}@anchor{2b6}@anchor{gnat_ugn/elaboration_order_handling_in_gnat controlling-elaboration-in-gnat-internal-calls}@anchor{2b7} +@anchor{gnat_ugn/elaboration_order_handling_in_gnat id5}@anchor{2c0}@anchor{gnat_ugn/elaboration_order_handling_in_gnat controlling-elaboration-in-gnat-internal-calls}@anchor{2c1} @section Controlling Elaboration in GNAT - Internal Calls @@ -33581,7 +33750,7 @@ guaranteed) for a program to be able to call a subprogram whose body is not yet elaborated, without raising a @cite{Program_Error} exception. @node Controlling Elaboration in GNAT - External Calls,Default Behavior in GNAT - Ensuring Safety,Controlling Elaboration in GNAT - Internal Calls,Elaboration Order Handling in GNAT -@anchor{gnat_ugn/elaboration_order_handling_in_gnat id6}@anchor{2b8}@anchor{gnat_ugn/elaboration_order_handling_in_gnat controlling-elaboration-in-gnat-external-calls}@anchor{2b9} +@anchor{gnat_ugn/elaboration_order_handling_in_gnat id6}@anchor{2c2}@anchor{gnat_ugn/elaboration_order_handling_in_gnat controlling-elaboration-in-gnat-external-calls}@anchor{2c3} @section Controlling Elaboration in GNAT - External Calls @@ -33689,7 +33858,7 @@ provides a number of facilities for assisting the programmer in developing programs that are robust with respect to elaboration order. @node Default Behavior in GNAT - Ensuring Safety,Treatment of Pragma Elaborate,Controlling Elaboration in GNAT - External Calls,Elaboration Order Handling in GNAT -@anchor{gnat_ugn/elaboration_order_handling_in_gnat id7}@anchor{2ba}@anchor{gnat_ugn/elaboration_order_handling_in_gnat default-behavior-in-gnat-ensuring-safety}@anchor{2bb} +@anchor{gnat_ugn/elaboration_order_handling_in_gnat id7}@anchor{2c4}@anchor{gnat_ugn/elaboration_order_handling_in_gnat default-behavior-in-gnat-ensuring-safety}@anchor{2c5} @section Default Behavior in GNAT - Ensuring Safety @@ -33791,7 +33960,7 @@ is clearly safer to rely on compile and link time checks rather than run-time checks. However, in the case of legacy code, it may be difficult to meet the requirements of the static model. This issue is further discussed in -@ref{2bc,,What to Do If the Default Elaboration Behavior Fails}. +@ref{2c6,,What to Do If the Default Elaboration Behavior Fails}. Note that the static model provides a strict subset of the allowed behavior and programs of the Ada Reference Manual, so if you do @@ -33801,7 +33970,7 @@ work using the dynamic model, providing that you remove any pragma Elaborate statements from the source. @node Treatment of Pragma Elaborate,Elaboration Issues for Library Tasks,Default Behavior in GNAT - Ensuring Safety,Elaboration Order Handling in GNAT -@anchor{gnat_ugn/elaboration_order_handling_in_gnat treatment-of-pragma-elaborate}@anchor{2bd}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id8}@anchor{2be} +@anchor{gnat_ugn/elaboration_order_handling_in_gnat treatment-of-pragma-elaborate}@anchor{2c7}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id8}@anchor{2c8} @section Treatment of Pragma Elaborate @@ -33840,7 +34009,7 @@ When using the static mode with @emph{-gnatwl}, any use of problems. @node Elaboration Issues for Library Tasks,Mixing Elaboration Models,Treatment of Pragma Elaborate,Elaboration Order Handling in GNAT -@anchor{gnat_ugn/elaboration_order_handling_in_gnat elaboration-issues-for-library-tasks}@anchor{2bf}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id9}@anchor{2c0} +@anchor{gnat_ugn/elaboration_order_handling_in_gnat elaboration-issues-for-library-tasks}@anchor{2c9}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id9}@anchor{2ca} @section Elaboration Issues for Library Tasks @@ -34203,7 +34372,7 @@ no task receives an entry call before elaboration of all units is completed. @end itemize @node Mixing Elaboration Models,What to Do If the Default Elaboration Behavior Fails,Elaboration Issues for Library Tasks,Elaboration Order Handling in GNAT -@anchor{gnat_ugn/elaboration_order_handling_in_gnat id10}@anchor{2c1}@anchor{gnat_ugn/elaboration_order_handling_in_gnat mixing-elaboration-models}@anchor{2c2} +@anchor{gnat_ugn/elaboration_order_handling_in_gnat id10}@anchor{2cb}@anchor{gnat_ugn/elaboration_order_handling_in_gnat mixing-elaboration-models}@anchor{2cc} @section Mixing Elaboration Models @@ -34268,7 +34437,7 @@ allowing the main application that uses this subsystem to be compiled using the more reliable default static model. @node What to Do If the Default Elaboration Behavior Fails,Elaboration for Indirect Calls,Mixing Elaboration Models,Elaboration Order Handling in GNAT -@anchor{gnat_ugn/elaboration_order_handling_in_gnat id11}@anchor{2c3}@anchor{gnat_ugn/elaboration_order_handling_in_gnat what-to-do-if-the-default-elaboration-behavior-fails}@anchor{2bc} +@anchor{gnat_ugn/elaboration_order_handling_in_gnat id11}@anchor{2cd}@anchor{gnat_ugn/elaboration_order_handling_in_gnat what-to-do-if-the-default-elaboration-behavior-fails}@anchor{2c6} @section What to Do If the Default Elaboration Behavior Fails @@ -34379,7 +34548,7 @@ all subprograms declared in this spec. @item Use Pragma Elaborate. -As previously described in section @ref{2bd,,Treatment of Pragma Elaborate}, +As previously described in section @ref{2c7,,Treatment of Pragma Elaborate}, GNAT in static mode assumes that a @cite{pragma} Elaborate indicates correctly that no elaboration checks are required on calls to the designated unit. There may be cases in which the caller knows that no transitive calls @@ -34512,7 +34681,7 @@ C-tests are indeed correct (it is less efficient, but efficiency is not a factor in running the ACATS tests.) @node Elaboration for Indirect Calls,Summary of Procedures for Elaboration Control,What to Do If the Default Elaboration Behavior Fails,Elaboration Order Handling in GNAT -@anchor{gnat_ugn/elaboration_order_handling_in_gnat id12}@anchor{2c4}@anchor{gnat_ugn/elaboration_order_handling_in_gnat elaboration-for-indirect-calls}@anchor{2c5} +@anchor{gnat_ugn/elaboration_order_handling_in_gnat id12}@anchor{2ce}@anchor{gnat_ugn/elaboration_order_handling_in_gnat elaboration-for-indirect-calls}@anchor{2cf} @section Elaboration for Indirect Calls @@ -34541,7 +34710,7 @@ adding an indirect call can cause erroneous behavior in the presence of @emph{-gnatd.U}. @node Summary of Procedures for Elaboration Control,Other Elaboration Order Considerations,Elaboration for Indirect Calls,Elaboration Order Handling in GNAT -@anchor{gnat_ugn/elaboration_order_handling_in_gnat id13}@anchor{2c6}@anchor{gnat_ugn/elaboration_order_handling_in_gnat summary-of-procedures-for-elaboration-control}@anchor{2c7} +@anchor{gnat_ugn/elaboration_order_handling_in_gnat id13}@anchor{2d0}@anchor{gnat_ugn/elaboration_order_handling_in_gnat summary-of-procedures-for-elaboration-control}@anchor{2d1} @section Summary of Procedures for Elaboration Control @@ -34565,7 +34734,7 @@ and, if you are sure there really are no elaboration problems, use a global pragma @cite{Suppress (Elaboration_Check)}. @node Other Elaboration Order Considerations,Determining the Chosen Elaboration Order,Summary of Procedures for Elaboration Control,Elaboration Order Handling in GNAT -@anchor{gnat_ugn/elaboration_order_handling_in_gnat id14}@anchor{2c8}@anchor{gnat_ugn/elaboration_order_handling_in_gnat other-elaboration-order-considerations}@anchor{2c9} +@anchor{gnat_ugn/elaboration_order_handling_in_gnat id14}@anchor{2d2}@anchor{gnat_ugn/elaboration_order_handling_in_gnat other-elaboration-order-considerations}@anchor{2d3} @section Other Elaboration Order Considerations @@ -34712,7 +34881,7 @@ and figuring out which is correct, and then adding the necessary @cite{Elaborate} or @cite{Elaborate_All} pragmas to ensure the desired order. @node Determining the Chosen Elaboration Order,,Other Elaboration Order Considerations,Elaboration Order Handling in GNAT -@anchor{gnat_ugn/elaboration_order_handling_in_gnat determining-the-chosen-elaboration-order}@anchor{2ca}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id15}@anchor{2cb} +@anchor{gnat_ugn/elaboration_order_handling_in_gnat determining-the-chosen-elaboration-order}@anchor{2d4}@anchor{gnat_ugn/elaboration_order_handling_in_gnat id15}@anchor{2d5} @section Determining the Chosen Elaboration Order @@ -34852,7 +35021,7 @@ gdbstr (body) @end example @node Inline Assembler,GNU Free Documentation License,Elaboration Order Handling in GNAT,Top -@anchor{gnat_ugn/inline_assembler inline-assembler}@anchor{12}@anchor{gnat_ugn/inline_assembler doc}@anchor{2cc}@anchor{gnat_ugn/inline_assembler id1}@anchor{2cd} +@anchor{gnat_ugn/inline_assembler inline-assembler}@anchor{12}@anchor{gnat_ugn/inline_assembler doc}@anchor{2d6}@anchor{gnat_ugn/inline_assembler id1}@anchor{2d7} @chapter Inline Assembler @@ -34911,7 +35080,7 @@ and with assembly language programming. @end menu @node Basic Assembler Syntax,A Simple Example of Inline Assembler,,Inline Assembler -@anchor{gnat_ugn/inline_assembler id2}@anchor{2ce}@anchor{gnat_ugn/inline_assembler basic-assembler-syntax}@anchor{2cf} +@anchor{gnat_ugn/inline_assembler id2}@anchor{2d8}@anchor{gnat_ugn/inline_assembler basic-assembler-syntax}@anchor{2d9} @section Basic Assembler Syntax @@ -35027,7 +35196,7 @@ Intel: Destination first; for example @cite{mov eax@comma{} 4}@w{ } @node A Simple Example of Inline Assembler,Output Variables in Inline Assembler,Basic Assembler Syntax,Inline Assembler -@anchor{gnat_ugn/inline_assembler a-simple-example-of-inline-assembler}@anchor{2d0}@anchor{gnat_ugn/inline_assembler id3}@anchor{2d1} +@anchor{gnat_ugn/inline_assembler a-simple-example-of-inline-assembler}@anchor{2da}@anchor{gnat_ugn/inline_assembler id3}@anchor{2db} @section A Simple Example of Inline Assembler @@ -35176,7 +35345,7 @@ If there are no errors, @emph{as} will generate an object file @code{nothing.out}. @node Output Variables in Inline Assembler,Input Variables in Inline Assembler,A Simple Example of Inline Assembler,Inline Assembler -@anchor{gnat_ugn/inline_assembler id4}@anchor{2d2}@anchor{gnat_ugn/inline_assembler output-variables-in-inline-assembler}@anchor{2d3} +@anchor{gnat_ugn/inline_assembler id4}@anchor{2dc}@anchor{gnat_ugn/inline_assembler output-variables-in-inline-assembler}@anchor{2dd} @section Output Variables in Inline Assembler @@ -35543,7 +35712,7 @@ end Get_Flags_3; @end quotation @node Input Variables in Inline Assembler,Inlining Inline Assembler Code,Output Variables in Inline Assembler,Inline Assembler -@anchor{gnat_ugn/inline_assembler id5}@anchor{2d4}@anchor{gnat_ugn/inline_assembler input-variables-in-inline-assembler}@anchor{2d5} +@anchor{gnat_ugn/inline_assembler id5}@anchor{2de}@anchor{gnat_ugn/inline_assembler input-variables-in-inline-assembler}@anchor{2df} @section Input Variables in Inline Assembler @@ -35632,7 +35801,7 @@ _increment__incr.1: @end quotation @node Inlining Inline Assembler Code,Other Asm Functionality,Input Variables in Inline Assembler,Inline Assembler -@anchor{gnat_ugn/inline_assembler id6}@anchor{2d6}@anchor{gnat_ugn/inline_assembler inlining-inline-assembler-code}@anchor{2d7} +@anchor{gnat_ugn/inline_assembler id6}@anchor{2e0}@anchor{gnat_ugn/inline_assembler inlining-inline-assembler-code}@anchor{2e1} @section Inlining Inline Assembler Code @@ -35703,7 +35872,7 @@ movl %esi,%eax thus saving the overhead of stack frame setup and an out-of-line call. @node Other Asm Functionality,,Inlining Inline Assembler Code,Inline Assembler -@anchor{gnat_ugn/inline_assembler other-asm-functionality}@anchor{2d8}@anchor{gnat_ugn/inline_assembler id7}@anchor{2d9} +@anchor{gnat_ugn/inline_assembler other-asm-functionality}@anchor{2e2}@anchor{gnat_ugn/inline_assembler id7}@anchor{2e3} @section Other @cite{Asm} Functionality @@ -35718,7 +35887,7 @@ and @cite{Volatile}, which inhibits unwanted optimizations. @end menu @node The Clobber Parameter,The Volatile Parameter,,Other Asm Functionality -@anchor{gnat_ugn/inline_assembler the-clobber-parameter}@anchor{2da}@anchor{gnat_ugn/inline_assembler id8}@anchor{2db} +@anchor{gnat_ugn/inline_assembler the-clobber-parameter}@anchor{2e4}@anchor{gnat_ugn/inline_assembler id8}@anchor{2e5} @subsection The @cite{Clobber} Parameter @@ -35782,7 +35951,7 @@ Use 'register' name @cite{memory} if you changed a memory location @end itemize @node The Volatile Parameter,,The Clobber Parameter,Other Asm Functionality -@anchor{gnat_ugn/inline_assembler the-volatile-parameter}@anchor{2dc}@anchor{gnat_ugn/inline_assembler id9}@anchor{2dd} +@anchor{gnat_ugn/inline_assembler the-volatile-parameter}@anchor{2e6}@anchor{gnat_ugn/inline_assembler id9}@anchor{2e7} @subsection The @cite{Volatile} Parameter @@ -35818,7 +35987,7 @@ to @cite{True} only if the compiler's optimizations have created problems. @node GNU Free Documentation License,Index,Inline Assembler,Top -@anchor{share/gnu_free_documentation_license gnu-fdl}@anchor{1}@anchor{share/gnu_free_documentation_license doc}@anchor{2de}@anchor{share/gnu_free_documentation_license gnu-free-documentation-license}@anchor{2df} +@anchor{share/gnu_free_documentation_license gnu-fdl}@anchor{1}@anchor{share/gnu_free_documentation_license doc}@anchor{2e8}@anchor{share/gnu_free_documentation_license gnu-free-documentation-license}@anchor{2e9} @chapter GNU Free Documentation License -- 2.30.2