From: Arnaud Charlet Date: Tue, 25 Apr 2017 15:59:28 +0000 (+0000) Subject: gnat_rm.texi, [...]: Update documentation. X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=9c533e7dfb45334395ad4aeefdfa5b4740d5c1dc;p=gcc.git gnat_rm.texi, [...]: Update documentation. * gnat_rm.texi, gnat_ugn.texi, doc/gnat_ugn/building_executable_programs_with_gnat.rst, doc/gnat_ugn/platform_specific_information.rst, doc/gnat_ugn/gnat_and_program_execution.rst, doc/gnat_ugn/gnat_utility_programs.rst, doc/gnat_ugn/the_gnat_compilation_model.rst, doc/gnat_rm/implementation_defined_attributes.rst, doc/gnat_rm/the_gnat_library.rst, doc/gnat_rm/implementation_defined_pragmas.rst, doc/gnat_rm/representation_clauses_and_pragmas.rst, doc/gnat_rm/implementation_of_specific_ada_features.rst, doc/gnat_rm/implementation_defined_aspects.rst, doc/gnat_rm/implementation_defined_characteristics.rst: Update documentation. From-SVN: r247253 --- diff --git a/gcc/ada/ChangeLog b/gcc/ada/ChangeLog index c31446dd2c5..c2bd56207dd 100644 --- a/gcc/ada/ChangeLog +++ b/gcc/ada/ChangeLog @@ -1,3 +1,20 @@ +2017-04-25 Arnaud Charlet + + * gnat_rm.texi, gnat_ugn.texi, + doc/gnat_ugn/building_executable_programs_with_gnat.rst, + doc/gnat_ugn/platform_specific_information.rst, + doc/gnat_ugn/gnat_and_program_execution.rst, + doc/gnat_ugn/gnat_utility_programs.rst, + doc/gnat_ugn/the_gnat_compilation_model.rst, + doc/gnat_rm/implementation_defined_attributes.rst, + doc/gnat_rm/the_gnat_library.rst, + doc/gnat_rm/implementation_defined_pragmas.rst, + doc/gnat_rm/representation_clauses_and_pragmas.rst, + doc/gnat_rm/implementation_of_specific_ada_features.rst, + doc/gnat_rm/implementation_defined_aspects.rst, + doc/gnat_rm/implementation_defined_characteristics.rst: Update + documentation. + 2017-04-25 Arnaud Charlet * exp_ch4.adb (Expand_N_Case_Expression): Emit error message when diff --git a/gcc/ada/doc/gnat_rm/implementation_defined_aspects.rst b/gcc/ada/doc/gnat_rm/implementation_defined_aspects.rst index 8d1cf7468bd..0fd528dc54e 100644 --- a/gcc/ada/doc/gnat_rm/implementation_defined_aspects.rst +++ b/gcc/ada/doc/gnat_rm/implementation_defined_aspects.rst @@ -66,8 +66,9 @@ Aspect Abstract_State This aspect is equivalent to :ref:`pragma Abstract_State`. -Annotate -======== +Aspect Annotate +=============== + .. index:: Annotate There are three forms of this aspect (where ID is an identifier, @@ -147,7 +148,7 @@ used when doing formatted output of dimensioned quantities. The syntax is:: This aspect can only be applied to a subtype whose parent type has -a `Dimension_Systen` aspect. The aspect must specify values for +a `Dimension_System` aspect. The aspect must specify values for all dimensions of the system. The rational values are the powers of the corresponding dimensions that are used by the compiler to verify that physical (numeric) computations are dimensionally consistent. For example, @@ -361,7 +362,6 @@ This boolean aspect is equivalent to :ref:`pragma Lock_Free`. Aspect Max_Queue_Length ======================= - .. index:: Max_Queue_Length This aspect is equivalent to :ref:`pragma Max_Queue_Length`. diff --git a/gcc/ada/doc/gnat_rm/implementation_defined_attributes.rst b/gcc/ada/doc/gnat_rm/implementation_defined_attributes.rst index c813afd5973..38731f3cab1 100644 --- a/gcc/ada/doc/gnat_rm/implementation_defined_attributes.rst +++ b/gcc/ada/doc/gnat_rm/implementation_defined_attributes.rst @@ -1168,7 +1168,7 @@ used in contexts (e.g., preelaborable packages) which require a static expression and where the function call could not be used (since the function call is always nonstatic, even if its argument is static). The argument must be in the range --(2**(m-1) .. 2**m-1, where m is the memory size +-(2**(m-1)) .. 2**m-1, where m is the memory size (typically 32 or 64). Negative values are intepreted in a modular manner (e.g., -1 means the same as 16#FFFF_FFFF# on a 32 bits machine). diff --git a/gcc/ada/doc/gnat_rm/implementation_defined_characteristics.rst b/gcc/ada/doc/gnat_rm/implementation_defined_characteristics.rst index 68c5039b41c..10c4a09f0bf 100644 --- a/gcc/ada/doc/gnat_rm/implementation_defined_characteristics.rst +++ b/gcc/ada/doc/gnat_rm/implementation_defined_characteristics.rst @@ -986,13 +986,13 @@ The policy is the same as that of the underlying threads implementation. in a pragma `Locking_Policy`. See D.3(4)." The two implementation defined policies permitted in GNAT are -`Inheritance_Locking` and `Conccurent_Readers_Locking`. On +`Inheritance_Locking` and `Concurrent_Readers_Locking`. On targets that support the `Inheritance_Locking` policy, locking is implemented by inheritance, i.e., the task owning the lock operates at a priority equal to the highest priority of any task currently -requesting the lock. On targets that support the -`Conccurent_Readers_Locking` policy, locking is implemented with a -read/write lock allowing multiple propected object functions to enter +requesting the lock. On targets that support the +`Concurrent_Readers_Locking` policy, locking is implemented with a +read/write lock allowing multiple protected object functions to enter concurrently. * diff --git a/gcc/ada/doc/gnat_rm/implementation_defined_pragmas.rst b/gcc/ada/doc/gnat_rm/implementation_defined_pragmas.rst index b243c8ed1c1..e5f0c82ea5e 100644 --- a/gcc/ada/doc/gnat_rm/implementation_defined_pragmas.rst +++ b/gcc/ada/doc/gnat_rm/implementation_defined_pragmas.rst @@ -564,7 +564,7 @@ Syntax: .. code-block:: ada - pragma Asynch_Readers [ (boolean_EXPRESSION) ]; + pragma Asynch_Readers [ (boolean_EXPRESSION) ]; For the semantics of this pragma, see the entry for aspect `Async_Readers` in the SPARK 2014 Reference Manual, section 7.1.2. @@ -578,7 +578,7 @@ Syntax: .. code-block:: ada - pragma Asynch_Writers [ (boolean_EXPRESSION) ]; + pragma Asynch_Writers [ (boolean_EXPRESSION) ]; For the semantics of this pragma, see the entry for aspect `Async_Writers` in the SPARK 2014 Reference Manual, section 7.1.2. @@ -1203,9 +1203,9 @@ following is an example of use within a package spec: package Math_Functions is ... function Sqrt (Arg : Float) return Float; - pragma Contract_Cases ((Arg in 0 .. 99) => Sqrt'Result < 10, - Arg >= 100 => Sqrt'Result >= 10, - others => Sqrt'Result = 0); + pragma Contract_Cases (((Arg in 0.0 .. 99.0) => Sqrt'Result < 10.0, + Arg >= 100.0 => Sqrt'Result >= 10.0, + others => Sqrt'Result = 0.0)); ... end Math_Functions; @@ -1380,6 +1380,21 @@ This pragma is standard in Ada 2012, but is available in all earlier versions of Ada as an implementation-defined pragma. See Ada 2012 Reference Manual for details. +Pragma Deadline_Floor +===================== + +Syntax: + + +.. code-block:: ada + + pragma Deadline_Floor (time_span_EXPRESSION); + + +This pragma applies only to protected types and specifies the floor +deadline inherited by a task when the task enters a protected object. +It is effective only when the EDF scheduling policy is used. + .. _Pragma-Default_Initial_Condition: Pragma Default_Initial_Condition @@ -1628,7 +1643,7 @@ Syntax: .. code-block:: ada - pragma Effective_Reads [ (boolean_EXPRESSION) ]; + pragma Effective_Reads [ (boolean_EXPRESSION) ]; For the semantics of this pragma, see the entry for aspect `Effective_Reads` in the SPARK 2014 Reference Manual, section 7.1.2. @@ -2248,14 +2263,13 @@ Syntax: pragma Favor_Top_Level (type_NAME); -The named type must be an access-to-subprogram type. This pragma is an -efficiency hint to the compiler, regarding the use of 'Access or -'Unrestricted_Access on nested (non-library-level) subprograms. The -pragma means that nested subprograms are not used with this type, or -are rare, so that the generated code should be efficient in the -top-level case. When this pragma is used, dynamically generated -trampolines may be used on some targets for nested subprograms. -See also the No_Implicit_Dynamic_Code restriction. +The argument of pragma `Favor_Top_Level` must be a named access-to-subprogram +type. This pragma is an efficiency hint to the compiler, regarding the use of +`'Access` or `'Unrestricted_Access` on nested (non-library-level) subprograms. +The pragma means that nested subprograms are not used with this type, or are +rare, so that the generated code should be efficient in the top-level case. +When this pragma is used, dynamically generated trampolines may be used on some +targets for nested subprograms. See restriction `No_Implicit_Dynamic_Code`. Pragma Finalize_Storage_Only ============================ @@ -2268,11 +2282,14 @@ Syntax: pragma Finalize_Storage_Only (first_subtype_LOCAL_NAME); -This pragma allows the compiler not to emit a Finalize call for objects -defined at the library level. This is mostly useful for types where -finalization is only used to deal with storage reclamation since in most -environments it is not necessary to reclaim memory just before terminating -execution, hence the name. +The argument of pragma `Finalize_Storage_Only` must denote a local type which +is derived from `Ada.Finalization.Controlled` or `Limited_Controlled`. The +pragma suppresses the call to `Finalize` for declared library-level objects +of the argument type. This is mostly useful for types where finalization is +only used to deal with storage reclamation since in most environments it is +not necessary to reclaim memory just before terminating execution, hence the +name. Note that this pragma does not suppress Finalize calls for library-level +heap-allocated objects (see pragma `No_Heap_Finalization`). Pragma Float_Representation =========================== @@ -2849,9 +2866,13 @@ Syntax: pragma Inline_Always (NAME [, NAME]); -Similar to pragma `Inline` except that inlining is not subject to -the use of option *-gnatn* or *-gnatN* and the inlining -happens regardless of whether these options are used. +Similar to pragma `Inline` except that inlining is unconditional. +Inline_Always instructs the compiler to inline every direct call to the +subprogram or else to emit a compilation error, independently of any +option, in particular *-gnatn* or *-gnatN* or the optimization level. +It is an error to take the address or access of `NAME`. It is also an error to +apply this pragma to a primitive operation of a tagged type. Thanks to such +restrictions, the compiler is allowed to remove the out-of-line body of `NAME`. Pragma Inline_Generic ===================== @@ -2974,7 +2995,9 @@ Interrupts can be in one of three states: The interrupt is reserved (no Ada handler can be installed), and the Ada run-time may not install a handler. As a result you are guaranteed - standard system default action if this interrupt is raised. + standard system default action if this interrupt is raised. This also allows + installing a low level handler via C APIs such as sigaction(), outside + of Ada control. * Runtime @@ -2984,7 +3007,8 @@ Interrupts can be in one of three states: * User - The interrupt is unreserved. The user may install a handler to provide + The interrupt is unreserved. The user may install an Ada handler via + Ada.Interrupts and pragma Interrupt_Handler or Attach_Handler to provide some other action. These states are the allowed values of the `State` parameter of the @@ -3614,12 +3638,44 @@ Syntax: This is a program unit pragma (there is also an equivalent aspect of the same name) that establishes the restriction `No_Elaboration_Code` for -the current unit and any extended main source units (body and subunits. -It also has has the effect of enforcing a transitive application of this -aspect, so that if any unit is implicitly or explicitly WITH'ed by the +the current unit and any extended main source units (body and subunits). +It also has the effect of enforcing a transitive application of this +aspect, so that if any unit is implicitly or explicitly with'ed by the current unit, it must also have the No_Elaboration_Code_All aspect set. It may be applied to package or subprogram specs or their generic versions. +Pragma No_Heap_Finalization +=========================== + +Syntax: + + +:: + + pragma No_Heap_Finalization [ (first_subtype_LOCAL_NAME) ]; + + +Pragma `No_Heap_Finalization` may be used as a configuration pragma or as a +type-specific pragma. + +In its configuration form, the pragma must appear within a configuration file +such as gnat.adc, without an argument. The pragma suppresses the call to +`Finalize` for heap-allocated objects created through library-level named +access-to-object types in cases where the designated type requires finalization +actions. + +In its type-specific form, the argument of the pragma must denote a +library-level named access-to-object type. The pragma suppresses the call to +`Finalize` for heap-allocated objects created through the specific access type +in cases where the designated type requires finalization actions. + +It is still possible to finalize such heap-allocated objects by explicitly +deallocating them. + +A library-level named access-to-object type declared within a generic unit will +lose its `No_Heap_Finalization` pragma when the corresponding instance does not +appear at the library level. + Pragma No_Inline ================ @@ -4855,14 +4911,16 @@ Syntax: .. code-block:: ada - pragma Profile (Ravenscar | Restricted | Rational | GNAT_Extended_Ravenscar); + pragma Profile (Ravenscar | Restricted | Rational | + GNAT_Extended_Ravenscar | GNAT_Ravenscar_EDF ); This pragma is standard in Ada 2005, but is available in all earlier versions of Ada as an implementation-defined pragma. This is a configuration pragma that establishes a set of configuration pragmas that depend on the argument. `Ravenscar` is standard in Ada 2005. -The other possibilities (`Restricted`, `Rational`, `GNAT_Extended_Ravenscar`) +The other possibilities (`Restricted`, `Rational`, +`GNAT_Extended_Ravenscar`, `GNAT_Ravenscar_EDF`) are implementation-defined. The set of configuration pragmas is defined in the following sections. @@ -4992,6 +5050,11 @@ is defined in the following sections. The ``Max_Protected_Entries``, ``Max_Entry_Queue_Length``, and ``No_Relative_Delay`` restrictions have been removed. +* Pragma Profile (GNAT_Ravenscar_EDF) + + This profile corresponds to the Ravenscar profile but using + EDF_Across_Priority as the Task_Scheduling_Policy. + * Pragma Profile (Restricted) This profile corresponds to the GNAT restricted run time. It @@ -5536,26 +5599,26 @@ Syntax: pragma Secondary_Stack_Size (integer_EXPRESSION); -This pragma appears within the task definition of a single task declaration -or a task type declaration (like pragma `Storage_Size`) and applies to all -task objects of that type. The argument specifies the size of the secondary +This pragma appears within the task definition of a single task declaration +or a task type declaration (like pragma `Storage_Size`) and applies to all +task objects of that type. The argument specifies the size of the secondary stack to be used by these task objects, and must be of an integer type. The -secondary stack is used to handle functions that return a variable-sized +secondary stack is used to handle functions that return a variable-sized result, for example a function returning an unconstrained String. Note this pragma only applies to targets using fixed secondary stacks, like -VxWorks 653 and bare board targets, where a fixed block for the +VxWorks 653 and bare board targets, where a fixed block for the secondary stack is allocated from the primary stack of the task. By default, these targets assign a percentage of the primary stack for the secondary stack, -as defined by `System.Parameter.Sec_Stack_Percentage`. With this pragma, +as defined by `System.Parameter.Sec_Stack_Percentage`. With this pragma, an `integer_EXPRESSION` of bytes is assigned from the primary stack instead. -For most targets, the pragma does not apply as the secondary stack grows on -demand: allocated as a chain of blocks in the heap. The default size of these -blocks can be modified via the `-D` binder option as described in +For most targets, the pragma does not apply as the secondary stack grows on +demand: allocated as a chain of blocks in the heap. The default size of these +blocks can be modified via the `-D` binder option as described in :title:`GNAT User's Guide`. -Note that no check is made to see if the secondary stack can fit inside the +Note that no check is made to see if the secondary stack can fit inside the primary stack. Note the pragma cannot appear when the restriction `No_Secondary_Stack` @@ -7384,6 +7447,10 @@ also be used at any point that a pragma is allowed, and it is permissible to have more than one such pragma in a file, allowing multiple encodings to appear within the same file. +However, note that the pragma cannot immediately precede the relevant +wide character, because then the previous encoding will still be in +effect, causing "illegal character" errors. + The argument can be an identifier or a character literal. In the identifier case, it is one of `HEX`, `UPPER`, `SHIFT_JIS`, `EUC`, `UTF8`, or `BRACKETS`. In the character literal diff --git a/gcc/ada/doc/gnat_rm/implementation_of_specific_ada_features.rst b/gcc/ada/doc/gnat_rm/implementation_of_specific_ada_features.rst index 4ba0926065b..979752fa409 100644 --- a/gcc/ada/doc/gnat_rm/implementation_of_specific_ada_features.rst +++ b/gcc/ada/doc/gnat_rm/implementation_of_specific_ada_features.rst @@ -285,6 +285,31 @@ Note that this simple scheme preserves the relative order of the tasks that were ready to execute in the priority queue where R has been placed at the end. +.. Support_for_Locking_Policies + +Support for Locking Policies +---------------------------- + +This section specifies which policies specified by pragma Locking_Policy +are supported on which platforms. + +GNAT supports the standard `Ceiling_Locking` policy, and the +implementation defined `Inheritance_Locking` and +`Concurrent_Readers_Locking` policies. + +`Ceiling_Locking` is supported on all platforms if the operating system +supports it. In particular, `Ceiling_Locking` is not supported on +VxWorks. +`Inheritance_Locking` is supported on +Linux, +Darwin (Mac OS X), +LynxOS 178, +and VxWorks. +`Concurrent_Readers_Locking` is supported on Linux. + +Note that on Linux, `Ceiling_Locking` requires the program to be running +with root privileges. Otherwise, the policy is ignored. + .. _GNAT_Implementation_of_Shared_Passive_Packages: GNAT Implementation of Shared Passive Packages diff --git a/gcc/ada/doc/gnat_rm/representation_clauses_and_pragmas.rst b/gcc/ada/doc/gnat_rm/representation_clauses_and_pragmas.rst index 0af4ce74ccb..72987b4688f 100644 --- a/gcc/ada/doc/gnat_rm/representation_clauses_and_pragmas.rst +++ b/gcc/ada/doc/gnat_rm/representation_clauses_and_pragmas.rst @@ -1576,10 +1576,9 @@ check Alignment_Check is suppressed, or if `pragma Restrictions (No_Elaboration_Code)` is in effect. It is also suppressed by default on non-strict alignment machines (such as the x86). -Finally, GNAT does not permit overlaying of objects of controlled types or -composite types containing a controlled component. In most cases, the compiler -can detect an attempt at such overlays and will generate a warning at compile -time and a Program_Error exception at run time. +Finally, GNAT does not permit overlaying of objects of class-wide types. In +most cases, the compiler can detect an attempt at such overlays and will +generate a warning at compile time and a Program_Error exception at run time. .. index:: Export diff --git a/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst b/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst index 5b8d930bf73..2c36592d058 100644 --- a/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst +++ b/gcc/ada/doc/gnat_ugn/building_executable_programs_with_gnat.rst @@ -2713,6 +2713,8 @@ of the pragma in the :title:`GNAT_Reference_manual`). * :samp:`-gnatw.h` (holes in record layouts) + * :samp:`-gnatw.j` (late primitives of tagged types) + * :samp:`-gnatw.k` (redefinition of names in standard) * :samp:`-gnatwl` (elaboration warnings) @@ -3186,6 +3188,24 @@ of the pragma in the :title:`GNAT_Reference_manual`). This switch disables warnings on use of obsolescent features. +.. index:: -gnatw.j (gcc) + +:samp:`-gnatw.j` + *Activate warnings on late declarations of tagged type primitives.* + + This switch activates warnings on visible primitives added to a + tagged type after deriving a private extension from it. + + +.. index:: -gnatw.J (gcc) + +:samp:`-gnatw.J` + *Suppress warnings on late declarations of tagged type primitives.* + + This switch suppresses warnings on visible primitives added to a + tagged type after deriving a private extension from it. + + .. index:: -gnatwk (gcc) :samp:`-gnatwk` @@ -6114,7 +6134,7 @@ be presented in subsequent sections. sized result, for example a function returning an unconstrained String. There are two ways in which this secondary stack is allocated. - For most targets, the secondary stack is growing on demand and is allocated + For most targets, the secondary stack grows on demand and is allocated as a chain of blocks in the heap. The -D option is not very relevant. It only give some control over the size of the allocated blocks (whose size is the minimum of the default secondary stack size value, 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 37c077e92d1..39becd673f1 100644 --- a/gcc/ada/doc/gnat_ugn/gnat_and_program_execution.rst +++ b/gcc/ada/doc/gnat_ugn/gnat_and_program_execution.rst @@ -3354,7 +3354,7 @@ and similarly for `Mass`, `Time`, `Electric_Current`, The package also defines conventional names for values of each unit, for example: - .. code-block":: ada + .. code-block:: ada m : constant Length := 1.0; kg : constant Mass := 1.0; diff --git a/gcc/ada/doc/gnat_ugn/gnat_utility_programs.rst b/gcc/ada/doc/gnat_ugn/gnat_utility_programs.rst index 062d6b90cdc..406455dd783 100644 --- a/gcc/ada/doc/gnat_ugn/gnat_utility_programs.rst +++ b/gcc/ada/doc/gnat_ugn/gnat_utility_programs.rst @@ -535,20 +535,20 @@ The following switches are available for *gnatxref*: .. index:: --version (gnatxref) -:samp:`-version` +:samp:`--version` Display Copyright and version, then exit disregarding all other options. .. index:: --help (gnatxref) -:samp:`-help` +:samp:`--help` If *--version* was not used, display usage, then exit disregarding all other options. .. index:: -a (gnatxref) -:samp:`a` +:samp:`-a` If this switch is present, `gnatfind` and `gnatxref` will parse the read-only files found in the library search path. Otherwise, these files will be ignored. This option can be used to protect Gnat sources or your own @@ -559,7 +559,7 @@ The following switches are available for *gnatxref*: .. index:: -aIDIR (gnatxref) -:samp:`aI{DIR}` +:samp:`-aI{DIR}` When looking for source files also look in directory DIR. The order in which source file search is undertaken is the same as for *gnatmake*. @@ -567,26 +567,26 @@ The following switches are available for *gnatxref*: .. index:: -aODIR (gnatxref) :samp:`aO{DIR}` - When searching for library and object files, look in directory + When -searching for library and object files, look in directory DIR. The order in which library files are searched is the same as for *gnatmake*. .. index:: -nostdinc (gnatxref) -:samp:`nostdinc` +:samp:`-nostdinc` Do not look for sources in the system default directory. .. index:: -nostdlib (gnatxref) -:samp:`nostdlib` +:samp:`-nostdlib` Do not look for library files in the system default directory. .. index:: --ext (gnatxref) -:samp:`-ext={extension}` +:samp:`--ext={extension}` Specify an alternate ali file extension. The default is `ali` and other extensions (e.g. `gli` for C/C++ sources when using *-fdump-xref*) may be specified via this switch. Note that if this switch overrides the @@ -595,21 +595,21 @@ The following switches are available for *gnatxref*: .. index:: --RTS (gnatxref) -:samp:`-RTS={rts-path}` +:samp:`--RTS={rts-path}` Specifies the default location of the runtime library. Same meaning as the equivalent *gnatmake* flag (:ref:`Switches_for_gnatmake`). .. index:: -d (gnatxref) -:samp:`d` +:samp:`-d` If this switch is set `gnatxref` will output the parent type reference for each matching derived types. .. index:: -f (gnatxref) -:samp:`f` +:samp:`-f` If this switch is set, the output file names will be preceded by their directory (if the file was found in the search path). If this switch is not set, the directory will not be printed. @@ -617,7 +617,7 @@ The following switches are available for *gnatxref*: .. index:: -g (gnatxref) -:samp:`g` +:samp:`-g` If this switch is set, information is output only for library-level entities, ignoring local entities. The use of this switch may accelerate `gnatfind` and `gnatxref`. @@ -625,30 +625,28 @@ The following switches are available for *gnatxref*: .. index:: -IDIR (gnatxref) -:samp:`I{DIR}` +:samp:`-I{DIR}` Equivalent to :samp:`-aODIR -aIDIR`. .. index:: -pFILE (gnatxref) -:samp:`p{FILE}` - Specify a project file to use. +:samp:`-p{FILE}` + Specify a configuration file to use to list the source and object directories. - By default, `gnatxref` and `gnatfind` will try to locate a - project file in the current directory. + If a file is specified, then the content of the source directory and object + directory lines are added as if they had been specified respectively + by :samp:`-aI` and :samp:`-aO`. - If a project file is either specified or found by the tools, then the content - of the source directory and object directory lines are added as if they - had been specified respectively by :samp:`-aI` - and :samp:`-aO`. + See :ref:`Configuration_Files_for_gnatxref_and_gnatfind` for the syntax + of this configuration file. -:samp:`u` +:samp:`-u` Output only unused symbols. This may be really useful if you give your main compilation unit on the command line, as `gnatxref` will then display every unused entity and 'with'ed package. - -:samp:`v` +:samp:`-v` Instead of producing the default output, `gnatxref` will generate a :file:`tags` file that can be used by vi. For examples how to use this feature, see :ref:`Examples_of_gnatxref_Usage`. The tags file is output @@ -719,7 +717,6 @@ with the following iterpretation of the command arguments: Note that if you specify at least one file in this part, `gnatfind` may sometimes not be able to find the body of the subprograms. - At least one of 'sourcefile' or 'pattern' has to be present on the command line. @@ -733,14 +730,14 @@ The following switches are available: .. index:: --help (gnatfind) -:samp:`-help` +:samp:`--help` If *--version* was not used, display usage, then exit disregarding all other options. .. index:: -a (gnatfind) -:samp:`a` +:samp:`-a` If this switch is present, `gnatfind` and `gnatxref` will parse the read-only files found in the library search path. Otherwise, these files will be ignored. This option can be used to protect Gnat sources or your own @@ -751,14 +748,14 @@ The following switches are available: .. index:: -aIDIR (gnatfind) -:samp:`aI{DIR}` +:samp:`-aI{DIR}` When looking for source files also look in directory DIR. The order in which source file search is undertaken is the same as for *gnatmake*. .. index:: -aODIR (gnatfind) -:samp:`aO{DIR}` +:samp:`-aO{DIR}` When searching for library and object files, look in directory DIR. The order in which library files are searched is the same as for *gnatmake*. @@ -766,19 +763,19 @@ The following switches are available: .. index:: -nostdinc (gnatfind) -:samp:`nostdinc` +:samp:`-nostdinc` Do not look for sources in the system default directory. .. index:: -nostdlib (gnatfind) -:samp:`nostdlib` +:samp:`-nostdlib` Do not look for library files in the system default directory. .. index:: --ext (gnatfind) -:samp:`-ext={extension}` +:samp:`--ext={extension}` Specify an alternate ali file extension. The default is `ali` and other extensions (e.g. `gli` for C/C++ sources when using *-fdump-xref*) may be specified via this switch. Note that if this switch overrides the @@ -787,21 +784,21 @@ The following switches are available: .. index:: --RTS (gnatfind) -:samp:`-RTS={rts-path}` +:samp:`--RTS={rts-path}` Specifies the default location of the runtime library. Same meaning as the equivalent *gnatmake* flag (:ref:`Switches_for_gnatmake`). .. index:: -d (gnatfind) -:samp:`d` +:samp:`-d` If this switch is set, then `gnatfind` will output the parent type reference for each matching derived types. .. index:: -e (gnatfind) -:samp:`e` +:samp:`-e` By default, `gnatfind` accept the simple regular expression set for `pattern`. If this switch is set, then the pattern will be considered as full Unix-style regular expression. @@ -809,7 +806,7 @@ The following switches are available: .. index:: -f (gnatfind) -:samp:`f` +:samp:`-f` If this switch is set, the output file names will be preceded by their directory (if the file was found in the search path). If this switch is not set, the directory will not be printed. @@ -817,7 +814,7 @@ The following switches are available: .. index:: -g (gnatfind) -:samp:`g` +:samp:`-g` If this switch is set, information is output only for library-level entities, ignoring local entities. The use of this switch may accelerate `gnatfind` and `gnatxref`. @@ -825,26 +822,25 @@ The following switches are available: .. index:: -IDIR (gnatfind) -:samp:`I{DIR}` +:samp:`-I{DIR}` Equivalent to :samp:`-aODIR -aIDIR`. .. index:: -pFILE (gnatfind) -:samp:`p{FILE}` - Specify a project file. - By default, `gnatxref` and `gnatfind` will try to locate a - project file in the current directory. +:samp:`-p{FILE}` + Specify a configuration file to use to list the source and object directories. - If a project file is either specified or found by the tools, then the content - of the source directory and object directory lines are added as if they - had been specified respectively by :samp:`-aI` and - :samp:`-aO`. + If a file is specified, then the content of the source directory and object + directory lines are added as if they had been specified respectively + by :samp:`-aI` and :samp:`-aO`. + See :ref:`Configuration_Files_for_gnatxref_and_gnatfind` for the syntax + of this configuration file. .. index:: -r (gnatfind) -:samp:`r` +:samp:`-r` By default, `gnatfind` will output only the information about the declaration, body or type completion of the entities. If this switch is set, the `gnatfind` will locate every reference to the entities in @@ -854,14 +850,14 @@ The following switches are available: .. index:: -s (gnatfind) -:samp:`s` +:samp:`-s` If this switch is set, then `gnatfind` will output the content of the Ada source file lines were the entity was found. .. index:: -t (gnatfind) -:samp:`t` +:samp:`-t` If this switch is set, then `gnatfind` will output the type hierarchy for the specified type. It act like -d option but recursively from parent type to parent type. When this switch is set it is not possible to @@ -877,28 +873,16 @@ As stated previously, gnatfind will search in every directory in the search path. You can force it to look only in the current directory if you specify `*` at the end of the command line. -.. _Project_Files_for_gnatxref_and_gnatfind: +.. _Configuration_Files_for_gnatxref_and_gnatfind: -Project Files for *gnatxref* and *gnatfind* -------------------------------------------- +Configuration Files for *gnatxref* and *gnatfind* +------------------------------------------------- -Project files allow a programmer to specify how to compile its -application, where to find sources, etc. These files are used -primarily by GPS, but they can also be used -by the two tools `gnatxref` and `gnatfind`. +Configuration files are used by `gnatxref` and `gnatfind` to specify +the list of source and object directories to consider. They can be +specified via the :samp:`-p` switch. -A project file name must end with :file:`.gpr`. If a single one is -present in the current directory, then `gnatxref` and `gnatfind` will -extract the information from it. If multiple project files are found, none of -them is read, and you have to use the :samp:`-p` switch to specify the one -you want to use. - -The following lines can be included, even though most of them have default -values which can be used in most cases. -The lines can be entered in any order in the file. -Except for :file:`src_dir` and :file:`obj_dir`, you can only have one instance of -each line. If you have multiple instances, only the last one is taken into -account. +The following lines can be included, in any order in the file: * *src_dir=DIR* [default: `"./"`]. @@ -906,66 +890,13 @@ account. lines can be specified and they will be searched in the order they are specified. - * *obj_dir=DIR* [default: `"./"`]. Specifies a directory where to look for object and library files. Multiple `obj_dir` lines can be specified, and they will be searched in the order they are specified - -* *comp_opt=SWITCHES* - [default: `""`]. - Creates a variable which can be referred to subsequently by using - the `${comp_opt}` notation. This is intended to store the default - switches given to *gnatmake* and *gcc*. - - -* *bind_opt=SWITCHES* - [default: `""`]. - Creates a variable which can be referred to subsequently by using - the :samp:`${bind_opt}` notation. This is intended to store the default - switches given to *gnatbind*. - - -* *link_opt=SWITCHES* - [default: `""`]. - Creates a variable which can be referred to subsequently by using - the :samp:`${link_opt}` notation. This is intended to store the default - switches given to *gnatlink*. - - -* *main=EXECUTABLE* - [default: `""`]. - Specifies the name of the executable for the application. This variable can - be referred to in the following lines by using the :samp:`{${main}` notation. - - -* *comp_cmd=COMMAND* - [default: `"gcc -c -I${src_dir} -g -gnatq"`]. - Specifies the command used to compile a single file in the application. - - -* *make_cmd=COMMAND* - [default: `"gnatmake ${main} -aI${src_dir} - -aO${obj_dir} -g -gnatq -cargs ${comp_opt} - -bargs ${bind_opt} -largs ${link_opt}"`]. - Specifies the command used to recompile the whole application. - - -* *run_cmd=COMMAND* - [default: `"${main}"`]. - Specifies the command used to run the application. - - -* *debug_cmd=COMMAND* - [default: `"gdb ${main}"`]. - Specifies the command used to debug the application - - -*gnatxref* and *gnatfind* only take into account the -`src_dir` and `obj_dir` lines, and ignore the others. - +Any other line will be silently ignored. .. _Regular_Expressions_in_gnatfind_and_gnatxref: @@ -3316,7 +3247,8 @@ Alternatively, you may run the script using the following command line: :samp:`--par_threshold={nnn}` If the number of parameter specifications is greater than `nnn` (or equal to `nnn` in case of a function), start each specification from - a new line. This feature is disabled by default. + a new line. If `nnn` is 0, and `--no-separate-is` was not specified, then + the "is" is placed on a separate line. This feature is disabled by default. .. _Setting_the_Source_Search_Path: @@ -4356,6 +4288,10 @@ Alternatively, you may run the script using the following command line: :samp:`-r` Recursively considers all sources from all projects. + .. index:: -files (gnattest) + + :samp:`-files={filename}` + The name of a text file containing a list of Ada source files to process. .. index:: --RTS (gnattest) @@ -4625,7 +4561,7 @@ Alternatively, you may run the script using the following command line: :: $ cd obj/driver - $ gnatmake -Ptest_driver + $ gprbuild -Ptest_driver $ test_runner One failed test with the diagnosis "test not implemented" is reported. @@ -4852,7 +4788,7 @@ Alternatively, you may run the script using the following command line: Testing with Contracts ---------------------- - *gnattest* supports pragmas *Precondition*, *Postcondition*, and *Test_Case*, + *gnattest* supports pragmas *Pre*, *Post*, and *Test_Case*, as well as the corresponding Ada 2012 aspects. Test routines are generated, one per each *Test_Case* associated with a tested subprogram. Those test routines have special wrappers for tested functions @@ -5002,6 +4938,29 @@ Alternatively, you may run the script using the following command line: attempting to use this powerful feature. + .. _Gnatcov_Integration: + + Integration with GNATcoverage + ----------------------------- + + In addition to the harness, *gnattest* generates a Makefile. This Makefile + provides targets for building the test drivers and also the targets for + computing the coverage information using GNATcoverage framework when this + coverage analysis tool is available. The target ``coverage`` fully automates + the process: it will first build all test drivers, then run them under + GNATcoverage, analyze individual trace files, and finally aggregate them: + + :: + + make coverage + + GNATcoverage options, such as coverage criteria and generated report format, + can be adjusted using Makefile variables provided for this purpose. + + Note that coverage targets are not generated in the Makefile when + --separate-drivers=test is passed to gnattest. + + .. _Putting_Tests_under_Version_Control: Putting Tests under Version Control @@ -5075,10 +5034,12 @@ Alternatively, you may run the script using the following command line: from projects imported either directly or indirectly by ``proj``. Otherwise this option has no effect. - :samp:`-U {main_unit}` + :samp:`-U {source_file}` Similar to :samp:`-U`, but if no sources are specified then process only those source files for units in the closure of - `main_unit`. + the Ada source contained in `source_file`. Note that this option + expects the source file name but not the Ada unit name as its + parameter. :samp:`-X{name}={val}` Indicates that the external variable ``name`` in the project has the diff --git a/gcc/ada/doc/gnat_ugn/platform_specific_information.rst b/gcc/ada/doc/gnat_ugn/platform_specific_information.rst index 8c94f907598..3618b0abf12 100644 --- a/gcc/ada/doc/gnat_ugn/platform_specific_information.rst +++ b/gcc/ada/doc/gnat_ugn/platform_specific_information.rst @@ -237,6 +237,20 @@ value greater than 0.0, or else use the corresponding *-T* binder option. +To make sure a program is running as root, you can put something like +this in a library package body in your application: + + .. code-block:: ada + + function geteuid return Integer; + pragma Import (C, geteuid, "geteuid"); + Ignore : constant Boolean := + (if geteuid = 0 then True else raise Program_Error with "must be root"); + +It gets the effective user id, and if it's not 0 (i.e. root), it raises +Program_Error. + + .. index:: Solaris Sparc threads libraries .. _Solaris-Specific_Considerations: @@ -2215,7 +2229,7 @@ This setting can be done with *gnatlink* using either of the following: 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. + because the comma is a separator for this option. .. _Setting_Heap_Size_from_gnatlink: @@ -2244,7 +2258,7 @@ Under Windows systems, it is possible to specify the program heap size from 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. + because the comma is a separator for this option. .. _Win32_Specific_Addons: 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 faedd8ae72d..d4985cd614f 100644 --- a/gcc/ada/doc/gnat_ugn/the_gnat_compilation_model.rst +++ b/gcc/ada/doc/gnat_ugn/the_gnat_compilation_model.rst @@ -2796,9 +2796,9 @@ The preprocessing language allows such constructs as .. code-block:: c #if DEBUG or else (PRIORITY > 4) then - bunch of declarations + sequence of declarations #else - completely different bunch of declarations + completely different sequence of declarations #end if; The values of the symbols `DEBUG` and `PRIORITY` can be @@ -2806,7 +2806,7 @@ defined either on the command line or in a separate file. The other way of running the preprocessor is even closer to the C style and often more convenient. In this approach the preprocessing is integrated into -the compilation process. The compiler is fed the preprocessor input which +the compilation process. The compiler is given the preprocessor input which includes `#if` lines etc, and then the compiler carries out the preprocessing internally and processes the resulting output. For more details on this approach, see :ref:`Integrated_Preprocessing`. @@ -2831,8 +2831,8 @@ For further discussion of conditional compilation in general, see Preprocessing Symbols ^^^^^^^^^^^^^^^^^^^^^ -Preprocessing symbols are defined in definition files and referred to in -sources to be preprocessed. A Preprocessing symbol is an identifier, following +Preprocessing symbols are defined in *definition files* and referenced in the +sources to be preprocessed. A preprocessing symbol is an identifier, following normal Ada (case-insensitive) rules for its syntax, with the restriction that all characters need to be in the ASCII set (no accented letters). @@ -2859,7 +2859,7 @@ where * *outfile* is the full name of the output file, which is an Ada source in standard Ada form. When used with GNAT, this file name will - normally have an ads or adb suffix. + normally have an *ads* or *adb* suffix. * *deffile* is the full name of a text file containing definitions of @@ -2880,7 +2880,7 @@ Switches for `gnatprep` .. index:: --help (gnatprep) :samp:`--help` - If *--version* was not used, display usage, then exit disregarding + If :option:`--version` was not used, display usage and then exit disregarding all other options. .. index:: -b (gnatprep) @@ -2904,15 +2904,15 @@ Switches for `gnatprep` Causes comments to be scanned. Normally comments are ignored by gnatprep. If this option is specified, then comments are scanned and any $symbol substitutions performed as in program text. This is particularly useful - when structured comments are used (e.g., when writing programs in the - SPARK dialect of Ada). Note that this switch is not available when - doing integrated preprocessing (it would be useless in this context - since comments are ignored by the compiler in any case). + when structured comments are used (e.g., for programs written in a + pre-2014 version of the SPARK Ada subset). Note that this switch is not + available when doing integrated preprocessing (it would be useless in + this context since comments are ignored by the compiler in any case). .. index:: -D (gnatprep) -:samp:`-D{symbol}={value}` - Defines a new preprocessing symbol, associated with value. If no value is given +:samp:`-D{symbol}[={value}]` + Defines a new preprocessing symbol with the specified value. If no value is given on the command line, then symbol is considered to be `True`. This switch can be used in place of a definition file. @@ -3119,84 +3119,134 @@ and then the substitution will occur as desired. Integrated Preprocessing ------------------------ -GNAT sources may be preprocessed immediately before compilation. -In this case, the actual -text of the source is not the text of the source file, but is derived from it -through a process called preprocessing. Integrated preprocessing is specified -through switches *-gnatep* and/or *-gnateD*. *-gnatep* -indicates, through a text file, the preprocessing data to be used. -:samp:`-gnateD` specifies or modifies the values of preprocessing symbol. -Note that integrated preprocessing applies only to Ada source files, it is +As noted above, a file to be preprocessed consists of Ada source code +in which preprocessing lines have been inserted. However, +instead of using *gnatprep* to explicitly preprocess a file as a separate +step before compilation, you can carry out the preprocessing implicitly +as part of compilation. Such *integrated preprocessing*, which is the common +style with C, is performed when either or both of the following switches +are passed to the compiler: + + * :option:`-gnatep`, which specifies the *preprocessor data file*. + This file dictates how the source files will be preprocessed (e.g., which + symbol definition files apply to which sources). + + * :option:`-gnateD`, which defines values for preprocessing symbols. + +Integrated preprocessing applies only to Ada source files, it is not available for configuration pragma files. -Note that when integrated preprocessing is used, the output from the -preprocessor is not written to any external file. Instead it is passed -internally to the compiler. If you need to preserve the result of -preprocessing in a file, then you should use *gnatprep* -to perform the desired preprocessing in stand-alone mode. +With integrated preprocessing, the output from the preprocessor is not, +by default, written to any external file. Instead it is passed +internally to the compiler. To preserve the result of +preprocessing in a file, either run *gnatprep* +in standalone mode or else supply the :option:`-gnateG` switch +(described below) to the compiler. -It is recommended that *gnatmake* switch -s should be -used when Integrated Preprocessing is used. The reason is that preprocessing -with another Preprocessing Data file without changing the sources will -not trigger recompilation without this switch. +The *gnatmake* switch :option:`-s` should be used with integrated +preprocessing; otherwise the use of a different preprocessor data file +without changing the sources will not cause recompilation. -Note that *gnatmake* switch -m will almost +Note that the *gnatmake* switch :option:`-m` will almost always trigger recompilation for sources that are preprocessed, because *gnatmake* cannot compute the checksum of the source after preprocessing. -The actual preprocessing function is described in detail in section -:ref:`Preprocessing_with_gnatprep`. This section only describes how integrated -preprocessing is triggered and parameterized. - +The actual preprocessing function is described in detail in +:ref:`Preprocessing_with_gnatprep`. This section explains the switches +that relate to integrated preprocessing. .. index:: -gnatep (gcc) -:samp:`-gnatep={file}` - This switch indicates to the compiler the file name (without directory - information) of the preprocessor data file to use. The preprocessor data file - should be found in the source directories. Alternatively when using project - files, you can reference to the project file's directory via the - ``project name'Project_Dir`` project attribute, e.g: - - .. code-block:: gpr - - project Prj is - package Compiler is - for Switches ("Ada") use - ("-gnatep=" & Prj'Project_Dir & "prep.def"); - end Compiler; - end Prj; - - A preprocessing data file is a text file with significant lines indicating - how should be preprocessed either a specific source or all sources not - mentioned in other lines. A significant line is a nonempty, non-comment line. - Comments are similar to Ada comments. - - Each significant line starts with either a literal string or the character '*'. - A literal string is the file name (without directory information) of the source - to preprocess. A character '*' indicates the preprocessing for all the sources - that are not specified explicitly on other lines (order of the lines is not - significant). It is an error to have two lines with the same file name or two +:samp:`-gnatep={preprocessor_data_file}` + This switch specifies the file name (without directory + information) of the preprocessor data file. Either place this file + in one of the source directories, or, when using project + files, reference the project file's directory via the + ``project_name'Project_Dir`` project attribute; e.g: + + .. code-block:: gpr + + project Prj is + package Compiler is + for Switches ("Ada") use + ("-gnatep=" & Prj'Project_Dir & "prep.def"); + end Compiler; + end Prj; + + A preprocessor data file is a text file that contains *preprocessor + control lines*. A preprocessor control line directs the preprocessing of + either a particular source file, or, analogous to *others* in Ada, + all sources not specified elsewhere in the preprocessor data file. + A preprocessor control line + can optionally identify a *definition file* that assigns values to + preprocessor symbols, as well as a list of switches that relate to + preprocessing. + Empty lines and comments (using Ada syntax) are also permitted, with no + semantic effect. + + Here's an example of a preprocessor data file: + + .. code-block:: ada + + "toto.adb" "prep.def" -u + -- Preprocess toto.adb, using definition file prep.def + -- Undefined symbols are treated as False + + * -c -DVERSION=V101 + -- Preprocess all other sources without using a definition file + -- Suppressed lined are commented + -- Symbol VERSION has the value V101 + + "tata.adb" "prep2.def" -s + -- Preprocess tata.adb, using definition file prep2.def + -- List all symbols with their values + + A preprocessor control line has the following syntax: + + :: + + ::= + [ ] { } + + ::= | '*' + + ::= + + := + + := (See below for list) + + Thus each preprocessor control line starts with either a literal string or + the character '*': + + * A literal string is the file name (without directory information) of the source + file that will be input to the preprocessor. + + * The character '*' is a wild-card indicator; the additional parameters on the line + indicate the preprocessing for all the sources + that are not specified explicitly on other lines (the order of the lines is not + significant). + + It is an error to have two lines with the same file name or two lines starting with the character '*'. - After the file name or the character '*', another optional literal string - indicating the file name of the definition file to be used for preprocessing + After the file name or '*', an optional literal string specifies the name of + the definition file to be used for preprocessing (:ref:`Form_of_Definitions_File`). The definition files are found by the compiler in one of the source directories. In some cases, when compiling a source in a directory other than the current directory, if the definition file is in the current directory, it may be necessary to add the current - directory as a source directory through switch -I., otherwise + directory as a source directory through the :option:`-I` switch; otherwise the compiler would not find the definition file. - Then, optionally, switches similar to those of `gnatprep` may - be found. Those switches are: + Finally, switches similar to those of *gnatprep* may optionally appear: :samp:`-b` Causes both preprocessor lines and the lines deleted by preprocessing to be replaced by blank lines, preserving the line number. - This switch is always implied; however, if specified after *-c* - it cancels the effect of *-c*. + This switch is always implied; however, if specified after :option:`-c` + it cancels the effect of :option:`-c`. :samp:`-c` @@ -3205,11 +3255,12 @@ preprocessing is triggered and parameterized. with the special string '`--!`'. - :samp:`-Dsymbol={value}` - Define or redefine a symbol, associated with value. A symbol is an Ada - identifier, or an Ada reserved word, with the exception of `if`, + :samp:`-D{symbol}={new_value}` + Define or redefine *symbol* to have *new_value* as its value. + The permitted form for *symbol* is either an Ada identifier, or any Ada reserved word + aside from `if`, `else`, `elsif`, `end`, `and`, `or` and `then`. - `value` is either a literal string, an Ada identifier or any Ada reserved + The permitted form for `new_value` is a literal string, an Ada identifier or any Ada reserved word. A symbol declared with this switch replaces a symbol with the same name defined in a definition file. @@ -3226,51 +3277,39 @@ preprocessing is triggered and parameterized. a `#if` or `#elsif` test will be treated as an error. - Examples of valid lines in a preprocessor data file: - - .. code-block:: ada - - "toto.adb" "prep.def" -u - -- preprocess "toto.adb", using definition file "prep.def", - -- undefined symbol are False. - - * -c -DVERSION=V101 - -- preprocess all other sources without a definition file; - -- suppressed lined are commented; symbol VERSION has the value V101. - - "titi.adb" "prep2.def" -s - -- preprocess "titi.adb", using definition file "prep2.def"; - -- list all symbols with their values. - .. index:: -gnateD (gcc) -:samp:`-gnateDsymbol[=value]` - Define or redefine a preprocessing symbol, associated with value. If no value - is given on the command line, then the value of the symbol is `True`. - A symbol is an identifier, following normal Ada (case-insensitive) - rules for its syntax, and value is either an arbitrary string between double +:samp:`-gnateD{symbol}[={new_value}]` + Define or redefine *symbol* to have *new_value* as its value. If no value + is supplied, then the value of *symbol* is `True`. + The form of *symbol* is an identifier, following normal Ada (case-insensitive) + rules for its syntax, and *new_value* is either an arbitrary string between double quotes or any sequence (including an empty sequence) of characters from the set (letters, digits, period, underline). Ada reserved words may be used as symbols, with the exceptions of `if`, `else`, `elsif`, `end`, `and`, `or` and `then`. - Examples:: + Examples: + + :: - -gnateDToto=Titi - -gnateDFoo - -gnateDFoo=\"Foo-Bar\" + -gnateDToto=Tata + -gnateDFoo + -gnateDFoo=\"Foo-Bar\" A symbol declared with this switch on the command line replaces a symbol with the same name either in a definition file or specified with a - switch -D in the preprocessor data file. + switch :option:`-D` in the preprocessor data file. - This switch is similar to switch *-D* of `gnatprep`. + This switch is similar to switch :option:`-D` of `gnatprep`. :samp:`-gnateG` - When integrated preprocessing is performed and the preprocessor modifies - the source text, write the result of this preprocessing into a file - .prep. + When integrated preprocessing is performed on source file :file:`filename.extension`, + create or overwrite :file:`filename.extension.prep` to contain + the result of the preprocessing. + For example if the source file is :file:`foo.adb` then + the output file will be :file:`foo.adb.prep`. .. _Mixed_Language_Programming: @@ -3340,7 +3379,7 @@ the main subprogram in Ada: -- Declare an Ada procedure spec for Print_Num, then use -- C function print_num for the implementation. procedure Print_Num (Num : Integer); - pragma Import (C, Print_Num, "print_num"; + pragma Import (C, Print_Num, "print_num"); begin Print_Num (Get_Num); diff --git a/gcc/ada/gnat_rm.texi b/gcc/ada/gnat_rm.texi index c51ff384c91..ace680e1f4a 100644 --- a/gcc/ada/gnat_rm.texi +++ b/gcc/ada/gnat_rm.texi @@ -3,7 +3,7 @@ @setfilename gnat_rm.info @documentencoding UTF-8 @ifinfo -@*Generated by Sphinx 1.3b2.@* +@*Generated by Sphinx 1.4.6.@* @end ifinfo @settitle GNAT Reference Manual @defindex ge @@ -21,7 +21,7 @@ @copying @quotation -GNAT Reference Manual , January 13, 2017 +GNAT Reference Manual , Apr 25, 2017 AdaCore @@ -135,6 +135,7 @@ Implementation Defined Pragmas * Pragma CPP_Virtual:: * Pragma CPP_Vtable:: * Pragma CPU:: +* Pragma Deadline_Floor:: * Pragma Default_Initial_Condition:: * Pragma Debug:: * Pragma Debug_Policy:: @@ -203,6 +204,7 @@ Implementation Defined Pragmas * Pragma Max_Queue_Length:: * Pragma No_Body:: * Pragma No_Elaboration_Code_All:: +* Pragma No_Heap_Finalization:: * Pragma No_Inline:: * Pragma No_Return:: * Pragma No_Run_Time:: @@ -299,7 +301,7 @@ Implementation Defined Pragmas Implementation Defined Aspects * Aspect Abstract_State:: -* Annotate:: +* Aspect Annotate:: * Aspect Async_Readers:: * Aspect Async_Writers:: * Aspect Constant_After_Elaboration:: @@ -848,6 +850,7 @@ GNAT Implementation of Tasking * Mapping Ada Tasks onto the Underlying Kernel Threads:: * Ensuring Compliance with the Real-Time Annex:: +* Support for Locking Policies:: Code Generation for Array Aggregates @@ -1195,6 +1198,7 @@ consideration, the use of these pragmas should be minimized. * Pragma CPP_Virtual:: * Pragma CPP_Vtable:: * Pragma CPU:: +* Pragma Deadline_Floor:: * Pragma Default_Initial_Condition:: * Pragma Debug:: * Pragma Debug_Policy:: @@ -1263,6 +1267,7 @@ consideration, the use of these pragmas should be minimized. * Pragma Max_Queue_Length:: * Pragma No_Body:: * Pragma No_Elaboration_Code_All:: +* Pragma No_Heap_Finalization:: * Pragma No_Inline:: * Pragma No_Return:: * Pragma No_Run_Time:: @@ -1918,7 +1923,7 @@ case, and it is recommended that these two options not be used together. Syntax: @example -pragma Asynch_Readers [ (boolean_EXPRESSION) ]; +pragma Asynch_Readers [ (boolean_EXPRESSION) ]; @end example For the semantics of this pragma, see the entry for aspect @cite{Async_Readers} in @@ -1932,7 +1937,7 @@ the SPARK 2014 Reference Manual, section 7.1.2. Syntax: @example -pragma Asynch_Writers [ (boolean_EXPRESSION) ]; +pragma Asynch_Writers [ (boolean_EXPRESSION) ]; @end example For the semantics of this pragma, see the entry for aspect @cite{Async_Writers} in @@ -2572,9 +2577,9 @@ following is an example of use within a package spec: package Math_Functions is ... function Sqrt (Arg : Float) return Float; - pragma Contract_Cases ((Arg in 0 .. 99) => Sqrt'Result < 10, - Arg >= 100 => Sqrt'Result >= 10, - others => Sqrt'Result = 0); + pragma Contract_Cases (((Arg in 0.0 .. 99.0) => Sqrt'Result < 10.0, + Arg >= 100.0 => Sqrt'Result >= 10.0, + others => Sqrt'Result = 0.0)); ... end Math_Functions; @end example @@ -2743,7 +2748,7 @@ the same object layout as the G++ compiler by default. See @ref{45,,Interfacing to C++} for related information. -@node Pragma CPU,Pragma Default_Initial_Condition,Pragma CPP_Vtable,Implementation Defined Pragmas +@node Pragma CPU,Pragma Deadline_Floor,Pragma CPP_Vtable,Implementation Defined Pragmas @anchor{gnat_rm/implementation_defined_pragmas pragma-cpu}@anchor{49} @section Pragma CPU @@ -2758,8 +2763,23 @@ This pragma is standard in Ada 2012, but is available in all earlier versions of Ada as an implementation-defined pragma. See Ada 2012 Reference Manual for details. -@node Pragma Default_Initial_Condition,Pragma Debug,Pragma CPU,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas id8}@anchor{4a}@anchor{gnat_rm/implementation_defined_pragmas pragma-default-initial-condition}@anchor{4b} +@node Pragma Deadline_Floor,Pragma Default_Initial_Condition,Pragma CPU,Implementation Defined Pragmas +@anchor{gnat_rm/implementation_defined_pragmas pragma-deadline-floor}@anchor{4a} +@section Pragma Deadline_Floor + + +Syntax: + +@example +pragma Deadline_Floor (time_span_EXPRESSION); +@end example + +This pragma applies only to protected types and specifies the floor +deadline inherited by a task when the task enters a protected object. +It is effective only when the EDF scheduling policy is used. + +@node Pragma Default_Initial_Condition,Pragma Debug,Pragma Deadline_Floor,Implementation Defined Pragmas +@anchor{gnat_rm/implementation_defined_pragmas id8}@anchor{4b}@anchor{gnat_rm/implementation_defined_pragmas pragma-default-initial-condition}@anchor{4c} @section Pragma Default_Initial_Condition @@ -2773,7 +2793,7 @@ For the semantics of this pragma, see the entry for aspect @cite{Default_Initial_Condition} in the SPARK 2014 Reference Manual, section 7.3.3. @node Pragma Debug,Pragma Debug_Policy,Pragma Default_Initial_Condition,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-debug}@anchor{4c} +@anchor{gnat_rm/implementation_defined_pragmas pragma-debug}@anchor{4d} @section Pragma Debug @@ -2801,7 +2821,7 @@ or by use of the pragma @cite{Check_Policy} with a first argument of @cite{Debug}. @node Pragma Debug_Policy,Pragma Default_Scalar_Storage_Order,Pragma Debug,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-debug-policy}@anchor{4d} +@anchor{gnat_rm/implementation_defined_pragmas pragma-debug-policy}@anchor{4e} @section Pragma Debug_Policy @@ -2816,7 +2836,7 @@ with a first argument of @cite{Debug}. It is retained for historical compatibility reasons. @node Pragma Default_Scalar_Storage_Order,Pragma Default_Storage_Pool,Pragma Debug_Policy,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-default-scalar-storage-order}@anchor{4e} +@anchor{gnat_rm/implementation_defined_pragmas pragma-default-scalar-storage-order}@anchor{4f} @section Pragma Default_Scalar_Storage_Order @@ -2889,7 +2909,7 @@ it may significantly degrade the run-time performance of the software, instead the default scalar storage order ought to be changed only on a local basis. @node Pragma Default_Storage_Pool,Pragma Depends,Pragma Default_Scalar_Storage_Order,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-default-storage-pool}@anchor{4f} +@anchor{gnat_rm/implementation_defined_pragmas pragma-default-storage-pool}@anchor{50} @section Pragma Default_Storage_Pool @@ -2906,7 +2926,7 @@ versions of Ada as an implementation-defined pragma. See Ada 2012 Reference Manual for details. @node Pragma Depends,Pragma Detect_Blocking,Pragma Default_Storage_Pool,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-depends}@anchor{50}@anchor{gnat_rm/implementation_defined_pragmas id9}@anchor{51} +@anchor{gnat_rm/implementation_defined_pragmas pragma-depends}@anchor{51}@anchor{gnat_rm/implementation_defined_pragmas id9}@anchor{52} @section Pragma Depends @@ -2939,7 +2959,7 @@ For the semantics of this pragma, see the entry for aspect @cite{Depends} in the SPARK 2014 Reference Manual, section 6.1.5. @node Pragma Detect_Blocking,Pragma Disable_Atomic_Synchronization,Pragma Depends,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-detect-blocking}@anchor{52} +@anchor{gnat_rm/implementation_defined_pragmas pragma-detect-blocking}@anchor{53} @section Pragma Detect_Blocking @@ -2957,7 +2977,7 @@ blocking operations within a protected operation, and to raise Program_Error if that happens. @node Pragma Disable_Atomic_Synchronization,Pragma Dispatching_Domain,Pragma Detect_Blocking,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-disable-atomic-synchronization}@anchor{53} +@anchor{gnat_rm/implementation_defined_pragmas pragma-disable-atomic-synchronization}@anchor{54} @section Pragma Disable_Atomic_Synchronization @@ -2983,7 +3003,7 @@ till the end of the scope. If an @cite{Entity} argument is present, the action applies only to that entity. @node Pragma Dispatching_Domain,Pragma Effective_Reads,Pragma Disable_Atomic_Synchronization,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-dispatching-domain}@anchor{54} +@anchor{gnat_rm/implementation_defined_pragmas pragma-dispatching-domain}@anchor{55} @section Pragma Dispatching_Domain @@ -2998,21 +3018,21 @@ versions of Ada as an implementation-defined pragma. See Ada 2012 Reference Manual for details. @node Pragma Effective_Reads,Pragma Effective_Writes,Pragma Dispatching_Domain,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas id10}@anchor{55}@anchor{gnat_rm/implementation_defined_pragmas pragma-effective-reads}@anchor{56} +@anchor{gnat_rm/implementation_defined_pragmas id10}@anchor{56}@anchor{gnat_rm/implementation_defined_pragmas pragma-effective-reads}@anchor{57} @section Pragma Effective_Reads Syntax: @example -pragma Effective_Reads [ (boolean_EXPRESSION) ]; +pragma Effective_Reads [ (boolean_EXPRESSION) ]; @end example For the semantics of this pragma, see the entry for aspect @cite{Effective_Reads} in the SPARK 2014 Reference Manual, section 7.1.2. @node Pragma Effective_Writes,Pragma Elaboration_Checks,Pragma Effective_Reads,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas id11}@anchor{57}@anchor{gnat_rm/implementation_defined_pragmas pragma-effective-writes}@anchor{58} +@anchor{gnat_rm/implementation_defined_pragmas id11}@anchor{58}@anchor{gnat_rm/implementation_defined_pragmas pragma-effective-writes}@anchor{59} @section Pragma Effective_Writes @@ -3026,7 +3046,7 @@ For the semantics of this pragma, see the entry for aspect @cite{Effective_Write in the SPARK 2014 Reference Manual, section 7.1.2. @node Pragma Elaboration_Checks,Pragma Eliminate,Pragma Effective_Writes,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-elaboration-checks}@anchor{59} +@anchor{gnat_rm/implementation_defined_pragmas pragma-elaboration-checks}@anchor{5a} @section Pragma Elaboration_Checks @@ -3051,7 +3071,7 @@ used by the GNAT compiler, see the chapter on elaboration order handling in the @emph{GNAT User's Guide}. @node Pragma Eliminate,Pragma Enable_Atomic_Synchronization,Pragma Elaboration_Checks,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-eliminate}@anchor{5a} +@anchor{gnat_rm/implementation_defined_pragmas pragma-eliminate}@anchor{5b} @section Pragma Eliminate @@ -3129,7 +3149,7 @@ dispatch are considered to be unused (are never called as a result of a direct or a dispatching call). @node Pragma Enable_Atomic_Synchronization,Pragma Export_Function,Pragma Eliminate,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-enable-atomic-synchronization}@anchor{5b} +@anchor{gnat_rm/implementation_defined_pragmas pragma-enable-atomic-synchronization}@anchor{5c} @section Pragma Enable_Atomic_Synchronization @@ -3157,7 +3177,7 @@ till the end of the scope. If an @cite{Entity} argument is present, the action applies only to that entity. @node Pragma Export_Function,Pragma Export_Object,Pragma Enable_Atomic_Synchronization,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-export-function}@anchor{5c} +@anchor{gnat_rm/implementation_defined_pragmas pragma-export-function}@anchor{5d} @section Pragma Export_Function @@ -3226,7 +3246,7 @@ string. In this case, no external name is generated. This form still allows the specification of parameter mechanisms. @node Pragma Export_Object,Pragma Export_Procedure,Pragma Export_Function,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-export-object}@anchor{5d} +@anchor{gnat_rm/implementation_defined_pragmas pragma-export-object}@anchor{5e} @section Pragma Export_Object @@ -3251,7 +3271,7 @@ of portability), but it is not required. @cite{Size} is syntax checked, but otherwise ignored by GNAT. @node Pragma Export_Procedure,Pragma Export_Value,Pragma Export_Object,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-export-procedure}@anchor{5e} +@anchor{gnat_rm/implementation_defined_pragmas pragma-export-procedure}@anchor{5f} @section Pragma Export_Procedure @@ -3304,7 +3324,7 @@ string. In this case, no external name is generated. This form still allows the specification of parameter mechanisms. @node Pragma Export_Value,Pragma Export_Valued_Procedure,Pragma Export_Procedure,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-export-value}@anchor{5f} +@anchor{gnat_rm/implementation_defined_pragmas pragma-export-value}@anchor{60} @section Pragma Export_Value @@ -3325,7 +3345,7 @@ the application. This pragma is currently supported only for the AAMP target and is ignored for other targets. @node Pragma Export_Valued_Procedure,Pragma Extend_System,Pragma Export_Value,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-export-valued-procedure}@anchor{60} +@anchor{gnat_rm/implementation_defined_pragmas pragma-export-valued-procedure}@anchor{61} @section Pragma Export_Valued_Procedure @@ -3383,7 +3403,7 @@ string. In this case, no external name is generated. This form still allows the specification of parameter mechanisms. @node Pragma Extend_System,Pragma Extensions_Allowed,Pragma Export_Valued_Procedure,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-extend-system}@anchor{61} +@anchor{gnat_rm/implementation_defined_pragmas pragma-extend-system}@anchor{62} @section Pragma Extend_System @@ -3434,7 +3454,7 @@ for compiling System units, as explained in the GNAT User's Guide. @node Pragma Extensions_Allowed,Pragma Extensions_Visible,Pragma Extend_System,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-extensions-allowed}@anchor{62} +@anchor{gnat_rm/implementation_defined_pragmas pragma-extensions-allowed}@anchor{63} @section Pragma Extensions_Allowed @@ -3467,7 +3487,7 @@ is constrained. @end table @node Pragma Extensions_Visible,Pragma External,Pragma Extensions_Allowed,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas id12}@anchor{63}@anchor{gnat_rm/implementation_defined_pragmas pragma-extensions-visible}@anchor{64} +@anchor{gnat_rm/implementation_defined_pragmas id12}@anchor{64}@anchor{gnat_rm/implementation_defined_pragmas pragma-extensions-visible}@anchor{65} @section Pragma Extensions_Visible @@ -3481,7 +3501,7 @@ For the semantics of this pragma, see the entry for aspect @cite{Extensions_Visi in the SPARK 2014 Reference Manual, section 6.1.7. @node Pragma External,Pragma External_Name_Casing,Pragma Extensions_Visible,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-external}@anchor{65} +@anchor{gnat_rm/implementation_defined_pragmas pragma-external}@anchor{66} @section Pragma External @@ -3502,7 +3522,7 @@ used this pragma for exactly the same purposes as pragma @cite{Export} before the latter was standardized. @node Pragma External_Name_Casing,Pragma Fast_Math,Pragma External,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-external-name-casing}@anchor{66} +@anchor{gnat_rm/implementation_defined_pragmas pragma-external-name-casing}@anchor{67} @section Pragma External_Name_Casing @@ -3591,7 +3611,7 @@ pragma External_Name_Casing (Uppercase, Uppercase); to enforce the upper casing of all external symbols. @node Pragma Fast_Math,Pragma Favor_Top_Level,Pragma External_Name_Casing,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-fast-math}@anchor{67} +@anchor{gnat_rm/implementation_defined_pragmas pragma-fast-math}@anchor{68} @section Pragma Fast_Math @@ -3620,7 +3640,7 @@ under control of the pragma, rather than use the preinstantiated versions. @end table @node Pragma Favor_Top_Level,Pragma Finalize_Storage_Only,Pragma Fast_Math,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas id13}@anchor{68}@anchor{gnat_rm/implementation_defined_pragmas pragma-favor-top-level}@anchor{69} +@anchor{gnat_rm/implementation_defined_pragmas id13}@anchor{69}@anchor{gnat_rm/implementation_defined_pragmas pragma-favor-top-level}@anchor{6a} @section Pragma Favor_Top_Level @@ -3630,17 +3650,16 @@ Syntax: pragma Favor_Top_Level (type_NAME); @end example -The named type must be an access-to-subprogram type. This pragma is an -efficiency hint to the compiler, regarding the use of 'Access or -'Unrestricted_Access on nested (non-library-level) subprograms. The -pragma means that nested subprograms are not used with this type, or -are rare, so that the generated code should be efficient in the -top-level case. When this pragma is used, dynamically generated -trampolines may be used on some targets for nested subprograms. -See also the No_Implicit_Dynamic_Code restriction. +The argument of pragma @cite{Favor_Top_Level} must be a named access-to-subprogram +type. This pragma is an efficiency hint to the compiler, regarding the use of +@cite{'Access} or @cite{'Unrestricted_Access} on nested (non-library-level) subprograms. +The pragma means that nested subprograms are not used with this type, or are +rare, so that the generated code should be efficient in the top-level case. +When this pragma is used, dynamically generated trampolines may be used on some +targets for nested subprograms. See restriction @cite{No_Implicit_Dynamic_Code}. @node Pragma Finalize_Storage_Only,Pragma Float_Representation,Pragma Favor_Top_Level,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-finalize-storage-only}@anchor{6a} +@anchor{gnat_rm/implementation_defined_pragmas pragma-finalize-storage-only}@anchor{6b} @section Pragma Finalize_Storage_Only @@ -3650,14 +3669,17 @@ Syntax: pragma Finalize_Storage_Only (first_subtype_LOCAL_NAME); @end example -This pragma allows the compiler not to emit a Finalize call for objects -defined at the library level. This is mostly useful for types where -finalization is only used to deal with storage reclamation since in most -environments it is not necessary to reclaim memory just before terminating -execution, hence the name. +The argument of pragma @cite{Finalize_Storage_Only} must denote a local type which +is derived from @cite{Ada.Finalization.Controlled} or @cite{Limited_Controlled}. The +pragma suppresses the call to @cite{Finalize} for declared library-level objects +of the argument type. This is mostly useful for types where finalization is +only used to deal with storage reclamation since in most environments it is +not necessary to reclaim memory just before terminating execution, hence the +name. Note that this pragma does not suppress Finalize calls for library-level +heap-allocated objects (see pragma @cite{No_Heap_Finalization}). @node Pragma Float_Representation,Pragma Ghost,Pragma Finalize_Storage_Only,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-float-representation}@anchor{6b} +@anchor{gnat_rm/implementation_defined_pragmas pragma-float-representation}@anchor{6c} @section Pragma Float_Representation @@ -3692,7 +3714,7 @@ No other value of digits is permitted. @end itemize @node Pragma Ghost,Pragma Global,Pragma Float_Representation,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-ghost}@anchor{6c}@anchor{gnat_rm/implementation_defined_pragmas id14}@anchor{6d} +@anchor{gnat_rm/implementation_defined_pragmas pragma-ghost}@anchor{6d}@anchor{gnat_rm/implementation_defined_pragmas id14}@anchor{6e} @section Pragma Ghost @@ -3706,7 +3728,7 @@ For the semantics of this pragma, see the entry for aspect @cite{Ghost} in the S 2014 Reference Manual, section 6.9. @node Pragma Global,Pragma Ident,Pragma Ghost,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-global}@anchor{6e}@anchor{gnat_rm/implementation_defined_pragmas id15}@anchor{6f} +@anchor{gnat_rm/implementation_defined_pragmas pragma-global}@anchor{6f}@anchor{gnat_rm/implementation_defined_pragmas id15}@anchor{70} @section Pragma Global @@ -3731,7 +3753,7 @@ For the semantics of this pragma, see the entry for aspect @cite{Global} in the SPARK 2014 Reference Manual, section 6.1.4. @node Pragma Ident,Pragma Ignore_Pragma,Pragma Global,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-ident}@anchor{70} +@anchor{gnat_rm/implementation_defined_pragmas pragma-ident}@anchor{71} @section Pragma Ident @@ -3745,7 +3767,7 @@ This pragma is identical in effect to pragma @cite{Comment}. It is provided for compatibility with other Ada compilers providing this pragma. @node Pragma Ignore_Pragma,Pragma Implementation_Defined,Pragma Ident,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-ignore-pragma}@anchor{71} +@anchor{gnat_rm/implementation_defined_pragmas pragma-ignore-pragma}@anchor{72} @section Pragma Ignore_Pragma @@ -3765,7 +3787,7 @@ pragma allows such pragmas to be ignored, which may be useful in @cite{CodePeer} mode, or during porting of legacy code. @node Pragma Implementation_Defined,Pragma Implemented,Pragma Ignore_Pragma,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-implementation-defined}@anchor{72} +@anchor{gnat_rm/implementation_defined_pragmas pragma-implementation-defined}@anchor{73} @section Pragma Implementation_Defined @@ -3792,7 +3814,7 @@ for the purpose of implementing the No_Implementation_Identifiers restriction. @node Pragma Implemented,Pragma Implicit_Packing,Pragma Implementation_Defined,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-implemented}@anchor{73} +@anchor{gnat_rm/implementation_defined_pragmas pragma-implemented}@anchor{74} @section Pragma Implemented @@ -3838,7 +3860,7 @@ By_Any shares the behavior of By_Entry and By_Protected_Procedure depending on the target's overriding subprogram kind. @node Pragma Implicit_Packing,Pragma Import_Function,Pragma Implemented,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-implicit-packing}@anchor{74} +@anchor{gnat_rm/implementation_defined_pragmas pragma-implicit-packing}@anchor{75} @section Pragma Implicit_Packing @@ -3892,7 +3914,7 @@ sufficient. The use of pragma Implicit_Packing allows this record declaration to compile without an explicit pragma Pack. @node Pragma Import_Function,Pragma Import_Object,Pragma Implicit_Packing,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-import-function}@anchor{75} +@anchor{gnat_rm/implementation_defined_pragmas pragma-import-function}@anchor{76} @section Pragma Import_Function @@ -3957,7 +3979,7 @@ notation. If the mechanism is not specified, the default mechanism is used. @node Pragma Import_Object,Pragma Import_Procedure,Pragma Import_Function,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-import-object}@anchor{76} +@anchor{gnat_rm/implementation_defined_pragmas pragma-import-object}@anchor{77} @section Pragma Import_Object @@ -3983,7 +4005,7 @@ point of view). @cite{size} is syntax checked, but otherwise ignored by GNAT. @node Pragma Import_Procedure,Pragma Import_Valued_Procedure,Pragma Import_Object,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-import-procedure}@anchor{77} +@anchor{gnat_rm/implementation_defined_pragmas pragma-import-procedure}@anchor{78} @section Pragma Import_Procedure @@ -4023,7 +4045,7 @@ applies to a procedure rather than a function and the parameters @cite{Result_Type} and @cite{Result_Mechanism} are not permitted. @node Pragma Import_Valued_Procedure,Pragma Independent,Pragma Import_Procedure,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-import-valued-procedure}@anchor{78} +@anchor{gnat_rm/implementation_defined_pragmas pragma-import-valued-procedure}@anchor{79} @section Pragma Import_Valued_Procedure @@ -4076,7 +4098,7 @@ pragma Import that specifies the desired convention, since otherwise the default convention is Ada, which is almost certainly not what is required. @node Pragma Independent,Pragma Independent_Components,Pragma Import_Valued_Procedure,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-independent}@anchor{79} +@anchor{gnat_rm/implementation_defined_pragmas pragma-independent}@anchor{7a} @section Pragma Independent @@ -4098,7 +4120,7 @@ constraints on the representation of the object (for instance prohibiting tight packing). @node Pragma Independent_Components,Pragma Initial_Condition,Pragma Independent,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-independent-components}@anchor{7a} +@anchor{gnat_rm/implementation_defined_pragmas pragma-independent-components}@anchor{7b} @section Pragma Independent_Components @@ -4119,7 +4141,7 @@ constraints on the representation of the object (for instance prohibiting tight packing). @node Pragma Initial_Condition,Pragma Initialize_Scalars,Pragma Independent_Components,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas id16}@anchor{7b}@anchor{gnat_rm/implementation_defined_pragmas pragma-initial-condition}@anchor{7c} +@anchor{gnat_rm/implementation_defined_pragmas id16}@anchor{7c}@anchor{gnat_rm/implementation_defined_pragmas pragma-initial-condition}@anchor{7d} @section Pragma Initial_Condition @@ -4133,7 +4155,7 @@ For the semantics of this pragma, see the entry for aspect @cite{Initial_Conditi in the SPARK 2014 Reference Manual, section 7.1.6. @node Pragma Initialize_Scalars,Pragma Initializes,Pragma Initial_Condition,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-initialize-scalars}@anchor{7d} +@anchor{gnat_rm/implementation_defined_pragmas pragma-initialize-scalars}@anchor{7e} @section Pragma Initialize_Scalars @@ -4196,7 +4218,7 @@ checking (see description of stack checking in the GNAT User's Guide) when using this pragma. @node Pragma Initializes,Pragma Inline_Always,Pragma Initialize_Scalars,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-initializes}@anchor{7e}@anchor{gnat_rm/implementation_defined_pragmas id17}@anchor{7f} +@anchor{gnat_rm/implementation_defined_pragmas pragma-initializes}@anchor{7f}@anchor{gnat_rm/implementation_defined_pragmas id17}@anchor{80} @section Pragma Initializes @@ -4223,7 +4245,7 @@ For the semantics of this pragma, see the entry for aspect @cite{Initializes} in SPARK 2014 Reference Manual, section 7.1.5. @node Pragma Inline_Always,Pragma Inline_Generic,Pragma Initializes,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas id18}@anchor{80}@anchor{gnat_rm/implementation_defined_pragmas pragma-inline-always}@anchor{81} +@anchor{gnat_rm/implementation_defined_pragmas id18}@anchor{81}@anchor{gnat_rm/implementation_defined_pragmas pragma-inline-always}@anchor{82} @section Pragma Inline_Always @@ -4233,12 +4255,16 @@ Syntax: pragma Inline_Always (NAME [, NAME]); @end example -Similar to pragma @cite{Inline} except that inlining is not subject to -the use of option @emph{-gnatn} or @emph{-gnatN} and the inlining -happens regardless of whether these options are used. +Similar to pragma @cite{Inline} except that inlining is unconditional. +Inline_Always instructs the compiler to inline every direct call to the +subprogram or else to emit a compilation error, independently of any +option, in particular @emph{-gnatn} or @emph{-gnatN} or the optimization level. +It is an error to take the address or access of @cite{NAME}. It is also an error to +apply this pragma to a primitive operation of a tagged type. Thanks to such +restrictions, the compiler is allowed to remove the out-of-line body of @cite{NAME}. @node Pragma Inline_Generic,Pragma Interface,Pragma Inline_Always,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-inline-generic}@anchor{82} +@anchor{gnat_rm/implementation_defined_pragmas pragma-inline-generic}@anchor{83} @section Pragma Inline_Generic @@ -4256,7 +4282,7 @@ than to check that the given names are all names of generic units or generic instances. @node Pragma Interface,Pragma Interface_Name,Pragma Inline_Generic,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-interface}@anchor{83} +@anchor{gnat_rm/implementation_defined_pragmas pragma-interface}@anchor{84} @section Pragma Interface @@ -4283,7 +4309,7 @@ maintaining Ada 83/Ada 95 compatibility and is compatible with other Ada 83 compilers. @node Pragma Interface_Name,Pragma Interrupt_Handler,Pragma Interface,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-interface-name}@anchor{84} +@anchor{gnat_rm/implementation_defined_pragmas pragma-interface-name}@anchor{85} @section Pragma Interface_Name @@ -4302,7 +4328,7 @@ for an interfaced subprogram, and is provided for compatibility with Ada least one of @cite{External_Name} or @cite{Link_Name}. @node Pragma Interrupt_Handler,Pragma Interrupt_State,Pragma Interface_Name,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-interrupt-handler}@anchor{85} +@anchor{gnat_rm/implementation_defined_pragmas pragma-interrupt-handler}@anchor{86} @section Pragma Interrupt_Handler @@ -4322,7 +4348,7 @@ when this pragma is applied to a nonprotected procedure, the instruction maskable interrupts, in place of the normal return instruction. @node Pragma Interrupt_State,Pragma Invariant,Pragma Interrupt_Handler,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-interrupt-state}@anchor{86} +@anchor{gnat_rm/implementation_defined_pragmas pragma-interrupt-state}@anchor{87} @section Pragma Interrupt_State @@ -4362,7 +4388,9 @@ System The interrupt is reserved (no Ada handler can be installed), and the Ada run-time may not install a handler. As a result you are guaranteed -standard system default action if this interrupt is raised. +standard system default action if this interrupt is raised. This also allows +installing a low level handler via C APIs such as sigaction(), outside +of Ada control. @item Runtime @@ -4374,7 +4402,8 @@ not required to do so. @item User -The interrupt is unreserved. The user may install a handler to provide +The interrupt is unreserved. The user may install an Ada handler via +Ada.Interrupts and pragma Interrupt_Handler or Attach_Handler to provide some other action. @end itemize @@ -4405,7 +4434,7 @@ with an application's runtime behavior in the cases of the synchronous signals, and in the case of the signal used to implement the @cite{abort} statement. @node Pragma Invariant,Pragma Keep_Names,Pragma Interrupt_State,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas id19}@anchor{87}@anchor{gnat_rm/implementation_defined_pragmas pragma-invariant}@anchor{88} +@anchor{gnat_rm/implementation_defined_pragmas id19}@anchor{88}@anchor{gnat_rm/implementation_defined_pragmas pragma-invariant}@anchor{89} @section Pragma Invariant @@ -4444,7 +4473,7 @@ For further details on the use of this pragma, see the Ada 2012 documentation of the Type_Invariant aspect. @node Pragma Keep_Names,Pragma License,Pragma Invariant,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-keep-names}@anchor{89} +@anchor{gnat_rm/implementation_defined_pragmas pragma-keep-names}@anchor{8a} @section Pragma Keep_Names @@ -4464,7 +4493,7 @@ use a @cite{Discard_Names} pragma in the @code{gnat.adc} file, but you want to retain the names for specific enumeration types. @node Pragma License,Pragma Link_With,Pragma Keep_Names,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-license}@anchor{8a} +@anchor{gnat_rm/implementation_defined_pragmas pragma-license}@anchor{8b} @section Pragma License @@ -4559,7 +4588,7 @@ GPL, but no warning for @cite{GNAT.Sockets} which is part of the GNAT run time, and is therefore licensed under the modified GPL. @node Pragma Link_With,Pragma Linker_Alias,Pragma License,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-link-with}@anchor{8b} +@anchor{gnat_rm/implementation_defined_pragmas pragma-link-with}@anchor{8c} @section Pragma Link_With @@ -4583,7 +4612,7 @@ separate arguments to the linker. In addition pragma Link_With allows multiple arguments, with the same effect as successive pragmas. @node Pragma Linker_Alias,Pragma Linker_Constructor,Pragma Link_With,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-linker-alias}@anchor{8c} +@anchor{gnat_rm/implementation_defined_pragmas pragma-linker-alias}@anchor{8d} @section Pragma Linker_Alias @@ -4624,7 +4653,7 @@ end p; @end example @node Pragma Linker_Constructor,Pragma Linker_Destructor,Pragma Linker_Alias,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-linker-constructor}@anchor{8d} +@anchor{gnat_rm/implementation_defined_pragmas pragma-linker-constructor}@anchor{8e} @section Pragma Linker_Constructor @@ -4654,7 +4683,7 @@ listed above. Where possible, the use of Stand Alone Libraries is preferable to the use of this pragma. @node Pragma Linker_Destructor,Pragma Linker_Section,Pragma Linker_Constructor,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-linker-destructor}@anchor{8e} +@anchor{gnat_rm/implementation_defined_pragmas pragma-linker-destructor}@anchor{8f} @section Pragma Linker_Destructor @@ -4677,7 +4706,7 @@ See @cite{pragma Linker_Constructor} for the set of restrictions that apply because of these specific contexts. @node Pragma Linker_Section,Pragma Lock_Free,Pragma Linker_Destructor,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas id20}@anchor{8f}@anchor{gnat_rm/implementation_defined_pragmas pragma-linker-section}@anchor{90} +@anchor{gnat_rm/implementation_defined_pragmas id20}@anchor{90}@anchor{gnat_rm/implementation_defined_pragmas pragma-linker-section}@anchor{91} @section Pragma Linker_Section @@ -4751,7 +4780,7 @@ end IO_Card; @end example @node Pragma Lock_Free,Pragma Loop_Invariant,Pragma Linker_Section,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas id21}@anchor{91}@anchor{gnat_rm/implementation_defined_pragmas pragma-lock-free}@anchor{92} +@anchor{gnat_rm/implementation_defined_pragmas id21}@anchor{92}@anchor{gnat_rm/implementation_defined_pragmas pragma-lock-free}@anchor{93} @section Pragma Lock_Free @@ -4762,7 +4791,7 @@ Compilation fails if the compiler cannot generate lock-free code for the operations. @node Pragma Loop_Invariant,Pragma Loop_Optimize,Pragma Lock_Free,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-loop-invariant}@anchor{93} +@anchor{gnat_rm/implementation_defined_pragmas pragma-loop-invariant}@anchor{94} @section Pragma Loop_Invariant @@ -4795,7 +4824,7 @@ attribute can only be used within the expression of a @cite{Loop_Invariant} pragma. For full details, see documentation of attribute @cite{Loop_Entry}. @node Pragma Loop_Optimize,Pragma Loop_Variant,Pragma Loop_Invariant,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-loop-optimize}@anchor{94} +@anchor{gnat_rm/implementation_defined_pragmas pragma-loop-optimize}@anchor{95} @section Pragma Loop_Optimize @@ -4857,7 +4886,7 @@ compiler in order to enable the relevant optimizations, that is to say vectorization. @node Pragma Loop_Variant,Pragma Machine_Attribute,Pragma Loop_Optimize,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-loop-variant}@anchor{95} +@anchor{gnat_rm/implementation_defined_pragmas pragma-loop-variant}@anchor{96} @section Pragma Loop_Variant @@ -4904,7 +4933,7 @@ The @cite{Loop_Entry} attribute may be used within the expressions of the @cite{Loop_Variant} pragma to refer to values on entry to the loop. @node Pragma Machine_Attribute,Pragma Main,Pragma Loop_Variant,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-machine-attribute}@anchor{96} +@anchor{gnat_rm/implementation_defined_pragmas pragma-machine-attribute}@anchor{97} @section Pragma Machine_Attribute @@ -4929,7 +4958,7 @@ for some attributes. For further information see @cite{GNU Compiler Collection (GCC) Internals}. @node Pragma Main,Pragma Main_Storage,Pragma Machine_Attribute,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-main}@anchor{97} +@anchor{gnat_rm/implementation_defined_pragmas pragma-main}@anchor{98} @section Pragma Main @@ -4949,7 +4978,7 @@ This pragma is provided for compatibility with OpenVMS VAX Systems. It has no effect in GNAT, other than being syntax checked. @node Pragma Main_Storage,Pragma Max_Queue_Length,Pragma Main,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-main-storage}@anchor{98} +@anchor{gnat_rm/implementation_defined_pragmas pragma-main-storage}@anchor{99} @section Pragma Main_Storage @@ -4968,7 +4997,7 @@ This pragma is provided for compatibility with OpenVMS VAX Systems. It has no effect in GNAT, other than being syntax checked. @node Pragma Max_Queue_Length,Pragma No_Body,Pragma Main_Storage,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-max-queue-length}@anchor{99} +@anchor{gnat_rm/implementation_defined_pragmas pragma-max-queue-length}@anchor{9a} @section Pragma Max_Queue_Length @@ -4984,7 +5013,7 @@ positive integer as a parameter and must appear after the declaration of an entry. @node Pragma No_Body,Pragma No_Elaboration_Code_All,Pragma Max_Queue_Length,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-no-body}@anchor{9a} +@anchor{gnat_rm/implementation_defined_pragmas pragma-no-body}@anchor{9b} @section Pragma No_Body @@ -5006,8 +5035,8 @@ such a way that a body needed before is no longer needed. The provision of a dummy body with a No_Body pragma ensures that there is no interference from earlier versions of the package body. -@node Pragma No_Elaboration_Code_All,Pragma No_Inline,Pragma No_Body,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas id22}@anchor{9b}@anchor{gnat_rm/implementation_defined_pragmas pragma-no-elaboration-code-all}@anchor{9c} +@node Pragma No_Elaboration_Code_All,Pragma No_Heap_Finalization,Pragma No_Body,Implementation Defined Pragmas +@anchor{gnat_rm/implementation_defined_pragmas id22}@anchor{9c}@anchor{gnat_rm/implementation_defined_pragmas pragma-no-elaboration-code-all}@anchor{9d} @section Pragma No_Elaboration_Code_All @@ -5019,14 +5048,46 @@ pragma No_Elaboration_Code_All [(program_unit_NAME)]; This is a program unit pragma (there is also an equivalent aspect of the same name) that establishes the restriction @cite{No_Elaboration_Code} for -the current unit and any extended main source units (body and subunits. -It also has has the effect of enforcing a transitive application of this -aspect, so that if any unit is implicitly or explicitly WITH'ed by the +the current unit and any extended main source units (body and subunits). +It also has the effect of enforcing a transitive application of this +aspect, so that if any unit is implicitly or explicitly with'ed by the current unit, it must also have the No_Elaboration_Code_All aspect set. It may be applied to package or subprogram specs or their generic versions. -@node Pragma No_Inline,Pragma No_Return,Pragma No_Elaboration_Code_All,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-no-inline}@anchor{9d} +@node Pragma No_Heap_Finalization,Pragma No_Inline,Pragma No_Elaboration_Code_All,Implementation Defined Pragmas +@anchor{gnat_rm/implementation_defined_pragmas pragma-no-heap-finalization}@anchor{9e} +@section Pragma No_Heap_Finalization + + +Syntax: + +@example +pragma No_Heap_Finalization [ (first_subtype_LOCAL_NAME) ]; +@end example + +Pragma @cite{No_Heap_Finalization} may be used as a configuration pragma or as a +type-specific pragma. + +In its configuration form, the pragma must appear within a configuration file +such as gnat.adc, without an argument. The pragma suppresses the call to +@cite{Finalize} for heap-allocated objects created through library-level named +access-to-object types in cases where the designated type requires finalization +actions. + +In its type-specific form, the argument of the pragma must denote a +library-level named access-to-object type. The pragma suppresses the call to +@cite{Finalize} for heap-allocated objects created through the specific access type +in cases where the designated type requires finalization actions. + +It is still possible to finalize such heap-allocated objects by explicitly +deallocating them. + +A library-level named access-to-object type declared within a generic unit will +lose its @cite{No_Heap_Finalization} pragma when the corresponding instance does not +appear at the library level. + +@node Pragma No_Inline,Pragma No_Return,Pragma No_Heap_Finalization,Implementation Defined Pragmas +@anchor{gnat_rm/implementation_defined_pragmas pragma-no-inline}@anchor{9f} @section Pragma No_Inline @@ -5044,7 +5105,7 @@ in particular it is not subject to the use of option @emph{-gnatn} or pragma @cite{Inline_Always} for the same @cite{NAME}. @node Pragma No_Return,Pragma No_Run_Time,Pragma No_Inline,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-no-return}@anchor{9e} +@anchor{gnat_rm/implementation_defined_pragmas pragma-no-return}@anchor{a0} @section Pragma No_Return @@ -5071,7 +5132,7 @@ available in all earlier versions of Ada as an implementation-defined pragma. @node Pragma No_Run_Time,Pragma No_Strict_Aliasing,Pragma No_Return,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-no-run-time}@anchor{9f} +@anchor{gnat_rm/implementation_defined_pragmas pragma-no-run-time}@anchor{a1} @section Pragma No_Run_Time @@ -5087,7 +5148,7 @@ internal testing. The pragma has been superseded by the reconfigurable runtime capability of @cite{GNAT}. @node Pragma No_Strict_Aliasing,Pragma No_Tagged_Streams,Pragma No_Run_Time,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-no-strict-aliasing}@anchor{a0} +@anchor{gnat_rm/implementation_defined_pragmas pragma-no-strict-aliasing}@anchor{a2} @section Pragma No_Strict_Aliasing @@ -5109,7 +5170,7 @@ in the @cite{GNAT User's Guide}. This pragma currently has no effects on access to unconstrained array types. @node Pragma No_Tagged_Streams,Pragma Normalize_Scalars,Pragma No_Strict_Aliasing,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-no-tagged-streams}@anchor{a1}@anchor{gnat_rm/implementation_defined_pragmas id23}@anchor{a2} +@anchor{gnat_rm/implementation_defined_pragmas pragma-no-tagged-streams}@anchor{a3}@anchor{gnat_rm/implementation_defined_pragmas id23}@anchor{a4} @section Pragma No_Tagged_Streams @@ -5144,7 +5205,7 @@ applies to a complete hierarchy (this is necessary to deal with the class-wide dispatching versions of the stream routines). @node Pragma Normalize_Scalars,Pragma Obsolescent,Pragma No_Tagged_Streams,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-normalize-scalars}@anchor{a3} +@anchor{gnat_rm/implementation_defined_pragmas pragma-normalize-scalars}@anchor{a5} @section Pragma Normalize_Scalars @@ -5226,7 +5287,7 @@ will always generate an invalid value if one exists. @end table @node Pragma Obsolescent,Pragma Optimize_Alignment,Pragma Normalize_Scalars,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-obsolescent}@anchor{a4}@anchor{gnat_rm/implementation_defined_pragmas id24}@anchor{a5} +@anchor{gnat_rm/implementation_defined_pragmas pragma-obsolescent}@anchor{a6}@anchor{gnat_rm/implementation_defined_pragmas id24}@anchor{a7} @section Pragma Obsolescent @@ -5322,7 +5383,7 @@ So if you specify "Entity =>" for the Entity argument, and a Message argument is present, it must be preceded by "Message =>". @node Pragma Optimize_Alignment,Pragma Ordered,Pragma Obsolescent,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-optimize-alignment}@anchor{a6} +@anchor{gnat_rm/implementation_defined_pragmas pragma-optimize-alignment}@anchor{a8} @section Pragma Optimize_Alignment @@ -5405,7 +5466,7 @@ latter are compiled by default in pragma Optimize_Alignment (Off) mode if no pragma appears at the start of the file. @node Pragma Ordered,Pragma Overflow_Mode,Pragma Optimize_Alignment,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-ordered}@anchor{a7} +@anchor{gnat_rm/implementation_defined_pragmas pragma-ordered}@anchor{a9} @section Pragma Ordered @@ -5497,7 +5558,7 @@ For additional information please refer to the description of the @emph{-gnatw.u} switch in the GNAT User's Guide. @node Pragma Overflow_Mode,Pragma Overriding_Renamings,Pragma Ordered,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-overflow-mode}@anchor{a8} +@anchor{gnat_rm/implementation_defined_pragmas pragma-overflow-mode}@anchor{aa} @section Pragma Overflow_Mode @@ -5536,7 +5597,7 @@ The pragma @cite{Unsuppress (Overflow_Check)} unsuppresses (enables) overflow checking, but does not affect the overflow mode. @node Pragma Overriding_Renamings,Pragma Partition_Elaboration_Policy,Pragma Overflow_Mode,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-overriding-renamings}@anchor{a9} +@anchor{gnat_rm/implementation_defined_pragmas pragma-overriding-renamings}@anchor{ab} @section Pragma Overriding_Renamings @@ -5571,7 +5632,7 @@ RM 8.3 (15) stipulates that an overridden operation is not visible within the declaration of the overriding operation. @node Pragma Partition_Elaboration_Policy,Pragma Part_Of,Pragma Overriding_Renamings,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-partition-elaboration-policy}@anchor{aa} +@anchor{gnat_rm/implementation_defined_pragmas pragma-partition-elaboration-policy}@anchor{ac} @section Pragma Partition_Elaboration_Policy @@ -5588,7 +5649,7 @@ versions of Ada as an implementation-defined pragma. See Ada 2012 Reference Manual for details. @node Pragma Part_Of,Pragma Passive,Pragma Partition_Elaboration_Policy,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas id25}@anchor{ab}@anchor{gnat_rm/implementation_defined_pragmas pragma-part-of}@anchor{ac} +@anchor{gnat_rm/implementation_defined_pragmas id25}@anchor{ad}@anchor{gnat_rm/implementation_defined_pragmas pragma-part-of}@anchor{ae} @section Pragma Part_Of @@ -5604,7 +5665,7 @@ For the semantics of this pragma, see the entry for aspect @cite{Part_Of} in the SPARK 2014 Reference Manual, section 7.2.6. @node Pragma Passive,Pragma Persistent_BSS,Pragma Part_Of,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-passive}@anchor{ad} +@anchor{gnat_rm/implementation_defined_pragmas pragma-passive}@anchor{af} @section Pragma Passive @@ -5628,7 +5689,7 @@ For more information on the subject of passive tasks, see the section 'Passive Task Optimization' in the GNAT Users Guide. @node Pragma Persistent_BSS,Pragma Polling,Pragma Passive,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-persistent-bss}@anchor{ae}@anchor{gnat_rm/implementation_defined_pragmas id26}@anchor{af} +@anchor{gnat_rm/implementation_defined_pragmas pragma-persistent-bss}@anchor{b0}@anchor{gnat_rm/implementation_defined_pragmas id26}@anchor{b1} @section Pragma Persistent_BSS @@ -5659,7 +5720,7 @@ If this pragma is used on a target where this feature is not supported, then the pragma will be ignored. See also @cite{pragma Linker_Section}. @node Pragma Polling,Pragma Post,Pragma Persistent_BSS,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-polling}@anchor{b0} +@anchor{gnat_rm/implementation_defined_pragmas pragma-polling}@anchor{b2} @section Pragma Polling @@ -5701,7 +5762,7 @@ Note that polling can also be enabled by use of the @emph{-gnatP} switch. See the section on switches for gcc in the @cite{GNAT User's Guide}. @node Pragma Post,Pragma Postcondition,Pragma Polling,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-post}@anchor{b1} +@anchor{gnat_rm/implementation_defined_pragmas pragma-post}@anchor{b3} @section Pragma Post @@ -5726,7 +5787,7 @@ appear at the start of the declarations in a subprogram body (preceded only by other pragmas). @node Pragma Postcondition,Pragma Post_Class,Pragma Post,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-postcondition}@anchor{b2} +@anchor{gnat_rm/implementation_defined_pragmas pragma-postcondition}@anchor{b4} @section Pragma Postcondition @@ -5891,7 +5952,7 @@ Ada 2012, and has been retained in its original form for compatibility purposes. @node Pragma Post_Class,Pragma Rename_Pragma,Pragma Postcondition,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-post-class}@anchor{b3} +@anchor{gnat_rm/implementation_defined_pragmas pragma-post-class}@anchor{b5} @section Pragma Post_Class @@ -5926,7 +5987,7 @@ policy that controls this pragma is @cite{Post'Class}, not @cite{Post_Class}. @node Pragma Rename_Pragma,Pragma Pre,Pragma Post_Class,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-rename-pragma}@anchor{b4} +@anchor{gnat_rm/implementation_defined_pragmas pragma-rename-pragma}@anchor{b6} @section Pragma Rename_Pragma @@ -5965,7 +6026,7 @@ Pragma Inline_Only will not necessarily mean the same thing as the other Ada compiler; it's up to you to make sure the semantics are close enough. @node Pragma Pre,Pragma Precondition,Pragma Rename_Pragma,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-pre}@anchor{b5} +@anchor{gnat_rm/implementation_defined_pragmas pragma-pre}@anchor{b7} @section Pragma Pre @@ -5990,7 +6051,7 @@ appear at the start of the declarations in a subprogram body (preceded only by other pragmas). @node Pragma Precondition,Pragma Predicate,Pragma Pre,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-precondition}@anchor{b6} +@anchor{gnat_rm/implementation_defined_pragmas pragma-precondition}@anchor{b8} @section Pragma Precondition @@ -6049,7 +6110,7 @@ Ada 2012, and has been retained in its original form for compatibility purposes. @node Pragma Predicate,Pragma Predicate_Failure,Pragma Precondition,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-predicate}@anchor{b7}@anchor{gnat_rm/implementation_defined_pragmas id27}@anchor{b8} +@anchor{gnat_rm/implementation_defined_pragmas pragma-predicate}@anchor{b9}@anchor{gnat_rm/implementation_defined_pragmas id27}@anchor{ba} @section Pragma Predicate @@ -6103,7 +6164,7 @@ defined for subtype B). When following this approach, the use of predicates should be avoided. @node Pragma Predicate_Failure,Pragma Preelaborable_Initialization,Pragma Predicate,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-predicate-failure}@anchor{b9} +@anchor{gnat_rm/implementation_defined_pragmas pragma-predicate-failure}@anchor{bb} @section Pragma Predicate_Failure @@ -6120,7 +6181,7 @@ 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{ba} +@anchor{gnat_rm/implementation_defined_pragmas pragma-preelaborable-initialization}@anchor{bc} @section Pragma Preelaborable_Initialization @@ -6135,7 +6196,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{bb} +@anchor{gnat_rm/implementation_defined_pragmas pragma-prefix-exception-messages}@anchor{bd} @section Pragma Prefix_Exception_Messages @@ -6166,7 +6227,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{bc} +@anchor{gnat_rm/implementation_defined_pragmas pragma-pre-class}@anchor{be} @section Pragma Pre_Class @@ -6201,7 +6262,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{bd} +@anchor{gnat_rm/implementation_defined_pragmas pragma-priority-specific-dispatching}@anchor{bf} @section Pragma Priority_Specific_Dispatching @@ -6225,21 +6286,23 @@ 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{be} +@anchor{gnat_rm/implementation_defined_pragmas pragma-profile}@anchor{c0} @section Pragma Profile Syntax: @example -pragma Profile (Ravenscar | Restricted | Rational | GNAT_Extended_Ravenscar); +pragma Profile (Ravenscar | Restricted | Rational | + GNAT_Extended_Ravenscar | GNAT_Ravenscar_EDF ); @end example This pragma is standard in Ada 2005, but is available in all earlier versions of Ada as an implementation-defined pragma. This is a configuration pragma that establishes a set of configuration pragmas that depend on the argument. @cite{Ravenscar} is standard in Ada 2005. -The other possibilities (@cite{Restricted}, @cite{Rational}, @cite{GNAT_Extended_Ravenscar}) +The other possibilities (@cite{Restricted}, @cite{Rational}, +@cite{GNAT_Extended_Ravenscar}, @cite{GNAT_Ravenscar_EDF}) are implementation-defined. The set of configuration pragmas is defined in the following sections. @@ -6410,6 +6473,12 @@ The @code{Simple_Barriers} restriction has been replaced by The @code{Max_Protected_Entries}, @code{Max_Entry_Queue_Length}, and @code{No_Relative_Delay} restrictions have been removed. +@item +Pragma Profile (GNAT_Ravenscar_EDF) + +This profile corresponds to the Ravenscar profile but using +EDF_Across_Priority as the Task_Scheduling_Policy. + @item Pragma Profile (Restricted) @@ -6491,7 +6560,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{bf} +@anchor{gnat_rm/implementation_defined_pragmas pragma-profile-warnings}@anchor{c1} @section Pragma Profile_Warnings @@ -6509,7 +6578,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{c0} +@anchor{gnat_rm/implementation_defined_pragmas pragma-propagate-exceptions}@anchor{c2} @section Pragma Propagate_Exceptions @@ -6528,7 +6597,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{c1} +@anchor{gnat_rm/implementation_defined_pragmas pragma-provide-shift-operators}@anchor{c3} @section Pragma Provide_Shift_Operators @@ -6548,7 +6617,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{c2} +@anchor{gnat_rm/implementation_defined_pragmas pragma-psect-object}@anchor{c4} @section Pragma Psect_Object @@ -6568,7 +6637,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{c3}@anchor{gnat_rm/implementation_defined_pragmas id28}@anchor{c4} +@anchor{gnat_rm/implementation_defined_pragmas pragma-pure-function}@anchor{c5}@anchor{gnat_rm/implementation_defined_pragmas id28}@anchor{c6} @section Pragma Pure_Function @@ -6630,7 +6699,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{c5} +@anchor{gnat_rm/implementation_defined_pragmas pragma-rational}@anchor{c7} @section Pragma Rational @@ -6648,7 +6717,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{c6} +@anchor{gnat_rm/implementation_defined_pragmas pragma-ravenscar}@anchor{c8} @section Pragma Ravenscar @@ -6668,7 +6737,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 id29}@anchor{c7}@anchor{gnat_rm/implementation_defined_pragmas pragma-refined-depends}@anchor{c8} +@anchor{gnat_rm/implementation_defined_pragmas id29}@anchor{c9}@anchor{gnat_rm/implementation_defined_pragmas pragma-refined-depends}@anchor{ca} @section Pragma Refined_Depends @@ -6701,7 +6770,7 @@ For the semantics of this pragma, see the entry for aspect @cite{Refined_Depends the 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{c9}@anchor{gnat_rm/implementation_defined_pragmas id30}@anchor{ca} +@anchor{gnat_rm/implementation_defined_pragmas pragma-refined-global}@anchor{cb}@anchor{gnat_rm/implementation_defined_pragmas id30}@anchor{cc} @section Pragma Refined_Global @@ -6726,7 +6795,7 @@ For the semantics of this pragma, see the entry for aspect @cite{Refined_Global} the 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{cb}@anchor{gnat_rm/implementation_defined_pragmas id31}@anchor{cc} +@anchor{gnat_rm/implementation_defined_pragmas pragma-refined-post}@anchor{cd}@anchor{gnat_rm/implementation_defined_pragmas id31}@anchor{ce} @section Pragma Refined_Post @@ -6740,7 +6809,7 @@ For the semantics of this pragma, see the entry for aspect @cite{Refined_Post} i the 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{cd}@anchor{gnat_rm/implementation_defined_pragmas id32}@anchor{ce} +@anchor{gnat_rm/implementation_defined_pragmas pragma-refined-state}@anchor{cf}@anchor{gnat_rm/implementation_defined_pragmas id32}@anchor{d0} @section Pragma Refined_State @@ -6766,7 +6835,7 @@ For the semantics of this pragma, see the entry for aspect @cite{Refined_State} the 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{cf} +@anchor{gnat_rm/implementation_defined_pragmas pragma-relative-deadline}@anchor{d1} @section Pragma Relative_Deadline @@ -6781,7 +6850,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 id33}@anchor{d0}@anchor{gnat_rm/implementation_defined_pragmas pragma-remote-access-type}@anchor{d1} +@anchor{gnat_rm/implementation_defined_pragmas id33}@anchor{d2}@anchor{gnat_rm/implementation_defined_pragmas pragma-remote-access-type}@anchor{d3} @section Pragma Remote_Access_Type @@ -6807,7 +6876,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{d2} +@anchor{gnat_rm/implementation_defined_pragmas pragma-restricted-run-time}@anchor{d4} @section Pragma Restricted_Run_Time @@ -6828,7 +6897,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{d3} +@anchor{gnat_rm/implementation_defined_pragmas pragma-restriction-warnings}@anchor{d5} @section Pragma Restriction_Warnings @@ -6866,7 +6935,7 @@ generating a warning, but any other use of implementation defined pragmas will cause a warning to be generated. @node Pragma Reviewable,Pragma Secondary_Stack_Size,Pragma Restriction_Warnings,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-reviewable}@anchor{d4} +@anchor{gnat_rm/implementation_defined_pragmas pragma-reviewable}@anchor{d6} @section Pragma Reviewable @@ -6970,7 +7039,7 @@ comprehensive messages identifying possible problems based on this information. @node Pragma Secondary_Stack_Size,Pragma Share_Generic,Pragma Reviewable,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas id34}@anchor{d5}@anchor{gnat_rm/implementation_defined_pragmas pragma-secondary-stack-size}@anchor{d6} +@anchor{gnat_rm/implementation_defined_pragmas id34}@anchor{d7}@anchor{gnat_rm/implementation_defined_pragmas pragma-secondary-stack-size}@anchor{d8} @section Pragma Secondary_Stack_Size @@ -7006,7 +7075,7 @@ Note the pragma cannot appear when the restriction @cite{No_Secondary_Stack} is in effect. @node Pragma Share_Generic,Pragma Shared,Pragma Secondary_Stack_Size,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-share-generic}@anchor{d7} +@anchor{gnat_rm/implementation_defined_pragmas pragma-share-generic}@anchor{d9} @section Pragma Share_Generic @@ -7024,7 +7093,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 id35}@anchor{d8}@anchor{gnat_rm/implementation_defined_pragmas pragma-shared}@anchor{d9} +@anchor{gnat_rm/implementation_defined_pragmas id35}@anchor{da}@anchor{gnat_rm/implementation_defined_pragmas pragma-shared}@anchor{db} @section Pragma Shared @@ -7032,7 +7101,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{da} +@anchor{gnat_rm/implementation_defined_pragmas pragma-short-circuit-and-or}@anchor{dc} @section Pragma Short_Circuit_And_Or @@ -7051,7 +7120,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{db} +@anchor{gnat_rm/implementation_defined_pragmas pragma-short-descriptors}@anchor{dd} @section Pragma Short_Descriptors @@ -7065,7 +7134,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{dc}@anchor{gnat_rm/implementation_defined_pragmas id36}@anchor{dd} +@anchor{gnat_rm/implementation_defined_pragmas pragma-simple-storage-pool-type}@anchor{de}@anchor{gnat_rm/implementation_defined_pragmas id36}@anchor{df} @section Pragma Simple_Storage_Pool_Type @@ -7119,7 +7188,7 @@ storage-management discipline). An object of a simple storage pool type can be associated with an access type by specifying the attribute -@ref{de,,Simple_Storage_Pool}. For example: +@ref{e0,,Simple_Storage_Pool}. For example: @example My_Pool : My_Simple_Storage_Pool_Type; @@ -7129,11 +7198,11 @@ type Acc is access My_Data_Type; for Acc'Simple_Storage_Pool use My_Pool; @end example -See attribute @ref{de,,Simple_Storage_Pool} +See attribute @ref{e0,,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 id37}@anchor{df}@anchor{gnat_rm/implementation_defined_pragmas pragma-source-file-name}@anchor{e0} +@anchor{gnat_rm/implementation_defined_pragmas id37}@anchor{e1}@anchor{gnat_rm/implementation_defined_pragmas pragma-source-file-name}@anchor{e2} @section Pragma Source_File_Name @@ -7225,19 +7294,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{e1,,Pragma Source_File_Name_Project}. +Source_File_Name cannot appear after a @ref{e3,,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 pragma-source-file-name-project}@anchor{e1}@anchor{gnat_rm/implementation_defined_pragmas id38}@anchor{e2} +@anchor{gnat_rm/implementation_defined_pragmas pragma-source-file-name-project}@anchor{e3}@anchor{gnat_rm/implementation_defined_pragmas id38}@anchor{e4} @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{e0,,Pragma Source_File_Name}, and +It cannot appear after a @ref{e2,,Pragma Source_File_Name}, and most importantly, once pragma Source_File_Name_Project appears, no further Source_File_Name pragmas are allowed. @@ -7249,7 +7318,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{e3} +@anchor{gnat_rm/implementation_defined_pragmas pragma-source-reference}@anchor{e5} @section Pragma Source_Reference @@ -7273,7 +7342,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{e4}@anchor{gnat_rm/implementation_defined_pragmas id39}@anchor{e5} +@anchor{gnat_rm/implementation_defined_pragmas pragma-spark-mode}@anchor{e6}@anchor{gnat_rm/implementation_defined_pragmas id39}@anchor{e7} @section Pragma SPARK_Mode @@ -7355,7 +7424,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{e6} +@anchor{gnat_rm/implementation_defined_pragmas pragma-static-elaboration-desired}@anchor{e8} @section Pragma Static_Elaboration_Desired @@ -7379,7 +7448,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{e7} +@anchor{gnat_rm/implementation_defined_pragmas pragma-stream-convert}@anchor{e9} @section Pragma Stream_Convert @@ -7456,7 +7525,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{e8} +@anchor{gnat_rm/implementation_defined_pragmas pragma-style-checks}@anchor{ea} @section Pragma Style_Checks @@ -7529,7 +7598,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{e9} +@anchor{gnat_rm/implementation_defined_pragmas pragma-subtitle}@anchor{eb} @section Pragma Subtitle @@ -7543,7 +7612,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{ea} +@anchor{gnat_rm/implementation_defined_pragmas pragma-suppress}@anchor{ec} @section Pragma Suppress @@ -7616,7 +7685,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{eb} +@anchor{gnat_rm/implementation_defined_pragmas pragma-suppress-all}@anchor{ed} @section Pragma Suppress_All @@ -7635,7 +7704,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{ec}@anchor{gnat_rm/implementation_defined_pragmas id40}@anchor{ed} +@anchor{gnat_rm/implementation_defined_pragmas pragma-suppress-debug-info}@anchor{ee}@anchor{gnat_rm/implementation_defined_pragmas id40}@anchor{ef} @section Pragma Suppress_Debug_Info @@ -7650,7 +7719,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{ee} +@anchor{gnat_rm/implementation_defined_pragmas pragma-suppress-exception-locations}@anchor{f0} @section Pragma Suppress_Exception_Locations @@ -7673,7 +7742,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 id41}@anchor{ef}@anchor{gnat_rm/implementation_defined_pragmas pragma-suppress-initialization}@anchor{f0} +@anchor{gnat_rm/implementation_defined_pragmas id41}@anchor{f1}@anchor{gnat_rm/implementation_defined_pragmas pragma-suppress-initialization}@anchor{f2} @section Pragma Suppress_Initialization @@ -7718,7 +7787,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{f1} +@anchor{gnat_rm/implementation_defined_pragmas pragma-task-name}@anchor{f3} @section Pragma Task_Name @@ -7774,7 +7843,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{f2} +@anchor{gnat_rm/implementation_defined_pragmas pragma-task-storage}@anchor{f4} @section Pragma Task_Storage @@ -7794,7 +7863,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{f3}@anchor{gnat_rm/implementation_defined_pragmas id42}@anchor{f4} +@anchor{gnat_rm/implementation_defined_pragmas pragma-test-case}@anchor{f5}@anchor{gnat_rm/implementation_defined_pragmas id42}@anchor{f6} @section Pragma Test_Case @@ -7850,7 +7919,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{f5}@anchor{gnat_rm/implementation_defined_pragmas id43}@anchor{f6} +@anchor{gnat_rm/implementation_defined_pragmas pragma-thread-local-storage}@anchor{f7}@anchor{gnat_rm/implementation_defined_pragmas id43}@anchor{f8} @section Pragma Thread_Local_Storage @@ -7884,7 +7953,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{f7} +@anchor{gnat_rm/implementation_defined_pragmas pragma-time-slice}@anchor{f9} @section Pragma Time_Slice @@ -7900,7 +7969,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{f8} +@anchor{gnat_rm/implementation_defined_pragmas pragma-title}@anchor{fa} @section Pragma Title @@ -7925,7 +7994,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{f9} +@anchor{gnat_rm/implementation_defined_pragmas pragma-type-invariant}@anchor{fb} @section Pragma Type_Invariant @@ -7946,7 +8015,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 id44}@anchor{fa}@anchor{gnat_rm/implementation_defined_pragmas pragma-type-invariant-class}@anchor{fb} +@anchor{gnat_rm/implementation_defined_pragmas id44}@anchor{fc}@anchor{gnat_rm/implementation_defined_pragmas pragma-type-invariant-class}@anchor{fd} @section Pragma Type_Invariant_Class @@ -7973,7 +8042,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{fc} +@anchor{gnat_rm/implementation_defined_pragmas pragma-unchecked-union}@anchor{fe} @section Pragma Unchecked_Union @@ -7993,7 +8062,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{fd} +@anchor{gnat_rm/implementation_defined_pragmas pragma-unevaluated-use-of-old}@anchor{ff} @section Pragma Unevaluated_Use_Of_Old @@ -8048,7 +8117,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{fe} +@anchor{gnat_rm/implementation_defined_pragmas pragma-unimplemented-unit}@anchor{100} @section Pragma Unimplemented_Unit @@ -8068,7 +8137,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 id45}@anchor{ff}@anchor{gnat_rm/implementation_defined_pragmas pragma-universal-aliasing}@anchor{100} +@anchor{gnat_rm/implementation_defined_pragmas id45}@anchor{101}@anchor{gnat_rm/implementation_defined_pragmas pragma-universal-aliasing}@anchor{102} @section Pragma Universal_Aliasing @@ -8087,7 +8156,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{101}@anchor{gnat_rm/implementation_defined_pragmas id46}@anchor{102} +@anchor{gnat_rm/implementation_defined_pragmas pragma-universal-data}@anchor{103}@anchor{gnat_rm/implementation_defined_pragmas id46}@anchor{104} @section Pragma Universal_Data @@ -8111,7 +8180,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 id47}@anchor{103}@anchor{gnat_rm/implementation_defined_pragmas pragma-unmodified}@anchor{104} +@anchor{gnat_rm/implementation_defined_pragmas id47}@anchor{105}@anchor{gnat_rm/implementation_defined_pragmas pragma-unmodified}@anchor{106} @section Pragma Unmodified @@ -8145,7 +8214,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{105}@anchor{gnat_rm/implementation_defined_pragmas id48}@anchor{106} +@anchor{gnat_rm/implementation_defined_pragmas pragma-unreferenced}@anchor{107}@anchor{gnat_rm/implementation_defined_pragmas id48}@anchor{108} @section Pragma Unreferenced @@ -8189,7 +8258,7 @@ Note that if a warning is desired for all calls to a given subprogram, regardless of whether they occur in the same unit as the subprogram declaration, then this pragma should not be used (calls from another unit would not be flagged); pragma Obsolescent can be used instead -for this purpose, see @ref{a4,,Pragma Obsolescent}. +for this purpose, see @ref{a6,,Pragma Obsolescent}. The second form of pragma @cite{Unreferenced} is used within a context clause. In this case the arguments must be unit names of units previously @@ -8205,7 +8274,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{107}@anchor{gnat_rm/implementation_defined_pragmas id49}@anchor{108} +@anchor{gnat_rm/implementation_defined_pragmas pragma-unreferenced-objects}@anchor{109}@anchor{gnat_rm/implementation_defined_pragmas id49}@anchor{10a} @section Pragma Unreferenced_Objects @@ -8230,7 +8299,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{109} +@anchor{gnat_rm/implementation_defined_pragmas pragma-unreserve-all-interrupts}@anchor{10b} @section Pragma Unreserve_All_Interrupts @@ -8266,7 +8335,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{10a} +@anchor{gnat_rm/implementation_defined_pragmas pragma-unsuppress}@anchor{10c} @section Pragma Unsuppress @@ -8302,7 +8371,7 @@ number of implementation-defined check names. See the description of pragma @cite{Suppress} for full details. @node Pragma Use_VADS_Size,Pragma Unused,Pragma Unsuppress,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-use-vads-size}@anchor{10b} +@anchor{gnat_rm/implementation_defined_pragmas pragma-use-vads-size}@anchor{10d} @section Pragma Use_VADS_Size @@ -8326,7 +8395,7 @@ as implemented in the VADS compiler. See description of the VADS_Size attribute for further details. @node Pragma Unused,Pragma Validity_Checks,Pragma Use_VADS_Size,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-unused}@anchor{10c}@anchor{gnat_rm/implementation_defined_pragmas id50}@anchor{10d} +@anchor{gnat_rm/implementation_defined_pragmas pragma-unused}@anchor{10e}@anchor{gnat_rm/implementation_defined_pragmas id50}@anchor{10f} @section Pragma Unused @@ -8360,7 +8429,7 @@ Thus it is never necessary to use @cite{pragma Unmodified} for such variables, though it is harmless to do so. @node Pragma Validity_Checks,Pragma Volatile,Pragma Unused,Implementation Defined Pragmas -@anchor{gnat_rm/implementation_defined_pragmas pragma-validity-checks}@anchor{10e} +@anchor{gnat_rm/implementation_defined_pragmas pragma-validity-checks}@anchor{110} @section Pragma Validity_Checks @@ -8417,7 +8486,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{10f} +@anchor{gnat_rm/implementation_defined_pragmas pragma-volatile}@anchor{111} @section Pragma Volatile @@ -8435,7 +8504,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{110}@anchor{gnat_rm/implementation_defined_pragmas id51}@anchor{111} +@anchor{gnat_rm/implementation_defined_pragmas pragma-volatile-full-access}@anchor{112}@anchor{gnat_rm/implementation_defined_pragmas id51}@anchor{113} @section Pragma Volatile_Full_Access @@ -8467,7 +8536,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 id52}@anchor{112}@anchor{gnat_rm/implementation_defined_pragmas pragma-volatile-function}@anchor{113} +@anchor{gnat_rm/implementation_defined_pragmas id52}@anchor{114}@anchor{gnat_rm/implementation_defined_pragmas pragma-volatile-function}@anchor{115} @section Pragma Volatile_Function @@ -8481,7 +8550,7 @@ For the semantics of this pragma, see the entry for aspect @cite{Volatile_Functi in the 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{114} +@anchor{gnat_rm/implementation_defined_pragmas pragma-warning-as-error}@anchor{116} @section Pragma Warning_As_Error @@ -8516,7 +8585,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{115,,Pragma Warnings}. +warnings provided by the back end and mentioned in @ref{117,,Pragma Warnings}. By using a single full @emph{-Wxxx} switch in the pragma, such warnings can also be treated as errors. @@ -8566,7 +8635,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 pragma-warnings}@anchor{115}@anchor{gnat_rm/implementation_defined_pragmas id53}@anchor{116} +@anchor{gnat_rm/implementation_defined_pragmas pragma-warnings}@anchor{117}@anchor{gnat_rm/implementation_defined_pragmas id53}@anchor{118} @section Pragma Warnings @@ -8718,7 +8787,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{117} +@anchor{gnat_rm/implementation_defined_pragmas pragma-weak-external}@anchor{119} @section Pragma Weak_External @@ -8769,7 +8838,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{118} +@anchor{gnat_rm/implementation_defined_pragmas pragma-wide-character-encoding}@anchor{11a} @section Pragma Wide_Character_Encoding @@ -8785,6 +8854,10 @@ also be used at any point that a pragma is allowed, and it is permissible to have more than one such pragma in a file, allowing multiple encodings to appear within the same file. +However, note that the pragma cannot immediately precede the relevant +wide character, because then the previous encoding will still be in +effect, causing "illegal character" errors. + The argument can be an identifier or a character literal. In the identifier case, it is one of @cite{HEX}, @cite{UPPER}, @cite{SHIFT_JIS}, @cite{EUC}, @cite{UTF8}, or @cite{BRACKETS}. In the character literal @@ -8796,7 +8869,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{119}@anchor{gnat_rm/implementation_defined_aspects doc}@anchor{11a}@anchor{gnat_rm/implementation_defined_aspects id1}@anchor{11b} +@anchor{gnat_rm/implementation_defined_aspects implementation-defined-aspects}@anchor{11b}@anchor{gnat_rm/implementation_defined_aspects doc}@anchor{11c}@anchor{gnat_rm/implementation_defined_aspects id1}@anchor{11d} @chapter Implementation Defined Aspects @@ -8852,7 +8925,7 @@ or attribute definition clause. @menu * Aspect Abstract_State:: -* Annotate:: +* Aspect Annotate:: * Aspect Async_Readers:: * Aspect Async_Writers:: * Aspect Constant_After_Elaboration:: @@ -8912,8 +8985,8 @@ or attribute definition clause. @end menu -@node Aspect Abstract_State,Annotate,,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-abstract-state}@anchor{11c} +@node Aspect Abstract_State,Aspect Annotate,,Implementation Defined Aspects +@anchor{gnat_rm/implementation_defined_aspects aspect-abstract-state}@anchor{11e} @section Aspect Abstract_State @@ -8921,9 +8994,9 @@ or attribute definition clause. This aspect is equivalent to @ref{1c,,pragma Abstract_State}. -@node Annotate,Aspect Async_Readers,Aspect Abstract_State,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects annotate}@anchor{11d} -@section Annotate +@node Aspect Annotate,Aspect Async_Readers,Aspect Abstract_State,Implementation Defined Aspects +@anchor{gnat_rm/implementation_defined_aspects aspect-annotate}@anchor{11f} +@section Aspect Annotate @geindex Annotate @@ -8948,8 +9021,8 @@ Equivalent to @cite{pragma Annotate (ID@comma{} Entity => Name);} Equivalent to @cite{pragma Annotate (ID@comma{} ID @{@comma{} ARG@}@comma{} Entity => Name);} @end table -@node Aspect Async_Readers,Aspect Async_Writers,Annotate,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-async-readers}@anchor{11e} +@node Aspect Async_Readers,Aspect Async_Writers,Aspect Annotate,Implementation Defined Aspects +@anchor{gnat_rm/implementation_defined_aspects aspect-async-readers}@anchor{120} @section Aspect Async_Readers @@ -8958,7 +9031,7 @@ Equivalent to @cite{pragma Annotate (ID@comma{} ID @{@comma{} ARG@}@comma{} Enti This boolean aspect is equivalent to @ref{2c,,pragma 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{11f} +@anchor{gnat_rm/implementation_defined_aspects aspect-async-writers}@anchor{121} @section Aspect Async_Writers @@ -8967,7 +9040,7 @@ This boolean aspect is equivalent to @ref{2c,,pragma Async_Readers}. This boolean aspect is equivalent to @ref{2f,,pragma 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{120} +@anchor{gnat_rm/implementation_defined_aspects aspect-constant-after-elaboration}@anchor{122} @section Aspect Constant_After_Elaboration @@ -8976,7 +9049,7 @@ This boolean aspect is equivalent to @ref{2f,,pragma Async_Writers}. This aspect is equivalent to @ref{40,,pragma 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{121} +@anchor{gnat_rm/implementation_defined_aspects aspect-contract-cases}@anchor{123} @section Aspect Contract_Cases @@ -8987,25 +9060,25 @@ 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{122} +@anchor{gnat_rm/implementation_defined_aspects aspect-depends}@anchor{124} @section Aspect Depends @geindex Depends -This aspect is equivalent to @ref{50,,pragma Depends}. +This aspect is equivalent to @ref{51,,pragma Depends}. @node Aspect Default_Initial_Condition,Aspect Dimension,Aspect Depends,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-default-initial-condition}@anchor{123} +@anchor{gnat_rm/implementation_defined_aspects aspect-default-initial-condition}@anchor{125} @section Aspect Default_Initial_Condition @geindex Default_Initial_Condition -This aspect is equivalent to @ref{4b,,pragma Default_Initial_Condition}. +This aspect is equivalent to @ref{4c,,pragma 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{124} +@anchor{gnat_rm/implementation_defined_aspects aspect-dimension}@anchor{126} @section Aspect Dimension @@ -9030,7 +9103,7 @@ RATIONAL ::= [-] NUMERIC_LITERAL [/ NUMERIC_LITERAL] @end example This aspect can only be applied to a subtype whose parent type has -a @cite{Dimension_Systen} aspect. The aspect must specify values for +a @cite{Dimension_System} aspect. The aspect must specify values for all dimensions of the system. The rational values are the powers of the corresponding dimensions that are used by the compiler to verify that physical (numeric) computations are dimensionally consistent. For example, @@ -9041,7 +9114,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{125} +@anchor{gnat_rm/implementation_defined_aspects aspect-dimension-system}@anchor{127} @section Aspect Dimension_System @@ -9101,7 +9174,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{126} +@anchor{gnat_rm/implementation_defined_aspects aspect-disable-controlled}@anchor{128} @section Aspect Disable_Controlled @@ -9114,110 +9187,110 @@ 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{127} +@anchor{gnat_rm/implementation_defined_aspects aspect-effective-reads}@anchor{129} @section Aspect Effective_Reads @geindex Effective_Reads -This aspect is equivalent to @ref{56,,pragma Effective_Reads}. +This aspect is equivalent to @ref{57,,pragma 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{128} +@anchor{gnat_rm/implementation_defined_aspects aspect-effective-writes}@anchor{12a} @section Aspect Effective_Writes @geindex Effective_Writes -This aspect is equivalent to @ref{58,,pragma Effective_Writes}. +This aspect is equivalent to @ref{59,,pragma 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{129} +@anchor{gnat_rm/implementation_defined_aspects aspect-extensions-visible}@anchor{12b} @section Aspect Extensions_Visible @geindex Extensions_Visible -This aspect is equivalent to @ref{64,,pragma Extensions_Visible}. +This aspect is equivalent to @ref{65,,pragma 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{12a} +@anchor{gnat_rm/implementation_defined_aspects aspect-favor-top-level}@anchor{12c} @section Aspect Favor_Top_Level @geindex Favor_Top_Level -This boolean aspect is equivalent to @ref{69,,pragma Favor_Top_Level}. +This boolean aspect is equivalent to @ref{6a,,pragma Favor_Top_Level}. @node Aspect Ghost,Aspect Global,Aspect Favor_Top_Level,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-ghost}@anchor{12b} +@anchor{gnat_rm/implementation_defined_aspects aspect-ghost}@anchor{12d} @section Aspect Ghost @geindex Ghost -This aspect is equivalent to @ref{6c,,pragma Ghost}. +This aspect is equivalent to @ref{6d,,pragma Ghost}. @node Aspect Global,Aspect Initial_Condition,Aspect Ghost,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-global}@anchor{12c} +@anchor{gnat_rm/implementation_defined_aspects aspect-global}@anchor{12e} @section Aspect Global @geindex Global -This aspect is equivalent to @ref{6e,,pragma Global}. +This aspect is equivalent to @ref{6f,,pragma Global}. @node Aspect Initial_Condition,Aspect Initializes,Aspect Global,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-initial-condition}@anchor{12d} +@anchor{gnat_rm/implementation_defined_aspects aspect-initial-condition}@anchor{12f} @section Aspect Initial_Condition @geindex Initial_Condition -This aspect is equivalent to @ref{7c,,pragma Initial_Condition}. +This aspect is equivalent to @ref{7d,,pragma Initial_Condition}. @node Aspect Initializes,Aspect Inline_Always,Aspect Initial_Condition,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-initializes}@anchor{12e} +@anchor{gnat_rm/implementation_defined_aspects aspect-initializes}@anchor{130} @section Aspect Initializes @geindex Initializes -This aspect is equivalent to @ref{7e,,pragma Initializes}. +This aspect is equivalent to @ref{7f,,pragma Initializes}. @node Aspect Inline_Always,Aspect Invariant,Aspect Initializes,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-inline-always}@anchor{12f} +@anchor{gnat_rm/implementation_defined_aspects aspect-inline-always}@anchor{131} @section Aspect Inline_Always @geindex Inline_Always -This boolean aspect is equivalent to @ref{81,,pragma Inline_Always}. +This boolean aspect is equivalent to @ref{82,,pragma Inline_Always}. @node Aspect Invariant,Aspect Invariant'Class,Aspect Inline_Always,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-invariant}@anchor{130} +@anchor{gnat_rm/implementation_defined_aspects aspect-invariant}@anchor{132} @section Aspect Invariant @geindex Invariant -This aspect is equivalent to @ref{88,,pragma Invariant}. It is a +This aspect is equivalent to @ref{89,,pragma Invariant}. It is a 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{131} +@anchor{gnat_rm/implementation_defined_aspects aspect-invariant-class}@anchor{133} @section Aspect Invariant'Class @geindex Invariant'Class -This aspect is equivalent to @ref{fb,,pragma Type_Invariant_Class}. It is a +This aspect is equivalent to @ref{fd,,pragma Type_Invariant_Class}. It is a 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{132} +@anchor{gnat_rm/implementation_defined_aspects aspect-iterable}@anchor{134} @section Aspect Iterable @@ -9293,99 +9366,99 @@ 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{133} +@anchor{gnat_rm/implementation_defined_aspects aspect-linker-section}@anchor{135} @section Aspect Linker_Section @geindex Linker_Section -This aspect is equivalent to @ref{90,,pragma Linker_Section}. +This aspect is equivalent to @ref{91,,pragma Linker_Section}. @node Aspect Lock_Free,Aspect Max_Queue_Length,Aspect Linker_Section,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-lock-free}@anchor{134} +@anchor{gnat_rm/implementation_defined_aspects aspect-lock-free}@anchor{136} @section Aspect Lock_Free @geindex Lock_Free -This boolean aspect is equivalent to @ref{92,,pragma Lock_Free}. +This boolean aspect is equivalent to @ref{93,,pragma Lock_Free}. @node Aspect Max_Queue_Length,Aspect No_Elaboration_Code_All,Aspect Lock_Free,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-max-queue-length}@anchor{135} +@anchor{gnat_rm/implementation_defined_aspects aspect-max-queue-length}@anchor{137} @section Aspect Max_Queue_Length @geindex Max_Queue_Length -This aspect is equivalent to @emph{pragma Max_Queue_Length}. +This aspect is equivalent to pragma Max_Queue_Length. @node Aspect No_Elaboration_Code_All,Aspect No_Tagged_Streams,Aspect Max_Queue_Length,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-no-elaboration-code-all}@anchor{136} +@anchor{gnat_rm/implementation_defined_aspects aspect-no-elaboration-code-all}@anchor{138} @section Aspect No_Elaboration_Code_All @geindex No_Elaboration_Code_All -This aspect is equivalent to @ref{9c,,pragma No_Elaboration_Code_All} +This aspect is equivalent to @ref{9d,,pragma No_Elaboration_Code_All} 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{137} +@anchor{gnat_rm/implementation_defined_aspects aspect-no-tagged-streams}@anchor{139} @section Aspect No_Tagged_Streams @geindex No_Tagged_Streams -This aspect is equivalent to @ref{a1,,pragma No_Tagged_Streams} with an +This aspect is equivalent to @ref{a3,,pragma No_Tagged_Streams} with an 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{138} +@anchor{gnat_rm/implementation_defined_aspects aspect-object-size}@anchor{13a} @section Aspect Object_Size @geindex Object_Size -This aspect is equivalent to @ref{139,,attribute Object_Size}. +This aspect is equivalent to @ref{13b,,attribute Object_Size}. @node Aspect Obsolescent,Aspect Part_Of,Aspect Object_Size,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-obsolescent}@anchor{13a} +@anchor{gnat_rm/implementation_defined_aspects aspect-obsolescent}@anchor{13c} @section Aspect Obsolescent @geindex Obsolsecent -This aspect is equivalent to @ref{a4,,pragma Obsolescent}. Note that the +This aspect is equivalent to @ref{a6,,pragma Obsolescent}. Note that the 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{13b} +@anchor{gnat_rm/implementation_defined_aspects aspect-part-of}@anchor{13d} @section Aspect Part_Of @geindex Part_Of -This aspect is equivalent to @ref{ac,,pragma Part_Of}. +This aspect is equivalent to @ref{ae,,pragma Part_Of}. @node Aspect Persistent_BSS,Aspect Predicate,Aspect Part_Of,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-persistent-bss}@anchor{13c} +@anchor{gnat_rm/implementation_defined_aspects aspect-persistent-bss}@anchor{13e} @section Aspect Persistent_BSS @geindex Persistent_BSS -This boolean aspect is equivalent to @ref{ae,,pragma Persistent_BSS}. +This boolean aspect is equivalent to @ref{b0,,pragma Persistent_BSS}. @node Aspect Predicate,Aspect Pure_Function,Aspect Persistent_BSS,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-predicate}@anchor{13d} +@anchor{gnat_rm/implementation_defined_aspects aspect-predicate}@anchor{13f} @section Aspect Predicate @geindex Predicate -This aspect is equivalent to @ref{b7,,pragma Predicate}. It is thus +This aspect is equivalent to @ref{b9,,pragma Predicate}. It is thus similar to the language defined aspects @cite{Dynamic_Predicate} and @cite{Static_Predicate} except that whether the resulting predicate is static or dynamic is controlled by the form of the @@ -9393,239 +9466,239 @@ 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{13e} +@anchor{gnat_rm/implementation_defined_aspects aspect-pure-function}@anchor{140} @section Aspect Pure_Function @geindex Pure_Function -This boolean aspect is equivalent to @ref{c3,,pragma Pure_Function}. +This boolean aspect is equivalent to @ref{c5,,pragma 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{13f} +@anchor{gnat_rm/implementation_defined_aspects aspect-refined-depends}@anchor{141} @section Aspect Refined_Depends @geindex Refined_Depends -This aspect is equivalent to @ref{c8,,pragma Refined_Depends}. +This aspect is equivalent to @ref{ca,,pragma 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{140} +@anchor{gnat_rm/implementation_defined_aspects aspect-refined-global}@anchor{142} @section Aspect Refined_Global @geindex Refined_Global -This aspect is equivalent to @ref{c9,,pragma Refined_Global}. +This aspect is equivalent to @ref{cb,,pragma 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{141} +@anchor{gnat_rm/implementation_defined_aspects aspect-refined-post}@anchor{143} @section Aspect Refined_Post @geindex Refined_Post -This aspect is equivalent to @ref{cb,,pragma Refined_Post}. +This aspect is equivalent to @ref{cd,,pragma 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{142} +@anchor{gnat_rm/implementation_defined_aspects aspect-refined-state}@anchor{144} @section Aspect Refined_State @geindex Refined_State -This aspect is equivalent to @ref{cd,,pragma Refined_State}. +This aspect is equivalent to @ref{cf,,pragma Refined_State}. @node Aspect Remote_Access_Type,Aspect Secondary_Stack_Size,Aspect Refined_State,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-remote-access-type}@anchor{143} +@anchor{gnat_rm/implementation_defined_aspects aspect-remote-access-type}@anchor{145} @section Aspect Remote_Access_Type @geindex Remote_Access_Type -This aspect is equivalent to @ref{d1,,pragma Remote_Access_Type}. +This aspect is equivalent to @ref{d3,,pragma Remote_Access_Type}. @node Aspect Secondary_Stack_Size,Aspect Scalar_Storage_Order,Aspect Remote_Access_Type,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-secondary-stack-size}@anchor{144} +@anchor{gnat_rm/implementation_defined_aspects aspect-secondary-stack-size}@anchor{146} @section Aspect Secondary_Stack_Size @geindex Secondary_Stack_Size -This aspect is equivalent to @ref{d6,,pragma Secondary_Stack_Size}. +This aspect is equivalent to @ref{d8,,pragma Secondary_Stack_Size}. @node Aspect Scalar_Storage_Order,Aspect Shared,Aspect Secondary_Stack_Size,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-scalar-storage-order}@anchor{145} +@anchor{gnat_rm/implementation_defined_aspects aspect-scalar-storage-order}@anchor{147} @section Aspect Scalar_Storage_Order @geindex Scalar_Storage_Order -This aspect is equivalent to a @ref{146,,attribute Scalar_Storage_Order}. +This aspect is equivalent to a @ref{148,,attribute Scalar_Storage_Order}. @node Aspect Shared,Aspect Simple_Storage_Pool,Aspect Scalar_Storage_Order,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-shared}@anchor{147} +@anchor{gnat_rm/implementation_defined_aspects aspect-shared}@anchor{149} @section Aspect Shared @geindex Shared -This boolean aspect is equivalent to @ref{d9,,pragma Shared} +This boolean aspect is equivalent to @ref{db,,pragma 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{148} +@anchor{gnat_rm/implementation_defined_aspects aspect-simple-storage-pool}@anchor{14a} @section Aspect Simple_Storage_Pool @geindex Simple_Storage_Pool -This aspect is equivalent to @ref{de,,attribute Simple_Storage_Pool}. +This aspect is equivalent to @ref{e0,,attribute Simple_Storage_Pool}. @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{149} +@anchor{gnat_rm/implementation_defined_aspects aspect-simple-storage-pool-type}@anchor{14b} @section Aspect Simple_Storage_Pool_Type @geindex Simple_Storage_Pool_Type -This boolean aspect is equivalent to @ref{dc,,pragma Simple_Storage_Pool_Type}. +This boolean aspect is equivalent to @ref{de,,pragma 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{14a} +@anchor{gnat_rm/implementation_defined_aspects aspect-spark-mode}@anchor{14c} @section Aspect SPARK_Mode @geindex SPARK_Mode -This aspect is equivalent to @ref{e4,,pragma SPARK_Mode} and +This aspect is equivalent to @ref{e6,,pragma SPARK_Mode} and 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{14b} +@anchor{gnat_rm/implementation_defined_aspects aspect-suppress-debug-info}@anchor{14d} @section Aspect Suppress_Debug_Info @geindex Suppress_Debug_Info -This boolean aspect is equivalent to @ref{ec,,pragma Suppress_Debug_Info}. +This boolean aspect is equivalent to @ref{ee,,pragma 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{14c} +@anchor{gnat_rm/implementation_defined_aspects aspect-suppress-initialization}@anchor{14e} @section Aspect Suppress_Initialization @geindex Suppress_Initialization -This boolean aspect is equivalent to @ref{f0,,pragma Suppress_Initialization}. +This boolean aspect is equivalent to @ref{f2,,pragma 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{14d} +@anchor{gnat_rm/implementation_defined_aspects aspect-test-case}@anchor{14f} @section Aspect Test_Case @geindex Test_Case -This aspect is equivalent to @ref{f3,,pragma Test_Case}. +This aspect is equivalent to @ref{f5,,pragma 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{14e} +@anchor{gnat_rm/implementation_defined_aspects aspect-thread-local-storage}@anchor{150} @section Aspect Thread_Local_Storage @geindex Thread_Local_Storage -This boolean aspect is equivalent to @ref{f5,,pragma Thread_Local_Storage}. +This boolean aspect is equivalent to @ref{f7,,pragma 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{14f} +@anchor{gnat_rm/implementation_defined_aspects aspect-universal-aliasing}@anchor{151} @section Aspect Universal_Aliasing @geindex Universal_Aliasing -This boolean aspect is equivalent to @ref{100,,pragma Universal_Aliasing}. +This boolean aspect is equivalent to @ref{102,,pragma Universal_Aliasing}. @node Aspect Universal_Data,Aspect Unmodified,Aspect Universal_Aliasing,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-universal-data}@anchor{150} +@anchor{gnat_rm/implementation_defined_aspects aspect-universal-data}@anchor{152} @section Aspect Universal_Data @geindex Universal_Data -This aspect is equivalent to @ref{101,,pragma Universal_Data}. +This aspect is equivalent to @ref{103,,pragma Universal_Data}. @node Aspect Unmodified,Aspect Unreferenced,Aspect Universal_Data,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-unmodified}@anchor{151} +@anchor{gnat_rm/implementation_defined_aspects aspect-unmodified}@anchor{153} @section Aspect Unmodified @geindex Unmodified -This boolean aspect is equivalent to @ref{104,,pragma Unmodified}. +This boolean aspect is equivalent to @ref{106,,pragma Unmodified}. @node Aspect Unreferenced,Aspect Unreferenced_Objects,Aspect Unmodified,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-unreferenced}@anchor{152} +@anchor{gnat_rm/implementation_defined_aspects aspect-unreferenced}@anchor{154} @section Aspect Unreferenced @geindex Unreferenced -This boolean aspect is equivalent to @ref{105,,pragma Unreferenced}. Note that +This boolean aspect is equivalent to @ref{107,,pragma Unreferenced}. Note that 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{153} +@anchor{gnat_rm/implementation_defined_aspects aspect-unreferenced-objects}@anchor{155} @section Aspect Unreferenced_Objects @geindex Unreferenced_Objects -This boolean aspect is equivalent to @ref{107,,pragma Unreferenced_Objects}. +This boolean aspect is equivalent to @ref{109,,pragma 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{154} +@anchor{gnat_rm/implementation_defined_aspects aspect-value-size}@anchor{156} @section Aspect Value_Size @geindex Value_Size -This aspect is equivalent to @ref{155,,attribute Value_Size}. +This aspect is equivalent to @ref{157,,attribute Value_Size}. @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{156} +@anchor{gnat_rm/implementation_defined_aspects aspect-volatile-full-access}@anchor{158} @section Aspect Volatile_Full_Access @geindex Volatile_Full_Access -This boolean aspect is equivalent to @ref{110,,pragma Volatile_Full_Access}. +This boolean aspect is equivalent to @ref{112,,pragma 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{157} +@anchor{gnat_rm/implementation_defined_aspects aspect-volatile-function}@anchor{159} @section Aspect Volatile_Function @geindex Volatile_Function -This boolean aspect is equivalent to @ref{113,,pragma Volatile_Function}. +This boolean aspect is equivalent to @ref{115,,pragma Volatile_Function}. @node Aspect Warnings,,Aspect Volatile_Function,Implementation Defined Aspects -@anchor{gnat_rm/implementation_defined_aspects aspect-warnings}@anchor{158} +@anchor{gnat_rm/implementation_defined_aspects aspect-warnings}@anchor{15a} @section Aspect Warnings @geindex Warnings -This aspect is equivalent to the two argument form of @ref{115,,pragma Warnings}, +This aspect is equivalent to the two argument form of @ref{117,,pragma Warnings}, 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{159}@anchor{gnat_rm/implementation_defined_attributes implementation-defined-attributes}@anchor{8}@anchor{gnat_rm/implementation_defined_attributes id1}@anchor{15a} +@anchor{gnat_rm/implementation_defined_attributes doc}@anchor{15b}@anchor{gnat_rm/implementation_defined_attributes implementation-defined-attributes}@anchor{8}@anchor{gnat_rm/implementation_defined_attributes id1}@anchor{15c} @chapter Implementation Defined Attributes @@ -9726,7 +9799,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{15b} +@anchor{gnat_rm/implementation_defined_attributes attribute-abort-signal}@anchor{15d} @section Attribute Abort_Signal @@ -9740,7 +9813,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{15c} +@anchor{gnat_rm/implementation_defined_attributes attribute-address-size}@anchor{15e} @section Attribute Address_Size @@ -9756,7 +9829,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{15d} +@anchor{gnat_rm/implementation_defined_attributes attribute-asm-input}@anchor{15f} @section Attribute Asm_Input @@ -9770,10 +9843,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{15e,,Machine Code Insertions} +@ref{160,,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{15f} +@anchor{gnat_rm/implementation_defined_attributes attribute-asm-output}@anchor{161} @section Attribute Asm_Output @@ -9789,10 +9862,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{15e,,Machine Code Insertions} +@ref{160,,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{160} +@anchor{gnat_rm/implementation_defined_attributes attribute-atomic-always-lock-free}@anchor{162} @section Attribute Atomic_Always_Lock_Free @@ -9804,7 +9877,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{161} +@anchor{gnat_rm/implementation_defined_attributes attribute-bit}@anchor{163} @section Attribute Bit @@ -9835,7 +9908,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{162} +@anchor{gnat_rm/implementation_defined_attributes attribute-bit-position}@anchor{164} @section Attribute Bit_Position @@ -9850,7 +9923,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{163} +@anchor{gnat_rm/implementation_defined_attributes attribute-code-address}@anchor{165} @section Attribute Code_Address @@ -9893,7 +9966,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{164} +@anchor{gnat_rm/implementation_defined_attributes attribute-compiler-version}@anchor{166} @section Attribute Compiler_Version @@ -9904,7 +9977,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{165} +@anchor{gnat_rm/implementation_defined_attributes attribute-constrained}@anchor{167} @section Attribute Constrained @@ -9919,7 +9992,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{166} +@anchor{gnat_rm/implementation_defined_attributes attribute-default-bit-order}@anchor{168} @section Attribute Default_Bit_Order @@ -9936,7 +10009,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{167} +@anchor{gnat_rm/implementation_defined_attributes attribute-default-scalar-storage-order}@anchor{169} @section Attribute Default_Scalar_Storage_Order @@ -9953,7 +10026,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{168} +@anchor{gnat_rm/implementation_defined_attributes attribute-deref}@anchor{16a} @section Attribute Deref @@ -9966,7 +10039,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{169} +@anchor{gnat_rm/implementation_defined_attributes attribute-descriptor-size}@anchor{16b} @section Attribute Descriptor_Size @@ -9993,7 +10066,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{16a} +@anchor{gnat_rm/implementation_defined_attributes attribute-elaborated}@anchor{16c} @section Attribute Elaborated @@ -10008,7 +10081,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{16b} +@anchor{gnat_rm/implementation_defined_attributes attribute-elab-body}@anchor{16d} @section Attribute Elab_Body @@ -10024,7 +10097,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{16c} +@anchor{gnat_rm/implementation_defined_attributes attribute-elab-spec}@anchor{16e} @section Attribute Elab_Spec @@ -10040,7 +10113,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{16d} +@anchor{gnat_rm/implementation_defined_attributes attribute-elab-subp-body}@anchor{16f} @section Attribute Elab_Subp_Body @@ -10054,7 +10127,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{16e} +@anchor{gnat_rm/implementation_defined_attributes attribute-emax}@anchor{170} @section Attribute Emax @@ -10067,7 +10140,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{16f} +@anchor{gnat_rm/implementation_defined_attributes attribute-enabled}@anchor{171} @section Attribute Enabled @@ -10091,7 +10164,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{170} +@anchor{gnat_rm/implementation_defined_attributes attribute-enum-rep}@anchor{172} @section Attribute Enum_Rep @@ -10128,7 +10201,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{171} +@anchor{gnat_rm/implementation_defined_attributes attribute-enum-val}@anchor{173} @section Attribute Enum_Val @@ -10151,7 +10224,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{172} +@anchor{gnat_rm/implementation_defined_attributes attribute-epsilon}@anchor{174} @section Attribute Epsilon @@ -10164,7 +10237,7 @@ the Ada 83 reference manual for an exact description of the semantics of this attribute. @node Attribute Fast_Math,Attribute Finalization_Size,Attribute Epsilon,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-fast-math}@anchor{173} +@anchor{gnat_rm/implementation_defined_attributes attribute-fast-math}@anchor{175} @section Attribute Fast_Math @@ -10175,7 +10248,7 @@ prefix) yields a static Boolean value that is True if pragma @cite{Fast_Math} is active, and False otherwise. @node Attribute Finalization_Size,Attribute Fixed_Value,Attribute Fast_Math,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-finalization-size}@anchor{174} +@anchor{gnat_rm/implementation_defined_attributes attribute-finalization-size}@anchor{176} @section Attribute Finalization_Size @@ -10193,7 +10266,7 @@ class-wide type whose tag denotes a type with no controlled parts. Note that only heap-allocated objects contain finalization data. @node Attribute Fixed_Value,Attribute From_Any,Attribute Finalization_Size,Implementation Defined Attributes -@anchor{gnat_rm/implementation_defined_attributes attribute-fixed-value}@anchor{175} +@anchor{gnat_rm/implementation_defined_attributes attribute-fixed-value}@anchor{177} @section Attribute Fixed_Value @@ -10220,7 +10293,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{176} +@anchor{gnat_rm/implementation_defined_attributes attribute-from-any}@anchor{178} @section Attribute From_Any @@ -10230,7 +10303,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{177} +@anchor{gnat_rm/implementation_defined_attributes attribute-has-access-values}@anchor{179} @section Attribute Has_Access_Values @@ -10248,7 +10321,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{178} +@anchor{gnat_rm/implementation_defined_attributes attribute-has-discriminants}@anchor{17a} @section Attribute Has_Discriminants @@ -10264,7 +10337,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{179} +@anchor{gnat_rm/implementation_defined_attributes attribute-img}@anchor{17b} @section Attribute Img @@ -10294,7 +10367,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{17a} +@anchor{gnat_rm/implementation_defined_attributes attribute-integer-value}@anchor{17c} @section Attribute Integer_Value @@ -10322,7 +10395,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{17b} +@anchor{gnat_rm/implementation_defined_attributes attribute-invalid-value}@anchor{17d} @section Attribute Invalid_Value @@ -10336,7 +10409,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{17c} +@anchor{gnat_rm/implementation_defined_attributes attribute-iterable}@anchor{17e} @section Attribute Iterable @@ -10345,7 +10418,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{17d} +@anchor{gnat_rm/implementation_defined_attributes attribute-large}@anchor{17f} @section Attribute Large @@ -10358,7 +10431,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{17e} +@anchor{gnat_rm/implementation_defined_attributes attribute-library-level}@anchor{180} @section Attribute Library_Level @@ -10384,7 +10457,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{17f} +@anchor{gnat_rm/implementation_defined_attributes attribute-lock-free}@anchor{181} @section Attribute Lock_Free @@ -10394,7 +10467,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{180} +@anchor{gnat_rm/implementation_defined_attributes attribute-loop-entry}@anchor{182} @section Attribute Loop_Entry @@ -10424,7 +10497,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{181} +@anchor{gnat_rm/implementation_defined_attributes attribute-machine-size}@anchor{183} @section Attribute Machine_Size @@ -10434,7 +10507,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{182} +@anchor{gnat_rm/implementation_defined_attributes attribute-mantissa}@anchor{184} @section Attribute Mantissa @@ -10447,7 +10520,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{183}@anchor{gnat_rm/implementation_defined_attributes id2}@anchor{184} +@anchor{gnat_rm/implementation_defined_attributes attribute-maximum-alignment}@anchor{185}@anchor{gnat_rm/implementation_defined_attributes id2}@anchor{186} @section Attribute Maximum_Alignment @@ -10463,7 +10536,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{185} +@anchor{gnat_rm/implementation_defined_attributes attribute-mechanism-code}@anchor{187} @section Attribute Mechanism_Code @@ -10494,7 +10567,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{186} +@anchor{gnat_rm/implementation_defined_attributes attribute-null-parameter}@anchor{188} @section Attribute Null_Parameter @@ -10519,7 +10592,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{139}@anchor{gnat_rm/implementation_defined_attributes id3}@anchor{187} +@anchor{gnat_rm/implementation_defined_attributes attribute-object-size}@anchor{13b}@anchor{gnat_rm/implementation_defined_attributes id3}@anchor{189} @section Attribute Object_Size @@ -10589,7 +10662,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{188} +@anchor{gnat_rm/implementation_defined_attributes attribute-old}@anchor{18a} @section Attribute Old @@ -10604,7 +10677,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{189} +@anchor{gnat_rm/implementation_defined_attributes attribute-passed-by-reference}@anchor{18b} @section Attribute Passed_By_Reference @@ -10620,7 +10693,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{18a} +@anchor{gnat_rm/implementation_defined_attributes attribute-pool-address}@anchor{18c} @section Attribute Pool_Address @@ -10645,7 +10718,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{18b} +@anchor{gnat_rm/implementation_defined_attributes attribute-range-length}@anchor{18d} @section Attribute Range_Length @@ -10658,7 +10731,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{18c} +@anchor{gnat_rm/implementation_defined_attributes attribute-restriction-set}@anchor{18e} @section Attribute Restriction_Set @@ -10728,7 +10801,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{18d} +@anchor{gnat_rm/implementation_defined_attributes attribute-result}@anchor{18f} @section Attribute Result @@ -10741,7 +10814,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{18e} +@anchor{gnat_rm/implementation_defined_attributes attribute-safe-emax}@anchor{190} @section Attribute Safe_Emax @@ -10754,7 +10827,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{18f} +@anchor{gnat_rm/implementation_defined_attributes attribute-safe-large}@anchor{191} @section Attribute Safe_Large @@ -10767,7 +10840,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{190} +@anchor{gnat_rm/implementation_defined_attributes attribute-safe-small}@anchor{192} @section Attribute Safe_Small @@ -10780,7 +10853,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 id4}@anchor{191}@anchor{gnat_rm/implementation_defined_attributes attribute-scalar-storage-order}@anchor{146} +@anchor{gnat_rm/implementation_defined_attributes id4}@anchor{193}@anchor{gnat_rm/implementation_defined_attributes attribute-scalar-storage-order}@anchor{148} @section Attribute Scalar_Storage_Order @@ -10899,7 +10972,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{de}@anchor{gnat_rm/implementation_defined_attributes id5}@anchor{192} +@anchor{gnat_rm/implementation_defined_attributes attribute-simple-storage-pool}@anchor{e0}@anchor{gnat_rm/implementation_defined_attributes id5}@anchor{194} @section Attribute Simple_Storage_Pool @@ -10962,7 +11035,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{193} +@anchor{gnat_rm/implementation_defined_attributes attribute-small}@anchor{195} @section Attribute Small @@ -10978,7 +11051,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{194} +@anchor{gnat_rm/implementation_defined_attributes attribute-storage-unit}@anchor{196} @section Attribute Storage_Unit @@ -10988,7 +11061,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{195} +@anchor{gnat_rm/implementation_defined_attributes attribute-stub-type}@anchor{197} @section Attribute Stub_Type @@ -11012,7 +11085,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{196} +@anchor{gnat_rm/implementation_defined_attributes attribute-system-allocator-alignment}@anchor{198} @section Attribute System_Allocator_Alignment @@ -11029,7 +11102,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{197} +@anchor{gnat_rm/implementation_defined_attributes attribute-target-name}@anchor{199} @section Attribute Target_Name @@ -11042,7 +11115,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{198} +@anchor{gnat_rm/implementation_defined_attributes attribute-to-address}@anchor{19a} @section Attribute To_Address @@ -11059,13 +11132,13 @@ used in contexts (e.g., preelaborable packages) which require a static expression and where the function call could not be used (since the function call is always nonstatic, even if its argument is static). The argument must be in the range --(2**(m-1) .. 2**m-1, where m is the memory size +-(2**(m-1)) .. 2**m-1, where m is the memory size (typically 32 or 64). Negative values are intepreted in a 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{199} +@anchor{gnat_rm/implementation_defined_attributes attribute-to-any}@anchor{19b} @section Attribute To_Any @@ -11075,7 +11148,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{19a} +@anchor{gnat_rm/implementation_defined_attributes attribute-type-class}@anchor{19c} @section Attribute Type_Class @@ -11105,7 +11178,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{19b} +@anchor{gnat_rm/implementation_defined_attributes attribute-type-key}@anchor{19d} @section Attribute Type_Key @@ -11117,7 +11190,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{19c} +@anchor{gnat_rm/implementation_defined_attributes attribute-typecode}@anchor{19e} @section Attribute TypeCode @@ -11127,7 +11200,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{19d} +@anchor{gnat_rm/implementation_defined_attributes attribute-unconstrained-array}@anchor{19f} @section Attribute Unconstrained_Array @@ -11141,7 +11214,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{19e} +@anchor{gnat_rm/implementation_defined_attributes attribute-universal-literal-string}@anchor{1a0} @section Attribute Universal_Literal_String @@ -11169,7 +11242,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{19f} +@anchor{gnat_rm/implementation_defined_attributes attribute-unrestricted-access}@anchor{1a1} @section Attribute Unrestricted_Access @@ -11356,7 +11429,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{1a0} +@anchor{gnat_rm/implementation_defined_attributes attribute-update}@anchor{1a2} @section Attribute Update @@ -11437,7 +11510,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{1a1} +@anchor{gnat_rm/implementation_defined_attributes attribute-valid-scalars}@anchor{1a3} @section Attribute Valid_Scalars @@ -11472,7 +11545,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{1a2} +@anchor{gnat_rm/implementation_defined_attributes attribute-vads-size}@anchor{1a4} @section Attribute VADS_Size @@ -11492,7 +11565,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 id6}@anchor{1a3}@anchor{gnat_rm/implementation_defined_attributes attribute-value-size}@anchor{155} +@anchor{gnat_rm/implementation_defined_attributes id6}@anchor{1a5}@anchor{gnat_rm/implementation_defined_attributes attribute-value-size}@anchor{157} @section Attribute Value_Size @@ -11506,7 +11579,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{1a4} +@anchor{gnat_rm/implementation_defined_attributes attribute-wchar-t-size}@anchor{1a6} @section Attribute Wchar_T_Size @@ -11518,7 +11591,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{1a5} +@anchor{gnat_rm/implementation_defined_attributes attribute-word-size}@anchor{1a7} @section Attribute Word_Size @@ -11529,7 +11602,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{1a6}@anchor{gnat_rm/standard_and_implementation_defined_restrictions id1}@anchor{1a7} +@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{1a8}@anchor{gnat_rm/standard_and_implementation_defined_restrictions id1}@anchor{1a9} @chapter Standard and Implementation Defined Restrictions @@ -11558,7 +11631,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{1a8}@anchor{gnat_rm/standard_and_implementation_defined_restrictions id2}@anchor{1a9} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions partition-wide-restrictions}@anchor{1aa}@anchor{gnat_rm/standard_and_implementation_defined_restrictions id2}@anchor{1ab} @section Partition-Wide Restrictions @@ -11647,7 +11720,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{1aa} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions immediate-reclamation}@anchor{1ac} @subsection Immediate_Reclamation @@ -11659,7 +11732,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{1ab} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions max-asynchronous-select-nesting}@anchor{1ad} @subsection Max_Asynchronous_Select_Nesting @@ -11671,7 +11744,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{1ac} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions max-entry-queue-length}@anchor{1ae} @subsection Max_Entry_Queue_Length @@ -11692,7 +11765,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{1ad} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions max-protected-entries}@anchor{1af} @subsection Max_Protected_Entries @@ -11703,7 +11776,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{1ae} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions max-select-alternatives}@anchor{1b0} @subsection Max_Select_Alternatives @@ -11712,7 +11785,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{1af} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions max-storage-at-blocking}@anchor{1b1} @subsection Max_Storage_At_Blocking @@ -11723,7 +11796,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{1b0} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions max-task-entries}@anchor{1b2} @subsection Max_Task_Entries @@ -11736,7 +11809,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{1b1} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions max-tasks}@anchor{1b3} @subsection Max_Tasks @@ -11749,7 +11822,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{1b2} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-abort-statements}@anchor{1b4} @subsection No_Abort_Statements @@ -11759,7 +11832,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{1b3} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-access-parameter-allocators}@anchor{1b5} @subsection No_Access_Parameter_Allocators @@ -11770,7 +11843,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{1b4} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-access-subprograms}@anchor{1b6} @subsection No_Access_Subprograms @@ -11780,7 +11853,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{1b5} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-allocators}@anchor{1b7} @subsection No_Allocators @@ -11790,7 +11863,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{1b6} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-anonymous-allocators}@anchor{1b8} @subsection No_Anonymous_Allocators @@ -11800,7 +11873,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{1b7} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-asynchronous-control}@anchor{1b9} @subsection No_Asynchronous_Control @@ -11810,7 +11883,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{1b8} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-calendar}@anchor{1ba} @subsection No_Calendar @@ -11820,7 +11893,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{1b9} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-coextensions}@anchor{1bb} @subsection No_Coextensions @@ -11830,7 +11903,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{1ba} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-default-initialization}@anchor{1bc} @subsection No_Default_Initialization @@ -11847,7 +11920,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{1bb} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-delay}@anchor{1bd} @subsection No_Delay @@ -11857,7 +11930,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{1bc} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-dependence}@anchor{1be} @subsection No_Dependence @@ -11867,7 +11940,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{1bd} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-direct-boolean-operators}@anchor{1bf} @subsection No_Direct_Boolean_Operators @@ -11880,7 +11953,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{1be} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-dispatch}@anchor{1c0} @subsection No_Dispatch @@ -11890,7 +11963,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{1bf} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-dispatching-calls}@anchor{1c1} @subsection No_Dispatching_Calls @@ -11951,7 +12024,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{1c0} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-dynamic-attachment}@anchor{1c2} @subsection No_Dynamic_Attachment @@ -11970,7 +12043,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{1c1} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-dynamic-priorities}@anchor{1c3} @subsection No_Dynamic_Priorities @@ -11979,7 +12052,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{1c2} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-entry-calls-in-elaboration-code}@anchor{1c4} @subsection No_Entry_Calls_In_Elaboration_Code @@ -11991,7 +12064,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{1c3} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-enumeration-maps}@anchor{1c5} @subsection No_Enumeration_Maps @@ -12002,7 +12075,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{1c4} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-exception-handlers}@anchor{1c6} @subsection No_Exception_Handlers @@ -12027,7 +12100,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{1c5} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-exception-propagation}@anchor{1c7} @subsection No_Exception_Propagation @@ -12044,7 +12117,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{1c6} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-exception-registration}@anchor{1c8} @subsection No_Exception_Registration @@ -12058,7 +12131,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{1c7} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-exceptions}@anchor{1c9} @subsection No_Exceptions @@ -12068,7 +12141,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{1c8} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-finalization}@anchor{1ca} @subsection No_Finalization @@ -12109,7 +12182,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{1c9} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-fixed-point}@anchor{1cb} @subsection No_Fixed_Point @@ -12119,7 +12192,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{1ca} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-floating-point}@anchor{1cc} @subsection No_Floating_Point @@ -12129,7 +12202,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{1cb} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-conditionals}@anchor{1cd} @subsection No_Implicit_Conditionals @@ -12145,7 +12218,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{1cc} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-dynamic-code}@anchor{1ce} @subsection No_Implicit_Dynamic_Code @@ -12175,7 +12248,7 @@ foreign-language convention; primitive operations of nested tagged types. @node No_Implicit_Heap_Allocations,No_Implicit_Protected_Object_Allocations,No_Implicit_Dynamic_Code,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-heap-allocations}@anchor{1cd} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-heap-allocations}@anchor{1cf} @subsection No_Implicit_Heap_Allocations @@ -12184,7 +12257,7 @@ types. [RM D.7] No constructs are allowed to cause implicit heap allocation. @node No_Implicit_Protected_Object_Allocations,No_Implicit_Task_Allocations,No_Implicit_Heap_Allocations,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-protected-object-allocations}@anchor{1ce} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-protected-object-allocations}@anchor{1d0} @subsection No_Implicit_Protected_Object_Allocations @@ -12194,7 +12267,7 @@ types. 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{1cf} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-task-allocations}@anchor{1d1} @subsection No_Implicit_Task_Allocations @@ -12203,7 +12276,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{1d0} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-initialize-scalars}@anchor{1d2} @subsection No_Initialize_Scalars @@ -12215,7 +12288,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{1d1} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-io}@anchor{1d3} @subsection No_IO @@ -12226,7 +12299,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{1d2} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-local-allocators}@anchor{1d4} @subsection No_Local_Allocators @@ -12237,7 +12310,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{1d3} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-local-protected-objects}@anchor{1d5} @subsection No_Local_Protected_Objects @@ -12247,7 +12320,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{1d4} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-local-timing-events}@anchor{1d6} @subsection No_Local_Timing_Events @@ -12257,7 +12330,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{1d5} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-long-long-integers}@anchor{1d7} @subsection No_Long_Long_Integers @@ -12269,7 +12342,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{1d6} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-multiple-elaboration}@anchor{1d8} @subsection No_Multiple_Elaboration @@ -12286,7 +12359,7 @@ 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{1d7} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-nested-finalization}@anchor{1d9} @subsection No_Nested_Finalization @@ -12295,7 +12368,7 @@ 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{1d8} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-protected-type-allocators}@anchor{1da} @subsection No_Protected_Type_Allocators @@ -12305,7 +12378,7 @@ 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{1d9} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-protected-types}@anchor{1db} @subsection No_Protected_Types @@ -12315,7 +12388,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{1da} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-recursion}@anchor{1dc} @subsection No_Recursion @@ -12325,7 +12398,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{1db} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-reentrancy}@anchor{1dd} @subsection No_Reentrancy @@ -12335,7 +12408,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{1dc} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-relative-delay}@anchor{1de} @subsection No_Relative_Delay @@ -12346,7 +12419,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{1dd} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-requeue-statements}@anchor{1df} @subsection No_Requeue_Statements @@ -12364,7 +12437,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{1de} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-secondary-stack}@anchor{1e0} @subsection No_Secondary_Stack @@ -12377,7 +12450,7 @@ stack is used to implement functions returning unconstrained objects secondary stacks for tasks (excluding the environment task) at run time. @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{1df} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-select-statements}@anchor{1e1} @subsection No_Select_Statements @@ -12387,7 +12460,7 @@ secondary stacks for tasks (excluding the environment task) at run time. 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{1e0} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-specific-termination-handlers}@anchor{1e2} @subsection No_Specific_Termination_Handlers @@ -12397,7 +12470,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{1e1} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-specification-of-aspect}@anchor{1e3} @subsection No_Specification_of_Aspect @@ -12408,7 +12481,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{1e2} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-standard-allocators-after-elaboration}@anchor{1e4} @subsection No_Standard_Allocators_After_Elaboration @@ -12420,7 +12493,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{1e3} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-standard-storage-pools}@anchor{1e5} @subsection No_Standard_Storage_Pools @@ -12432,7 +12505,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{1e4} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-stream-optimizations}@anchor{1e6} @subsection No_Stream_Optimizations @@ -12445,7 +12518,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{1e5} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-streams}@anchor{1e7} @subsection No_Streams @@ -12466,7 +12539,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{1e6} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-task-allocators}@anchor{1e8} @subsection No_Task_Allocators @@ -12476,7 +12549,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{1e7} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-task-at-interrupt-priority}@anchor{1e9} @subsection No_Task_At_Interrupt_Priority @@ -12488,7 +12561,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{1e8} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-task-attributes-package}@anchor{1ea} @subsection No_Task_Attributes_Package @@ -12505,7 +12578,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{1e9} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-task-hierarchy}@anchor{1eb} @subsection No_Task_Hierarchy @@ -12515,7 +12588,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{1ea} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-task-termination}@anchor{1ec} @subsection No_Task_Termination @@ -12524,7 +12597,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{1eb} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-tasking}@anchor{1ed} @subsection No_Tasking @@ -12537,7 +12610,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{1ec} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-terminate-alternatives}@anchor{1ee} @subsection No_Terminate_Alternatives @@ -12546,7 +12619,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{1ed} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-unchecked-access}@anchor{1ef} @subsection No_Unchecked_Access @@ -12556,7 +12629,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{1ee} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-unchecked-conversion}@anchor{1f0} @subsection No_Unchecked_Conversion @@ -12566,7 +12639,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{1ef} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-unchecked-deallocation}@anchor{1f1} @subsection No_Unchecked_Deallocation @@ -12576,7 +12649,7 @@ dependences on the predefined generic function Unchecked_Conversion. dependences on the predefined generic procedure Unchecked_Deallocation. @node No_Use_Of_Entity,Pure_Barriers,No_Unchecked_Deallocation,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-use-of-entity}@anchor{1f0} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-use-of-entity}@anchor{1f2} @subsection No_Use_Of_Entity @@ -12596,7 +12669,7 @@ No_Use_Of_Entity => Ada.Text_IO.Put_Line @end example @node Pure_Barriers,Simple_Barriers,No_Use_Of_Entity,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions pure-barriers}@anchor{1f1} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions pure-barriers}@anchor{1f3} @subsection Pure_Barriers @@ -12645,7 +12718,7 @@ but still ensures absence of side effects, exceptions, and recursion during the evaluation of the barriers. @node Simple_Barriers,Static_Priorities,Pure_Barriers,Partition-Wide Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions simple-barriers}@anchor{1f2} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions simple-barriers}@anchor{1f4} @subsection Simple_Barriers @@ -12664,7 +12737,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{1f3} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions static-priorities}@anchor{1f5} @subsection Static_Priorities @@ -12675,7 +12748,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{1f4} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions static-storage-size}@anchor{1f6} @subsection Static_Storage_Size @@ -12685,7 +12758,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{1f5}@anchor{gnat_rm/standard_and_implementation_defined_restrictions id3}@anchor{1f6} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions program-unit-level-restrictions}@anchor{1f7}@anchor{gnat_rm/standard_and_implementation_defined_restrictions id3}@anchor{1f8} @section Program Unit Level Restrictions @@ -12714,7 +12787,7 @@ other compilation units in the partition. @end menu @node No_Elaboration_Code,No_Dynamic_Sized_Objects,,Program Unit Level Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-elaboration-code}@anchor{1f7} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-elaboration-code}@anchor{1f9} @subsection No_Elaboration_Code @@ -12770,7 +12843,7 @@ associated with the unit. This counter is typically used to check for access before elaboration and to control multiple elaboration attempts. @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{1f8} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-dynamic-sized-objects}@anchor{1fa} @subsection No_Dynamic_Sized_Objects @@ -12788,7 +12861,7 @@ 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{1f9} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-entry-queue}@anchor{1fb} @subsection No_Entry_Queue @@ -12801,7 +12874,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{1fa} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implementation-aspect-specifications}@anchor{1fc} @subsection No_Implementation_Aspect_Specifications @@ -12812,7 +12885,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{1fb} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implementation-attributes}@anchor{1fd} @subsection No_Implementation_Attributes @@ -12824,7 +12897,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{1fc} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implementation-identifiers}@anchor{1fe} @subsection No_Implementation_Identifiers @@ -12835,7 +12908,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{1fd} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implementation-pragmas}@anchor{1ff} @subsection No_Implementation_Pragmas @@ -12846,7 +12919,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{1fe} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implementation-restrictions}@anchor{200} @subsection No_Implementation_Restrictions @@ -12858,7 +12931,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{1ff} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implementation-units}@anchor{201} @subsection No_Implementation_Units @@ -12869,7 +12942,7 @@ mention in the context clause of any implementation-defined descendants of packages Ada, Interfaces, or System. @node No_Implicit_Aliasing,No_Implicit_Loops,No_Implementation_Units,Program Unit Level Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-aliasing}@anchor{200} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-aliasing}@anchor{202} @subsection No_Implicit_Aliasing @@ -12884,7 +12957,7 @@ to be aliased, and in such cases, it can always be replaced by the standard attribute Unchecked_Access which is preferable. @node No_Implicit_Loops,No_Obsolescent_Features,No_Implicit_Aliasing,Program Unit Level Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-loops}@anchor{201} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-implicit-loops}@anchor{203} @subsection No_Implicit_Loops @@ -12901,7 +12974,7 @@ arrays larger than about 5000 scalar components. Note that if this restriction is set in the spec of a package, it will not apply to its body. @node No_Obsolescent_Features,No_Wide_Characters,No_Implicit_Loops,Program Unit Level Restrictions -@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-obsolescent-features}@anchor{202} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-obsolescent-features}@anchor{204} @subsection No_Obsolescent_Features @@ -12911,7 +12984,7 @@ is set in the spec of a package, it will not apply to its body. 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{203} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions no-wide-characters}@anchor{205} @subsection No_Wide_Characters @@ -12925,7 +12998,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{204} +@anchor{gnat_rm/standard_and_implementation_defined_restrictions spark-05}@anchor{206} @subsection SPARK_05 @@ -13284,7 +13357,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{205}@anchor{gnat_rm/implementation_advice implementation-advice}@anchor{a}@anchor{gnat_rm/implementation_advice id1}@anchor{206} +@anchor{gnat_rm/implementation_advice doc}@anchor{207}@anchor{gnat_rm/implementation_advice implementation-advice}@anchor{a}@anchor{gnat_rm/implementation_advice id1}@anchor{208} @chapter Implementation Advice @@ -13381,7 +13454,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{207} +@anchor{gnat_rm/implementation_advice rm-1-1-3-20-error-detection}@anchor{209} @section RM 1.1.3(20): Error Detection @@ -13398,7 +13471,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{208} +@anchor{gnat_rm/implementation_advice rm-1-1-3-31-child-units}@anchor{20a} @section RM 1.1.3(31): Child Units @@ -13414,7 +13487,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{209} +@anchor{gnat_rm/implementation_advice rm-1-1-5-12-bounded-errors}@anchor{20b} @section RM 1.1.5(12): Bounded Errors @@ -13431,7 +13504,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{20a}@anchor{gnat_rm/implementation_advice rm-2-8-16-pragmas}@anchor{20b} +@anchor{gnat_rm/implementation_advice id2}@anchor{20c}@anchor{gnat_rm/implementation_advice rm-2-8-16-pragmas}@anchor{20d} @section RM 2.8(16): Pragmas @@ -13544,7 +13617,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{20c} +@anchor{gnat_rm/implementation_advice rm-2-8-17-19-pragmas}@anchor{20e} @section RM 2.8(17-19): Pragmas @@ -13565,14 +13638,14 @@ replacing @cite{library_items}." @end itemize @end quotation -See @ref{20b,,RM 2.8(16); Pragmas}. +See @ref{20d,,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{20d} +@anchor{gnat_rm/implementation_advice rm-3-5-2-5-alternative-character-sets}@anchor{20f} @section RM 3.5.2(5): Alternative Character Sets @@ -13600,7 +13673,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{20e} +@anchor{gnat_rm/implementation_advice rm-3-5-4-28-integer-types}@anchor{210} @section RM 3.5.4(28): Integer Types @@ -13619,7 +13692,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{20f} +@anchor{gnat_rm/implementation_advice rm-3-5-4-29-integer-types}@anchor{211} @section RM 3.5.4(29): Integer Types @@ -13635,7 +13708,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{210} +@anchor{gnat_rm/implementation_advice rm-3-5-5-8-enumeration-values}@anchor{212} @section RM 3.5.5(8): Enumeration Values @@ -13655,7 +13728,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{211} +@anchor{gnat_rm/implementation_advice rm-3-5-7-17-float-types}@anchor{213} @section RM 3.5.7(17): Float Types @@ -13685,7 +13758,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{212} +@anchor{gnat_rm/implementation_advice rm-3-6-2-11-multidimensional-arrays}@anchor{214} @section RM 3.6.2(11): Multidimensional Arrays @@ -13703,7 +13776,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{213} +@anchor{gnat_rm/implementation_advice rm-9-6-30-31-duration-small}@anchor{215} @section RM 9.6(30-31): Duration'Small @@ -13724,7 +13797,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{214} +@anchor{gnat_rm/implementation_advice rm-10-2-1-12-consistent-representation}@anchor{216} @section RM 10.2.1(12): Consistent Representation @@ -13746,7 +13819,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{215} +@anchor{gnat_rm/implementation_advice rm-11-4-1-19-exception-information}@anchor{217} @section RM 11.4.1(19): Exception Information @@ -13777,7 +13850,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{216} +@anchor{gnat_rm/implementation_advice rm-11-5-28-suppression-of-checks}@anchor{218} @section RM 11.5(28): Suppression of Checks @@ -13792,7 +13865,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{217} +@anchor{gnat_rm/implementation_advice rm-13-1-21-24-representation-clauses}@anchor{219} @section RM 13.1 (21-24): Representation Clauses @@ -13841,7 +13914,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{218} +@anchor{gnat_rm/implementation_advice rm-13-2-6-8-packed-types}@anchor{21a} @section RM 13.2(6-8): Packed Types @@ -13880,7 +13953,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{219} +@anchor{gnat_rm/implementation_advice rm-13-3-14-19-address-clauses}@anchor{21b} @section RM 13.3(14-19): Address Clauses @@ -13933,7 +14006,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{21a} +@anchor{gnat_rm/implementation_advice rm-13-3-29-35-alignment-clauses}@anchor{21c} @section RM 13.3(29-35): Alignment Clauses @@ -13990,7 +14063,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{21b} +@anchor{gnat_rm/implementation_advice rm-13-3-42-43-size-clauses}@anchor{21d} @section RM 13.3(42-43): Size Clauses @@ -14008,7 +14081,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{21c} +@anchor{gnat_rm/implementation_advice rm-13-3-50-56-size-clauses}@anchor{21e} @section RM 13.3(50-56): Size Clauses @@ -14059,7 +14132,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{21d} +@anchor{gnat_rm/implementation_advice rm-13-3-71-73-component-size-clauses}@anchor{21f} @section RM 13.3(71-73): Component Size Clauses @@ -14093,7 +14166,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{21e} +@anchor{gnat_rm/implementation_advice rm-13-4-9-10-enumeration-representation-clauses}@anchor{220} @section RM 13.4(9-10): Enumeration Representation Clauses @@ -14115,7 +14188,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{21f} +@anchor{gnat_rm/implementation_advice rm-13-5-1-17-22-record-representation-clauses}@anchor{221} @section RM 13.5.1(17-22): Record Representation Clauses @@ -14175,7 +14248,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{220} +@anchor{gnat_rm/implementation_advice rm-13-5-2-5-storage-place-attributes}@anchor{222} @section RM 13.5.2(5): Storage Place Attributes @@ -14195,7 +14268,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{221} +@anchor{gnat_rm/implementation_advice rm-13-5-3-7-8-bit-ordering}@anchor{223} @section RM 13.5.3(7-8): Bit Ordering @@ -14215,7 +14288,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{222} +@anchor{gnat_rm/implementation_advice rm-13-7-37-address-as-private}@anchor{224} @section RM 13.7(37): Address as Private @@ -14233,7 +14306,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{223} +@anchor{gnat_rm/implementation_advice rm-13-7-1-16-address-operations}@anchor{225} @section RM 13.7.1(16): Address Operations @@ -14251,7 +14324,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{224} +@anchor{gnat_rm/implementation_advice rm-13-9-14-17-unchecked-conversion}@anchor{226} @section RM 13.9(14-17): Unchecked Conversion @@ -14295,7 +14368,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{225} +@anchor{gnat_rm/implementation_advice rm-13-11-23-25-implicit-heap-usage}@anchor{227} @section RM 13.11(23-25): Implicit Heap Usage @@ -14346,7 +14419,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{226} +@anchor{gnat_rm/implementation_advice rm-13-11-2-17-unchecked-deallocation}@anchor{228} @section RM 13.11.2(17): Unchecked Deallocation @@ -14361,7 +14434,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{227} +@anchor{gnat_rm/implementation_advice rm-13-13-2-17-stream-oriented-attributes}@anchor{229} @section RM 13.13.2(17): Stream Oriented Attributes @@ -14416,7 +14489,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{228} +@anchor{gnat_rm/implementation_advice rm-a-1-52-names-of-predefined-numeric-types}@anchor{22a} @section RM A.1(52): Names of Predefined Numeric Types @@ -14434,7 +14507,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{229} +@anchor{gnat_rm/implementation_advice rm-a-3-2-49-ada-characters-handling}@anchor{22b} @section RM A.3.2(49): @cite{Ada.Characters.Handling} @@ -14451,7 +14524,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{22a} +@anchor{gnat_rm/implementation_advice rm-a-4-4-106-bounded-length-string-handling}@anchor{22c} @section RM A.4.4(106): Bounded-Length String Handling @@ -14466,7 +14539,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{22b} +@anchor{gnat_rm/implementation_advice rm-a-5-2-46-47-random-number-generation}@anchor{22d} @section RM A.5.2(46-47): Random Number Generation @@ -14495,7 +14568,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{22c} +@anchor{gnat_rm/implementation_advice rm-a-10-7-23-get-immediate}@anchor{22e} @section RM A.10.7(23): @cite{Get_Immediate} @@ -14519,7 +14592,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{22d} +@anchor{gnat_rm/implementation_advice rm-b-1-39-41-pragma-export}@anchor{22f} @section RM B.1(39-41): Pragma @cite{Export} @@ -14567,7 +14640,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{22e} +@anchor{gnat_rm/implementation_advice rm-b-2-12-13-package-interfaces}@anchor{230} @section RM B.2(12-13): Package @cite{Interfaces} @@ -14597,7 +14670,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{22f} +@anchor{gnat_rm/implementation_advice rm-b-3-63-71-interfacing-with-c}@anchor{231} @section RM B.3(63-71): Interfacing with C @@ -14685,7 +14758,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{230} +@anchor{gnat_rm/implementation_advice rm-b-4-95-98-interfacing-with-cobol}@anchor{232} @section RM B.4(95-98): Interfacing with COBOL @@ -14726,7 +14799,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{231} +@anchor{gnat_rm/implementation_advice rm-b-5-22-26-interfacing-with-fortran}@anchor{233} @section RM B.5(22-26): Interfacing with Fortran @@ -14777,7 +14850,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{232} +@anchor{gnat_rm/implementation_advice rm-c-1-3-5-access-to-machine-operations}@anchor{234} @section RM C.1(3-5): Access to Machine Operations @@ -14812,7 +14885,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{233} +@anchor{gnat_rm/implementation_advice rm-c-1-10-16-access-to-machine-operations}@anchor{235} @section RM C.1(10-16): Access to Machine Operations @@ -14873,7 +14946,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{234} +@anchor{gnat_rm/implementation_advice rm-c-3-28-interrupt-support}@anchor{236} @section RM C.3(28): Interrupt Support @@ -14891,7 +14964,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{235} +@anchor{gnat_rm/implementation_advice rm-c-3-1-20-21-protected-procedure-handlers}@anchor{237} @section RM C.3.1(20-21): Protected Procedure Handlers @@ -14917,7 +14990,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{236} +@anchor{gnat_rm/implementation_advice rm-c-3-2-25-package-interrupts}@anchor{238} @section RM C.3.2(25): Package @cite{Interrupts} @@ -14935,7 +15008,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{237} +@anchor{gnat_rm/implementation_advice rm-c-4-14-pre-elaboration-requirements}@anchor{239} @section RM C.4(14): Pre-elaboration Requirements @@ -14951,7 +15024,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{238} +@anchor{gnat_rm/implementation_advice rm-c-5-8-pragma-discard-names}@anchor{23a} @section RM C.5(8): Pragma @cite{Discard_Names} @@ -14969,7 +15042,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{239} +@anchor{gnat_rm/implementation_advice rm-c-7-2-30-the-package-task-attributes}@anchor{23b} @section RM C.7.2(30): The Package Task_Attributes @@ -14990,7 +15063,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{23a} +@anchor{gnat_rm/implementation_advice rm-d-3-17-locking-policies}@anchor{23c} @section RM D.3(17): Locking Policies @@ -15007,7 +15080,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{23b} +@anchor{gnat_rm/implementation_advice rm-d-4-16-entry-queuing-policies}@anchor{23d} @section RM D.4(16): Entry Queuing Policies @@ -15022,7 +15095,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{23c} +@anchor{gnat_rm/implementation_advice rm-d-6-9-10-preemptive-abort}@anchor{23e} @section RM D.6(9-10): Preemptive Abort @@ -15048,7 +15121,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{23d} +@anchor{gnat_rm/implementation_advice rm-d-7-21-tasking-restrictions}@anchor{23f} @section RM D.7(21): Tasking Restrictions @@ -15067,7 +15140,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{23e} +@anchor{gnat_rm/implementation_advice rm-d-8-47-49-monotonic-time}@anchor{240} @section RM D.8(47-49): Monotonic Time @@ -15102,7 +15175,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{23f} +@anchor{gnat_rm/implementation_advice rm-e-5-28-29-partition-communication-subsystem}@anchor{241} @section RM E.5(28-29): Partition Communication Subsystem @@ -15130,7 +15203,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{240} +@anchor{gnat_rm/implementation_advice rm-f-7-cobol-support}@anchor{242} @section RM F(7): COBOL Support @@ -15150,7 +15223,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{241} +@anchor{gnat_rm/implementation_advice rm-f-1-2-decimal-radix-support}@anchor{243} @section RM F.1(2): Decimal Radix Support @@ -15166,7 +15239,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{242} +@anchor{gnat_rm/implementation_advice rm-g-numerics}@anchor{244} @section RM G: Numerics @@ -15186,7 +15259,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{243} +@anchor{gnat_rm/implementation_advice rm-g-1-1-56-58-complex-types}@anchor{245} @section RM G.1.1(56-58): Complex Types @@ -15248,7 +15321,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{244} +@anchor{gnat_rm/implementation_advice rm-g-1-2-49-complex-elementary-functions}@anchor{246} @section RM G.1.2(49): Complex Elementary Functions @@ -15270,7 +15343,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{245} +@anchor{gnat_rm/implementation_advice rm-g-2-4-19-accuracy-requirements}@anchor{247} @section RM G.2.4(19): Accuracy Requirements @@ -15294,7 +15367,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{246} +@anchor{gnat_rm/implementation_advice rm-g-2-6-15-complex-arithmetic-accuracy}@anchor{248} @section RM G.2.6(15): Complex Arithmetic Accuracy @@ -15312,7 +15385,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{247} +@anchor{gnat_rm/implementation_advice rm-h-6-15-2-pragma-partition-elaboration-policy}@anchor{249} @section RM H.6(15/2): Pragma Partition_Elaboration_Policy @@ -15327,7 +15400,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{248}@anchor{gnat_rm/implementation_defined_characteristics id1}@anchor{249} +@anchor{gnat_rm/implementation_defined_characteristics implementation-defined-characteristics}@anchor{b}@anchor{gnat_rm/implementation_defined_characteristics doc}@anchor{24a}@anchor{gnat_rm/implementation_defined_characteristics id1}@anchor{24b} @chapter Implementation Defined Characteristics @@ -16522,7 +16595,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{24a,,GNAT.Regexp (g-regexp.ads)}. +See @ref{24c,,GNAT.Regexp (g-regexp.ads)}. @itemize * @@ -17063,13 +17136,13 @@ in a pragma @cite{Locking_Policy}. See D.3(4)." @end itemize The two implementation defined policies permitted in GNAT are -@cite{Inheritance_Locking} and @cite{Conccurent_Readers_Locking}. On +@cite{Inheritance_Locking} and @cite{Concurrent_Readers_Locking}. On targets that support the @cite{Inheritance_Locking} policy, locking is implemented by inheritance, i.e., the task owning the lock operates at a priority equal to the highest priority of any task currently -requesting the lock. On targets that support the -@cite{Conccurent_Readers_Locking} policy, locking is implemented with a -read/write lock allowing multiple propected object functions to enter +requesting the lock. On targets that support the +@cite{Concurrent_Readers_Locking} policy, locking is implemented with a +read/write lock allowing multiple protected object functions to enter concurrently. @@ -17564,7 +17637,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{24b}@anchor{gnat_rm/intrinsic_subprograms intrinsic-subprograms}@anchor{c}@anchor{gnat_rm/intrinsic_subprograms id1}@anchor{24c} +@anchor{gnat_rm/intrinsic_subprograms doc}@anchor{24d}@anchor{gnat_rm/intrinsic_subprograms intrinsic-subprograms}@anchor{c}@anchor{gnat_rm/intrinsic_subprograms id1}@anchor{24e} @chapter Intrinsic Subprograms @@ -17601,7 +17674,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{24d}@anchor{gnat_rm/intrinsic_subprograms intrinsic-operators}@anchor{24e} +@anchor{gnat_rm/intrinsic_subprograms id2}@anchor{24f}@anchor{gnat_rm/intrinsic_subprograms intrinsic-operators}@anchor{250} @section Intrinsic Operators @@ -17632,7 +17705,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{24f}@anchor{gnat_rm/intrinsic_subprograms id3}@anchor{250} +@anchor{gnat_rm/intrinsic_subprograms compilation-date}@anchor{251}@anchor{gnat_rm/intrinsic_subprograms id3}@anchor{252} @section Compilation_Date @@ -17646,7 +17719,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{251}@anchor{gnat_rm/intrinsic_subprograms id4}@anchor{252} +@anchor{gnat_rm/intrinsic_subprograms compilation-time}@anchor{253}@anchor{gnat_rm/intrinsic_subprograms id4}@anchor{254} @section Compilation_Time @@ -17660,7 +17733,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{253}@anchor{gnat_rm/intrinsic_subprograms enclosing-entity}@anchor{254} +@anchor{gnat_rm/intrinsic_subprograms id5}@anchor{255}@anchor{gnat_rm/intrinsic_subprograms enclosing-entity}@anchor{256} @section Enclosing_Entity @@ -17674,7 +17747,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{255}@anchor{gnat_rm/intrinsic_subprograms exception-information}@anchor{256} +@anchor{gnat_rm/intrinsic_subprograms id6}@anchor{257}@anchor{gnat_rm/intrinsic_subprograms exception-information}@anchor{258} @section Exception_Information @@ -17688,7 +17761,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{257}@anchor{gnat_rm/intrinsic_subprograms id7}@anchor{258} +@anchor{gnat_rm/intrinsic_subprograms exception-message}@anchor{259}@anchor{gnat_rm/intrinsic_subprograms id7}@anchor{25a} @section Exception_Message @@ -17702,7 +17775,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{259}@anchor{gnat_rm/intrinsic_subprograms id8}@anchor{25a} +@anchor{gnat_rm/intrinsic_subprograms exception-name}@anchor{25b}@anchor{gnat_rm/intrinsic_subprograms id8}@anchor{25c} @section Exception_Name @@ -17716,7 +17789,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{25b}@anchor{gnat_rm/intrinsic_subprograms id9}@anchor{25c} +@anchor{gnat_rm/intrinsic_subprograms file}@anchor{25d}@anchor{gnat_rm/intrinsic_subprograms id9}@anchor{25e} @section File @@ -17730,7 +17803,7 @@ application program should simply call the function file. @node Line,Shifts and Rotates,File,Intrinsic Subprograms -@anchor{gnat_rm/intrinsic_subprograms id10}@anchor{25d}@anchor{gnat_rm/intrinsic_subprograms line}@anchor{25e} +@anchor{gnat_rm/intrinsic_subprograms id10}@anchor{25f}@anchor{gnat_rm/intrinsic_subprograms line}@anchor{260} @section Line @@ -17744,7 +17817,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{25f}@anchor{gnat_rm/intrinsic_subprograms shifts-and-rotates}@anchor{260} +@anchor{gnat_rm/intrinsic_subprograms id11}@anchor{261}@anchor{gnat_rm/intrinsic_subprograms shifts-and-rotates}@anchor{262} @section Shifts and Rotates @@ -17783,7 +17856,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{261}@anchor{gnat_rm/intrinsic_subprograms id12}@anchor{262} +@anchor{gnat_rm/intrinsic_subprograms source-location}@anchor{263}@anchor{gnat_rm/intrinsic_subprograms id12}@anchor{264} @section Source_Location @@ -17797,7 +17870,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{263}@anchor{gnat_rm/representation_clauses_and_pragmas id1}@anchor{264} +@anchor{gnat_rm/representation_clauses_and_pragmas representation-clauses-and-pragmas}@anchor{d}@anchor{gnat_rm/representation_clauses_and_pragmas doc}@anchor{265}@anchor{gnat_rm/representation_clauses_and_pragmas id1}@anchor{266} @chapter Representation Clauses and Pragmas @@ -17843,7 +17916,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{265}@anchor{gnat_rm/representation_clauses_and_pragmas alignment-clauses}@anchor{266} +@anchor{gnat_rm/representation_clauses_and_pragmas id2}@anchor{267}@anchor{gnat_rm/representation_clauses_and_pragmas alignment-clauses}@anchor{268} @section Alignment Clauses @@ -17863,7 +17936,7 @@ For elementary 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{183,,Attribute Maximum_Alignment}.) +@cite{Standard'Maximum_Alignment}; see @ref{185,,Attribute Maximum_Alignment}.) @geindex Maximum_Alignment attribute @@ -17972,7 +18045,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{267}@anchor{gnat_rm/representation_clauses_and_pragmas size-clauses}@anchor{268} +@anchor{gnat_rm/representation_clauses_and_pragmas id3}@anchor{269}@anchor{gnat_rm/representation_clauses_and_pragmas size-clauses}@anchor{26a} @section Size Clauses @@ -18049,7 +18122,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{269}@anchor{gnat_rm/representation_clauses_and_pragmas id4}@anchor{26a} +@anchor{gnat_rm/representation_clauses_and_pragmas storage-size-clauses}@anchor{26b}@anchor{gnat_rm/representation_clauses_and_pragmas id4}@anchor{26c} @section Storage_Size Clauses @@ -18122,7 +18195,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{26b}@anchor{gnat_rm/representation_clauses_and_pragmas size-of-variant-record-objects}@anchor{26c} +@anchor{gnat_rm/representation_clauses_and_pragmas id5}@anchor{26d}@anchor{gnat_rm/representation_clauses_and_pragmas size-of-variant-record-objects}@anchor{26e} @section Size of Variant Record Objects @@ -18232,7 +18305,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{26d}@anchor{gnat_rm/representation_clauses_and_pragmas biased-representation}@anchor{26e} +@anchor{gnat_rm/representation_clauses_and_pragmas id6}@anchor{26f}@anchor{gnat_rm/representation_clauses_and_pragmas biased-representation}@anchor{270} @section Biased Representation @@ -18270,7 +18343,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{26f}@anchor{gnat_rm/representation_clauses_and_pragmas value-size-and-object-size-clauses}@anchor{270} +@anchor{gnat_rm/representation_clauses_and_pragmas id7}@anchor{271}@anchor{gnat_rm/representation_clauses_and_pragmas value-size-and-object-size-clauses}@anchor{272} @section Value_Size and Object_Size Clauses @@ -18577,7 +18650,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{271}@anchor{gnat_rm/representation_clauses_and_pragmas component-size-clauses}@anchor{272} +@anchor{gnat_rm/representation_clauses_and_pragmas id8}@anchor{273}@anchor{gnat_rm/representation_clauses_and_pragmas component-size-clauses}@anchor{274} @section Component_Size Clauses @@ -18624,7 +18697,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{273}@anchor{gnat_rm/representation_clauses_and_pragmas id9}@anchor{274} +@anchor{gnat_rm/representation_clauses_and_pragmas bit-order-clauses}@anchor{275}@anchor{gnat_rm/representation_clauses_and_pragmas id9}@anchor{276} @section Bit_Order Clauses @@ -18730,7 +18803,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{275}@anchor{gnat_rm/representation_clauses_and_pragmas effect-of-bit-order-on-byte-ordering}@anchor{276} +@anchor{gnat_rm/representation_clauses_and_pragmas id10}@anchor{277}@anchor{gnat_rm/representation_clauses_and_pragmas effect-of-bit-order-on-byte-ordering}@anchor{278} @section Effect of Bit_Order on Byte Ordering @@ -18987,7 +19060,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{277}@anchor{gnat_rm/representation_clauses_and_pragmas id11}@anchor{278} +@anchor{gnat_rm/representation_clauses_and_pragmas pragma-pack-for-arrays}@anchor{279}@anchor{gnat_rm/representation_clauses_and_pragmas id11}@anchor{27a} @section Pragma Pack for Arrays @@ -19104,7 +19177,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{279}@anchor{gnat_rm/representation_clauses_and_pragmas id12}@anchor{27a} +@anchor{gnat_rm/representation_clauses_and_pragmas pragma-pack-for-records}@anchor{27b}@anchor{gnat_rm/representation_clauses_and_pragmas id12}@anchor{27c} @section Pragma Pack for Records @@ -19189,7 +19262,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{27b}@anchor{gnat_rm/representation_clauses_and_pragmas record-representation-clauses}@anchor{27c} +@anchor{gnat_rm/representation_clauses_and_pragmas id13}@anchor{27d}@anchor{gnat_rm/representation_clauses_and_pragmas record-representation-clauses}@anchor{27e} @section Record Representation Clauses @@ -19274,7 +19347,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{27d}@anchor{gnat_rm/representation_clauses_and_pragmas id14}@anchor{27e} +@anchor{gnat_rm/representation_clauses_and_pragmas handling-of-records-with-holes}@anchor{27f}@anchor{gnat_rm/representation_clauses_and_pragmas id14}@anchor{280} @section Handling of Records with Holes @@ -19351,7 +19424,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{27f}@anchor{gnat_rm/representation_clauses_and_pragmas id15}@anchor{280} +@anchor{gnat_rm/representation_clauses_and_pragmas enumeration-clauses}@anchor{281}@anchor{gnat_rm/representation_clauses_and_pragmas id15}@anchor{282} @section Enumeration Clauses @@ -19394,7 +19467,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{281}@anchor{gnat_rm/representation_clauses_and_pragmas address-clauses}@anchor{282} +@anchor{gnat_rm/representation_clauses_and_pragmas id16}@anchor{283}@anchor{gnat_rm/representation_clauses_and_pragmas address-clauses}@anchor{284} @section Address Clauses @@ -19521,10 +19594,9 @@ check Alignment_Check is suppressed, or if @cite{pragma Restrictions (No_Elaboration_Code)} is in effect. It is also suppressed by default on non-strict alignment machines (such as the x86). -Finally, GNAT does not permit overlaying of objects of controlled types or -composite types containing a controlled component. In most cases, the compiler -can detect an attempt at such overlays and will generate a warning at compile -time and a Program_Error exception at run time. +Finally, GNAT does not permit overlaying of objects of class-wide types. In +most cases, the compiler can detect an attempt at such overlays and will +generate a warning at compile time and a Program_Error exception at run time. @geindex Export @@ -19724,7 +19796,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{283}@anchor{gnat_rm/representation_clauses_and_pragmas use-of-address-clauses-for-memory-mapped-i-o}@anchor{284} +@anchor{gnat_rm/representation_clauses_and_pragmas id17}@anchor{285}@anchor{gnat_rm/representation_clauses_and_pragmas use-of-address-clauses-for-memory-mapped-i-o}@anchor{286} @section Use of Address Clauses for Memory-Mapped I/O @@ -19782,7 +19854,7 @@ provides the pragma @cite{Volatile_Full_Access} which can be used in lieu of pragma @cite{Atomic} and will give the additional guarantee. @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{285}@anchor{gnat_rm/representation_clauses_and_pragmas effect-of-convention-on-representation}@anchor{286} +@anchor{gnat_rm/representation_clauses_and_pragmas id18}@anchor{287}@anchor{gnat_rm/representation_clauses_and_pragmas effect-of-convention-on-representation}@anchor{288} @section Effect of Convention on Representation @@ -19860,7 +19932,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{287}@anchor{gnat_rm/representation_clauses_and_pragmas id19}@anchor{288} +@anchor{gnat_rm/representation_clauses_and_pragmas conventions-and-anonymous-access-types}@anchor{289}@anchor{gnat_rm/representation_clauses_and_pragmas id19}@anchor{28a} @section Conventions and Anonymous Access Types @@ -19936,7 +20008,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{289}@anchor{gnat_rm/representation_clauses_and_pragmas determining-the-representations-chosen-by-gnat}@anchor{28a} +@anchor{gnat_rm/representation_clauses_and_pragmas id20}@anchor{28b}@anchor{gnat_rm/representation_clauses_and_pragmas determining-the-representations-chosen-by-gnat}@anchor{28c} @section Determining the Representations chosen by GNAT @@ -20088,7 +20160,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{28b}@anchor{gnat_rm/standard_library_routines id1}@anchor{28c} +@anchor{gnat_rm/standard_library_routines standard-library-routines}@anchor{e}@anchor{gnat_rm/standard_library_routines doc}@anchor{28d}@anchor{gnat_rm/standard_library_routines id1}@anchor{28e} @chapter Standard Library Routines @@ -20911,7 +20983,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{28d}@anchor{gnat_rm/the_implementation_of_standard_i_o id1}@anchor{28e} +@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{28f}@anchor{gnat_rm/the_implementation_of_standard_i_o id1}@anchor{290} @chapter The Implementation of Standard I/O @@ -20963,7 +21035,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{28f}@anchor{gnat_rm/the_implementation_of_standard_i_o id2}@anchor{290} +@anchor{gnat_rm/the_implementation_of_standard_i_o standard-i-o-packages}@anchor{291}@anchor{gnat_rm/the_implementation_of_standard_i_o id2}@anchor{292} @section Standard I/O Packages @@ -21034,7 +21106,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{291}@anchor{gnat_rm/the_implementation_of_standard_i_o id3}@anchor{292} +@anchor{gnat_rm/the_implementation_of_standard_i_o form-strings}@anchor{293}@anchor{gnat_rm/the_implementation_of_standard_i_o id3}@anchor{294} @section FORM Strings @@ -21060,7 +21132,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{293}@anchor{gnat_rm/the_implementation_of_standard_i_o id4}@anchor{294} +@anchor{gnat_rm/the_implementation_of_standard_i_o direct-io}@anchor{295}@anchor{gnat_rm/the_implementation_of_standard_i_o id4}@anchor{296} @section Direct_IO @@ -21080,7 +21152,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{295}@anchor{gnat_rm/the_implementation_of_standard_i_o id5}@anchor{296} +@anchor{gnat_rm/the_implementation_of_standard_i_o sequential-io}@anchor{297}@anchor{gnat_rm/the_implementation_of_standard_i_o id5}@anchor{298} @section Sequential_IO @@ -21127,7 +21199,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{297}@anchor{gnat_rm/the_implementation_of_standard_i_o text-io}@anchor{298} +@anchor{gnat_rm/the_implementation_of_standard_i_o id6}@anchor{299}@anchor{gnat_rm/the_implementation_of_standard_i_o text-io}@anchor{29a} @section Text_IO @@ -21210,7 +21282,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{299}@anchor{gnat_rm/the_implementation_of_standard_i_o stream-pointer-positioning}@anchor{29a} +@anchor{gnat_rm/the_implementation_of_standard_i_o id7}@anchor{29b}@anchor{gnat_rm/the_implementation_of_standard_i_o stream-pointer-positioning}@anchor{29c} @subsection Stream Pointer Positioning @@ -21246,7 +21318,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{29b}@anchor{gnat_rm/the_implementation_of_standard_i_o id8}@anchor{29c} +@anchor{gnat_rm/the_implementation_of_standard_i_o reading-and-writing-non-regular-files}@anchor{29d}@anchor{gnat_rm/the_implementation_of_standard_i_o id8}@anchor{29e} @subsection Reading and Writing Non-Regular Files @@ -21297,7 +21369,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{29d}@anchor{gnat_rm/the_implementation_of_standard_i_o id9}@anchor{29e} +@anchor{gnat_rm/the_implementation_of_standard_i_o get-immediate}@anchor{29f}@anchor{gnat_rm/the_implementation_of_standard_i_o id9}@anchor{2a0} @subsection Get_Immediate @@ -21315,7 +21387,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{29f}@anchor{gnat_rm/the_implementation_of_standard_i_o treating-text-io-files-as-streams}@anchor{2a0} +@anchor{gnat_rm/the_implementation_of_standard_i_o id10}@anchor{2a1}@anchor{gnat_rm/the_implementation_of_standard_i_o treating-text-io-files-as-streams}@anchor{2a2} @subsection Treating Text_IO Files as Streams @@ -21331,7 +21403,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{2a1}@anchor{gnat_rm/the_implementation_of_standard_i_o text-io-extensions}@anchor{2a2} +@anchor{gnat_rm/the_implementation_of_standard_i_o id11}@anchor{2a3}@anchor{gnat_rm/the_implementation_of_standard_i_o text-io-extensions}@anchor{2a4} @subsection Text_IO Extensions @@ -21359,7 +21431,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{2a3}@anchor{gnat_rm/the_implementation_of_standard_i_o id12}@anchor{2a4} +@anchor{gnat_rm/the_implementation_of_standard_i_o text-io-facilities-for-unbounded-strings}@anchor{2a5}@anchor{gnat_rm/the_implementation_of_standard_i_o id12}@anchor{2a6} @subsection Text_IO Facilities for Unbounded Strings @@ -21407,7 +21479,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{2a5}@anchor{gnat_rm/the_implementation_of_standard_i_o id13}@anchor{2a6} +@anchor{gnat_rm/the_implementation_of_standard_i_o wide-text-io}@anchor{2a7}@anchor{gnat_rm/the_implementation_of_standard_i_o id13}@anchor{2a8} @section Wide_Text_IO @@ -21654,12 +21726,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{2a7}@anchor{gnat_rm/the_implementation_of_standard_i_o id14}@anchor{2a8} +@anchor{gnat_rm/the_implementation_of_standard_i_o stream-pointer-positioning-1}@anchor{2a9}@anchor{gnat_rm/the_implementation_of_standard_i_o id14}@anchor{2aa} @subsection Stream Pointer Positioning @cite{Ada.Wide_Text_IO} is similar to @cite{Ada.Text_IO} in its handling -of stream pointer positioning (@ref{298,,Text_IO}). There is one additional +of stream pointer positioning (@ref{29a,,Text_IO}). There is one additional case: If @cite{Ada.Wide_Text_IO.Look_Ahead} reads a character outside the @@ -21678,7 +21750,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{2a9}@anchor{gnat_rm/the_implementation_of_standard_i_o id15}@anchor{2aa} +@anchor{gnat_rm/the_implementation_of_standard_i_o reading-and-writing-non-regular-files-1}@anchor{2ab}@anchor{gnat_rm/the_implementation_of_standard_i_o id15}@anchor{2ac} @subsection Reading and Writing Non-Regular Files @@ -21689,7 +21761,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{2ab}@anchor{gnat_rm/the_implementation_of_standard_i_o wide-wide-text-io}@anchor{2ac} +@anchor{gnat_rm/the_implementation_of_standard_i_o id16}@anchor{2ad}@anchor{gnat_rm/the_implementation_of_standard_i_o wide-wide-text-io}@anchor{2ae} @section Wide_Wide_Text_IO @@ -21858,12 +21930,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{2ad}@anchor{gnat_rm/the_implementation_of_standard_i_o id17}@anchor{2ae} +@anchor{gnat_rm/the_implementation_of_standard_i_o stream-pointer-positioning-2}@anchor{2af}@anchor{gnat_rm/the_implementation_of_standard_i_o id17}@anchor{2b0} @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{298,,Text_IO}). There is one additional +of stream pointer positioning (@ref{29a,,Text_IO}). There is one additional case: If @cite{Ada.Wide_Wide_Text_IO.Look_Ahead} reads a character outside the @@ -21882,7 +21954,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{2af}@anchor{gnat_rm/the_implementation_of_standard_i_o reading-and-writing-non-regular-files-2}@anchor{2b0} +@anchor{gnat_rm/the_implementation_of_standard_i_o id18}@anchor{2b1}@anchor{gnat_rm/the_implementation_of_standard_i_o reading-and-writing-non-regular-files-2}@anchor{2b2} @subsection Reading and Writing Non-Regular Files @@ -21893,7 +21965,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{2b1}@anchor{gnat_rm/the_implementation_of_standard_i_o stream-io}@anchor{2b2} +@anchor{gnat_rm/the_implementation_of_standard_i_o id19}@anchor{2b3}@anchor{gnat_rm/the_implementation_of_standard_i_o stream-io}@anchor{2b4} @section Stream_IO @@ -21915,7 +21987,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{2b3}@anchor{gnat_rm/the_implementation_of_standard_i_o text-translation}@anchor{2b4} +@anchor{gnat_rm/the_implementation_of_standard_i_o id20}@anchor{2b5}@anchor{gnat_rm/the_implementation_of_standard_i_o text-translation}@anchor{2b6} @section Text Translation @@ -21949,7 +22021,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{2b5}@anchor{gnat_rm/the_implementation_of_standard_i_o shared-files}@anchor{2b6} +@anchor{gnat_rm/the_implementation_of_standard_i_o id21}@anchor{2b7}@anchor{gnat_rm/the_implementation_of_standard_i_o shared-files}@anchor{2b8} @section Shared Files @@ -22012,7 +22084,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{2b7}@anchor{gnat_rm/the_implementation_of_standard_i_o id22}@anchor{2b8} +@anchor{gnat_rm/the_implementation_of_standard_i_o filenames-encoding}@anchor{2b9}@anchor{gnat_rm/the_implementation_of_standard_i_o id22}@anchor{2ba} @section Filenames encoding @@ -22052,7 +22124,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{2b9}@anchor{gnat_rm/the_implementation_of_standard_i_o id23}@anchor{2ba} +@anchor{gnat_rm/the_implementation_of_standard_i_o file-content-encoding}@anchor{2bb}@anchor{gnat_rm/the_implementation_of_standard_i_o id23}@anchor{2bc} @section File content encoding @@ -22085,7 +22157,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{2bb}@anchor{gnat_rm/the_implementation_of_standard_i_o id24}@anchor{2bc} +@anchor{gnat_rm/the_implementation_of_standard_i_o open-modes}@anchor{2bd}@anchor{gnat_rm/the_implementation_of_standard_i_o id24}@anchor{2be} @section Open Modes @@ -22188,7 +22260,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{2bd}@anchor{gnat_rm/the_implementation_of_standard_i_o id25}@anchor{2be} +@anchor{gnat_rm/the_implementation_of_standard_i_o operations-on-c-streams}@anchor{2bf}@anchor{gnat_rm/the_implementation_of_standard_i_o id25}@anchor{2c0} @section Operations on C Streams @@ -22348,7 +22420,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{2bf}@anchor{gnat_rm/the_implementation_of_standard_i_o id26}@anchor{2c0} +@anchor{gnat_rm/the_implementation_of_standard_i_o interfacing-to-c-streams}@anchor{2c1}@anchor{gnat_rm/the_implementation_of_standard_i_o id26}@anchor{2c2} @section Interfacing to C Streams @@ -22441,7 +22513,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{2c1}@anchor{gnat_rm/the_gnat_library id1}@anchor{2c2} +@anchor{gnat_rm/the_gnat_library the-gnat-library}@anchor{10}@anchor{gnat_rm/the_gnat_library doc}@anchor{2c3}@anchor{gnat_rm/the_gnat_library id1}@anchor{2c4} @chapter The GNAT Library @@ -22630,7 +22702,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{2c3}@anchor{gnat_rm/the_gnat_library ada-characters-latin-9-a-chlat9-ads}@anchor{2c4} +@anchor{gnat_rm/the_gnat_library id2}@anchor{2c5}@anchor{gnat_rm/the_gnat_library ada-characters-latin-9-a-chlat9-ads}@anchor{2c6} @section @cite{Ada.Characters.Latin_9} (@code{a-chlat9.ads}) @@ -22647,7 +22719,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{2c5}@anchor{gnat_rm/the_gnat_library id3}@anchor{2c6} +@anchor{gnat_rm/the_gnat_library ada-characters-wide-latin-1-a-cwila1-ads}@anchor{2c7}@anchor{gnat_rm/the_gnat_library id3}@anchor{2c8} @section @cite{Ada.Characters.Wide_Latin_1} (@code{a-cwila1.ads}) @@ -22664,7 +22736,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{2c7}@anchor{gnat_rm/the_gnat_library ada-characters-wide-latin-9-a-cwila1-ads}@anchor{2c8} +@anchor{gnat_rm/the_gnat_library id4}@anchor{2c9}@anchor{gnat_rm/the_gnat_library ada-characters-wide-latin-9-a-cwila1-ads}@anchor{2ca} @section @cite{Ada.Characters.Wide_Latin_9} (@code{a-cwila1.ads}) @@ -22681,7 +22753,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{2c9}@anchor{gnat_rm/the_gnat_library id5}@anchor{2ca} +@anchor{gnat_rm/the_gnat_library ada-characters-wide-wide-latin-1-a-chzla1-ads}@anchor{2cb}@anchor{gnat_rm/the_gnat_library id5}@anchor{2cc} @section @cite{Ada.Characters.Wide_Wide_Latin_1} (@code{a-chzla1.ads}) @@ -22698,7 +22770,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{2cb}@anchor{gnat_rm/the_gnat_library id6}@anchor{2cc} +@anchor{gnat_rm/the_gnat_library ada-characters-wide-wide-latin-9-a-chzla9-ads}@anchor{2cd}@anchor{gnat_rm/the_gnat_library id6}@anchor{2ce} @section @cite{Ada.Characters.Wide_Wide_Latin_9} (@code{a-chzla9.ads}) @@ -22715,7 +22787,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{2cd}@anchor{gnat_rm/the_gnat_library ada-containers-formal-doubly-linked-lists-a-cfdlli-ads}@anchor{2ce} +@anchor{gnat_rm/the_gnat_library id7}@anchor{2cf}@anchor{gnat_rm/the_gnat_library ada-containers-formal-doubly-linked-lists-a-cfdlli-ads}@anchor{2d0} @section @cite{Ada.Containers.Formal_Doubly_Linked_Lists} (@code{a-cfdlli.ads}) @@ -22734,7 +22806,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{2cf}@anchor{gnat_rm/the_gnat_library ada-containers-formal-hashed-maps-a-cfhama-ads}@anchor{2d0} +@anchor{gnat_rm/the_gnat_library id8}@anchor{2d1}@anchor{gnat_rm/the_gnat_library ada-containers-formal-hashed-maps-a-cfhama-ads}@anchor{2d2} @section @cite{Ada.Containers.Formal_Hashed_Maps} (@code{a-cfhama.ads}) @@ -22753,7 +22825,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{2d1}@anchor{gnat_rm/the_gnat_library ada-containers-formal-hashed-sets-a-cfhase-ads}@anchor{2d2} +@anchor{gnat_rm/the_gnat_library id9}@anchor{2d3}@anchor{gnat_rm/the_gnat_library ada-containers-formal-hashed-sets-a-cfhase-ads}@anchor{2d4} @section @cite{Ada.Containers.Formal_Hashed_Sets} (@code{a-cfhase.ads}) @@ -22772,7 +22844,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{2d3}@anchor{gnat_rm/the_gnat_library ada-containers-formal-ordered-maps-a-cforma-ads}@anchor{2d4} +@anchor{gnat_rm/the_gnat_library id10}@anchor{2d5}@anchor{gnat_rm/the_gnat_library ada-containers-formal-ordered-maps-a-cforma-ads}@anchor{2d6} @section @cite{Ada.Containers.Formal_Ordered_Maps} (@code{a-cforma.ads}) @@ -22791,7 +22863,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{2d5}@anchor{gnat_rm/the_gnat_library id11}@anchor{2d6} +@anchor{gnat_rm/the_gnat_library ada-containers-formal-ordered-sets-a-cforse-ads}@anchor{2d7}@anchor{gnat_rm/the_gnat_library id11}@anchor{2d8} @section @cite{Ada.Containers.Formal_Ordered_Sets} (@code{a-cforse.ads}) @@ -22810,7 +22882,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{2d7}@anchor{gnat_rm/the_gnat_library ada-containers-formal-vectors-a-cofove-ads}@anchor{2d8} +@anchor{gnat_rm/the_gnat_library id12}@anchor{2d9}@anchor{gnat_rm/the_gnat_library ada-containers-formal-vectors-a-cofove-ads}@anchor{2da} @section @cite{Ada.Containers.Formal_Vectors} (@code{a-cofove.ads}) @@ -22829,7 +22901,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{2d9}@anchor{gnat_rm/the_gnat_library ada-containers-formal-indefinite-vectors-a-cfinve-ads}@anchor{2da} +@anchor{gnat_rm/the_gnat_library id13}@anchor{2db}@anchor{gnat_rm/the_gnat_library ada-containers-formal-indefinite-vectors-a-cfinve-ads}@anchor{2dc} @section @cite{Ada.Containers.Formal_Indefinite_Vectors} (@code{a-cfinve.ads}) @@ -22848,7 +22920,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{2db}@anchor{gnat_rm/the_gnat_library ada-containers-bounded-holders-a-coboho-ads}@anchor{2dc} +@anchor{gnat_rm/the_gnat_library id14}@anchor{2dd}@anchor{gnat_rm/the_gnat_library ada-containers-bounded-holders-a-coboho-ads}@anchor{2de} @section @cite{Ada.Containers.Bounded_Holders} (@code{a-coboho.ads}) @@ -22860,7 +22932,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{2dd}@anchor{gnat_rm/the_gnat_library id15}@anchor{2de} +@anchor{gnat_rm/the_gnat_library ada-command-line-environment-a-colien-ads}@anchor{2df}@anchor{gnat_rm/the_gnat_library id15}@anchor{2e0} @section @cite{Ada.Command_Line.Environment} (@code{a-colien.ads}) @@ -22873,7 +22945,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{2df}@anchor{gnat_rm/the_gnat_library ada-command-line-remove-a-colire-ads}@anchor{2e0} +@anchor{gnat_rm/the_gnat_library id16}@anchor{2e1}@anchor{gnat_rm/the_gnat_library ada-command-line-remove-a-colire-ads}@anchor{2e2} @section @cite{Ada.Command_Line.Remove} (@code{a-colire.ads}) @@ -22891,7 +22963,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{2e1}@anchor{gnat_rm/the_gnat_library id17}@anchor{2e2} +@anchor{gnat_rm/the_gnat_library ada-command-line-response-file-a-clrefi-ads}@anchor{2e3}@anchor{gnat_rm/the_gnat_library id17}@anchor{2e4} @section @cite{Ada.Command_Line.Response_File} (@code{a-clrefi.ads}) @@ -22911,7 +22983,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{2e3}@anchor{gnat_rm/the_gnat_library ada-direct-io-c-streams-a-diocst-ads}@anchor{2e4} +@anchor{gnat_rm/the_gnat_library id18}@anchor{2e5}@anchor{gnat_rm/the_gnat_library ada-direct-io-c-streams-a-diocst-ads}@anchor{2e6} @section @cite{Ada.Direct_IO.C_Streams} (@code{a-diocst.ads}) @@ -22926,7 +22998,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{2e5}@anchor{gnat_rm/the_gnat_library ada-exceptions-is-null-occurrence-a-einuoc-ads}@anchor{2e6} +@anchor{gnat_rm/the_gnat_library id19}@anchor{2e7}@anchor{gnat_rm/the_gnat_library ada-exceptions-is-null-occurrence-a-einuoc-ads}@anchor{2e8} @section @cite{Ada.Exceptions.Is_Null_Occurrence} (@code{a-einuoc.ads}) @@ -22940,7 +23012,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{2e7}@anchor{gnat_rm/the_gnat_library ada-exceptions-last-chance-handler-a-elchha-ads}@anchor{2e8} +@anchor{gnat_rm/the_gnat_library id20}@anchor{2e9}@anchor{gnat_rm/the_gnat_library ada-exceptions-last-chance-handler-a-elchha-ads}@anchor{2ea} @section @cite{Ada.Exceptions.Last_Chance_Handler} (@code{a-elchha.ads}) @@ -22954,7 +23026,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{2e9}@anchor{gnat_rm/the_gnat_library id21}@anchor{2ea} +@anchor{gnat_rm/the_gnat_library ada-exceptions-traceback-a-exctra-ads}@anchor{2eb}@anchor{gnat_rm/the_gnat_library id21}@anchor{2ec} @section @cite{Ada.Exceptions.Traceback} (@code{a-exctra.ads}) @@ -22967,7 +23039,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{2eb}@anchor{gnat_rm/the_gnat_library id22}@anchor{2ec} +@anchor{gnat_rm/the_gnat_library ada-sequential-io-c-streams-a-siocst-ads}@anchor{2ed}@anchor{gnat_rm/the_gnat_library id22}@anchor{2ee} @section @cite{Ada.Sequential_IO.C_Streams} (@code{a-siocst.ads}) @@ -22982,7 +23054,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{2ed}@anchor{gnat_rm/the_gnat_library ada-streams-stream-io-c-streams-a-ssicst-ads}@anchor{2ee} +@anchor{gnat_rm/the_gnat_library id23}@anchor{2ef}@anchor{gnat_rm/the_gnat_library ada-streams-stream-io-c-streams-a-ssicst-ads}@anchor{2f0} @section @cite{Ada.Streams.Stream_IO.C_Streams} (@code{a-ssicst.ads}) @@ -22997,7 +23069,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{2ef}@anchor{gnat_rm/the_gnat_library id24}@anchor{2f0} +@anchor{gnat_rm/the_gnat_library ada-strings-unbounded-text-io-a-suteio-ads}@anchor{2f1}@anchor{gnat_rm/the_gnat_library id24}@anchor{2f2} @section @cite{Ada.Strings.Unbounded.Text_IO} (@code{a-suteio.ads}) @@ -23014,7 +23086,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{2f1}@anchor{gnat_rm/the_gnat_library ada-strings-wide-unbounded-wide-text-io-a-swuwti-ads}@anchor{2f2} +@anchor{gnat_rm/the_gnat_library id25}@anchor{2f3}@anchor{gnat_rm/the_gnat_library ada-strings-wide-unbounded-wide-text-io-a-swuwti-ads}@anchor{2f4} @section @cite{Ada.Strings.Wide_Unbounded.Wide_Text_IO} (@code{a-swuwti.ads}) @@ -23031,7 +23103,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{2f3}@anchor{gnat_rm/the_gnat_library id26}@anchor{2f4} +@anchor{gnat_rm/the_gnat_library ada-strings-wide-wide-unbounded-wide-wide-text-io-a-szuzti-ads}@anchor{2f5}@anchor{gnat_rm/the_gnat_library id26}@anchor{2f6} @section @cite{Ada.Strings.Wide_Wide_Unbounded.Wide_Wide_Text_IO} (@code{a-szuzti.ads}) @@ -23048,7 +23120,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{2f5}@anchor{gnat_rm/the_gnat_library id27}@anchor{2f6} +@anchor{gnat_rm/the_gnat_library ada-text-io-c-streams-a-tiocst-ads}@anchor{2f7}@anchor{gnat_rm/the_gnat_library id27}@anchor{2f8} @section @cite{Ada.Text_IO.C_Streams} (@code{a-tiocst.ads}) @@ -23063,7 +23135,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{2f7}@anchor{gnat_rm/the_gnat_library ada-text-io-reset-standard-files-a-tirsfi-ads}@anchor{2f8} +@anchor{gnat_rm/the_gnat_library id28}@anchor{2f9}@anchor{gnat_rm/the_gnat_library ada-text-io-reset-standard-files-a-tirsfi-ads}@anchor{2fa} @section @cite{Ada.Text_IO.Reset_Standard_Files} (@code{a-tirsfi.ads}) @@ -23078,7 +23150,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{2f9}@anchor{gnat_rm/the_gnat_library ada-wide-characters-unicode-a-wichun-ads}@anchor{2fa} +@anchor{gnat_rm/the_gnat_library id29}@anchor{2fb}@anchor{gnat_rm/the_gnat_library ada-wide-characters-unicode-a-wichun-ads}@anchor{2fc} @section @cite{Ada.Wide_Characters.Unicode} (@code{a-wichun.ads}) @@ -23091,7 +23163,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{2fb}@anchor{gnat_rm/the_gnat_library id30}@anchor{2fc} +@anchor{gnat_rm/the_gnat_library ada-wide-text-io-c-streams-a-wtcstr-ads}@anchor{2fd}@anchor{gnat_rm/the_gnat_library id30}@anchor{2fe} @section @cite{Ada.Wide_Text_IO.C_Streams} (@code{a-wtcstr.ads}) @@ -23106,7 +23178,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{2fd}@anchor{gnat_rm/the_gnat_library id31}@anchor{2fe} +@anchor{gnat_rm/the_gnat_library ada-wide-text-io-reset-standard-files-a-wrstfi-ads}@anchor{2ff}@anchor{gnat_rm/the_gnat_library id31}@anchor{300} @section @cite{Ada.Wide_Text_IO.Reset_Standard_Files} (@code{a-wrstfi.ads}) @@ -23121,7 +23193,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{2ff}@anchor{gnat_rm/the_gnat_library ada-wide-wide-characters-unicode-a-zchuni-ads}@anchor{300} +@anchor{gnat_rm/the_gnat_library id32}@anchor{301}@anchor{gnat_rm/the_gnat_library ada-wide-wide-characters-unicode-a-zchuni-ads}@anchor{302} @section @cite{Ada.Wide_Wide_Characters.Unicode} (@code{a-zchuni.ads}) @@ -23134,7 +23206,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{301}@anchor{gnat_rm/the_gnat_library ada-wide-wide-text-io-c-streams-a-ztcstr-ads}@anchor{302} +@anchor{gnat_rm/the_gnat_library id33}@anchor{303}@anchor{gnat_rm/the_gnat_library ada-wide-wide-text-io-c-streams-a-ztcstr-ads}@anchor{304} @section @cite{Ada.Wide_Wide_Text_IO.C_Streams} (@code{a-ztcstr.ads}) @@ -23149,7 +23221,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{303}@anchor{gnat_rm/the_gnat_library ada-wide-wide-text-io-reset-standard-files-a-zrstfi-ads}@anchor{304} +@anchor{gnat_rm/the_gnat_library id34}@anchor{305}@anchor{gnat_rm/the_gnat_library ada-wide-wide-text-io-reset-standard-files-a-zrstfi-ads}@anchor{306} @section @cite{Ada.Wide_Wide_Text_IO.Reset_Standard_Files} (@code{a-zrstfi.ads}) @@ -23164,7 +23236,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{305}@anchor{gnat_rm/the_gnat_library id35}@anchor{306} +@anchor{gnat_rm/the_gnat_library gnat-altivec-g-altive-ads}@anchor{307}@anchor{gnat_rm/the_gnat_library id35}@anchor{308} @section @cite{GNAT.Altivec} (@code{g-altive.ads}) @@ -23177,7 +23249,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{307}@anchor{gnat_rm/the_gnat_library gnat-altivec-conversions-g-altcon-ads}@anchor{308} +@anchor{gnat_rm/the_gnat_library id36}@anchor{309}@anchor{gnat_rm/the_gnat_library gnat-altivec-conversions-g-altcon-ads}@anchor{30a} @section @cite{GNAT.Altivec.Conversions} (@code{g-altcon.ads}) @@ -23188,7 +23260,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{309}@anchor{gnat_rm/the_gnat_library gnat-altivec-vector-operations-g-alveop-ads}@anchor{30a} +@anchor{gnat_rm/the_gnat_library id37}@anchor{30b}@anchor{gnat_rm/the_gnat_library gnat-altivec-vector-operations-g-alveop-ads}@anchor{30c} @section @cite{GNAT.Altivec.Vector_Operations} (@code{g-alveop.ads}) @@ -23202,7 +23274,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{30b}@anchor{gnat_rm/the_gnat_library id38}@anchor{30c} +@anchor{gnat_rm/the_gnat_library gnat-altivec-vector-types-g-alvety-ads}@anchor{30d}@anchor{gnat_rm/the_gnat_library id38}@anchor{30e} @section @cite{GNAT.Altivec.Vector_Types} (@code{g-alvety.ads}) @@ -23214,7 +23286,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{30d}@anchor{gnat_rm/the_gnat_library id39}@anchor{30e} +@anchor{gnat_rm/the_gnat_library gnat-altivec-vector-views-g-alvevi-ads}@anchor{30f}@anchor{gnat_rm/the_gnat_library id39}@anchor{310} @section @cite{GNAT.Altivec.Vector_Views} (@code{g-alvevi.ads}) @@ -23229,7 +23301,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{30f}@anchor{gnat_rm/the_gnat_library id40}@anchor{310} +@anchor{gnat_rm/the_gnat_library gnat-array-split-g-arrspl-ads}@anchor{311}@anchor{gnat_rm/the_gnat_library id40}@anchor{312} @section @cite{GNAT.Array_Split} (@code{g-arrspl.ads}) @@ -23242,7 +23314,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{311}@anchor{gnat_rm/the_gnat_library gnat-awk-g-awk-ads}@anchor{312} +@anchor{gnat_rm/the_gnat_library id41}@anchor{313}@anchor{gnat_rm/the_gnat_library gnat-awk-g-awk-ads}@anchor{314} @section @cite{GNAT.AWK} (@code{g-awk.ads}) @@ -23257,7 +23329,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{313}@anchor{gnat_rm/the_gnat_library id42}@anchor{314} +@anchor{gnat_rm/the_gnat_library gnat-bind-environment-g-binenv-ads}@anchor{315}@anchor{gnat_rm/the_gnat_library id42}@anchor{316} @section @cite{GNAT.Bind_Environment} (@code{g-binenv.ads}) @@ -23270,7 +23342,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{315}@anchor{gnat_rm/the_gnat_library id43}@anchor{316} +@anchor{gnat_rm/the_gnat_library gnat-bounded-buffers-g-boubuf-ads}@anchor{317}@anchor{gnat_rm/the_gnat_library id43}@anchor{318} @section @cite{GNAT.Bounded_Buffers} (@code{g-boubuf.ads}) @@ -23285,7 +23357,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{317}@anchor{gnat_rm/the_gnat_library gnat-bounded-mailboxes-g-boumai-ads}@anchor{318} +@anchor{gnat_rm/the_gnat_library id44}@anchor{319}@anchor{gnat_rm/the_gnat_library gnat-bounded-mailboxes-g-boumai-ads}@anchor{31a} @section @cite{GNAT.Bounded_Mailboxes} (@code{g-boumai.ads}) @@ -23298,7 +23370,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{319}@anchor{gnat_rm/the_gnat_library id45}@anchor{31a} +@anchor{gnat_rm/the_gnat_library gnat-bubble-sort-g-bubsor-ads}@anchor{31b}@anchor{gnat_rm/the_gnat_library id45}@anchor{31c} @section @cite{GNAT.Bubble_Sort} (@code{g-bubsor.ads}) @@ -23313,7 +23385,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{31b}@anchor{gnat_rm/the_gnat_library gnat-bubble-sort-a-g-busora-ads}@anchor{31c} +@anchor{gnat_rm/the_gnat_library id46}@anchor{31d}@anchor{gnat_rm/the_gnat_library gnat-bubble-sort-a-g-busora-ads}@anchor{31e} @section @cite{GNAT.Bubble_Sort_A} (@code{g-busora.ads}) @@ -23329,7 +23401,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{31d}@anchor{gnat_rm/the_gnat_library gnat-bubble-sort-g-g-busorg-ads}@anchor{31e} +@anchor{gnat_rm/the_gnat_library id47}@anchor{31f}@anchor{gnat_rm/the_gnat_library gnat-bubble-sort-g-g-busorg-ads}@anchor{320} @section @cite{GNAT.Bubble_Sort_G} (@code{g-busorg.ads}) @@ -23345,7 +23417,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{31f}@anchor{gnat_rm/the_gnat_library id48}@anchor{320} +@anchor{gnat_rm/the_gnat_library gnat-byte-order-mark-g-byorma-ads}@anchor{321}@anchor{gnat_rm/the_gnat_library id48}@anchor{322} @section @cite{GNAT.Byte_Order_Mark} (@code{g-byorma.ads}) @@ -23361,7 +23433,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{321}@anchor{gnat_rm/the_gnat_library id49}@anchor{322} +@anchor{gnat_rm/the_gnat_library gnat-byte-swapping-g-bytswa-ads}@anchor{323}@anchor{gnat_rm/the_gnat_library id49}@anchor{324} @section @cite{GNAT.Byte_Swapping} (@code{g-bytswa.ads}) @@ -23375,7 +23447,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{323}@anchor{gnat_rm/the_gnat_library gnat-calendar-g-calend-ads}@anchor{324} +@anchor{gnat_rm/the_gnat_library id50}@anchor{325}@anchor{gnat_rm/the_gnat_library gnat-calendar-g-calend-ads}@anchor{326} @section @cite{GNAT.Calendar} (@code{g-calend.ads}) @@ -23389,7 +23461,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{325}@anchor{gnat_rm/the_gnat_library id51}@anchor{326} +@anchor{gnat_rm/the_gnat_library gnat-calendar-time-io-g-catiio-ads}@anchor{327}@anchor{gnat_rm/the_gnat_library id51}@anchor{328} @section @cite{GNAT.Calendar.Time_IO} (@code{g-catiio.ads}) @@ -23400,7 +23472,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{327}@anchor{gnat_rm/the_gnat_library gnat-crc32-g-crc32-ads}@anchor{328} +@anchor{gnat_rm/the_gnat_library id52}@anchor{329}@anchor{gnat_rm/the_gnat_library gnat-crc32-g-crc32-ads}@anchor{32a} @section @cite{GNAT.CRC32} (@code{g-crc32.ads}) @@ -23417,7 +23489,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{329}@anchor{gnat_rm/the_gnat_library id53}@anchor{32a} +@anchor{gnat_rm/the_gnat_library gnat-case-util-g-casuti-ads}@anchor{32b}@anchor{gnat_rm/the_gnat_library id53}@anchor{32c} @section @cite{GNAT.Case_Util} (@code{g-casuti.ads}) @@ -23432,7 +23504,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{32b}@anchor{gnat_rm/the_gnat_library gnat-cgi-g-cgi-ads}@anchor{32c} +@anchor{gnat_rm/the_gnat_library id54}@anchor{32d}@anchor{gnat_rm/the_gnat_library gnat-cgi-g-cgi-ads}@anchor{32e} @section @cite{GNAT.CGI} (@code{g-cgi.ads}) @@ -23447,7 +23519,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{32d}@anchor{gnat_rm/the_gnat_library id55}@anchor{32e} +@anchor{gnat_rm/the_gnat_library gnat-cgi-cookie-g-cgicoo-ads}@anchor{32f}@anchor{gnat_rm/the_gnat_library id55}@anchor{330} @section @cite{GNAT.CGI.Cookie} (@code{g-cgicoo.ads}) @@ -23462,7 +23534,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{32f}@anchor{gnat_rm/the_gnat_library id56}@anchor{330} +@anchor{gnat_rm/the_gnat_library gnat-cgi-debug-g-cgideb-ads}@anchor{331}@anchor{gnat_rm/the_gnat_library id56}@anchor{332} @section @cite{GNAT.CGI.Debug} (@code{g-cgideb.ads}) @@ -23474,7 +23546,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{331}@anchor{gnat_rm/the_gnat_library gnat-command-line-g-comlin-ads}@anchor{332} +@anchor{gnat_rm/the_gnat_library id57}@anchor{333}@anchor{gnat_rm/the_gnat_library gnat-command-line-g-comlin-ads}@anchor{334} @section @cite{GNAT.Command_Line} (@code{g-comlin.ads}) @@ -23487,7 +23559,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{333}@anchor{gnat_rm/the_gnat_library id58}@anchor{334} +@anchor{gnat_rm/the_gnat_library gnat-compiler-version-g-comver-ads}@anchor{335}@anchor{gnat_rm/the_gnat_library id58}@anchor{336} @section @cite{GNAT.Compiler_Version} (@code{g-comver.ads}) @@ -23505,7 +23577,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{335}@anchor{gnat_rm/the_gnat_library id59}@anchor{336} +@anchor{gnat_rm/the_gnat_library gnat-ctrl-c-g-ctrl-c-ads}@anchor{337}@anchor{gnat_rm/the_gnat_library id59}@anchor{338} @section @cite{GNAT.Ctrl_C} (@code{g-ctrl_c.ads}) @@ -23516,7 +23588,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{337}@anchor{gnat_rm/the_gnat_library gnat-current-exception-g-curexc-ads}@anchor{338} +@anchor{gnat_rm/the_gnat_library id60}@anchor{339}@anchor{gnat_rm/the_gnat_library gnat-current-exception-g-curexc-ads}@anchor{33a} @section @cite{GNAT.Current_Exception} (@code{g-curexc.ads}) @@ -23533,7 +23605,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{339}@anchor{gnat_rm/the_gnat_library id61}@anchor{33a} +@anchor{gnat_rm/the_gnat_library gnat-debug-pools-g-debpoo-ads}@anchor{33b}@anchor{gnat_rm/the_gnat_library id61}@anchor{33c} @section @cite{GNAT.Debug_Pools} (@code{g-debpoo.ads}) @@ -23550,7 +23622,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{33b}@anchor{gnat_rm/the_gnat_library id62}@anchor{33c} +@anchor{gnat_rm/the_gnat_library gnat-debug-utilities-g-debuti-ads}@anchor{33d}@anchor{gnat_rm/the_gnat_library id62}@anchor{33e} @section @cite{GNAT.Debug_Utilities} (@code{g-debuti.ads}) @@ -23563,7 +23635,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{33d}@anchor{gnat_rm/the_gnat_library id63}@anchor{33e} +@anchor{gnat_rm/the_gnat_library gnat-decode-string-g-decstr-ads}@anchor{33f}@anchor{gnat_rm/the_gnat_library id63}@anchor{340} @section @cite{GNAT.Decode_String} (@code{g-decstr.ads}) @@ -23587,7 +23659,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{33f}@anchor{gnat_rm/the_gnat_library id64}@anchor{340} +@anchor{gnat_rm/the_gnat_library gnat-decode-utf8-string-g-deutst-ads}@anchor{341}@anchor{gnat_rm/the_gnat_library id64}@anchor{342} @section @cite{GNAT.Decode_UTF8_String} (@code{g-deutst.ads}) @@ -23608,7 +23680,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{341}@anchor{gnat_rm/the_gnat_library gnat-directory-operations-g-dirope-ads}@anchor{342} +@anchor{gnat_rm/the_gnat_library id65}@anchor{343}@anchor{gnat_rm/the_gnat_library gnat-directory-operations-g-dirope-ads}@anchor{344} @section @cite{GNAT.Directory_Operations} (@code{g-dirope.ads}) @@ -23621,7 +23693,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{343}@anchor{gnat_rm/the_gnat_library gnat-directory-operations-iteration-g-diopit-ads}@anchor{344} +@anchor{gnat_rm/the_gnat_library id66}@anchor{345}@anchor{gnat_rm/the_gnat_library gnat-directory-operations-iteration-g-diopit-ads}@anchor{346} @section @cite{GNAT.Directory_Operations.Iteration} (@code{g-diopit.ads}) @@ -23633,7 +23705,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{345}@anchor{gnat_rm/the_gnat_library gnat-dynamic-htables-g-dynhta-ads}@anchor{346} +@anchor{gnat_rm/the_gnat_library id67}@anchor{347}@anchor{gnat_rm/the_gnat_library gnat-dynamic-htables-g-dynhta-ads}@anchor{348} @section @cite{GNAT.Dynamic_HTables} (@code{g-dynhta.ads}) @@ -23651,7 +23723,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{347}@anchor{gnat_rm/the_gnat_library id68}@anchor{348} +@anchor{gnat_rm/the_gnat_library gnat-dynamic-tables-g-dyntab-ads}@anchor{349}@anchor{gnat_rm/the_gnat_library id68}@anchor{34a} @section @cite{GNAT.Dynamic_Tables} (@code{g-dyntab.ads}) @@ -23671,7 +23743,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{349}@anchor{gnat_rm/the_gnat_library gnat-encode-string-g-encstr-ads}@anchor{34a} +@anchor{gnat_rm/the_gnat_library id69}@anchor{34b}@anchor{gnat_rm/the_gnat_library gnat-encode-string-g-encstr-ads}@anchor{34c} @section @cite{GNAT.Encode_String} (@code{g-encstr.ads}) @@ -23693,7 +23765,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{34b}@anchor{gnat_rm/the_gnat_library id70}@anchor{34c} +@anchor{gnat_rm/the_gnat_library gnat-encode-utf8-string-g-enutst-ads}@anchor{34d}@anchor{gnat_rm/the_gnat_library id70}@anchor{34e} @section @cite{GNAT.Encode_UTF8_String} (@code{g-enutst.ads}) @@ -23714,7 +23786,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{34d}@anchor{gnat_rm/the_gnat_library gnat-exception-actions-g-excact-ads}@anchor{34e} +@anchor{gnat_rm/the_gnat_library id71}@anchor{34f}@anchor{gnat_rm/the_gnat_library gnat-exception-actions-g-excact-ads}@anchor{350} @section @cite{GNAT.Exception_Actions} (@code{g-excact.ads}) @@ -23727,7 +23799,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{34f}@anchor{gnat_rm/the_gnat_library gnat-exception-traces-g-exctra-ads}@anchor{350} +@anchor{gnat_rm/the_gnat_library id72}@anchor{351}@anchor{gnat_rm/the_gnat_library gnat-exception-traces-g-exctra-ads}@anchor{352} @section @cite{GNAT.Exception_Traces} (@code{g-exctra.ads}) @@ -23741,7 +23813,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{351}@anchor{gnat_rm/the_gnat_library gnat-exceptions-g-expect-ads}@anchor{352} +@anchor{gnat_rm/the_gnat_library id73}@anchor{353}@anchor{gnat_rm/the_gnat_library gnat-exceptions-g-expect-ads}@anchor{354} @section @cite{GNAT.Exceptions} (@code{g-expect.ads}) @@ -23762,7 +23834,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{353}@anchor{gnat_rm/the_gnat_library id74}@anchor{354} +@anchor{gnat_rm/the_gnat_library gnat-expect-g-expect-ads}@anchor{355}@anchor{gnat_rm/the_gnat_library id74}@anchor{356} @section @cite{GNAT.Expect} (@code{g-expect.ads}) @@ -23778,7 +23850,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{355}@anchor{gnat_rm/the_gnat_library id75}@anchor{356} +@anchor{gnat_rm/the_gnat_library gnat-expect-tty-g-exptty-ads}@anchor{357}@anchor{gnat_rm/the_gnat_library id75}@anchor{358} @section @cite{GNAT.Expect.TTY} (@code{g-exptty.ads}) @@ -23790,7 +23862,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{357}@anchor{gnat_rm/the_gnat_library gnat-float-control-g-flocon-ads}@anchor{358} +@anchor{gnat_rm/the_gnat_library id76}@anchor{359}@anchor{gnat_rm/the_gnat_library gnat-float-control-g-flocon-ads}@anchor{35a} @section @cite{GNAT.Float_Control} (@code{g-flocon.ads}) @@ -23804,7 +23876,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{359}@anchor{gnat_rm/the_gnat_library id77}@anchor{35a} +@anchor{gnat_rm/the_gnat_library gnat-formatted-string-g-forstr-ads}@anchor{35b}@anchor{gnat_rm/the_gnat_library id77}@anchor{35c} @section @cite{GNAT.Formatted_String} (@code{g-forstr.ads}) @@ -23819,7 +23891,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{35b}@anchor{gnat_rm/the_gnat_library id78}@anchor{35c} +@anchor{gnat_rm/the_gnat_library gnat-heap-sort-g-heasor-ads}@anchor{35d}@anchor{gnat_rm/the_gnat_library id78}@anchor{35e} @section @cite{GNAT.Heap_Sort} (@code{g-heasor.ads}) @@ -23833,7 +23905,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{35d}@anchor{gnat_rm/the_gnat_library gnat-heap-sort-a-g-hesora-ads}@anchor{35e} +@anchor{gnat_rm/the_gnat_library id79}@anchor{35f}@anchor{gnat_rm/the_gnat_library gnat-heap-sort-a-g-hesora-ads}@anchor{360} @section @cite{GNAT.Heap_Sort_A} (@code{g-hesora.ads}) @@ -23849,7 +23921,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{35f}@anchor{gnat_rm/the_gnat_library gnat-heap-sort-g-g-hesorg-ads}@anchor{360} +@anchor{gnat_rm/the_gnat_library id80}@anchor{361}@anchor{gnat_rm/the_gnat_library gnat-heap-sort-g-g-hesorg-ads}@anchor{362} @section @cite{GNAT.Heap_Sort_G} (@code{g-hesorg.ads}) @@ -23863,7 +23935,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{361}@anchor{gnat_rm/the_gnat_library gnat-htable-g-htable-ads}@anchor{362} +@anchor{gnat_rm/the_gnat_library id81}@anchor{363}@anchor{gnat_rm/the_gnat_library gnat-htable-g-htable-ads}@anchor{364} @section @cite{GNAT.HTable} (@code{g-htable.ads}) @@ -23876,7 +23948,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{363}@anchor{gnat_rm/the_gnat_library gnat-io-g-io-ads}@anchor{364} +@anchor{gnat_rm/the_gnat_library id82}@anchor{365}@anchor{gnat_rm/the_gnat_library gnat-io-g-io-ads}@anchor{366} @section @cite{GNAT.IO} (@code{g-io.ads}) @@ -23892,7 +23964,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{365}@anchor{gnat_rm/the_gnat_library gnat-io-aux-g-io-aux-ads}@anchor{366} +@anchor{gnat_rm/the_gnat_library id83}@anchor{367}@anchor{gnat_rm/the_gnat_library gnat-io-aux-g-io-aux-ads}@anchor{368} @section @cite{GNAT.IO_Aux} (@code{g-io_aux.ads}) @@ -23906,7 +23978,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{367}@anchor{gnat_rm/the_gnat_library id84}@anchor{368} +@anchor{gnat_rm/the_gnat_library gnat-lock-files-g-locfil-ads}@anchor{369}@anchor{gnat_rm/the_gnat_library id84}@anchor{36a} @section @cite{GNAT.Lock_Files} (@code{g-locfil.ads}) @@ -23920,7 +23992,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{369}@anchor{gnat_rm/the_gnat_library gnat-mbbs-discrete-random-g-mbdira-ads}@anchor{36a} +@anchor{gnat_rm/the_gnat_library id85}@anchor{36b}@anchor{gnat_rm/the_gnat_library gnat-mbbs-discrete-random-g-mbdira-ads}@anchor{36c} @section @cite{GNAT.MBBS_Discrete_Random} (@code{g-mbdira.ads}) @@ -23932,7 +24004,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{36b}@anchor{gnat_rm/the_gnat_library gnat-mbbs-float-random-g-mbflra-ads}@anchor{36c} +@anchor{gnat_rm/the_gnat_library id86}@anchor{36d}@anchor{gnat_rm/the_gnat_library gnat-mbbs-float-random-g-mbflra-ads}@anchor{36e} @section @cite{GNAT.MBBS_Float_Random} (@code{g-mbflra.ads}) @@ -23944,7 +24016,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{36d}@anchor{gnat_rm/the_gnat_library gnat-md5-g-md5-ads}@anchor{36e} +@anchor{gnat_rm/the_gnat_library id87}@anchor{36f}@anchor{gnat_rm/the_gnat_library gnat-md5-g-md5-ads}@anchor{370} @section @cite{GNAT.MD5} (@code{g-md5.ads}) @@ -23957,7 +24029,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{36f}@anchor{gnat_rm/the_gnat_library gnat-memory-dump-g-memdum-ads}@anchor{370} +@anchor{gnat_rm/the_gnat_library id88}@anchor{371}@anchor{gnat_rm/the_gnat_library gnat-memory-dump-g-memdum-ads}@anchor{372} @section @cite{GNAT.Memory_Dump} (@code{g-memdum.ads}) @@ -23970,7 +24042,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{371}@anchor{gnat_rm/the_gnat_library gnat-most-recent-exception-g-moreex-ads}@anchor{372} +@anchor{gnat_rm/the_gnat_library id89}@anchor{373}@anchor{gnat_rm/the_gnat_library gnat-most-recent-exception-g-moreex-ads}@anchor{374} @section @cite{GNAT.Most_Recent_Exception} (@code{g-moreex.ads}) @@ -23984,7 +24056,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{373}@anchor{gnat_rm/the_gnat_library gnat-os-lib-g-os-lib-ads}@anchor{374} +@anchor{gnat_rm/the_gnat_library id90}@anchor{375}@anchor{gnat_rm/the_gnat_library gnat-os-lib-g-os-lib-ads}@anchor{376} @section @cite{GNAT.OS_Lib} (@code{g-os_lib.ads}) @@ -24000,7 +24072,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{375}@anchor{gnat_rm/the_gnat_library id91}@anchor{376} +@anchor{gnat_rm/the_gnat_library gnat-perfect-hash-generators-g-pehage-ads}@anchor{377}@anchor{gnat_rm/the_gnat_library id91}@anchor{378} @section @cite{GNAT.Perfect_Hash_Generators} (@code{g-pehage.ads}) @@ -24018,7 +24090,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{377}@anchor{gnat_rm/the_gnat_library id92}@anchor{378} +@anchor{gnat_rm/the_gnat_library gnat-random-numbers-g-rannum-ads}@anchor{379}@anchor{gnat_rm/the_gnat_library id92}@anchor{37a} @section @cite{GNAT.Random_Numbers} (@code{g-rannum.ads}) @@ -24030,7 +24102,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{24a}@anchor{gnat_rm/the_gnat_library id93}@anchor{379} +@anchor{gnat_rm/the_gnat_library gnat-regexp-g-regexp-ads}@anchor{24c}@anchor{gnat_rm/the_gnat_library id93}@anchor{37b} @section @cite{GNAT.Regexp} (@code{g-regexp.ads}) @@ -24046,7 +24118,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{37a}@anchor{gnat_rm/the_gnat_library gnat-registry-g-regist-ads}@anchor{37b} +@anchor{gnat_rm/the_gnat_library id94}@anchor{37c}@anchor{gnat_rm/the_gnat_library gnat-registry-g-regist-ads}@anchor{37d} @section @cite{GNAT.Registry} (@code{g-regist.ads}) @@ -24060,7 +24132,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{37c}@anchor{gnat_rm/the_gnat_library id95}@anchor{37d} +@anchor{gnat_rm/the_gnat_library gnat-regpat-g-regpat-ads}@anchor{37e}@anchor{gnat_rm/the_gnat_library id95}@anchor{37f} @section @cite{GNAT.Regpat} (@code{g-regpat.ads}) @@ -24075,7 +24147,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{37e}@anchor{gnat_rm/the_gnat_library gnat-rewrite-data-g-rewdat-ads}@anchor{37f} +@anchor{gnat_rm/the_gnat_library id96}@anchor{380}@anchor{gnat_rm/the_gnat_library gnat-rewrite-data-g-rewdat-ads}@anchor{381} @section @cite{GNAT.Rewrite_Data} (@code{g-rewdat.ads}) @@ -24089,7 +24161,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{380}@anchor{gnat_rm/the_gnat_library id97}@anchor{381} +@anchor{gnat_rm/the_gnat_library gnat-secondary-stack-info-g-sestin-ads}@anchor{382}@anchor{gnat_rm/the_gnat_library id97}@anchor{383} @section @cite{GNAT.Secondary_Stack_Info} (@code{g-sestin.ads}) @@ -24101,7 +24173,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{382}@anchor{gnat_rm/the_gnat_library gnat-semaphores-g-semaph-ads}@anchor{383} +@anchor{gnat_rm/the_gnat_library id98}@anchor{384}@anchor{gnat_rm/the_gnat_library gnat-semaphores-g-semaph-ads}@anchor{385} @section @cite{GNAT.Semaphores} (@code{g-semaph.ads}) @@ -24112,7 +24184,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{384}@anchor{gnat_rm/the_gnat_library id99}@anchor{385} +@anchor{gnat_rm/the_gnat_library gnat-serial-communications-g-sercom-ads}@anchor{386}@anchor{gnat_rm/the_gnat_library id99}@anchor{387} @section @cite{GNAT.Serial_Communications} (@code{g-sercom.ads}) @@ -24124,7 +24196,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{386}@anchor{gnat_rm/the_gnat_library id100}@anchor{387} +@anchor{gnat_rm/the_gnat_library gnat-sha1-g-sha1-ads}@anchor{388}@anchor{gnat_rm/the_gnat_library id100}@anchor{389} @section @cite{GNAT.SHA1} (@code{g-sha1.ads}) @@ -24137,7 +24209,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{388}@anchor{gnat_rm/the_gnat_library gnat-sha224-g-sha224-ads}@anchor{389} +@anchor{gnat_rm/the_gnat_library id101}@anchor{38a}@anchor{gnat_rm/the_gnat_library gnat-sha224-g-sha224-ads}@anchor{38b} @section @cite{GNAT.SHA224} (@code{g-sha224.ads}) @@ -24150,7 +24222,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{38a}@anchor{gnat_rm/the_gnat_library gnat-sha256-g-sha256-ads}@anchor{38b} +@anchor{gnat_rm/the_gnat_library id102}@anchor{38c}@anchor{gnat_rm/the_gnat_library gnat-sha256-g-sha256-ads}@anchor{38d} @section @cite{GNAT.SHA256} (@code{g-sha256.ads}) @@ -24163,7 +24235,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{38c}@anchor{gnat_rm/the_gnat_library gnat-sha384-g-sha384-ads}@anchor{38d} +@anchor{gnat_rm/the_gnat_library id103}@anchor{38e}@anchor{gnat_rm/the_gnat_library gnat-sha384-g-sha384-ads}@anchor{38f} @section @cite{GNAT.SHA384} (@code{g-sha384.ads}) @@ -24176,7 +24248,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{38e}@anchor{gnat_rm/the_gnat_library id104}@anchor{38f} +@anchor{gnat_rm/the_gnat_library gnat-sha512-g-sha512-ads}@anchor{390}@anchor{gnat_rm/the_gnat_library id104}@anchor{391} @section @cite{GNAT.SHA512} (@code{g-sha512.ads}) @@ -24189,7 +24261,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{390}@anchor{gnat_rm/the_gnat_library id105}@anchor{391} +@anchor{gnat_rm/the_gnat_library gnat-signals-g-signal-ads}@anchor{392}@anchor{gnat_rm/the_gnat_library id105}@anchor{393} @section @cite{GNAT.Signals} (@code{g-signal.ads}) @@ -24201,7 +24273,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{392}@anchor{gnat_rm/the_gnat_library id106}@anchor{393} +@anchor{gnat_rm/the_gnat_library gnat-sockets-g-socket-ads}@anchor{394}@anchor{gnat_rm/the_gnat_library id106}@anchor{395} @section @cite{GNAT.Sockets} (@code{g-socket.ads}) @@ -24216,7 +24288,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{394}@anchor{gnat_rm/the_gnat_library id107}@anchor{395} +@anchor{gnat_rm/the_gnat_library gnat-source-info-g-souinf-ads}@anchor{396}@anchor{gnat_rm/the_gnat_library id107}@anchor{397} @section @cite{GNAT.Source_Info} (@code{g-souinf.ads}) @@ -24230,7 +24302,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{396}@anchor{gnat_rm/the_gnat_library id108}@anchor{397} +@anchor{gnat_rm/the_gnat_library gnat-spelling-checker-g-speche-ads}@anchor{398}@anchor{gnat_rm/the_gnat_library id108}@anchor{399} @section @cite{GNAT.Spelling_Checker} (@code{g-speche.ads}) @@ -24242,7 +24314,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{398}@anchor{gnat_rm/the_gnat_library gnat-spelling-checker-generic-g-spchge-ads}@anchor{399} +@anchor{gnat_rm/the_gnat_library id109}@anchor{39a}@anchor{gnat_rm/the_gnat_library gnat-spelling-checker-generic-g-spchge-ads}@anchor{39b} @section @cite{GNAT.Spelling_Checker_Generic} (@code{g-spchge.ads}) @@ -24255,7 +24327,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{39a}@anchor{gnat_rm/the_gnat_library gnat-spitbol-patterns-g-spipat-ads}@anchor{39b} +@anchor{gnat_rm/the_gnat_library id110}@anchor{39c}@anchor{gnat_rm/the_gnat_library gnat-spitbol-patterns-g-spipat-ads}@anchor{39d} @section @cite{GNAT.Spitbol.Patterns} (@code{g-spipat.ads}) @@ -24271,7 +24343,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{39c}@anchor{gnat_rm/the_gnat_library gnat-spitbol-g-spitbo-ads}@anchor{39d} +@anchor{gnat_rm/the_gnat_library id111}@anchor{39e}@anchor{gnat_rm/the_gnat_library gnat-spitbol-g-spitbo-ads}@anchor{39f} @section @cite{GNAT.Spitbol} (@code{g-spitbo.ads}) @@ -24286,7 +24358,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{39e}@anchor{gnat_rm/the_gnat_library gnat-spitbol-table-boolean-g-sptabo-ads}@anchor{39f} +@anchor{gnat_rm/the_gnat_library id112}@anchor{3a0}@anchor{gnat_rm/the_gnat_library gnat-spitbol-table-boolean-g-sptabo-ads}@anchor{3a1} @section @cite{GNAT.Spitbol.Table_Boolean} (@code{g-sptabo.ads}) @@ -24301,7 +24373,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{3a0}@anchor{gnat_rm/the_gnat_library gnat-spitbol-table-integer-g-sptain-ads}@anchor{3a1} +@anchor{gnat_rm/the_gnat_library id113}@anchor{3a2}@anchor{gnat_rm/the_gnat_library gnat-spitbol-table-integer-g-sptain-ads}@anchor{3a3} @section @cite{GNAT.Spitbol.Table_Integer} (@code{g-sptain.ads}) @@ -24318,7 +24390,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{3a2}@anchor{gnat_rm/the_gnat_library gnat-spitbol-table-vstring-g-sptavs-ads}@anchor{3a3} +@anchor{gnat_rm/the_gnat_library id114}@anchor{3a4}@anchor{gnat_rm/the_gnat_library gnat-spitbol-table-vstring-g-sptavs-ads}@anchor{3a5} @section @cite{GNAT.Spitbol.Table_VString} (@code{g-sptavs.ads}) @@ -24335,7 +24407,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{3a4}@anchor{gnat_rm/the_gnat_library gnat-sse-g-sse-ads}@anchor{3a5} +@anchor{gnat_rm/the_gnat_library id115}@anchor{3a6}@anchor{gnat_rm/the_gnat_library gnat-sse-g-sse-ads}@anchor{3a7} @section @cite{GNAT.SSE} (@code{g-sse.ads}) @@ -24347,7 +24419,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 String_Hash g-strhas ads,GNAT SSE g-sse ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-sse-vector-types-g-ssvety-ads}@anchor{3a6}@anchor{gnat_rm/the_gnat_library id116}@anchor{3a7} +@anchor{gnat_rm/the_gnat_library gnat-sse-vector-types-g-ssvety-ads}@anchor{3a8}@anchor{gnat_rm/the_gnat_library id116}@anchor{3a9} @section @cite{GNAT.SSE.Vector_Types} (@code{g-ssvety.ads}) @@ -24356,7 +24428,7 @@ introduction to the binding contents and use. SSE vector types for use with SSE related intrinsics. @node GNAT String_Hash g-strhas ads,GNAT Strings g-string ads,GNAT SSE Vector_Types g-ssvety ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library gnat-string-hash-g-strhas-ads}@anchor{3a8}@anchor{gnat_rm/the_gnat_library id117}@anchor{3a9} +@anchor{gnat_rm/the_gnat_library gnat-string-hash-g-strhas-ads}@anchor{3aa}@anchor{gnat_rm/the_gnat_library id117}@anchor{3ab} @section @cite{GNAT.String_Hash} (@code{g-strhas.ads}) @@ -24368,7 +24440,7 @@ Provides a generic hash function working on arrays of scalars. Both the scalar type and the hash result type are parameters. @node GNAT Strings g-string ads,GNAT String_Split g-strspl ads,GNAT String_Hash g-strhas ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library id118}@anchor{3aa}@anchor{gnat_rm/the_gnat_library gnat-strings-g-string-ads}@anchor{3ab} +@anchor{gnat_rm/the_gnat_library id118}@anchor{3ac}@anchor{gnat_rm/the_gnat_library gnat-strings-g-string-ads}@anchor{3ad} @section @cite{GNAT.Strings} (@code{g-string.ads}) @@ -24378,7 +24450,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{3ac}@anchor{gnat_rm/the_gnat_library id119}@anchor{3ad} +@anchor{gnat_rm/the_gnat_library gnat-string-split-g-strspl-ads}@anchor{3ae}@anchor{gnat_rm/the_gnat_library id119}@anchor{3af} @section @cite{GNAT.String_Split} (@code{g-strspl.ads}) @@ -24392,7 +24464,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{3ae}@anchor{gnat_rm/the_gnat_library id120}@anchor{3af} +@anchor{gnat_rm/the_gnat_library gnat-table-g-table-ads}@anchor{3b0}@anchor{gnat_rm/the_gnat_library id120}@anchor{3b1} @section @cite{GNAT.Table} (@code{g-table.ads}) @@ -24412,7 +24484,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{3b0}@anchor{gnat_rm/the_gnat_library id121}@anchor{3b1} +@anchor{gnat_rm/the_gnat_library gnat-task-lock-g-tasloc-ads}@anchor{3b2}@anchor{gnat_rm/the_gnat_library id121}@anchor{3b3} @section @cite{GNAT.Task_Lock} (@code{g-tasloc.ads}) @@ -24429,7 +24501,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{3b2}@anchor{gnat_rm/the_gnat_library id122}@anchor{3b3} +@anchor{gnat_rm/the_gnat_library gnat-time-stamp-g-timsta-ads}@anchor{3b4}@anchor{gnat_rm/the_gnat_library id122}@anchor{3b5} @section @cite{GNAT.Time_Stamp} (@code{g-timsta.ads}) @@ -24444,7 +24516,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{3b4}@anchor{gnat_rm/the_gnat_library id123}@anchor{3b5} +@anchor{gnat_rm/the_gnat_library gnat-threads-g-thread-ads}@anchor{3b6}@anchor{gnat_rm/the_gnat_library id123}@anchor{3b7} @section @cite{GNAT.Threads} (@code{g-thread.ads}) @@ -24461,7 +24533,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 id124}@anchor{3b6}@anchor{gnat_rm/the_gnat_library gnat-traceback-g-traceb-ads}@anchor{3b7} +@anchor{gnat_rm/the_gnat_library id124}@anchor{3b8}@anchor{gnat_rm/the_gnat_library gnat-traceback-g-traceb-ads}@anchor{3b9} @section @cite{GNAT.Traceback} (@code{g-traceb.ads}) @@ -24473,7 +24545,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{3b8}@anchor{gnat_rm/the_gnat_library id125}@anchor{3b9} +@anchor{gnat_rm/the_gnat_library gnat-traceback-symbolic-g-trasym-ads}@anchor{3ba}@anchor{gnat_rm/the_gnat_library id125}@anchor{3bb} @section @cite{GNAT.Traceback.Symbolic} (@code{g-trasym.ads}) @@ -24482,7 +24554,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 id126}@anchor{3ba}@anchor{gnat_rm/the_gnat_library gnat-utf-32-g-table-ads}@anchor{3bb} +@anchor{gnat_rm/the_gnat_library id126}@anchor{3bc}@anchor{gnat_rm/the_gnat_library gnat-utf-32-g-table-ads}@anchor{3bd} @section @cite{GNAT.UTF_32} (@code{g-table.ads}) @@ -24501,7 +24573,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{3bc}@anchor{gnat_rm/the_gnat_library id127}@anchor{3bd} +@anchor{gnat_rm/the_gnat_library gnat-wide-spelling-checker-g-u3spch-ads}@anchor{3be}@anchor{gnat_rm/the_gnat_library id127}@anchor{3bf} @section @cite{GNAT.Wide_Spelling_Checker} (@code{g-u3spch.ads}) @@ -24514,7 +24586,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{3be}@anchor{gnat_rm/the_gnat_library id128}@anchor{3bf} +@anchor{gnat_rm/the_gnat_library gnat-wide-spelling-checker-g-wispch-ads}@anchor{3c0}@anchor{gnat_rm/the_gnat_library id128}@anchor{3c1} @section @cite{GNAT.Wide_Spelling_Checker} (@code{g-wispch.ads}) @@ -24526,7 +24598,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{3c0}@anchor{gnat_rm/the_gnat_library id129}@anchor{3c1} +@anchor{gnat_rm/the_gnat_library gnat-wide-string-split-g-wistsp-ads}@anchor{3c2}@anchor{gnat_rm/the_gnat_library id129}@anchor{3c3} @section @cite{GNAT.Wide_String_Split} (@code{g-wistsp.ads}) @@ -24540,7 +24612,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{3c2}@anchor{gnat_rm/the_gnat_library id130}@anchor{3c3} +@anchor{gnat_rm/the_gnat_library gnat-wide-wide-spelling-checker-g-zspche-ads}@anchor{3c4}@anchor{gnat_rm/the_gnat_library id130}@anchor{3c5} @section @cite{GNAT.Wide_Wide_Spelling_Checker} (@code{g-zspche.ads}) @@ -24552,7 +24624,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{3c4}@anchor{gnat_rm/the_gnat_library id131}@anchor{3c5} +@anchor{gnat_rm/the_gnat_library gnat-wide-wide-string-split-g-zistsp-ads}@anchor{3c6}@anchor{gnat_rm/the_gnat_library id131}@anchor{3c7} @section @cite{GNAT.Wide_Wide_String_Split} (@code{g-zistsp.ads}) @@ -24566,7 +24638,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 interfaces-c-extensions-i-cexten-ads}@anchor{3c6}@anchor{gnat_rm/the_gnat_library id132}@anchor{3c7} +@anchor{gnat_rm/the_gnat_library interfaces-c-extensions-i-cexten-ads}@anchor{3c8}@anchor{gnat_rm/the_gnat_library id132}@anchor{3c9} @section @cite{Interfaces.C.Extensions} (@code{i-cexten.ads}) @@ -24577,7 +24649,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 id133}@anchor{3c8}@anchor{gnat_rm/the_gnat_library interfaces-c-streams-i-cstrea-ads}@anchor{3c9} +@anchor{gnat_rm/the_gnat_library id133}@anchor{3ca}@anchor{gnat_rm/the_gnat_library interfaces-c-streams-i-cstrea-ads}@anchor{3cb} @section @cite{Interfaces.C.Streams} (@code{i-cstrea.ads}) @@ -24590,7 +24662,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{3ca}@anchor{gnat_rm/the_gnat_library id134}@anchor{3cb} +@anchor{gnat_rm/the_gnat_library interfaces-packed-decimal-i-pacdec-ads}@anchor{3cc}@anchor{gnat_rm/the_gnat_library id134}@anchor{3cd} @section @cite{Interfaces.Packed_Decimal} (@code{i-pacdec.ads}) @@ -24605,7 +24677,7 @@ from a packed decimal format compatible with that used on IBM mainframes. @node Interfaces VxWorks i-vxwork ads,Interfaces VxWorks Int_Connection i-vxinco ads,Interfaces Packed_Decimal i-pacdec ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library interfaces-vxworks-i-vxwork-ads}@anchor{3cc}@anchor{gnat_rm/the_gnat_library id135}@anchor{3cd} +@anchor{gnat_rm/the_gnat_library interfaces-vxworks-i-vxwork-ads}@anchor{3ce}@anchor{gnat_rm/the_gnat_library id135}@anchor{3cf} @section @cite{Interfaces.VxWorks} (@code{i-vxwork.ads}) @@ -24621,7 +24693,7 @@ In particular, it interfaces with the VxWorks hardware interrupt facilities. @node Interfaces VxWorks Int_Connection i-vxinco ads,Interfaces VxWorks IO i-vxwoio ads,Interfaces VxWorks i-vxwork ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library interfaces-vxworks-int-connection-i-vxinco-ads}@anchor{3ce}@anchor{gnat_rm/the_gnat_library id136}@anchor{3cf} +@anchor{gnat_rm/the_gnat_library interfaces-vxworks-int-connection-i-vxinco-ads}@anchor{3d0}@anchor{gnat_rm/the_gnat_library id136}@anchor{3d1} @section @cite{Interfaces.VxWorks.Int_Connection} (@code{i-vxinco.ads}) @@ -24637,7 +24709,7 @@ intConnect() with a custom routine for installing interrupt handlers. @node Interfaces VxWorks IO i-vxwoio ads,System Address_Image s-addima ads,Interfaces VxWorks Int_Connection i-vxinco ads,The GNAT Library -@anchor{gnat_rm/the_gnat_library interfaces-vxworks-io-i-vxwoio-ads}@anchor{3d0}@anchor{gnat_rm/the_gnat_library id137}@anchor{3d1} +@anchor{gnat_rm/the_gnat_library interfaces-vxworks-io-i-vxwoio-ads}@anchor{3d2}@anchor{gnat_rm/the_gnat_library id137}@anchor{3d3} @section @cite{Interfaces.VxWorks.IO} (@code{i-vxwoio.ads}) @@ -24660,7 +24732,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 id138}@anchor{3d2}@anchor{gnat_rm/the_gnat_library system-address-image-s-addima-ads}@anchor{3d3} +@anchor{gnat_rm/the_gnat_library id138}@anchor{3d4}@anchor{gnat_rm/the_gnat_library system-address-image-s-addima-ads}@anchor{3d5} @section @cite{System.Address_Image} (@code{s-addima.ads}) @@ -24676,7 +24748,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 id139}@anchor{3d4}@anchor{gnat_rm/the_gnat_library system-assertions-s-assert-ads}@anchor{3d5} +@anchor{gnat_rm/the_gnat_library id139}@anchor{3d6}@anchor{gnat_rm/the_gnat_library system-assertions-s-assert-ads}@anchor{3d7} @section @cite{System.Assertions} (@code{s-assert.ads}) @@ -24692,7 +24764,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 id140}@anchor{3d6}@anchor{gnat_rm/the_gnat_library system-atomic-counters-s-atocou-ads}@anchor{3d7} +@anchor{gnat_rm/the_gnat_library id140}@anchor{3d8}@anchor{gnat_rm/the_gnat_library system-atomic-counters-s-atocou-ads}@anchor{3d9} @section @cite{System.Atomic_Counters} (@code{s-atocou.ads}) @@ -24706,7 +24778,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{3d8}@anchor{gnat_rm/the_gnat_library id141}@anchor{3d9} +@anchor{gnat_rm/the_gnat_library system-memory-s-memory-ads}@anchor{3da}@anchor{gnat_rm/the_gnat_library id141}@anchor{3db} @section @cite{System.Memory} (@code{s-memory.ads}) @@ -24724,7 +24796,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 system-multiprocessors-s-multip-ads}@anchor{3da}@anchor{gnat_rm/the_gnat_library id142}@anchor{3db} +@anchor{gnat_rm/the_gnat_library system-multiprocessors-s-multip-ads}@anchor{3dc}@anchor{gnat_rm/the_gnat_library id142}@anchor{3dd} @section @cite{System.Multiprocessors} (@code{s-multip.ads}) @@ -24737,7 +24809,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{3dc}@anchor{gnat_rm/the_gnat_library id143}@anchor{3dd} +@anchor{gnat_rm/the_gnat_library system-multiprocessors-dispatching-domains-s-mudido-ads}@anchor{3de}@anchor{gnat_rm/the_gnat_library id143}@anchor{3df} @section @cite{System.Multiprocessors.Dispatching_Domains} (@code{s-mudido.ads}) @@ -24750,7 +24822,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 id144}@anchor{3de}@anchor{gnat_rm/the_gnat_library system-partition-interface-s-parint-ads}@anchor{3df} +@anchor{gnat_rm/the_gnat_library id144}@anchor{3e0}@anchor{gnat_rm/the_gnat_library system-partition-interface-s-parint-ads}@anchor{3e1} @section @cite{System.Partition_Interface} (@code{s-parint.ads}) @@ -24763,7 +24835,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 id145}@anchor{3e0}@anchor{gnat_rm/the_gnat_library system-pool-global-s-pooglo-ads}@anchor{3e1} +@anchor{gnat_rm/the_gnat_library id145}@anchor{3e2}@anchor{gnat_rm/the_gnat_library system-pool-global-s-pooglo-ads}@anchor{3e3} @section @cite{System.Pool_Global} (@code{s-pooglo.ads}) @@ -24780,7 +24852,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 system-pool-local-s-pooloc-ads}@anchor{3e2}@anchor{gnat_rm/the_gnat_library id146}@anchor{3e3} +@anchor{gnat_rm/the_gnat_library system-pool-local-s-pooloc-ads}@anchor{3e4}@anchor{gnat_rm/the_gnat_library id146}@anchor{3e5} @section @cite{System.Pool_Local} (@code{s-pooloc.ads}) @@ -24797,7 +24869,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 id147}@anchor{3e4}@anchor{gnat_rm/the_gnat_library system-restrictions-s-restri-ads}@anchor{3e5} +@anchor{gnat_rm/the_gnat_library id147}@anchor{3e6}@anchor{gnat_rm/the_gnat_library system-restrictions-s-restri-ads}@anchor{3e7} @section @cite{System.Restrictions} (@code{s-restri.ads}) @@ -24813,7 +24885,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{3e6}@anchor{gnat_rm/the_gnat_library id148}@anchor{3e7} +@anchor{gnat_rm/the_gnat_library system-rident-s-rident-ads}@anchor{3e8}@anchor{gnat_rm/the_gnat_library id148}@anchor{3e9} @section @cite{System.Rident} (@code{s-rident.ads}) @@ -24829,7 +24901,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 id149}@anchor{3e8}@anchor{gnat_rm/the_gnat_library system-strings-stream-ops-s-ststop-ads}@anchor{3e9} +@anchor{gnat_rm/the_gnat_library id149}@anchor{3ea}@anchor{gnat_rm/the_gnat_library system-strings-stream-ops-s-ststop-ads}@anchor{3eb} @section @cite{System.Strings.Stream_Ops} (@code{s-ststop.ads}) @@ -24845,7 +24917,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{3ea}@anchor{gnat_rm/the_gnat_library id150}@anchor{3eb} +@anchor{gnat_rm/the_gnat_library system-unsigned-types-s-unstyp-ads}@anchor{3ec}@anchor{gnat_rm/the_gnat_library id150}@anchor{3ed} @section @cite{System.Unsigned_Types} (@code{s-unstyp.ads}) @@ -24858,7 +24930,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{3ec}@anchor{gnat_rm/the_gnat_library id151}@anchor{3ed} +@anchor{gnat_rm/the_gnat_library system-wch-cnv-s-wchcnv-ads}@anchor{3ee}@anchor{gnat_rm/the_gnat_library id151}@anchor{3ef} @section @cite{System.Wch_Cnv} (@code{s-wchcnv.ads}) @@ -24879,7 +24951,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{3ee}@anchor{gnat_rm/the_gnat_library id152}@anchor{3ef} +@anchor{gnat_rm/the_gnat_library system-wch-con-s-wchcon-ads}@anchor{3f0}@anchor{gnat_rm/the_gnat_library id152}@anchor{3f1} @section @cite{System.Wch_Con} (@code{s-wchcon.ads}) @@ -24891,7 +24963,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{3f0}@anchor{gnat_rm/interfacing_to_other_languages id1}@anchor{3f1} +@anchor{gnat_rm/interfacing_to_other_languages interfacing-to-other-languages}@anchor{11}@anchor{gnat_rm/interfacing_to_other_languages doc}@anchor{3f2}@anchor{gnat_rm/interfacing_to_other_languages id1}@anchor{3f3} @chapter Interfacing to Other Languages @@ -24909,7 +24981,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{3f2}@anchor{gnat_rm/interfacing_to_other_languages id2}@anchor{3f3} +@anchor{gnat_rm/interfacing_to_other_languages interfacing-to-c}@anchor{3f4}@anchor{gnat_rm/interfacing_to_other_languages id2}@anchor{3f5} @section Interfacing to C @@ -25047,7 +25119,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{3f4}@anchor{gnat_rm/interfacing_to_other_languages id3}@anchor{45} +@anchor{gnat_rm/interfacing_to_other_languages id4}@anchor{3f6}@anchor{gnat_rm/interfacing_to_other_languages id3}@anchor{45} @section Interfacing to C++ @@ -25104,7 +25176,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{3f5}@anchor{gnat_rm/interfacing_to_other_languages interfacing-to-cobol}@anchor{3f6} +@anchor{gnat_rm/interfacing_to_other_languages id5}@anchor{3f7}@anchor{gnat_rm/interfacing_to_other_languages interfacing-to-cobol}@anchor{3f8} @section Interfacing to COBOL @@ -25112,7 +25184,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{3f7}@anchor{gnat_rm/interfacing_to_other_languages interfacing-to-fortran}@anchor{3f8} +@anchor{gnat_rm/interfacing_to_other_languages id6}@anchor{3f9}@anchor{gnat_rm/interfacing_to_other_languages interfacing-to-fortran}@anchor{3fa} @section Interfacing to Fortran @@ -25122,7 +25194,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{3f9}@anchor{gnat_rm/interfacing_to_other_languages id7}@anchor{3fa} +@anchor{gnat_rm/interfacing_to_other_languages interfacing-to-non-gnat-ada-code}@anchor{3fb}@anchor{gnat_rm/interfacing_to_other_languages id7}@anchor{3fc} @section Interfacing to non-GNAT Ada code @@ -25146,7 +25218,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{3fb}@anchor{gnat_rm/specialized_needs_annexes id1}@anchor{3fc} +@anchor{gnat_rm/specialized_needs_annexes specialized-needs-annexes}@anchor{12}@anchor{gnat_rm/specialized_needs_annexes doc}@anchor{3fd}@anchor{gnat_rm/specialized_needs_annexes id1}@anchor{3fe} @chapter Specialized Needs Annexes @@ -25187,7 +25259,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{3fd}@anchor{gnat_rm/implementation_of_specific_ada_features id1}@anchor{3fe} +@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{3ff}@anchor{gnat_rm/implementation_of_specific_ada_features id1}@anchor{400} @chapter Implementation of Specific Ada Features @@ -25205,7 +25277,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{15e}@anchor{gnat_rm/implementation_of_specific_ada_features id2}@anchor{3ff} +@anchor{gnat_rm/implementation_of_specific_ada_features machine-code-insertions}@anchor{160}@anchor{gnat_rm/implementation_of_specific_ada_features id2}@anchor{401} @section Machine Code Insertions @@ -25373,7 +25445,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{400}@anchor{gnat_rm/implementation_of_specific_ada_features gnat-implementation-of-tasking}@anchor{401} +@anchor{gnat_rm/implementation_of_specific_ada_features id3}@anchor{402}@anchor{gnat_rm/implementation_of_specific_ada_features gnat-implementation-of-tasking}@anchor{403} @section GNAT Implementation of Tasking @@ -25384,11 +25456,12 @@ to compliance with the Real-Time Systems Annex. @menu * Mapping Ada Tasks onto the Underlying Kernel Threads:: * Ensuring Compliance with the Real-Time Annex:: +* Support for Locking Policies:: @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{402}@anchor{gnat_rm/implementation_of_specific_ada_features id4}@anchor{403} +@anchor{gnat_rm/implementation_of_specific_ada_features mapping-ada-tasks-onto-the-underlying-kernel-threads}@anchor{404}@anchor{gnat_rm/implementation_of_specific_ada_features id4}@anchor{405} @subsection Mapping Ada Tasks onto the Underlying Kernel Threads @@ -25456,8 +25529,8 @@ 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{404}@anchor{gnat_rm/implementation_of_specific_ada_features ensuring-compliance-with-the-real-time-annex}@anchor{405} +@node Ensuring Compliance with the Real-Time Annex,Support for Locking Policies,Mapping Ada Tasks onto the Underlying Kernel Threads,GNAT Implementation of Tasking +@anchor{gnat_rm/implementation_of_specific_ada_features id5}@anchor{406}@anchor{gnat_rm/implementation_of_specific_ada_features ensuring-compliance-with-the-real-time-annex}@anchor{407} @subsection Ensuring Compliance with the Real-Time Annex @@ -25505,8 +25578,35 @@ Note that this simple scheme preserves the relative order of the tasks that were ready to execute in the priority queue where R has been placed at the end. +@c Support_for_Locking_Policies + +@node Support for Locking Policies,,Ensuring Compliance with the Real-Time Annex,GNAT Implementation of Tasking +@anchor{gnat_rm/implementation_of_specific_ada_features support-for-locking-policies}@anchor{408} +@subsection Support for Locking Policies + + +This section specifies which policies specified by pragma Locking_Policy +are supported on which platforms. + +GNAT supports the standard @cite{Ceiling_Locking} policy, and the +implementation defined @cite{Inheritance_Locking} and +@cite{Concurrent_Readers_Locking} policies. + +@cite{Ceiling_Locking} is supported on all platforms if the operating system +supports it. In particular, @cite{Ceiling_Locking} is not supported on +VxWorks. +@cite{Inheritance_Locking} is supported on +Linux, +Darwin (Mac OS X), +LynxOS 178, +and VxWorks. +@cite{Concurrent_Readers_Locking} is supported on Linux. + +Note that on Linux, @cite{Ceiling_Locking} requires the program to be running +with root privileges. Otherwise, the policy is ignored. + @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{406}@anchor{gnat_rm/implementation_of_specific_ada_features gnat-implementation-of-shared-passive-packages}@anchor{407} +@anchor{gnat_rm/implementation_of_specific_ada_features id6}@anchor{409}@anchor{gnat_rm/implementation_of_specific_ada_features gnat-implementation-of-shared-passive-packages}@anchor{40a} @section GNAT Implementation of Shared Passive Packages @@ -25607,7 +25707,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{408}@anchor{gnat_rm/implementation_of_specific_ada_features id7}@anchor{409} +@anchor{gnat_rm/implementation_of_specific_ada_features code-generation-for-array-aggregates}@anchor{40b}@anchor{gnat_rm/implementation_of_specific_ada_features id7}@anchor{40c} @section Code Generation for Array Aggregates @@ -25638,7 +25738,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{40a}@anchor{gnat_rm/implementation_of_specific_ada_features id8}@anchor{40b} +@anchor{gnat_rm/implementation_of_specific_ada_features static-constant-aggregates-with-static-bounds}@anchor{40d}@anchor{gnat_rm/implementation_of_specific_ada_features id8}@anchor{40e} @subsection Static constant aggregates with static bounds @@ -25685,7 +25785,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{40c}@anchor{gnat_rm/implementation_of_specific_ada_features id9}@anchor{40d} +@anchor{gnat_rm/implementation_of_specific_ada_features constant-aggregates-with-unconstrained-nominal-types}@anchor{40f}@anchor{gnat_rm/implementation_of_specific_ada_features id9}@anchor{410} @subsection Constant aggregates with unconstrained nominal types @@ -25700,7 +25800,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{40e}@anchor{gnat_rm/implementation_of_specific_ada_features aggregates-with-static-bounds}@anchor{40f} +@anchor{gnat_rm/implementation_of_specific_ada_features id10}@anchor{411}@anchor{gnat_rm/implementation_of_specific_ada_features aggregates-with-static-bounds}@anchor{412} @subsection Aggregates with static bounds @@ -25728,7 +25828,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{410}@anchor{gnat_rm/implementation_of_specific_ada_features aggregates-with-nonstatic-bounds}@anchor{411} +@anchor{gnat_rm/implementation_of_specific_ada_features id11}@anchor{413}@anchor{gnat_rm/implementation_of_specific_ada_features aggregates-with-nonstatic-bounds}@anchor{414} @subsection Aggregates with nonstatic bounds @@ -25739,7 +25839,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{412}@anchor{gnat_rm/implementation_of_specific_ada_features aggregates-in-assignment-statements}@anchor{413} +@anchor{gnat_rm/implementation_of_specific_ada_features id12}@anchor{415}@anchor{gnat_rm/implementation_of_specific_ada_features aggregates-in-assignment-statements}@anchor{416} @subsection Aggregates in assignment statements @@ -25781,7 +25881,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{414}@anchor{gnat_rm/implementation_of_specific_ada_features the-size-of-discriminated-records-with-default-discriminants}@anchor{415} +@anchor{gnat_rm/implementation_of_specific_ada_features id13}@anchor{417}@anchor{gnat_rm/implementation_of_specific_ada_features the-size-of-discriminated-records-with-default-discriminants}@anchor{418} @section The Size of Discriminated Records with Default Discriminants @@ -25861,7 +25961,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{416}@anchor{gnat_rm/implementation_of_specific_ada_features id14}@anchor{417} +@anchor{gnat_rm/implementation_of_specific_ada_features strict-conformance-to-the-ada-reference-manual}@anchor{419}@anchor{gnat_rm/implementation_of_specific_ada_features id14}@anchor{41a} @section Strict Conformance to the Ada Reference Manual @@ -25888,7 +25988,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{418}@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{419} +@anchor{gnat_rm/implementation_of_ada_2012_features doc}@anchor{41b}@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{41c} @chapter Implementation of Ada 2012 Features @@ -28054,7 +28154,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{41a}@anchor{gnat_rm/obsolescent_features doc}@anchor{41b}@anchor{gnat_rm/obsolescent_features obsolescent-features}@anchor{15} +@anchor{gnat_rm/obsolescent_features id1}@anchor{41d}@anchor{gnat_rm/obsolescent_features doc}@anchor{41e}@anchor{gnat_rm/obsolescent_features obsolescent-features}@anchor{15} @chapter Obsolescent Features @@ -28073,7 +28173,7 @@ compatibility purposes. @end menu @node pragma No_Run_Time,pragma Ravenscar,,Obsolescent Features -@anchor{gnat_rm/obsolescent_features id2}@anchor{41c}@anchor{gnat_rm/obsolescent_features pragma-no-run-time}@anchor{41d} +@anchor{gnat_rm/obsolescent_features id2}@anchor{41f}@anchor{gnat_rm/obsolescent_features pragma-no-run-time}@anchor{420} @section pragma No_Run_Time @@ -28086,7 +28186,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{41e}@anchor{gnat_rm/obsolescent_features pragma-ravenscar}@anchor{41f} +@anchor{gnat_rm/obsolescent_features id3}@anchor{421}@anchor{gnat_rm/obsolescent_features pragma-ravenscar}@anchor{422} @section pragma Ravenscar @@ -28095,7 +28195,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{420}@anchor{gnat_rm/obsolescent_features id4}@anchor{421} +@anchor{gnat_rm/obsolescent_features pragma-restricted-run-time}@anchor{423}@anchor{gnat_rm/obsolescent_features id4}@anchor{424} @section pragma Restricted_Run_Time @@ -28105,7 +28205,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{422}@anchor{gnat_rm/obsolescent_features id5}@anchor{423} +@anchor{gnat_rm/obsolescent_features pragma-task-info}@anchor{425}@anchor{gnat_rm/obsolescent_features id5}@anchor{426} @section pragma Task_Info @@ -28131,7 +28231,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{424}@anchor{gnat_rm/obsolescent_features package-system-task-info-s-tasinf-ads}@anchor{425} +@anchor{gnat_rm/obsolescent_features package-system-task-info}@anchor{427}@anchor{gnat_rm/obsolescent_features package-system-task-info-s-tasinf-ads}@anchor{428} @section package System.Task_Info (@code{s-tasinf.ads}) @@ -28141,7 +28241,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{426}@anchor{gnat_rm/compatibility_and_porting_guide id1}@anchor{427} +@anchor{gnat_rm/compatibility_and_porting_guide compatibility-and-porting-guide}@anchor{16}@anchor{gnat_rm/compatibility_and_porting_guide doc}@anchor{429}@anchor{gnat_rm/compatibility_and_porting_guide id1}@anchor{42a} @chapter Compatibility and Porting Guide @@ -28163,7 +28263,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{428}@anchor{gnat_rm/compatibility_and_porting_guide writing-portable-fixed-point-declarations}@anchor{429} +@anchor{gnat_rm/compatibility_and_porting_guide id2}@anchor{42b}@anchor{gnat_rm/compatibility_and_porting_guide writing-portable-fixed-point-declarations}@anchor{42c} @section Writing Portable Fixed-Point Declarations @@ -28285,7 +28385,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{42a}@anchor{gnat_rm/compatibility_and_porting_guide id3}@anchor{42b} +@anchor{gnat_rm/compatibility_and_porting_guide compatibility-with-ada-83}@anchor{42d}@anchor{gnat_rm/compatibility_and_porting_guide id3}@anchor{42e} @section Compatibility with Ada 83 @@ -28313,7 +28413,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{42c}@anchor{gnat_rm/compatibility_and_porting_guide legal-ada-83-programs-that-are-illegal-in-ada-95}@anchor{42d} +@anchor{gnat_rm/compatibility_and_porting_guide id4}@anchor{42f}@anchor{gnat_rm/compatibility_and_porting_guide legal-ada-83-programs-that-are-illegal-in-ada-95}@anchor{430} @subsection Legal Ada 83 programs that are illegal in Ada 95 @@ -28413,7 +28513,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{42e}@anchor{gnat_rm/compatibility_and_porting_guide id5}@anchor{42f} +@anchor{gnat_rm/compatibility_and_porting_guide more-deterministic-semantics}@anchor{431}@anchor{gnat_rm/compatibility_and_porting_guide id5}@anchor{432} @subsection More deterministic semantics @@ -28441,7 +28541,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{430}@anchor{gnat_rm/compatibility_and_porting_guide changed-semantics}@anchor{431} +@anchor{gnat_rm/compatibility_and_porting_guide id6}@anchor{433}@anchor{gnat_rm/compatibility_and_porting_guide changed-semantics}@anchor{434} @subsection Changed semantics @@ -28483,7 +28583,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{432}@anchor{gnat_rm/compatibility_and_porting_guide id7}@anchor{433} +@anchor{gnat_rm/compatibility_and_porting_guide other-language-compatibility-issues}@anchor{435}@anchor{gnat_rm/compatibility_and_porting_guide id7}@anchor{436} @subsection Other language compatibility issues @@ -28516,7 +28616,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{434}@anchor{gnat_rm/compatibility_and_porting_guide id8}@anchor{435} +@anchor{gnat_rm/compatibility_and_porting_guide compatibility-between-ada-95-and-ada-2005}@anchor{437}@anchor{gnat_rm/compatibility_and_porting_guide id8}@anchor{438} @section Compatibility between Ada 95 and Ada 2005 @@ -28588,7 +28688,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{436}@anchor{gnat_rm/compatibility_and_porting_guide id9}@anchor{437} +@anchor{gnat_rm/compatibility_and_porting_guide implementation-dependent-characteristics}@anchor{439}@anchor{gnat_rm/compatibility_and_porting_guide id9}@anchor{43a} @section Implementation-dependent characteristics @@ -28611,7 +28711,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{438}@anchor{gnat_rm/compatibility_and_porting_guide id10}@anchor{439} +@anchor{gnat_rm/compatibility_and_porting_guide implementation-defined-pragmas}@anchor{43b}@anchor{gnat_rm/compatibility_and_porting_guide id10}@anchor{43c} @subsection Implementation-defined pragmas @@ -28633,7 +28733,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{43a}@anchor{gnat_rm/compatibility_and_porting_guide implementation-defined-attributes}@anchor{43b} +@anchor{gnat_rm/compatibility_and_porting_guide id11}@anchor{43d}@anchor{gnat_rm/compatibility_and_porting_guide implementation-defined-attributes}@anchor{43e} @subsection Implementation-defined attributes @@ -28647,7 +28747,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{43c}@anchor{gnat_rm/compatibility_and_porting_guide id12}@anchor{43d} +@anchor{gnat_rm/compatibility_and_porting_guide libraries}@anchor{43f}@anchor{gnat_rm/compatibility_and_porting_guide id12}@anchor{440} @subsection Libraries @@ -28676,7 +28776,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{43e}@anchor{gnat_rm/compatibility_and_porting_guide id13}@anchor{43f} +@anchor{gnat_rm/compatibility_and_porting_guide elaboration-order}@anchor{441}@anchor{gnat_rm/compatibility_and_porting_guide id13}@anchor{442} @subsection Elaboration order @@ -28712,7 +28812,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{440}@anchor{gnat_rm/compatibility_and_porting_guide id14}@anchor{441} +@anchor{gnat_rm/compatibility_and_porting_guide target-specific-aspects}@anchor{443}@anchor{gnat_rm/compatibility_and_porting_guide id14}@anchor{444} @subsection Target-specific aspects @@ -28725,10 +28825,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{442,,Representation Clauses}. +GNAT's approach to these issues is described in @ref{445,,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{443}@anchor{gnat_rm/compatibility_and_porting_guide compatibility-with-other-ada-systems}@anchor{444} +@anchor{gnat_rm/compatibility_and_porting_guide id15}@anchor{446}@anchor{gnat_rm/compatibility_and_porting_guide compatibility-with-other-ada-systems}@anchor{447} @section Compatibility with Other Ada Systems @@ -28771,7 +28871,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{442}@anchor{gnat_rm/compatibility_and_porting_guide id16}@anchor{445} +@anchor{gnat_rm/compatibility_and_porting_guide representation-clauses}@anchor{445}@anchor{gnat_rm/compatibility_and_porting_guide id16}@anchor{448} @section Representation Clauses @@ -28864,7 +28964,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{446}@anchor{gnat_rm/compatibility_and_porting_guide id17}@anchor{447} +@anchor{gnat_rm/compatibility_and_porting_guide compatibility-with-hp-ada-83}@anchor{449}@anchor{gnat_rm/compatibility_and_porting_guide id17}@anchor{44a} @section Compatibility with HP Ada 83 @@ -28894,7 +28994,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{448}@anchor{share/gnu_free_documentation_license gnu-free-documentation-license}@anchor{449} +@anchor{share/gnu_free_documentation_license gnu-fdl}@anchor{1}@anchor{share/gnu_free_documentation_license doc}@anchor{44b}@anchor{share/gnu_free_documentation_license gnu-free-documentation-license}@anchor{44c} @chapter GNU Free Documentation License diff --git a/gcc/ada/gnat_ugn.texi b/gcc/ada/gnat_ugn.texi index 1916d1efc57..2e1a78839cb 100644 --- a/gcc/ada/gnat_ugn.texi +++ b/gcc/ada/gnat_ugn.texi @@ -3,7 +3,7 @@ @setfilename gnat_ugn.info @documentencoding UTF-8 @ifinfo -@*Generated by Sphinx 1.3b2.@* +@*Generated by Sphinx 1.4.6.@* @end ifinfo @settitle GNAT User's Guide for Native Platforms @defindex ge @@ -21,7 +21,7 @@ @copying @quotation -GNAT User's Guide for Native Platforms , January 13, 2017 +GNAT User's Guide for Native Platforms , Apr 25, 2017 AdaCore @@ -331,7 +331,7 @@ The Cross-Referencing Tools gnatxref and gnatfind * gnatxref Switches:: * gnatfind Switches:: -* Project Files for gnatxref and gnatfind:: +* Configuration Files for gnatxref and gnatfind:: * Regular Expressions in gnatfind and gnatxref:: * Examples of gnatxref Usage:: * Examples of gnatfind Usage:: @@ -4611,9 +4611,9 @@ The preprocessing language allows such constructs as @example #if DEBUG or else (PRIORITY > 4) then - bunch of declarations + sequence of declarations #else - completely different bunch of declarations + completely different sequence of declarations #end if; @end example @@ -4622,7 +4622,7 @@ defined either on the command line or in a separate file. The other way of running the preprocessor is even closer to the C style and often more convenient. In this approach the preprocessing is integrated into -the compilation process. The compiler is fed the preprocessor input which +the compilation process. The compiler is given the preprocessor input which includes @cite{#if} lines etc, and then the compiler carries out the preprocessing internally and processes the resulting output. For more details on this approach, see @ref{18,,Integrated Preprocessing}. @@ -4657,8 +4657,8 @@ For further discussion of conditional compilation in general, see @subsubsection Preprocessing Symbols -Preprocessing symbols are defined in definition files and referred to in -sources to be preprocessed. A Preprocessing symbol is an identifier, following +Preprocessing symbols are defined in @emph{definition files} and referenced in the +sources to be preprocessed. A preprocessing symbol is an identifier, following normal Ada (case-insensitive) rules for its syntax, with the restriction that all characters need to be in the ASCII set (no accented letters). @@ -4705,7 +4705,7 @@ file containing preprocessor directives. is the full name of the output file, which is an Ada source in standard Ada form. When used with GNAT, this file name will -normally have an ads or adb suffix. +normally have an @emph{ads} or @emph{adb} suffix. @end table @item @@ -4742,7 +4742,7 @@ Display Copyright and version, then exit disregarding all other options. @item @code{--help} -If @emph{--version} was not used, display usage, then exit disregarding +If @code{--version} was not used, display usage and then exit disregarding all other options. @end table @@ -4781,10 +4781,10 @@ being preserved in the output file. Causes comments to be scanned. Normally comments are ignored by gnatprep. If this option is specified, then comments are scanned and any $symbol substitutions performed as in program text. This is particularly useful -when structured comments are used (e.g., when writing programs in the -SPARK dialect of Ada). Note that this switch is not available when -doing integrated preprocessing (it would be useless in this context -since comments are ignored by the compiler in any case). +when structured comments are used (e.g., for programs written in a +pre-2014 version of the SPARK Ada subset). Note that this switch is not +available when doing integrated preprocessing (it would be useless in +this context since comments are ignored by the compiler in any case). @end table @geindex -D (gnatprep) @@ -4792,9 +4792,9 @@ since comments are ignored by the compiler in any case). @table @asis -@item @code{-D@emph{symbol}=@emph{value}} +@item @code{-D@emph{symbol}[=@emph{value}]} -Defines a new preprocessing symbol, associated with value. If no value is given +Defines a new preprocessing symbol with the specified value. If no value is given on the command line, then symbol is considered to be @cite{True}. This switch can be used in place of a definition file. @end table @@ -5038,48 +5038,66 @@ and then the substitution will occur as desired. @subsection Integrated Preprocessing -GNAT sources may be preprocessed immediately before compilation. -In this case, the actual -text of the source is not the text of the source file, but is derived from it -through a process called preprocessing. Integrated preprocessing is specified -through switches @emph{-gnatep} and/or @emph{-gnateD}. @emph{-gnatep} -indicates, through a text file, the preprocessing data to be used. -@code{-gnateD} specifies or modifies the values of preprocessing symbol. -Note that integrated preprocessing applies only to Ada source files, it is +As noted above, a file to be preprocessed consists of Ada source code +in which preprocessing lines have been inserted. However, +instead of using @emph{gnatprep} to explicitly preprocess a file as a separate +step before compilation, you can carry out the preprocessing implicitly +as part of compilation. Such @emph{integrated preprocessing}, which is the common +style with C, is performed when either or both of the following switches +are passed to the compiler: + +@quotation + + +@itemize * + +@item +@code{-gnatep}, which specifies the @emph{preprocessor data file}. +This file dictates how the source files will be preprocessed (e.g., which +symbol definition files apply to which sources). + +@item +@code{-gnateD}, which defines values for preprocessing symbols. +@end itemize +@end quotation + +Integrated preprocessing applies only to Ada source files, it is not available for configuration pragma files. -Note that when integrated preprocessing is used, the output from the -preprocessor is not written to any external file. Instead it is passed -internally to the compiler. If you need to preserve the result of -preprocessing in a file, then you should use @emph{gnatprep} -to perform the desired preprocessing in stand-alone mode. +With integrated preprocessing, the output from the preprocessor is not, +by default, written to any external file. Instead it is passed +internally to the compiler. To preserve the result of +preprocessing in a file, either run @emph{gnatprep} +in standalone mode or else supply the @code{-gnateG} switch +(described below) to the compiler. -It is recommended that @emph{gnatmake} switch -s should be -used when Integrated Preprocessing is used. The reason is that preprocessing -with another Preprocessing Data file without changing the sources will -not trigger recompilation without this switch. +The @emph{gnatmake} switch @code{-s} should be used with integrated +preprocessing; otherwise the use of a different preprocessor data file +without changing the sources will not cause recompilation. -Note that @emph{gnatmake} switch -m will almost +Note that the @emph{gnatmake} switch @code{-m} will almost always trigger recompilation for sources that are preprocessed, because @emph{gnatmake} cannot compute the checksum of the source after preprocessing. -The actual preprocessing function is described in detail in section -@ref{17,,Preprocessing with gnatprep}. This section only describes how integrated -preprocessing is triggered and parameterized. +The actual preprocessing function is described in detail in +@ref{17,,Preprocessing with gnatprep}. This section explains the switches +that relate to integrated preprocessing. @geindex -gnatep (gcc) @table @asis -@item @code{-gnatep=@emph{file}} +@item @code{-gnatep=@emph{preprocessor_data_file}} -This switch indicates to the compiler the file name (without directory -information) of the preprocessor data file to use. The preprocessor data file -should be found in the source directories. Alternatively when using project -files, you can reference to the project file's directory via the -@code{project name'Project_Dir} project attribute, e.g: +This switch specifies the file name (without directory +information) of the preprocessor data file. Either place this file +in one of the source directories, or, when using project +files, reference the project file's directory via the +@code{project_name'Project_Dir} project attribute; e.g: + +@quotation @example project Prj is @@ -5089,30 +5107,87 @@ project Prj is end Compiler; end Prj; @end example +@end quotation + +A preprocessor data file is a text file that contains @emph{preprocessor +control lines}. A preprocessor control line directs the preprocessing of +either a particular source file, or, analogous to @emph{others} in Ada, +all sources not specified elsewhere in the preprocessor data file. +A preprocessor control line +can optionally identify a @emph{definition file} that assigns values to +preprocessor symbols, as well as a list of switches that relate to +preprocessing. +Empty lines and comments (using Ada syntax) are also permitted, with no +semantic effect. + +Here's an example of a preprocessor data file: + +@quotation + +@example +"toto.adb" "prep.def" -u +-- Preprocess toto.adb, using definition file prep.def +-- Undefined symbols are treated as False + +* -c -DVERSION=V101 +-- Preprocess all other sources without using a definition file +-- Suppressed lined are commented +-- Symbol VERSION has the value V101 + +"tata.adb" "prep2.def" -s +-- Preprocess tata.adb, using definition file prep2.def +-- List all symbols with their values +@end example +@end quotation + +A preprocessor control line has the following syntax: + +@quotation + +@example + ::= + [ ] @{ @} + + ::= | '*' + + ::= + + := + + := (See below for list) +@end example +@end quotation + +Thus each preprocessor control line starts with either a literal string or +the character '*': -A preprocessing data file is a text file with significant lines indicating -how should be preprocessed either a specific source or all sources not -mentioned in other lines. A significant line is a nonempty, non-comment line. -Comments are similar to Ada comments. -Each significant line starts with either a literal string or the character '*'. +@itemize * + +@item A literal string is the file name (without directory information) of the source -to preprocess. A character '*' indicates the preprocessing for all the sources -that are not specified explicitly on other lines (order of the lines is not -significant). It is an error to have two lines with the same file name or two +file that will be input to the preprocessor. + +@item +The character '*' is a wild-card indicator; the additional parameters on the line +indicate the preprocessing for all the sources +that are not specified explicitly on other lines (the order of the lines is not +significant). +@end itemize + +It is an error to have two lines with the same file name or two lines starting with the character '*'. -After the file name or the character '*', another optional literal string -indicating the file name of the definition file to be used for preprocessing +After the file name or '*', an optional literal string specifies the name of +the definition file to be used for preprocessing (@ref{ac,,Form of Definitions File}). The definition files are found by the compiler in one of the source directories. In some cases, when compiling a source in a directory other than the current directory, if the definition file is in the current directory, it may be necessary to add the current -directory as a source directory through switch -I., otherwise +directory as a source directory through the @code{-I} switch; otherwise the compiler would not find the definition file. -Then, optionally, switches similar to those of @cite{gnatprep} may -be found. Those switches are: +Finally, switches similar to those of @emph{gnatprep} may optionally appear: @table @asis @@ -5121,8 +5196,8 @@ be found. Those switches are: Causes both preprocessor lines and the lines deleted by preprocessing to be replaced by blank lines, preserving the line number. -This switch is always implied; however, if specified after @emph{-c} -it cancels the effect of @emph{-c}. +This switch is always implied; however, if specified after @code{-c} +it cancels the effect of @code{-c}. @item @code{-c} @@ -5130,12 +5205,13 @@ Causes both preprocessor lines and the lines deleted by preprocessing to be retained as comments marked with the special string '@cite{--!}'. -@item @code{-Dsymbol=@emph{value}} +@item @code{-D@emph{symbol}=@emph{new_value}} -Define or redefine a symbol, associated with value. A symbol is an Ada -identifier, or an Ada reserved word, with the exception of @cite{if}, +Define or redefine @emph{symbol} to have @emph{new_value} as its value. +The permitted form for @emph{symbol} is either an Ada identifier, or any Ada reserved word +aside from @cite{if}, @cite{else}, @cite{elsif}, @cite{end}, @cite{and}, @cite{or} and @cite{then}. -@cite{value} is either a literal string, an Ada identifier or any Ada reserved +The permitted form for @cite{new_value} is a literal string, an Ada identifier or any Ada reserved word. A symbol declared with this switch replaces a symbol with the same name defined in a definition file. @@ -5151,22 +5227,6 @@ in the context of a preprocessor test. In the absence of this option, an undefined symbol in a @cite{#if} or @cite{#elsif} test will be treated as an error. @end table - -Examples of valid lines in a preprocessor data file: - -@example -"toto.adb" "prep.def" -u --- preprocess "toto.adb", using definition file "prep.def", --- undefined symbol are False. - -* -c -DVERSION=V101 --- preprocess all other sources without a definition file; --- suppressed lined are commented; symbol VERSION has the value V101. - -"titi.adb" "prep2.def" -s --- preprocess "titi.adb", using definition file "prep2.def"; --- list all symbols with their values. -@end example @end table @geindex -gnateD (gcc) @@ -5174,12 +5234,12 @@ Examples of valid lines in a preprocessor data file: @table @asis -@item @code{-gnateDsymbol[=value]} +@item @code{-gnateD@emph{symbol}[=@emph{new_value}]} -Define or redefine a preprocessing symbol, associated with value. If no value -is given on the command line, then the value of the symbol is @cite{True}. -A symbol is an identifier, following normal Ada (case-insensitive) -rules for its syntax, and value is either an arbitrary string between double +Define or redefine @emph{symbol} to have @emph{new_value} as its value. If no value +is supplied, then the value of @emph{symbol} is @cite{True}. +The form of @emph{symbol} is an identifier, following normal Ada (case-insensitive) +rules for its syntax, and @emph{new_value} is either an arbitrary string between double quotes or any sequence (including an empty sequence) of characters from the set (letters, digits, period, underline). Ada reserved words may be used as symbols, with the exceptions of @cite{if}, @@ -5187,23 +5247,28 @@ Ada reserved words may be used as symbols, with the exceptions of @cite{if}, Examples: +@quotation + @example --gnateDToto=Titi +-gnateDToto=Tata -gnateDFoo -gnateDFoo=\"Foo-Bar\" @end example +@end quotation A symbol declared with this switch on the command line replaces a symbol with the same name either in a definition file or specified with a -switch -D in the preprocessor data file. +switch @code{-D} in the preprocessor data file. -This switch is similar to switch @emph{-D} of @cite{gnatprep}. +This switch is similar to switch @code{-D} of @cite{gnatprep}. @item @code{-gnateG} -When integrated preprocessing is performed and the preprocessor modifies -the source text, write the result of this preprocessing into a file -.prep. +When integrated preprocessing is performed on source file @code{filename.extension}, +create or overwrite @code{filename.extension.prep} to contain +the result of the preprocessing. +For example if the source file is @code{foo.adb} then +the output file will be @code{foo.adb.prep}. @end table @node Mixed Language Programming,GNAT and Other Compilation Models,Conditional Compilation,The GNAT Compilation Model @@ -5281,7 +5346,7 @@ procedure My_Main is -- Declare an Ada procedure spec for Print_Num, then use -- C function print_num for the implementation. procedure Print_Num (Num : Integer); - pragma Import (C, Print_Num, "print_num"; + pragma Import (C, Print_Num, "print_num"); begin Print_Num (Get_Num); @@ -10765,6 +10830,9 @@ switch are: @item @code{-gnatw.h} (holes in record layouts) +@item +@code{-gnatw.j} (late primitives of tagged types) + @item @code{-gnatw.k} (redefinition of names in standard) @@ -11395,6 +11463,32 @@ Second, the restriction does flag uses of package @cite{ASCII}. This switch disables warnings on use of obsolescent features. @end table +@geindex -gnatw.j (gcc) + + +@table @asis + +@item @code{-gnatw.j} + +@emph{Activate warnings on late declarations of tagged type primitives.} + +This switch activates warnings on visible primitives added to a +tagged type after deriving a private extension from it. +@end table + +@geindex -gnatw.J (gcc) + + +@table @asis + +@item @code{-gnatw.J} + +@emph{Suppress warnings on late declarations of tagged type primitives.} + +This switch suppresses warnings on visible primitives added to a +tagged type after deriving a private extension from it. +@end table + @geindex -gnatwk (gcc) @@ -15029,7 +15123,7 @@ This chapter describes the GNAT binder, @cite{gnatbind}, which is used to bind compiled GNAT objects. Note: to invoke @cite{gnatbind} with a project file, use the @cite{gnat} -driver (see @emph{The_GNAT_Driver_and_Project_Files}). +driver (see The_GNAT_Driver_and_Project_Files). The @cite{gnatbind} program performs four separate functions: @@ -15286,7 +15380,7 @@ The secondary stack is used to deal with functions that return a variable sized result, for example a function returning an unconstrained String. There are two ways in which this secondary stack is allocated. -For most targets, the secondary stack is growing on demand and is allocated +For most targets, the secondary stack grows on demand and is allocated as a chain of blocks in the heap. The -D option is not very relevant. It only give some control over the size of the allocated blocks (whose size is the minimum of the default secondary stack size value, @@ -16346,7 +16440,7 @@ references for the Ada part of a program. It uses the binder file generated by the @emph{gnatbind} to determine this list. Note: to invoke @cite{gnatlink} with a project file, use the @cite{gnat} -driver (see @emph{The_GNAT_Driver_and_Project_Files}). +driver (see The_GNAT_Driver_and_Project_Files). @menu * Running gnatlink:: @@ -17222,7 +17316,7 @@ files. It can also be used to check the source dependencies of a unit as well as various characteristics. Note: to invoke @cite{gnatls} with a project file, use the @cite{gnat} -driver (see @emph{The_GNAT_Driver_and_Project_Files}). +driver (see The_GNAT_Driver_and_Project_Files). @menu * Running gnatls:: @@ -17606,12 +17700,12 @@ To use these tools, you must not compile your application using the information will not be generated. Note: to invoke @cite{gnatxref} or @cite{gnatfind} with a project file, -use the @cite{gnat} driver (see @emph{The_GNAT_Driver_and_Project_Files}). +use the @cite{gnat} driver (see The_GNAT_Driver_and_Project_Files). @menu * gnatxref Switches:: * gnatfind Switches:: -* Project Files for gnatxref and gnatfind:: +* Configuration Files for gnatxref and gnatfind:: * Regular Expressions in gnatfind and gnatxref:: * Examples of gnatxref Usage:: * Examples of gnatfind Usage:: @@ -17659,7 +17753,7 @@ The following switches are available for @emph{gnatxref}: @table @asis -@item @code{-version} +@item @code{--version} Display Copyright and version, then exit disregarding all other options. @end table @@ -17669,7 +17763,7 @@ Display Copyright and version, then exit disregarding all other options. @table @asis -@item @code{-help} +@item @code{--help} If @emph{--version} was not used, display usage, then exit disregarding all other options. @@ -17680,7 +17774,7 @@ all other options. @table @asis -@item @code{a} +@item @code{-a} If this switch is present, @cite{gnatfind} and @cite{gnatxref} will parse the read-only files found in the library search path. Otherwise, these files @@ -17695,7 +17789,7 @@ or permissions status in the file system for the current user. @table @asis -@item @code{aI@emph{DIR}} +@item @code{-aI@emph{DIR}} When looking for source files also look in directory DIR. The order in which source file search is undertaken is the same as for @emph{gnatmake}. @@ -17708,7 +17802,7 @@ source file search is undertaken is the same as for @emph{gnatmake}. @item @code{aO@emph{DIR}} -When searching for library and object files, look in directory +When -searching for library and object files, look in directory DIR. The order in which library files are searched is the same as for @emph{gnatmake}. @end table @@ -17718,7 +17812,7 @@ DIR. The order in which library files are searched is the same as for @table @asis -@item @code{nostdinc} +@item @code{-nostdinc} Do not look for sources in the system default directory. @end table @@ -17728,7 +17822,7 @@ Do not look for sources in the system default directory. @table @asis -@item @code{nostdlib} +@item @code{-nostdlib} Do not look for library files in the system default directory. @end table @@ -17738,7 +17832,7 @@ Do not look for library files in the system default directory. @table @asis -@item @code{-ext=@emph{extension}} +@item @code{--ext=@emph{extension}} Specify an alternate ali file extension. The default is @cite{ali} and other extensions (e.g. @cite{gli} for C/C++ sources when using @emph{-fdump-xref}) @@ -17751,7 +17845,7 @@ default, which means that only the new extension will be considered. @table @asis -@item @code{-RTS=@emph{rts-path}} +@item @code{--RTS=@emph{rts-path}} Specifies the default location of the runtime library. Same meaning as the equivalent @emph{gnatmake} flag (@ref{dc,,Switches for gnatmake}). @@ -17762,7 +17856,7 @@ equivalent @emph{gnatmake} flag (@ref{dc,,Switches for gnatmake}). @table @asis -@item @code{d} +@item @code{-d} If this switch is set @cite{gnatxref} will output the parent type reference for each matching derived types. @@ -17773,7 +17867,7 @@ reference for each matching derived types. @table @asis -@item @code{f} +@item @code{-f} If this switch is set, the output file names will be preceded by their directory (if the file was found in the search path). If this switch is @@ -17785,7 +17879,7 @@ not set, the directory will not be printed. @table @asis -@item @code{g} +@item @code{-g} If this switch is set, information is output only for library-level entities, ignoring local entities. The use of this switch may accelerate @@ -17797,7 +17891,7 @@ entities, ignoring local entities. The use of this switch may accelerate @table @asis -@item @code{I@emph{DIR}} +@item @code{-I@emph{DIR}} Equivalent to @code{-aODIR -aIDIR}. @end table @@ -17807,29 +17901,28 @@ Equivalent to @code{-aODIR -aIDIR}. @table @asis -@item @code{p@emph{FILE}} +@item @code{-p@emph{FILE}} -Specify a project file to use. +Specify a configuration file to use to list the source and object directories. -By default, @cite{gnatxref} and @cite{gnatfind} will try to locate a -project file in the current directory. +If a file is specified, then the content of the source directory and object +directory lines are added as if they had been specified respectively +by @code{-aI} and @code{-aO}. -If a project file is either specified or found by the tools, then the content -of the source directory and object directory lines are added as if they -had been specified respectively by @code{-aI} -and @code{-aO}. +See @ref{154,,Configuration Files for gnatxref and gnatfind} for the syntax +of this configuration file. -@item @code{u} +@item @code{-u} Output only unused symbols. This may be really useful if you give your main compilation unit on the command line, as @cite{gnatxref} will then display every unused entity and 'with'ed package. -@item @code{v} +@item @code{-v} Instead of producing the default output, @cite{gnatxref} will generate a @code{tags} file that can be used by vi. For examples how to use this -feature, see @ref{154,,Examples of gnatxref Usage}. The tags file is output +feature, see @ref{155,,Examples of gnatxref Usage}. The tags file is output to the standard output, thus you will have to redirect it to a file. @end table @@ -17837,8 +17930,8 @@ All these switches may be in any order on the command line, and may even appear after the file names. They need not be separated by spaces, thus you can say @code{gnatxref -ag} instead of @code{gnatxref -a -g}. -@node gnatfind Switches,Project Files for gnatxref and gnatfind,gnatxref Switches,The Cross-Referencing Tools gnatxref and gnatfind -@anchor{gnat_ugn/gnat_utility_programs id11}@anchor{155}@anchor{gnat_ugn/gnat_utility_programs gnatfind-switches}@anchor{156} +@node gnatfind Switches,Configuration Files for gnatxref and gnatfind,gnatxref Switches,The Cross-Referencing Tools gnatxref and gnatfind +@anchor{gnat_ugn/gnat_utility_programs id11}@anchor{156}@anchor{gnat_ugn/gnat_utility_programs gnatfind-switches}@anchor{157} @subsection @cite{gnatfind} Switches @@ -17860,7 +17953,7 @@ with the following iterpretation of the command arguments: @item @emph{pattern} An entity will be output only if it matches the regular expression found -in @cite{pattern}, see @ref{157,,Regular Expressions in gnatfind and gnatxref}. +in @cite{pattern}, see @ref{158,,Regular Expressions in gnatfind and gnatxref}. Omitting the pattern is equivalent to specifying @code{*}, which will match any entity. Note that if you do not provide a pattern, you @@ -17874,7 +17967,7 @@ for matching purposes. At the current time there is no support for @cite{gnatfind} will look for references, bodies or declarations of symbols referenced in @code{sourcefile}, at line @cite{line} -and column @cite{column}. See @ref{158,,Examples of gnatfind Usage} +and column @cite{column}. See @ref{159,,Examples of gnatfind Usage} for syntax examples. @item @emph{line} @@ -17928,7 +18021,7 @@ Display Copyright and version, then exit disregarding all other options. @table @asis -@item @code{-help} +@item @code{--help} If @emph{--version} was not used, display usage, then exit disregarding all other options. @@ -17939,7 +18032,7 @@ all other options. @table @asis -@item @code{a} +@item @code{-a} If this switch is present, @cite{gnatfind} and @cite{gnatxref} will parse the read-only files found in the library search path. Otherwise, these files @@ -17954,7 +18047,7 @@ or permission status in the file system for the current user. @table @asis -@item @code{aI@emph{DIR}} +@item @code{-aI@emph{DIR}} When looking for source files also look in directory DIR. The order in which source file search is undertaken is the same as for @emph{gnatmake}. @@ -17965,7 +18058,7 @@ source file search is undertaken is the same as for @emph{gnatmake}. @table @asis -@item @code{aO@emph{DIR}} +@item @code{-aO@emph{DIR}} When searching for library and object files, look in directory DIR. The order in which library files are searched is the same as for @@ -17977,7 +18070,7 @@ DIR. The order in which library files are searched is the same as for @table @asis -@item @code{nostdinc} +@item @code{-nostdinc} Do not look for sources in the system default directory. @end table @@ -17987,7 +18080,7 @@ Do not look for sources in the system default directory. @table @asis -@item @code{nostdlib} +@item @code{-nostdlib} Do not look for library files in the system default directory. @end table @@ -17997,7 +18090,7 @@ Do not look for library files in the system default directory. @table @asis -@item @code{-ext=@emph{extension}} +@item @code{--ext=@emph{extension}} Specify an alternate ali file extension. The default is @cite{ali} and other extensions (e.g. @cite{gli} for C/C++ sources when using @emph{-fdump-xref}) @@ -18010,7 +18103,7 @@ default, which means that only the new extension will be considered. @table @asis -@item @code{-RTS=@emph{rts-path}} +@item @code{--RTS=@emph{rts-path}} Specifies the default location of the runtime library. Same meaning as the equivalent @emph{gnatmake} flag (@ref{dc,,Switches for gnatmake}). @@ -18021,7 +18114,7 @@ equivalent @emph{gnatmake} flag (@ref{dc,,Switches for gnatmake}). @table @asis -@item @code{d} +@item @code{-d} If this switch is set, then @cite{gnatfind} will output the parent type reference for each matching derived types. @@ -18032,7 +18125,7 @@ reference for each matching derived types. @table @asis -@item @code{e} +@item @code{-e} By default, @cite{gnatfind} accept the simple regular expression set for @cite{pattern}. If this switch is set, then the pattern will be @@ -18044,7 +18137,7 @@ considered as full Unix-style regular expression. @table @asis -@item @code{f} +@item @code{-f} If this switch is set, the output file names will be preceded by their directory (if the file was found in the search path). If this switch is @@ -18056,7 +18149,7 @@ not set, the directory will not be printed. @table @asis -@item @code{g} +@item @code{-g} If this switch is set, information is output only for library-level entities, ignoring local entities. The use of this switch may accelerate @@ -18068,7 +18161,7 @@ entities, ignoring local entities. The use of this switch may accelerate @table @asis -@item @code{I@emph{DIR}} +@item @code{-I@emph{DIR}} Equivalent to @code{-aODIR -aIDIR}. @end table @@ -18078,16 +18171,16 @@ Equivalent to @code{-aODIR -aIDIR}. @table @asis -@item @code{p@emph{FILE}} +@item @code{-p@emph{FILE}} + +Specify a configuration file to use to list the source and object directories. -Specify a project file. -By default, @cite{gnatxref} and @cite{gnatfind} will try to locate a -project file in the current directory. +If a file is specified, then the content of the source directory and object +directory lines are added as if they had been specified respectively +by @code{-aI} and @code{-aO}. -If a project file is either specified or found by the tools, then the content -of the source directory and object directory lines are added as if they -had been specified respectively by @code{-aI} and -@code{-aO}. +See @ref{154,,Configuration Files for gnatxref and gnatfind} for the syntax +of this configuration file. @end table @geindex -r (gnatfind) @@ -18095,7 +18188,7 @@ had been specified respectively by @code{-aI} and @table @asis -@item @code{r} +@item @code{-r} By default, @cite{gnatfind} will output only the information about the declaration, body or type completion of the entities. If this switch is @@ -18109,7 +18202,7 @@ path if no file is given on the command line). @table @asis -@item @code{s} +@item @code{-s} If this switch is set, then @cite{gnatfind} will output the content of the Ada source file lines were the entity was found. @@ -18120,7 +18213,7 @@ of the Ada source file lines were the entity was found. @table @asis -@item @code{t} +@item @code{-t} If this switch is set, then @cite{gnatfind} will output the type hierarchy for the specified type. It act like -d option but recursively from parent @@ -18137,28 +18230,16 @@ As stated previously, gnatfind will search in every directory in the search path. You can force it to look only in the current directory if you specify @cite{*} at the end of the command line. -@node Project Files for gnatxref and gnatfind,Regular Expressions in gnatfind and gnatxref,gnatfind Switches,The Cross-Referencing Tools gnatxref and gnatfind -@anchor{gnat_ugn/gnat_utility_programs project-files-for-gnatxref-and-gnatfind}@anchor{159}@anchor{gnat_ugn/gnat_utility_programs id12}@anchor{15a} -@subsection Project Files for @emph{gnatxref} and @emph{gnatfind} +@node Configuration Files for gnatxref and gnatfind,Regular Expressions in gnatfind and gnatxref,gnatfind Switches,The Cross-Referencing Tools gnatxref and gnatfind +@anchor{gnat_ugn/gnat_utility_programs configuration-files-for-gnatxref-and-gnatfind}@anchor{154}@anchor{gnat_ugn/gnat_utility_programs id12}@anchor{15a} +@subsection Configuration Files for @emph{gnatxref} and @emph{gnatfind} -Project files allow a programmer to specify how to compile its -application, where to find sources, etc. These files are used -primarily by GPS, but they can also be used -by the two tools @cite{gnatxref} and @cite{gnatfind}. +Configuration files are used by @cite{gnatxref} and @cite{gnatfind} to specify +the list of source and object directories to consider. They can be +specified via the @code{-p} switch. -A project file name must end with @code{.gpr}. If a single one is -present in the current directory, then @cite{gnatxref} and @cite{gnatfind} will -extract the information from it. If multiple project files are found, none of -them is read, and you have to use the @code{-p} switch to specify the one -you want to use. - -The following lines can be included, even though most of them have default -values which can be used in most cases. -The lines can be entered in any order in the file. -Except for @code{src_dir} and @code{obj_dir}, you can only have one instance of -each line. If you have multiple instances, only the last one is taken into -account. +The following lines can be included, in any order in the file: @itemize * @@ -18186,100 +18267,12 @@ Specifies a directory where to look for object and library files. Multiple @cite{obj_dir} lines can be specified, and they will be searched in the order they are specified @end table - -@item - -@table @asis - -@item @emph{comp_opt=SWITCHES} - -[default: @cite{""}]. -Creates a variable which can be referred to subsequently by using -the @cite{$@{comp_opt@}} notation. This is intended to store the default -switches given to @emph{gnatmake} and @emph{gcc}. -@end table - -@item - -@table @asis - -@item @emph{bind_opt=SWITCHES} - -[default: @cite{""}]. -Creates a variable which can be referred to subsequently by using -the @code{$@emph{bind_opt}} notation. This is intended to store the default -switches given to @emph{gnatbind}. -@end table - -@item - -@table @asis - -@item @emph{link_opt=SWITCHES} - -[default: @cite{""}]. -Creates a variable which can be referred to subsequently by using -the @code{$@emph{link_opt}} notation. This is intended to store the default -switches given to @emph{gnatlink}. -@end table - -@item - -@table @asis - -@item @emph{main=EXECUTABLE} - -[default: @cite{""}]. -Specifies the name of the executable for the application. This variable can -be referred to in the following lines by using the @code{@emph{$@{main}} notation. -@end table - -@item - -@table @asis - -@item @emph{comp_cmd=COMMAND} - -[default: @cite{"gcc -c -I$@{src_dir@} -g -gnatq"}]. -Specifies the command used to compile a single file in the application. -@end table - -@item - -@table @asis - -@item @emph{make_cmd=COMMAND} - -[default: @cite{"gnatmake $@{main@} -aI$@{src_dir@} -aO$@{obj_dir@} -g -gnatq -cargs $@{comp_opt@} -bargs $@{bind_opt@} -largs $@{link_opt@}"}]. -Specifies the command used to recompile the whole application. -@end table - -@item - -@table @asis - -@item @emph{run_cmd=COMMAND} - -[default: @cite{"$@{main@}"}]. -Specifies the command used to run the application. -@end table - -@item - -@table @asis - -@item @emph{debug_cmd=COMMAND} - -[default: @cite{"gdb $@{main@}"}]. -Specifies the command used to debug the application -@end table @end itemize -@emph{gnatxref} and @emph{gnatfind} only take into account the -@cite{src_dir} and @cite{obj_dir} lines, and ignore the others. +Any other line will be silently ignored. -@node Regular Expressions in gnatfind and gnatxref,Examples of gnatxref Usage,Project Files for gnatxref and gnatfind,The Cross-Referencing Tools gnatxref and gnatfind -@anchor{gnat_ugn/gnat_utility_programs id13}@anchor{15b}@anchor{gnat_ugn/gnat_utility_programs regular-expressions-in-gnatfind-and-gnatxref}@anchor{157} +@node Regular Expressions in gnatfind and gnatxref,Examples of gnatxref Usage,Configuration Files for gnatxref and gnatfind,The Cross-Referencing Tools gnatxref and gnatfind +@anchor{gnat_ugn/gnat_utility_programs id13}@anchor{15b}@anchor{gnat_ugn/gnat_utility_programs regular-expressions-in-gnatfind-and-gnatxref}@anchor{158} @subsection Regular Expressions in @cite{gnatfind} and @cite{gnatxref} @@ -18372,7 +18365,7 @@ least one character. @end itemize @node Examples of gnatxref Usage,Examples of gnatfind Usage,Regular Expressions in gnatfind and gnatxref,The Cross-Referencing Tools gnatxref and gnatfind -@anchor{gnat_ugn/gnat_utility_programs examples-of-gnatxref-usage}@anchor{154}@anchor{gnat_ugn/gnat_utility_programs id14}@anchor{15c} +@anchor{gnat_ugn/gnat_utility_programs examples-of-gnatxref-usage}@anchor{155}@anchor{gnat_ugn/gnat_utility_programs id14}@anchor{15c} @subsection Examples of @cite{gnatxref} Usage @@ -18514,7 +18507,7 @@ From @emph{vi}, you can then use the command @code{:tag @emph{entity}} display a new file with the corresponding declaration of entity. @node Examples of gnatfind Usage,,Examples of gnatxref Usage,The Cross-Referencing Tools gnatxref and gnatfind -@anchor{gnat_ugn/gnat_utility_programs id15}@anchor{15f}@anchor{gnat_ugn/gnat_utility_programs examples-of-gnatfind-usage}@anchor{158} +@anchor{gnat_ugn/gnat_utility_programs id15}@anchor{15f}@anchor{gnat_ugn/gnat_utility_programs examples-of-gnatfind-usage}@anchor{159} @subsection Examples of @cite{gnatfind} Usage @@ -22485,12 +22478,12 @@ example: @quotation -@c code-block":: ada -@c -@c m : constant Length := 1.0; -@c kg : constant Mass := 1.0; -@c s : constant Time := 1.0; -@c A : constant Electric_Current := 1.0; +@example +m : constant Length := 1.0; +kg : constant Mass := 1.0; +s : constant Time := 1.0; +A : constant Electric_Current := 1.0; +@end example @end quotation as well as useful multiples of these units: @@ -23551,6 +23544,22 @@ you should use @cite{pragma Time_Slice} with a value greater than 0.0, or else use the corresponding @emph{-T} binder option. +To make sure a program is running as root, you can put something like +this in a library package body in your application: + +@quotation + +@example +function geteuid return Integer; +pragma Import (C, geteuid, "geteuid"); +Ignore : constant Boolean := + (if geteuid = 0 then True else raise Program_Error with "must be root"); +@end example +@end quotation + +It gets the effective user id, and if it's not 0 (i.e. root), it raises +Program_Error. + @geindex Solaris Sparc threads libraries @node Solaris-Specific Considerations,Solaris Threads Issues,Choosing the Scheduling Policy,Specifying a Run-Time Library @@ -25949,7 +25958,7 @@ $ gnatlink hello -Wl,--stack=0x1000000 This sets the stack reserve size to 0x1000000 bytes. Note that with @emph{-Wl} option it is not possible to set the stack commit size -because the coma is a separator for this option. +because the comma is a separator for this option. @end itemize @node Setting Heap Size from gnatlink,,Setting Stack Size from gnatlink,Mixed-Language Programming on Windows @@ -25982,7 +25991,7 @@ $ gnatlink hello -Wl,--heap=0x1000000 This sets the heap reserve size to 0x1000000 bytes. Note that with @emph{-Wl} option it is not possible to set the heap commit size -because the coma is a separator for this option. +because the comma is a separator for this option. @end itemize @node Windows Specific Add-Ons,,Mixed-Language Programming on Windows,Microsoft Windows Topics