1------------------------------------------------------------------------------
2--                                                                          --
3--                         GNAT COMPILER COMPONENTS                         --
4--                                                                          --
5--                                E I N F O                                 --
6--                                                                          --
7--                                 S p e c                                  --
8--                                                                          --
9--          Copyright (C) 1992-2013, Free Software Foundation, Inc.         --
10--                                                                          --
11-- GNAT is free software;  you can  redistribute it  and/or modify it under --
12-- terms of the  GNU General Public License as published  by the Free Soft- --
13-- ware  Foundation;  either version 3,  or (at your option) any later ver- --
14-- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
15-- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
16-- or FITNESS FOR A PARTICULAR PURPOSE.                                     --
17--                                                                          --
18-- As a special exception under Section 7 of GPL version 3, you are granted --
19-- additional permissions described in the GCC Runtime Library Exception,   --
20-- version 3.1, as published by the Free Software Foundation.               --
21--                                                                          --
22-- You should have received a copy of the GNU General Public License and    --
23-- a copy of the GCC Runtime Library Exception along with this program;     --
24-- see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see    --
25-- <http://www.gnu.org/licenses/>.                                          --
26--                                                                          --
27-- GNAT was originally developed  by the GNAT team at  New York University. --
28-- Extensive contributions were provided by Ada Core Technologies Inc.      --
29--                                                                          --
30------------------------------------------------------------------------------
31
32with Snames; use Snames;
33with Types;  use Types;
34with Uintp;  use Uintp;
35with Urealp; use Urealp;
36
37package Einfo is
38
39--  This package defines the annotations to the abstract syntax tree that
40--  are needed to support semantic processing of an Ada compilation.
41
42--  Note that after editing this spec and the corresponding body it is
43--  required to run ceinfo to check the consistentcy of spec and body.
44--  See ceinfo.adb for more information about the checks made.
45
46--  These annotations are for the most part attributes of declared entities,
47--  and they correspond to conventional symbol table information. Other
48--  attributes include sets of meanings for overloaded names, possible
49--  types for overloaded expressions, flags to indicate deferred constants,
50--  incomplete types, etc. These attributes are stored in available fields
51--  in tree nodes (i.e. fields not used by the parser, as defined by the
52--  Sinfo package specification), and accessed by means of a set of
53--  subprograms which define an abstract interface.
54
55--  There are two kinds of semantic information
56
57--    First, the tree nodes with the following Nkind values:
58
59--      N_Defining_Identifier
60--      N_Defining_Character_Literal
61--      N_Defining_Operator_Symbol
62
63--    are called Entities, and constitute the information that would often
64--    be stored separately in a symbol table. These nodes are all extended
65--    to provide extra space, and contain fields which depend on the entity
66--    kind, as defined by the contents of the Ekind field. The use of the
67--    Ekind field, and the associated fields in the entity, are defined
68--    in this package, as are the access functions to these fields.
69
70--    Second, in some cases semantic information is stored directly in other
71--    kinds of nodes, e.g. the Etype field, used to indicate the type of an
72--    expression. The access functions to these fields are defined in the
73--    Sinfo package, but their full documentation is to be found in
74--    the Einfo package specification.
75
76--  Declaration processing places information in the nodes of their defining
77--  identifiers. Name resolution places in all other occurrences of an
78--  identifier a pointer to the corresponding defining occurrence.
79
80--------------------------------
81-- The XEINFO Utility Program --
82--------------------------------
83
84--  XEINFO is a utility program which automatically produces a C header file,
85--  einfo.h from the spec and body of package Einfo. It reads the input
86--  files einfo.ads and einfo.adb and produces the output file einfo.h.
87--  XEINFO is run automatically by the build scripts when you do a full
88--  bootstrap.
89
90--  In order for this utility program to operate correctly, the form of the
91--  einfo.ads and einfo.adb files must meet certain requirements and be laid
92--  out in a specific manner.
93
94--  The general form of einfo.ads is as follows:
95
96--     type declaration for type Entity_Kind
97--     subtype declarations declaring subranges of Entity_Kind
98--     subtype declarations declaring synonyms for some standard types
99--     function specs for attributes
100--     procedure specs
101--     pragma Inline declarations
102
103--  This order must be observed. There are no restrictions on the procedures,
104--  since the C header file only includes functions (Gigi is not allowed to
105--  modify the generated tree). However, functions are required to have headers
106--  that fit on a single line.
107
108--  XEINFO reads and processes the function specs and the pragma Inlines. For
109--  functions that are declared as inlined, XEINFO reads the corresponding body
110--  from einfo.adb, and processes it into C code. This results in some strict
111--  restrictions on which functions can be inlined:
112
113--     The function spec must be on a single line
114
115--     There can only be a single statement, contained on a single line,
116--     not counting any pragma Assert statements.
117
118--     This single statement must either be a function call with simple,
119--     single token arguments, or it must be a membership test of the form
120--     a in b, where a and b are single tokens.
121
122--  For functions that are not inlined, there is no restriction on the body,
123--  and XEINFO generates a direct reference in the C header file which allows
124--  the C code in Gigi to directly call the corresponding Ada body.
125
126----------------------------------
127-- Handling of Type'Size Values --
128----------------------------------
129
130--  The Ada 95 RM contains some rather peculiar (to us) rules on the value
131--  of type'Size (see RM 13.3(55)). We have found that attempting to use
132--  these RM Size values generally, and in particular for determining the
133--  default size of objects, creates chaos, and major incompatibilities in
134--  existing code.
135
136--  We proceed as follows, for discrete and fixed-point subtypes, we have
137--  two separate sizes for each subtype:
138
139--    The Object_Size, which is used for determining the default size of
140--    objects and components. This size value can be referred to using the
141--    Object_Size attribute. The phrase "is used" here means that it is
142--    the basis of the determination of the size. The backend is free to
143--    pad this up if necessary for efficiency, e.g. an 8-bit stand-alone
144--    character might be stored in 32 bits on a machine with no efficient
145--    byte access instructions such as the Alpha.
146
147--    The default rules for the value of Object_Size for fixed-point and
148--    discrete types are as follows:
149
150--       The Object_Size for base subtypes reflect the natural hardware
151--       size in bits (see Ttypes and Cstand for integer types). For
152--       enumeration and fixed-point base subtypes have 8. 16. 32 or 64
153--       bits for this size, depending on the range of values to be stored.
154
155--       The Object_Size of a subtype is the same as the Object_Size of
156--       the subtype from which it is obtained.
157
158--       The Object_Size of a derived base type is copied from the parent
159--       base type, and the Object_Size of a derived first subtype is copied
160--       from the parent first subtype.
161
162--    The Value_Size which is the number of bits required to store a value
163--    of the type. This size can be referred to using the Value_Size
164--    attribute. This value is used to determine how tightly to pack
165--    records or arrays with components of this type, and also affects
166--    the semantics of unchecked conversion (unchecked conversions where
167--    the Value_Size values differ generate a warning, and are potentially
168--    target dependent).
169
170--    The default rule for the value of Value_Size are as follows:
171
172--       The Value_Size for a base subtype is the minimum number of bits
173--       required to store all values of the type (including the sign bit
174--       only if negative values are possible).
175
176--       If a subtype statically matches the first subtype, then it has
177--       by default the same Value_Size as the first subtype. This is a
178--       consequence of RM 13.1(14) ("if two subtypes statically match,
179--       then their subtype-specific aspects are the same".)
180
181--       All other subtypes have a Value_Size corresponding to the minimum
182--       number of bits required to store all values of the subtype. For
183--       dynamic bounds, it is assumed that the value can range down or up
184--       to the corresponding bound of the ancestor
185
186--    The RM defined attribute Size corresponds to the Value_Size attribute
187
188--    The Size attribute may be defined for a first-named subtype. This sets
189--    the Value_Size of the first-named subtype to the given value, and the
190--    Object_Size of this first-named subtype to the given value padded up
191--    to an appropriate boundary. It is a consequence of the default rules
192--    above that this Object_Size will apply to all further subtypes. On the
193--    other hand, Value_Size is affected only for the first subtype, any
194--    dynamic subtypes obtained from it directly, and any statically matching
195--    subtypes. The Value_Size of any other static subtypes is not affected.
196
197--    Value_Size and Object_Size may be explicitly set for any subtype using
198--    an attribute definition clause. Note that the use of these attributes
199--    can cause the RM 13.1(14) rule to be violated. If two access types
200--    reference aliased objects whose subtypes have differing Object_Size
201--    values as a result of explicit attribute definition clauses, then it
202--    is erroneous to convert from one access subtype to the other.
203
204--    At the implementation level, Esize stores the Object_Size and the
205--    RM_Size field stores the Value_Size (and hence the value of the
206--    Size attribute, which, as noted above, is equivalent to Value_Size).
207
208--  To get a feel for the difference, consider the following examples (note
209--  that in each case the base is short_short_integer with a size of 8):
210
211--                                            Object_Size     Value_Size
212
213--     type x1 is range 0..5;                      8               3
214
215--     type x2 is range 0..5;
216--     for x2'size use 12;                        16              12
217
218--     subtype x3 is x2 range 0 .. 3;             16               2
219
220--     subtype x4 is x2'base range 0 .. 10;        8               4
221
222--     subtype x5 is x2 range 0 .. dynamic;       16              (7)
223
224--     subtype x6 is x2'base range 0 .. dynamic;   8              (7)
225
226--  Note: the entries marked (7) are not actually specified by the Ada 95 RM,
227--  but it seems in the spirit of the RM rules to allocate the minimum number
228--  of bits known to be large enough to hold the given range of values.
229
230--  So far, so good, but GNAT has to obey the RM rules, so the question is
231--  under what conditions must the RM Size be used. The following is a list
232--  of the occasions on which the RM Size must be used:
233
234--    Component size for packed arrays or records
235--    Value of the attribute Size for a type
236--    Warning about sizes not matching for unchecked conversion
237
238--  The RM_Size field keeps track of the RM Size as needed in these
239--  three situations.
240
241--  For elementary types other than discrete and fixed-point types, the
242--  Object_Size and Value_Size are the same (and equivalent to the RM
243--  attribute Size). Only Size may be specified for such types.
244
245--  For composite types, Object_Size and Value_Size are computed from their
246--  respective value for the type of each element as well as the layout.
247
248--  All size attributes are stored as Uint values. Negative values are used to
249--  reference GCC expressions for the case of non-static sizes, as explained
250--  in Repinfo.
251
252--------------------------------------
253-- Delayed Freezing and Elaboration --
254--------------------------------------
255
256--  The flag Has_Delayed_Freeze indicates that an entity carries an explicit
257--  freeze node, which appears later in the expanded tree.
258
259--  a) The flag is used by the front-end to trigger expansion actions which
260--  include the generation of that freeze node. Typically this happens at the
261--  end of the current compilation unit, or before the first subprogram body is
262--  encountered in the current unit. See files freeze and exp_ch13 for details
263--  on the actions triggered by a freeze node, which include the construction
264--  of initialization procedures and dispatch tables.
265
266--  b) The presence of a freeze node on an entity is used by the backend to
267--  defer elaboration of the entity until its freeze node is seen. In the
268--  absence of an explicit freeze node, an entity is frozen (and elaborated)
269--  at the point of declaration.
270
271--  For object declarations, the flag is set when an address clause for the
272--  object is encountered. Legality checks on the address expression only take
273--  place at the freeze point of the object.
274
275--  Most types have an explicit freeze node, because they cannot be elaborated
276--  until all representation and operational items that apply to them have been
277--  analyzed. Private types and incomplete types have the flag set as well, as
278--  do task and protected types.
279
280--  Implicit base types created for type derivations, as well as classwide
281--  types created for all tagged types, have the flag set.
282
283--  If a subprogram has an access parameter whose designated type is incomplete
284--  the subprogram has the flag set.
285
286-----------------------
287-- Entity Attributes --
288-----------------------
289
290--  This section contains a complete list of the attributes that are defined
291--  on entities. Some attributes apply to all entities, others only to certain
292--  kinds of entities. In the latter case the attribute should only be set or
293--  accessed if the Ekind field indicates an appropriate entity.
294
295--  There are two kinds of attributes that apply to entities, stored and
296--  synthesized. Stored attributes correspond to a field or flag in the entity
297--  itself. Such attributes are identified in the table below by giving the
298--  field or flag in the attribute that is used to hold the attribute value.
299--  Synthesized attributes are not stored directly, but are rather computed as
300--  needed from other attributes, or from information in the tree. These are
301--  marked "synthesized" in the table below. The stored attributes have both
302--  access functions and set procedures to set the corresponding values, while
303--  synthesized attributes have only access functions.
304
305--  Note: in the case of Node, Uint, or Elist fields, there are cases where
306--  the same physical field is used for different purposes in different
307--  entities, so these access functions should only be referenced for the
308--  class of entities in which they are defined as being present. Flags are
309--  not overlapped in this way, but nevertheless as a matter of style and
310--  abstraction (which may or may not be checked by assertions in the body),
311--  this restriction should be observed for flag fields as well.
312
313--  Note: certain of the attributes on types apply only to base types, and
314--  are so noted by the notation [base type only]. These are cases where the
315--  attribute of any subtype is the same as the attribute of the base type.
316--  The attribute can be referenced on a subtype (and automatically retrieves
317--  the value from the base type). However, it is an error to try to set the
318--  attribute on other than the base type, and if assertions are enabled,
319--  an attempt to set the attribute on a subtype will raise an assert error.
320
321--  Other attributes are noted as applying to the [implementation base type
322--  only].  These are representation attributes which must always apply to a
323--  full non-private type, and where the attributes are always on the full
324--  type.  The attribute can be referenced on a subtype (and automatically
325--  retries the value from the implementation base type). However, it is an
326--  error to try to set the attribute on other than the implementation base
327--  type, and if assertions are enabled, an attempt to set the attribute on a
328--  subtype will raise an assert error.
329
330--    Abstract_States (Elist25)
331--       Defined for E_Package entities. Contains a list of all the abstract
332--       states declared by the related package.
333
334--    Accept_Address (Elist21)
335--       Defined in entries. If an accept has a statement sequence, then an
336--       address variable is created, which is used to hold the address of the
337--       parameters, as passed by the runtime. Accept_Address holds an element
338--       list which represents a stack of entities for these address variables.
339--       The current entry is the top of the stack, which is the last element
340--       on the list. A stack is required to handle the case of nested select
341--       statements referencing the same entry.
342
343--    Access_Disp_Table (Elist16) [implementation base type only]
344--       Defined in E_Record_Type and E_Record_Subtype entities. Set in tagged
345--       types to point to their dispatch tables. The first two entities are
346--       associated with the primary dispatch table: 1) primary dispatch table
347--       with user-defined primitives 2) primary dispatch table with predefined
348--       primitives. For each interface type covered by the tagged type we also
349--       have: 3) secondary dispatch table with thunks of primitives covering
350--       user-defined interface primitives, 4) secondary dispatch table with
351--       thunks of predefined primitives, 5) secondary dispatch table with user
352--       defined primitives, and 6) secondary dispatch table with predefined
353--       primitives. The last entity of this list is an access type declaration
354--       used to expand dispatching calls through the primary dispatch table.
355--       For a non-tagged record, contains No_Elist.
356
357--    Actual_Subtype (Node17)
358--       Defined in variables, constants, and formal parameters. This is the
359--       subtype imposed by the value of the object, as opposed to its nominal
360--       subtype, which is imposed by the declaration. The actual subtype
361--       differs from the nominal one when the latter is indefinite (as in the
362--       case of an unconstrained formal parameter, or a variable declared
363--       with an unconstrained type and an initial value). The nominal subtype
364--       is the Etype entry for the entity. The Actual_Subtype field is set
365--       only if the actual subtype differs from the nominal subtype. If the
366--       actual and nominal subtypes are the same, then the Actual_Subtype
367--       field is Empty, and Etype indicates both types.
368--
369--       For objects, the Actual_Subtype is set only if this is a discriminated
370--       type. For arrays, the bounds of the expression are obtained and the
371--       Etype of the object is directly the constrained subtype. This is
372--       rather irregular, and the semantic checks that depend on the nominal
373--       subtype being unconstrained use flag Is_Constr_Subt_For_U_Nominal(qv).
374
375--    Address_Clause (synthesized)
376--       Applies to entries, objects and subprograms. Set if an address clause
377--       is present which references the object or subprogram and points to
378--       the N_Attribute_Definition_Clause node. Empty if no Address clause.
379--       The expression in the address clause is always a constant that is
380--       defined before the entity to which the address clause applies.
381--       Note: Gigi references this field in E_Task_Type entities???
382
383--    Address_Taken (Flag104)
384--       Defined in all entities. Set if the Address or Unrestricted_Access
385--       attribute is applied directly to the entity, i.e. the entity is the
386--       entity of the prefix of the attribute reference. Also set if the
387--       entity is the second argument of an Asm_Input or Asm_Output attribute,
388--       as the construct may entail taking its address. Used by Gigi to make
389--       sure that the address can be meaningfully taken, and also in the case
390--       of subprograms to control output of certain warnings.
391
392--    Aft_Value (synthesized)
393--       Applies to fixed and decimal types. Computes a universal integer
394--       that holds value of the Aft attribute for the type.
395
396--    Alias (Node18)
397--       Defined in overloadable entities (literals, subprograms, entries) and
398--       subprograms that cover a primitive operation of an abstract interface
399--       (that is, subprograms with the Interface_Alias attribute). In case of
400--       overloaded entities it points to the parent subprogram of a derived
401--       subprogram. In case of abstract interface subprograms it points to the
402--       subprogram that covers the abstract interface primitive. Also used for
403--       a subprogram renaming, where it points to the renamed subprogram. For
404--       an inherited operation (of a type extension) that is overridden in a
405--       private part, the Alias is the overriding operation. In this fashion a
406--       call from outside the package ends up executing the new body even if
407--       non-dispatching, and a call from inside calls the overriding operation
408--       because it hides the implicit one. Alias is always empty for entries.
409
410--    Alignment (Uint14)
411--       Defined in entities for types and also in constants, variables
412--       (including exceptions where it refers to the static data allocated for
413--       an exception), loop parameters, and formal parameters. This indicates
414--       the desired alignment for a type, or the actual alignment for an
415--       object. A value of zero (Uint_0) indicates that the alignment has not
416--       been set yet. The alignment can be set by an explicit alignment
417--       clause, or set by the front-end in package Layout, or set by the
418--       back-end as part of the back end back-annotation process. The
419--       alignment field is also defined in E_Exception entities, but there it
420--       is used only by the back-end for back annotation.
421
422--    Alignment_Clause (synthesized)
423--       Applies to all entities for types and objects. If an alignment
424--       attribute definition clause is present for the entity, then this
425--       function returns the N_Attribute_Definition clause that specifies the
426--       alignment. If no alignment clause applies to the type, then the call
427--       to this function returns Empty. Note that the call can return a
428--       non-Empty value even if Has_Alignment_Clause is not set (happens with
429--       subtype and derived type declarations). Note also that a record
430--       definition clause with an (obsolescent) mod clause is converted
431--       into an attribute definition clause for this purpose.
432
433--    Associated_Formal_Package (Node12)
434--       Defined in packages that are the actuals of formal_packages. Points
435--       to the entity in the declaration for the formal package.
436
437--    Associated_Node_For_Itype (Node8)
438--       Defined in all type and subtype entities. Set non-Empty only for
439--       Itypes. Set to point to the associated node for the Itype, i.e.
440--       the node whose elaboration generated the Itype. This is used for
441--       copying trees, to determine whether or not to copy an Itype, and
442--       also for accessibility checks on anonymous access types. This
443--       node is typically an object declaration, component declaration,
444--       type or subtype declaration. For an access discriminant in a type
445--       declaration, the associated_node_for_itype is the discriminant
446--       specification. For an access parameter it is the enclosing subprogram
447--       declaration.
448--
449--       Itypes have no explicit declaration, and therefore are not attached to
450--       the tree: their Parent field is always empty. The Associated_Node_For_
451--       Itype is the only way to determine the construct that leads to the
452--       creation of a given itype entity.
453
454--    Associated_Storage_Pool (Node22) [root type only]
455--       Defined in simple and general access type entities. References the
456--       storage pool to be used for the corresponding collection. A value of
457--       Empty means that the default pool is to be used. This is defined
458--       only in the root type, since derived types must have the same pool
459--       as the parent type.
460
461--    Barrier_Function (Node12)
462--       Defined in protected entries and entry families. This is the
463--       subprogram declaration for the body of the function that returns
464--       the value of the entry barrier.
465
466--    Base_Type (synthesized)
467--       Applies to all type and subtype entities. Returns the base type of a
468--       type or subtype. The base type of a type is the type itself. The base
469--       type of a subtype is the type that it constrains (which is always
470--       a type entity, not some other subtype). Note that in the case of a
471--       subtype of a private type, it is possible for the base type attribute
472--       to return a private type, even if the subtype to which it applies is
473--       non-private. See also Implementation_Base_Type. Note: it is allowed to
474--       apply Base_Type to other than a type, in which case it simply returns
475--       the entity unchanged.
476
477--    Block_Node (Node11)
478--       Defined in block entities. Points to the identifier in the
479--       Block_Statement itself. Used when retrieving the block construct
480--       for finalization purposes, The block entity has an implicit label
481--       declaration in the enclosing declarative part, and has otherwise
482--       no direct connection in the tree with the block statement. The
483--       link is to the identifier (which is an occurrence of the entity)
484--       and not to the block_statement itself, because the statement may
485--       be rewritten, e.g. in the process of removing dead code.
486
487--    Body_Entity (Node19)
488--       Defined in package and generic package entities, points to the
489--       corresponding package body entity if one is present.
490
491--    Body_Needed_For_SAL (Flag40)
492--       Defined in package and subprogram entities that are compilation
493--       units. Indicates that the source for the body must be included
494--       when the unit is part of a standalone library.
495
496--    Body_References (Elist16)
497--       Defined in abstract state entities. Contains an element list of
498--       references (identifiers) that appear in a package body whose spec
499--       defines the related state. If the body refines the said state, all
500--       references on this list are illegal due to the visible refinement.
501
502--    BIP_Initialization_Call (Node29)
503--       Defined in constants and variables whose corresponding declaration
504--       is wrapped in a transient block and the inital value is provided by
505--       a build-in-place function call. Contains the relocated build-in-place
506--       call after the expansion has decoupled the call from the object. This
507--       attribute is used by the finalization machinery to insert cleanup code
508--       for all additional transient variables found in the transient block.
509
510--    C_Pass_By_Copy (Flag125) [implementation base type only]
511--       Defined in record types. Set if a pragma Convention for the record
512--       type specifies convention C_Pass_By_Copy. This convention name is
513--       treated as identical in all respects to convention C, except that
514--       if it is specified for a record type, then the C_Pass_By_Copy flag
515--       is set, and if a foreign convention subprogram has a formal of the
516--       corresponding type, then the parameter passing mechanism will be
517--       set to By_Copy (unless specifically overridden by an Import or
518--       Export pragma).
519
520--    Can_Never_Be_Null (Flag38)
521--       This flag is defined in all entities, but can only be set in an object
522--       which can never have a null value. Set for constant access values
523--       initialized to a non-null value. This is also set for all access
524--       parameters in Ada 83 and Ada 95 modes, and for access parameters
525--       that explicitly exclude null in Ada 2005.
526--
527--       This is used to avoid unnecessary resetting of the Is_Known_Non_Null
528--       flag for such entities. In Ada 2005 mode, this is also used when
529--       determining subtype conformance of subprogram profiles to ensure
530--       that two formals have the same null-exclusion status.
531--
532--       ??? This is also set on some access types, eg the Etype of the
533--       anonymous access type of a controlling formal.
534
535--    Can_Use_Internal_Rep (Flag229) [base type only]
536--       Defined in Access_Subprogram_Kind nodes. This flag is set by the
537--       front end and used by the back end. False means that the back end
538--       must represent the type in the same way as Convention-C types (and
539--       other foreign-convention types). On many targets, this means that
540--       the back end will use dynamically generated trampolines for nested
541--       subprograms. True means that the back end can represent the type in
542--       some internal way. On the aforementioned targets, this means that the
543--       back end will not use dynamically generated trampolines. This flag
544--       must be False if Has_Foreign_Convention is True; otherwise, the front
545--       end is free to set the policy.
546--
547--       Setting this False in all cases corresponds to the traditional back
548--       end strategy, where all access-to-subprogram types are represented the
549--       same way, independent of the Convention. For further details, see also
550--       Always_Compatible_Rep in Targparm.
551--
552--       Efficiency note: On targets that use dynamically generated
553--       trampolines, False generally favors efficiency of top-level
554--       subprograms, whereas True generally favors efficiency of nested
555--       ones. On other targets, this flag has little or no effect on
556--       efficiency. The front end should take this into account. In
557--       particular, pragma Favor_Top_Level gives a hint that the flag
558--       should be False.
559--
560--       Note: We considered using Convention-C for this purpose, but we need
561--       this separate flag, because Convention-C implies that in the case of
562--       P'[Unrestricted_]Access, P also have convention C. Sometimes we want
563--       to have Can_Use_Internal_Rep False for an access type, but allow P to
564--       have convention Ada.
565
566--    Chars (Name1)
567--       Defined in all entities. This field contains an entry into the names
568--       table that has the character string of the identifier, character
569--       literal or operator symbol. See Namet for further details. Note that
570--       throughout the processing of the front end, this name is the simple
571--       unqualified name. However, just before gigi is called, a call is made
572--       to Qualify_All_Entity_Names. This causes entity names to be qualified
573--       using the encoding described in exp_dbug.ads, and from that point on
574--       (including post gigi steps such as cross-reference generation), the
575--       entities will contain the encoded qualified names.
576
577--    Checks_May_Be_Suppressed (Flag31)
578--       Defined in all entities. Set if a pragma Suppress or Unsuppress
579--       mentions the entity specifically in the second argument. If this
580--       flag is set the Global_Entity_Suppress and Local_Entity_Suppress
581--       tables must be consulted to determine if there actually is an active
582--       Suppress or Unsuppress pragma that applies to the entity.
583
584--    Class_Wide_Type (Node9)
585--       Defined in all type entities. For a tagged type or subtype, returns
586--       the corresponding implicitly declared class-wide type. For a
587--       class-wide type, returns itself. Set to Empty for non-tagged types.
588
589--    Cloned_Subtype (Node16)
590--       Defined in E_Record_Subtype and E_Class_Wide_Subtype entities.
591--       Each such entity can either have a Discriminant_Constraint, in
592--       which case it represents a distinct type from the base type (and
593--       will have a list of components and discrimants in the list headed by
594--       First_Entity) or else no such constraint, in which case it will be a
595--       copy of the base type.
596--
597--       o  Each element of the list in First_Entity is copied from the base
598--          type; in that case, this field is Empty.
599--
600--       o  The list in First_Entity is shared with the base type; in that
601--          case, this field points to that entity.
602--
603--       A record or classwide subtype may also be a copy of some other
604--       subtype and share the entities in the First_Entity with that subtype.
605--       In that case, this field points to that subtype.
606--
607--       For E_Class_Wide_Subtype, the presence of Equivalent_Type overrides
608--       this field. Note that this field ONLY appears in subtype entries, not
609--       in type entries, it is not defined, and it is an error to reference
610--       Cloned_Subtype in an E_Record_Type or E_Class_Wide_Type entity.
611
612--    Comes_From_Source
613--       This flag appears on all nodes, including entities, and indicates
614--       that the node was created by the scanner or parser from the original
615--       source. Thus for entities, it indicates that the entity is defined
616--       in the original source program.
617
618--    Component_Alignment (special field) [base type only]
619--       Defined in array and record entities. Contains a value of type
620--       Component_Alignment_Kind indicating the alignment of components.
621--       Set to Calign_Default normally, but can be overridden by use of
622--       the Component_Alignment pragma. Note: this field is currently
623--       stored in a non-standard way, see body for details.
624
625--    Component_Bit_Offset (Uint11)
626--       Defined in record components (E_Component, E_Discriminant) if a
627--       component clause applies to the component. First bit position of
628--       given component, computed from the first bit and position values
629--       given in the component clause. A value of No_Uint means that the
630--       value is not yet known. The value can be set by the appearance of
631--       an explicit component clause in a record representation clause,
632--       or it can be set by the front-end in package Layout, or it can be
633--       set by the backend. By the time backend processing is completed,
634--       this field is always set. A negative value is used to represent
635--       a value which is not known at compile time, and must be computed
636--       at run-time (this happens if fields of a record have variable
637--       lengths). See package Layout for details of these values.
638--
639--       Note: Component_Bit_Offset is redundant with respect to the fields
640--       Normalized_First_Bit and Normalized_Position, and could in principle
641--       be eliminated, but it is convenient in several situations, including
642--       use in Gigi, to have this redundant field.
643
644--    Component_Clause (Node13)
645--       Defined in record components and discriminants. If a record
646--       representation clause is present for the corresponding record type a
647--       that specifies a position for the component, then the Component_Clause
648--       field of the E_Component entity points to the N_Component_Clause node.
649--       Set to Empty if no record representation clause was present, or if
650--       there was no specification for this component.
651
652--    Component_Size (Uint22) [implementation base type only]
653--       Defined in array types. It contains the component size value for
654--       the array. A value of No_Uint means that the value is not yet set.
655--       The value can be set by the use of a component size clause, or
656--       by the front end in package Layout, or by the backend. A negative
657--       value is used to represent a value which is not known at compile
658--       time, and must be computed at run-time (this happens if the type
659--       of the component has a variable length size). See package Layout
660--       for details of these values.
661
662--    Component_Type (Node20) [implementation base type only]
663--       Defined in array types and string types. References component type.
664
665--    Corresponding_Concurrent_Type (Node18)
666--       Defined in record types that are constructed by the expander to
667--       represent task and protected types (Is_Concurrent_Record_Type flag
668--       set). Points to the entity for the corresponding task type or the
669--       protected type.
670
671--    Corresponding_Discriminant (Node19)
672--       Defined in discriminants of a derived type, when the discriminant is
673--       used to constrain a discriminant of the parent type. Points to the
674--       corresponding discriminant in the parent type. Otherwise it is Empty.
675
676--    Corresponding_Equality (Node30)
677--       Defined in function entities for implicit inequality operators.
678--       Denotes the explicit or derived equality operation that creates
679--       the implicit inequality. Note that this field is not present in
680--       other function entities, only in implicit inequality routines,
681--       where Comes_From_Source is always False.
682
683--    Corresponding_Protected_Entry (Node18)
684--       Defined in subprogram bodies. Set for subprogram bodies that implement
685--       a protected type entry to point to the entity for the entry.
686
687--    Corresponding_Record_Type (Node18)
688--       Defined in protected and task types and subtypes. References the
689--       entity for the corresponding record type constructed by the expander
690--       (see Exp_Ch9). This type is used to represent values of the task type.
691
692--    Corresponding_Remote_Type (Node22)
693--       Defined in record types that describe the fat pointer structure for
694--       Remote_Access_To_Subprogram types. References the original access
695--       to subprogram type.
696
697--    CR_Discriminant (Node23)
698--       Defined in discriminants of concurrent types. Denotes the homologous
699--       discriminant of the corresponding record type. The CR_Discriminant is
700--       created at the same time as the discriminal, and used to replace
701--       occurrences of the discriminant within the type declaration.
702
703--    Current_Use_Clause (Node27)
704--       Defined in packages and in types. For packages, denotes the use
705--       package clause currently in scope that makes the package use_visible.
706--       For types, it denotes the use_type clause that makes the operators of
707--       the type visible. Used for more precise warning messages on redundant
708--       use clauses.
709
710--    Current_Value (Node9)
711--       Defined in all object entities. Set in E_Variable, E_Constant, formal
712--       parameters and E_Loop_Parameter entities if we have trackable current
713--       values. Set non-Empty if the (constant) current value of the variable
714--       is known, This value is valid only for references from the same
715--       sequential scope as the entity. The sequential scope of an entity
716--       includes the immediate scope and any contained scopes that are package
717--       specs, package bodies, blocks (at any nesting level) or statement
718--       sequences in IF or loop statements.
719--
720--       Another related use of this field is to record information about the
721--       value obtained from an IF or WHILE statement condition. If the IF or
722--       ELSIF or WHILE condition has the form "NOT {,NOT] OBJ RELOP VAL ",
723--       or OBJ [AND [THEN]] expr, where OBJ refers to an entity with a
724--       Current_Value field, RELOP is one of the six relational operators, and
725--       VAL is a compile-time known value then the Current_Value field of OBJ
726--       points to the N_If_Statement, N_Elsif_Part, or N_Iteration_Scheme node
727--       of the relevant construct, and the Condition field of this can be
728--       consulted to give information about the value of OBJ. For more details
729--       on this usage, see the procedure Exp_Util.Get_Current_Value_Condition.
730
731--    Debug_Info_Off (Flag166)
732--       Defined in all entities. Set if a pragma Suppress_Debug_Info applies
733--       to the entity, or if internal processing in the compiler determines
734--       that suppression of debug information is desirable. Note that this
735--       flag is only for use by the front end as part of the processing for
736--       determining if Needs_Debug_Info should be set. The back end should
737--       always test Needs_Debug_Info, it should never test Debug_Info_Off.
738
739--    Debug_Renaming_Link (Node25)
740--       Used to link the variable associated with a debug renaming declaration
741--       to the renamed entity. See Exp_Dbug.Debug_Renaming_Declaration for
742--       details of the use of this field.
743
744--    Declaration_Node (synthesized)
745--       Applies to all entities. Returns the tree node for the construct that
746--       declared the entity. Normally this is just the Parent of the entity.
747--       One exception arises with child units, where the parent of the entity
748--       is a selected component/defining program unit name. Another exception
749--       is that if the entity is an incomplete type that has been completed or
750--       a private type, then we obtain the declaration node denoted by the
751--       full type, i.e. the full type declaration node. Also note that for
752--       subprograms, this returns the {function,procedure}_specification, not
753--       the subprogram_declaration.
754
755--    Default_Aspect_Component_Value (Node19) [base type only]
756--       Defined in array types. Holds the static value specified in a
757--       Default_Component_Value aspect specification for the array type.
758
759--    Default_Aspect_Value (Node19) [base type only]
760--       Defined in scalar types. Holds the static value specified in a
761--       Default_Value aspect specification for the type.
762
763--    Default_Expr_Function (Node21)
764--       Defined in parameters. It holds the entity of the parameterless
765--       function that is built to evaluate the default expression if it is
766--       more complex than a simple identifier or literal. For the latter
767--       simple cases or if there is no default value, this field is Empty.
768
769--    Default_Expressions_Processed (Flag108)
770--       A flag in subprograms (functions, operators, procedures) and in
771--       entries and entry families used to indicate that default expressions
772--       have been processed and to avoid multiple calls to process the
773--       default expressions (see Freeze.Process_Default_Expressions), which
774--       would not only waste time, but also generate false error messages.
775
776--    Default_Value (Node20)
777--       Defined in formal parameters. Points to the node representing the
778--       expression for the default value for the parameter. Empty if the
779--       parameter has no default value (which is always the case for OUT
780--       and IN OUT parameters in the absence of errors).
781
782--    Delay_Cleanups (Flag114)
783--       Defined in entities that have finalization lists (subprograms
784--       blocks, and tasks). Set if there are pending generic body
785--       instantiations for the corresponding entity. If this flag is
786--       set, then generation of cleanup actions for the corresponding
787--       entity must be delayed, since the insertion of the generic body
788--       may affect cleanup generation (see Inline for further details).
789
790--    Delay_Subprogram_Descriptors (Flag50)
791--       Defined in entities for which exception subprogram descriptors
792--       are generated (subprograms, package declarations and package
793--       bodies). Defined if there are pending generic body instantiations
794--       for the corresponding entity. If this flag is set, then generation
795--       of the subprogram descriptor for the corresponding enities must
796--       be delayed, since the insertion of the generic body may add entries
797--       to the list of handlers.
798--
799--       Note: for subprograms, Delay_Subprogram_Descriptors is set if and
800--       only if Delay_Cleanups is set. But Delay_Cleanups can be set for a
801--       a block (in which case Delay_Subprogram_Descriptors is set for the
802--       containing subprogram). In addition Delay_Subprogram_Descriptors is
803--       set for a library level package declaration or body which contains
804--       delayed instantiations (in this case the descriptor refers to the
805--       enclosing elaboration procedure).
806
807--    Delta_Value (Ureal18)
808--       Defined in fixed and decimal types. Points to a universal real
809--       that holds value of delta for the type, as given in the declaration
810--       or as inherited by a subtype or derived type.
811
812--    Dependent_Instances (Elist8)
813--       Defined in packages that are instances. Holds list of instances
814--       of inner generics. Used to place freeze nodes for those instances
815--       after that of the current one, i.e. after the corresponding generic
816--       bodies.
817
818--    Depends_On_Private (Flag14)
819--       Defined in all type entities. Set if the type is private or if it
820--       depends on a private type.
821
822--    Designated_Type (synthesized)
823--       Applies to access types. Returns the designated type. Differs from
824--       Directly_Designated_Type in that if the access type refers to an
825--       incomplete type, and the full type is available, then this full type
826--       is returned instead of the incomplete type.
827
828--    Digits_Value (Uint17)
829--       Defined in floating point types and subtypes and decimal types and
830--       subtypes. Contains the Digits value specified in the declaration.
831
832--    Direct_Primitive_Operations (Elist10)
833--       Defined in tagged types and subtypes (including synchronized types),
834--       in tagged private types and in tagged incomplete types. Element list
835--       of entities for primitive operations of the tagged type. Not defined
836--       in untagged types. In order to follow the C++ ABI, entities of
837--       primitives that come from source must be stored in this list in the
838--       order of their occurrence in the sources. For incomplete types the
839--       list is always empty.
840
841--    Directly_Designated_Type (Node20)
842--       Defined in access types. This field points to the type that is
843--       directly designated by the access type. In the case of an access
844--       type to an incomplete type, this field references the incomplete
845--       type. Directly_Designated_Type is typically used in implementing the
846--       static semantics of the language; in implementing dynamic semantics,
847--       we typically want the full view of the designated type. The function
848--       Designated_Type obtains this full type in the case of access to an
849--       incomplete type.
850
851--    Discard_Names (Flag88)
852--       Defined in types and exception entities. Set if pragma Discard_Names
853--       applies to the entity. It is also set for declarative regions and
854--       package specs for which a Discard_Names pragma with zero arguments
855--       has been encountered. The purpose of setting this flag is to be able
856--       to set the Discard_Names attribute on enumeration types declared
857--       after the pragma within the same declarative region. This flag is
858--       set to False if a Keep_Names pragma appears for an enumeration type.
859
860--    Discriminal (Node17)
861--       Defined in discriminants (Discriminant formal: GNAT's first
862--       coinage). The entity used as a formal parameter that corresponds
863--       to a discriminant. See section "Handling of Discriminants" for
864--       full details of the use of discriminals.
865
866--    Discriminal_Link (Node10)
867--       Defined in E_In_Parameter or E_Constant entities. For discriminals,
868--       points back to corresponding discriminant. For other entities, must
869--       remain Empty.
870
871--    Discriminant_Checking_Func (Node20)
872--       Defined in components. Points to the defining identifier of the
873--       function built by the expander returns a Boolean indicating whether
874--       the given record component exists for the current discriminant
875--       values.
876
877--    Discriminant_Constraint (Elist21)
878--       Defined in entities whose Has_Discriminants flag is set (concurrent
879--       types, subtypes, record types and subtypes, private types and
880--       subtypes, limited private types and subtypes and incomplete types).
881--       It is an error to reference the Discriminant_Constraint field if
882--       Has_Discriminants is False.
883--
884--       If the Is_Constrained flag is set, Discriminant_Constraint points
885--       to an element list containing the discriminant constraints in the
886--       same order in which the discriminants are declared.
887--
888--       If the Is_Constrained flag is not set but the discriminants of the
889--       unconstrained type have default initial values then this field
890--       points to an element list giving these default initial values in
891--       the same order in which the discriminants are declared. Note that
892--       in this case the entity cannot be a tagged record type, because
893--       discriminants in this case cannot have defaults.
894--
895--       If the entity is a tagged record implicit type, then this field is
896--       inherited from the first subtype (so that the itype is subtype
897--       conformant with its first subtype, which is needed when the first
898--       subtype overrides primitive operations inherited by the implicit
899--       base type).
900--
901--       In all other cases Discriminant_Constraint contains the empty
902--       Elist (ie it is initialized with a call to New_Elmt_List).
903
904--    Discriminant_Default_Value (Node20)
905--       Defined in discriminants. Points to the node representing the
906--       expression for the default value of the discriminant. Set to
907--       Empty if the discriminant has no default value.
908
909--    Discriminant_Number (Uint15)
910--       Defined in discriminants. Gives the ranking of a discriminant in
911--       the list of discriminants of the type, i.e. a sequential integer
912--       index starting at 1 and ranging up to number of discriminants.
913
914--    Dispatch_Table_Wrappers (Elist26) [implementation base type only]
915--       Defined in E_Record_Type and E_Record_Subtype entities. Set in library
916--       level tagged type entities if we are generating statically allocated
917--       dispatch tables. Points to the list of dispatch table wrappers
918--       associated with the tagged type. For a non-tagged record, contains
919--       No_Elist.
920
921--    DTC_Entity (Node16)
922--       Defined in function and procedure entities. Set to Empty unless
923--       the subprogram is dispatching in which case it references the
924--       Dispatch Table pointer Component. For regular Ada tagged this, this
925--       is the _Tag component. For CPP_Class types and their descendants,
926--       this points to the component entity in the record that holds the
927--       Vtable pointer for the Vtable containing the entry referencing the
928--       subprogram.
929
930--    DT_Entry_Count (Uint15)
931--       Defined in E_Component entities. Only used for component marked
932--       Is_Tag. Store the number of entries in the Vtable (or Dispatch Table)
933
934--    DT_Offset_To_Top_Func (Node25)
935--       Defined in E_Component entities. Only used for component marked
936--       Is_Tag. If present it stores the Offset_To_Top function used to
937--       provide this value in tagged types whose ancestor has discriminants.
938
939--    DT_Position (Uint15)
940--       Defined in function and procedure entities which are dispatching
941--       (should not be referenced without first checking that flag
942--       Is_Dispatching_Operation is True). Contains the offset into
943--       the Vtable for the entry that references the subprogram.
944
945--    Ekind (Ekind)
946--       Defined in all entities. Contains a value of the enumeration type
947--       Entity_Kind declared in a subsequent section in this spec.
948
949--    Elaborate_Body_Desirable (Flag210)
950--       Defined in package entities. Set if the elaboration circuitry detects
951--       a case where there is a package body that modifies one or more visible
952--       entities in the package spec and there is no explicit Elaborate_Body
953--       pragma for the package. This information is passed on to the binder,
954--       which attempts, but does not promise, to elaborate the body as close
955--       to the spec as possible.
956
957--    Elaboration_Entity (Node13)
958--       Defined in generic and non-generic package and subprogram entities.
959--       This is a counter associated with the unit that is initially set to
960--       zero, is incremented when an elaboration request for the unit is
961--       made, and is decremented when a finalization request for the unit
962--       is made. This is used for three purposes. First, it is used to
963--       implement access before elaboration checks (the counter must be
964--       non-zero to call a subprogram at elaboration time). Second, it is
965--       used to guard against repeated execution of the elaboration code.
966--       Third, it is used to ensure that the finalization code is executed
967--       only after all clients have requested it.
968--
969--       Note that we always allocate this counter, and set this field, but
970--       we do not always actually use it. It is only used if it is needed
971--       for access before elaboration use (see Elaboration_Entity_Required
972--       flag) or if either the spec or the body has elaboration code. If
973--       neither of these two conditions holds, then the entity is still
974--       allocated (since we don't know early enough whether or not there
975--       is elaboration code), but is simply not used for any purpose.
976
977--    Elaboration_Entity_Required (Flag174)
978--       Defined in generic and non-generic package and subprogram entities.
979--       Set only if Elaboration_Entity is non-Empty to indicate that the
980--       counter is required to be non-zero even if there is no other
981--       elaboration code. This occurs when the Elaboration_Entity counter
982--       is used for access before elaboration checks. If the counter is
983--       only used to prevent multiple execution of the elaboration code,
984--       then if there is no other elaboration code, obviously there is no
985--       need to set the flag.
986
987--    Encapsulating_State (Node10)
988--       Defined in abstract states and variables. Contains the entity of an
989--       ancestor state whose refinement utilizes this item as a constituent.
990
991--    Enclosing_Scope (Node18)
992--       Defined in labels. Denotes the innermost enclosing construct that
993--       contains the label. Identical to the scope of the label, except for
994--       labels declared in the body of an accept statement, in which case the
995--       entry_name is the Enclosing_Scope. Used to validate goto's within
996--       accept statements.
997
998--    Entry_Accepted (Flag152)
999--       Defined in E_Entry and E_Entry_Family entities. Set if there is
1000--       at least one accept for this entry in the task body. Used to
1001--       generate warnings for missing accepts.
1002
1003--    Entry_Bodies_Array (Node15)
1004--       Defined in protected types for which Has_Entries is true.
1005--       This is the defining identifier for the array of entry body
1006--       action procedures and barrier functions used by the runtime to
1007--       execute the user code associated with each entry.
1008
1009--    Entry_Cancel_Parameter (Node23)
1010--       Defined in blocks. This only applies to a block statement for
1011--       which the Is_Asynchronous_Call_Block flag is set. It
1012--       contains the defining identifier of an object that must be
1013--       passed to the Cancel_Task_Entry_Call or Cancel_Protected_Entry_Call
1014--       call in the cleanup handler added to the block by
1015--       Exp_Ch7.Expand_Cleanup_Actions. This parameter is a Boolean
1016--       object for task entry calls and a Communications_Block object
1017--       in the case of protected entry calls. In both cases the objects
1018--       are declared in outer scopes to this block.
1019
1020--    Entry_Component (Node11)
1021--       Defined in formal parameters (in, in out and out parameters). Used
1022--       only for formals of entries. References the corresponding component
1023--       of the entry parameter record for the entry.
1024
1025--    Entry_Formal (Node16)
1026--       Defined in components of the record built to correspond to entry
1027--       parameters. This field points from the component to the formal. It
1028--       is the back pointer corresponding to Entry_Component.
1029
1030--    Entry_Index_Constant (Node18)
1031--       Defined in an entry index parameter. This is an identifier that
1032--       eventually becomes the name of a constant representing the index
1033--       of the entry family member whose entry body is being executed. Used
1034--       to expand references to the entry index specification identifier.
1035
1036--    Entry_Index_Type (synthesized)
1037--       Applies to an entry family. Denotes Etype of the subtype indication
1038--       in the entry declaration. Used to resolve the index expression in an
1039--       accept statement for a member of the family, and in the prefix of
1040--       'COUNT when it applies to a family member.
1041
1042--    Contract (Node34)
1043--       Defined in entry, entry family, package, package body, subprogram and
1044--       subprogram body entities as well as their respective generic forms. A
1045--       contract is also applicable to a variable. Points to the contract of
1046--       the entity, holding various assertion items and data classifiers.
1047
1048--    Entry_Parameters_Type (Node15)
1049--       Defined in entries. Points to the access-to-record type that is
1050--       constructed by the expander to hold a reference to the parameter
1051--       values. This reference is manipulated (as an address) by the
1052--       tasking runtime. The designated record represents a packaging
1053--       up of the entry parameters (see Exp_Ch9.Expand_N_Entry_Declaration
1054--       for further details). Entry_Parameters_Type is Empty if the entry
1055--       has no parameters.
1056
1057--    Enumeration_Pos (Uint11)
1058--       Defined in enumeration literals. Contains the position number
1059--       corresponding to the value of the enumeration literal.
1060
1061--    Enumeration_Rep (Uint12)
1062--       Defined in enumeration literals. Contains the representation that
1063--       corresponds to the value of the enumeration literal. Note that
1064--       this is normally the same as Enumeration_Pos except in the presence
1065--       of representation clauses, where Pos will still represent the
1066--       position of the literal within the type and Rep will have be the
1067--       value given in the representation clause.
1068
1069--    Enumeration_Rep_Expr (Node22)
1070--       Defined in enumeration literals. Points to the expression in an
1071--       associated enumeration rep clause that provides the representation
1072--       value for this literal. Empty if no enumeration rep clause for this
1073--       literal (or if rep clause does not have an entry for this literal,
1074--       an error situation). This is also used to catch duplicate entries
1075--       for the same literal.
1076
1077--    Enum_Pos_To_Rep (Node23)
1078--       Defined in enumeration types (but not enumeration subtypes). Set to
1079--       Empty unless the enumeration type has a non-standard representation
1080--       (i.e. at least one literal has a representation value different from
1081--       its pos value). In this case, Enum_Pos_To_Rep is the entity for an
1082--       array constructed when the type is frozen that maps Pos values to
1083--       corresponding Rep values. The index type of this array is Natural,
1084--       and the component type is a suitable integer type that holds the
1085--       full range of representation values.
1086
1087--    Equivalent_Type (Node18)
1088--       Defined in class wide types and subtypes, access to protected
1089--       subprogram types, and in exception types. For a classwide type, it
1090--       is always Empty. For a class wide subtype, it points to an entity
1091--       created by the expander which gives Gigi an easily understandable
1092--       equivalent of the class subtype with a known size (given by an
1093--       initial value). See Exp_Util.Expand_Class_Wide_Subtype for further
1094--       details. For E_Exception_Type, this points to the record containing
1095--       the data necessary to represent exceptions (for further details, see
1096--       System.Standard_Library. For access_to_protected subprograms, it
1097--       denotes a record that holds pointers to the operation and to the
1098--       protected object. For remote Access_To_Subprogram types, it denotes
1099--       the record that is the fat pointer representation of an RAST.
1100
1101--    Esize (Uint12)
1102--       Defined in all types and subtypes, and also for components, constants,
1103--       and variables, including exceptions where it refers to the static data
1104--       allocated for an exception. Contains the Object_Size of the type or of
1105--       the object. A value of zero indicates that the value is not yet known.
1106--
1107--       For the case of components where a component clause is present, the
1108--       value is the value from the component clause, which must be non-
1109--       negative (but may be zero, which is acceptable for the case of
1110--       a type with only one possible value). It is also possible for Esize
1111--       of a component to be set without a component clause defined, which
1112--       means that the component size is specified, but not the position.
1113--       See also RM_Size and the section on "Handling of Type'Size Values".
1114--       During gigi processing, the value is back annotated for all zero
1115--       values, so that after the call to gigi, the value is properly set.
1116
1117--    Etype (Node5)
1118--       Defined in all entities. Represents the type of the entity, which
1119--       is itself another entity. For a type entity, points to the parent
1120--       type for a derived type, or if the type is not derived, points to
1121--       itself. For a subtype entity, Etype points to the base type. For
1122--       a class wide type, points to the corresponding specific type. For a
1123--       subprogram or subprogram type, Etype has the return type of a function
1124--       or is set to Standard_Void_Type to represent a procedure. The Etype
1125--       field of a package is also set to Standard_Void_Type.
1126--
1127--       Note one obscure case: for pragma Default_Storage_Pool (null), the
1128--       Etype of the N_Null node is Empty.
1129
1130--    Exception_Code (Uint22)
1131--       Defined in exception entities. Set to zero unless either an
1132--       Import_Exception or Export_Exception pragma applies to the
1133--       pragma and specifies a Code value. See description of these
1134--       pragmas for details. Note that this field is relevant only if
1135--       Is_VMS_Exception is set.
1136
1137--    Extra_Formal (Node15)
1138--       Defined in formal parameters in the non-generic case. Certain
1139--       parameters require extra implicit information to be passed (e.g. the
1140--       flag indicating if an unconstrained variant record argument is
1141--       constrained, and the accessibility level for access parameters. See
1142--       description of Extra_Constrained, Extra_Accessibility fields for
1143--       further details. Extra formal parameters are constructed to represent
1144--       these values, and chained to the end of the list of formals using the
1145--       Extra_Formal field (i.e. the Extra_Formal field of the last "real"
1146--       formal points to the first extra formal, and the Extra_Formal field of
1147--       each extra formal points to the next one, with Empty indicating the
1148--       end of the list of extra formals.
1149
1150--    Extra_Formals (Node28)
1151--       Applies to subprograms and subprogram types, and also in entries
1152--       and entry families. Returns first extra formal of the subprogram
1153--       or entry. Returns Empty if there are no extra formals.
1154
1155--    Extra_Accessibility (Node13)
1156--       Defined in formal parameters in the non-generic case. Normally Empty,
1157--       but if expansion is active, and a parameter is one for which a
1158--       dynamic accessibility check is required, then an extra formal of type
1159--       Natural is created (see description of field Extra_Formal), and the
1160--       Extra_Accessibility field of the formal parameter points to the entity
1161--       for this extra formal. Also defined in variables when compiling
1162--       receiving stubs. In this case, a non Empty value means that this
1163--       variable's accessibility depth has been transmitted by the caller and
1164--       must be retrieved through the entity designed by this field instead of
1165--       being computed.
1166
1167--    Extra_Accessibility_Of_Result (Node19)
1168--       Defined in (non-generic) Function, Operator, and Subprogram_Type
1169--       entities. Normally Empty, but if expansion is active, and a function
1170--       is one for which "the accessibility level of the result ... determined
1171--       by the point of call" (AI05-0234) is needed, then an extra formal of
1172--       subtype Natural is created (see description of field Extra_Formal),
1173--       and the Extra_Accessibility_Of_Result field of the function points to
1174--       the entity for this extra formal.
1175
1176--    Extra_Constrained (Node23)
1177--       Defined in formal parameters in the non-generic case. Normally Empty,
1178--       but if expansion is active and a parameter is one for which a dynamic
1179--       indication of its constrained status is required, then an extra formal
1180--       of type Boolean is created (see description of field Extra_Formal),
1181--       and the Extra_Constrained field of the formal parameter points to the
1182--       entity for this extra formal. Also defined in variables when compiling
1183--       receiving stubs. In this case, a non empty value means that this
1184--       variable's constrained status has been transmitted by the caller and
1185--       must be retrieved through the entity designed by this field instead of
1186--       being computed.
1187
1188--    Finalization_Master (Node23) [root type only]
1189--       Defined in access-to-controlled or access-to-class-wide types. The
1190--       field contains the entity of the finalization master which handles
1191--       dynamically allocated controlled objects referenced by the access
1192--       type. Empty for access-to-subprogram types. Empty for access types
1193--       whose designated type does not need finalization actions.
1194
1195--    Finalize_Storage_Only (Flag158) [base type only]
1196--       Defined in all types. Set on direct controlled types to which a
1197--       valid Finalize_Storage_Only pragma applies. This flag is also set on
1198--       composite types when they have at least one controlled component and
1199--       all their controlled components are Finalize_Storage_Only. It is also
1200--       inherited by type derivation except for direct controlled types where
1201--       the Finalize_Storage_Only pragma is required at each level of
1202--       derivation.
1203
1204--    Finalizer (Node28)
1205--       Applies to package declarations and bodies. Contains the entity of the
1206--       library-level program which finalizes all package-level controlled
1207--       objects.
1208
1209--    First_Component (synthesized)
1210--       Applies to record types. Returns the first component by following the
1211--       chain of declared entities for the record until a component is found
1212--       (one with an Ekind of E_Component). The discriminants are skipped. If
1213--       the record is null, then Empty is returned.
1214
1215--    First_Component_Or_Discriminant (synthesized)
1216--      Similar to First_Component, but discriminants are not skipped, so will
1217--      find the first discriminant if discriminants are present.
1218
1219--    First_Entity (Node17)
1220--       Defined in all entities which act as scopes to which a list of
1221--       associated entities is attached (blocks, class subtypes and types,
1222--       entries, functions, loops, packages, procedures, protected objects,
1223--       record types and subtypes, private types, task types and subtypes).
1224--       Points to a list of associated entities using the Next_Entity field
1225--       as a chain pointer with Empty marking the end of the list.
1226
1227--    First_Exit_Statement (Node8)
1228--       Defined in E_Loop entity. The exit statements for a loop are chained
1229--       (in reverse order of appearance) using this field to point to the
1230--       first entry in the chain (last exit statement in the loop). The
1231--       entries are chained through the Next_Exit_Statement field of the
1232--       N_Exit_Statement node with Empty marking the end of the list.
1233
1234--    First_Formal (synthesized)
1235--       Applies to subprograms and subprogram types, and also in entries
1236--       and entry families. Returns first formal of the subprogram or entry.
1237--       The formals are the first entities declared in a subprogram or in
1238--       a subprogram type (the designated type of an Access_To_Subprogram
1239--       definition) or in an entry.
1240
1241--    First_Formal_With_Extras (synthesized)
1242--       Applies to subprograms and subprogram types, and also in entries
1243--       and entry families. Returns first formal of the subprogram or entry.
1244--       Returns Empty if there are no formals. The list returned includes
1245--       all the extra formals (see description of Extra_Formals field).
1246
1247--    First_Index (Node17)
1248--       Defined in array types and subtypes and in string types and subtypes.
1249--       By introducing implicit subtypes for the index constraints, we have
1250--       the same structure for constrained and unconstrained arrays, subtype
1251--       marks and discrete ranges are both represented by a subtype. This
1252--       function returns the tree node corresponding to an occurrence of the
1253--       first index (NOT the entity for the type). Subsequent indices are
1254--       obtained using Next_Index. Note that this field is defined for the
1255--       case of string literal subtypes, but is always Empty.
1256
1257--    First_Literal (Node17)
1258--       Defined in all enumeration types, including character and boolean
1259--       types. This field points to the first enumeration literal entity
1260--       for the type (i.e. it is set to First (Literals (N)) where N is
1261--       the enumeration type definition node. A special case occurs with
1262--       standard character and wide character types, where this field is
1263--       Empty, since there are no enumeration literal lists in these cases.
1264--       Note that this field is set in enumeration subtypes, but it still
1265--       points to the first literal of the base type in this case.
1266
1267--    First_Optional_Parameter (Node14)
1268--       Defined in (non-generic) function and procedure entities. Set to a
1269--       non-null value only if a pragma Import_Function, Import_Procedure
1270--       or Import_Valued_Procedure specifies a First_Optional_Parameter
1271--       argument, in which case this field points to the parameter entity
1272--       corresponding to the specified parameter.
1273
1274--    First_Private_Entity (Node16)
1275--       Defined in all entities containing private parts (packages, protected
1276--       types and subtypes, task types and subtypes). The entities on the
1277--       entity chain are in order of declaration, so the entries for private
1278--       entities are at the end of the chain. This field points to the first
1279--       entity for the private part. It is Empty if there are no entities
1280--       declared in the private part or if there is no private part.
1281
1282--    First_Rep_Item (Node6)
1283--       Defined in all entities. If non-empty, points to a linked list of
1284--       representation pragmas nodes and representation clause nodes that
1285--       apply to the entity, linked using Next_Rep_Item, with Empty marking
1286--       the end of the list. In the case of derived types and subtypes, the
1287--       new entity inherits the chain at the point of declaration. This means
1288--       that it is possible to have multiple instances of the same kind of rep
1289--       item on the chain, in which case it is the first one that applies to
1290--       the entity.
1291--
1292--       Note: pragmas that can apply to more than one overloadable entity,
1293--       (Convention, Interface, Inline, Inline_Always, Import, Export,
1294--       External) are never present on this chain when they apply to
1295--       overloadable entities, since it is impossible for a given pragma
1296--       to be on more than one chain at a time.
1297--
1298--       For most representation items, the representation information is
1299--       reflected in other fields and flags in the entity. For example if a
1300--       record representation clause is present, the component entities
1301--       reflect the specified information. However, there are some items that
1302--       are only reflected in the chain. These include:
1303--
1304--          Machine_Attribute pragma
1305--          Link_Alias pragma
1306--          Linker_Constructor pragma
1307--          Linker_Destructor pragma
1308--          Weak_External pragma
1309--          Thread_Local_Storage pragma
1310--
1311--       If any of these items are present, then the flag Has_Gigi_Rep_Item is
1312--       set, indicating that Gigi should search the chain.
1313--
1314--       Other representation items are included in the chain so that error
1315--       messages can easily locate the relevant nodes for posting errors.
1316--       Note in particular that size clauses are defined only for this
1317--       purpose, and should only be accessed if Has_Size_Clause is set.
1318
1319--    Float_Rep (Uint10)
1320--       Defined in floating-point entities. Contains a value of type
1321--       Float_Rep_Kind. Together with the Digits_Value uniquely defines
1322--       the floating-point representation to be used.
1323
1324--    Freeze_Node (Node7)
1325--       Defined in all entities. If there is an associated freeze node for the
1326--       entity, this field references this freeze node. If no freeze node is
1327--       associated with the entity, then this field is Empty. See package
1328--       Freeze for further details.
1329
1330--    From_Limited_With (Flag159)
1331--       Defined in abtract states, package and type entities. Set to True when
1332--       the related entity is generated by the expansion of a limited with
1333--       clause. Such an entity is said to be a "shadow" - it acts as the
1334--       abstract view of a state or variable or as the incomplete view of a
1335--       type by inheriting relevant attributes from the said entity.
1336
1337--    Full_View (Node11)
1338--       Defined in all type and subtype entities and in deferred constants.
1339--       References the entity for the corresponding full type declaration.
1340--       For all types other than private and incomplete types, this field
1341--       always contains Empty. If an incomplete type E1 is completed by a
1342--       private type E2 whose full type declaration entity is E3 then the
1343--       full view of E1 is E2, and the full view of E2 is E3. See also
1344--       Underlying_Type.
1345
1346--    Generic_Homonym (Node11)
1347--       Defined in generic packages. The generic homonym is the entity of
1348--       a renaming declaration inserted in every generic unit. It is used
1349--       to resolve the name of a local entity that is given by a qualified
1350--       name, when the generic entity itself is hidden by a local name.
1351
1352--    Generic_Renamings (Elist23)
1353--       Defined in package and subprogram instances. Holds mapping that
1354--       associates generic parameters with the corresponding instances, in
1355--       those cases where the instance is an entity.
1356
1357--    Handler_Records (List10)
1358--       Defined in subprogram and package entities. Points to a list of
1359--       identifiers referencing the handler record entities for the
1360--       corresponding unit.
1361
1362--    Has_Aliased_Components (Flag135) [implementation base type only]
1363--       Defined in array type entities. Indicates that the component type
1364--       of the array is aliased.
1365
1366--    Has_Alignment_Clause (Flag46)
1367--       Defined in all type entities and objects. Indicates if an alignment
1368--       clause has been given for the entity. If set, then Alignment_Clause
1369--       returns the N_Attribute_Definition node for the alignment attribute
1370--       definition clause. Note that it is possible for this flag to be False
1371--       even when Alignment_Clause returns non_Empty (this happens in the case
1372--       of derived type declarations).
1373
1374--    Has_All_Calls_Remote (Flag79)
1375--       Defined in all library unit entities. Set if the library unit has an
1376--       All_Calls_Remote pragma. Note that such entities must also be RCI
1377--       entities, so the flag Is_Remote_Call_Interface will always be set if
1378--       this flag is set.
1379
1380--    Has_Anonymous_Master (Flag253)
1381--       Defined in units (top-level functions and procedures, library-level
1382--       packages). Set if the associated unit contains a heterogeneous
1383--       finalization master. The master's name is of the form <unit>AM and it
1384--       services anonymous access-to-controlled types with an undetermined
1385--       lifetime.
1386
1387--    Has_Atomic_Components (Flag86) [implementation base type only]
1388--       Defined in all types and objects. Set only for an array type or
1389--       an array object if a valid pragma Atomic_Components applies to the
1390--       type or object. Note that in the case of an object, this flag is
1391--       only set on the object if there was an explicit pragma for the
1392--       object. In other words, the proper test for whether an object has
1393--       atomic components is to see if either the object or its base type
1394--       has this flag set. Note that in the case of a type, the pragma will
1395--       be chained to the rep item chain of the first subtype in the usual
1396--       manner.
1397
1398--    Has_Attach_Handler (synthesized)
1399--       Applies to record types that are constructed by the expander to
1400--       represent protected types. Returns True if there is at least one
1401--       Attach_Handler pragma in the corresponding specification.
1402
1403--    Has_Biased_Representation (Flag139)
1404--       Defined in discrete types (where it applies to the type'size value),
1405--       and to objects (both stand-alone and components), where it applies to
1406--       the size of the object from a size or record component clause. In
1407--       all cases it indicates that the size in question is smaller than
1408--       would normally be required, but that the size requirement can be
1409--       satisfied by using a biased representation, in which stored values
1410--       have the low bound (Expr_Value (Type_Low_Bound (T)) subtracted to
1411--       reduce the required size. For example, a type with a range of 1..2
1412--       takes one bit, using 0 to represent 1 and 1 to represent 2.
1413--
1414--       Note that in the object and component cases, the flag is only set if
1415--       the type is unbiased, but the object specifies a smaller size than the
1416--       size of the type, forcing biased representation for the object, but
1417--       the subtype is still an unbiased type.
1418
1419--    Has_Completion (Flag26)
1420--       Defined in all entities that require a completion (functions,
1421--       procedures, private types, limited private types, incomplete types,
1422--       constants and packages that require a body). The flag is set if the
1423--       completion has been encountered and analyzed.
1424
1425--    Has_Completion_In_Body (Flag71)
1426--       Defined in all entities for types and subtypes. Set only in "Taft
1427--       amendment types" (incomplete types whose full declaration appears in
1428--       the package body).
1429
1430--    Has_Complex_Representation (Flag140) [implementation base type only]
1431--       Defined in all type entities. Set only for a record base type to
1432--       which a valid pragma Complex_Representation applies.
1433
1434--    Has_Component_Size_Clause (Flag68) [implementation base type only]
1435--       Defined in all type entities. Set if a component size clause is
1436--       Defined for the given type. Note that this flag can be False even
1437--       if Component_Size is non-zero (happens in the case of derived types).
1438
1439--    Has_Constrained_Partial_View (Flag187)
1440--       Defined in private type and their completions, when the private
1441--       type has no discriminants and the full view has discriminants with
1442--       defaults. In Ada 2005 heap-allocated objects of such types are not
1443--       constrained, and can change their discriminants with full assignment.
1444--
1445--       Ada 2012 has an additional rule (3.3. (23/10.3)) concerning objects
1446--       declared in a generic package body. Objects whose type is an untagged
1447--       generic formal private type are considered to have a constrained
1448--       partial view. The predicate Object_Type_Has_Constrained_Partial_View
1449--       in sem_aux is used to test for this case.
1450
1451--    Has_Contiguous_Rep (Flag181)
1452--       Defined in enumeration types. Set if the type as a representation
1453--       clause whose entries are successive integers.
1454
1455--    Has_Controlling_Result (Flag98)
1456--       Defined in E_Function entities. Set if the function is a primitive
1457--       function of a tagged type which can dispatch on result.
1458
1459--    Has_Controlled_Component (Flag43) [base type only]
1460--       Defined in all type and subtype entities. Set only for composite type
1461--       entities which contain a component that either is a controlled type,
1462--       or itself contains controlled component (i.e. either Is_Controlled or
1463--       Has_Controlled_Component is set for at least one component).
1464
1465--    Has_Convention_Pragma (Flag119)
1466--       Defined in all entities. Set for an entity for which a valid pragma
1467--       Convention, Import, or Export has been given. Used to prevent more
1468--       than one such pragma appearing for a given entity (RM B.1(45)).
1469
1470--    Has_Delayed_Aspects (Flag200)
1471--      Defined in all entities. Set if the Rep_Item chain for the entity has
1472--      one or more N_Aspect_Definition nodes chained which are not to be
1473--      evaluated till the freeze point. The aspect definition expression
1474--      clause has been preanalyzed to get visibility at the point of use,
1475--      but no other action has been taken.
1476
1477--    Has_Delayed_Freeze (Flag18)
1478--       Defined in all entities. Set to indicate that an explicit freeze
1479--       node must be generated for the entity at its freezing point. See
1480--       separate section ("Delayed Freezing and Elaboration") for details.
1481
1482--    Has_Default_Aspect (Flag39) [base type only]
1483--       Defined in entities for types and subtypes, set for scalar types with
1484--       a Default_Value aspect and array types with a Default_Component_Value
1485--       apsect. If this flag is set, then a corresponding aspect specification
1486--       node will be present on the rep item chain for the entity.
1487
1488--    Has_Delayed_Rep_Aspects (Flag261)
1489--       Defined in all type and subtypes. This flag is set if there is at
1490--       least one aspect for a representation characteristic that has to be
1491--       delayed and is one of the characteristics that may be inherited by
1492--       types derived from this type if not overridden. If this flag is set,
1493--       then types derived from this type have May_Inherit_Delayed_Rep_Aspects
1494--       set, signalling that Freeze.Inhert_Delayed_Rep_Aspects must be called
1495--       at the freeze point of the derived type.
1496
1497--    Has_Discriminants (Flag5)
1498--       Defined in all types and subtypes. For types that are allowed to have
1499--       discriminants (record types and subtypes, task types and subtypes,
1500--       protected types and subtypes, private types, limited private types,
1501--       and incomplete types), indicates if the corresponding type or subtype
1502--       has a known discriminant part. Always false for all other types.
1503
1504--    Has_Dispatch_Table (Flag220)
1505--       Defined in E_Record_Types that are tagged. Set to indicate that the
1506--       corresponding dispatch table is already built. This flag is used to
1507--       avoid duplicate construction of library level dispatch tables (because
1508--       the declaration of library level objects cause premature construction
1509--       of the table); otherwise the code that builds the table is added at
1510--       the end of the list of declarations of the package.
1511
1512--    Has_Dynamic_Predicate_Aspect (Flag258)
1513--       Defined in all types and subtypes. Set if a Dynamic_Predicate aspect
1514--       applies to the type. Note that we can tell if a dynamic predicate is
1515--       present by looking at Has_Predicates and Static_Predicate, but that
1516--       could have come from a Predicate aspect or pragma, and we need to
1517--       record the difference so that we can use the right set of check
1518--       policies to figure out if the predicate is active.
1519
1520--    Has_Entries (synthesized)
1521--       Applies to concurrent types. True if any entries are declared
1522--       within the task or protected definition for the type.
1523
1524--    Has_Enumeration_Rep_Clause (Flag66)
1525--       Defined in enumeration types. Set if an enumeration representation
1526--       clause has been given for this enumeration type. Used to prevent more
1527--       than one enumeration representation clause for a given type. Note
1528--       that this does not imply a representation with holes, since the rep
1529--       clause may merely confirm the default 0..N representation.
1530
1531--    Has_External_Tag_Rep_Clause (Flag110)
1532--       Defined in tagged types. Set if an external_tag rep. clause has been
1533--       given for this type. Use to avoid the generation of the default
1534--       external_tag.
1535
1536--    Has_Exit (Flag47)
1537--       Defined in loop entities. Set if the loop contains an exit statement.
1538
1539--    Has_Foreign_Convention (synthesized)
1540--       Applies to all entities. Determines if the Convention for the
1541--       entity is a foreign convention (i.e. is other than Convention_Ada,
1542--       Convention_Intrinsic, Convention_Entry or Convention_Protected).
1543
1544--    Has_Forward_Instantiation (Flag175)
1545--       Defined in package entities. Set for packages that instantiate local
1546--       generic entities before the corresponding generic body has been seen.
1547--       If a package has a forward instantiation, we cannot inline subprograms
1548--       appearing in the same package because the placement requirements of
1549--       the instance will conflict with the  linear elaboration of front-end
1550--       inlining.
1551
1552--    Has_Fully_Qualified_Name (Flag173)
1553--       Defined in all entities. Set if the name in the Chars field has been
1554--       replaced by the fully qualified name, as used for debug output. See
1555--       Exp_Dbug for a full description of the use of this flag and also the
1556--       related flag Has_Qualified_Name.
1557
1558--    Has_Gigi_Rep_Item (Flag82)
1559--       Defined in all entities. Set if the rep item chain (referenced by
1560--       First_Rep_Item and linked through the Next_Rep_Item chain) contains a
1561--       representation item that needs to be specially processed by Gigi, i.e.
1562--       one of the following items:
1563--
1564--          Machine_Attribute pragma
1565--          Linker_Alias pragma
1566--          Linker_Constructor pragma
1567--          Linker_Destructor pragma
1568--          Weak_External pragma
1569--          Thread_Local_Storage pragma
1570--
1571--       If this flag is set, then Gigi should scan the rep item chain to
1572--       process any of these items that appear. At least one such item will
1573--       be present.
1574--
1575--    Has_Homonym (Flag56)
1576--       Defined in all entities. Set if an entity has a homonym in the same
1577--       scope. Used by Gigi to generate unique names for such entities.
1578
1579--    Has_Implicit_Dereference (Flag251)
1580--       Defined in types and discriminants. Set if the type has an aspect
1581--       Implicit_Dereference. Set also on the discriminant named in the aspect
1582--       clause, to simplify type resolution.
1583
1584--    Has_Independent_Components (Flag34)
1585--       Defined in objects and types. Set if the aspect Independent_Components
1586--       applies (as set by coresponding pragma or aspect specification).
1587
1588--    Has_Inheritable_Invariants (Flag248)
1589--       Defined in all type entities. Set in private types from which one
1590--       or more Invariant'Class aspects will be inherited if a another type is
1591--       derived from the type (i.e. those types which have an Invariant'Class
1592--       aspect, or which inherit one or more Invariant'Class aspects). Also
1593--       set in the corresponding full types. Note that it might be the full
1594--       type which has inheritable invariants, and in this case the flag will
1595--       also be set in the private type.
1596
1597--    Has_Initial_Value (Flag219)
1598--       Defined in entities for variables and out parameters. Set if there
1599--       is an explicit initial value expression in the declaration of the
1600--       variable. Note that this is set only if this initial value is
1601--       explicit, it is not set for the case of implicit initialization
1602--       of access types or controlled types. Always set to False for out
1603--       parameters. Also defined in entities for in and in-out parameters,
1604--       but always false in these cases.
1605
1606--    Has_Interrupt_Handler (synthesized)
1607--       Applies to all protected type entities. Set if the protected type
1608--       definition contains at least one procedure to which a pragma
1609--       Interrupt_Handler applies.
1610
1611--    Has_Invariants (Flag232)
1612--       Defined in all type entities and in subprogram entities. Set in
1613--       private types if an Invariant or Invariant'Class aspect applies to the
1614--       type, or if the type inherits one or more Invariant'Class aspects.
1615--       Also set in the corresponding full type. Note: if this flag is set
1616--       True, then usually the Invariant_Procedure attribute is set once the
1617--       type is frozen, however this may not be true in some error situations.
1618--       Note that it might be the full type which has inheritable invariants,
1619--       and then the flag will also be set in the private type.
1620
1621--    Has_Loop_Entry_Attributes (Flag260)
1622--       Defined in E_Loop entities. Set when the loop is subject to at least
1623--       one attribute 'Loop_Entry. The flag also implies that the loop has
1624--       already been transformed. See Expand_Loop_Entry_Attribute for details.
1625
1626--    Has_Machine_Radix_Clause (Flag83)
1627--       Defined in decimal types and subtypes, set if a Machine_Radix
1628--       representation clause is present. This flag is used to detect
1629--       the error of multiple machine radix clauses for a single type.
1630
1631--    Has_Master_Entity (Flag21)
1632--       Defined in entities that can appear in the scope stack (see spec
1633--       of Sem). It is set if a task master entity (_master) has been
1634--       declared and initialized in the corresponding scope.
1635
1636--    Has_Missing_Return (Flag142)
1637--       Defined in functions and generic functions. Set if there is one or
1638--       more missing return statements in the function. This is used to
1639--       control wrapping of the body in Exp_Ch6 to ensure that the program
1640--       error exception is correctly raised in this case at runtime.
1641
1642--    Has_Nested_Block_With_Handler (Flag101)
1643--       Defined in scope entities. Set if there is a nested block within the
1644--       scope that has an exception handler and the two scopes are in the
1645--       same procedure. This is used by the backend for controlling certain
1646--       optimizations to ensure that they are consistent with exceptions.
1647--       See documentation in Gigi for further details.
1648
1649--    Has_Non_Null_Refinement (synth)
1650--       Defined in E_Abstract_State entities. True if the state has at least
1651--       one variable or state constituent in aspect/pragma Refined_State.
1652
1653--    Has_Non_Standard_Rep (Flag75) [implementation base type only]
1654--       Defined in all type entities. Set when some representation clause
1655--       or pragma causes the representation of the item to be significantly
1656--       modified. In this category are changes of small or radix for a
1657--       fixed-point type, change of component size for an array, and record
1658--       or enumeration representation clauses, as well as packed pragmas.
1659--       All other representation clauses (e.g. Size and Alignment clauses)
1660--       are not considered to be significant since they do not affect
1661--       stored bit patterns.
1662
1663--    Has_Null_Abstract_State (synth)
1664--       Defined in package entities. True if the package is subject to a null
1665--       Abstract_State aspect/pragma.
1666
1667--    Has_Null_Refinement (synth)
1668--       Defined in E_Abstract_State entities. True if the state has a null
1669--       refinement in aspect/pragma Refined_State.
1670
1671--    Has_Object_Size_Clause (Flag172)
1672--       Defined in entities for types and subtypes. Set if an Object_Size
1673--       clause has been processed for the type Used to prevent multiple
1674--       Object_Size clauses for a given entity.
1675
1676--    Has_Per_Object_Constraint (Flag154)
1677--       Defined in E_Component entities. Set if the subtype of the component
1678--       has a per object constraint. Per object constraints result from the
1679--       following situations :
1680--
1681--       1. N_Attribute_Reference - when the prefix is the enclosing type and
1682--          the attribute is Access.
1683--       2. N_Discriminant_Association - when the expression uses the
1684--          discriminant of the enclosing type.
1685--       3. N_Index_Or_Discriminant_Constraint - when at least one of the
1686--          individual constraints is a per object constraint.
1687--       4. N_Range - when the lower or upper bound uses the discriminant of
1688--          the enclosing type.
1689--       5. N_Range_Constraint - when the range expression uses the
1690--          discriminant of the enclosing type.
1691
1692--    Has_Postconditions (Flag240)
1693--      Defined in subprogram entities. Set if postconditions are active for
1694--      the procedure, and a _postconditions procedure has been generated.
1695
1696--    Has_Pragma_Controlled (Flag27) [implementation base type only]
1697--       Defined in access type entities. It is set if a pragma Controlled
1698--       applies to the access type.
1699
1700--    Has_Pragma_Elaborate_Body (Flag150)
1701--       Defined in all entities. Set in compilation unit entities if a
1702--       pragma Elaborate_Body applies to the compilation unit.
1703
1704--    Has_Pragma_Inline (Flag157)
1705--       Defined in all entities. Set for functions and procedures for which a
1706--       pragma Inline or Inline_Always applies to the subprogram. Note that
1707--       this flag can be set even if Is_Inlined is not set. This happens for
1708--       pragma Inline (if Inline_Active is False). In other words, the flag
1709--       Has_Pragma_Inline represents the formal semantic status, and is used
1710--       for checking semantic correctness. The flag Is_Inlined indicates
1711--       whether inlining is actually active for the entity.
1712
1713--    Has_Pragma_Inline_Always (Flag230)
1714--       Defined in all entities. Set for functions and procedures for which a
1715--       pragma Inline_Always applies. Note that if this flag is set, the flag
1716--       Has_Pragma_Inline is also set.
1717
1718--    Has_Pragma_No_Inline (Flag201)
1719--       Defined in all entities. Set for functions and procedures for which a
1720--       pragma No_Inline applies. Note that if this flag is set, the flag
1721--       Has_Pragma_Inline_Always cannot be set.
1722
1723--    Has_Pragma_Ordered (Flag198) [implementation base type only]
1724--       Defined in entities for enumeration types. If set indicates that a
1725--       valid pragma Ordered was given for the type. This flag is inherited
1726--       by derived enumeration types. We don't need to distinguish the derived
1727--       case since we allow multiple occurrences of this pragma anyway.
1728
1729--    Has_Pragma_Pack (Flag121) [implementation base type only]
1730--       Defined in array and record type entities. If set, indicates that a
1731--       valid pragma Pack was given for the type. Note that this flag is not
1732--       inherited by derived type. See also the Is_Packed flag.
1733
1734--    Has_Pragma_Pure (Flag203)
1735--       Defined in all entities. If set, indicates that a valid pragma Pure
1736--       was given for the entity. In some cases, we need to test whether
1737--       Is_Pure was explicitly set using this pragma.
1738
1739--    Has_Pragma_Preelab_Init (Flag221)
1740--       Defined in type and subtype entities. If set indicates that a valid
1741--       pragma Preelaborable_Initialization applies to the type.
1742
1743--    Has_Pragma_Pure_Function (Flag179)
1744--       Defined in all entities. If set, indicates that a valid pragma
1745--       Pure_Function was given for the entity. In some cases, we need to
1746--       know that Is_Pure was explicitly set using this pragma. We also set
1747--       this flag for some internal entities that we know should be treated
1748--       as pure for optimization purposes.
1749
1750--    Has_Pragma_Thread_Local_Storage (Flag169)
1751--       Defined in all entities. If set, indicates that a valid pragma
1752--       Thread_Local_Storage was given for the entity.
1753
1754--    Has_Pragma_Unmodified (Flag233)
1755--       Defined in all entities. Can only be set for variables (E_Variable,
1756--       E_Out_Parameter, E_In_Out_Parameter). Set if a valid pragma Unmodified
1757--       applies to the variable, indicating that no warning should be given
1758--       if the entity is never modified. Note that clients should generally
1759--       not test this flag directly, but instead use function Has_Unmodified.
1760
1761--    Has_Pragma_Unreferenced (Flag180)
1762--       Defined in all entities. Set if a valid pragma Unreferenced applies
1763--       to the entity, indicating that no warning should be given if the
1764--       entity has no references, but a warning should be given if it is
1765--       in fact referenced. For private types, this flag is set in both the
1766--       private entity and full entity if the pragma applies to either. Note
1767--       that clients should generally not test this flag directly, but instead
1768--       use function Has_Unreferenced.
1769
1770--    Has_Pragma_Unreferenced_Objects (Flag212)
1771--       Defined in type and subtype entities. Set if a valid pragma
1772--       Unreferenced_Objects applies to the type, indicating that no warning
1773--       should be given for objects of such a type for being unreferenced
1774--       (but unlike the case with pragma Unreferenced, it is ok to reference
1775--       such an object and no warning is generated.
1776
1777--    Has_Predicates (Flag250)
1778--       Defined in type and subtype entities. Set if a pragma Predicate or
1779--       Predicate aspect applies to the type or subtype, or if it inherits a
1780--       Predicate aspect from its parent or progenitor types.
1781
1782--    Has_Primitive_Operations (Flag120) [base type only]
1783--       Defined in all type entities. Set if at least one primitive operation
1784--       is defined for the type.
1785
1786--    Has_Private_Ancestor (Flag151)
1787--       Applies to untagged derived types and to type extensions. True when
1788--       some ancestor is derived from a private type, making some components
1789--       invisible and aggregates illegal. Used to check the legality of
1790--       selected components and aggregates. The flag is set at the point of
1791--       derivation. The legality of an aggregate of a type with a private
1792--       ancestor must be checked because it also depends on the visibility
1793--       at the point the aggregate is resolved. See sem_aggr.adb. This is
1794--       part of AI05-0115.
1795
1796--    Has_Private_Declaration (Flag155)
1797--       Defined in all entities. Set if it is the defining entity of a private
1798--       type declaration or its corresponding full declaration. This flag is
1799--       thus preserved when the full and the partial views are exchanged, to
1800--       indicate if a full type declaration is a completion. Used for semantic
1801--       checks in E.4(18) and elsewhere.
1802
1803--    Has_Qualified_Name (Flag161)
1804--       Defined in all entities. Set if the name in the Chars field has
1805--       been replaced by its qualified name, as used for debug output. See
1806--       Exp_Dbug for a full description of qualification requirements. For
1807--       some entities, the name is the fully qualified name, but there are
1808--       exceptions. In particular, for local variables in procedures, we
1809--       do not include the procedure itself or higher scopes. See also the
1810--       flag Has_Fully_Qualified_Name, which is set if the name does indeed
1811--       include the fully qualified name.
1812
1813--    Has_RACW (Flag214)
1814--       Defined in package spec entities. Set if the spec contains the
1815--       declaration of a remote access-to-classwide type.
1816
1817--    Has_Record_Rep_Clause (Flag65) [implementation base type only]
1818--       Defined in record types. Set if a record representation clause has
1819--       been given for this record type. Used to prevent more than one such
1820--       clause for a given record type. Note that this is initially cleared
1821--       for a derived type, even though the representation is inherited. See
1822--       also the flag Has_Specified_Layout.
1823
1824--    Has_Recursive_Call (Flag143)
1825--       Defined in procedures. Set if a direct parameterless recursive call
1826--       is detected while analyzing the body. Used to activate some error
1827--       checks for infinite recursion.
1828
1829--    Has_Shift_Operator (Flag267) [base type only]
1830--       Defined in integer types. Set in the base type of an integer type for
1831--       which at least one of the shift operators is defined.
1832
1833--    Has_Size_Clause (Flag29)
1834--       Defined in entities for types and objects. Set if a size clause is
1835--       defined for the entity. Used to prevent multiple Size clauses for a
1836--       given entity. Note that it is always initially cleared for a derived
1837--       type, even though the Size for such a type is inherited from a Size
1838--       clause given for the parent type.
1839
1840--    Has_Small_Clause (Flag67)
1841--       Defined in ordinary fixed point types (but not subtypes). Indicates
1842--       that a small clause has been given for the entity. Used to prevent
1843--       multiple Small clauses for a given entity. Note that it is always
1844--       initially cleared for a derived type, even though the Small for such
1845--       a type is inherited from a Small clause given for the parent type.
1846
1847--    Has_Specified_Layout (Flag100) [implementation base type only]
1848--       Defined in all type entities. Set for a record type or subtype if
1849--       the record layout has been specified by a record representation
1850--       clause. Note that this differs from the flag Has_Record_Rep_Clause
1851--       in that it is inherited by a derived type. Has_Record_Rep_Clause is
1852--       used to indicate that the type is mentioned explicitly in a record
1853--       representation clause, and thus is not inherited by a derived type.
1854--       This flag is always False for non-record types.
1855
1856--    Has_Specified_Stream_Input (Flag190)
1857--    Has_Specified_Stream_Output (Flag191)
1858--    Has_Specified_Stream_Read (Flag192)
1859--    Has_Specified_Stream_Write (Flag193)
1860--       Defined in all type and subtype entities. Set for a given view if the
1861--       corresponding stream-oriented attribute has been defined by an
1862--       attribute definition clause. When such a clause occurs, a TSS is set
1863--       on the underlying full view; the flags are used to track visibility of
1864--       the attribute definition clause for partial or incomplete views.
1865
1866--    Has_Static_Discriminants (Flag211)
1867--       Defined in record subtypes constrained by discriminant values. Set if
1868--       all the discriminant values have static values, meaning that in the
1869--       case of a variant record, the component list can be trimmed down to
1870--       include only the components corresponding to these discriminants.
1871
1872--    Has_Static_Predicate_Aspect (Flag259)
1873--       Defined in all types and subtypes. Set if a Dynamic_Predicate aspect
1874--       applies to the type. Note that we can tell if a static predicate is
1875--       present by looking at Has_Predicates and Static_Predicate, but that
1876--       could have come from a Predicate aspect or pragma, and we need to
1877--       record the difference so that we can use the right set of check
1878--       policies to figure out if the predicate is active.
1879
1880--    Has_Storage_Size_Clause (Flag23) [implementation base type only]
1881--       Defined in task types and access types. It is set if a Storage_Size
1882--       clause is present for the type. Used to prevent multiple clauses for
1883--       one type. Note that this flag is initially cleared for a derived type
1884--       even though the Storage_Size for such a type is inherited from a
1885--       Storage_Size clause given for the parent type. Note that in the case
1886--       of access types, this flag is defined only in the root type, since a
1887--       storage size clause cannot be given to a derived type.
1888
1889--    Has_Stream_Size_Clause (Flag184)
1890--       Defined in all entities. It is set for types which have a Stream_Size
1891--       clause attribute. Used to prevent multiple Stream_Size clauses for a
1892--       given entity, and also whether it is necessary to check for a stream
1893--       size clause.
1894
1895--    Has_Task (Flag30) [base type only]
1896--       Defined in all type entities. Set on task types themselves, and also
1897--       (recursively) on any composite type which has a component for which
1898--       Has_Task is set. The meaning is that an allocator or declaration of
1899--       such an object must create the required tasks. Note: the flag is not
1900--       set on access types, even if they designate an object that Has_Task.
1901
1902--    Has_Thunks (Flag228)
1903--       Applies to E_Constant entities marked Is_Tag. True for secondary tag
1904--       referencing a dispatch table whose contents are pointers to thunks.
1905
1906--    Has_Unchecked_Union (Flag123) [base type only]
1907--       Defined in all type entities. Set on unchecked unions themselves
1908--       and (recursively) on any composite type which has a component for
1909--       which Has_Unchecked_Union is set. The meaning is that a comparison
1910--       operation for the type is not permitted. Note that the flag is not
1911--       set on access types, even if they designate an object that has
1912--       the flag Has_Unchecked_Union set.
1913
1914--    Has_Unknown_Discriminants (Flag72)
1915--       Defined in all entities. Set for types with unknown discriminants.
1916--       Types can have unknown discriminants either from their declaration or
1917--       through type derivation. The use of this flag exactly meets the spec
1918--       in RM 3.7(26). Note that all class-wide types are considered to have
1919--       unknown discriminants. Note that both flags Has_Discriminants and
1920--       Has_Unknown_Discriminants may be true for a type. Class-wide types and
1921--       their subtypes have unknown discriminants and can have declared ones
1922--       as well. Private types declared with unknown discriminants may have a
1923--       full view that has explicit discriminants, and both flag will be set
1924--       on the partial view, to insure that discriminants are properly
1925--       inherited in certain contexts.
1926
1927--    Has_Up_Level_Access (Flag215)
1928--       Defined in E_Variable and E_Constant entities. Set if the entity
1929--       is a local variable declared in a subprogram p and is accessed in
1930--       a subprogram nested inside p. Currently this flag is only set when
1931--       VM_Target /= No_VM, for efficiency, since only the .NET back-end
1932--       makes use of it to generate proper code for up-level references.
1933
1934--    Has_Visible_Refinement (Flag263)
1935--       Defined in E_Abstract_State entities. Set when a state has at least
1936--       one refinement constituent and analysis is in the region between
1937--       pragma Refined_State and the end of the package body declarations.
1938
1939--    Has_Volatile_Components (Flag87) [implementation base type only]
1940--       Defined in all types and objects. Set only for an array type or array
1941--       object if a valid pragma Volatile_Components or a valid pragma
1942--       Atomic_Components applies to the type or object. Note that in the case
1943--       of an object, this flag is only set on the object if there was an
1944--       explicit pragma for the object. In other words, the proper test for
1945--       whether an object has volatile components is to see if either the
1946--       object or its base type has this flag set. Note that in the case of a
1947--       type the pragma will be chained to the rep item chain of the first
1948--       subtype in the usual manner.
1949
1950--    Has_Xref_Entry (Flag182)
1951--       Defined in all entities. Set if an entity has an entry in the Xref
1952--       information generated in ali files. This is true for all source
1953--       entities in the extended main source file. It is also true of entities
1954--       in other packages that are referenced directly or indirectly from the
1955--       main source file (indirect reference occurs when the main source file
1956--       references an entity with a type reference. See package Lib.Xref for
1957--       further details).
1958
1959--    Hiding_Loop_Variable (Node8)
1960--       Defined in variables. Set only if a variable of a discrete type is
1961--       hidden by a loop variable in the same local scope, in which case
1962--       the Hiding_Loop_Variable field of the hidden variable points to
1963--       the E_Loop_Parameter entity doing the hiding. Used in processing
1964--       warning messages if the hidden variable turns out to be unused
1965--       or is referenced without being set.
1966
1967--    Homonym (Node4)
1968--       Defined in all entities. Link for list of entities that have the
1969--       same source name and that are declared in the same or enclosing
1970--       scopes. Homonyms in the same scope are overloaded. Used for name
1971--       resolution and for the generation of debugging information.
1972
1973--    Implementation_Base_Type (synthesized)
1974--       Applies to all entities. For types, similar to Base_Type, but never
1975--       returns a private type when applied to a non-private type. Instead in
1976--       this case, it always returns the Underlying_Type of the base type, so
1977--       that we still have a concrete type. For entities other than types,
1978--       returns the entity unchanged.
1979
1980--    Import_Pragma (Node35)
1981--       Defined in subprogram entities. Set if a valid pragma Import or pragma
1982--       Import_Function or pragma Import_Procedure aplies to the subprogram,
1983--       in which case this field points to the pragma (we can't use the normal
1984--       Rep_Item chain mechanism, because a single pragma Import can apply
1985--       to multiple subprogram entities.
1986
1987--    In_Package_Body (Flag48)
1988--       Defined in package entities. Set on the entity that denotes the
1989--       package (the defining occurrence of the package declaration) while
1990--       analyzing and expanding the package body. Reset on completion of
1991--       analysis/expansion.
1992
1993--    In_Private_Part (Flag45)
1994--       Defined in all entities. Can be set only in package entities and
1995--       objects. For package entities, this flag is set to indicate that the
1996--       private part of the package is being analyzed. The flag is reset at
1997--       the end of the package declaration. For objects it indicates that the
1998--       declaration of the object occurs in the private part of a package.
1999
2000--    Initialization_Statements (Node28)
2001--       Defined in constants and variables. For a composite object initialized
2002--       initialized with an aggregate that has been converted to a sequence
2003--       of assignments, points to a block statement containing the
2004--       assignments.
2005
2006--    Inner_Instances (Elist23)
2007--       Defined in generic units. Contains element list of units that are
2008--       instantiated within the given generic. Used to diagnose circular
2009--       instantiations.
2010
2011--    Interface_Alias (Node25)
2012--       Defined in subprograms that cover a primitive operation of an abstract
2013--       interface type. Can be set only if the Is_Hidden flag is also set,
2014--       since such entities are always hidden. Points to its associated
2015--       interface subprogram. It is used to register the subprogram in
2016--       secondary dispatch table of the interface (Ada 2005: AI-251).
2017
2018--    Interface_Name (Node21)
2019--       Defined in constants, variables, exceptions, functions, procedures,
2020--       packages, components (JGNAT only), discriminants (JGNAT only), and
2021--       access to subprograms (JGNAT only). Set to Empty unless an export,
2022--       import, or interface name pragma has explicitly specified an external
2023--       name, in which case it references an N_String_Literal node for the
2024--       specified external name. In the case of exceptions, the field is set
2025--       by Import_Exception/Export_Exception (which can be used in OpenVMS
2026--       versions only). Note that if this field is Empty, and Is_Imported
2027--       or Is_Exported is set, then the default interface name is the name
2028--       of the entity, cased in a manner that is appropriate to the system
2029--       in use. Note that Interface_Name is ignored if an address clause
2030--       is present (since it is meaningless in this case).
2031--
2032--       An additional special case usage of this field is in JGNAT for
2033--       E_Component and E_Discriminant. JGNAT allows these entities to be
2034--       imported by specifying pragma Import within a component's containing
2035--       record definition. This supports interfacing to object fields defined
2036--       within Java classes, and such pragmas are generated by the jvm2ada
2037--       binding generator tool whenever it processes classes with public
2038--       object fields. A pragma Import for a component can define the
2039--       External_Name of the imported Java field (which is generally needed,
2040--       because Java names are case sensitive).
2041
2042--    Interfaces (Elist25)
2043--       Defined in record types and subtypes. List of abstract interfaces
2044--       implemented by a tagged type that are not already implemented by the
2045--       ancestors (Ada 2005: AI-251).
2046
2047--    Invariant_Procedure (synthesized)
2048--       Defined in types and subtypes. Set for private types if one or more
2049--       Invariant, or Invariant'Class, or inherited Invariant'Class aspects
2050--       apply to the type. Points to the entity for a procedure which checks
2051--       the invariant. This invariant procedure takes a single argument of the
2052--       given type, and returns if the invariant holds, or raises exception
2053--       Assertion_Error with an appropriate message if it does not hold. This
2054--       attribute is defined but always empty for private subtypes. This
2055--       attribute is also set for the corresponding full type.
2056--
2057--       Note: the reason this is marked as a synthesized attribute is that the
2058--       way this is stored is as an element of the Subprograms_For_Type field.
2059
2060--    In_Use (Flag8)
2061--       Defined in packages and types. Set when analyzing a use clause for
2062--       the corresponding entity. Reset at end of corresponding declarative
2063--       part. The flag on a type is also used to determine the visibility of
2064--       the primitive operators of the type.
2065
2066--    Is_Abstract_Subprogram (Flag19)
2067--       Defined in all subprograms and entries. Set for abstract subprograms.
2068--       Always False for enumeration literals and entries. See also
2069--       Requires_Overriding.
2070
2071--    Is_Abstract_Type (Flag146)
2072--       Defined in all types. Set for abstract types.
2073
2074--    Is_Access_Constant (Flag69)
2075--       Defined in access types and subtypes. Indicates that the keyword
2076--       constant was present in the access type definition.
2077
2078--    Is_Access_Protected_Subprogram_Type (synthesized)
2079--       Applies to all types, true for named and anonymous access to
2080--       protected subprograms.
2081
2082--    Is_Access_Type (synthesized)
2083--       Applies to all entities, true for access types and subtypes
2084
2085--    Is_Ada_2005_Only (Flag185)
2086--       Defined in all entities, true if a valid pragma Ada_05 or Ada_2005
2087--       applies to the entity which specifically names the entity, indicating
2088--       that the entity is Ada 2005 only. Note that this flag is not set if
2089--       the entity is part of a unit compiled with the normal no-argument form
2090--       of pragma Ada_05 or Ada_2005.
2091
2092--    Is_Ada_2012_Only (Flag199)
2093--       Defined in all entities, true if a valid pragma Ada_12 or Ada_2012
2094--       applies to the entity which specifically names the entity, indicating
2095--       that the entity is Ada 2012 only. Note that this flag is not set if
2096--       the entity is part of a unit compiled with the normal no-argument form
2097--       of pragma Ada_12 or Ada_2012.
2098
2099--    Is_Aliased (Flag15)
2100--       Defined in all entities. Set for objects and types whose declarations
2101--       carry the keyword aliased, and on record components that have the
2102--       keyword. For Ada 2012, also applies to formal parameters.
2103
2104--    Is_AST_Entry (Flag132)
2105--       Defined in entry entities. Set if a valid pragma AST_Entry applies
2106--       to the entry. This flag can only be set in OpenVMS versions of GNAT.
2107--       Note: we also allow the flag to appear in entry families, but given
2108--       the current implementation of the pragma AST_Entry, this flag will
2109--       always be False in entry families.
2110
2111--    Is_Atomic (Flag85)
2112--       Defined in all type entities, and also in constants, components and
2113--       variables. Set if a pragma Atomic or Shared applies to the entity.
2114--       In the case of private and incomplete types, this flag is set in
2115--       both the partial view and the full view.
2116
2117--    Is_Array_Type (synthesized)
2118--       Applies to all entities, true for array types and subtypes
2119
2120--    Is_Asynchronous (Flag81)
2121--       Defined in all type entities and in procedure entities. Set
2122--       if a pragma Asynchronous applies to the entity.
2123
2124--    Is_Base_Type (synthesized)
2125--       Applies to type and subtype entities. True if entity is a base type
2126
2127--    Is_Bit_Packed_Array (Flag122) [implementation base type only]
2128--       Defined in all entities. This flag is set for a packed array type that
2129--       is bit packed (i.e. the component size is known by the front end and
2130--       is in the range 1-7, 9-15, 17-31, or 33-63). Is_Packed is always set
2131--       if Is_Bit_Packed_Array is set, but it is possible for Is_Packed to be
2132--       set without Is_Bit_Packed_Array for the case of an array having one or
2133--       more index types that are enumeration types with non-standard
2134--       enumeration representations.
2135
2136--    Is_Boolean_Type (synthesized)
2137--       Applies to all entities, true for boolean types and subtypes,
2138--       i.e. Standard.Boolean and all types ultimately derived from it.
2139
2140--    Is_Called (Flag102)
2141--       Defined in subprograms. Returns true if the subprogram is called
2142--       in the unit being compiled or in a unit in the context. Used for
2143--       inlining.
2144
2145--    Is_Character_Type (Flag63)
2146--       Defined in all entities. Set for character types and subtypes,
2147--       i.e. enumeration types that have at least one character literal.
2148
2149--    Is_Child_Unit (Flag73)
2150--       Defined in all entities. Set only for defining entities of program
2151--       units that are child units (but False for subunits).
2152
2153--    Is_Class_Wide_Type (synthesized)
2154--       Applies to all entities, true for class wide types and subtypes
2155
2156--    Is_Class_Wide_Equivalent_Type (Flag35)
2157--       Defined in record types and subtypes. Set to True, if the type acts
2158--       as a class-wide equivalent type, i.e. the Equivalent_Type field of
2159--       some class-wide subtype entity references this record type.
2160
2161--    Is_Compilation_Unit (Flag149)
2162--       Defined in all entities. Set if the entity is a package or subprogram
2163--       entity for a compilation unit other than a subunit (since we treat
2164--       subunits as part of the same compilation operation as the ultimate
2165--       parent, we do not consider them to be separate units for this flag).
2166
2167--    Is_Completely_Hidden (Flag103)
2168--       Defined in all entities. This flag can be set only for E_Discriminant
2169--       entities. This flag can be set only for girder discriminants of
2170--       untagged types. When set, the entity is a girder discriminant of a
2171--       derived untagged type which is not directly visible in the derived
2172--       type because the derived type or one of its ancestors have renamed the
2173--       discriminants in the root type. Note: there are girder discriminants
2174--       which are not Completely_Hidden (e.g. discriminants of a root type).
2175
2176--    Is_Composite_Type (synthesized)
2177--       Applies to all entities, true for all composite types and
2178--       subtypes. Either Is_Composite_Type or Is_Elementary_Type (but
2179--       not both) is true of any type.
2180
2181--    Is_Concurrent_Record_Type (Flag20)
2182--       Defined in record types and subtypes. Set if the type was created
2183--       by the expander to represent a task or protected type. For every
2184--       concurrent type, such as record type is constructed, and task and
2185--       protected objects are instances of this record type at runtime
2186--       (Gigi will replace declarations of the concurrent type using the
2187--       declarations of the corresponding record type). See package Exp_Ch9
2188--       for further details.
2189
2190--    Is_Concurrent_Type (synthesized)
2191--       Applies to all entities, true for task types and subtypes and for
2192--       protected types and subtypes.
2193
2194--    Is_Constant_Object (synthesized)
2195--       Applies to all entities, true for E_Constant, E_Loop_Parameter, and
2196--       E_In_Parameter entities.
2197
2198--    Is_Constrained (Flag12)
2199--       Defined in types or subtypes which may have index, discriminant
2200--       or range constraint (i.e. array types and subtypes, record types
2201--       and subtypes, string types and subtypes, and all numeric types).
2202--       Set if the type or subtype is constrained.
2203
2204--    Is_Constr_Subt_For_U_Nominal (Flag80)
2205--       Defined in all types and subtypes. Set only for the constructed
2206--       subtype of an object whose nominal subtype is unconstrained. Note
2207--       that the constructed subtype itself will be constrained.
2208
2209--    Is_Constr_Subt_For_UN_Aliased (Flag141)
2210--       Defined in all types and subtypes. This flag can be set only if
2211--       Is_Constr_Subt_For_U_Nominal is also set. It indicates that in
2212--       addition the object concerned is aliased. This flag is used by
2213--       Gigi to determine whether a template must be constructed.
2214
2215--    Is_Constructor (Flag76)
2216--       Defined in function and procedure entities. Set if a pragma
2217--       CPP_Constructor applies to the subprogram.
2218
2219--    Is_Controlled (Flag42) [base type only]
2220--       Defined in all type entities. Indicates that the type is controlled,
2221--       i.e. is either a descendant of Ada.Finalization.Controlled or of
2222--       Ada.Finalization.Limited_Controlled.
2223
2224--    Is_Controlling_Formal (Flag97)
2225--       Defined in all Formal_Kind entities. Marks the controlling parameters
2226--       of dispatching operations.
2227
2228--    Is_CPP_Class (Flag74)
2229--       Defined in all type entities, set only for tagged types to which a
2230--       valid pragma Import (CPP, ...) or pragma CPP_Class has been applied.
2231
2232--    Is_Decimal_Fixed_Point_Type (synthesized)
2233--       Applies to all type entities, true for decimal fixed point
2234--       types and subtypes.
2235
2236--    Is_Descendent_Of_Address (Flag223)
2237--       Defined in all entities. True if the entity is type System.Address,
2238--       or (recursively) a subtype or derived type of System.Address.
2239
2240--    Is_Discrete_Type (synthesized)
2241--       Applies to all entities, true for all discrete types and subtypes
2242
2243--    Is_Discrete_Or_Fixed_Point_Type (synthesized)
2244--       Applies to all entities, true for all discrete types and subtypes
2245--       and all fixed-point types and subtypes.
2246
2247--    Is_Discrim_SO_Function (Flag176)
2248--       Defined in all entities. Set only in E_Function entities that Layout
2249--       creates to compute discriminant-dependent dynamic size/offset values.
2250
2251--    Is_Discriminant_Check_Function (Flag264)
2252--       Defined in all entities. Set only in E_Function entities for functions
2253--       created to do discriminant checks.
2254
2255--    Is_Discriminal (synthesized)
2256--       Applies to all entities, true for renamings of discriminants. Such
2257--       entities appear as constants or IN parameters.
2258
2259--    Is_Dispatch_Table_Entity (Flag234)
2260--       Applies to all entities. Set to indicate to the backend that this
2261--       entity is associated with a dispatch table.
2262
2263--    Is_Dispatching_Operation (Flag6)
2264--       Defined in all entities. Set for procedures, functions, generic
2265--       procedures, and generic functions if the corresponding operation
2266--       is dispatching.
2267
2268--    Is_Dynamic_Scope (synthesized)
2269--       Applies to all Entities. Returns True if the entity is a dynamic
2270--       scope (i.e. a block, subprogram, task_type, entry
2271--       or extended return statement).
2272
2273--    Is_Elementary_Type (synthesized)
2274--       Applies to all entities, true for all elementary types and
2275--       subtypes. Either Is_Composite_Type or Is_Elementary_Type (but
2276--       not both) is true of any type.
2277
2278--    Is_Eliminated (Flag124)
2279--       Defined in type entities, subprogram entities, and object entities.
2280--       Indicates that the corresponding entity has been eliminated by use
2281--       of pragma Eliminate. Also used to mark subprogram entities whose
2282--       declaration and body are within unreachable code that is removed.
2283
2284--    Is_Enumeration_Type (synthesized)
2285--       Defined in all entities, true for enumeration types and subtypes
2286
2287--    Is_Entry (synthesized)
2288--       Applies to all entities, True only for entry and entry family
2289--       entities and False for all other entity kinds.
2290
2291--    Is_Entry_Formal (Flag52)
2292--       Defined in all entities. Set only for entry formals (which can only
2293--       be in, in-out or out parameters). This flag is used to speed up the
2294--       test for the need to replace references in Exp_Ch2.
2295
2296--    Is_Exported (Flag99)
2297--       Defined in all entities. Set if the entity is exported. For now we
2298--       only allow the export of constants, exceptions, functions, procedures
2299--       and variables, but that may well change later on. Exceptions can only
2300--       be exported in the OpenVMS and Java VM implementations of GNAT.
2301
2302--    Is_External_State (synthesized)
2303--       Applies to all entities, true for abstract states that are subject to
2304--       option External.
2305
2306--    Is_Finalizer (synthesized)
2307--       Applies to all entities, true for procedures containing finalization
2308--       code to process local or library level objects.
2309
2310--    Is_First_Subtype (Flag70)
2311--       Defined in all entities. True for first subtypes (RM 3.2.1(6)),
2312--       i.e. the entity in the type declaration that introduced the type.
2313--       This may be the base type itself (e.g. for record declarations and
2314--       enumeration type declarations), or it may be the first subtype of
2315--       an anonymous base type (e.g. for integer type declarations or
2316--       constrained array declarations).
2317
2318--    Is_Fixed_Point_Type (synthesized)
2319--       Applies to all entities, true for decimal and ordinary fixed
2320--       point types and subtypes
2321
2322--    Is_Floating_Point_Type (synthesized)
2323--       Applies to all entities, true for float types and subtypes
2324
2325--    Is_Formal (synthesized)
2326--       Applies to all entities, true for IN, IN OUT and OUT parameters
2327
2328--    Is_Formal_Object (synthesized)
2329--       Applies to all entities, true for generic IN and IN OUT parameters
2330
2331--    Is_Formal_Subprogram (Flag111)
2332--       Defined in all entities. Set for generic formal subprograms.
2333
2334--    Is_For_Access_Subtype (Flag118)
2335--       Defined in E_Private_Subtype and E_Record_Subtype entities. Means the
2336--       sole purpose of the type is to be designated by an Access_Subtype and
2337--       hence should not be expanded into components because the type may not
2338--       have been found or frozen yet.
2339
2340--    Is_Frozen (Flag4)
2341--       Defined in all type and subtype entities. Set if type or subtype has
2342--       been frozen.
2343
2344--    Is_Generic_Actual_Type (Flag94)
2345--       Defined in all type and subtype entities. Set in the subtype
2346--       declaration that renames the generic formal as a subtype of the
2347--       actual. Guarantees that the subtype is not static within the instance.
2348
2349--    Is_Generic_Instance (Flag130)
2350--       Defined in all entities. Set to indicate that the entity is an
2351--       instance of a generic unit, or a formal package (which is an instance
2352--       of the template).
2353
2354--    Is_Generic_Subprogram (synthesized)
2355--       Applies to all entities. Yields True for a generic subprogram
2356--       (generic function, generic subprogram), False for all other entities.
2357
2358--    Is_Generic_Type (Flag13)
2359--       Defined in all entities. Set for types which are generic formal types.
2360--       Such types have an Ekind that corresponds to their classification, so
2361--       the Ekind cannot be used to identify generic formal types.
2362
2363--    Is_Generic_Unit (synthesized)
2364--       Applies to all entities. Yields True for a generic unit (generic
2365--       package, generic function, generic procedure), and False for all
2366--       other entities.
2367
2368--    Is_Ghost_Entity (synthesized)
2369--       Applies to all entities. Yields True for a subprogram or a whole
2370--       object that has convention Ghost. For now only functions can have
2371--       Ghost convention, so this will be false for other than functions,
2372--       but we expect that to change in the future.
2373
2374--    Is_Ghost_Subprogram (synthesized)
2375--       Applies to all entities. Yields True for a subprogram that has a Ghost
2376--       convention. Note: for now, only ghost functions are allowed, so this
2377--       will always be false for procedures, but that is expected to change in
2378--       the future.
2379
2380--    Is_Hidden (Flag57)
2381--       Defined in all entities. Set for all entities declared in the
2382--       private part or body of a package. Also marks generic formals of a
2383--       formal package declared without a box. For library level entities,
2384--       this flag is set if the entity is not publicly visible. This flag
2385--       is reset when compiling the body of the package where the entity
2386--       is declared, when compiling the private part or body of a public
2387--       child unit, and when compiling a private child unit (see Install_
2388--       Private_Declaration in sem_ch7).
2389
2390--    Is_Hidden_Open_Scope (Flag171)
2391--       Defined in all entities. Set for a scope that contains the
2392--       instantiation of a child unit, and whose entities are not visible
2393--       during analysis of the instance.
2394
2395--    Is_Immediately_Visible (Flag7)
2396--       Defined in all entities. Set if entity is immediately visible, i.e.
2397--       is defined in some currently open scope (RM 8.3(4)).
2398
2399--    Is_Implementation_Defined (Flag254)
2400--       Defined in all entities. Set if a pragma Implementation_Defined is
2401--       applied to the pragma. Used to mark all implementation defined
2402--       identifiers in standard library packages, and to implement the
2403--       restriction No_Implementation_Identifiers.
2404
2405--    Is_Imported (Flag24)
2406--       Defined in all entities. Set if the entity is imported. For now we
2407--       only allow the import of exceptions, functions, procedures, packages.
2408--       and variables. Exceptions can only be imported in the OpenVMS and
2409--       Java VM implementations of GNAT. Packages and types can only be
2410--       imported in the Java VM implementation.
2411
2412--    Is_Incomplete_Or_Private_Type (synthesized)
2413--       Applies to all entities, true for private and incomplete types
2414
2415--    Is_Incomplete_Type (synthesized)
2416--       Applies to all entities, true for incomplete types and subtypes
2417
2418--    Is_Inlined (Flag11)
2419--       Defined in all entities. Set for functions and procedures which are
2420--       to be inlined. For subprograms created during expansion, this flag
2421--       may be set directly by the expander to request inlining. Also set
2422--       for packages that contain inlined subprograms, whose bodies must be
2423--       be compiled. Is_Inlined is also set on generic subprograms and is
2424--       inherited by their instances. It is also set on the body entities
2425--       of inlined subprograms. See also Has_Pragma_Inline.
2426
2427--    Is_Instantiated (Flag126)
2428--       Defined in generic packages and generic subprograms. Set if the unit
2429--       is instantiated from somewhere in the extended main source unit. This
2430--       flag is used to control warnings about the unit being uninstantiated.
2431--       Also set in a package that is used as an actual for a generic package
2432--       formal in an instantiation. Also set on a parent instance, in the
2433--       instantiation of a child, which is implicitly declared in the parent.
2434
2435--    Is_Integer_Type (synthesized)
2436--       Applies to all entities, true for integer types and subtypes
2437
2438--    Is_Interface (Flag186)
2439--       Defined in record types and subtypes. Set to indicate that the current
2440--       entity corresponds with an abstract interface. Because abstract
2441--       interfaces are conceptually a special kind of abstract tagged types
2442--       we represent them by means of tagged record types and subtypes
2443--       marked with this attribute. This allows us to reuse most of the
2444--       compiler support for abstract tagged types to implement interfaces
2445--       (Ada 2005: AI-251).
2446
2447--    Is_Internal (Flag17)
2448--       Defined in all entities. Set to indicate an entity created during
2449--       semantic processing (e.g. an implicit type, or a temporary). The
2450--       current uses of this flag are:
2451--
2452--         1) Internal entities (such as temporaries generated for the result
2453--         of an inlined function call or dummy variables generated for the
2454--         debugger). Set to indicate that they need not be initialized, even
2455--         when scalars are initialized or normalized;
2456--
2457--         2) Predefined primitives of tagged types. Set to mark that they
2458--         have specific properties: first they are primitives even if they
2459--         are not defined in the type scope (the freezing point is not
2460--         necessarily in the same scope), and second the predefined equality
2461--         can be overridden by a user-defined equality, no body will be
2462--         generated in this case.
2463--
2464--         3) Object declarations generated by the expander that are implicitly
2465--         imported or exported so that they can be marked in Sprint output.
2466--
2467--         4) Internal entities in the list of primitives of tagged types that
2468--         are used to handle secondary dispatch tables. These entities have
2469--         also the attribute Interface_Alias.
2470
2471--    Is_Interrupt_Handler (Flag89)
2472--       Defined in procedures. Set if a pragma Interrupt_Handler applies
2473--       to the procedure. The procedure must be parameterless, and on all
2474--       targets except AAMP it must be a protected procedure.
2475
2476--    Is_Intrinsic_Subprogram (Flag64)
2477--       Defined in functions and procedures. It is set if a valid pragma
2478--       Interface or Import is present for this subprogram specifying pragma
2479--       Intrinsic. Valid means that the name and profile of the subprogram
2480--       match the requirements of one of the recognized intrinsic subprograms
2481--       (see package Sem_Intr for details). Note: the value of Convention for
2482--       such an entity will be set to Convention_Intrinsic, but it is the
2483--       setting of Is_Intrinsic_Subprogram, NOT simply having convention set
2484--       to intrinsic, which causes intrinsic code to be generated.
2485
2486--    Is_Invariant_Procedure (Flag257)
2487--       Defined in functions an procedures. Set for a generated invariant
2488--       procedure to identify it easily in the
2489
2490--    Is_Itype (Flag91)
2491--       Defined in all entities. Set to indicate that a type is an Itype,
2492--       which means that the declaration for the type does not appear
2493--       explicitly in the tree. Instead gigi will elaborate the type when it
2494--       is first used. Has_Delayed_Freeze can be set for Itypes, and the
2495--       meaning is that the first use (the one which causes the type to be
2496--       defined) will be the freeze node. Note that an important restriction
2497--       on Itypes is that the first use of such a type (the one that causes it
2498--       to be defined) must be in the same scope as the type.
2499
2500--    Is_Known_Non_Null (Flag37)
2501--       Defined in all entities. Relevant (and can be set) only for
2502--       objects of an access type. It is set if the object is currently
2503--       known to have a non-null value (meaning that no access checks
2504--       are needed). The indication can for example come from assignment
2505--       of an access parameter or an allocator whose value is known non-null.
2506--
2507--       Note: this flag is set according to the sequential flow of the
2508--       program, watching the current value of the variable. However, this
2509--       processing can miss cases of changing the value of an aliased or
2510--       constant object, so even if this flag is set, it should not be
2511--       believed if the variable is aliased or volatile. It would be a
2512--       little neater to avoid the flag being set in the first place in
2513--       such cases, but that's trickier, and there is only one place that
2514--       tests the value anyway.
2515--
2516--       The flag is dynamically set and reset as semantic analysis and
2517--       expansion proceeds. Its value is meaningless once the tree is
2518--       fully constructed, since it simply indicates the last state.
2519--       Thus this flag has no meaning to the back end.
2520
2521--    Is_Known_Null (Flag204)
2522--       Defined in all entities. Relevant (and can be set ) only for
2523--       objects of an access type. It is set if the object is currently known
2524--       to have a null value (meaning that a dereference will surely raise
2525--       constraint error exception). The indication can come from an
2526--       assignment or object declaration.
2527--
2528--       The comments above about sequential flow and aliased and volatile for
2529--       the Is_Known_Non_Null flag apply equally to the Is_Known_Null flag.
2530
2531--    Is_Known_Valid (Flag170)
2532--       Defined in all entities. Relevant for types (and subtype) and
2533--       for objects (and enumeration literals) of a discrete type.
2534--
2535--       The purpose of this flag is to implement the requirement stated
2536--       in (RM 13.9.1(9-11)) which require that the use of possibly invalid
2537--       values may not cause programs to become erroneous. See the function
2538--       Checks.Expr_Known_Valid for further details. Note that the setting
2539--       is conservative, in the sense that if the flag is set, it must be
2540--       right. If the flag is not set, nothing is known about the validity.
2541--
2542--       For enumeration literals, the flag is always set, since clearly
2543--       an enumeration literal represents a valid value. Range checks
2544--       where necessary will ensure that this valid value is appropriate.
2545--
2546--       For objects, the flag indicates the state of knowledge about the
2547--       current value of the object. This may be modified during expansion,
2548--       and thus the final value is not relevant to gigi.
2549--
2550--       For types and subtypes, the flag is set if all possible bit patterns
2551--       of length Object_Size (i.e. Esize of the type) represent valid values
2552--       of the type. In general for such tytpes, all values are valid, the
2553--       only exception being the case where an object of the type has an
2554--       explicit size that is greater than Object_Size.
2555--
2556--       For non-discrete objects, the setting of the Is_Known_Valid flag is
2557--       not defined, and is not relevant, since the considerations of the
2558--       requirement in (RM 13.9.1(9-11)) do not apply.
2559--
2560--       The flag is dynamically set and reset as semantic analysis and
2561--       expansion proceeds. Its value is meaningless once the tree is
2562--       fully constructed, since it simply indicates the last state.
2563--       Thus this flag has no meaning to the back end.
2564
2565--    Is_Limited_Composite (Flag106)
2566--       Defined in all entities. Set for composite types that have a limited
2567--       component. Used to enforce the rule that operations on the composite
2568--       type that depend on the full view of the component do not become
2569--       visible until the immediate scope of the composite type itself
2570--       (RM 7.3.1 (5)).
2571
2572--    Is_Limited_Interface (Flag197)
2573--       Defined in record types and subtypes. True for interface types, if
2574--       interface is declared limited, task, protected, or synchronized, or
2575--       is derived from a limited interface.
2576
2577--    Is_Limited_Record (Flag25)
2578--       Defined in all entities. Set to true for record (sub)types if the
2579--       record is declared to be limited. Note that this flag is not set
2580--       simply because some components of the record are limited.
2581
2582--    Is_Local_Anonymous_Access (Flag194)
2583--       Defined in access types. Set for an anonymous access type to indicate
2584--       that the type is created for a record component with an access
2585--       definition, an array component, or (pre-Ada 2012) a standalone object.
2586--       Such anonymous types have an accessibility level equal to that of the
2587--       declaration in which they appear, unlike the anonymous access types
2588--       that are created for access parameters, access discriminants, and
2589--       (as of Ada 2012) stand-alone objects.
2590
2591--    Is_Machine_Code_Subprogram (Flag137)
2592--       Defined in subprogram entities. Set to indicate that the subprogram
2593--       is a machine code subprogram (i.e. its body includes at least one
2594--       code statement). Also indicates that all necessary semantic checks
2595--       as required by RM 13.8(3) have been performed.
2596
2597--    Is_Modular_Integer_Type (synthesized)
2598--       Applies to all entities. True if entity is a modular integer type
2599
2600--    Is_Non_Static_Subtype (Flag109)
2601--       Defined in all type and subtype entities. It is set in some (but not
2602--       all) cases in which a subtype is known to be non-static. Before this
2603--       flag was added, the computation of whether a subtype was static was
2604--       entirely synthesized, by looking at the bounds, and the immediate
2605--       subtype parent. However, this method does not work for some Itypes
2606--       that have no parent set (and the only way to find the immediate
2607--       subtype parent is to go through the tree). For now, this flag is set
2608--       conservatively, i.e. if it is set then for sure the subtype is non-
2609--       static, but if it is not set, then the type may or may not be static.
2610--       Thus the test for a static subtype is that this flag is clear AND that
2611--       the bounds are static AND that the parent subtype (if available to be
2612--       tested) is static. Eventually we should make sure this flag is always
2613--       set right, at which point, these comments can be removed, and the
2614--       tests for static subtypes greatly simplified.
2615
2616--    Is_Null_Init_Proc (Flag178)
2617--       Defined in procedure entities. Set for generated init proc procedures
2618--       (used to initialize composite types), if the code for the procedure
2619--       is null (i.e. is a return and nothing else). Such null initialization
2620--       procedures are generated in case some client is compiled using the
2621--       Initialize_Scalars pragma, generating a call to this null procedure,
2622--       but there is no need to call such procedures within a compilation
2623--       unit, and this flag is used to suppress such calls.
2624
2625--    Is_Null_State (synthesized)
2626--       Applies to all entities, true for an abstract state declared with
2627--       keyword null.
2628
2629--    Is_Numeric_Type (synthesized)
2630--       Applies to all entities, true for all numeric types and subtypes
2631--       (integer, fixed, float).
2632
2633--    Is_Object (synthesized)
2634--       Applies to all entities, true for entities representing objects,
2635--       including generic formal parameters.
2636
2637--    Is_Obsolescent (Flag153)
2638--       Defined in all entities. Set for any entity for which a valid pragma
2639--       Obsolescent applies.
2640
2641--    Is_Only_Out_Parameter (Flag226)
2642--       Defined in formal parameter entities. Set if this parameter is the
2643--       only OUT parameter for this formal part. If there is more than one
2644--       out parameter, or if there is some other IN OUT parameter then this
2645--       flag is not set in any of them. Used in generation of warnings.
2646
2647--    Is_Optional_Parameter (Flag134)
2648--       Defined in parameter entities. Set if the parameter is specified as
2649--       optional by use of a First_Optional_Parameter argument to one of the
2650--       extended Import pragmas. Can only be set for OpenVMS versions of GNAT.
2651
2652--    Is_Ordinary_Fixed_Point_Type (synthesized)
2653--       Applies to all entities, true for ordinary fixed point types and
2654--       subtypes.
2655
2656--    Is_Package_Or_Generic_Package (synthesized)
2657--       Applies to all entities. True for packages and generic packages.
2658--       False for all other entities.
2659
2660--    Is_Package_Body_Entity (Flag160)
2661--       Defined in all entities. Set for entities defined at the top level
2662--       of a package body. Used to control externally generated names.
2663
2664--    Is_Packed (Flag51) [implementation base type only]
2665--       Defined in all type entities. This flag is set only for record and
2666--       array types which have a packed representation. There are three
2667--       cases which cause packing:
2668--
2669--         1. Explicit use of pragma Pack for an array of package components
2670--         2. Explicit use of pragma Pack to pack a record
2671--         4. Setting Component_Size of an array to a bit-packable value
2672--         3. Indexing an array with a non-standard enumeration type.
2673--
2674--       For records, Is_Packed is always set if Has_Pragma_Pack is set,
2675--       and can also be set on its own in a derived type which inherited
2676--       its packed status.
2677--
2678--       For arrays, Is_Packed is set if an array is bit packed (i.e. the
2679--       component size is known at compile time and is 1-7, 9-15 or 17-31),
2680--       or if the array has one or more index types that are enumeration
2681--       types with non-standard representations (in GNAT, we store such
2682--       arrays compactly, using the Pos of the enumeration type value).
2683--
2684--       As for the case of records, Is_Packed can be set on its own for a
2685--       derived type, with the same dual before/after freeze meaning.
2686--       Is_Packed can also be set as the result of an explicit component
2687--       size clause that specifies an appropriate component size.
2688--
2689--       In the bit packed array case, Is_Bit_Packed_Array will be set in
2690--       the bit packed case once the array type is frozen.
2691--
2692--       Before an array type is frozen, Is_Packed will always be set if
2693--       Has_Pragma_Pack is set. Before the freeze point, it is not possible
2694--       to know the component size, since the component type is not frozen
2695--       until the array type is frozen. Thus Is_Packed for an array type
2696--       before it is frozen means that packed is required. Then if it turns
2697--       out that the component size is not suitable for bit packing, the
2698--       Is_Packed flag gets turned off.
2699
2700--    Is_Packed_Array_Type (Flag138)
2701--       Defined in all entities. This flag is set on the entity for the type
2702--       used to implement a packed array (either a modular type, or a subtype
2703--       of Packed_Bytes{1,2,4} as appropriate). The flag is set if and only
2704--       if the type appears in the Packed_Array_Type field of some other type
2705--       entity. It is used by Gigi to activate the special processing for such
2706--       types (unchecked conversions that would not otherwise be allowed are
2707--       allowed for such types). If the Is_Packed_Array_Type flag is set in
2708--       an entity, then the Original_Array_Type field of this entity points
2709--       to the original array type for which this is the packed array type.
2710
2711--    Is_Potentially_Use_Visible (Flag9)
2712--       Defined in all entities. Set if entity is potentially use visible,
2713--       i.e. it is defined in a package that appears in a currently active
2714--       use clause (RM 8.4(8)). Note that potentially use visible entities
2715--       are not necessarily use visible (RM 8.4(9-11)).
2716
2717--    Is_Predicate_Function (Flag255)
2718--       Present in functions and procedures. Set for generated predicate
2719--       functions.
2720
2721--    Is_Predicate_Function_M (Flag256)
2722--       Present in functions and procedures. Set for special version of
2723--       predicate function generated for use in membership tests, where
2724--       raise expressions are transformed to return False.
2725
2726--    Is_Preelaborated (Flag59)
2727--       Defined in all entities, set in E_Package and E_Generic_Package
2728--       entities to which a pragma Preelaborate is applied, and also in
2729--       all entities within such packages. Note that the fact that this
2730--       flag is set does not necesarily mean that no elaboration code is
2731--       generated for the package.
2732
2733--    Is_Primitive (Flag218)
2734--       Defined in overloadable entities and in generic subprograms. Set to
2735--       indicate that this is a primitive operation of some type, which may
2736--       be a tagged type or a non-tagged type. Used to verify overriding
2737--       indicators in bodies.
2738
2739--    Is_Primitive_Wrapper (Flag195)
2740--       Defined in functions and procedures created by the expander to serve
2741--       as an indirection mechanism to overriding primitives of concurrent
2742--       types, entries and protected procedures.
2743
2744--    Is_Prival (synthesized)
2745--       Applies to all entities, true for renamings of private protected
2746--       components. Such entities appear as constants or variables.
2747
2748--    Is_Private_Composite (Flag107)
2749--       Defined in composite types that have a private component. Used to
2750--       enforce the rule that operations on the composite type that depend
2751--       on the full view of the component, do not become visible until the
2752--       immediate scope of the composite type itself (7.3.1 (5)). Both this
2753--       flag and Is_Limited_Composite are needed.
2754
2755--    Is_Private_Descendant (Flag53)
2756--       Defined in entities that can represent library units (packages,
2757--       functions, procedures). Set if the library unit is itself a private
2758--       child unit, or if it is the descendent of a private child unit.
2759
2760--    Is_Private_Primitive (Flag245)
2761--       Defined in subprograms. Set if the operation is a primitive of a
2762--       tagged type (procedure or function dispatching on result) whose
2763--       full view has not been seen. Used in particular for primitive
2764--       subprograms of a synchronized type declared between the two views
2765--       of the type, so that the wrapper built for such a subprogram can
2766--       be given the proper signature.
2767
2768--    Is_Private_Type (synthesized)
2769--       Applies to all entities, true for private types and subtypes,
2770--       as well as for record with private types as subtypes
2771
2772--    Is_Processed_Transient (Flag252)
2773--       Defined in entities of variables and constants. Set when a transient
2774--       object needs to be finalized and it has already been processed by the
2775--       transient scope machinery. This flag signals the general finalization
2776--       mechanism to ignore the transient object.
2777
2778--    Is_Protected_Component (synthesized)
2779--       Applicable to all entities, true if the entity denotes a private
2780--       component of a protected type.
2781
2782--    Is_Protected_Interface (synthesized)
2783--       Defined in types that are interfaces. True if interface is declared
2784--       protected, or is derived from protected interfaces.
2785
2786--    Is_Protected_Type (synthesized)
2787--       Applies to all entities, true for protected types and subtypes
2788
2789--    Is_Public (Flag10)
2790--       Defined in all entities. Set to indicate that an entity defined in
2791--       one compilation unit can be referenced from other compilation units.
2792--       If this reference causes a reference in the generated variable, for
2793--       example in the case of a variable name, then Gigi will generate an
2794--       appropriate external name for use by the linker.
2795
2796--    Is_Protected_Record_Type (synthesized)
2797--       Applies to all entities, true if Is_Concurrent_Record_Type is true and
2798--       Corresponding_Concurrent_Type is a protected type.
2799
2800--    Is_Pure (Flag44)
2801--       Defined in all entities. Set in all entities of a unit to which a
2802--       pragma Pure is applied except for non-intrinsic imported subprograms,
2803--       and also set for the entity of the unit itself. In addition, this
2804--       flag may be set for any other functions or procedures that are known
2805--       to be side effect free, so in the case of subprograms, the Is_Pure
2806--       flag may be used by the optimizer to imply that it can assume freedom
2807--       from side effects (other than those resulting from assignment to out
2808--       parameters, or to objects designated by access parameters).
2809
2810--    Is_Pure_Unit_Access_Type (Flag189)
2811--       Defined in access type and subtype entities. Set if the type or
2812--       subtype appears in a pure unit. Used to give an error message at
2813--       freeze time if the access type has a storage pool.
2814
2815--    Is_RACW_Stub_Type (Flag244)
2816--       Defined in all types, true for the stub types generated for remote
2817--       access-to-class-wide types.
2818
2819--    Is_Raised (Flag224)
2820--       Defined in exception entities. Set if the entity is referenced by a
2821--       a raise statement.
2822
2823--    Is_Real_Type (synthesized)
2824--       Applies to all entities, true for real types and subtypes
2825
2826--    Is_Record_Type (synthesized)
2827--       Applies to all entities, true for record types and subtypes,
2828--       includes class-wide types and subtypes (which are also records)
2829
2830--    Is_Remote_Call_Interface (Flag62)
2831--       Defined in all entities. Set in E_Package and E_Generic_Package
2832--       entities to which a pragma Remote_Call_Interface is applied, and
2833--       also on entities declared in the visible part of such a package.
2834
2835--    Is_Remote_Types (Flag61)
2836--       Defined in all entities. Set in E_Package and E_Generic_Package
2837--       entities to which a pragma Remote_Types is applied, and also on
2838--       entities declared in the visible part of the spec of such a package.
2839--       Also set for types which are generic formal types to which the
2840--       pragma Remote_Access_Type applies.
2841
2842--    Is_Renaming_Of_Object (Flag112)
2843--       Defined in all entities, set only for a variable or constant for
2844--       which the Renamed_Object field is non-empty and for which the
2845--       renaming is handled by the front end, by macro substitution of
2846--       a copy of the (evaluated) name tree whereever the variable is used.
2847
2848--    Is_Return_Object (Flag209)
2849--       Defined in all object entities. True if the object is the return
2850--       object of an extended_return_statement; False otherwise.
2851
2852--    Is_Safe_To_Reevaluate (Flag249)
2853--       Defined in all entities. Set in variables that are initialized by
2854--       means of an assignment statement. When initialized their contents
2855--       never change and hence they can be seen by the backend as constants.
2856--       See also Is_True_Constant.
2857
2858--    Is_Scalar_Type (synthesized)
2859--       Applies to all entities, true for scalar types and subtypes
2860
2861--    Is_Shared_Passive (Flag60)
2862--       Defined in all entities. Set in E_Package and E_Generic_Package
2863--       entities to which a pragma Shared_Passive is applied, and also in
2864--       all entities within such packages.
2865
2866--    Is_Standard_Character_Type (synthesized)
2867--       Applies to all entities, true for types and subtypes whose root type
2868--       is one of the standard character types (Character, Wide_Character,
2869--       Wide_Wide_Character).
2870
2871--    Is_Statically_Allocated (Flag28)
2872--       Defined in all entities. This can only be set for exception,
2873--       variable, constant, and type/subtype entities. If the flag is set,
2874--       then the variable or constant must be allocated statically rather
2875--       than on the local stack frame. For exceptions, the meaning is that
2876--       the exception data should be allocated statically (and indeed this
2877--       flag is always set for exceptions, since exceptions do not have
2878--       local scope). For a type, the meaning is that the type must be
2879--       elaborated at the global level rather than locally. No type marked
2880--       with this flag may depend on a local variable, or on any other type
2881--       which does not also have this flag set to True. For a variable or
2882--       or constant, if the flag is set, then the type of the object must
2883--       either be declared at the library level, or it must also have the
2884--       flag set (since to allocate the object statically, its type must
2885--       also be elaborated globally).
2886
2887--    Is_String_Type (synthesized)
2888--       Applies to all type entities. Determines if the given type is a
2889--       string type, i.e. it is directly a string type or string subtype,
2890--       or a string slice type, or an array type with one dimension and a
2891--       component type that is a character type.
2892
2893--    Is_Subprogram (synthesized)
2894--       Applies to all entities, true for function, procedure and operator
2895--       entities.
2896
2897--    Is_Synchronized_Interface (synthesized)
2898--       Defined in types that are interfaces. True if interface is declared
2899--       synchronized, task, or protected, or is derived from a synchronized
2900--       interface.
2901
2902--    Is_Tag (Flag78)
2903--       Defined in E_Component and E_Constant entities. For regular tagged
2904--       type this flag is set on the tag component (whose name is Name_uTag).
2905--       For CPP_Class tagged types, this flag marks the pointer to the main
2906--       vtable (i.e. the one to be extended by derivation).
2907
2908--    Is_Tagged_Type (Flag55)
2909--       Defined in all entities. Set for an entity for a tagged type.
2910
2911--    Is_Task_Interface (synthesized)
2912--       Defined in types that are interfaces. True if interface is declared as
2913--       a task interface, or if it is derived from task interfaces.
2914
2915--    Is_Task_Record_Type (synthesized)
2916--       Applies to all entities. True if Is_Concurrent_Record_Type
2917--       Corresponding_Concurrent_Type is a task type.
2918
2919--    Is_Task_Type (synthesized)
2920--       Applies to all entities. True for task types and subtypes
2921
2922--    Is_Thunk (Flag225)
2923--       Defined in all entities. True for subprograms that are thunks: that is
2924--       small subprograms built by the expander for tagged types that cover
2925--       interface types. As part of the runtime call to an interface, thunks
2926--       displace the pointer to the object (pointer named "this" in the C++
2927--       terminology) from a secondary dispatch table to the primary dispatch
2928--       table associated with a given tagged type; if the thunk is a function
2929--       that returns an object which covers an interface type then the thunk
2930--       displaces the pointer to the object from the primary dispatch table to
2931--       the secondary dispatch table associated with the interface type. Set
2932--       by Expand_Interface_Thunk and used by Expand_Call to handle extra
2933--       actuals associated with accessibility level.
2934
2935--    Is_Trivial_Subprogram (Flag235)
2936--       Defined in all entities. Set in subprograms where either the body
2937--       consists of a single null statement, or the first or only statement
2938--       of the body raises an exception. This is used for suppressing certain
2939--       warnings, see Sem_Ch6.Analyze_Subprogram_Body discussion for details.
2940
2941--    Is_True_Constant (Flag163)
2942--       Defined in all entities for constants and variables. Set in constants
2943--       and variables which have an initial value specified but which are
2944--       never assigned, partially or in the whole. For variables, it means
2945--       that the variable was initialized but never modified, and hence can be
2946--       treated as a constant by the code generator. For a constant, it means
2947--       that the constant was not modified by generated code (e.g. to set a
2948--       discriminant in an init proc). Assignments by user or generated code
2949--       will reset this flag. See also Is_Safe_To_Reevaluate.
2950
2951--    Is_Type (synthesized)
2952--       Applies to all entities, true for a type entity
2953
2954--    Is_Unchecked_Union (Flag117) [implementation base type only]
2955--       Defined in all entities. Set only in record types to which the
2956--       pragma Unchecked_Union has been validly applied.
2957
2958--    Is_Underlying_Record_View (Flag246) [base type only]
2959--       Defined in all entities. Set only in record types that represent the
2960--       underlying record view. This view is built for derivations of types
2961--       with unknown discriminants; it is a record with the same structure
2962--       as its corresponding record type, but whose parent is the full view
2963--       of the parent in the original type extension.
2964
2965--    Is_Unsigned_Type (Flag144)
2966--       Defined in all types, but can be set only for discrete and fixed-point
2967--       type and subtype entities. This flag is only valid if the entity is
2968--       frozen. If set it indicates that the representation is known to be
2969--       unsigned (i.e. that no negative values appear in the range). This is
2970--       normally just a reflection of the lower bound of the subtype or base
2971--       type, but there is one case in which the setting is non-obvious,
2972--       namely the case of an unsigned subtype of a signed type from which
2973--       a further subtype is obtained using variable bounds. This further
2974--       subtype is still unsigned, but this cannot be determined by looking
2975--       at its bounds or the bounds of the corresponding base type.
2976
2977--    Is_Valued_Procedure (Flag127)
2978--       Defined in procedure entities. Set if an Import_Valued_Procedure
2979--       or Export_Valued_Procedure pragma applies to the procedure entity.
2980
2981--    Is_Visible_Formal (Flag206)
2982--       Defined in all entities. Set for instances of the formals of a
2983--       formal package. Indicates that the entity must be made visible in the
2984--       body of the instance, to reproduce the visibility of the generic.
2985--       This simplifies visibility settings in instance bodies.
2986
2987--    Is_Visible_Lib_Unit (Flag116)
2988--       Defined in all (root or child) library unit entities. Once compiled,
2989--       library units remain chained to the entities in the parent scope, and
2990--       a separate flag must be used to indicate whether the names are visible
2991--       by selected notation, or not.
2992
2993--    Is_VMS_Exception (Flag133)
2994--       Defined in all entities. Set only for exception entities where the
2995--       exception was specified in an Import_Exception or Export_Exception
2996--       pragma with the VMS option for Form. See description of these pragmas
2997--       for details. This flag can only be set in OpenVMS versions of GNAT.
2998
2999--    Is_Volatile (Flag16)
3000--       Defined in all type entities, and also in constants, components and
3001--       variables. Set if a pragma Volatile applies to the entity. Also set
3002--       if pragma Shared or pragma Atomic applies to entity. In the case of
3003--       private or incomplete types, this flag is set in both the private
3004--       and full view. The flag is not set reliably on private subtypes,
3005--       and is always retrieved from the base type (but this is not a base-
3006--       type-only attribute because it applies to other entities). Note that
3007--       the back end should use Treat_As_Volatile, rather than Is_Volatile
3008--       to indicate code generation requirements for volatile variables.
3009--       Similarly, any front end test which is concerned with suppressing
3010--       optimizations on volatile objects should test Treat_As_Volatile
3011--       rather than testing this flag.
3012
3013--    Is_Wrapper_Package (synthesized)
3014--       Defined in package entities. Indicates that the package has been
3015--       created as a wrapper for a subprogram instantiation.
3016
3017--    Itype_Printed (Flag202)
3018--       Defined in all type and subtype entities. Set in Itypes if the Itype
3019--       has been printed by Sprint. This is used to avoid printing an Itype
3020--       more than once.
3021
3022--    Kill_Elaboration_Checks (Flag32)
3023--       Defined in all entities. Set by the expander to kill elaboration
3024--       checks which are known not to be needed. Equivalent in effect to
3025--       the use of pragma Suppress (Elaboration_Checks) for that entity
3026--       except that the effect is permanent and cannot be undone by a
3027--       subsequent pragma Unsuppress.
3028
3029--    Kill_Range_Checks (Flag33)
3030--       Defined in all entities. Equivalent in effect to the use of pragma
3031--       Suppress (Range_Checks) for that entity except that the result is
3032--       permanent and cannot be undone by a subsequent pragma Unsuppress.
3033--       This is currently only used in one odd situation in Sem_Ch3 for
3034--       record types, and it would be good to get rid of it???
3035
3036--    Known_To_Have_Preelab_Init (Flag207)
3037--       Defined in all type and subtype entities. If set, then the type is
3038--       known to have preelaborable initialization. In the case of a partial
3039--       view of a private type, it is only possible for this to be set if a
3040--       pragma Preelaborable_Initialization is given for the type. For other
3041--       types, it is never set if the type does not have preelaborable
3042--       initialization, it may or may not be set if the type does have
3043--       preelaborable initialization.
3044
3045--    Last_Aggregate_Assignment (Node11)
3046--       Applies to controlled variables initialized by an aggregate. Points to
3047--       the last statement associated with the expansion of the aggregate. The
3048--       attribute is used by the finalization machinery when marking an object
3049--       as successfully initialized.
3050
3051--    Last_Assignment (Node26)
3052--       Defined in entities for variables, and OUT or IN OUT formals. Set for
3053--       a local variable or formal to point to the left side of an assignment
3054--       statement assigning a value to the variable. Cleared if the value of
3055--       the entity is referenced. Used to warn about dubious assignment
3056--       statements whose value is not used.
3057
3058--    Last_Entity (Node20)
3059--       Defined in all entities which act as scopes to which a list of
3060--       associated entities is attached (blocks, class subtypes and types,
3061--       entries, functions, loops, packages, procedures, protected objects,
3062--       record types and subtypes, private types, task types and subtypes).
3063--       Points to the last entry in the list of associated entities chained
3064--       through the Next_Entity field. Empty if no entities are chained.
3065
3066--    Last_Formal (synthesized)
3067--       Applies to subprograms and subprogram types, and also in entries
3068--       and entry families. Returns last formal of the subprogram or entry.
3069--       The formals are the first entities declared in a subprogram or in
3070--       a subprogram type (the designated type of an Access_To_Subprogram
3071--       definition) or in an entry.
3072
3073--    Limited_View (Node23)
3074--       Defined in non-generic package entities that are not instances. Bona
3075--       fide package with the limited-view list through the first_entity and
3076--       first_private attributes. The elements of this list are the shadow
3077--       entities created for the types and local packages that are declared
3078--       in a package appearing in a limited_with clause (Ada 2005: AI-50217).
3079
3080--    Linker_Section_Pragma (Node33)
3081--       Present in constant, variable, type and subprogram entities. Points
3082--       to a linker section pragma that applies to the entity, or is Empty if
3083--       no such pragma applies. Note that for constants and variables, this
3084--       field may be set as a result of a linker section pragma applied to the
3085--       type of the object.
3086
3087--    Lit_Indexes (Node15)
3088--       Defined in enumeration types and subtypes. Non-empty only for the
3089--       case of an enumeration root type, where it contains the entity for
3090--       the generated indexes entity. See unit Exp_Imgv for full details of
3091--       the nature and use of this entity for implementing the Image and
3092--       Value attributes for the enumeration type in question.
3093
3094--    Lit_Strings (Node16)
3095--       Defined in enumeration types and subtypes. Non-empty only for the
3096--       case of an enumeration root type, where it contains the entity for
3097--       the literals string entity. See unit Exp_Imgv for full details of
3098--       the nature and use of this entity for implementing the Image and
3099--       Value attributes for the enumeration type in question.
3100
3101--    Low_Bound_Tested (Flag205)
3102--       Defined in all entities. Currently this can only be set for formal
3103--       parameter entries of a standard unconstrained one-dimensional array
3104--       or string type. Indicates that an explicit test of the low bound of
3105--       the formal appeared in the code, e.g. in a pragma Assert. If this
3106--       flag is set, warnings about assuming the index low bound to be one
3107--       are suppressed.
3108
3109--    Machine_Radix_10 (Flag84)
3110--       Defined in decimal types and subtypes, set if the Machine_Radix is 10,
3111--       as the result of the specification of a machine radix representation
3112--       clause. Note that it is possible for this flag to be set without
3113--       having Has_Machine_Radix_Clause True. This happens when a type is
3114--       derived from a type with a clause present.
3115
3116--    Master_Id (Node17)
3117--       Defined in access types and subtypes. Empty unless Has_Task is
3118--       set for the designated type, in which case it points to the entity
3119--       for the Master_Id for the access type master. Also set for access-to-
3120--       limited-class-wide types whose root may be extended with task
3121--       components, and for access-to-limited-interfaces because they can be
3122--       used to reference tasks implementing such interface.
3123
3124--    Materialize_Entity (Flag168)
3125--       Defined in all entities. Set only for renamed obects which should be
3126--       materialized for debugging purposes. This means that a memory location
3127--       containing the renamed address should be allocated. This is needed so
3128--       that the debugger can find the entity.
3129
3130--    May_Inherit_Delayed_Rep_Aspects (Flag262)
3131--       Defined in all entities for types and subtypes. Set if the type is
3132--       derived from a type which has delayed rep aspects (marked by the flag
3133--       Has_Delayed_Rep_Aspects being set). In this case, at the freeze point
3134--       for the derived type we know that the parent type is frozen, and if
3135--       a given attribute has not been set for the derived type, we copy the
3136--       value from the parent type. See Freeze.Inherit_Delayed_Rep_Aspects.
3137
3138--    Mechanism (Uint8) (returned as Mechanism_Type)
3139--       Defined in functions and non-generic formal parameters. Indicates
3140--       the mechanism to be used for the function return or for the formal
3141--       parameter. See separate section on passing mechanisms. This field
3142--       is also set (to the default value of zero) in a subprogram body
3143--       entity but not used in this context.
3144
3145--    Modulus (Uint17) [base type only]
3146--       Defined in modular types. Contains the modulus. For the binary case,
3147--       this will be a power of 2, but if Non_Binary_Modulus is set, then it
3148--       will not be a power of 2.
3149
3150--    Must_Be_On_Byte_Boundary (Flag183)
3151--       Defined in entities for types and subtypes. Set if objects of the type
3152--       must always be allocated on a byte boundary (more accurately a storage
3153--       unit boundary). The front end checks that component clauses respect
3154--       this rule, and the back end ensures that record packing does not
3155--       violate this rule. Currently the flag is set only for packed arrays
3156--       longer than 64 bits where the component size is not a power of 2.
3157
3158--    Must_Have_Preelab_Init (Flag208)
3159--       Defined in entities for types and subtypes. Set in the full type of a
3160--       private type or subtype if a pragma Has_Preelaborable_Initialization
3161--       is present for the private type. Used to check that the full type has
3162--       preelaborable initialization at freeze time (this has to be deferred
3163--       to the freeze point because of the rule about overriding Initialize).
3164
3165--    Needs_Debug_Info (Flag147)
3166--       Defined in all entities. Set if the entity requires normal debugging
3167--       information to be generated. This is true of all entities that have
3168--       Comes_From_Source set, and also transitively for entities associated
3169--       with such components (e.g. their types). It is true for all entities
3170--       in Debug_Generated_Code mode (-gnatD switch). This is the flag that
3171--       the back end should check to determine whether or not to generate
3172--       debugging information for an entity. Note that callers should always
3173--       use Sem_Util.Set_Debug_Info_Needed, rather than Set_Needs_Debug_Info,
3174--       so that the flag is set properly on subsidiary entities.
3175
3176--    Needs_No_Actuals (Flag22)
3177--       Defined in callable entities (subprograms, entries, access to
3178--       subprograms)  which can be called without actuals because all of
3179--       their formals (if any) have default values. This flag simplifies the
3180--       resolution of the syntactic ambiguity involving a call to these
3181--       entities when the return type is an array type, and a call can be
3182--       interpreted as an indexing of the result of the call. It is also
3183--       used to resolve various cases of entry calls.
3184
3185--    Never_Set_In_Source (Flag115)
3186--       Defined in all entities, but can be set only for variables and
3187--       parameters. This flag is set if the object is never assigned a value
3188--       in user source code, either by assignment or by being used as an out
3189--       or in out parameter. Note that this flag is not reset from using an
3190--       initial value, so if you want to test for this case as well, test the
3191--       Has_Initial_Value flag also.
3192--
3193--       This flag is only for the purposes of issuing warnings, it must not
3194--       be used by the code generator to indicate that the variable is in
3195--       fact a constant, since some assignments in generated code do not
3196--       count (for example, the call to an init proc to assign some but
3197--       not all of the fields in a partially initialized record). The code
3198--       generator should instead use the flag Is_True_Constant.
3199--
3200--       For the purposes of this warning, the default assignment of
3201--       access variables to null is not considered the assignment of
3202--       of a value (so the warning can be given for code that relies
3203--       on this initial null value, when no other value is ever set).
3204--
3205--       In variables and out parameters, if this flag is set after full
3206--       processing of the corresponding declarative unit, it indicates that
3207--       the variable or parameter was never set, and a warning message can
3208--       be issued.
3209--
3210--       Note: this flag is initially set, and then cleared on encountering
3211--       any construct that might conceivably legitimately set the value.
3212--       Thus during the analysis of a declarative region and its associated
3213--       statement sequence, the meaning of the flag is "not set yet", and
3214--       once this analysis is complete the flag means "never assigned".
3215
3216--       Note: for variables appearing in package declarations, this flag
3217--       is never set. That is because there is no way to tell if some
3218--       client modifies the variable (or in the case of variables in the
3219--       private part, if some child unit modifies the variables).
3220
3221--       Note: in the case of renamed objects, the flag must be set in the
3222--       ultimate renamed object. Clients noting a possible modification
3223--       should use the Note_Possible_Modification procedure in Sem_Util
3224--       rather than Set_Never_Set_In_Source precisely to deal properly with
3225--       the renaming possibility.
3226
3227--    Next_Component (synthesized)
3228--       Applies to record components. Returns the next component by following
3229--       the chain of declared entities until one is found which corresponds to
3230--       a component (Ekind is E_Component). Any internal types generated from
3231--       the subtype indications of the record components are skipped. Returns
3232--       Empty if no more components.
3233
3234--    Next_Component_Or_Discriminant (synthesized)
3235--      Similar to Next_Component, but includes components and discriminants
3236--      so the input can have either E_Component or E_Discriminant, and the
3237--      same is true for the result. Returns Empty if no more components or
3238--      discriminants in the record.
3239
3240--    Next_Discriminant (synthesized)
3241--       Applies to discriminants returned by First/Next_Discriminant.
3242--       Returns the next language-defined (ie: perhaps non-girder)
3243--       discriminant by following the chain of declared entities as long as
3244--       the kind of the entity corresponds to a discriminant. Note that the
3245--       discriminants might be the only components of the record.
3246--       Returns Empty if there are no more.
3247
3248--    Next_Entity (Node2)
3249--       Defined in all entities. The entities of a scope are chained, with
3250--       the head of the list being in the First_Entity field of the scope
3251--       entity. All entities use the Next_Entity field as a forward pointer
3252--       for this list, with Empty indicating the end of the list. Since this
3253--       field is in the base part of the entity, the access routines for this
3254--       field are in Sinfo.
3255
3256--    Next_Formal (synthesized)
3257--       Applies to the entity for a formal parameter. Returns the next
3258--       formal parameter of the subprogram or subprogram type. Returns
3259--       Empty if there are no more formals.
3260
3261--    Next_Formal_With_Extras (synthesized)
3262--       Applies to the entity for a formal parameter. Returns the next
3263--       formal parameter of the subprogram or subprogram type. Returns
3264--       Empty if there are no more formals. The list returned includes
3265--       all the extra formals (see description of Extra_Formal field)
3266
3267--    Next_Index (synthesized)
3268--       Applies to array types and subtypes and to string types and
3269--       subtypes. Yields the next index. The first index is obtained by
3270--       using the First_Index attribute, and then subsequent indexes are
3271--       obtained by applying Next_Index to the previous index. Empty is
3272--       returned to indicate that there are no more indexes. Note that
3273--       unlike most attributes in this package, Next_Index applies to
3274--       nodes for the indexes, not to entities.
3275
3276--    Next_Inlined_Subprogram (Node12)
3277--       Defined in subprograms. Used to chain inlined subprograms used in
3278--       the current compilation, in the order in which they must be compiled
3279--       by Gigi to insure that all inlinings are performed.
3280
3281--    Next_Literal (synthesized)
3282--       Applies to enumeration literals, returns the next literal, or
3283--       Empty if applied to the last literal. This is actually a synonym
3284--       for Next, but its use is preferred in this context.
3285
3286--    Non_Binary_Modulus (Flag58) [base type only]
3287--       Defined in all subtype and type entities. Set for modular integer
3288--       types if the modulus value is other than a power of 2.
3289
3290--    Non_Limited_View (Node17)
3291--       Defined in abstract states and incomplete types that act as shadow
3292--       entities created when analysing a limited with clause (Ada 2005:
3293--       AI-50217). Points to the defining entity of the original declaration.
3294
3295--    Nonzero_Is_True (Flag162) [base type only]
3296--       Defined in enumeration types. Set if any non-zero value is to be
3297--       interpreted as true. Currently this is set for derived Boolean
3298--       types which have a convention of C, C++ or Fortran.
3299
3300--    No_Pool_Assigned (Flag131) [root type only]
3301--       Defined in access types. Set if a storage size clause applies to the
3302--       variable with a static expression value of zero. This flag is used to
3303--       generate errors if any attempt is made to allocate or free an instance
3304--       of such an access type. This is set only in the root type, since
3305--       derived types must have the same pool.
3306
3307--    No_Return (Flag113)
3308--       Defined in all entities. Always false except in the case of procedures
3309--       and generic procedures for which a pragma No_Return is given.
3310
3311--    Normalized_First_Bit (Uint8)
3312--       Defined in components and discriminants. Indicates the normalized
3313--       value of First_Bit for the component, i.e. the offset within the
3314--       lowest addressed storage unit containing part or all of the field.
3315--       Set to No_Uint if no first bit position is assigned yet.
3316
3317--    Normalized_Position (Uint14)
3318--       Defined in components and discriminants. Indicates the normalized
3319--       value of Position for the component, i.e. the offset in storage
3320--       units from the start of the record to the lowest addressed storage
3321--       unit containing part or all of the field.
3322
3323--    Normalized_Position_Max (Uint10)
3324--       Defined in components and discriminants. For almost all cases, this
3325--       is the same as Normalized_Position. The one exception is for the case
3326--       of a discriminated record containing one or more arrays whose length
3327--       depends on discriminants. In this case, the Normalized_Position_Max
3328--       field represents the maximum possible value of Normalized_Position
3329--       assuming min/max values for discriminant subscripts in all fields.
3330--       This is used by Layout in front end layout mode to properly computed
3331--       the maximum size such records (needed for allocation purposes when
3332--       there are default discriminants, and also for the 'Size value).
3333
3334--    No_Strict_Aliasing (Flag136) [base type only]
3335--       Defined in access types. Set to direct the back end to avoid any
3336--       optimizations based on an assumption about the aliasing status of
3337--       objects designated by the access type. For the case of the gcc
3338--       back end, the effect is as though all references to objects of
3339--       the type were compiled with -fno-strict-aliasing. This flag is
3340--       set if an unchecked conversion with the access type as a target
3341--       type occurs in the same source unit as the declaration of the
3342--       access type, or if an explicit pragma No_Strict_Aliasing applies.
3343
3344--    Number_Dimensions (synthesized)
3345--       Applies to array types and subtypes. Returns the number of dimensions
3346--       of the array type or subtype as a value of type Pos.
3347
3348--    Number_Entries (synthesized)
3349--       Applies to concurrent types. Returns the number of entries that are
3350--       declared within the task or protected definition for the type.
3351
3352--    Number_Formals (synthesized)
3353--       Applies to subprograms and subprogram types. Yields the number of
3354--       formals as a value of type Pos.
3355
3356--    OK_To_Rename (Flag247)
3357--       Defined only in entities for variables. If this flag is set, it
3358--       means that if the entity is used as the initial value of an object
3359--       declaration, the object declaration can be safely converted into a
3360--       renaming to avoid an extra copy. This is set for variables which are
3361--       generated by the expander to hold the result of evaluating some
3362--       expression. Most notably, the local variables used to store the result
3363--       of concatenations are so marked (see Exp_Ch4.Expand_Concatenate). It
3364--       is only worth setting this flag for composites, since for primitive
3365--       types, it is cheaper to do the copy.
3366
3367--    OK_To_Reorder_Components (Flag239) [base type only]
3368--       Defined in record types. Set if the back end is permitted to reorder
3369--       the components. If not set, the record must be layed out in the order
3370--       in which the components are declared textually. Currently this flag
3371--       can only be set by debug switches.
3372
3373--    Optimize_Alignment_Space (Flag241)
3374--       Defined in type, subtype, variable, and constant entities. This
3375--       flag records that the type or object is to be layed out in a manner
3376--       consistent with Optimize_Alignment (Space) mode. The compiler and
3377--       binder ensure a consistent view of any given type or object. If pragma
3378--       Optimize_Alignment (Off) mode applies to the type/object, then neither
3379--       of the flags Optimize_Alignment_Space/Optimize_Alignment_Time is set.
3380
3381--    Optimize_Alignment_Time (Flag242)
3382--       Defined in type, subtype, variable, and constant entities. This
3383--       flag records that the type or object is to be layed out in a manner
3384--       consistent with Optimize_Alignment (Time) mode. The compiler and
3385--       binder ensure a consistent view of any given type or object. If pragma
3386--       Optimize_Alignment (Off) mode applies to the type/object, then neither
3387--       of the flags Optimize_Alignment_Space/Optimize_Alignment_Time is set.
3388
3389--    Original_Access_Type (Node26)
3390--       Defined in E_Access_Subprogram_Type entities. Set only if the access
3391--       type was generated by the expander as part of processing an access
3392--       to protected subprogram type. Points to the access to protected
3393--       subprogram type.
3394
3395--    Original_Array_Type (Node21)
3396--       Defined in modular types and array types and subtypes. Set only
3397--       if the Is_Packed_Array_Type flag is set, indicating that the type
3398--       is the implementation type for a packed array, and in this case it
3399--       points to the original array type for which this is the packed
3400--       array implementation type.
3401
3402--    Original_Record_Component (Node22)
3403--       Defined in components, including discriminants. The usage depends
3404--       on whether the record is a base type and whether it is tagged.
3405--
3406--       In base tagged types:
3407--         When the component is inherited in a record extension, it points
3408--         to the original component (the entity of the ancestor component
3409--         which is not itself inherited) otherwise it points to itself.
3410--         Gigi uses this attribute to implement the automatic dereference in
3411--         the extension and to apply the transformation:
3412--
3413--            Rec_Ext.Comp -> Rec_Ext.Parent. ... .Parent.Comp
3414--
3415--       In base non-tagged types:
3416--         Always points to itself except for non-girder discriminants, where
3417--         it points to the girder discriminant it renames.
3418--
3419--       In subtypes (tagged and untagged):
3420--         Points to the component in the base type.
3421
3422--    Overlays_Constant (Flag243)
3423--       Defined in all entities. Set only for a variable for which there is
3424--       an address clause which causes the variable to overlay a constant.
3425
3426--    Overridden_Operation (Node26)
3427--       Defined in subprograms. For overriding operations, points to the
3428--       user-defined parent subprogram that is being overridden. Note: this
3429--       attribute uses the same field as Static_Initialization. The latter
3430--       is only defined for internal initialization procedures, for which
3431--       Overridden_Operation is irrelevant. Thus this attribute must not be
3432--       set for init_procs.
3433
3434--    Package_Instantiation (Node26)
3435--       Defined in packages and generic packages. When defined, this field
3436--       references an N_Generic_Instantiation node associated with an
3437--       instantiated package. In the case where the referenced node has
3438--       been rewritten to an N_Package_Specification, the instantiation
3439--       node is available from the Original_Node field of the package spec
3440--       node. This is currently not guaranteed to be set in all cases, but
3441--       when set, the field is used in Get_Package_Instantiation_Node as
3442--       one of the means of obtaining the instantiation node. Eventually
3443--       it should be set in all cases, including package entities associated
3444--       with formal packages. ???
3445
3446--    Packed_Array_Type (Node23)
3447--       Defined in array types and subtypes, including the string literal
3448--       subtype case, if the corresponding type is packed (either bit packed
3449--       or packed to eliminate holes in non-contiguous enumeration type index
3450--       types). References the type used to represent the packed array, which
3451--       is either a modular type for short static arrays, or an array of
3452--       System.Unsigned. Note that in some situations (internal types, and
3453--       references to fields of variant records), it is not always possible
3454--       to construct this type in advance of its use. If Packed_Array_Type
3455--       is empty, then the necessary type is declared on the fly for each
3456--       reference to the array.
3457
3458--    Parameter_Mode (synthesized)
3459--       Applies to formal parameter entities. This is a synonym for Ekind,
3460--       used when obtaining the formal kind of a formal parameter (the result
3461--       is one of E_[In/Out/In_Out]_Parameter)
3462
3463--    Parent_Subtype (Node19) [base type only]
3464--       Defined in E_Record_Type. Set only for derived tagged types, in which
3465--       case it points to the subtype of the parent type. This is the type
3466--       that is used as the Etype of the _parent field.
3467
3468--    Part_Of_Constituents (Elist9)
3469--       Present in abstract state entities. Contains all constituents that are
3470--       subject to indicator Part_Of (both aspect and option variants).
3471
3472--    Postcondition_Proc (Node8)
3473--       Defined only in procedure entities, saves the entity of the generated
3474--       postcondition proc if one is present, otherwise is set to Empty. Used
3475--       to generate the call to this procedure in case the expander inserts
3476--       implicit return statements.
3477
3478--    PPC_Wrapper (Node25)
3479--       Defined in entries and entry families. Set only if pre- or post-
3480--       conditions are present. The precondition_wrapper body is the original
3481--       entry call, decorated with the given precondition for the entry.
3482
3483--    Predicate_Function (synthesized)
3484--       Defined in all types. Set for types for which (Has_Predicates is True)
3485--       and for which a predicate procedure has been built that tests that the
3486--       specified predicates are True. Contains the entity for the function
3487--       which takes a single argument of the given type, and returns True if
3488--       the predicate holds and False if it does not.
3489--
3490--       Note: the reason this is marked as a synthesized attribute is that the
3491--       way this is stored is as an element of the Subprograms_For_Type field.
3492
3493--    Predicate_Function_M (synthesized)
3494--       Defined in all types. Present only if Predicate_Function is present,
3495--       and only if the predicate function has Raise_Expression nodes. It
3496--       is the special version created for membership tests, where if one of
3497--       these raise expressions is executed, the result is to return False.
3498
3499--    Primitive_Operations (synthesized)
3500--       Defined in concurrent types, tagged record types and subtypes, tagged
3501--       private types and tagged incomplete types. For concurrent types whose
3502--       Corresponding_Record_Type (CRT) is available, returns the list of
3503--       Direct_Primitive_Operations of its CRT; otherwise returns No_Elist.
3504--       For all the other types returns the Direct_Primitive_Operations.
3505
3506--    Prival (Node17)
3507--       Defined in private components of protected types. Refers to the entity
3508--       of the component renaming declaration generated inside protected
3509--       subprograms, entries or barrier functions.
3510
3511--    Prival_Link (Node20)
3512--       Defined in constants and variables which rename private components of
3513--       protected types. Set to the original private component.
3514
3515--    Private_Dependents (Elist18)
3516--       Defined in private (sub)types. Records the subtypes of the private
3517--       type, derivations from it, and records and arrays with components
3518--       dependent on the type.
3519--
3520--       The subtypes are traversed when installing and deinstalling (the full
3521--       view of) a private type in order to ensure correct view of the
3522--       subtypes.
3523--
3524--       Used in similar fashion for incomplete types: holds list of subtypes
3525--       of these incomplete types that have discriminant constraints. The
3526--       full views of these subtypes are constructed when the full view of
3527--       the incomplete type is processed.
3528
3529--       In addition, if the incomplete type is the designated type in an
3530--       access definition for an access parameter, the operation may be
3531--       a dispatching primitive operation, which is only known when the full
3532--       declaration of the type is seen. Subprograms that have such an
3533--       access parameter are also placed in the list of private_dependents.
3534
3535--    Private_View (Node22)
3536--       For each private type, three entities are allocated, the private view,
3537--       the full view, and the shadow entity. The shadow entity contains a
3538--       copy of the private view and is used for restoring the proper private
3539--       view after a region in which the full view is visible (and is copied
3540--       into the entity normally used for the private view during this period
3541--       of visibility). The Private_View field is self-referential when the
3542--       private view lives in its normal entity, but in the copy that is made
3543--       in the shadow entity, it points to the proper location in which to
3544--       restore the private view saved in the shadow.
3545
3546--    Protected_Formal (Node22)
3547--       Defined in formal parameters (in, in out and out parameters). Used
3548--       only for formals of protected operations. References corresponding
3549--       formal parameter in the unprotected version of the operation that
3550--       is created during expansion.
3551
3552--    Protected_Body_Subprogram (Node11)
3553--       Defined in protected operations. References the entity for the
3554--       subprogram which implements the body of the operation.
3555
3556--    Protection_Object (Node23)
3557--       Applies to protected entries, entry families and subprograms. Denotes
3558--       the entity which is used to rename the _object component of protected
3559--       types.
3560
3561--    Reachable (Flag49)
3562--       Defined in labels. The flag is set over the range of statements in
3563--       which a goto to that label is legal.
3564
3565--    Referenced (Flag156)
3566--       Defined in all entities. Set if the entity is referenced, except for
3567--       the case of an appearance of a simple variable that is not a renaming
3568--       as the left side of an assignment in which case Referenced_As_LHS is
3569--       set instead, or a similar appearance as an out parameter actual, in
3570--       which case Referenced_As_Out_Parameter is set.
3571
3572--    Referenced_As_LHS (Flag36):
3573--       Defined in all entities. This flag is set instead of Referenced if a
3574--       simple variable that is not a renaming appears as the left side of an
3575--       assignment. The reason we distinguish this kind of reference is that
3576--       we have a separate warning for variables that are only assigned and
3577--       never read.
3578
3579--    Referenced_As_Out_Parameter (Flag227):
3580--       Defined in all entities. This flag is set instead of Referenced if a
3581--       simple variable that is not a renaming appears as an actual for an out
3582--       formal. The reason we distinguish this kind of reference is that
3583--       we have a separate warning for variables that are only assigned and
3584--       never read, and out parameters are a special case.
3585
3586--    Refinement_Constituents (Elist8)
3587--       Present in abstract state entities. Contains all the constituents that
3588--       refine the state, in other words, all the hidden states that appear in
3589--       the constituent_list of aspect/pragma Refined_State.
3590
3591--    Register_Exception_Call (Node20)
3592--       Defined in exception entities. When an exception is declared,
3593--       a call is expanded to Register_Exception. This field points to
3594--       the expanded N_Procedure_Call_Statement node for this call. It
3595--       is used for Import/Export_Exception processing to modify the
3596--       register call to make appropriate entries in the special tables
3597--       used for handling these pragmas at runtime.
3598
3599--    Related_Array_Object (Node25)
3600--       Defined in array types and subtypes. Used only for the base type
3601--       and subtype created for an anonymous array object. Set to point
3602--       to the entity of the corresponding array object. Currently used
3603--       only for type-related error messages.
3604
3605--    Related_Expression (Node24)
3606--       Defined in variables and types. When Set for internally generated
3607--       entities, it may be used to denote the source expression whose
3608--       elaboration created the variable declaration. If set, it is used
3609--       for generating clearer messages from CodePeer. It is used on source
3610--       entities that are variables in iterator specifications, to provide
3611--       a link to the container that is the domain of iteration. This allows
3612--       for better cross-reference information when the loop modifies elements
3613--       of the container, and suppresses spurious warnings.
3614--
3615--       Shouldn't it also be used for the same purpose in errout? It seems
3616--       odd to have two mechanisms here???
3617
3618--    Related_Instance (Node15)
3619--       Defined in the wrapper packages created for subprogram instances.
3620--       The internal subprogram that implements the instance is inside the
3621--       wrapper package, but for debugging purposes its external symbol
3622--       must correspond to the name and scope of the related instance.
3623
3624--    Related_Type (Node27)
3625--       Defined in components, constants and variables. Set when there is an
3626--       associated dispatch table to point to entities containing primary or
3627--       secondary tags. Not set in the _tag component of record types.
3628
3629--    Relative_Deadline_Variable (Node26) [implementation base type only]
3630--       Defined in task type entities. This flag is set if a valid and
3631--       effective pragma Relative_Deadline applies to the base type. Points
3632--       to the entity for a variable that is created to hold the value given
3633--       in a Relative_Deadline pragma for a task type.
3634
3635--    Renamed_Entity (Node18)
3636--       Defined in exceptions, packages, subprograms, and generic units. Set
3637--       for entities that are defined by a renaming declaration. Denotes the
3638--       renamed entity, or transitively the ultimate renamed entity if
3639--       there is a chain of renaming declarations. Empty if no renaming.
3640
3641--    Renamed_In_Spec (Flag231)
3642--       Defined in package entities. If a package renaming occurs within
3643--       a package spec, then this flag is set on the renamed package. The
3644--       purpose is to prevent a warning about unused entities in the renamed
3645--       package. Such a warning would be inappropriate since clients of the
3646--       package can see the entities in the package via the renaming.
3647
3648--    Renamed_Object (Node18)
3649--       Defined in all objects (constants, variables, components, formal
3650--       parameters, generic formal parameters, and loop parameters).
3651--       ??? Defined in discriminants?
3652--       Set non-Empty if the object was declared by a renaming declaration,
3653--       in which case it references the tree node for the name of the renamed
3654--       object. This is only possible for the variable and constant cases.
3655--       For formal parameters, this field is used in the course of inline
3656--       expansion, to map the formals of a subprogram into the corresponding
3657--       actuals. For formals of a task entry, it denotes the local renaming
3658--       that replaces the actual within the accept statement. The field is
3659--       Empty otherwise (it is always empty for loop parameters).
3660
3661--    Renaming_Map (Uint9)
3662--       Defined in generic subprograms, generic packages, and their
3663--       instances. Also defined in the instances of the corresponding
3664--       bodies. Denotes the renaming map (generic entities => instance
3665--       entities) used to construct the instance by givin an index into
3666--       the tables used to represent these maps. See Sem_Ch12 for further
3667--       details. The maps for package instances are also used when the
3668--       instance is the actual corresponding to a formal package.
3669
3670--    Requires_Overriding (Flag213)
3671--       Defined in all subprograms and entries. Set for subprograms that
3672--       require overriding as defined by RM-2005-3.9.3(6/2). Note that this
3673--       is True only for implicitly declare subprograms; it is not set on the
3674--       parent type's subprogram. See also Is_Abstract_Subprogram.
3675
3676--    Return_Present (Flag54)
3677--       Defined in function and generic function entities. Set if the
3678--       function contains a return statement (used for error checking).
3679--       This flag can also be set in procedure and generic procedure
3680--       entities (for convenience in setting it), but is only tested
3681--       for the function case.
3682
3683--    Return_Applies_To (Node8)
3684--       Defined in E_Return_Statement. Points to the entity representing
3685--       the construct to which the return statement applies, as defined in
3686--       RM-6.5(4/2). Note that a (simple) return statement within an
3687--       extended_return_statement applies to the extended_return_statement,
3688--       even though it causes the whole function to return.
3689
3690--    Returns_By_Ref (Flag90)
3691--       Defined in function entities, to indicate that the function
3692--       returns the result by reference, either because its return type is a
3693--       by-reference-type or because it uses explicitly the secondary stack.
3694
3695--    Reverse_Bit_Order (Flag164) [base type only]
3696--       Defined in all record type entities. Set if entity has a Bit_Order
3697--       aspect (set by an aspect clause or attribute definition clause) that
3698--       has reversed the order of bits from the default value. When this flag
3699--       is set, a component clause must specify a set of bits entirely within
3700--       a single storage unit (Ada 95) or within a single machine scalar (see
3701--       Ada 2005 AI-133), or must occupy an integral number of storage units.
3702
3703--    Reverse_Storage_Order (Flag93) [base type only]
3704--       Defined in all record and array type entities. Set if entity has a
3705--       Scalar_Storage_Order aspect (set by an aspect clause or attribute
3706--       definition clause) that has reversed the order of storage elements
3707--       from the default value. When this flag is set for a record type,
3708--       the Bit_Order aspect must be set to the same value (either explicitly
3709--       or as the target default value).
3710
3711--    RM_Size (Uint13)
3712--       Defined in all type and subtype entities. Contains the value of
3713--       type'Size as defined in the RM. See also the Esize field and
3714--       and the description on "Handling of Type'Size Values". A value
3715--       of zero in this field for a non-discrete type means that
3716--       the front end has not yet determined the size value. For the
3717--       case of a discrete type, this field is always set by the front
3718--       end and zero is a legitimate value for a type with one value.
3719
3720--    Root_Type (synthesized)
3721--       Applies to all type entities. For class-wide types, return the root
3722--       type of the class covered by the CW type, otherwise returns the
3723--       ultimate derivation ancestor of the given type. This function
3724--       preserves the view, i.e. the Root_Type of a partial view is the
3725--       partial view of the ultimate ancestor, the Root_Type of a full view
3726--       is the full view of the ultimate ancestor. Note that this function
3727--       does not correspond exactly to the use of root type in the RM, since
3728--       in the RM root type applies to a class of types, not to a type.
3729
3730--    Scalar_Range (Node20)
3731--       Defined in all scalar types (including modular types, where the
3732--       bounds are 0 .. modulus - 1). References a node in the tree that
3733--       contains the bounds for the range. Note that this information
3734--       could be obtained by rummaging around the tree, but it is more
3735--       convenient to have it immediately at hand in the entity. The
3736--       contents of Scalar_Range can either be an N_Subtype_Indication
3737--       node (with a constraint), or a Range node, but not a simple
3738--       subtype reference (a subtype is converted into a range).
3739
3740--    Scale_Value (Uint15)
3741--       Defined in decimal fixed-point types and subtypes. Contains the scale
3742--       for the type (i.e. the value of type'Scale = the number of decimal
3743--       digits after the decimal point).
3744
3745--    Scope (Node3)
3746--       Defined in all entities. Points to the entity for the scope (block,
3747--       loop, subprogram, package etc.) in which the entity is declared.
3748--       Since this field is in the base part of the entity node, the access
3749--       routines for this field are in Sinfo. Note that for a child package,
3750--       the Scope will be the parent package, and for a non-child package,
3751--       the Scope will be Standard.
3752
3753--    Scope_Depth (synthesized)
3754--       Applies to program units, blocks, concurrent types and entries, and
3755--       also to record types, i.e. to any entity that can appear on the scope
3756--       stack. Yields the scope depth value, which for those entities other
3757--       than records is simply the scope depth value, for record entities, it
3758--       is the Scope_Depth of the record scope.
3759
3760--    Scope_Depth_Value (Uint22)
3761--       Defined in program units, blocks, concurrent types, and entries.
3762--       Indicates the number of scopes that statically enclose the declaration
3763--       of the unit or type. Library units have a depth of zero. Note that
3764--       record types can act as scopes but do NOT have this field set (see
3765--       Scope_Depth above)
3766
3767--    Scope_Depth_Set (synthesized)
3768--       Applies to a special predicate function that returns a Boolean value
3769--       indicating whether or not the Scope_Depth field has been set. It is
3770--       needed, since returns an invalid value in this case.
3771
3772--    Sec_Stack_Needed_For_Return (Flag167)
3773--       Defined in scope entities (blocks, functions, procedures, tasks,
3774--       entries). Set to True when secondary stack is used to hold the
3775--       returned value of a function and thus should not be released on
3776--       scope exit.
3777
3778--    Shadow_Entities (List14)
3779--       Defined in package and generic package entities. Points to a list
3780--       of entities that correspond to private types. For each private type
3781--       a shadow entity is created that holds a copy of the private view.
3782--       In regions of the program where the full views of these private
3783--       entities are visible, the full view is copied into the entity that
3784--       is normally used to hold the private view, but the shadow entity
3785--       copy is unchanged. The shadow entities are then used to restore the
3786--       original private views at the end of the region. This list is a
3787--       standard format list (i.e. First (Shadow_Entities) is the first
3788--       entry and subsequent entries are obtained using Next.
3789
3790--    Shared_Var_Procs_Instance (Node22)
3791--       Defined in variables. Set non-Empty only if Is_Shared_Passive is
3792--       set, in which case this is the entity for the associated instance of
3793--       System.Shared_Storage.Shared_Var_Procs. See Exp_Smem for full details.
3794
3795--    Size_Check_Code (Node19)
3796--       Defined in constants and variables. Normally Empty. Set if code is
3797--       generated to check the size of the object. This field is used to
3798--       suppress this code if a subsequent address clause is encountered.
3799
3800--    Size_Clause (synthesized)
3801--       Applies to all entities. If a size clause is present in the rep
3802--       item chain for an entity then the attribute definition clause node
3803--       for the size clause is returned. Otherwise Size_Clause returns Empty
3804--       if no item is present. Usually this is only meaningful if the flag
3805--       Has_Size_Clause is set. This is because when the representation item
3806--       chain is copied for a derived type, it can inherit a size clause that
3807--       is not applicable to the entity.
3808
3809--    Size_Depends_On_Discriminant (Flag177)
3810--       Defined in all entities for types and subtypes. Indicates that the
3811--       size of the type depends on the value of one or more discriminants.
3812--       Currently, this flag is only set for arrays which have one or more
3813--       bounds depending on a discriminant value.
3814
3815--    Size_Known_At_Compile_Time (Flag92)
3816--       Defined in all entities for types and subtypes. Indicates that the
3817--       size of objects of the type is known at compile time. This flag is
3818--       used to optimize some generated code sequences, and also to enable
3819--       some error checks (e.g. disallowing component clauses on variable
3820--       length objects). It is set conservatively (i.e. if it is True, the
3821--       size is certainly known at compile time, if it is False, then the
3822--       size may or may not be known at compile time, but the code will
3823--       assume that it is not known).
3824
3825--    Small_Value (Ureal21)
3826--       Defined in fixed point types. Points to the universal real for the
3827--       Small of the type, either as given in a representation clause, or
3828--       as computed (as a power of two) by the compiler.
3829
3830--    SPARK_Aux_Pragma (Node33)
3831--       Present in package spec and body entities. For a package spec entity
3832--       it relates to the SPARK mode setting for the private part. This field
3833--       points to the N_Pragma node that applies to the private part. This is
3834--       either set with a local SPARK_Mode pragma in the private part or it is
3835--       inherited from the SPARK mode that applies to the rest of the spec.
3836--       For a package body, it similarly applies to the SPARK mode setting for
3837--       the elaboration sequence after the BEGIN. In the case where the pragma
3838--       is inherited, the SPARK_Aux_Pragma_Inherited flag is set in the
3839--       package spec or body entity.
3840
3841--    SPARK_Aux_Pragma_Inherited (Flag266)
3842--       Present in the entities of subprogram specs and bodies as well as
3843--       in package specs and bodies. Set if the SPARK_Aux_Pragma field
3844--       points to a pragma that is inherited, rather than a local one.
3845
3846--    SPARK_Pragma (Node32)
3847--       Present in the entities of subprogram specs and bodies as well as in
3848--       package specs and bodies. Points to the N_Pragma node that applies to
3849--       the spec or body. This is either set by a local SPARK_Mode pragma or
3850--       is inherited from the context (from an outer scope for the spec case
3851--       or from the spec for the body case). In the case where it is inherited
3852--       the flag SPARK_Pragma_Inherited is set. Empty if no SPARK_Mode pragma
3853--       is applicable.
3854
3855--    SPARK_Pragma_Inherited (Flag265)
3856--       Present in the entities of subprogram specs and bodies as well as in
3857--       package specs and bodies. Set if the SPARK_Pragma field points to a
3858--       pragma that is inherited, rather than a local one.
3859
3860--    Spec_Entity (Node19)
3861--       Defined in package body entities. Points to corresponding package
3862--       spec entity. Also defined in subprogram body parameters in the
3863--       case where there is a separate spec, where this field references
3864--       the corresponding parameter entities in the spec.
3865
3866--    Static_Predicate (List25)
3867--       Defined in discrete types/subtypes with predicates (Has_Predicates
3868--       set). Set if the type/subtype has a static predicate. Points to a
3869--       list of expression and N_Range nodes that represent the predicate
3870--       in canonical form. The canonical form has entries sorted in ascending
3871--       order, with duplicates eliminated, and adjacent ranges coalesced, so
3872--       that there is always a gap in the values between successive entries.
3873--       The entries in this list are fully analyzed and typed with the base
3874--       type of the subtype. Note that all entries are static and have values
3875--       within the subtype range.
3876
3877--    Status_Flag_Or_Transient_Decl (Node15)
3878--       Defined in variables and constants. Applies to objects that require
3879--       special treatment by the finalization machinery, such as extended
3880--       return results, IF and CASE expression results, and objects inside
3881--       N_Expression_With_Actions nodes. The attribute contains the entity
3882--       of a flag which specifies particular behavior over a region of code
3883--       or the declaration of a "hook" object.
3884--       In which case is it a flag, or a hook object???
3885
3886--    Storage_Size_Variable (Node15) [implementation base type only]
3887--       Defined in access types and task type entities. This flag is set
3888--       if a valid and effective pragma Storage_Size applies to the base
3889--       type. Points to the entity for a variable that is created to
3890--       hold the value given in a Storage_Size pragma for an access
3891--       collection or a task type. Note that in the access type case,
3892--       this field is defined only in the root type (since derived types
3893--       share the same storage pool).
3894
3895--    Static_Elaboration_Desired (Flag77)
3896--       Defined in library-level packages. Set by the pragma of the same
3897--       name, to indicate that static initialization must be attempted for
3898--       all types declared in the package, and that a warning must be emitted
3899--       for those types to which static initialization is not available.
3900
3901--    Static_Initialization (Node30)
3902--       Defined in initialization procedures for types whose objects can be
3903--       initialized statically. The value of this attribute is a positional
3904--       aggregate whose components are compile-time static values. Used
3905--       when available in object declarations to eliminate the call to the
3906--       initialization procedure, and to minimize elaboration code. Note:
3907--       This attribute uses the same field as Overridden_Operation, which is
3908--       irrelevant in init_procs.
3909
3910--    Stored_Constraint (Elist23)
3911--       Defined in entities that can have discriminants (concurrent types
3912--       subtypes, record types and subtypes, private types and subtypes,
3913--       limited private types and subtypes and incomplete types). Points
3914--       to an element list containing the expressions for each of the
3915--       stored discriminants for the record (sub)type.
3916
3917--    Strict_Alignment (Flag145) [implementation base type only]
3918--       Defined in all type entities. Indicates that some containing part
3919--       is either aliased or tagged. This prohibits packing the object
3920--       tighter than its natural size and alignment.
3921
3922--    String_Literal_Length (Uint16)
3923--       Defined in string literal subtypes (which are created to correspond
3924--       to string literals in the program). Contains the length of the string
3925--       literal.
3926
3927--    String_Literal_Low_Bound (Node15)
3928--       Defined in string literal subtypes (which are created to correspond
3929--       to string literals in the program). Contains an expression whose
3930--       value represents the low bound of the literal. This is a copy of
3931--       the low bound of the applicable index constraint if there is one,
3932--       or a copy of the low bound of the index base type if not.
3933
3934--    Subprograms_For_Type (Node29)
3935--       Defined in all type and subprogram entities. This is used to hold
3936--       a list of subprogram entities for subprograms associated with the
3937--       type, linked through the Subprograms_For_Type field of the subprogram
3938--       entity. Basically this is a way of multiplexing the single field to
3939--       hold more than one entity (since we ran out of space in some type
3940--       entities). This is currently used for Invariant_Procedure and also
3941--       for Predicate_Function, and clients will always use the latter two
3942--       names to access entries in this list.
3943
3944--    Suppress_Elaboration_Warnings (Flag148)
3945--       Defined in all entities, can be set only for subprogram entities and
3946--       for variables. If this flag is set then Sem_Elab will not generate
3947--       elaboration warnings for the subprogram or variable. Suppression of
3948--       such warnings is automatic for subprograms for which elaboration
3949--       checks are suppressed (without the need to set this flag), but the
3950--       flag is also set for various internal entities (such as init procs)
3951--       which are known not to generate any possible access before
3952--       elaboration, and it is set on variables when a warning is given to
3953--       avoid multiple elaboration warnings for the same variable.
3954
3955--    Suppress_Initialization (Flag105)
3956--       Defined in all type and subtype entities. If set for the base type,
3957--       then the generation of initialization procedures is suppressed for the
3958--       type. Any other implicit initialiation (e.g. from the use of pragma
3959--       Initialize_Scalars) is also suppressed if this flag is set either for
3960--       the subtype in question, or for the base type. Set by use of pragma
3961--       Suppress_Initialization and also for internal entities where we know
3962--       that no initialization is required. For example, enumeration image
3963--       table entities set it.
3964
3965--    Suppress_Style_Checks (Flag165)
3966--       Defined in all entities. Suppresses any style checks specifically
3967--       associated with the given entity if set.
3968
3969--    Suppress_Value_Tracking_On_Call (Flag217)
3970--       Defined in all entities. Set in a scope entity if value tracking is to
3971--       be suppressed on any call within the scope. Used when an access to a
3972--       local subprogram is computed, to deal with the possibility that this
3973--       value may be passed around, and if used, may clobber a local variable.
3974
3975--    Task_Body_Procedure (Node25)
3976--       Defined in task types and subtypes. Points to the entity for the task
3977--       task body procedure (as further described in Exp_Ch9, task bodies are
3978--       expanded into procedures). A convenient function to retrieve this
3979--       field is Sem_Util.Get_Task_Body_Procedure.
3980--
3981--       The last sentence is odd??? Why not have Task_Body_Procedure go to the
3982--       Underlying_Type of the Root_Type???
3983
3984--    Thunk_Entity (Node31)
3985--       Defined in functions and procedures which have been classified as
3986--       Is_Thunk. Set to the target entity called by the thunk.
3987
3988--    Treat_As_Volatile (Flag41)
3989--       Defined in all type entities, and also in constants, components and
3990--       variables. Set if this entity is to be treated as volatile for code
3991--       generation purposes. Always set if Is_Volatile is set, but can also
3992--       be set as a result of situations (such as address overlays) where
3993--       the front end wishes to force volatile handling to inhibit aliasing
3994--       optimization which might be legally ok, but is undesirable. Note
3995--       that the back end always tests this flag rather than Is_Volatile.
3996--       The front end tests Is_Volatile if it is concerned with legality
3997--       checks associated with declared volatile variables, but if the test
3998--       is for the purposes of suppressing optimizations, then the front
3999--       end should test Treat_As_Volatile rather than Is_Volatile.
4000--
4001--       Note: before testing Treat_As_Volatile, consider whether it would
4002--       be more appropriate to use Exp_Util.Is_Volatile_Reference instead,
4003--       which catches more cases of volatile references.
4004
4005--    Type_High_Bound (synthesized)
4006--       Applies to scalar types. Returns the tree node (Node_Id) that contains
4007--       the high bound of a scalar type. The returned value is literal for a
4008--       base type, but may be an expression in the case of scalar type with
4009--       dynamic bounds. Note that in the case of a fixed point type, the high
4010--       bound is in units of small, and is an integer.
4011
4012--    Type_Low_Bound (synthesized)
4013--       Applies to scalar types. Returns the tree node (Node_Id) that contains
4014--       the low bound of a scalar type. The returned value is literal for a
4015--       base type, but may be an expression in the case of scalar type with
4016--       dynamic bounds. Note that in the case of a fixed point type, the low
4017--       bound is in units of small, and is an integer.
4018
4019--    Underlying_Full_View (Node19)
4020--       Defined in private subtypes that are the completion of other private
4021--       types, or in private types that are derived from private subtypes. If
4022--       the full view of a private type T is derived from another private type
4023--       with discriminants Td, the full view of T is also private, and there
4024--       is no way to attach to it a further full view that would convey the
4025--       structure of T to the back end. The Underlying_Full_ View is an
4026--       attribute of the full view that is a subtype of Td with the same
4027--       constraint as the declaration for T. The declaration for this subtype
4028--       is built at the point of the declaration of T, either as completion,
4029--       or as a subtype declaration where the base type is private and has a
4030--       private completion. If Td is already constrained, then its full view
4031--       can serve directly as the full view of T.
4032
4033--    Underlying_Record_View (Node28)
4034--       Defined in record types. Set for record types that are extensions of
4035--       types with unknown discriminants, and also set for internally built
4036--       underlying record views to reference its original record type. Record
4037--       types that are extensions of types with unknown discriminants do not
4038--       have a completion, but they cannot be used without having some
4039--       discriminated view at hand. This view is a record type with the same
4040--       structure, whose parent type is the full view of the parent in the
4041--       original type extension.
4042
4043--    Underlying_Type (synthesized)
4044--       Applies to all entities. This is the identity function except in the
4045--       case where it is applied to an incomplete or private type, in which
4046--       case it is the underlying type of the type declared by the completion,
4047--       or Empty if the completion has not yet been encountered and analyzed.
4048--
4049--       Note: the reason this attribute applies to all entities, and not just
4050--       types, is to legitimize code where Underlying_Type is applied to an
4051--       entity which may or may not be a type, with the intent that if it is a
4052--       type, its underlying type is taken.
4053
4054--    Universal_Aliasing (Flag216) [implementation base type only]
4055--       Defined in all type entities. Set to direct the back-end to avoid
4056--       any optimizations based on type-based alias analysis for this type.
4057--       Indicates that objects of this type can alias objects of any other
4058--       types, which guarantees that any objects can be referenced through
4059--       access types designating this type safely, whatever the actual type
4060--       of these objects. In other words, the effect is as though access
4061--       types designating this type were subject to No_Strict_Aliasing.
4062
4063--    Unset_Reference (Node16)
4064--       Defined in variables and out parameters. This is normally Empty. It
4065--       is set to point to an identifier that represents a reference to the
4066--       entity before any value has been set. Only the first such reference
4067--       is identified. This field is used to generate a warning message if
4068--       necessary (see Sem_Warn.Check_Unset_Reference).
4069
4070--    Used_As_Generic_Actual (Flag222)
4071--       Defined in all entities, set if the entity is used as an argument to
4072--       a generic instantiation. Used to tune certain warning messages.
4073
4074--    Uses_Lock_Free (Flag188)
4075--       Defined in protected type entities. Set to True when the Lock Free
4076--       implementation is used for the protected type. This implemenatation is
4077--       based on atomic transactions and doesn't require anymore the use of
4078--       Protection object (see System.Tasking.Protected_Objects).
4079
4080--    Uses_Sec_Stack (Flag95)
4081--       Defined in scope entities (block, entry, function, loop, procedure,
4082--       task). Set to True when secondary stack is used in this scope and must
4083--       be released on exit unless Sec_Stack_Needed_For_Return is set.
4084
4085--    Warnings_Off (Flag96)
4086--       Defined in all entities. Set if a pragma Warnings (Off, entity-name)
4087--       is used to suppress warnings for a given entity. It is also used by
4088--       the compiler in some situations to kill spurious warnings. Note that
4089--       clients should generally not test this flag directly, but instead
4090--       use function Has_Warnings_Off.
4091
4092--    Warnings_Off_Used (Flag236)
4093--       Defined in all entities. Can only be set if Warnings_Off is set. If
4094--       set indicates that a warning was suppressed by the Warnings_Off flag,
4095--       and Unmodified/Unreferenced would not have suppressed the warning.
4096
4097--    Warnings_Off_Used_Unmodified (Flag237)
4098--       Defined in all entities. Can only be set if Warnings_Off is set and
4099--       Has_Pragma_Unmodified is not set. If set indicates that a warning was
4100--       suppressed by the Warnings_Off status but that pragma Unmodified
4101--       would also have suppressed the warning.
4102
4103--    Warnings_Off_Used_Unreferenced (Flag238)
4104--       Defined in all entities. Can only be set if Warnings_Off is set and
4105--       Has_Pragma_Unreferenced is not set. If set indicates that a warning
4106--       was suppressed by the Warnings_Off status but that pragma Unreferenced
4107--       would also have suppressed the warning.
4108
4109--    Was_Hidden (Flag196)
4110--       Defined in all entities. Used to save the value of the Is_Hidden
4111--       attribute when the limited-view is installed (Ada 2005: AI-217).
4112
4113--    Wrapped_Entity (Node27)
4114--       Defined in functions and procedures which have been classified as
4115--       Is_Primitive_Wrapper. Set to the entity being wrapper.
4116
4117--------------------------------------
4118-- Delayed Freezing and Elaboration --
4119--------------------------------------
4120
4121--  The flag Has_Delayed_Freeze indicates that an entity carries an explicit
4122--  freeze node, which appears later in the expanded tree.
4123
4124--  a)   The flag is used by the front-end to trigger expansion actions
4125--  which include the generation of that freeze node. Typically this happens at
4126--  the end of the current compilation unit, or before the first subprogram
4127--  body is encountered in the current unit. See files freeze and exp_ch13 for
4128--  details on the actions triggered by a freeze node, which include the
4129--  construction of initialization procedures and dispatch tables.
4130
4131--  b) The flag is used by the backend to defer elaboration of the entity until
4132--  its freeze node is seen.  In the absence of an explicit freeze node, an
4133--  entity is frozen (and elaborated) at the point of declaration.
4134
4135--  For object declarations, the flag is set when an address clause for the
4136--  object is encountered. Legality checks on the address expression only
4137--  take place at the freeze point of the object.
4138
4139--  Most types have an explicit freeze node, because they cannot be elaborated
4140--  until all representation and operational items that apply to them have been
4141--  analyzed. Private types and incomplete types have the flag set as well, as
4142--  do task and protected types.
4143
4144--  Implicit base types created for type derivations, as well as classwide
4145--  types created for all tagged types, have the flag set.
4146
4147--  If a subprogram has an access parameter whose designated type is incomplete
4148--  the subprogram has the flag set.
4149
4150   ------------------
4151   -- Access Kinds --
4152   ------------------
4153
4154   --  The following entity kinds are introduced by the corresponding type
4155   --  definitions:
4156
4157   --    E_Access_Type,
4158   --    E_General_Access_Type,
4159   --    E_Access_Subprogram_Type,
4160   --    E_Anonymous_Access_Subprogram_Type,
4161   --    E_Access_Protected_Subprogram_Type,
4162   --    E_Anonymous_Access_Protected_Subprogram_Type
4163   --    E_Anonymous_Access_Type.
4164
4165   --  E_Access_Subtype is for an access subtype created by a subtype
4166   --  declaration.
4167
4168   --  In addition, we define the kind E_Allocator_Type to label allocators.
4169   --  This is because special resolution rules apply to this construct.
4170   --  Eventually the constructs are labeled with the access type imposed by
4171   --  the context. Gigi should never see the type E_Allocator.
4172
4173   --  Similarly, the type E_Access_Attribute_Type is used as the initial kind
4174   --  associated with an access attribute. After resolution a specific access
4175   --  type will be established as determined by the context.
4176
4177   --  Finally, the type Any_Access is used to label -null- during type
4178   --  resolution. Any_Access is also replaced by the context type after
4179   --  resolution.
4180
4181   --------------------------------
4182   -- Classification of Entities --
4183   --------------------------------
4184
4185   --  The classification of program entities which follows is a refinement of
4186   --  the list given in RM 3.1(1). E.g., separate entities denote subtypes of
4187   --  different type classes. Ada 95 entities include class wide types,
4188   --  protected types, subprogram types, generalized access types,  generic
4189   --  formal derived types and generic formal packages.
4190
4191   --  The order chosen for these kinds allows us to classify related entities
4192   --  so that they are contiguous. As a result, they do not appear in the
4193   --  exact same order as their order of first appearance in the LRM (For
4194   --  example, private types are listed before packages). The contiguity
4195   --  allows us to define useful subtypes (see below) such as type entities,
4196   --  overloaded entities, etc.
4197
4198   --  Each entity (explicitly or implicitly declared) has a kind, which is
4199   --  a value of the following type:
4200
4201   type Entity_Kind is (
4202
4203      E_Void,
4204      --  The initial Ekind value for a newly created entity. Also used as the
4205      --  Ekind for Standard_Void_Type, a type entity in Standard used as a
4206      --  dummy type for the return type of a procedure (the reason we create
4207      --  this type is to share the circuits for performing overload resolution
4208      --  on calls).
4209
4210      -------------
4211      -- Objects --
4212      -------------
4213
4214      E_Component,
4215      --  Components of a record declaration, private declarations of
4216      --  protected objects.
4217
4218      E_Constant,
4219      --  Constants created by an object declaration with a constant keyword
4220
4221      E_Discriminant,
4222      --  A discriminant, created by the use of a discriminant in a type
4223      --  declaration.
4224
4225      E_Loop_Parameter,
4226      --  A loop parameter created by a for loop
4227
4228      E_Variable,
4229      --  Variables created by an object declaration with no constant keyword
4230
4231      ------------------------
4232      -- Parameter Entities --
4233      ------------------------
4234
4235      --  Parameters are also objects
4236
4237      E_Out_Parameter,
4238      --  An out parameter of a subprogram or entry
4239
4240      E_In_Out_Parameter,
4241      --  An in-out parameter of a subprogram or entry
4242
4243      E_In_Parameter,
4244      --  An in parameter of a subprogram or entry
4245
4246      --------------------------------
4247      -- Generic Parameter Entities --
4248      --------------------------------
4249
4250      --  Generic parameters are also objects
4251
4252      E_Generic_In_Out_Parameter,
4253      --  A generic in out parameter, created by the use of a generic in out
4254      --  parameter in a generic declaration.
4255
4256      E_Generic_In_Parameter,
4257      --  A generic in parameter, created by the use of a generic in
4258      --  parameter in a generic declaration.
4259
4260      -------------------
4261      -- Named Numbers --
4262      -------------------
4263
4264      E_Named_Integer,
4265      --  Named numbers created by a number declaration with an integer value
4266
4267      E_Named_Real,
4268      --  Named numbers created by a number declaration with a real value
4269
4270      -----------------------
4271      -- Enumeration Types --
4272      -----------------------
4273
4274      E_Enumeration_Type,
4275      --  Enumeration types, created by an enumeration type declaration
4276
4277      E_Enumeration_Subtype,
4278      --  Enumeration subtypes, created by an explicit or implicit subtype
4279      --  declaration applied to an enumeration type or subtype.
4280
4281      -------------------
4282      -- Numeric Types --
4283      -------------------
4284
4285      E_Signed_Integer_Type,
4286      --  Signed integer type, used for the anonymous base type of the
4287      --  integer subtype created by an integer type declaration.
4288
4289      E_Signed_Integer_Subtype,
4290      --  Signed integer subtype, created by either an integer subtype or
4291      --  integer type declaration (in the latter case an integer type is
4292      --  created for the base type, and this is the first named subtype).
4293
4294      E_Modular_Integer_Type,
4295      --  Modular integer type, used for the anonymous base type of the
4296      --  integer subtype created by a modular integer type declaration.
4297
4298      E_Modular_Integer_Subtype,
4299      --  Modular integer subtype, created by either an modular subtype
4300      --  or modular type declaration (in the latter case a modular type
4301      --  is created for the base type, and this is the first named subtype).
4302
4303      E_Ordinary_Fixed_Point_Type,
4304      --  Ordinary fixed type, used for the anonymous base type of the
4305      --  fixed subtype created by an ordinary fixed point type declaration.
4306
4307      E_Ordinary_Fixed_Point_Subtype,
4308      --  Ordinary fixed point subtype, created by either an ordinary fixed
4309      --  point subtype or ordinary fixed point type declaration (in the
4310      --  latter case a fixed point type is created for the base type, and
4311      --  this is the first named subtype).
4312
4313      E_Decimal_Fixed_Point_Type,
4314      --  Decimal fixed type, used for the anonymous base type of the decimal
4315      --  fixed subtype created by an ordinary fixed point type declaration.
4316
4317      E_Decimal_Fixed_Point_Subtype,
4318      --  Decimal fixed point subtype, created by either a decimal fixed point
4319      --  subtype or decimal fixed point type declaration (in the latter case
4320      --  a fixed point type is created for the base type, and this is the
4321      --  first named subtype).
4322
4323      E_Floating_Point_Type,
4324      --  Floating point type, used for the anonymous base type of the
4325      --  floating point subtype created by a floating point type declaration.
4326
4327      E_Floating_Point_Subtype,
4328
4329      --  Floating point subtype, created by either a floating point subtype
4330      --  or floating point type declaration (in the latter case a floating
4331      --  point type is created for the base type, and this is the first
4332      --  named subtype).
4333
4334      ------------------
4335      -- Access Types --
4336      ------------------
4337
4338      E_Access_Type,
4339      --  An access type created by an access type declaration with no all
4340      --  keyword present. Note that the predefined type Any_Access, which
4341      --  has E_Access_Type Ekind, is used to label NULL in the upwards pass
4342      --  of type analysis, to be replaced by the true access type in the
4343      --  downwards resolution pass.
4344
4345      E_Access_Subtype,
4346      --  An access subtype created by a subtype declaration for any access
4347      --  type (whether or not it is a general access type).
4348
4349      E_Access_Attribute_Type,
4350      --  An access type created for an access attribute (such as 'Access,
4351      --  'Unrestricted_Access and Unchecked_Access)
4352
4353      E_Allocator_Type,
4354      --  A special internal type used to label allocators and attribute
4355      --  references using 'Access. This is needed because special resolution
4356      --  rules apply to these constructs. On the resolution pass, this type
4357      --  is always replaced by the actual access type, so Gigi should never
4358      --  see types with this Ekind.
4359
4360      E_General_Access_Type,
4361      --  An access type created by an access type declaration with the all
4362      --  keyword present.
4363
4364      E_Access_Subprogram_Type,
4365      --  An access to subprogram type, created by an access to subprogram
4366      --  declaration.
4367
4368      E_Anonymous_Access_Subprogram_Type,
4369      --  An anonymous access to subprogram type, created by an access to
4370      --  subprogram declaration, or generated for a current instance of
4371      --  a type name appearing within a component definition that has an
4372      --  anonymous access to subprogram type.
4373
4374      E_Access_Protected_Subprogram_Type,
4375      --  An access to a protected subprogram, created by the corresponding
4376      --  declaration. Values of such a type denote both a protected object
4377      --  and a protected operation within, and have different compile-time
4378      --  and run-time properties than other access to subprograms.
4379
4380      E_Anonymous_Access_Protected_Subprogram_Type,
4381      --  An anonymous access to protected subprogram type, created by an
4382      --  access to subprogram declaration.
4383
4384      E_Anonymous_Access_Type,
4385      --  An anonymous access type created by an access parameter or access
4386      --  discriminant.
4387
4388      ---------------------
4389      -- Composite Types --
4390      ---------------------
4391
4392      E_Array_Type,
4393      --  An array type created by an array type declaration. Includes all
4394      --  cases of arrays, except for string types.
4395
4396      E_Array_Subtype,
4397      --  An array subtype, created by an explicit array subtype declaration,
4398      --  or the use of an anonymous array subtype.
4399
4400      E_String_Type,
4401      --  A string type, i.e. an array type whose component type is a character
4402      --  type, and for which string literals can thus be written.
4403
4404      E_String_Subtype,
4405      --  A string subtype, created by an explicit subtype declaration for a
4406      --  string type, or the use of an anonymous subtype of a string type,
4407
4408      E_String_Literal_Subtype,
4409      --  A special string subtype, used only to describe the type of a string
4410      --  literal (will always be one dimensional, with literal bounds).
4411
4412      E_Class_Wide_Type,
4413      --  A class wide type, created by any tagged type declaration (i.e. if
4414      --  a tagged type is declared, the corresponding class type is always
4415      --  created, using this Ekind value).
4416
4417      E_Class_Wide_Subtype,
4418      --  A subtype of a class wide type, created by a subtype declaration
4419      --  used to declare a subtype of a class type.
4420
4421      E_Record_Type,
4422      --  A record type, created by a record type declaration
4423
4424      E_Record_Subtype,
4425      --  A record subtype, created by a record subtype declaration
4426
4427      E_Record_Type_With_Private,
4428      --  Used for types defined by a private extension declaration, and
4429      --  for tagged private types. Includes the fields for both private
4430      --  types and for record types (with the sole exception of
4431      --  Corresponding_Concurrent_Type which is obviously not needed).
4432      --  This entity is considered to be both a record type and
4433      --  a private type.
4434
4435      E_Record_Subtype_With_Private,
4436      --  A subtype of a type defined by a private extension declaration
4437
4438      E_Private_Type,
4439      --  A private type, created by a private type declaration
4440      --  that has neither the keyword limited nor the keyword tagged.
4441
4442      E_Private_Subtype,
4443      --  A subtype of a private type, created by a subtype declaration used
4444      --  to declare a subtype of a private type.
4445
4446      E_Limited_Private_Type,
4447      --  A limited private type, created by a private type declaration that
4448      --  has the keyword limited, but not the keyword tagged.
4449
4450      E_Limited_Private_Subtype,
4451      --  A subtype of a limited private type, created by a subtype declaration
4452      --  used to declare a subtype of a limited private type.
4453
4454      E_Incomplete_Type,
4455      --  An incomplete type, created by an incomplete type declaration
4456
4457      E_Incomplete_Subtype,
4458      --  An incomplete subtype, created by a subtype declaration where the
4459      --  subtype mark denotes an incomplete type.
4460
4461      E_Task_Type,
4462      --  A task type, created by a task type declaration. An entity with this
4463      --  Ekind is also created to describe the anonymous type of a task that
4464      --  is created by a single task declaration.
4465
4466      E_Task_Subtype,
4467      --  A subtype of a task type, created by a subtype declaration used to
4468      --  declare a subtype of a task type.
4469
4470      E_Protected_Type,
4471      --  A protected type, created by a protected type declaration. An entity
4472      --  with this Ekind is also created to describe the anonymous type of
4473      --  a protected object created by a single protected declaration.
4474
4475      E_Protected_Subtype,
4476      --  A subtype of a protected type, created by a subtype declaration used
4477      --  to declare a subtype of a protected type.
4478
4479      -----------------
4480      -- Other Types --
4481      -----------------
4482
4483      E_Exception_Type,
4484      --  The type of an exception created by an exception declaration
4485
4486      E_Subprogram_Type,
4487      --  This is the designated type of an Access_To_Subprogram. Has type
4488      --  and signature like a subprogram entity, so can appear in calls,
4489      --  which are resolved like regular calls, except that such an entity
4490      --  is not overloadable.
4491
4492      ---------------------------
4493      -- Overloadable Entities --
4494      ---------------------------
4495
4496      E_Enumeration_Literal,
4497      --  An enumeration literal, created by the use of the literal in an
4498      --  enumeration type definition.
4499
4500      E_Function,
4501      --  A function, created by a function declaration or a function body
4502      --  that acts as its own declaration.
4503
4504      E_Operator,
4505      --  A predefined operator, appearing in Standard, or an implicitly
4506      --  defined concatenation operator created whenever an array is
4507      --  declared. We do not make normal derived operators explicit in
4508      --  the tree, but the concatenation operators are made explicit.
4509
4510      E_Procedure,
4511      --  A procedure, created by a procedure declaration or a procedure
4512      --  body that acts as its own declaration.
4513
4514      E_Entry,
4515      --  An entry, created by an entry declaration in a task or protected
4516      --  object.
4517
4518      E_Abstract_State,
4519      --  A state abstraction. Used to designate entities introduced by aspect
4520      --  or pragma Abstract_State. The entity carries the various properties
4521      --  of the state.
4522
4523      --------------------
4524      -- Other Entities --
4525      --------------------
4526
4527      E_Entry_Family,
4528      --  An entry family, created by an entry family declaration in a
4529      --  task or protected type definition.
4530
4531      E_Block,
4532      --  A block identifier, created by an explicit or implicit label on
4533      --  a block or declare statement.
4534
4535      E_Entry_Index_Parameter,
4536      --  An entry index parameter created by an entry index specification
4537      --  for the body of a protected entry family.
4538
4539      E_Exception,
4540      --  An exception created by an exception declaration. The exception
4541      --  itself uses E_Exception for the Ekind, the implicit type that is
4542      --  created to represent its type uses the Ekind E_Exception_Type.
4543
4544      E_Generic_Function,
4545      --  A generic function. This is the entity for a generic function
4546      --  created by a generic subprogram declaration.
4547
4548      E_Generic_Procedure,
4549      --  A generic function. This is the entity for a generic procedure
4550      --  created by a generic subprogram declaration.
4551
4552      E_Generic_Package,
4553      --  A generic package, this is the entity for a generic package created
4554      --  by a generic package declaration.
4555
4556      E_Label,
4557      --  The defining entity for a label. Note that this is created by the
4558      --  implicit label declaration, not the occurrence of the label itself,
4559      --  which is simply a direct name referring to the label.
4560
4561      E_Loop,
4562      --  A loop identifier, created by an explicit or implicit label on a
4563      --  loop statement.
4564
4565      E_Return_Statement,
4566      --  A dummy entity created for each return statement. Used to hold
4567      --  information about the return statement (what it applies to) and in
4568      --  rules checking. For example, a simple_return_statement that applies
4569      --  to an extended_return_statement cannot have an expression; this
4570      --  requires putting the E_Return_Statement entity for the
4571      --  extended_return_statement on the scope stack.
4572
4573      E_Package,
4574      --  A package, created by a package declaration
4575
4576      E_Package_Body,
4577      --  A package body. This entity serves only limited functions, since
4578      --  most semantic analysis uses the package entity (E_Package). However
4579      --  there are some attributes that are significant for the body entity.
4580      --  For example, collection of exception handlers.
4581
4582      E_Protected_Object,
4583      --  A protected object, created by an object declaration that declares
4584      --  an object of a protected type.
4585
4586      E_Protected_Body,
4587      --  A protected body. This entity serves almost no function, since all
4588      --  semantic analysis uses the protected entity (E_Protected_Type)
4589
4590      E_Task_Body,
4591      --  A task body. This entity serves almost no function, since all
4592      --  semantic analysis uses the protected entity (E_Task_Type).
4593
4594      E_Subprogram_Body
4595      --  A subprogram body. Used when a subprogram has a separate declaration
4596      --  to represent the entity for the body. This entity serves almost no
4597      --  function, since all semantic analysis uses the subprogram entity
4598      --  for the declaration (E_Function or E_Procedure).
4599   );
4600
4601   for Entity_Kind'Size use 8;
4602   --  The data structures in Atree assume this
4603
4604   --------------------------
4605   -- Subtype Declarations --
4606   --------------------------
4607
4608   --  The above entities are arranged so that they can be conveniently grouped
4609   --  into subtype ranges. Note that for each of the xxx_Kind ranges defined
4610   --  below, there is a corresponding Is_xxx (or for types, Is_xxx_Type)
4611   --  predicate which is to be used in preference to direct range tests using
4612   --  the subtype name. However, the subtype names are available for direct
4613   --  use, e.g. as choices in case statements.
4614
4615   subtype Access_Kind                 is Entity_Kind range
4616       E_Access_Type ..
4617   --  E_Access_Subtype
4618   --  E_Access_Attribute_Type
4619   --  E_Allocator_Type
4620   --  E_General_Access_Type
4621   --  E_Access_Subprogram_Type
4622   --  E_Anonymous_Access_Subprogram_Type
4623   --  E_Access_Protected_Subprogram_Type
4624   --  E_Anonymous_Access_Protected_Subprogram_Type
4625       E_Anonymous_Access_Type;
4626
4627   subtype Access_Subprogram_Kind      is Entity_Kind range
4628       E_Access_Subprogram_Type ..
4629   --  E_Anonymous_Access_Subprogram_Type
4630   --  E_Access_Protected_Subprogram_Type
4631       E_Anonymous_Access_Protected_Subprogram_Type;
4632
4633   subtype Access_Protected_Kind       is Entity_Kind range
4634      E_Access_Protected_Subprogram_Type ..
4635      E_Anonymous_Access_Protected_Subprogram_Type;
4636
4637   subtype Aggregate_Kind              is Entity_Kind range
4638       E_Array_Type ..
4639   --  E_Array_Subtype
4640   --  E_String_Type
4641   --  E_String_Subtype
4642   --  E_String_Literal_Subtype
4643   --  E_Class_Wide_Type
4644   --  E_Class_Wide_Subtype
4645   --  E_Record_Type
4646       E_Record_Subtype;
4647
4648   subtype Array_Kind                  is Entity_Kind range
4649       E_Array_Type ..
4650   --  E_Array_Subtype
4651   --  E_String_Type
4652   --  E_String_Subtype
4653       E_String_Literal_Subtype;
4654
4655   subtype Assignable_Kind             is Entity_Kind range
4656       E_Variable ..
4657   --  E_Out_Parameter
4658       E_In_Out_Parameter;
4659
4660   subtype Class_Wide_Kind             is Entity_Kind range
4661       E_Class_Wide_Type ..
4662       E_Class_Wide_Subtype;
4663
4664   subtype Composite_Kind              is Entity_Kind range
4665       E_Array_Type ..
4666   --  E_Array_Subtype
4667   --  E_String_Type
4668   --  E_String_Subtype
4669   --  E_String_Literal_Subtype
4670   --  E_Class_Wide_Type
4671   --  E_Class_Wide_Subtype
4672   --  E_Record_Type
4673   --  E_Record_Subtype
4674   --  E_Record_Type_With_Private
4675   --  E_Record_Subtype_With_Private
4676   --  E_Private_Type
4677   --  E_Private_Subtype
4678   --  E_Limited_Private_Type
4679   --  E_Limited_Private_Subtype
4680   --  E_Incomplete_Type
4681   --  E_Incomplete_Subtype
4682   --  E_Task_Type
4683   --  E_Task_Subtype,
4684   --  E_Protected_Type,
4685       E_Protected_Subtype;
4686
4687   subtype Concurrent_Kind             is Entity_Kind range
4688       E_Task_Type ..
4689   --  E_Task_Subtype,
4690   --  E_Protected_Type,
4691       E_Protected_Subtype;
4692
4693   subtype Concurrent_Body_Kind        is Entity_Kind range
4694       E_Protected_Body ..
4695       E_Task_Body;
4696
4697   subtype Decimal_Fixed_Point_Kind    is Entity_Kind range
4698       E_Decimal_Fixed_Point_Type ..
4699       E_Decimal_Fixed_Point_Subtype;
4700
4701   subtype Digits_Kind                 is Entity_Kind range
4702       E_Decimal_Fixed_Point_Type ..
4703   --  E_Decimal_Fixed_Point_Subtype
4704   --  E_Floating_Point_Type
4705       E_Floating_Point_Subtype;
4706
4707   subtype Discrete_Kind               is Entity_Kind range
4708       E_Enumeration_Type ..
4709   --  E_Enumeration_Subtype
4710   --  E_Signed_Integer_Type
4711   --  E_Signed_Integer_Subtype
4712   --  E_Modular_Integer_Type
4713       E_Modular_Integer_Subtype;
4714
4715   subtype Discrete_Or_Fixed_Point_Kind is Entity_Kind range
4716       E_Enumeration_Type ..
4717   --  E_Enumeration_Subtype
4718   --  E_Signed_Integer_Type
4719   --  E_Signed_Integer_Subtype
4720   --  E_Modular_Integer_Type
4721   --  E_Modular_Integer_Subtype
4722   --  E_Ordinary_Fixed_Point_Type
4723   --  E_Ordinary_Fixed_Point_Subtype
4724   --  E_Decimal_Fixed_Point_Type
4725       E_Decimal_Fixed_Point_Subtype;
4726
4727   subtype Elementary_Kind             is Entity_Kind range
4728       E_Enumeration_Type ..
4729   --  E_Enumeration_Subtype
4730   --  E_Signed_Integer_Type
4731   --  E_Signed_Integer_Subtype
4732   --  E_Modular_Integer_Type
4733   --  E_Modular_Integer_Subtype
4734   --  E_Ordinary_Fixed_Point_Type
4735   --  E_Ordinary_Fixed_Point_Subtype
4736   --  E_Decimal_Fixed_Point_Type
4737   --  E_Decimal_Fixed_Point_Subtype
4738   --  E_Floating_Point_Type
4739   --  E_Floating_Point_Subtype
4740   --  E_Access_Type
4741   --  E_Access_Subtype
4742   --  E_Access_Attribute_Type
4743   --  E_Allocator_Type
4744   --  E_General_Access_Type
4745   --  E_Access_Subprogram_Type
4746   --  E_Access_Protected_Subprogram_Type
4747   --  E_Anonymous_Access_Subprogram_Type
4748   --  E_Anonymous_Access_Protected_Subprogram_Type
4749       E_Anonymous_Access_Type;
4750
4751   subtype Enumeration_Kind            is Entity_Kind range
4752       E_Enumeration_Type ..
4753       E_Enumeration_Subtype;
4754
4755   subtype Entry_Kind                  is Entity_Kind range
4756       E_Entry ..
4757       E_Entry_Family;
4758
4759   subtype Fixed_Point_Kind            is Entity_Kind range
4760       E_Ordinary_Fixed_Point_Type ..
4761   --  E_Ordinary_Fixed_Point_Subtype
4762   --  E_Decimal_Fixed_Point_Type
4763       E_Decimal_Fixed_Point_Subtype;
4764
4765   subtype Float_Kind                  is Entity_Kind range
4766       E_Floating_Point_Type ..
4767       E_Floating_Point_Subtype;
4768
4769   subtype Formal_Kind                 is Entity_Kind range
4770       E_Out_Parameter ..
4771   --  E_In_Out_Parameter
4772       E_In_Parameter;
4773
4774   subtype Formal_Object_Kind          is Entity_Kind range
4775       E_Generic_In_Out_Parameter ..
4776       E_Generic_In_Parameter;
4777
4778   subtype Generic_Subprogram_Kind     is Entity_Kind range
4779       E_Generic_Function ..
4780       E_Generic_Procedure;
4781
4782   subtype Generic_Unit_Kind           is Entity_Kind range
4783       E_Generic_Function ..
4784   --  E_Generic_Procedure
4785       E_Generic_Package;
4786
4787   subtype Incomplete_Kind             is Entity_Kind range
4788       E_Incomplete_Type ..
4789       E_Incomplete_Subtype;
4790
4791   subtype Incomplete_Or_Private_Kind  is Entity_Kind range
4792       E_Record_Type_With_Private ..
4793   --  E_Record_Subtype_With_Private
4794   --  E_Private_Type
4795   --  E_Private_Subtype
4796   --  E_Limited_Private_Type
4797   --  E_Limited_Private_Subtype
4798   --  E_Incomplete_Type
4799       E_Incomplete_Subtype;
4800
4801   subtype Integer_Kind                is Entity_Kind range
4802       E_Signed_Integer_Type ..
4803   --  E_Signed_Integer_Subtype
4804   --  E_Modular_Integer_Type
4805       E_Modular_Integer_Subtype;
4806
4807   subtype Modular_Integer_Kind        is Entity_Kind range
4808       E_Modular_Integer_Type ..
4809       E_Modular_Integer_Subtype;
4810
4811   subtype Named_Kind                  is Entity_Kind range
4812       E_Named_Integer ..
4813       E_Named_Real;
4814
4815   subtype Numeric_Kind                is Entity_Kind range
4816       E_Signed_Integer_Type ..
4817   --  E_Signed_Integer_Subtype
4818   --  E_Modular_Integer_Type
4819   --  E_Modular_Integer_Subtype
4820   --  E_Ordinary_Fixed_Point_Type
4821   --  E_Ordinary_Fixed_Point_Subtype
4822   --  E_Decimal_Fixed_Point_Type
4823   --  E_Decimal_Fixed_Point_Subtype
4824   --  E_Floating_Point_Type
4825       E_Floating_Point_Subtype;
4826
4827   subtype Object_Kind                 is Entity_Kind range
4828       E_Component ..
4829   --  E_Constant
4830   --  E_Discriminant
4831   --  E_Loop_Parameter
4832   --  E_Variable
4833   --  E_Out_Parameter
4834   --  E_In_Out_Parameter
4835   --  E_In_Parameter
4836   --  E_Generic_In_Out_Parameter
4837       E_Generic_In_Parameter;
4838
4839   subtype Ordinary_Fixed_Point_Kind   is Entity_Kind range
4840       E_Ordinary_Fixed_Point_Type ..
4841       E_Ordinary_Fixed_Point_Subtype;
4842
4843   subtype Overloadable_Kind           is Entity_Kind range
4844       E_Enumeration_Literal ..
4845   --  E_Function
4846   --  E_Operator
4847   --  E_Procedure
4848   --  E_Entry
4849       E_Abstract_State;
4850
4851   subtype Private_Kind                is Entity_Kind range
4852       E_Record_Type_With_Private ..
4853   --  E_Record_Subtype_With_Private
4854   --  E_Private_Type
4855   --  E_Private_Subtype
4856   --  E_Limited_Private_Type
4857       E_Limited_Private_Subtype;
4858
4859   subtype Protected_Kind              is Entity_Kind range
4860       E_Protected_Type ..
4861       E_Protected_Subtype;
4862
4863   subtype Real_Kind                   is Entity_Kind range
4864       E_Ordinary_Fixed_Point_Type ..
4865   --  E_Ordinary_Fixed_Point_Subtype
4866   --  E_Decimal_Fixed_Point_Type
4867   --  E_Decimal_Fixed_Point_Subtype
4868   --  E_Floating_Point_Type
4869       E_Floating_Point_Subtype;
4870
4871   subtype Record_Kind                 is Entity_Kind range
4872       E_Class_Wide_Type ..
4873   --  E_Class_Wide_Subtype
4874   --  E_Record_Type
4875   --  E_Record_Subtype
4876   --  E_Record_Type_With_Private
4877       E_Record_Subtype_With_Private;
4878
4879   subtype Scalar_Kind                 is Entity_Kind range
4880       E_Enumeration_Type ..
4881   --  E_Enumeration_Subtype
4882   --  E_Signed_Integer_Type
4883   --  E_Signed_Integer_Subtype
4884   --  E_Modular_Integer_Type
4885   --  E_Modular_Integer_Subtype
4886   --  E_Ordinary_Fixed_Point_Type
4887   --  E_Ordinary_Fixed_Point_Subtype
4888   --  E_Decimal_Fixed_Point_Type
4889   --  E_Decimal_Fixed_Point_Subtype
4890   --  E_Floating_Point_Type
4891       E_Floating_Point_Subtype;
4892
4893   subtype String_Kind                 is Entity_Kind range
4894       E_String_Type ..
4895   --  E_String_Subtype
4896       E_String_Literal_Subtype;
4897
4898   subtype Subprogram_Kind             is Entity_Kind range
4899       E_Function ..
4900   --  E_Operator
4901       E_Procedure;
4902
4903   subtype Signed_Integer_Kind         is Entity_Kind range
4904       E_Signed_Integer_Type ..
4905       E_Signed_Integer_Subtype;
4906
4907   subtype Task_Kind                   is Entity_Kind range
4908       E_Task_Type ..
4909       E_Task_Subtype;
4910
4911   subtype Type_Kind                   is Entity_Kind range
4912       E_Enumeration_Type ..
4913   --  E_Enumeration_Subtype
4914   --  E_Signed_Integer_Type
4915   --  E_Signed_Integer_Subtype
4916   --  E_Modular_Integer_Type
4917   --  E_Modular_Integer_Subtype
4918   --  E_Ordinary_Fixed_Point_Type
4919   --  E_Ordinary_Fixed_Point_Subtype
4920   --  E_Decimal_Fixed_Point_Type
4921   --  E_Decimal_Fixed_Point_Subtype
4922   --  E_Floating_Point_Type
4923   --  E_Floating_Point_Subtype
4924   --  E_Access_Type
4925   --  E_Access_Subtype
4926   --  E_Access_Attribute_Type
4927   --  E_Allocator_Type,
4928   --  E_General_Access_Type
4929   --  E_Access_Subprogram_Type,
4930   --  E_Access_Protected_Subprogram_Type
4931   --  E_Anonymous_Access_Subprogram_Type
4932   --  E_Anonymous_Access_Protected_Subprogram_Type
4933   --  E_Anonymous_Access_Type
4934   --  E_Array_Type
4935   --  E_Array_Subtype
4936   --  E_String_Type
4937   --  E_String_Subtype
4938   --  E_String_Literal_Subtype
4939   --  E_Class_Wide_Subtype
4940   --  E_Class_Wide_Type
4941   --  E_Record_Type
4942   --  E_Record_Subtype
4943   --  E_Record_Type_With_Private
4944   --  E_Record_Subtype_With_Private
4945   --  E_Private_Type
4946   --  E_Private_Subtype
4947   --  E_Limited_Private_Type
4948   --  E_Limited_Private_Subtype
4949   --  E_Incomplete_Type
4950   --  E_Incomplete_Subtype
4951   --  E_Task_Type
4952   --  E_Task_Subtype
4953   --  E_Protected_Type
4954   --  E_Protected_Subtype
4955   --  E_Exception_Type
4956       E_Subprogram_Type;
4957
4958   --------------------------------------------------------
4959   -- Description of Defined Attributes for Entity_Kinds --
4960   --------------------------------------------------------
4961
4962   --  For each enumeration value defined in Entity_Kind we list all the
4963   --  attributes defined in Einfo which can legally be applied to an entity
4964   --  of that kind. The implementation of the attribute functions (and for
4965   --  non-synthesized attributes, of the corresponding set procedures) are
4966   --  in the Einfo body.
4967
4968   --  The following attributes are defined in all entities
4969
4970   --    Ekind                               (Ekind)
4971
4972   --    Chars                               (Name1)
4973   --    Next_Entity                         (Node2)
4974   --    Scope                               (Node3)
4975   --    Homonym                             (Node4)
4976   --    Etype                               (Node5)
4977   --    First_Rep_Item                      (Node6)
4978   --    Freeze_Node                         (Node7)
4979
4980   --    Address_Taken                       (Flag104)
4981   --    Can_Never_Be_Null                   (Flag38)
4982   --    Checks_May_Be_Suppressed            (Flag31)
4983   --    Debug_Info_Off                      (Flag166)
4984   --    Has_Convention_Pragma               (Flag119)
4985   --    Has_Delayed_Aspects                 (Flag200)
4986   --    Has_Delayed_Freeze                  (Flag18)
4987   --    Has_Fully_Qualified_Name            (Flag173)
4988   --    Has_Gigi_Rep_Item                   (Flag82)
4989   --    Has_Homonym                         (Flag56)
4990   --    Has_Pragma_Elaborate_Body           (Flag150)
4991   --    Has_Pragma_Inline                   (Flag157)
4992   --    Has_Pragma_Inline_Always            (Flag230)
4993   --    Has_Pragma_No_Inline                (Flag201)
4994   --    Has_Pragma_Pure                     (Flag203)
4995   --    Has_Pragma_Pure_Function            (Flag179)
4996   --    Has_Pragma_Thread_Local_Storage     (Flag169)
4997   --    Has_Pragma_Unmodified               (Flag233)
4998   --    Has_Pragma_Unreferenced             (Flag180)
4999   --    Has_Private_Declaration             (Flag155)
5000   --    Has_Qualified_Name                  (Flag161)
5001   --    Has_Stream_Size_Clause              (Flag184)
5002   --    Has_Unknown_Discriminants           (Flag72)
5003   --    Has_Xref_Entry                      (Flag182)
5004   --    In_Private_Part                     (Flag45)
5005   --    Is_Ada_2005_Only                    (Flag185)
5006   --    Is_Ada_2012_Only                    (Flag199)
5007   --    Is_Bit_Packed_Array                 (Flag122)  (base type only)
5008   --    Is_Aliased                          (Flag15)
5009   --    Is_Character_Type                   (Flag63)
5010   --    Is_Child_Unit                       (Flag73)
5011   --    Is_Compilation_Unit                 (Flag149)
5012   --    Is_Completely_Hidden                (Flag103)
5013   --    Is_Descendent_Of_Address            (Flag223)
5014   --    Is_Discrim_SO_Function              (Flag176)
5015   --    Is_Discriminant_Check_Function      (Flag264)
5016   --    Is_Dispatch_Table_Entity            (Flag234)
5017   --    Is_Dispatching_Operation            (Flag6)
5018   --    Is_Entry_Formal                     (Flag52)
5019   --    Is_Exported                         (Flag99)
5020   --    Is_First_Subtype                    (Flag70)
5021   --    Is_Formal_Subprogram                (Flag111)
5022   --    Is_Generic_Instance                 (Flag130)
5023   --    Is_Generic_Type                     (Flag13)
5024   --    Is_Hidden                           (Flag57)
5025   --    Is_Hidden_Open_Scope                (Flag171)
5026   --    Is_Immediately_Visible              (Flag7)
5027   --    Is_Implementation_Defined           (Flag254)
5028   --    Is_Imported                         (Flag24)
5029   --    Is_Inlined                          (Flag11)
5030   --    Is_Internal                         (Flag17)
5031   --    Is_Itype                            (Flag91)
5032   --    Is_Known_Non_Null                   (Flag37)
5033   --    Is_Known_Null                       (Flag204)
5034   --    Is_Known_Valid                      (Flag170)
5035   --    Is_Limited_Composite                (Flag106)
5036   --    Is_Limited_Record                   (Flag25)
5037   --    Is_Obsolescent                      (Flag153)
5038   --    Is_Package_Body_Entity              (Flag160)
5039   --    Is_Packed_Array_Type                (Flag138)
5040   --    Is_Potentially_Use_Visible          (Flag9)
5041   --    Is_Preelaborated                    (Flag59)
5042   --    Is_Primitive_Wrapper                (Flag195)
5043   --    Is_Public                           (Flag10)
5044   --    Is_Pure                             (Flag44)
5045   --    Is_Remote_Call_Interface            (Flag62)
5046   --    Is_Remote_Types                     (Flag61)
5047   --    Is_Renaming_Of_Object               (Flag112)
5048   --    Is_Shared_Passive                   (Flag60)
5049   --    Is_Statically_Allocated             (Flag28)
5050   --    Is_Tagged_Type                      (Flag55)
5051   --    Is_Thunk                            (Flag225)
5052   --    Is_Trivial_Subprogram               (Flag235)
5053   --    Is_Unchecked_Union                  (Flag117)
5054   --    Is_Visible_Formal                   (Flag206)
5055   --    Is_VMS_Exception                    (Flag133)
5056   --    Kill_Elaboration_Checks             (Flag32)
5057   --    Kill_Range_Checks                   (Flag33)
5058   --    Low_Bound_Tested                    (Flag205)
5059   --    Materialize_Entity                  (Flag168)
5060   --    Needs_Debug_Info                    (Flag147)
5061   --    Never_Set_In_Source                 (Flag115)
5062   --    No_Return                           (Flag113)
5063   --    Overlays_Constant                   (Flag243)
5064   --    Referenced                          (Flag156)
5065   --    Referenced_As_LHS                   (Flag36)
5066   --    Referenced_As_Out_Parameter         (Flag227)
5067   --    Suppress_Elaboration_Warnings       (Flag148)
5068   --    Suppress_Style_Checks               (Flag165)
5069   --    Suppress_Value_Tracking_On_Call     (Flag217)
5070   --    Used_As_Generic_Actual              (Flag222)
5071   --    Warnings_Off                        (Flag96)
5072   --    Warnings_Off_Used                   (Flag236)
5073   --    Warnings_Off_Used_Unmodified        (Flag237)
5074   --    Warnings_Off_Used_Unreferenced      (Flag238)
5075   --    Was_Hidden                          (Flag196)
5076
5077   --    Declaration_Node                    (synth)
5078   --    Has_Foreign_Convention              (synth)
5079   --    Is_Dynamic_Scope                    (synth)
5080   --    Is_Standard_Character_Type          (synth)
5081   --    Underlying_Type                     (synth)
5082   --    all classification attributes       (synth)
5083
5084   --  The following list of access functions applies to all entities for
5085   --  types and subtypes. References to this list appear subsequently as
5086   --  as "(plus type attributes)" for each appropriate Entity_Kind.
5087
5088   --    Associated_Node_For_Itype           (Node8)
5089   --    Class_Wide_Type                     (Node9)
5090   --    Full_View                           (Node11)
5091   --    Esize                               (Uint12)
5092   --    RM_Size                             (Uint13)
5093   --    Alignment                           (Uint14)
5094   --    Related_Expression                  (Node24)
5095   --    Current_Use_Clause                  (Node27)
5096   --    Subprograms_For_Type                (Node29)
5097   --    Linker_Section_Pragma               (Node33)
5098
5099   --    Depends_On_Private                  (Flag14)
5100   --    Discard_Names                       (Flag88)
5101   --    Finalize_Storage_Only               (Flag158)  (base type only)
5102   --    From_Limited_With                   (Flag159)
5103   --    Has_Aliased_Components              (Flag135)  (base type only)
5104   --    Has_Alignment_Clause                (Flag46)
5105   --    Has_Atomic_Components               (Flag86)   (base type only)
5106   --    Has_Completion_In_Body              (Flag71)
5107   --    Has_Complex_Representation          (Flag140)  (base type only)
5108   --    Has_Constrained_Partial_View        (Flag187)
5109   --    Has_Controlled_Component            (Flag43)   (base type only)
5110   --    Has_Default_Aspect                  (Flag39)   (base type only)
5111   --    Has_Delayed_Rep_Aspects             (Flag261)
5112   --    Has_Discriminants                   (Flag5)
5113   --    Has_Dynamic_Predicate_Aspect        (Flag258)
5114   --    Has_Independent_Components          (Flag34)   (base type only)
5115   --    Has_Inheritable_Invariants          (Flag248)
5116   --    Has_Invariants                      (Flag232)
5117   --    Has_Non_Standard_Rep                (Flag75)   (base type only)
5118   --    Has_Object_Size_Clause              (Flag172)
5119   --    Has_Pragma_Preelab_Init             (Flag221)
5120   --    Has_Pragma_Unreferenced_Objects     (Flag212)
5121   --    Has_Predicates                      (Flag250)
5122   --    Has_Primitive_Operations            (Flag120)  (base type only)
5123   --    Has_Size_Clause                     (Flag29)
5124   --    Has_Specified_Layout                (Flag100)  (base type only)
5125   --    Has_Specified_Stream_Input          (Flag190)
5126   --    Has_Specified_Stream_Output         (Flag191)
5127   --    Has_Specified_Stream_Read           (Flag192)
5128   --    Has_Specified_Stream_Write          (Flag193)
5129   --    Has_Static_Predicate_Aspect         (Flag259)
5130   --    Has_Task                            (Flag30)   (base type only)
5131   --    Has_Unchecked_Union                 (Flag123)  (base type only)
5132   --    Has_Volatile_Components             (Flag87)   (base type only)
5133   --    In_Use                              (Flag8)
5134   --    Is_Abstract_Type                    (Flag146)
5135   --    Is_Asynchronous                     (Flag81)
5136   --    Is_Atomic                           (Flag85)
5137   --    Is_Constr_Subt_For_U_Nominal        (Flag80)
5138   --    Is_Constr_Subt_For_UN_Aliased       (Flag141)
5139   --    Is_Controlled                       (Flag42)   (base type only)
5140   --    Is_Eliminated                       (Flag124)
5141   --    Is_Frozen                           (Flag4)
5142   --    Is_Generic_Actual_Type              (Flag94)
5143   --    Is_RACW_Stub_Type                   (Flag244)
5144   --    Is_Non_Static_Subtype               (Flag109)
5145   --    Is_Packed                           (Flag51)   (base type only)
5146   --    Is_Private_Composite                (Flag107)
5147   --    Is_Unsigned_Type                    (Flag144)
5148   --    Is_Volatile                         (Flag16)
5149   --    Itype_Printed                       (Flag202)  (itypes only)
5150   --    Known_To_Have_Preelab_Init          (Flag207)
5151   --    May_Inherit_Delayed_Rep_Aspects     (Flag262)
5152   --    Must_Be_On_Byte_Boundary            (Flag183)
5153   --    Must_Have_Preelab_Init              (Flag208)
5154   --    Optimize_Alignment_Space            (Flag241)
5155   --    Optimize_Alignment_Time             (Flag242)
5156   --    Size_Depends_On_Discriminant        (Flag177)
5157   --    Size_Known_At_Compile_Time          (Flag92)
5158   --    Strict_Alignment                    (Flag145)  (base type only)
5159   --    Suppress_Initialization             (Flag105)
5160   --    Treat_As_Volatile                   (Flag41)
5161   --    Universal_Aliasing                  (Flag216)  (impl base type only)
5162
5163   --    Alignment_Clause                    (synth)
5164   --    Base_Type                           (synth)
5165   --    Implementation_Base_Type            (synth)
5166   --    Invariant_Procedure                 (synth)
5167   --    Is_Access_Protected_Subprogram_Type (synth)
5168   --    Predicate_Function                  (synth)
5169   --    Predicate_Function_M                (synth)
5170   --    Root_Type                           (synth)
5171   --    Size_Clause                         (synth)
5172
5173   ------------------------------------------
5174   -- Applicable attributes by entity kind --
5175   ------------------------------------------
5176
5177   --  E_Abstract_State
5178   --    Refinement_Constituents             (Elist8)
5179   --    Part_Of_Constituents                (Elist9)
5180   --    Encapsulating_State                 (Node10)
5181   --    Body_References                     (Elist16)
5182   --    Non_Limited_View                    (Node17)
5183   --    From_Limited_With                   (Flag159)
5184   --    Has_Visible_Refinement              (Flag263)
5185   --    Has_Non_Null_Refinement             (synth)
5186   --    Has_Null_Refinement                 (synth)
5187   --    Is_External_State                   (synth)
5188   --    Is_Null_State                       (synth)
5189
5190   --  E_Access_Protected_Subprogram_Type
5191   --    Equivalent_Type                     (Node18)
5192   --    Directly_Designated_Type            (Node20)
5193   --    Needs_No_Actuals                    (Flag22)
5194   --    Can_Use_Internal_Rep                (Flag229)
5195   --    (plus type attributes)
5196
5197   --  E_Access_Subprogram_Type
5198   --    Equivalent_Type                     (Node18)   (remote types only)
5199   --    Directly_Designated_Type            (Node20)
5200   --    Interface_Name                      (Node21)   (JGNAT usage only)
5201   --    Needs_No_Actuals                    (Flag22)
5202   --    Original_Access_Type                (Node26)
5203   --    Can_Use_Internal_Rep                (Flag229)
5204   --    (plus type attributes)
5205
5206   --  E_Access_Type
5207   --  E_Access_Subtype
5208   --    Storage_Size_Variable               (Node15)   (base type only)
5209   --    Master_Id                           (Node17)
5210   --    Directly_Designated_Type            (Node20)
5211   --    Associated_Storage_Pool             (Node22)   (base type only)
5212   --    Finalization_Master                 (Node23)   (base type only)
5213   --    Has_Pragma_Controlled               (Flag27)   (base type only)
5214   --    Has_Storage_Size_Clause             (Flag23)   (base type only)
5215   --    Is_Access_Constant                  (Flag69)
5216   --    Is_Local_Anonymous_Access           (Flag194)
5217   --    Is_Pure_Unit_Access_Type            (Flag189)
5218   --    No_Pool_Assigned                    (Flag131)  (base type only)
5219   --    No_Strict_Aliasing                  (Flag136)  (base type only)
5220   --    (plus type attributes)
5221
5222   --  E_Access_Attribute_Type
5223   --    Directly_Designated_Type            (Node20)
5224   --    (plus type attributes)
5225
5226   --  E_Allocator_Type
5227   --    Directly_Designated_Type            (Node20)
5228   --    (plus type attributes)
5229
5230   --  E_Anonymous_Access_Subprogram_Type
5231   --  E_Anonymous_Access_Protected_Subprogram_Type
5232   --    Storage_Size_Variable               (Node15)   ??? is this needed ???
5233   --    Directly_Designated_Type            (Node20)
5234   --    Can_Use_Internal_Rep                (Flag229)
5235   --    (plus type attributes)
5236
5237   --  E_Anonymous_Access_Type
5238   --    Storage_Size_Variable               (Node15)   ??? is this needed ???
5239   --    Directly_Designated_Type            (Node20)
5240   --    Finalization_Master                 (Node23)
5241   --    (plus type attributes)
5242
5243   --  E_Array_Type
5244   --  E_Array_Subtype
5245   --    First_Index                         (Node17)
5246   --    Default_Aspect_Component_Value      (Node19)   (base type only)
5247   --    Component_Type                      (Node20)   (base type only)
5248   --    Original_Array_Type                 (Node21)
5249   --    Component_Size                      (Uint22)   (base type only)
5250   --    Packed_Array_Type                   (Node23)
5251   --    Related_Array_Object                (Node25)
5252   --    Component_Alignment                 (special)  (base type only)
5253   --    Has_Component_Size_Clause           (Flag68)   (base type only)
5254   --    Has_Pragma_Pack                     (Flag121)  (impl base type only)
5255   --    Is_Constrained                      (Flag12)
5256   --    Reverse_Storage_Order               (Flag93)   (base type only)
5257   --    Next_Index                          (synth)
5258   --    Number_Dimensions                   (synth)
5259   --    (plus type attributes)
5260
5261   --  E_Block
5262   --    Block_Node                          (Node11)
5263   --    First_Entity                        (Node17)
5264   --    Last_Entity                         (Node20)
5265   --    Scope_Depth_Value                   (Uint22)
5266   --    Entry_Cancel_Parameter              (Node23)
5267   --    Delay_Cleanups                      (Flag114)
5268   --    Discard_Names                       (Flag88)
5269   --    Has_Master_Entity                   (Flag21)
5270   --    Has_Nested_Block_With_Handler       (Flag101)
5271   --    Sec_Stack_Needed_For_Return         (Flag167)
5272   --    Uses_Sec_Stack                      (Flag95)
5273   --    Scope_Depth                         (synth)
5274
5275   --  E_Class_Wide_Type
5276   --  E_Class_Wide_Subtype
5277   --    Direct_Primitive_Operations         (Elist10)
5278   --    Cloned_Subtype                      (Node16)   (subtype case only)
5279   --    First_Entity                        (Node17)
5280   --    Equivalent_Type                     (Node18)   (always Empty for type)
5281   --    Last_Entity                         (Node20)
5282   --    First_Component                     (synth)
5283   --    First_Component_Or_Discriminant     (synth)
5284   --    (plus type attributes)
5285
5286   --  E_Component
5287   --    Normalized_First_Bit                (Uint8)
5288   --    Current_Value                       (Node9)    (always Empty)
5289   --    Normalized_Position_Max             (Uint10)
5290   --    Component_Bit_Offset                (Uint11)
5291   --    Esize                               (Uint12)
5292   --    Component_Clause                    (Node13)
5293   --    Normalized_Position                 (Uint14)
5294   --    DT_Entry_Count                      (Uint15)
5295   --    Entry_Formal                        (Node16)
5296   --    Prival                              (Node17)
5297   --    Renamed_Object                      (Node18)   (always Empty)
5298   --    Discriminant_Checking_Func          (Node20)
5299   --    Interface_Name                      (Node21)   (JGNAT usage only)
5300   --    Original_Record_Component           (Node22)
5301   --    DT_Offset_To_Top_Func               (Node25)
5302   --    Related_Type                        (Node27)
5303   --    Has_Biased_Representation           (Flag139)
5304   --    Has_Per_Object_Constraint           (Flag154)
5305   --    Is_Atomic                           (Flag85)
5306   --    Is_Tag                              (Flag78)
5307   --    Is_Volatile                         (Flag16)
5308   --    Treat_As_Volatile                   (Flag41)
5309   --    Is_Return_Object                    (Flag209)
5310   --    Next_Component                      (synth)
5311   --    Next_Component_Or_Discriminant      (synth)
5312
5313   --  E_Constant
5314   --  E_Loop_Parameter
5315   --    Current_Value                       (Node9)    (always Empty)
5316   --    Discriminal_Link                    (Node10)
5317   --    Full_View                           (Node11)
5318   --    Esize                               (Uint12)
5319   --    Extra_Accessibility                 (Node13)   (constants only)
5320   --    Alignment                           (Uint14)
5321   --    Status_Flag_Or_Transient_Decl       (Node15)   (constants only)
5322   --    Actual_Subtype                      (Node17)
5323   --    Renamed_Object                      (Node18)
5324   --    Size_Check_Code                     (Node19)   (constants only)
5325   --    Prival_Link                         (Node20)   (privals only)
5326   --    Interface_Name                      (Node21)   (constants only)
5327   --    Related_Type                        (Node27)   (constants only)
5328   --    Initialization_Statements           (Node28)
5329   --    BIP_Initialization_Call             (Node29)
5330   --    Linker_Section_Pragma               (Node33)
5331   --    Has_Alignment_Clause                (Flag46)
5332   --    Has_Atomic_Components               (Flag86)
5333   --    Has_Biased_Representation           (Flag139)
5334   --    Has_Completion                      (Flag26)   (constants only)
5335   --    Has_Independent_Components          (Flag34)   (base type only)
5336   --    Has_Thunks                          (Flag228)  (constants only)
5337   --    Has_Size_Clause                     (Flag29)
5338   --    Has_Up_Level_Access                 (Flag215)
5339   --    Has_Volatile_Components             (Flag87)
5340   --    Is_Atomic                           (Flag85)
5341   --    Is_Eliminated                       (Flag124)
5342   --    Is_Processed_Transient              (Flag252)  (constants only)
5343   --    Is_Return_Object                    (Flag209)
5344   --    Is_True_Constant                    (Flag163)
5345   --    Is_Volatile                         (Flag16)
5346   --    Optimize_Alignment_Space            (Flag241)  (constants only)
5347   --    Optimize_Alignment_Time             (Flag242)  (constants only)
5348   --    Treat_As_Volatile                   (Flag41)
5349   --    Address_Clause                      (synth)
5350   --    Alignment_Clause                    (synth)
5351   --    Size_Clause                         (synth)
5352
5353   --  E_Decimal_Fixed_Point_Type
5354   --  E_Decimal_Fixed_Subtype
5355   --    Scale_Value                         (Uint15)
5356   --    Digits_Value                        (Uint17)
5357   --    Scalar_Range                        (Node20)
5358   --    Delta_Value                         (Ureal18)
5359   --    Small_Value                         (Ureal21)
5360   --    Has_Machine_Radix_Clause            (Flag83)
5361   --    Machine_Radix_10                    (Flag84)
5362   --    Aft_Value                           (synth)
5363   --    Type_Low_Bound                      (synth)
5364   --    Type_High_Bound                     (synth)
5365   --    (plus type attributes)
5366
5367   --  E_Discriminant
5368   --    Normalized_First_Bit                (Uint8)
5369   --    Current_Value                       (Node9)    (always Empty)
5370   --    Normalized_Position_Max             (Uint10)
5371   --    Component_Bit_Offset                (Uint11)
5372   --    Esize                               (Uint12)
5373   --    Component_Clause                    (Node13)
5374   --    Normalized_Position                 (Uint14)
5375   --    Discriminant_Number                 (Uint15)
5376   --    Discriminal                         (Node17)
5377   --    Renamed_Object                      (Node18)   (always Empty)
5378   --    Corresponding_Discriminant          (Node19)
5379   --    Discriminant_Default_Value          (Node20)
5380   --    Interface_Name                      (Node21)   (JGNAT usage only)
5381   --    Original_Record_Component           (Node22)
5382   --    CR_Discriminant                     (Node23)
5383   --    Is_Return_Object                    (Flag209)
5384   --    Next_Component_Or_Discriminant      (synth)
5385   --    Next_Discriminant                   (synth)
5386   --    Next_Stored_Discriminant            (synth)
5387
5388   --  E_Entry
5389   --  E_Entry_Family
5390   --    Protected_Body_Subprogram           (Node11)
5391   --    Barrier_Function                    (Node12)
5392   --    Entry_Parameters_Type               (Node15)
5393   --    First_Entity                        (Node17)
5394   --    Alias                               (Node18)   (for entry only. Empty)
5395   --    Last_Entity                         (Node20)
5396   --    Accept_Address                      (Elist21)
5397   --    Scope_Depth_Value                   (Uint22)
5398   --    Protection_Object                   (Node23)   (protected kind)
5399   --    PPC_Wrapper                         (Node25)
5400   --    Extra_Formals                       (Node28)
5401   --    Contract                            (Node34)
5402   --    Default_Expressions_Processed       (Flag108)
5403   --    Entry_Accepted                      (Flag152)
5404   --    Is_AST_Entry                        (Flag132)  (for entry only)
5405   --    Needs_No_Actuals                    (Flag22)
5406   --    Sec_Stack_Needed_For_Return         (Flag167)
5407   --    Uses_Sec_Stack                      (Flag95)
5408   --    Address_Clause                      (synth)
5409   --    Entry_Index_Type                    (synth)
5410   --    First_Formal                        (synth)
5411   --    First_Formal_With_Extras            (synth)
5412   --    Last_Formal                         (synth)
5413   --    Number_Formals                      (synth)
5414   --    Scope_Depth                         (synth)
5415
5416   --  E_Entry_Index_Parameter
5417   --    Entry_Index_Constant                (Node18)
5418
5419   --  E_Enumeration_Literal
5420   --    Enumeration_Pos                     (Uint11)
5421   --    Enumeration_Rep                     (Uint12)
5422   --    Alias                               (Node18)
5423   --    Enumeration_Rep_Expr                (Node22)
5424   --    Next_Literal                        (synth)
5425
5426   --  E_Enumeration_Type
5427   --  E_Enumeration_Subtype
5428   --    Lit_Indexes                         (Node15)   (root type only)
5429   --    Lit_Strings                         (Node16)   (root type only)
5430   --    First_Literal                       (Node17)
5431   --    Default_Aspect_Value                (Node19)   (base type only)
5432   --    Scalar_Range                        (Node20)
5433   --    Enum_Pos_To_Rep                     (Node23)   (type only)
5434   --    Static_Predicate                    (List25)
5435   --    Has_Biased_Representation           (Flag139)
5436   --    Has_Contiguous_Rep                  (Flag181)
5437   --    Has_Enumeration_Rep_Clause          (Flag66)
5438   --    Has_Pragma_Ordered                  (Flag198)  (base type only)
5439   --    Nonzero_Is_True                     (Flag162)  (base type only)
5440   --    Type_Low_Bound                      (synth)
5441   --    Type_High_Bound                     (synth)
5442   --    (plus type attributes)
5443
5444   --  E_Exception
5445   --    Esize                               (Uint12)
5446   --    Alignment                           (Uint14)
5447   --    Renamed_Entity                      (Node18)
5448   --    Register_Exception_Call             (Node20)
5449   --    Interface_Name                      (Node21)
5450   --    Exception_Code                      (Uint22)
5451   --    Discard_Names                       (Flag88)
5452   --    Is_VMS_Exception                    (Flag133)
5453   --    Is_Raised                           (Flag224)
5454
5455   --  E_Exception_Type
5456   --    Equivalent_Type                     (Node18)
5457   --    (plus type attributes)
5458
5459   --  E_Floating_Point_Type
5460   --  E_Floating_Point_Subtype
5461   --    Digits_Value                        (Uint17)
5462   --    Float_Rep                           (Uint10)   (Float_Rep_Kind)
5463   --    Default_Aspect_Value                (Node19)   (base type only)
5464   --    Scalar_Range                        (Node20)
5465   --    Machine_Emax_Value                  (synth)
5466   --    Machine_Emin_Value                  (synth)
5467   --    Machine_Mantissa_Value              (synth)
5468   --    Machine_Radix_Value                 (synth)
5469   --    Model_Emin_Value                    (synth)
5470   --    Model_Epsilon_Value                 (synth)
5471   --    Model_Mantissa_Value                (synth)
5472   --    Model_Small_Value                   (synth)
5473   --    Safe_Emax_Value                     (synth)
5474   --    Safe_First_Value                    (synth)
5475   --    Safe_Last_Value                     (synth)
5476   --    Type_Low_Bound                      (synth)
5477   --    Type_High_Bound                     (synth)
5478   --    Vax_Float                           (synth)
5479   --    (plus type attributes)
5480
5481   --  E_Function
5482   --  E_Generic_Function
5483   --    Mechanism                           (Uint8)    (Mechanism_Type)
5484   --    Renaming_Map                        (Uint9)
5485   --    Handler_Records                     (List10)   (non-generic case only)
5486   --    Protected_Body_Subprogram           (Node11)
5487   --    Next_Inlined_Subprogram             (Node12)
5488   --    Elaboration_Entity                  (Node13)   (not implicit /=)
5489   --    First_Optional_Parameter            (Node14)   (non-generic case only)
5490   --    DT_Position                         (Uint15)
5491   --    DTC_Entity                          (Node16)
5492   --    First_Entity                        (Node17)
5493   --    Alias                               (Node18)   (non-generic case only)
5494   --    Renamed_Entity                      (Node18)   (generic case only)
5495   --    Extra_Accessibility_Of_Result       (Node19)   (non-generic case only)
5496   --    Last_Entity                         (Node20)
5497   --    Interface_Name                      (Node21)
5498   --    Scope_Depth_Value                   (Uint22)
5499   --    Generic_Renamings                   (Elist23)  (for an instance)
5500   --    Inner_Instances                     (Elist23)  (generic case only)
5501   --    Protection_Object                   (Node23)   (for concurrent kind)
5502   --    Interface_Alias                     (Node25)
5503   --    Overridden_Operation                (Node26)
5504   --    Wrapped_Entity                      (Node27)   (non-generic case only)
5505   --    Extra_Formals                       (Node28)
5506   --    Subprograms_For_Type                (Node29)
5507   --    Corresponding_Equality              (Node30)   (implicit /= only)
5508   --    Thunk_Entity                        (Node31)   (thunk case only)
5509   --    SPARK_Pragma                        (Node32)
5510   --    Linker_Section_Pragma               (Node33)
5511   --    Contract                            (Node34)
5512   --    Body_Needed_For_SAL                 (Flag40)
5513   --    Elaboration_Entity_Required         (Flag174)
5514   --    Default_Expressions_Processed       (Flag108)
5515   --    Delay_Cleanups                      (Flag114)
5516   --    Delay_Subprogram_Descriptors        (Flag50)
5517   --    Discard_Names                       (Flag88)
5518   --    Has_Anonymous_Master                (Flag253)
5519   --    Has_Completion                      (Flag26)
5520   --    Has_Controlling_Result              (Flag98)
5521   --    Has_Invariants                      (Flag232)
5522   --    Has_Master_Entity                   (Flag21)
5523   --    Has_Missing_Return                  (Flag142)
5524   --    Has_Nested_Block_With_Handler       (Flag101)
5525   --    Has_Postconditions                  (Flag240)
5526   --    Has_Recursive_Call                  (Flag143)
5527   --    Is_Abstract_Subprogram              (Flag19)   (non-generic case only)
5528   --    Is_Called                           (Flag102)  (non-generic case only)
5529   --    Is_Constructor                      (Flag76)
5530   --    Is_Discrim_SO_Function              (Flag176)
5531   --    Is_Discriminant_Check_Function      (Flag264)
5532   --    Is_Eliminated                       (Flag124)
5533   --    Is_Instantiated                     (Flag126)  (generic case only)
5534   --    Is_Intrinsic_Subprogram             (Flag64)
5535   --    Is_Invariant_Procedure              (Flag257)  (non-generic case only)
5536   --    Is_Machine_Code_Subprogram          (Flag137)  (non-generic case only)
5537   --    Is_Predicate_Function               (Flag255)  (non-generic case only)
5538   --    Is_Predicate_Function_M             (Flag256)  (non-generic case only)
5539   --    Is_Primitive                        (Flag218)
5540   --    Is_Primitive_Wrapper                (Flag195)  (non-generic case only)
5541   --    Is_Private_Descendant               (Flag53)
5542   --    Is_Private_Primitive                (Flag245)  (non-generic case only)
5543   --    Is_Pure                             (Flag44)
5544   --    Is_Visible_Lib_Unit                 (Flag116)
5545   --    Needs_No_Actuals                    (Flag22)
5546   --    Requires_Overriding                 (Flag213)  (non-generic case only)
5547   --    Return_Present                      (Flag54)
5548   --    Returns_By_Ref                      (Flag90)
5549   --    Sec_Stack_Needed_For_Return         (Flag167)
5550   --    SPARK_Pragma_Inherited              (Flag265)
5551   --    Uses_Sec_Stack                      (Flag95)
5552   --    Address_Clause                      (synth)
5553   --    First_Formal                        (synth)
5554   --    First_Formal_With_Extras            (synth)
5555   --    Is_Ghost_Entity                     (synth)    (non-generic case only)
5556   --    Is_Ghost_Subprogram                 (synth)    (non-generic case only)
5557   --    Last_Formal                         (synth)
5558   --    Number_Formals                      (synth)
5559   --    Scope_Depth                         (synth)
5560
5561   --  E_General_Access_Type
5562   --    Storage_Size_Variable               (Node15)   (base type only)
5563   --    Master_Id                           (Node17)
5564   --    Directly_Designated_Type            (Node20)
5565   --    Associated_Storage_Pool             (Node22)   (root type only)
5566   --    Finalization_Master                 (Node23)   (root type only)
5567   --    (plus type attributes)
5568
5569   --  E_Generic_In_Parameter
5570   --  E_Generic_In_Out_Parameter
5571   --    Current_Value                       (Node9)    (always Empty)
5572   --    Entry_Component                     (Node11)
5573   --    Actual_Subtype                      (Node17)
5574   --    Renamed_Object                      (Node18)   (always Empty)
5575   --    Default_Value                       (Node20)
5576   --    Protected_Formal                    (Node22)
5577   --    Is_Controlling_Formal               (Flag97)
5578   --    Is_Return_Object                    (Flag209)
5579   --    Parameter_Mode                      (synth)
5580
5581   --  E_Incomplete_Type
5582   --  E_Incomplete_Subtype
5583   --    Direct_Primitive_Operations         (Elist10)
5584   --    Non_Limited_View                    (Node17)
5585   --    Private_Dependents                  (Elist18)
5586   --    Discriminant_Constraint             (Elist21)
5587   --    Stored_Constraint                   (Elist23)
5588   --    (plus type attributes)
5589
5590   --  E_In_Parameter
5591   --  E_In_Out_Parameter
5592   --  E_Out_Parameter
5593   --    Mechanism                           (Uint8)    (Mechanism_Type)
5594   --    Current_Value                       (Node9)
5595   --    Discriminal_Link                    (Node10)   (discriminals only)
5596   --    Entry_Component                     (Node11)
5597   --    Esize                               (Uint12)
5598   --    Extra_Accessibility                 (Node13)
5599   --    Alignment                           (Uint14)
5600   --    Extra_Formal                        (Node15)
5601   --    Unset_Reference                     (Node16)
5602   --    Actual_Subtype                      (Node17)
5603   --    Renamed_Object                      (Node18)
5604   --    Spec_Entity                         (Node19)
5605   --    Default_Value                       (Node20)
5606   --    Default_Expr_Function               (Node21)
5607   --    Protected_Formal                    (Node22)
5608   --    Extra_Constrained                   (Node23)
5609   --    Last_Assignment                     (Node26)   (OUT, IN-OUT only)
5610   --    Has_Initial_Value                   (Flag219)
5611   --    Is_Controlling_Formal               (Flag97)
5612   --    Is_Only_Out_Parameter               (Flag226)
5613   --    Is_Optional_Parameter               (Flag134)
5614   --    Low_Bound_Tested                    (Flag205)
5615   --    Is_Return_Object                    (Flag209)
5616   --    Parameter_Mode                      (synth)
5617
5618   --  E_Label
5619   --    Enclosing_Scope                     (Node18)
5620   --    Reachable                           (Flag49)
5621
5622   --  E_Limited_Private_Type
5623   --  E_Limited_Private_Subtype
5624   --    First_Entity                        (Node17)
5625   --    Private_Dependents                  (Elist18)
5626   --    Underlying_Full_View                (Node19)
5627   --    Last_Entity                         (Node20)
5628   --    Discriminant_Constraint             (Elist21)
5629   --    Private_View                        (Node22)
5630   --    Stored_Constraint                   (Elist23)
5631   --    Has_Completion                      (Flag26)
5632   --    (plus type attributes)
5633
5634   --  E_Loop
5635   --    First_Exit_Statement                (Node8)
5636   --    Has_Exit                            (Flag47)
5637   --    Has_Loop_Entry_Attributes           (Flag260)
5638   --    Has_Master_Entity                   (Flag21)
5639   --    Has_Nested_Block_With_Handler       (Flag101)
5640   --    Uses_Sec_Stack                      (Flag95)
5641
5642   --  E_Modular_Integer_Type
5643   --  E_Modular_Integer_Subtype
5644   --    Modulus                             (Uint17)   (base type only)
5645   --    Default_Aspect_Value                (Node19)   (base type only)
5646   --    Original_Array_Type                 (Node21)
5647   --    Scalar_Range                        (Node20)
5648   --    Static_Predicate                    (List25)
5649   --    Non_Binary_Modulus                  (Flag58)   (base type only)
5650   --    Has_Biased_Representation           (Flag139)
5651   --    Has_Shift_Operator                  (Flag267)  (base type only)
5652   --    Type_Low_Bound                      (synth)
5653   --    Type_High_Bound                     (synth)
5654   --    (plus type attributes)
5655
5656   --  E_Named_Integer
5657
5658   --  E_Named_Real
5659
5660   --  E_Operator
5661   --    First_Entity                        (Node17)
5662   --    Alias                               (Node18)
5663   --    Extra_Accessibility_Of_Result       (Node19)
5664   --    Last_Entity                         (Node20)
5665   --    Overridden_Operation                (Node26)
5666   --    Subprograms_For_Type                (Node29)
5667   --    Linker_Section_Pragma               (Node33)
5668   --    Contract                            (Node34)
5669   --    Has_Invariants                      (Flag232)
5670   --    Has_Postconditions                  (Flag240)
5671   --    Is_Machine_Code_Subprogram          (Flag137)
5672   --    Is_Pure                             (Flag44)
5673   --    Is_Intrinsic_Subprogram             (Flag64)
5674   --    Is_Primitive                        (Flag218)
5675   --    Default_Expressions_Processed       (Flag108)
5676   --    Aren't there more flags and fields? seems like this list should be
5677   --    more similar to the E_Function list, which is much longer ???
5678
5679   --  E_Ordinary_Fixed_Point_Type
5680   --  E_Ordinary_Fixed_Point_Subtype
5681   --    Delta_Value                         (Ureal18)
5682   --    Default_Aspect_Value                (Node19)   (base type only)
5683   --    Scalar_Range                        (Node20)
5684   --    Small_Value                         (Ureal21)
5685   --    Has_Small_Clause                    (Flag67)
5686   --    Aft_Value                           (synth)
5687   --    Type_Low_Bound                      (synth)
5688   --    Type_High_Bound                     (synth)
5689   --    (plus type attributes)
5690
5691   --  E_Package
5692   --  E_Generic_Package
5693   --    Dependent_Instances                 (Elist8)   (for an instance)
5694   --    Renaming_Map                        (Uint9)
5695   --    Handler_Records                     (List10)   (non-generic case only)
5696   --    Generic_Homonym                     (Node11)   (generic case only)
5697   --    Associated_Formal_Package           (Node12)
5698   --    Elaboration_Entity                  (Node13)
5699   --    Shadow_Entities                     (List14)
5700   --    Related_Instance                    (Node15)   (non-generic case only)
5701   --    First_Private_Entity                (Node16)
5702   --    First_Entity                        (Node17)
5703   --    Renamed_Entity                      (Node18)
5704   --    Body_Entity                         (Node19)
5705   --    Last_Entity                         (Node20)
5706   --    Interface_Name                      (Node21)
5707   --    Scope_Depth_Value                   (Uint22)
5708   --    Generic_Renamings                   (Elist23)  (for an instance)
5709   --    Inner_Instances                     (Elist23)  (generic case only)
5710   --    Limited_View                        (Node23)   (non-generic/instance)
5711   --    Abstract_States                     (Elist25)
5712   --    Package_Instantiation               (Node26)
5713   --    Current_Use_Clause                  (Node27)
5714   --    Finalizer                           (Node28)   (non-generic case only)
5715   --    SPARK_Aux_Pragma                    (Node33)
5716   --    SPARK_Pragma                        (Node32)
5717   --    Contract                            (Node34)
5718   --    Delay_Subprogram_Descriptors        (Flag50)
5719   --    Body_Needed_For_SAL                 (Flag40)
5720   --    Discard_Names                       (Flag88)
5721   --    Elaboration_Entity_Required         (Flag174)
5722   --    Elaborate_Body_Desirable            (Flag210)  (non-generic case only)
5723   --    From_Limited_With                   (Flag159)
5724   --    Has_All_Calls_Remote                (Flag79)
5725   --    Has_Anonymous_Master                (Flag253)
5726   --    Has_Completion                      (Flag26)
5727   --    Has_Forward_Instantiation           (Flag175)
5728   --    Has_Master_Entity                   (Flag21)
5729   --    Has_RACW                            (Flag214)  (non-generic case only)
5730   --    In_Package_Body                     (Flag48)
5731   --    In_Use                              (Flag8)
5732   --    Is_Instantiated                     (Flag126)
5733   --    Is_Private_Descendant               (Flag53)
5734   --    Is_Visible_Lib_Unit                 (Flag116)
5735   --    Renamed_In_Spec                     (Flag231)  (non-generic case only)
5736   --    SPARK_Aux_Pragma_Inherited          (Flag266)
5737   --    SPARK_Pragma_Inherited              (Flag265)
5738   --    Static_Elaboration_Desired          (Flag77)   (non-generic case only)
5739   --    Has_Null_Abstract_State             (synth)
5740   --    Is_Wrapper_Package                  (synth)    (non-generic case only)
5741   --    Scope_Depth                         (synth)
5742
5743   --  E_Package_Body
5744   --    Handler_Records                     (List10)   (non-generic case only)
5745   --    Related_Instance                    (Node15)   (non-generic case only)
5746   --    First_Entity                        (Node17)
5747   --    Spec_Entity                         (Node19)
5748   --    Last_Entity                         (Node20)
5749   --    Scope_Depth_Value                   (Uint22)
5750   --    Finalizer                           (Node28)   (non-generic case only)
5751   --    SPARK_Aux_Pragma                    (Node33)
5752   --    SPARK_Pragma                        (Node32)
5753   --    Contract                            (Node34)
5754   --    Delay_Subprogram_Descriptors        (Flag50)
5755   --    Has_Anonymous_Master                (Flag253)
5756   --    SPARK_Aux_Pragma_Inherited          (Flag266)
5757   --    SPARK_Pragma_Inherited              (Flag265)
5758   --    Scope_Depth                         (synth)
5759
5760   --  E_Private_Type
5761   --  E_Private_Subtype
5762   --    Direct_Primitive_Operations         (Elist10)
5763   --    First_Entity                        (Node17)
5764   --    Private_Dependents                  (Elist18)
5765   --    Underlying_Full_View                (Node19)
5766   --    Last_Entity                         (Node20)
5767   --    Discriminant_Constraint             (Elist21)
5768   --    Private_View                        (Node22)
5769   --    Stored_Constraint                   (Elist23)
5770   --    Has_Completion                      (Flag26)
5771   --    Is_Controlled                       (Flag42)   (base type only)
5772   --    Is_For_Access_Subtype               (Flag118)  (subtype only)
5773   --    (plus type attributes)
5774
5775   --  E_Procedure
5776   --  E_Generic_Procedure
5777   --    Postcondition_Proc                  (Node8)    (non-generic case only)
5778   --    Renaming_Map                        (Uint9)
5779   --    Handler_Records                     (List10)   (non-generic case only)
5780   --    Protected_Body_Subprogram           (Node11)
5781   --    Next_Inlined_Subprogram             (Node12)
5782   --    Elaboration_Entity                  (Node13)
5783   --    First_Optional_Parameter            (Node14)   (non-generic case only)
5784   --    DT_Position                         (Uint15)
5785   --    DTC_Entity                          (Node16)
5786   --    First_Entity                        (Node17)
5787   --    Alias                               (Node18)   (non-generic case only)
5788   --    Renamed_Entity                      (Node18)   (generic case only)
5789   --    Last_Entity                         (Node20)
5790   --    Interface_Name                      (Node21)
5791   --    Scope_Depth_Value                   (Uint22)
5792   --    Generic_Renamings                   (Elist23)  (for an instance)
5793   --    Inner_Instances                     (Elist23)  (generic case only)
5794   --    Protection_Object                   (Node23)   (for concurrent kind)
5795   --    Interface_Alias                     (Node25)
5796   --    Overridden_Operation                (Node26)   (never for init proc)
5797   --    Wrapped_Entity                      (Node27)   (non-generic case only)
5798   --    Extra_Formals                       (Node28)
5799   --    Static_Initialization               (Node30)   (init_proc only)
5800   --    Thunk_Entity                        (Node31)   (thunk case only)
5801   --    SPARK_Pragma                        (Node32)
5802   --    Linker_Section_Pragma               (Node33)
5803   --    Contract                            (Node34)
5804   --    Body_Needed_For_SAL                 (Flag40)
5805   --    Delay_Cleanups                      (Flag114)
5806   --    Discard_Names                       (Flag88)
5807   --    Elaboration_Entity_Required         (Flag174)
5808   --    Default_Expressions_Processed       (Flag108)
5809   --    Delay_Cleanups                      (Flag114)
5810   --    Delay_Subprogram_Descriptors        (Flag50)
5811   --    Discard_Names                       (Flag88)
5812   --    Has_Anonymous_Master                (Flag253)
5813   --    Has_Completion                      (Flag26)
5814   --    Has_Invariants                      (Flag232)
5815   --    Has_Master_Entity                   (Flag21)
5816   --    Has_Nested_Block_With_Handler       (Flag101)
5817   --    Has_Postconditions                  (Flag240)
5818   --    Is_Abstract_Subprogram              (Flag19)   (non-generic case only)
5819   --    Is_Asynchronous                     (Flag81)
5820   --    Is_Called                           (Flag102)  (non-generic case only)
5821   --    Is_Constructor                      (Flag76)
5822   --    Is_Eliminated                       (Flag124)
5823   --    Is_Instantiated                     (Flag126)  (generic case only)
5824   --    Is_Interrupt_Handler                (Flag89)
5825   --    Is_Intrinsic_Subprogram             (Flag64)
5826   --    Is_Invariant_Procedure              (Flag257)  (non-generic case only)
5827   --    Is_Machine_Code_Subprogram          (Flag137)  (non-generic case only)
5828   --    Is_Null_Init_Proc                   (Flag178)
5829   --    Is_Predicate_Function               (Flag255)  (non-generic case only)
5830   --    Is_Predicate_Function_M             (Flag256)  (non-generic case only)
5831   --    Is_Primitive                        (Flag218)
5832   --    Is_Primitive_Wrapper                (Flag195)  (non-generic case only)
5833   --    Is_Private_Descendant               (Flag53)
5834   --    Is_Private_Primitive                (Flag245)  (non-generic case only)
5835   --    Is_Pure                             (Flag44)
5836   --    Is_Valued_Procedure                 (Flag127)
5837   --    Is_Visible_Lib_Unit                 (Flag116)
5838   --    Needs_No_Actuals                    (Flag22)
5839   --    No_Return                           (Flag113)
5840   --    Requires_Overriding                 (Flag213)  (non-generic case only)
5841   --    Sec_Stack_Needed_For_Return         (Flag167)
5842   --    SPARK_Pragma_Inherited              (Flag265)
5843   --    Address_Clause                      (synth)
5844   --    First_Formal                        (synth)
5845   --    First_Formal_With_Extras            (synth)
5846   --    Is_Finalizer                        (synth)
5847   --    Is_Ghost_Entity                     (synth)    (non-generic case only)
5848   --    Is_Ghost_Subprogram                 (synth)    (non-generic case only)
5849   --    Last_Formal                         (synth)
5850   --    Number_Formals                      (synth)
5851
5852   --  E_Protected_Body
5853   --    (any others??? First/Last Entity, Scope_Depth???)
5854
5855   --  E_Protected_Object
5856
5857   --  E_Protected_Type
5858   --  E_Protected_Subtype
5859   --    Direct_Primitive_Operations         (Elist10)
5860   --    Entry_Bodies_Array                  (Node15)
5861   --    First_Private_Entity                (Node16)
5862   --    First_Entity                        (Node17)
5863   --    Corresponding_Record_Type           (Node18)
5864   --    Last_Entity                         (Node20)
5865   --    Discriminant_Constraint             (Elist21)
5866   --    Scope_Depth_Value                   (Uint22)
5867   --    Scope_Depth                         (synth)
5868   --    Stored_Constraint                   (Elist23)
5869   --    Has_Interrupt_Handler               (synth)
5870   --    Sec_Stack_Needed_For_Return         (Flag167)  ???
5871   --    Uses_Lock_Free                      (Flag188)
5872   --    Uses_Sec_Stack                      (Flag95)   ???
5873   --    Has_Entries                         (synth)
5874   --    Number_Entries                      (synth)
5875
5876   --  E_Record_Type
5877   --  E_Record_Subtype
5878   --    Direct_Primitive_Operations         (Elist10)
5879   --    Access_Disp_Table                   (Elist16)  (base type only)
5880   --    Cloned_Subtype                      (Node16)   (subtype case only)
5881   --    First_Entity                        (Node17)
5882   --    Corresponding_Concurrent_Type       (Node18)
5883   --    Parent_Subtype                      (Node19)   (base type only)
5884   --    Last_Entity                         (Node20)
5885   --    Discriminant_Constraint             (Elist21)
5886   --    Corresponding_Remote_Type           (Node22)
5887   --    Stored_Constraint                   (Elist23)
5888   --    Interfaces                          (Elist25)
5889   --    Dispatch_Table_Wrappers             (Elist26)  (base type only)
5890   --    Underlying_Record_View              (Node28)   (base type only)
5891   --    Component_Alignment                 (special)  (base type only)
5892   --    C_Pass_By_Copy                      (Flag125)  (base type only)
5893   --    Has_Dispatch_Table                  (Flag220)  (base tagged type only)
5894   --    Has_External_Tag_Rep_Clause         (Flag110)
5895   --    Has_Pragma_Pack                     (Flag121)  (impl base type only)
5896   --    Has_Private_Ancestor                (Flag151)
5897   --    Has_Record_Rep_Clause               (Flag65)   (base type only)
5898   --    Has_Static_Discriminants            (Flag211)  (subtype only)
5899   --    Is_Class_Wide_Equivalent_Type       (Flag35)
5900   --    Is_Concurrent_Record_Type           (Flag20)
5901   --    Is_Constrained                      (Flag12)
5902   --    Is_Controlled                       (Flag42)   (base type only)
5903   --    Is_Interface                        (Flag186)
5904   --    Is_Limited_Interface                (Flag197)
5905   --    OK_To_Reorder_Components            (Flag239)  (base type only)
5906   --    Reverse_Bit_Order                   (Flag164)  (base type only)
5907   --    Reverse_Storage_Order               (Flag93)   (base type only)
5908   --    First_Component                     (synth)
5909   --    First_Component_Or_Discriminant     (synth)
5910   --    (plus type attributes)
5911
5912   --  E_Record_Type_With_Private
5913   --  E_Record_Subtype_With_Private
5914   --    Direct_Primitive_Operations         (Elist10)
5915   --    First_Entity                        (Node17)
5916   --    Private_Dependents                  (Elist18)
5917   --    Underlying_Full_View                (Node19)
5918   --    Last_Entity                         (Node20)
5919   --    Discriminant_Constraint             (Elist21)
5920   --    Private_View                        (Node22)
5921   --    Stored_Constraint                   (Elist23)
5922   --    Interfaces                          (Elist25)
5923   --    Has_Completion                      (Flag26)
5924   --    Has_Private_Ancestor                (Flag151)
5925   --    Has_Record_Rep_Clause               (Flag65)   (base type only)
5926   --    Has_External_Tag_Rep_Clause         (Flag110)
5927   --    Is_Concurrent_Record_Type           (Flag20)
5928   --    Is_Constrained                      (Flag12)
5929   --    Is_Controlled                       (Flag42)   (base type only)
5930   --    Is_Interface                        (Flag186)
5931   --    Is_Limited_Interface                (Flag197)
5932   --    OK_To_Reorder_Components            (Flag239)  (base type only)
5933   --    Reverse_Bit_Order                   (Flag164)  (base type only)
5934   --    Reverse_Storage_Order               (Flag93)   (base type only)
5935   --    First_Component                     (synth)
5936   --    First_Component_Or_Discriminant     (synth)
5937   --    (plus type attributes)
5938
5939   --  E_Return_Statement
5940   --    Return_Applies_To                   (Node8)
5941
5942   --  E_Signed_Integer_Type
5943   --  E_Signed_Integer_Subtype
5944   --    Default_Aspect_Value                (Node19)   (base type only)
5945   --    Scalar_Range                        (Node20)
5946   --    Static_Predicate                    (List25)
5947   --    Has_Biased_Representation           (Flag139)
5948   --    Has_Shift_Operator                  (Flag267)  (base type only)
5949   --    Type_Low_Bound                      (synth)
5950   --    Type_High_Bound                     (synth)
5951   --    (plus type attributes)
5952
5953   --  E_String_Type
5954   --  E_String_Subtype
5955   --    First_Index                         (Node17)
5956   --    Component_Type                      (Node20)   (base type only)
5957   --    Is_Constrained                      (Flag12)
5958   --    Next_Index                          (synth)
5959   --    Number_Dimensions                   (synth)
5960   --    (plus type attributes)
5961
5962   --  E_String_Literal_Subtype
5963   --    String_Literal_Low_Bound            (Node15)
5964   --    String_Literal_Length               (Uint16)
5965   --    First_Index                         (Node17)   (always Empty)
5966   --    Packed_Array_Type                   (Node23)
5967   --    (plus type attributes)
5968
5969   --  E_Subprogram_Body
5970   --    Mechanism                           (Uint8)
5971   --    First_Entity                        (Node17)
5972   --    Corresponding_Protected_Entry       (Node18)
5973   --    Last_Entity                         (Node20)
5974   --    Scope_Depth_Value                   (Uint22)
5975   --    Extra_Formals                       (Node28)
5976   --    SPARK_Pragma                        (Node32)
5977   --    SPARK_Pragma_Inherited              (Flag265)
5978   --    Contract                            (Node34)
5979   --    Scope_Depth                         (synth)
5980
5981   --  E_Subprogram_Type
5982   --    Extra_Accessibility_Of_Result       (Node19)
5983   --    Directly_Designated_Type            (Node20)
5984   --    Extra_Formals                       (Node28)
5985   --    First_Formal                        (synth)
5986   --    First_Formal_With_Extras            (synth)
5987   --    Last_Formal                         (synth)
5988   --    Number_Formals                      (synth)
5989   --    (plus type attributes)
5990
5991   --  E_Task_Body
5992   --    (any others??? First/Last Entity, Scope_Depth???)
5993
5994   --  E_Task_Type
5995   --  E_Task_Subtype
5996   --    Direct_Primitive_Operations         (Elist10)
5997   --    Storage_Size_Variable               (Node15)   (base type only)
5998   --    First_Private_Entity                (Node16)
5999   --    First_Entity                        (Node17)
6000   --    Corresponding_Record_Type           (Node18)
6001   --    Last_Entity                         (Node20)
6002   --    Discriminant_Constraint             (Elist21)
6003   --    Scope_Depth_Value                   (Uint22)
6004   --    Scope_Depth                         (synth)
6005   --    Stored_Constraint                   (Elist23)
6006   --    Task_Body_Procedure                 (Node25)
6007   --    Delay_Cleanups                      (Flag114)
6008   --    Has_Master_Entity                   (Flag21)
6009   --    Has_Storage_Size_Clause             (Flag23)   (base type only)
6010   --    Uses_Sec_Stack                      (Flag95)   ???
6011   --    Sec_Stack_Needed_For_Return         (Flag167)  ???
6012   --    Has_Entries                         (synth)
6013   --    Number_Entries                      (synth)
6014   --    Relative_Deadline_Variable          (Node26)   (base type only)
6015   --    (plus type attributes)
6016
6017   --  E_Variable
6018   --    Hiding_Loop_Variable                (Node8)
6019   --    Current_Value                       (Node9)
6020   --    Encapsulating_State                 (Node10)
6021   --    Last_Aggregate_Assignment           (Node11)
6022   --    Esize                               (Uint12)
6023   --    Extra_Accessibility                 (Node13)
6024   --    Alignment                           (Uint14)
6025   --    Status_Flag_Or_Transient_Decl       (Node15)   (transient object only)
6026   --    Unset_Reference                     (Node16)
6027   --    Actual_Subtype                      (Node17)
6028   --    Renamed_Object                      (Node18)
6029   --    Size_Check_Code                     (Node19)
6030   --    Prival_Link                         (Node20)
6031   --    Interface_Name                      (Node21)
6032   --    Shared_Var_Procs_Instance           (Node22)
6033   --    Extra_Constrained                   (Node23)
6034   --    Related_Expression                  (Node24)
6035   --    Debug_Renaming_Link                 (Node25)
6036   --    Last_Assignment                     (Node26)
6037   --    Related_Type                        (Node27)
6038   --    Initialization_Statements           (Node28)
6039   --    BIP_Initialization_Call             (Node29)
6040   --    Linker_Section_Pragma               (Node33)
6041   --    Contract                            (Node34)
6042   --    Has_Alignment_Clause                (Flag46)
6043   --    Has_Atomic_Components               (Flag86)
6044   --    Has_Biased_Representation           (Flag139)
6045   --    Has_Independent_Components          (Flag34)   (base type only)
6046   --    Has_Initial_Value                   (Flag219)
6047   --    Has_Size_Clause                     (Flag29)
6048   --    Has_Up_Level_Access                 (Flag215)
6049   --    Has_Volatile_Components             (Flag87)
6050   --    Is_Atomic                           (Flag85)
6051   --    Is_Eliminated                       (Flag124)
6052   --    Is_Processed_Transient              (Flag252)
6053   --    Is_Safe_To_Reevaluate               (Flag249)
6054   --    Is_Shared_Passive                   (Flag60)
6055   --    Is_True_Constant                    (Flag163)
6056   --    Is_Volatile                         (Flag16)
6057   --    Is_Return_Object                    (Flag209)
6058   --    OK_To_Rename                        (Flag247)
6059   --    Optimize_Alignment_Space            (Flag241)
6060   --    Optimize_Alignment_Time             (Flag242)
6061   --    Treat_As_Volatile                   (Flag41)
6062   --    Address_Clause                      (synth)
6063   --    Alignment_Clause                    (synth)
6064   --    Is_Ghost_Entity                     (synth)
6065   --    Size_Clause                         (synth)
6066
6067   --  E_Void
6068   --    Since E_Void is the initial Ekind value of an entity when it is first
6069   --    created, one might expect that no attributes would be defined on such
6070   --    an entity until its Ekind field is set. However, in practice, there
6071   --    are many instances in which fields of an E_Void entity are set in the
6072   --    code prior to setting the Ekind field. This is not well documented or
6073   --    well controlled, and needs cleaning up later. Meanwhile, the access
6074   --    procedures in the body of Einfo permit many, but not all, attributes
6075   --    to be applied to an E_Void entity, precisely so that this kind of
6076   --    pre-setting of attributes works. This is really a hole in the dynamic
6077   --    type checking, since there is no assurance that the eventual Ekind
6078   --    value will be appropriate for the attributes set, and the consequence
6079   --    is that the dynamic type checking in the Einfo body is unnecessarily
6080   --    weak. To be looked at systematically some time ???
6081
6082   ---------------------------------
6083   -- Component_Alignment Control --
6084   ---------------------------------
6085
6086   --  There are four types of alignment possible for array and record
6087   --  types, and a field in the type entities contains a value of the
6088   --  following type indicating which alignment choice applies. For full
6089   --  details of the meaning of these alignment types, see description
6090   --  of the Component_Alignment pragma
6091
6092   type Component_Alignment_Kind is (
6093      Calign_Default,          -- default alignment
6094      Calign_Component_Size,   -- natural alignment for component size
6095      Calign_Component_Size_4, -- natural for size <= 4, 4 for size >= 4
6096      Calign_Storage_Unit);    -- all components byte aligned
6097
6098   -----------------------------------
6099   -- Floating Point Representation --
6100   -----------------------------------
6101
6102   type Float_Rep_Kind is (
6103      IEEE_Binary,  -- IEEE 754p conform binary format
6104      VAX_Native,   -- VAX D, F, G or H format
6105      AAMP);        -- AAMP format
6106
6107   ---------------
6108   -- Iterators --
6109   ---------------
6110
6111   --  In addition to attributes that are stored as plain data, other
6112   --  attributes are procedural, and require some small amount of
6113   --  computation. Of course, from the point of view of a user of this
6114   --  package, the distinction is not visible (even the field information
6115   --  provided below should be disregarded, as it is subject to  change
6116   --  without notice). A number of  attributes appear as lists: lists of
6117   --  formals,  lists of actuals, of discriminants, etc. For these, pairs
6118   --  of functions are defined, which take the form:
6119
6120   --      function First_Thing (E : Enclosing_Construct) return Thing;
6121   --      function Next_Thing (T : Thing) return Thing;
6122
6123   --  The end of iteration is always signaled by a value of Empty, so that
6124   --  loops over these chains invariably have the form:
6125
6126   --      This : Thing;
6127   --      ...
6128   --      This := First_Thing (E);
6129
6130   --      while Present (This) loop
6131   --         Do_Something_With (This);
6132   --        ...
6133   --        This := Next_Thing (This);
6134   --      end loop;
6135
6136   -----------------------------------
6137   -- Handling of Check Suppression --
6138   -----------------------------------
6139
6140   --  There are three ways that checks can be suppressed:
6141
6142   --    1.  At the command line level
6143   --    2.  At the scope level.
6144   --    3.  At the entity level.
6145
6146   --  See spec of Sem in sem.ads for details of the data structures used
6147   --  to keep track of these various methods for suppressing checks.
6148
6149   -------------------------------
6150   -- Handling of Discriminants --
6151   -------------------------------
6152
6153   --  During semantic processing, discriminants are separate entities which
6154   --  reflect the semantic properties and allowed usage of discriminants in
6155   --  the language.
6156
6157   --  In the case of discriminants used as bounds, the references are handled
6158   --  directly, since special processing is needed in any case. However, there
6159   --  are two circumstances in which discriminants are referenced in a quite
6160   --  general manner, like any other variables:
6161
6162   --     In initialization expressions for records. Note that the expressions
6163   --     used in Priority, Storage_Size, Task_Info and Relative_Deadline
6164   --     pragmas are effectively in this category, since these pragmas are
6165   --     converted to initialized record fields in the Corresponding_Record_
6166   --     Type.
6167
6168   --     In task and protected bodies, where the discriminant values may be
6169   --     referenced freely within these bodies. Discriminants can also appear
6170   --     in bounds of entry families and in defaults of operations.
6171
6172   --  In both these cases, the discriminants must be treated essentially as
6173   --  objects. The following approach is used to simplify and minimize the
6174   --  special processing that is required.
6175
6176   --  When a record type with discriminants is analyzed, semantic processing
6177   --  creates the entities for the discriminants. It also creates additional
6178   --  sets of entities called discriminals, one for each of the discriminants,
6179   --  and the Discriminal field of the discriminant entity points to this
6180   --  additional entity, which is initially created as an uninitialized
6181   --  (E_Void) entity.
6182
6183   --  During expansion of expressions, any discriminant reference is replaced
6184   --  by a reference to the corresponding discriminal. When the initialization
6185   --  procedure for the record is created (there will always be one, since
6186   --  discriminants are present, see Exp_Ch3 for further details), the
6187   --  discriminals are used as the entities for the formal parameters of
6188   --  this initialization procedure. The references to these discriminants
6189   --  have already been replaced by references to these discriminals, which
6190   --  are now the formal parameters corresponding to the required objects.
6191
6192   --  In the case of a task or protected body, the semantics similarly creates
6193   --  a set of discriminals for the discriminants of the task or protected
6194   --  type. When the procedure is created for the task body, the parameter
6195   --  passed in is a reference to the task value type, which contains the
6196   --  required discriminant values. The expander creates a set of declarations
6197   --  of the form:
6198
6199   --      discr_nameD : constant discr_type renames _task.discr_name;
6200
6201   --  where discr_nameD is the discriminal entity referenced by the task
6202   --  discriminant, and _task is the task value passed in as the parameter.
6203   --  Again, any references to discriminants in the task body have been
6204   --  replaced by the discriminal reference, which is now an object that
6205   --  contains the required value.
6206
6207   --  This approach for tasks means that two sets of discriminals are needed
6208   --  for a task type, one for the initialization procedure, and one for the
6209   --  task body. This works out nicely, since the semantics allocates one set
6210   --  for the task itself, and one set for the corresponding record.
6211
6212   --  The one bit of trickiness arises in making sure that the right set of
6213   --  discriminals is used at the right time. First the task definition is
6214   --  processed. Any references to discriminants here are replaced by the
6215   --  corresponding *task* discriminals (the record type doesn't even exist
6216   --  yet, since it is constructed as part of the expansion of the task
6217   --  declaration, which happens after the semantic processing of the task
6218   --  definition). The discriminants to be used for the corresponding record
6219   --  are created at the same time as the other discriminals, and held in the
6220   --  CR_Discriminant field of the discriminant. A use of the discriminant in
6221   --  a bound for an entry family is replaced with the CR_Discriminant because
6222   --  it controls the bound of the entry queue array which is a component of
6223   --  the corresponding record.
6224
6225   --  Just before the record initialization routine is constructed, the
6226   --  expander exchanges the task and record discriminals. This has two
6227   --  effects. First the generation of the record initialization routine
6228   --  uses the discriminals that are now on the record, which is the set
6229   --  that used to be on the task, which is what we want.
6230
6231   --  Second, a new set of (so far unused) discriminals is now on the task
6232   --  discriminants, and it is this set that will be used for expanding the
6233   --  task body, and also for the discriminal declarations at the start of
6234   --  the task body.
6235
6236   ---------------------------------------------------
6237   -- Handling of private data in protected objects --
6238   ---------------------------------------------------
6239
6240   --  Private components in protected types pose problems similar to those
6241   --  of discriminants. Private data is visible and can be directly referenced
6242   --  from protected bodies. However, when protected entries and subprograms
6243   --  are expanded into corresponding bodies and barrier functions, private
6244   --  components lose their original context and visibility.
6245
6246   --  To remedy this side effect of expansion, private components are expanded
6247   --  into renamings called "privals", by analogy with "discriminals".
6248
6249   --     private_comp : comp_type renames _object.private_comp;
6250
6251   --  Prival declarations are inserted during the analysis of subprogram and
6252   --  entry bodies to ensure proper visibility for any subsequent expansion.
6253   --  _Object is the formal parameter of the generated corresponding body or
6254   --  a local renaming which denotes the protected object obtained from entry
6255   --  parameter _O. Privals receive minimal decoration upon creation and are
6256   --  categorized as either E_Variable for the general case or E_Constant when
6257   --  they appear in functions.
6258
6259   --  Along with the local declarations, each private component carries a
6260   --  placeholder which references the prival entity in the current body. This
6261   --  form of indirection is used to resolve name clashes of privals and other
6262   --  locally visible entities such as parameters, local objects, entry family
6263   --  indexes or identifiers used in the barrier condition.
6264
6265   --  When analyzing the statements of a protected subprogram or entry, any
6266   --  reference to a private component must resolve to the locally declared
6267   --  prival through normal visibility. In case of name conflicts (the cases
6268   --  above), the prival is marked as hidden and acts as a weakly declared
6269   --  entity. As a result, the reference points to the correct entity. When a
6270   --  private component is denoted by an expanded name (prot_type.comp for
6271   --  example), the expansion mechanism uses the placeholder of the component
6272   --  to correct the Entity and Etype of the reference.
6273
6274   -------------------
6275   -- Type Synonyms --
6276   -------------------
6277
6278   --  The following type synonyms are used to tidy up the function and
6279   --  procedure declarations that follow, and also to make it possible to meet
6280   --  the requirement for the XEINFO utility that all function specs must fit
6281   --  on a single source line.
6282
6283   subtype B is Boolean;
6284   subtype C is Component_Alignment_Kind;
6285   subtype E is Entity_Id;
6286   subtype F is Float_Rep_Kind;
6287   subtype M is Mechanism_Type;
6288   subtype N is Node_Id;
6289   subtype U is Uint;
6290   subtype R is Ureal;
6291   subtype L is Elist_Id;
6292   subtype S is List_Id;
6293
6294   --------------------------------
6295   -- Attribute Access Functions --
6296   --------------------------------
6297
6298   --  All attributes are manipulated through a procedural interface. This
6299   --  section contains the functions used to obtain attribute values which
6300   --  correspond to values in fields or flags in the entity itself.
6301
6302   function Abstract_States                     (Id : E) return L;
6303   function Accept_Address                      (Id : E) return L;
6304   function Access_Disp_Table                   (Id : E) return L;
6305   function Actual_Subtype                      (Id : E) return E;
6306   function Address_Taken                       (Id : E) return B;
6307   function Alias                               (Id : E) return E;
6308   function Alignment                           (Id : E) return U;
6309   function Associated_Formal_Package           (Id : E) return E;
6310   function Associated_Node_For_Itype           (Id : E) return N;
6311   function Associated_Storage_Pool             (Id : E) return E;
6312   function Barrier_Function                    (Id : E) return N;
6313   function Block_Node                          (Id : E) return N;
6314   function Body_Entity                         (Id : E) return E;
6315   function Body_Needed_For_SAL                 (Id : E) return B;
6316   function Body_References                     (Id : E) return L;
6317   function BIP_Initialization_Call             (Id : E) return N;
6318   function CR_Discriminant                     (Id : E) return E;
6319   function C_Pass_By_Copy                      (Id : E) return B;
6320   function Can_Never_Be_Null                   (Id : E) return B;
6321   function Can_Use_Internal_Rep                (Id : E) return B;
6322   function Checks_May_Be_Suppressed            (Id : E) return B;
6323   function Class_Wide_Type                     (Id : E) return E;
6324   function Cloned_Subtype                      (Id : E) return E;
6325   function Component_Alignment                 (Id : E) return C;
6326   function Component_Bit_Offset                (Id : E) return U;
6327   function Component_Clause                    (Id : E) return N;
6328   function Component_Size                      (Id : E) return U;
6329   function Component_Type                      (Id : E) return E;
6330   function Contract                            (Id : E) return N;
6331   function Corresponding_Concurrent_Type       (Id : E) return E;
6332   function Corresponding_Discriminant          (Id : E) return E;
6333   function Corresponding_Equality              (Id : E) return E;
6334   function Corresponding_Protected_Entry       (Id : E) return E;
6335   function Corresponding_Record_Type           (Id : E) return E;
6336   function Corresponding_Remote_Type           (Id : E) return E;
6337   function Current_Use_Clause                  (Id : E) return E;
6338   function Current_Value                       (Id : E) return N;
6339   function DTC_Entity                          (Id : E) return E;
6340   function DT_Entry_Count                      (Id : E) return U;
6341   function DT_Offset_To_Top_Func               (Id : E) return E;
6342   function DT_Position                         (Id : E) return U;
6343   function Debug_Info_Off                      (Id : E) return B;
6344   function Debug_Renaming_Link                 (Id : E) return E;
6345   function Default_Aspect_Component_Value      (Id : E) return N;
6346   function Default_Aspect_Value                (Id : E) return N;
6347   function Default_Expr_Function               (Id : E) return E;
6348   function Default_Expressions_Processed       (Id : E) return B;
6349   function Default_Value                       (Id : E) return N;
6350   function Delay_Cleanups                      (Id : E) return B;
6351   function Delay_Subprogram_Descriptors        (Id : E) return B;
6352   function Delta_Value                         (Id : E) return R;
6353   function Dependent_Instances                 (Id : E) return L;
6354   function Depends_On_Private                  (Id : E) return B;
6355   function Digits_Value                        (Id : E) return U;
6356   function Direct_Primitive_Operations         (Id : E) return L;
6357   function Directly_Designated_Type            (Id : E) return E;
6358   function Discard_Names                       (Id : E) return B;
6359   function Discriminal                         (Id : E) return E;
6360   function Discriminal_Link                    (Id : E) return E;
6361   function Discriminant_Checking_Func          (Id : E) return E;
6362   function Discriminant_Constraint             (Id : E) return L;
6363   function Discriminant_Default_Value          (Id : E) return N;
6364   function Discriminant_Number                 (Id : E) return U;
6365   function Dispatch_Table_Wrappers             (Id : E) return L;
6366   function Elaborate_Body_Desirable            (Id : E) return B;
6367   function Elaboration_Entity                  (Id : E) return E;
6368   function Elaboration_Entity_Required         (Id : E) return B;
6369   function Encapsulating_State                 (Id : E) return E;
6370   function Enclosing_Scope                     (Id : E) return E;
6371   function Entry_Accepted                      (Id : E) return B;
6372   function Entry_Bodies_Array                  (Id : E) return E;
6373   function Entry_Cancel_Parameter              (Id : E) return E;
6374   function Entry_Component                     (Id : E) return E;
6375   function Entry_Formal                        (Id : E) return E;
6376   function Entry_Index_Constant                (Id : E) return E;
6377   function Entry_Index_Type                    (Id : E) return E;
6378   function Entry_Parameters_Type               (Id : E) return E;
6379   function Enum_Pos_To_Rep                     (Id : E) return E;
6380   function Enumeration_Pos                     (Id : E) return U;
6381   function Enumeration_Rep                     (Id : E) return U;
6382   function Enumeration_Rep_Expr                (Id : E) return N;
6383   function Equivalent_Type                     (Id : E) return E;
6384   function Esize                               (Id : E) return U;
6385   function Exception_Code                      (Id : E) return U;
6386   function Extra_Accessibility                 (Id : E) return E;
6387   function Extra_Accessibility_Of_Result       (Id : E) return E;
6388   function Extra_Constrained                   (Id : E) return E;
6389   function Extra_Formal                        (Id : E) return E;
6390   function Extra_Formals                       (Id : E) return E;
6391   function Finalization_Master                 (Id : E) return E;
6392   function Finalize_Storage_Only               (Id : E) return B;
6393   function Finalizer                           (Id : E) return E;
6394   function First_Entity                        (Id : E) return E;
6395   function First_Exit_Statement                (Id : E) return N;
6396   function First_Index                         (Id : E) return N;
6397   function First_Literal                       (Id : E) return E;
6398   function First_Optional_Parameter            (Id : E) return E;
6399   function First_Private_Entity                (Id : E) return E;
6400   function First_Rep_Item                      (Id : E) return N;
6401   function Float_Rep                           (Id : E) return F;
6402   function Freeze_Node                         (Id : E) return N;
6403   function From_Limited_With                   (Id : E) return B;
6404   function Full_View                           (Id : E) return E;
6405   function Generic_Homonym                     (Id : E) return E;
6406   function Generic_Renamings                   (Id : E) return L;
6407   function Handler_Records                     (Id : E) return S;
6408   function Has_Aliased_Components              (Id : E) return B;
6409   function Has_Alignment_Clause                (Id : E) return B;
6410   function Has_All_Calls_Remote                (Id : E) return B;
6411   function Has_Anonymous_Master                (Id : E) return B;
6412   function Has_Atomic_Components               (Id : E) return B;
6413   function Has_Biased_Representation           (Id : E) return B;
6414   function Has_Completion                      (Id : E) return B;
6415   function Has_Completion_In_Body              (Id : E) return B;
6416   function Has_Complex_Representation          (Id : E) return B;
6417   function Has_Component_Size_Clause           (Id : E) return B;
6418   function Has_Constrained_Partial_View        (Id : E) return B;
6419   function Has_Contiguous_Rep                  (Id : E) return B;
6420   function Has_Controlled_Component            (Id : E) return B;
6421   function Has_Controlling_Result              (Id : E) return B;
6422   function Has_Convention_Pragma               (Id : E) return B;
6423   function Has_Default_Aspect                  (Id : E) return B;
6424   function Has_Delayed_Aspects                 (Id : E) return B;
6425   function Has_Delayed_Freeze                  (Id : E) return B;
6426   function Has_Delayed_Rep_Aspects             (Id : E) return B;
6427   function Has_Discriminants                   (Id : E) return B;
6428   function Has_Dispatch_Table                  (Id : E) return B;
6429   function Has_Dynamic_Predicate_Aspect        (Id : E) return B;
6430   function Has_Enumeration_Rep_Clause          (Id : E) return B;
6431   function Has_Exit                            (Id : E) return B;
6432   function Has_External_Tag_Rep_Clause         (Id : E) return B;
6433   function Has_Forward_Instantiation           (Id : E) return B;
6434   function Has_Fully_Qualified_Name            (Id : E) return B;
6435   function Has_Gigi_Rep_Item                   (Id : E) return B;
6436   function Has_Homonym                         (Id : E) return B;
6437   function Has_Implicit_Dereference            (Id : E) return B;
6438   function Has_Independent_Components          (Id : E) return B;
6439   function Has_Inheritable_Invariants          (Id : E) return B;
6440   function Has_Initial_Value                   (Id : E) return B;
6441   function Has_Interrupt_Handler               (Id : E) return B;
6442   function Has_Invariants                      (Id : E) return B;
6443   function Has_Loop_Entry_Attributes           (Id : E) return B;
6444   function Has_Machine_Radix_Clause            (Id : E) return B;
6445   function Has_Master_Entity                   (Id : E) return B;
6446   function Has_Missing_Return                  (Id : E) return B;
6447   function Has_Nested_Block_With_Handler       (Id : E) return B;
6448   function Has_Non_Standard_Rep                (Id : E) return B;
6449   function Has_Object_Size_Clause              (Id : E) return B;
6450   function Has_Per_Object_Constraint           (Id : E) return B;
6451   function Has_Postconditions                  (Id : E) return B;
6452   function Has_Pragma_Controlled               (Id : E) return B;
6453   function Has_Pragma_Elaborate_Body           (Id : E) return B;
6454   function Has_Pragma_Inline                   (Id : E) return B;
6455   function Has_Pragma_Inline_Always            (Id : E) return B;
6456   function Has_Pragma_No_Inline                (Id : E) return B;
6457   function Has_Pragma_Ordered                  (Id : E) return B;
6458   function Has_Pragma_Pack                     (Id : E) return B;
6459   function Has_Pragma_Preelab_Init             (Id : E) return B;
6460   function Has_Pragma_Pure                     (Id : E) return B;
6461   function Has_Pragma_Pure_Function            (Id : E) return B;
6462   function Has_Pragma_Thread_Local_Storage     (Id : E) return B;
6463   function Has_Pragma_Unmodified               (Id : E) return B;
6464   function Has_Pragma_Unreferenced             (Id : E) return B;
6465   function Has_Pragma_Unreferenced_Objects     (Id : E) return B;
6466   function Has_Predicates                      (Id : E) return B;
6467   function Has_Primitive_Operations            (Id : E) return B;
6468   function Has_Private_Ancestor                (Id : E) return B;
6469   function Has_Private_Declaration             (Id : E) return B;
6470   function Has_Qualified_Name                  (Id : E) return B;
6471   function Has_RACW                            (Id : E) return B;
6472   function Has_Record_Rep_Clause               (Id : E) return B;
6473   function Has_Recursive_Call                  (Id : E) return B;
6474   function Has_Shift_Operator                  (Id : E) return B;
6475   function Has_Size_Clause                     (Id : E) return B;
6476   function Has_Small_Clause                    (Id : E) return B;
6477   function Has_Specified_Layout                (Id : E) return B;
6478   function Has_Specified_Stream_Input          (Id : E) return B;
6479   function Has_Specified_Stream_Output         (Id : E) return B;
6480   function Has_Specified_Stream_Read           (Id : E) return B;
6481   function Has_Specified_Stream_Write          (Id : E) return B;
6482   function Has_Static_Discriminants            (Id : E) return B;
6483   function Has_Static_Predicate_Aspect         (Id : E) return B;
6484   function Has_Storage_Size_Clause             (Id : E) return B;
6485   function Has_Stream_Size_Clause              (Id : E) return B;
6486   function Has_Task                            (Id : E) return B;
6487   function Has_Thunks                          (Id : E) return B;
6488   function Has_Unchecked_Union                 (Id : E) return B;
6489   function Has_Unknown_Discriminants           (Id : E) return B;
6490   function Has_Up_Level_Access                 (Id : E) return B;
6491   function Has_Visible_Refinement              (Id : E) return B;
6492   function Has_Volatile_Components             (Id : E) return B;
6493   function Has_Xref_Entry                      (Id : E) return B;
6494   function Hiding_Loop_Variable                (Id : E) return E;
6495   function Homonym                             (Id : E) return E;
6496   function Import_Pragma                       (Id : E) return E;
6497   function In_Package_Body                     (Id : E) return B;
6498   function In_Private_Part                     (Id : E) return B;
6499   function In_Use                              (Id : E) return B;
6500   function Initialization_Statements           (Id : E) return N;
6501   function Inner_Instances                     (Id : E) return L;
6502   function Interface_Alias                     (Id : E) return E;
6503   function Interface_Name                      (Id : E) return N;
6504   function Interfaces                          (Id : E) return L;
6505   function Is_AST_Entry                        (Id : E) return B;
6506   function Is_Abstract_Subprogram              (Id : E) return B;
6507   function Is_Abstract_Type                    (Id : E) return B;
6508   function Is_Access_Constant                  (Id : E) return B;
6509   function Is_Ada_2005_Only                    (Id : E) return B;
6510   function Is_Ada_2012_Only                    (Id : E) return B;
6511   function Is_Aliased                          (Id : E) return B;
6512   function Is_Asynchronous                     (Id : E) return B;
6513   function Is_Atomic                           (Id : E) return B;
6514   function Is_Bit_Packed_Array                 (Id : E) return B;
6515   function Is_CPP_Class                        (Id : E) return B;
6516   function Is_Called                           (Id : E) return B;
6517   function Is_Character_Type                   (Id : E) return B;
6518   function Is_Child_Unit                       (Id : E) return B;
6519   function Is_Class_Wide_Equivalent_Type       (Id : E) return B;
6520   function Is_Compilation_Unit                 (Id : E) return B;
6521   function Is_Completely_Hidden                (Id : E) return B;
6522   function Is_Constr_Subt_For_UN_Aliased       (Id : E) return B;
6523   function Is_Constr_Subt_For_U_Nominal        (Id : E) return B;
6524   function Is_Constrained                      (Id : E) return B;
6525   function Is_Constructor                      (Id : E) return B;
6526   function Is_Controlled                       (Id : E) return B;
6527   function Is_Controlling_Formal               (Id : E) return B;
6528   function Is_Descendent_Of_Address            (Id : E) return B;
6529   function Is_Discrim_SO_Function              (Id : E) return B;
6530   function Is_Discriminant_Check_Function      (Id : E) return B;
6531   function Is_Dispatch_Table_Entity            (Id : E) return B;
6532   function Is_Dispatching_Operation            (Id : E) return B;
6533   function Is_Eliminated                       (Id : E) return B;
6534   function Is_Entry_Formal                     (Id : E) return B;
6535   function Is_Exported                         (Id : E) return B;
6536   function Is_First_Subtype                    (Id : E) return B;
6537   function Is_For_Access_Subtype               (Id : E) return B;
6538   function Is_Frozen                           (Id : E) return B;
6539   function Is_Generic_Instance                 (Id : E) return B;
6540   function Is_Hidden                           (Id : E) return B;
6541   function Is_Hidden_Open_Scope                (Id : E) return B;
6542   function Is_Immediately_Visible              (Id : E) return B;
6543   function Is_Implementation_Defined           (Id : E) return B;
6544   function Is_Imported                         (Id : E) return B;
6545   function Is_Inlined                          (Id : E) return B;
6546   function Is_Instantiated                     (Id : E) return B;
6547   function Is_Interface                        (Id : E) return B;
6548   function Is_Internal                         (Id : E) return B;
6549   function Is_Interrupt_Handler                (Id : E) return B;
6550   function Is_Intrinsic_Subprogram             (Id : E) return B;
6551   function Is_Invariant_Procedure              (Id : E) return B;
6552   function Is_Itype                            (Id : E) return B;
6553   function Is_Known_Non_Null                   (Id : E) return B;
6554   function Is_Known_Null                       (Id : E) return B;
6555   function Is_Known_Valid                      (Id : E) return B;
6556   function Is_Limited_Composite                (Id : E) return B;
6557   function Is_Limited_Interface                (Id : E) return B;
6558   function Is_Local_Anonymous_Access           (Id : E) return B;
6559   function Is_Machine_Code_Subprogram          (Id : E) return B;
6560   function Is_Non_Static_Subtype               (Id : E) return B;
6561   function Is_Null_Init_Proc                   (Id : E) return B;
6562   function Is_Obsolescent                      (Id : E) return B;
6563   function Is_Only_Out_Parameter               (Id : E) return B;
6564   function Is_Optional_Parameter               (Id : E) return B;
6565   function Is_Package_Body_Entity              (Id : E) return B;
6566   function Is_Packed                           (Id : E) return B;
6567   function Is_Packed_Array_Type                (Id : E) return B;
6568   function Is_Potentially_Use_Visible          (Id : E) return B;
6569   function Is_Predicate_Function               (Id : E) return B;
6570   function Is_Predicate_Function_M             (Id : E) return B;
6571   function Is_Preelaborated                    (Id : E) return B;
6572   function Is_Primitive                        (Id : E) return B;
6573   function Is_Primitive_Wrapper                (Id : E) return B;
6574   function Is_Private_Composite                (Id : E) return B;
6575   function Is_Private_Descendant               (Id : E) return B;
6576   function Is_Private_Primitive                (Id : E) return B;
6577   function Is_Processed_Transient              (Id : E) return B;
6578   function Is_Public                           (Id : E) return B;
6579   function Is_Pure                             (Id : E) return B;
6580   function Is_Pure_Unit_Access_Type            (Id : E) return B;
6581   function Is_RACW_Stub_Type                   (Id : E) return B;
6582   function Is_Raised                           (Id : E) return B;
6583   function Is_Remote_Call_Interface            (Id : E) return B;
6584   function Is_Remote_Types                     (Id : E) return B;
6585   function Is_Renaming_Of_Object               (Id : E) return B;
6586   function Is_Return_Object                    (Id : E) return B;
6587   function Is_Safe_To_Reevaluate               (Id : E) return B;
6588   function Is_Shared_Passive                   (Id : E) return B;
6589   function Is_Statically_Allocated             (Id : E) return B;
6590   function Is_Tag                              (Id : E) return B;
6591   function Is_Tagged_Type                      (Id : E) return B;
6592   function Is_Thunk                            (Id : E) return B;
6593   function Is_Trivial_Subprogram               (Id : E) return B;
6594   function Is_True_Constant                    (Id : E) return B;
6595   function Is_Unchecked_Union                  (Id : E) return B;
6596   function Is_Underlying_Record_View           (Id : E) return B;
6597   function Is_Unsigned_Type                    (Id : E) return B;
6598   function Is_VMS_Exception                    (Id : E) return B;
6599   function Is_Valued_Procedure                 (Id : E) return B;
6600   function Is_Visible_Formal                   (Id : E) return B;
6601   function Is_Visible_Lib_Unit                 (Id : E) return B;
6602   function Is_Volatile                         (Id : E) return B;
6603   function Itype_Printed                       (Id : E) return B;
6604   function Kill_Elaboration_Checks             (Id : E) return B;
6605   function Kill_Range_Checks                   (Id : E) return B;
6606   function Known_To_Have_Preelab_Init          (Id : E) return B;
6607   function Last_Aggregate_Assignment           (Id : E) return N;
6608   function Last_Assignment                     (Id : E) return N;
6609   function Last_Entity                         (Id : E) return E;
6610   function Limited_View                        (Id : E) return E;
6611   function Linker_Section_Pragma               (Id : E) return N;
6612   function Lit_Indexes                         (Id : E) return E;
6613   function Lit_Strings                         (Id : E) return E;
6614   function Low_Bound_Tested                    (Id : E) return B;
6615   function Machine_Radix_10                    (Id : E) return B;
6616   function Master_Id                           (Id : E) return E;
6617   function Materialize_Entity                  (Id : E) return B;
6618   function May_Inherit_Delayed_Rep_Aspects     (Id : E) return B;
6619   function Mechanism                           (Id : E) return M;
6620   function Modulus                             (Id : E) return U;
6621   function Must_Be_On_Byte_Boundary            (Id : E) return B;
6622   function Must_Have_Preelab_Init              (Id : E) return B;
6623   function Needs_Debug_Info                    (Id : E) return B;
6624   function Needs_No_Actuals                    (Id : E) return B;
6625   function Never_Set_In_Source                 (Id : E) return B;
6626   function Next_Inlined_Subprogram             (Id : E) return E;
6627   function No_Pool_Assigned                    (Id : E) return B;
6628   function No_Return                           (Id : E) return B;
6629   function No_Strict_Aliasing                  (Id : E) return B;
6630   function Non_Binary_Modulus                  (Id : E) return B;
6631   function Non_Limited_View                    (Id : E) return E;
6632   function Nonzero_Is_True                     (Id : E) return B;
6633   function Normalized_First_Bit                (Id : E) return U;
6634   function Normalized_Position                 (Id : E) return U;
6635   function Normalized_Position_Max             (Id : E) return U;
6636   function OK_To_Rename                        (Id : E) return B;
6637   function OK_To_Reorder_Components            (Id : E) return B;
6638   function Optimize_Alignment_Space            (Id : E) return B;
6639   function Optimize_Alignment_Time             (Id : E) return B;
6640   function Original_Access_Type                (Id : E) return E;
6641   function Original_Array_Type                 (Id : E) return E;
6642   function Original_Record_Component           (Id : E) return E;
6643   function Overlays_Constant                   (Id : E) return B;
6644   function Overridden_Operation                (Id : E) return E;
6645   function PPC_Wrapper                         (Id : E) return E;
6646   function Package_Instantiation               (Id : E) return N;
6647   function Packed_Array_Type                   (Id : E) return E;
6648   function Parent_Subtype                      (Id : E) return E;
6649   function Part_Of_Constituents                (Id : E) return L;
6650   function Postcondition_Proc                  (Id : E) return E;
6651   function Prival                              (Id : E) return E;
6652   function Prival_Link                         (Id : E) return E;
6653   function Private_Dependents                  (Id : E) return L;
6654   function Private_View                        (Id : E) return N;
6655   function Protected_Body_Subprogram           (Id : E) return E;
6656   function Protected_Formal                    (Id : E) return E;
6657   function Protection_Object                   (Id : E) return E;
6658   function RM_Size                             (Id : E) return U;
6659   function Reachable                           (Id : E) return B;
6660   function Referenced                          (Id : E) return B;
6661   function Referenced_As_LHS                   (Id : E) return B;
6662   function Referenced_As_Out_Parameter         (Id : E) return B;
6663   function Refinement_Constituents             (Id : E) return L;
6664   function Register_Exception_Call             (Id : E) return N;
6665   function Related_Array_Object                (Id : E) return E;
6666   function Related_Expression                  (Id : E) return N;
6667   function Related_Instance                    (Id : E) return E;
6668   function Related_Type                        (Id : E) return E;
6669   function Relative_Deadline_Variable          (Id : E) return E;
6670   function Renamed_Entity                      (Id : E) return N;
6671   function Renamed_In_Spec                     (Id : E) return B;
6672   function Renamed_Object                      (Id : E) return N;
6673   function Renaming_Map                        (Id : E) return U;
6674   function Requires_Overriding                 (Id : E) return B;
6675   function Return_Applies_To                   (Id : E) return N;
6676   function Return_Present                      (Id : E) return B;
6677   function Returns_By_Ref                      (Id : E) return B;
6678   function Reverse_Bit_Order                   (Id : E) return B;
6679   function Reverse_Storage_Order               (Id : E) return B;
6680   function Scalar_Range                        (Id : E) return N;
6681   function Scale_Value                         (Id : E) return U;
6682   function Scope_Depth_Value                   (Id : E) return U;
6683   function Sec_Stack_Needed_For_Return         (Id : E) return B;
6684   function Shadow_Entities                     (Id : E) return S;
6685   function Shared_Var_Procs_Instance           (Id : E) return E;
6686   function Size_Check_Code                     (Id : E) return N;
6687   function Size_Depends_On_Discriminant        (Id : E) return B;
6688   function Size_Known_At_Compile_Time          (Id : E) return B;
6689   function Small_Value                         (Id : E) return R;
6690   function SPARK_Aux_Pragma                    (Id : E) return N;
6691   function SPARK_Aux_Pragma_Inherited          (Id : E) return B;
6692   function SPARK_Pragma                        (Id : E) return N;
6693   function SPARK_Pragma_Inherited              (Id : E) return B;
6694   function Spec_Entity                         (Id : E) return E;
6695   function Static_Elaboration_Desired          (Id : E) return B;
6696   function Static_Initialization               (Id : E) return N;
6697   function Static_Predicate                    (Id : E) return S;
6698   function Status_Flag_Or_Transient_Decl       (Id : E) return E;
6699   function Storage_Size_Variable               (Id : E) return E;
6700   function Stored_Constraint                   (Id : E) return L;
6701   function Strict_Alignment                    (Id : E) return B;
6702   function String_Literal_Length               (Id : E) return U;
6703   function String_Literal_Low_Bound            (Id : E) return N;
6704   function Subprograms_For_Type                (Id : E) return E;
6705   function Suppress_Elaboration_Warnings       (Id : E) return B;
6706   function Suppress_Initialization             (Id : E) return B;
6707   function Suppress_Style_Checks               (Id : E) return B;
6708   function Suppress_Value_Tracking_On_Call     (Id : E) return B;
6709   function Task_Body_Procedure                 (Id : E) return N;
6710   function Thunk_Entity                        (Id : E) return E;
6711   function Treat_As_Volatile                   (Id : E) return B;
6712   function Underlying_Full_View                (Id : E) return E;
6713   function Underlying_Record_View              (Id : E) return E;
6714   function Universal_Aliasing                  (Id : E) return B;
6715   function Unset_Reference                     (Id : E) return N;
6716   function Used_As_Generic_Actual              (Id : E) return B;
6717   function Uses_Lock_Free                      (Id : E) return B;
6718   function Uses_Sec_Stack                      (Id : E) return B;
6719   function Vax_Float                           (Id : E) return B;
6720   function Warnings_Off                        (Id : E) return B;
6721   function Warnings_Off_Used                   (Id : E) return B;
6722   function Warnings_Off_Used_Unmodified        (Id : E) return B;
6723   function Warnings_Off_Used_Unreferenced      (Id : E) return B;
6724   function Was_Hidden                          (Id : E) return B;
6725   function Wrapped_Entity                      (Id : E) return E;
6726
6727   -------------------------------
6728   -- Classification Attributes --
6729   -------------------------------
6730
6731   --  These functions provide a convenient functional notation for testing
6732   --  whether an Ekind value belongs to a specified kind, for example the
6733   --  function Is_Elementary_Type tests if its argument is in Elementary_Kind.
6734   --  In some cases, the test is of an entity attribute (e.g. in the case of
6735   --  Is_Generic_Type where the Ekind does not provide the needed information)
6736
6737   function Is_Access_Type                      (Id : E) return B;
6738   function Is_Access_Protected_Subprogram_Type (Id : E) return B;
6739   function Is_Access_Subprogram_Type           (Id : E) return B;
6740   function Is_Aggregate_Type                   (Id : E) return B;
6741   function Is_Array_Type                       (Id : E) return B;
6742   function Is_Assignable                       (Id : E) return B;
6743   function Is_Class_Wide_Type                  (Id : E) return B;
6744   function Is_Composite_Type                   (Id : E) return B;
6745   function Is_Concurrent_Body                  (Id : E) return B;
6746   function Is_Concurrent_Record_Type           (Id : E) return B;
6747   function Is_Concurrent_Type                  (Id : E) return B;
6748   function Is_Decimal_Fixed_Point_Type         (Id : E) return B;
6749   function Is_Digits_Type                      (Id : E) return B;
6750   function Is_Discrete_Or_Fixed_Point_Type     (Id : E) return B;
6751   function Is_Discrete_Type                    (Id : E) return B;
6752   function Is_Elementary_Type                  (Id : E) return B;
6753   function Is_Entry                            (Id : E) return B;
6754   function Is_Enumeration_Type                 (Id : E) return B;
6755   function Is_Fixed_Point_Type                 (Id : E) return B;
6756   function Is_Floating_Point_Type              (Id : E) return B;
6757   function Is_Formal                           (Id : E) return B;
6758   function Is_Formal_Object                    (Id : E) return B;
6759   function Is_Formal_Subprogram                (Id : E) return B;
6760   function Is_Generic_Actual_Type              (Id : E) return B;
6761   function Is_Generic_Unit                     (Id : E) return B;
6762   function Is_Generic_Type                     (Id : E) return B;
6763   function Is_Generic_Subprogram               (Id : E) return B;
6764   function Is_Incomplete_Or_Private_Type       (Id : E) return B;
6765   function Is_Incomplete_Type                  (Id : E) return B;
6766   function Is_Integer_Type                     (Id : E) return B;
6767   function Is_Limited_Record                   (Id : E) return B;
6768   function Is_Modular_Integer_Type             (Id : E) return B;
6769   function Is_Named_Number                     (Id : E) return B;
6770   function Is_Numeric_Type                     (Id : E) return B;
6771   function Is_Object                           (Id : E) return B;
6772   function Is_Ordinary_Fixed_Point_Type        (Id : E) return B;
6773   function Is_Overloadable                     (Id : E) return B;
6774   function Is_Private_Type                     (Id : E) return B;
6775   function Is_Protected_Type                   (Id : E) return B;
6776   function Is_Real_Type                        (Id : E) return B;
6777   function Is_Record_Type                      (Id : E) return B;
6778   function Is_Scalar_Type                      (Id : E) return B;
6779   function Is_Signed_Integer_Type              (Id : E) return B;
6780   function Is_Subprogram                       (Id : E) return B;
6781   function Is_Task_Type                        (Id : E) return B;
6782   function Is_Type                             (Id : E) return B;
6783
6784   -------------------------------------
6785   -- Synthesized Attribute Functions --
6786   -------------------------------------
6787
6788   --  The functions in this section synthesize attributes from the tree,
6789   --  so they do not correspond to defined fields in the entity itself.
6790
6791   function Address_Clause                      (Id : E) return N;
6792   function Aft_Value                           (Id : E) return U;
6793   function Alignment_Clause                    (Id : E) return N;
6794   function Base_Type                           (Id : E) return E;
6795   function Declaration_Node                    (Id : E) return N;
6796   function Designated_Type                     (Id : E) return E;
6797   function First_Component                     (Id : E) return E;
6798   function First_Component_Or_Discriminant     (Id : E) return E;
6799   function First_Formal                        (Id : E) return E;
6800   function First_Formal_With_Extras            (Id : E) return E;
6801   function Has_Attach_Handler                  (Id : E) return B;
6802   function Has_Entries                         (Id : E) return B;
6803   function Has_Foreign_Convention              (Id : E) return B;
6804   function Has_Non_Null_Refinement             (Id : E) return B;
6805   function Has_Null_Abstract_State             (Id : E) return B;
6806   function Has_Null_Refinement                 (Id : E) return B;
6807   function Implementation_Base_Type            (Id : E) return E;
6808   function Is_Base_Type                        (Id : E) return B;
6809   function Is_Boolean_Type                     (Id : E) return B;
6810   function Is_Constant_Object                  (Id : E) return B;
6811   function Is_Discriminal                      (Id : E) return B;
6812   function Is_Dynamic_Scope                    (Id : E) return B;
6813   function Is_External_State                   (Id : E) return B;
6814   function Is_Finalizer                        (Id : E) return B;
6815   function Is_Ghost_Entity                     (Id : E) return B;
6816   function Is_Ghost_Subprogram                 (Id : E) return B;
6817   function Is_Null_State                       (Id : E) return B;
6818   function Is_Package_Or_Generic_Package       (Id : E) return B;
6819   function Is_Prival                           (Id : E) return B;
6820   function Is_Protected_Component              (Id : E) return B;
6821   function Is_Protected_Interface              (Id : E) return B;
6822   function Is_Protected_Record_Type            (Id : E) return B;
6823   function Is_Standard_Character_Type          (Id : E) return B;
6824   function Is_String_Type                      (Id : E) return B;
6825   function Is_Synchronized_Interface           (Id : E) return B;
6826   function Is_Task_Interface                   (Id : E) return B;
6827   function Is_Task_Record_Type                 (Id : E) return B;
6828   function Is_Wrapper_Package                  (Id : E) return B;
6829   function Last_Formal                         (Id : E) return E;
6830   function Machine_Emax_Value                  (Id : E) return U;
6831   function Machine_Emin_Value                  (Id : E) return U;
6832   function Machine_Mantissa_Value              (Id : E) return U;
6833   function Machine_Radix_Value                 (Id : E) return U;
6834   function Model_Emin_Value                    (Id : E) return U;
6835   function Model_Epsilon_Value                 (Id : E) return R;
6836   function Model_Mantissa_Value                (Id : E) return U;
6837   function Model_Small_Value                   (Id : E) return R;
6838   function Next_Component                      (Id : E) return E;
6839   function Next_Component_Or_Discriminant      (Id : E) return E;
6840   function Next_Discriminant                   (Id : E) return E;
6841   function Next_Formal                         (Id : E) return E;
6842   function Next_Formal_With_Extras             (Id : E) return E;
6843   function Next_Literal                        (Id : E) return E;
6844   function Next_Stored_Discriminant            (Id : E) return E;
6845   function Number_Dimensions                   (Id : E) return Pos;
6846   function Number_Entries                      (Id : E) return Nat;
6847   function Number_Formals                      (Id : E) return Pos;
6848   function Parameter_Mode                      (Id : E) return Formal_Kind;
6849   function Primitive_Operations                (Id : E) return L;
6850   function Root_Type                           (Id : E) return E;
6851   function Safe_Emax_Value                     (Id : E) return U;
6852   function Safe_First_Value                    (Id : E) return R;
6853   function Safe_Last_Value                     (Id : E) return R;
6854   function Scope_Depth_Set                     (Id : E) return B;
6855   function Size_Clause                         (Id : E) return N;
6856   function Stream_Size_Clause                  (Id : E) return N;
6857   function Type_High_Bound                     (Id : E) return N;
6858   function Type_Low_Bound                      (Id : E) return N;
6859   function Underlying_Type                     (Id : E) return E;
6860
6861   ----------------------------------------------
6862   -- Type Representation Attribute Predicates --
6863   ----------------------------------------------
6864
6865   --  These predicates test the setting of the indicated attribute. If the
6866   --  value has been set, then Known is True, and Unknown is False. If no
6867   --  value is set, then Known is False and Unknown is True. The Known_Static
6868   --  predicate is true only if the value is set (Known) and is set to a
6869   --  compile time known value. Note that in the case of Alignment and
6870   --  Normalized_First_Bit, dynamic values are not possible, so we do not
6871   --  need a separate Known_Static calls in these cases. The not set (unknown)
6872   --  values are as follows:
6873
6874   --    Alignment               Uint_0 or No_Uint
6875   --    Component_Size          Uint_0 or No_Uint
6876   --    Component_Bit_Offset    No_Uint
6877   --    Digits_Value            Uint_0 or No_Uint
6878   --    Esize                   Uint_0 or No_Uint
6879   --    Normalized_First_Bit    No_Uint
6880   --    Normalized_Position     No_Uint
6881   --    Normalized_Position_Max No_Uint
6882   --    RM_Size                 Uint_0 or No_Uint
6883
6884   --  It would be cleaner to use No_Uint in all these cases, but historically
6885   --  we chose to use Uint_0 at first, and the change over will take time ???
6886   --  This is particularly true for the RM_Size field, where a value of zero
6887   --  is legitimate. We deal with this by a nasty kludge that knows that the
6888   --  value is always known static for discrete types (and no other types can
6889   --  have an RM_Size value of zero).
6890
6891   --  In two cases, Known_Static_Esize and Known_Static_RM_Size, there is one
6892   --  more consideration, which is that we always return False for generic
6893   --  types. Within a template, the size can look known, because of the fake
6894   --  size values we put in template types, but they are not really known and
6895   --  anyone testing if they are known within the template should get False as
6896   --  a result to prevent incorrect assumptions.
6897
6898   function Known_Alignment                       (E : Entity_Id) return B;
6899   function Known_Component_Bit_Offset            (E : Entity_Id) return B;
6900   function Known_Component_Size                  (E : Entity_Id) return B;
6901   function Known_Esize                           (E : Entity_Id) return B;
6902   function Known_Normalized_First_Bit            (E : Entity_Id) return B;
6903   function Known_Normalized_Position             (E : Entity_Id) return B;
6904   function Known_Normalized_Position_Max         (E : Entity_Id) return B;
6905   function Known_RM_Size                         (E : Entity_Id) return B;
6906
6907   function Known_Static_Component_Bit_Offset     (E : Entity_Id) return B;
6908   function Known_Static_Component_Size           (E : Entity_Id) return B;
6909   function Known_Static_Esize                    (E : Entity_Id) return B;
6910   function Known_Static_Normalized_First_Bit     (E : Entity_Id) return B;
6911   function Known_Static_Normalized_Position      (E : Entity_Id) return B;
6912   function Known_Static_Normalized_Position_Max  (E : Entity_Id) return B;
6913   function Known_Static_RM_Size                  (E : Entity_Id) return B;
6914
6915   function Unknown_Alignment                     (E : Entity_Id) return B;
6916   function Unknown_Component_Bit_Offset          (E : Entity_Id) return B;
6917   function Unknown_Component_Size                (E : Entity_Id) return B;
6918   function Unknown_Esize                         (E : Entity_Id) return B;
6919   function Unknown_Normalized_First_Bit          (E : Entity_Id) return B;
6920   function Unknown_Normalized_Position           (E : Entity_Id) return B;
6921   function Unknown_Normalized_Position_Max       (E : Entity_Id) return B;
6922   function Unknown_RM_Size                       (E : Entity_Id) return B;
6923
6924   ------------------------------
6925   -- Attribute Set Procedures --
6926   ------------------------------
6927
6928   procedure Set_Abstract_States                 (Id : E; V : L);
6929   procedure Set_Accept_Address                  (Id : E; V : L);
6930   procedure Set_Access_Disp_Table               (Id : E; V : L);
6931   procedure Set_Actual_Subtype                  (Id : E; V : E);
6932   procedure Set_Address_Taken                   (Id : E; V : B := True);
6933   procedure Set_Alias                           (Id : E; V : E);
6934   procedure Set_Alignment                       (Id : E; V : U);
6935   procedure Set_Associated_Formal_Package       (Id : E; V : E);
6936   procedure Set_Associated_Node_For_Itype       (Id : E; V : N);
6937   procedure Set_Associated_Storage_Pool         (Id : E; V : E);
6938   procedure Set_Barrier_Function                (Id : E; V : N);
6939   procedure Set_Block_Node                      (Id : E; V : N);
6940   procedure Set_Body_Entity                     (Id : E; V : E);
6941   procedure Set_Body_Needed_For_SAL             (Id : E; V : B := True);
6942   procedure Set_Body_References                 (Id : E; V : L);
6943   procedure Set_BIP_Initialization_Call         (Id : E; V : N);
6944   procedure Set_CR_Discriminant                 (Id : E; V : E);
6945   procedure Set_C_Pass_By_Copy                  (Id : E; V : B := True);
6946   procedure Set_Can_Never_Be_Null               (Id : E; V : B := True);
6947   procedure Set_Can_Use_Internal_Rep            (Id : E; V : B := True);
6948   procedure Set_Checks_May_Be_Suppressed        (Id : E; V : B := True);
6949   procedure Set_Class_Wide_Type                 (Id : E; V : E);
6950   procedure Set_Cloned_Subtype                  (Id : E; V : E);
6951   procedure Set_Component_Alignment             (Id : E; V : C);
6952   procedure Set_Component_Bit_Offset            (Id : E; V : U);
6953   procedure Set_Component_Clause                (Id : E; V : N);
6954   procedure Set_Component_Size                  (Id : E; V : U);
6955   procedure Set_Component_Type                  (Id : E; V : E);
6956   procedure Set_Contract                        (Id : E; V : N);
6957   procedure Set_Corresponding_Concurrent_Type   (Id : E; V : E);
6958   procedure Set_Corresponding_Discriminant      (Id : E; V : E);
6959   procedure Set_Corresponding_Equality          (Id : E; V : E);
6960   procedure Set_Corresponding_Protected_Entry   (Id : E; V : E);
6961   procedure Set_Corresponding_Record_Type       (Id : E; V : E);
6962   procedure Set_Corresponding_Remote_Type       (Id : E; V : E);
6963   procedure Set_Current_Use_Clause              (Id : E; V : E);
6964   procedure Set_Current_Value                   (Id : E; V : N);
6965   procedure Set_DTC_Entity                      (Id : E; V : E);
6966   procedure Set_DT_Entry_Count                  (Id : E; V : U);
6967   procedure Set_DT_Offset_To_Top_Func           (Id : E; V : E);
6968   procedure Set_DT_Position                     (Id : E; V : U);
6969   procedure Set_Debug_Info_Off                  (Id : E; V : B := True);
6970   procedure Set_Debug_Renaming_Link             (Id : E; V : E);
6971   procedure Set_Default_Aspect_Component_Value  (Id : E; V : N);
6972   procedure Set_Default_Aspect_Value            (Id : E; V : N);
6973   procedure Set_Default_Expr_Function           (Id : E; V : E);
6974   procedure Set_Default_Expressions_Processed   (Id : E; V : B := True);
6975   procedure Set_Default_Value                   (Id : E; V : N);
6976   procedure Set_Delay_Cleanups                  (Id : E; V : B := True);
6977   procedure Set_Delay_Subprogram_Descriptors    (Id : E; V : B := True);
6978   procedure Set_Delta_Value                     (Id : E; V : R);
6979   procedure Set_Dependent_Instances             (Id : E; V : L);
6980   procedure Set_Depends_On_Private              (Id : E; V : B := True);
6981   procedure Set_Digits_Value                    (Id : E; V : U);
6982   procedure Set_Direct_Primitive_Operations     (Id : E; V : L);
6983   procedure Set_Directly_Designated_Type        (Id : E; V : E);
6984   procedure Set_Discard_Names                   (Id : E; V : B := True);
6985   procedure Set_Discriminal                     (Id : E; V : E);
6986   procedure Set_Discriminal_Link                (Id : E; V : E);
6987   procedure Set_Discriminant_Checking_Func      (Id : E; V : E);
6988   procedure Set_Discriminant_Constraint         (Id : E; V : L);
6989   procedure Set_Discriminant_Default_Value      (Id : E; V : N);
6990   procedure Set_Discriminant_Number             (Id : E; V : U);
6991   procedure Set_Dispatch_Table_Wrappers         (Id : E; V : L);
6992   procedure Set_Elaborate_Body_Desirable        (Id : E; V : B := True);
6993   procedure Set_Elaboration_Entity              (Id : E; V : E);
6994   procedure Set_Elaboration_Entity_Required     (Id : E; V : B := True);
6995   procedure Set_Encapsulating_State             (Id : E; V : E);
6996   procedure Set_Enclosing_Scope                 (Id : E; V : E);
6997   procedure Set_Entry_Accepted                  (Id : E; V : B := True);
6998   procedure Set_Entry_Bodies_Array              (Id : E; V : E);
6999   procedure Set_Entry_Cancel_Parameter          (Id : E; V : E);
7000   procedure Set_Entry_Component                 (Id : E; V : E);
7001   procedure Set_Entry_Formal                    (Id : E; V : E);
7002   procedure Set_Entry_Index_Constant            (Id : E; V : E);
7003   procedure Set_Entry_Parameters_Type           (Id : E; V : E);
7004   procedure Set_Enum_Pos_To_Rep                 (Id : E; V : E);
7005   procedure Set_Enumeration_Pos                 (Id : E; V : U);
7006   procedure Set_Enumeration_Rep                 (Id : E; V : U);
7007   procedure Set_Enumeration_Rep_Expr            (Id : E; V : N);
7008   procedure Set_Equivalent_Type                 (Id : E; V : E);
7009   procedure Set_Esize                           (Id : E; V : U);
7010   procedure Set_Exception_Code                  (Id : E; V : U);
7011   procedure Set_Extra_Accessibility             (Id : E; V : E);
7012   procedure Set_Extra_Accessibility_Of_Result   (Id : E; V : E);
7013   procedure Set_Extra_Constrained               (Id : E; V : E);
7014   procedure Set_Extra_Formal                    (Id : E; V : E);
7015   procedure Set_Extra_Formals                   (Id : E; V : E);
7016   procedure Set_Finalization_Master             (Id : E; V : E);
7017   procedure Set_Finalize_Storage_Only           (Id : E; V : B := True);
7018   procedure Set_Finalizer                       (Id : E; V : E);
7019   procedure Set_First_Entity                    (Id : E; V : E);
7020   procedure Set_First_Exit_Statement            (Id : E; V : N);
7021   procedure Set_First_Index                     (Id : E; V : N);
7022   procedure Set_First_Literal                   (Id : E; V : E);
7023   procedure Set_First_Optional_Parameter        (Id : E; V : E);
7024   procedure Set_First_Private_Entity            (Id : E; V : E);
7025   procedure Set_First_Rep_Item                  (Id : E; V : N);
7026   procedure Set_Float_Rep                       (Id : E; V : F);
7027   procedure Set_Freeze_Node                     (Id : E; V : N);
7028   procedure Set_From_Limited_With               (Id : E; V : B := True);
7029   procedure Set_Full_View                       (Id : E; V : E);
7030   procedure Set_Generic_Homonym                 (Id : E; V : E);
7031   procedure Set_Generic_Renamings               (Id : E; V : L);
7032   procedure Set_Handler_Records                 (Id : E; V : S);
7033   procedure Set_Has_Aliased_Components          (Id : E; V : B := True);
7034   procedure Set_Has_Alignment_Clause            (Id : E; V : B := True);
7035   procedure Set_Has_All_Calls_Remote            (Id : E; V : B := True);
7036   procedure Set_Has_Anonymous_Master            (Id : E; V : B := True);
7037   procedure Set_Has_Atomic_Components           (Id : E; V : B := True);
7038   procedure Set_Has_Biased_Representation       (Id : E; V : B := True);
7039   procedure Set_Has_Completion                  (Id : E; V : B := True);
7040   procedure Set_Has_Completion_In_Body          (Id : E; V : B := True);
7041   procedure Set_Has_Complex_Representation      (Id : E; V : B := True);
7042   procedure Set_Has_Component_Size_Clause       (Id : E; V : B := True);
7043   procedure Set_Has_Constrained_Partial_View    (Id : E; V : B := True);
7044   procedure Set_Has_Contiguous_Rep              (Id : E; V : B := True);
7045   procedure Set_Has_Controlled_Component        (Id : E; V : B := True);
7046   procedure Set_Has_Controlling_Result          (Id : E; V : B := True);
7047   procedure Set_Has_Convention_Pragma           (Id : E; V : B := True);
7048   procedure Set_Has_Default_Aspect              (Id : E; V : B := True);
7049   procedure Set_Has_Delayed_Aspects             (Id : E; V : B := True);
7050   procedure Set_Has_Delayed_Freeze              (Id : E; V : B := True);
7051   procedure Set_Has_Delayed_Rep_Aspects         (Id : E; V : B := True);
7052   procedure Set_Has_Discriminants               (Id : E; V : B := True);
7053   procedure Set_Has_Dispatch_Table              (Id : E; V : B := True);
7054   procedure Set_Has_Dynamic_Predicate_Aspect    (Id : E; V : B := True);
7055   procedure Set_Has_Enumeration_Rep_Clause      (Id : E; V : B := True);
7056   procedure Set_Has_Exit                        (Id : E; V : B := True);
7057   procedure Set_Has_External_Tag_Rep_Clause     (Id : E; V : B := True);
7058   procedure Set_Has_Forward_Instantiation       (Id : E; V : B := True);
7059   procedure Set_Has_Fully_Qualified_Name        (Id : E; V : B := True);
7060   procedure Set_Has_Gigi_Rep_Item               (Id : E; V : B := True);
7061   procedure Set_Has_Homonym                     (Id : E; V : B := True);
7062   procedure Set_Has_Implicit_Dereference        (Id : E; V : B := True);
7063   procedure Set_Has_Independent_Components      (Id : E; V : B := True);
7064   procedure Set_Has_Inheritable_Invariants      (Id : E; V : B := True);
7065   procedure Set_Has_Initial_Value               (Id : E; V : B := True);
7066   procedure Set_Has_Invariants                  (Id : E; V : B := True);
7067   procedure Set_Has_Loop_Entry_Attributes       (Id : E; V : B := True);
7068   procedure Set_Has_Machine_Radix_Clause        (Id : E; V : B := True);
7069   procedure Set_Has_Master_Entity               (Id : E; V : B := True);
7070   procedure Set_Has_Missing_Return              (Id : E; V : B := True);
7071   procedure Set_Has_Nested_Block_With_Handler   (Id : E; V : B := True);
7072   procedure Set_Has_Non_Standard_Rep            (Id : E; V : B := True);
7073   procedure Set_Has_Object_Size_Clause          (Id : E; V : B := True);
7074   procedure Set_Has_Per_Object_Constraint       (Id : E; V : B := True);
7075   procedure Set_Has_Postconditions              (Id : E; V : B := True);
7076   procedure Set_Has_Pragma_Controlled           (Id : E; V : B := True);
7077   procedure Set_Has_Pragma_Elaborate_Body       (Id : E; V : B := True);
7078   procedure Set_Has_Pragma_Inline               (Id : E; V : B := True);
7079   procedure Set_Has_Pragma_Inline_Always        (Id : E; V : B := True);
7080   procedure Set_Has_Pragma_No_Inline            (Id : E; V : B := True);
7081   procedure Set_Has_Pragma_Ordered              (Id : E; V : B := True);
7082   procedure Set_Has_Pragma_Pack                 (Id : E; V : B := True);
7083   procedure Set_Has_Pragma_Preelab_Init         (Id : E; V : B := True);
7084   procedure Set_Has_Pragma_Pure                 (Id : E; V : B := True);
7085   procedure Set_Has_Pragma_Pure_Function        (Id : E; V : B := True);
7086   procedure Set_Has_Pragma_Thread_Local_Storage (Id : E; V : B := True);
7087   procedure Set_Has_Pragma_Unmodified           (Id : E; V : B := True);
7088   procedure Set_Has_Pragma_Unreferenced         (Id : E; V : B := True);
7089   procedure Set_Has_Pragma_Unreferenced_Objects (Id : E; V : B := True);
7090   procedure Set_Has_Predicates                  (Id : E; V : B := True);
7091   procedure Set_Has_Primitive_Operations        (Id : E; V : B := True);
7092   procedure Set_Has_Private_Ancestor            (Id : E; V : B := True);
7093   procedure Set_Has_Private_Declaration         (Id : E; V : B := True);
7094   procedure Set_Has_Qualified_Name              (Id : E; V : B := True);
7095   procedure Set_Has_RACW                        (Id : E; V : B := True);
7096   procedure Set_Has_Record_Rep_Clause           (Id : E; V : B := True);
7097   procedure Set_Has_Recursive_Call              (Id : E; V : B := True);
7098   procedure Set_Has_Shift_Operator              (Id : E; V : B := True);
7099   procedure Set_Has_Size_Clause                 (Id : E; V : B := True);
7100   procedure Set_Has_Small_Clause                (Id : E; V : B := True);
7101   procedure Set_Has_Specified_Layout            (Id : E; V : B := True);
7102   procedure Set_Has_Specified_Stream_Input      (Id : E; V : B := True);
7103   procedure Set_Has_Specified_Stream_Output     (Id : E; V : B := True);
7104   procedure Set_Has_Specified_Stream_Read       (Id : E; V : B := True);
7105   procedure Set_Has_Specified_Stream_Write      (Id : E; V : B := True);
7106   procedure Set_Has_Static_Discriminants        (Id : E; V : B := True);
7107   procedure Set_Has_Static_Predicate_Aspect     (Id : E; V : B := True);
7108   procedure Set_Has_Storage_Size_Clause         (Id : E; V : B := True);
7109   procedure Set_Has_Stream_Size_Clause          (Id : E; V : B := True);
7110   procedure Set_Has_Task                        (Id : E; V : B := True);
7111   procedure Set_Has_Thunks                      (Id : E; V : B := True);
7112   procedure Set_Has_Unchecked_Union             (Id : E; V : B := True);
7113   procedure Set_Has_Unknown_Discriminants       (Id : E; V : B := True);
7114   procedure Set_Has_Up_Level_Access             (Id : E; V : B := True);
7115   procedure Set_Has_Visible_Refinement          (Id : E; V : B := True);
7116   procedure Set_Has_Volatile_Components         (Id : E; V : B := True);
7117   procedure Set_Has_Xref_Entry                  (Id : E; V : B := True);
7118   procedure Set_Hiding_Loop_Variable            (Id : E; V : E);
7119   procedure Set_Homonym                         (Id : E; V : E);
7120   procedure Set_Import_Pragma                   (Id : E; V : E);
7121   procedure Set_In_Package_Body                 (Id : E; V : B := True);
7122   procedure Set_In_Private_Part                 (Id : E; V : B := True);
7123   procedure Set_In_Use                          (Id : E; V : B := True);
7124   procedure Set_Initialization_Statements       (Id : E; V : N);
7125   procedure Set_Inner_Instances                 (Id : E; V : L);
7126   procedure Set_Interface_Alias                 (Id : E; V : E);
7127   procedure Set_Interface_Name                  (Id : E; V : N);
7128   procedure Set_Interfaces                      (Id : E; V : L);
7129   procedure Set_Is_AST_Entry                    (Id : E; V : B := True);
7130   procedure Set_Is_Abstract_Subprogram          (Id : E; V : B := True);
7131   procedure Set_Is_Abstract_Type                (Id : E; V : B := True);
7132   procedure Set_Is_Access_Constant              (Id : E; V : B := True);
7133   procedure Set_Is_Ada_2005_Only                (Id : E; V : B := True);
7134   procedure Set_Is_Ada_2012_Only                (Id : E; V : B := True);
7135   procedure Set_Is_Aliased                      (Id : E; V : B := True);
7136   procedure Set_Is_Asynchronous                 (Id : E; V : B := True);
7137   procedure Set_Is_Atomic                       (Id : E; V : B := True);
7138   procedure Set_Is_Bit_Packed_Array             (Id : E; V : B := True);
7139   procedure Set_Is_CPP_Class                    (Id : E; V : B := True);
7140   procedure Set_Is_Called                       (Id : E; V : B := True);
7141   procedure Set_Is_Character_Type               (Id : E; V : B := True);
7142   procedure Set_Is_Child_Unit                   (Id : E; V : B := True);
7143   procedure Set_Is_Class_Wide_Equivalent_Type   (Id : E; V : B := True);
7144   procedure Set_Is_Compilation_Unit             (Id : E; V : B := True);
7145   procedure Set_Is_Completely_Hidden            (Id : E; V : B := True);
7146   procedure Set_Is_Concurrent_Record_Type       (Id : E; V : B := True);
7147   procedure Set_Is_Constr_Subt_For_UN_Aliased   (Id : E; V : B := True);
7148   procedure Set_Is_Constr_Subt_For_U_Nominal    (Id : E; V : B := True);
7149   procedure Set_Is_Constrained                  (Id : E; V : B := True);
7150   procedure Set_Is_Constructor                  (Id : E; V : B := True);
7151   procedure Set_Is_Controlled                   (Id : E; V : B := True);
7152   procedure Set_Is_Controlling_Formal           (Id : E; V : B := True);
7153   procedure Set_Is_Descendent_Of_Address        (Id : E; V : B := True);
7154   procedure Set_Is_Discrim_SO_Function          (Id : E; V : B := True);
7155   procedure Set_Is_Discriminant_Check_Function  (Id : E; V : B := True);
7156   procedure Set_Is_Dispatch_Table_Entity        (Id : E; V : B := True);
7157   procedure Set_Is_Dispatching_Operation        (Id : E; V : B := True);
7158   procedure Set_Is_Eliminated                   (Id : E; V : B := True);
7159   procedure Set_Is_Entry_Formal                 (Id : E; V : B := True);
7160   procedure Set_Is_Exported                     (Id : E; V : B := True);
7161   procedure Set_Is_First_Subtype                (Id : E; V : B := True);
7162   procedure Set_Is_For_Access_Subtype           (Id : E; V : B := True);
7163   procedure Set_Is_Formal_Subprogram            (Id : E; V : B := True);
7164   procedure Set_Is_Frozen                       (Id : E; V : B := True);
7165   procedure Set_Is_Generic_Actual_Type          (Id : E; V : B := True);
7166   procedure Set_Is_Generic_Instance             (Id : E; V : B := True);
7167   procedure Set_Is_Generic_Type                 (Id : E; V : B := True);
7168   procedure Set_Is_Hidden                       (Id : E; V : B := True);
7169   procedure Set_Is_Hidden_Open_Scope            (Id : E; V : B := True);
7170   procedure Set_Is_Immediately_Visible          (Id : E; V : B := True);
7171   procedure Set_Is_Implementation_Defined       (Id : E; V : B := True);
7172   procedure Set_Is_Imported                     (Id : E; V : B := True);
7173   procedure Set_Is_Inlined                      (Id : E; V : B := True);
7174   procedure Set_Is_Instantiated                 (Id : E; V : B := True);
7175   procedure Set_Is_Interface                    (Id : E; V : B := True);
7176   procedure Set_Is_Internal                     (Id : E; V : B := True);
7177   procedure Set_Is_Interrupt_Handler            (Id : E; V : B := True);
7178   procedure Set_Is_Intrinsic_Subprogram         (Id : E; V : B := True);
7179   procedure Set_Is_Invariant_Procedure          (Id : E; V : B := True);
7180   procedure Set_Is_Itype                        (Id : E; V : B := True);
7181   procedure Set_Is_Known_Non_Null               (Id : E; V : B := True);
7182   procedure Set_Is_Known_Null                   (Id : E; V : B := True);
7183   procedure Set_Is_Known_Valid                  (Id : E; V : B := True);
7184   procedure Set_Is_Limited_Composite            (Id : E; V : B := True);
7185   procedure Set_Is_Limited_Interface            (Id : E; V : B := True);
7186   procedure Set_Is_Limited_Record               (Id : E; V : B := True);
7187   procedure Set_Is_Local_Anonymous_Access       (Id : E; V : B := True);
7188   procedure Set_Is_Machine_Code_Subprogram      (Id : E; V : B := True);
7189   procedure Set_Is_Non_Static_Subtype           (Id : E; V : B := True);
7190   procedure Set_Is_Null_Init_Proc               (Id : E; V : B := True);
7191   procedure Set_Is_Obsolescent                  (Id : E; V : B := True);
7192   procedure Set_Is_Only_Out_Parameter           (Id : E; V : B := True);
7193   procedure Set_Is_Optional_Parameter           (Id : E; V : B := True);
7194   procedure Set_Is_Package_Body_Entity          (Id : E; V : B := True);
7195   procedure Set_Is_Packed                       (Id : E; V : B := True);
7196   procedure Set_Is_Packed_Array_Type            (Id : E; V : B := True);
7197   procedure Set_Is_Potentially_Use_Visible      (Id : E; V : B := True);
7198   procedure Set_Is_Predicate_Function           (Id : E; V : B := True);
7199   procedure Set_Is_Predicate_Function_M         (Id : E; V : B := True);
7200   procedure Set_Is_Preelaborated                (Id : E; V : B := True);
7201   procedure Set_Is_Primitive                    (Id : E; V : B := True);
7202   procedure Set_Is_Primitive_Wrapper            (Id : E; V : B := True);
7203   procedure Set_Is_Private_Composite            (Id : E; V : B := True);
7204   procedure Set_Is_Private_Descendant           (Id : E; V : B := True);
7205   procedure Set_Is_Private_Primitive            (Id : E; V : B := True);
7206   procedure Set_Is_Processed_Transient          (Id : E; V : B := True);
7207   procedure Set_Is_Public                       (Id : E; V : B := True);
7208   procedure Set_Is_Pure                         (Id : E; V : B := True);
7209   procedure Set_Is_Pure_Unit_Access_Type        (Id : E; V : B := True);
7210   procedure Set_Is_RACW_Stub_Type               (Id : E; V : B := True);
7211   procedure Set_Is_Raised                       (Id : E; V : B := True);
7212   procedure Set_Is_Remote_Call_Interface        (Id : E; V : B := True);
7213   procedure Set_Is_Remote_Types                 (Id : E; V : B := True);
7214   procedure Set_Is_Renaming_Of_Object           (Id : E; V : B := True);
7215   procedure Set_Is_Return_Object                (Id : E; V : B := True);
7216   procedure Set_Is_Safe_To_Reevaluate           (Id : E; V : B := True);
7217   procedure Set_Is_Shared_Passive               (Id : E; V : B := True);
7218   procedure Set_Is_Statically_Allocated         (Id : E; V : B := True);
7219   procedure Set_Is_Tag                          (Id : E; V : B := True);
7220   procedure Set_Is_Tagged_Type                  (Id : E; V : B := True);
7221   procedure Set_Is_Thunk                        (Id : E; V : B := True);
7222   procedure Set_Is_Trivial_Subprogram           (Id : E; V : B := True);
7223   procedure Set_Is_True_Constant                (Id : E; V : B := True);
7224   procedure Set_Is_Unchecked_Union              (Id : E; V : B := True);
7225   procedure Set_Is_Underlying_Record_View       (Id : E; V : B := True);
7226   procedure Set_Is_Unsigned_Type                (Id : E; V : B := True);
7227   procedure Set_Is_VMS_Exception                (Id : E; V : B := True);
7228   procedure Set_Is_Valued_Procedure             (Id : E; V : B := True);
7229   procedure Set_Is_Visible_Formal               (Id : E; V : B := True);
7230   procedure Set_Is_Visible_Lib_Unit             (Id : E; V : B := True);
7231   procedure Set_Is_Volatile                     (Id : E; V : B := True);
7232   procedure Set_Itype_Printed                   (Id : E; V : B := True);
7233   procedure Set_Kill_Elaboration_Checks         (Id : E; V : B := True);
7234   procedure Set_Kill_Range_Checks               (Id : E; V : B := True);
7235   procedure Set_Known_To_Have_Preelab_Init      (Id : E; V : B := True);
7236   procedure Set_Last_Aggregate_Assignment       (Id : E; V : N);
7237   procedure Set_Last_Assignment                 (Id : E; V : N);
7238   procedure Set_Last_Entity                     (Id : E; V : E);
7239   procedure Set_Limited_View                    (Id : E; V : E);
7240   procedure Set_Linker_Section_Pragma           (Id : E; V : N);
7241   procedure Set_Lit_Indexes                     (Id : E; V : E);
7242   procedure Set_Lit_Strings                     (Id : E; V : E);
7243   procedure Set_Low_Bound_Tested                (Id : E; V : B := True);
7244   procedure Set_Machine_Radix_10                (Id : E; V : B := True);
7245   procedure Set_Master_Id                       (Id : E; V : E);
7246   procedure Set_Materialize_Entity              (Id : E; V : B := True);
7247   procedure Set_May_Inherit_Delayed_Rep_Aspects (Id : E; V : B := True);
7248   procedure Set_Mechanism                       (Id : E; V : M);
7249   procedure Set_Modulus                         (Id : E; V : U);
7250   procedure Set_Must_Be_On_Byte_Boundary        (Id : E; V : B := True);
7251   procedure Set_Must_Have_Preelab_Init          (Id : E; V : B := True);
7252   procedure Set_Needs_Debug_Info                (Id : E; V : B := True);
7253   procedure Set_Needs_No_Actuals                (Id : E; V : B := True);
7254   procedure Set_Never_Set_In_Source             (Id : E; V : B := True);
7255   procedure Set_Next_Inlined_Subprogram         (Id : E; V : E);
7256   procedure Set_No_Pool_Assigned                (Id : E; V : B := True);
7257   procedure Set_No_Return                       (Id : E; V : B := True);
7258   procedure Set_No_Strict_Aliasing              (Id : E; V : B := True);
7259   procedure Set_Non_Binary_Modulus              (Id : E; V : B := True);
7260   procedure Set_Non_Limited_View                (Id : E; V : E);
7261   procedure Set_Nonzero_Is_True                 (Id : E; V : B := True);
7262   procedure Set_Normalized_First_Bit            (Id : E; V : U);
7263   procedure Set_Normalized_Position             (Id : E; V : U);
7264   procedure Set_Normalized_Position_Max         (Id : E; V : U);
7265   procedure Set_OK_To_Rename                    (Id : E; V : B := True);
7266   procedure Set_OK_To_Reorder_Components        (Id : E; V : B := True);
7267   procedure Set_Optimize_Alignment_Space        (Id : E; V : B := True);
7268   procedure Set_Optimize_Alignment_Time         (Id : E; V : B := True);
7269   procedure Set_Original_Access_Type            (Id : E; V : E);
7270   procedure Set_Original_Array_Type             (Id : E; V : E);
7271   procedure Set_Original_Record_Component       (Id : E; V : E);
7272   procedure Set_Overlays_Constant               (Id : E; V : B := True);
7273   procedure Set_Overridden_Operation            (Id : E; V : E);
7274   procedure Set_PPC_Wrapper                     (Id : E; V : E);
7275   procedure Set_Package_Instantiation           (Id : E; V : N);
7276   procedure Set_Packed_Array_Type               (Id : E; V : E);
7277   procedure Set_Parent_Subtype                  (Id : E; V : E);
7278   procedure Set_Part_Of_Constituents            (Id : E; V : L);
7279   procedure Set_Postcondition_Proc              (Id : E; V : E);
7280   procedure Set_Prival                          (Id : E; V : E);
7281   procedure Set_Prival_Link                     (Id : E; V : E);
7282   procedure Set_Private_Dependents              (Id : E; V : L);
7283   procedure Set_Private_View                    (Id : E; V : N);
7284   procedure Set_Protected_Body_Subprogram       (Id : E; V : E);
7285   procedure Set_Protected_Formal                (Id : E; V : E);
7286   procedure Set_Protection_Object               (Id : E; V : E);
7287   procedure Set_RM_Size                         (Id : E; V : U);
7288   procedure Set_Reachable                       (Id : E; V : B := True);
7289   procedure Set_Referenced                      (Id : E; V : B := True);
7290   procedure Set_Referenced_As_LHS               (Id : E; V : B := True);
7291   procedure Set_Referenced_As_Out_Parameter     (Id : E; V : B := True);
7292   procedure Set_Refinement_Constituents         (Id : E; V : L);
7293   procedure Set_Register_Exception_Call         (Id : E; V : N);
7294   procedure Set_Related_Array_Object            (Id : E; V : E);
7295   procedure Set_Related_Expression              (Id : E; V : N);
7296   procedure Set_Related_Instance                (Id : E; V : E);
7297   procedure Set_Related_Type                    (Id : E; V : E);
7298   procedure Set_Relative_Deadline_Variable      (Id : E; V : E);
7299   procedure Set_Renamed_Entity                  (Id : E; V : N);
7300   procedure Set_Renamed_In_Spec                 (Id : E; V : B := True);
7301   procedure Set_Renamed_Object                  (Id : E; V : N);
7302   procedure Set_Renaming_Map                    (Id : E; V : U);
7303   procedure Set_Requires_Overriding             (Id : E; V : B := True);
7304   procedure Set_Return_Applies_To               (Id : E; V : N);
7305   procedure Set_Return_Present                  (Id : E; V : B := True);
7306   procedure Set_Returns_By_Ref                  (Id : E; V : B := True);
7307   procedure Set_Reverse_Bit_Order               (Id : E; V : B := True);
7308   procedure Set_Reverse_Storage_Order           (Id : E; V : B := True);
7309   procedure Set_Scalar_Range                    (Id : E; V : N);
7310   procedure Set_Scale_Value                     (Id : E; V : U);
7311   procedure Set_Scope_Depth_Value               (Id : E; V : U);
7312   procedure Set_Sec_Stack_Needed_For_Return     (Id : E; V : B := True);
7313   procedure Set_Shadow_Entities                 (Id : E; V : S);
7314   procedure Set_Shared_Var_Procs_Instance       (Id : E; V : E);
7315   procedure Set_Size_Check_Code                 (Id : E; V : N);
7316   procedure Set_Size_Depends_On_Discriminant    (Id : E; V : B := True);
7317   procedure Set_Size_Known_At_Compile_Time      (Id : E; V : B := True);
7318   procedure Set_Small_Value                     (Id : E; V : R);
7319   procedure Set_SPARK_Aux_Pragma                (Id : E; V : N);
7320   procedure Set_SPARK_Aux_Pragma_Inherited      (Id : E; V : B := True);
7321   procedure Set_SPARK_Pragma                    (Id : E; V : N);
7322   procedure Set_SPARK_Pragma_Inherited          (Id : E; V : B := True);
7323   procedure Set_Spec_Entity                     (Id : E; V : E);
7324   procedure Set_Static_Elaboration_Desired      (Id : E; V : B);
7325   procedure Set_Static_Initialization           (Id : E; V : N);
7326   procedure Set_Static_Predicate                (Id : E; V : S);
7327   procedure Set_Status_Flag_Or_Transient_Decl   (Id : E; V : E);
7328   procedure Set_Storage_Size_Variable           (Id : E; V : E);
7329   procedure Set_Stored_Constraint               (Id : E; V : L);
7330   procedure Set_Strict_Alignment                (Id : E; V : B := True);
7331   procedure Set_String_Literal_Length           (Id : E; V : U);
7332   procedure Set_String_Literal_Low_Bound        (Id : E; V : N);
7333   procedure Set_Subprograms_For_Type            (Id : E; V : E);
7334   procedure Set_Suppress_Elaboration_Warnings   (Id : E; V : B := True);
7335   procedure Set_Suppress_Initialization         (Id : E; V : B := True);
7336   procedure Set_Suppress_Style_Checks           (Id : E; V : B := True);
7337   procedure Set_Suppress_Value_Tracking_On_Call (Id : E; V : B := True);
7338   procedure Set_Task_Body_Procedure             (Id : E; V : N);
7339   procedure Set_Thunk_Entity                    (Id : E; V : E);
7340   procedure Set_Treat_As_Volatile               (Id : E; V : B := True);
7341   procedure Set_Underlying_Full_View            (Id : E; V : E);
7342   procedure Set_Underlying_Record_View          (Id : E; V : E);
7343   procedure Set_Universal_Aliasing              (Id : E; V : B := True);
7344   procedure Set_Unset_Reference                 (Id : E; V : N);
7345   procedure Set_Used_As_Generic_Actual          (Id : E; V : B := True);
7346   procedure Set_Uses_Lock_Free                  (Id : E; V : B := True);
7347   procedure Set_Uses_Sec_Stack                  (Id : E; V : B := True);
7348   procedure Set_Warnings_Off                    (Id : E; V : B := True);
7349   procedure Set_Warnings_Off_Used               (Id : E; V : B := True);
7350   procedure Set_Warnings_Off_Used_Unmodified    (Id : E; V : B := True);
7351   procedure Set_Warnings_Off_Used_Unreferenced  (Id : E; V : B := True);
7352   procedure Set_Was_Hidden                      (Id : E; V : B := True);
7353   procedure Set_Wrapped_Entity                  (Id : E; V : E);
7354
7355   ---------------------------------------------------
7356   -- Access to Subprograms in Subprograms_For_Type --
7357   ---------------------------------------------------
7358
7359   function Invariant_Procedure                 (Id : E) return N;
7360   function Predicate_Function                  (Id : E) return N;
7361   function Predicate_Function_M                (Id : E) return N;
7362
7363   procedure Set_Invariant_Procedure            (Id : E; V : E);
7364   procedure Set_Predicate_Function             (Id : E; V : E);
7365   procedure Set_Predicate_Function_M           (Id : E; V : E);
7366
7367   -----------------------------------
7368   -- Field Initialization Routines --
7369   -----------------------------------
7370
7371   --  These routines are overloadings of some of the above Set procedures
7372   --  where the argument is normally a Uint. The overloadings take an Int
7373   --  parameter instead, and appropriately convert it. There are also
7374   --  versions that implicitly initialize to the appropriate "not set"
7375   --  value. The not set (unknown) values are as follows:
7376
7377   --    Alignment                 Uint_0
7378   --    Component_Size            Uint_0
7379   --    Component_Bit_Offset      No_Uint
7380   --    Digits_Value              Uint_0
7381   --    Esize                     Uint_0
7382   --    Normalized_First_Bit      No_Uint
7383   --    Normalized_Position       No_Uint
7384   --    Normalized_Position_Max   No_Uint
7385   --    RM_Size                   Uint_0
7386
7387   --  It would be cleaner to use No_Uint in all these cases, but historically
7388   --  we chose to use Uint_0 at first, and the change over will take time ???
7389   --  This is particularly true for the RM_Size field, where a value of zero
7390   --  is legitimate and causes some kludges around the code.
7391
7392   --  Contrary to the corresponding Set procedures above, these routines
7393   --  do NOT check the entity kind of their argument, instead they set the
7394   --  underlying Uint fields directly (this allows them to be used for
7395   --  entities whose Ekind has not been set yet).
7396
7397   procedure Init_Alignment                (Id : E; V : Int);
7398   procedure Init_Component_Size           (Id : E; V : Int);
7399   procedure Init_Component_Bit_Offset     (Id : E; V : Int);
7400   procedure Init_Digits_Value             (Id : E; V : Int);
7401   procedure Init_Esize                    (Id : E; V : Int);
7402   procedure Init_Normalized_First_Bit     (Id : E; V : Int);
7403   procedure Init_Normalized_Position      (Id : E; V : Int);
7404   procedure Init_Normalized_Position_Max  (Id : E; V : Int);
7405   procedure Init_RM_Size                  (Id : E; V : Int);
7406
7407   procedure Init_Alignment                (Id : E);
7408   procedure Init_Component_Size           (Id : E);
7409   procedure Init_Component_Bit_Offset     (Id : E);
7410   procedure Init_Digits_Value             (Id : E);
7411   procedure Init_Esize                    (Id : E);
7412   procedure Init_Normalized_First_Bit     (Id : E);
7413   procedure Init_Normalized_Position      (Id : E);
7414   procedure Init_Normalized_Position_Max  (Id : E);
7415   procedure Init_RM_Size                  (Id : E);
7416
7417   procedure Init_Size_Align (Id : E);
7418   --  This procedure initializes both size fields and the alignment
7419   --  field to all be Unknown.
7420
7421   procedure Init_Object_Size_Align (Id : E);
7422   --  Same as Init_Size_Align except RM_Size field (which is only for types)
7423   --  is unaffected.
7424
7425   procedure Init_Size (Id : E; V : Int);
7426   --  Initialize both the Esize and RM_Size fields of E to V
7427
7428   procedure Init_Component_Location (Id : E);
7429   --  Initializes all fields describing the location of a component
7430   --  (Normalized_Position, Component_Bit_Offset, Normalized_First_Bit,
7431   --  Normalized_Position_Max, Esize) to all be Unknown.
7432
7433   ---------------
7434   -- Iterators --
7435   ---------------
7436
7437   --  The call to Next_xxx (obj) is equivalent to obj := Next_xxx (obj)
7438   --  We define the set of Proc_Next_xxx routines simply for the purposes
7439   --  of inlining them without necessarily inlining the function.
7440
7441   procedure Proc_Next_Component                 (N : in out Node_Id);
7442   procedure Proc_Next_Component_Or_Discriminant (N : in out Node_Id);
7443   procedure Proc_Next_Discriminant              (N : in out Node_Id);
7444   procedure Proc_Next_Formal                    (N : in out Node_Id);
7445   procedure Proc_Next_Formal_With_Extras        (N : in out Node_Id);
7446   procedure Proc_Next_Index                     (N : in out Node_Id);
7447   procedure Proc_Next_Inlined_Subprogram        (N : in out Node_Id);
7448   procedure Proc_Next_Literal                   (N : in out Node_Id);
7449   procedure Proc_Next_Stored_Discriminant       (N : in out Node_Id);
7450
7451   pragma Inline (Proc_Next_Component);
7452   pragma Inline (Proc_Next_Component_Or_Discriminant);
7453   pragma Inline (Proc_Next_Discriminant);
7454   pragma Inline (Proc_Next_Formal);
7455   pragma Inline (Proc_Next_Formal_With_Extras);
7456   pragma Inline (Proc_Next_Index);
7457   pragma Inline (Proc_Next_Inlined_Subprogram);
7458   pragma Inline (Proc_Next_Literal);
7459   pragma Inline (Proc_Next_Stored_Discriminant);
7460
7461   procedure Next_Component                 (N : in out Node_Id)
7462     renames Proc_Next_Component;
7463
7464   procedure Next_Component_Or_Discriminant (N : in out Node_Id)
7465     renames Proc_Next_Component_Or_Discriminant;
7466
7467   procedure Next_Discriminant              (N : in out Node_Id)
7468     renames Proc_Next_Discriminant;
7469
7470   procedure Next_Formal                    (N : in out Node_Id)
7471     renames Proc_Next_Formal;
7472
7473   procedure Next_Formal_With_Extras        (N : in out Node_Id)
7474     renames Proc_Next_Formal_With_Extras;
7475
7476   procedure Next_Index                     (N : in out Node_Id)
7477     renames Proc_Next_Index;
7478
7479   procedure Next_Inlined_Subprogram        (N : in out Node_Id)
7480     renames Proc_Next_Inlined_Subprogram;
7481
7482   procedure Next_Literal                   (N : in out Node_Id)
7483     renames Proc_Next_Literal;
7484
7485   procedure Next_Stored_Discriminant       (N : in out Node_Id)
7486     renames Proc_Next_Stored_Discriminant;
7487
7488   ---------------------------
7489   -- Testing Warning Flags --
7490   ---------------------------
7491
7492   --  These routines are to be used rather than testing flags Warnings_Off,
7493   --  Has_Pragma_Unmodified, Has_Pragma_Unreferenced. They deal with setting
7494   --  the flags Warnings_Off_Used[_Unmodified|Unreferenced] for later access.
7495
7496   function Has_Warnings_Off (E : Entity_Id) return Boolean;
7497   --  If Warnings_Off is set on E, then returns True and also sets the flag
7498   --  Warnings_Off_Used on E. If Warnings_Off is not set on E, returns False
7499   --  and has no side effect.
7500
7501   function Has_Unmodified (E : Entity_Id) return Boolean;
7502   --  If flag Has_Pragma_Unmodified is set on E, returns True with no side
7503   --  effects. Otherwise if Warnings_Off is set on E, returns True and also
7504   --  sets the flag Warnings_Off_Used_Unmodified on E. If neither of the flags
7505   --  Warnings_Off nor Has_Pragma_Unmodified is set, returns False with no
7506   --  side effects.
7507
7508   function Has_Unreferenced (E : Entity_Id) return Boolean;
7509   --  If flag Has_Pragma_Unreferenced is set on E, returns True with no side
7510   --  effects. Otherwise if Warnings_Off is set on E, returns True and also
7511   --  sets the flag Warnings_Off_Used_Unreferenced on E. If neither of the
7512   --  flags Warnings_Off nor Has_Pragma_Unreferenced is set, returns False
7513   --  with no side effects.
7514
7515   ----------------------------------------------
7516   -- Subprograms for Accessing Rep Item Chain --
7517   ----------------------------------------------
7518
7519   --  The First_Rep_Item field of every entity points to a linked list (linked
7520   --  through Next_Rep_Item) of representation pragmas, attribute definition
7521   --  clauses, representation clauses, and aspect specifications that apply to
7522   --  the item. Note that in the case of types, it is assumed that any such
7523   --  rep items for a base type also apply to all subtypes. This is achieved
7524   --  by having the chain for subtypes link onto the chain for the base type,
7525   --  so that new entries for the subtype are added at the start of the chain.
7526   --
7527   --  Note: aspect specification nodes are linked only when evaluation of the
7528   --  expression is deferred to the freeze point. For further details see
7529   --  Sem_Ch13.Analyze_Aspect_Specifications.
7530
7531   function Get_Attribute_Definition_Clause
7532     (E  : Entity_Id;
7533      Id : Attribute_Id) return Node_Id;
7534   --  Searches the Rep_Item chain for a given entity E, for an instance of an
7535   --  attribute definition clause with the given attribute Id. If found, the
7536   --  value returned is the N_Attribute_Definition_Clause node, otherwise
7537   --  Empty is returned.
7538
7539   function Get_Pragma (E : Entity_Id; Id : Pragma_Id) return Node_Id;
7540   --  Searches the Rep_Item chain of entity E, for an instance of a pragma
7541   --  with the given pragma Id. If found, the value returned is the N_Pragma
7542   --  node, otherwise Empty is returned. The following contract pragmas that
7543   --  appear in N_Contract nodes are also handled by this routine:
7544   --    Abstract_State
7545   --    Async_Readers
7546   --    Async_Writers
7547   --    Contract_Cases
7548   --    Depends
7549   --    Effective_Reads
7550   --    Effective_Writes
7551   --    Global
7552   --    Initial_Condition
7553   --    Initializes
7554   --    Part_Of
7555   --    Precondition
7556   --    Postcondition
7557   --    Refined_Depends
7558   --    Refined_Global
7559   --    Refined_Post
7560   --    Refined_State
7561   --    Test_Case
7562
7563   function Get_Record_Representation_Clause (E : Entity_Id) return Node_Id;
7564   --  Searches the Rep_Item chain for a given entity E, for a record
7565   --  representation clause, and if found, returns it. Returns Empty
7566   --  if no such clause is found.
7567
7568   function Present_In_Rep_Item (E : Entity_Id; N : Node_Id) return Boolean;
7569   --  Return True if N is present in the Rep_Item chain for a given entity E
7570
7571   procedure Record_Rep_Item (E : Entity_Id; N : Node_Id);
7572   --  N is the node for a representation pragma, representation clause, an
7573   --  attribute definition clause, or an aspect specification that applies to
7574   --  entity E. This procedure links the node N onto the Rep_Item chain for
7575   --  entity E. Note that it is an error to call this procedure with E being
7576   --  overloadable, and N being a pragma that applies to multiple overloadable
7577   --  entities (Convention, Interface, Inline, Inline_Always, Import, Export,
7578   --  External). This is not allowed even in the case where the entity is not
7579   --  overloaded, since we can't rely on it being present in the overloaded
7580   --  case, it is not useful to have it present in the non-overloaded case.
7581
7582   -------------------------------
7583   -- Miscellaneous Subprograms --
7584   -------------------------------
7585
7586   procedure Append_Entity (Id : Entity_Id; V : Entity_Id);
7587   --  Add an entity to the list of entities declared in the scope V
7588
7589   function Get_Full_View (T : Entity_Id) return Entity_Id;
7590   --  If T is an incomplete type and the full declaration has been seen, or
7591   --  is the name of a class_wide type whose root is incomplete, return the
7592   --  corresponding full declaration, else return T itself.
7593
7594   function Is_Entity_Name (N : Node_Id) return Boolean;
7595   --  Test if the node N is the name of an entity (i.e. is an identifier,
7596   --  expanded name, or an attribute reference that returns an entity).
7597
7598   function Next_Index (Id : Node_Id) return Node_Id;
7599   --  Given an index from a previous call to First_Index or Next_Index,
7600   --  returns a node representing the occurrence of the next index subtype,
7601   --  or Empty if there are no more index subtypes.
7602
7603   function Scope_Depth (Id : Entity_Id) return Uint;
7604   --  Returns the scope depth value of the Id, unless the Id is a record
7605   --  type, in which case it returns the scope depth of the record scope.
7606
7607   function Subtype_Kind (K : Entity_Kind) return Entity_Kind;
7608   --  Given an entity_kind K this function returns the entity_kind
7609   --  corresponding to subtype kind of the type represented by K. For
7610   --  example if K is E_Signed_Integer_Type then E_Signed_Integer_Subtype
7611   --  is returned. If K is already a subtype kind it itself is returned. An
7612   --  internal error is generated if no such correspondence exists for K.
7613
7614   ----------------------------------
7615   -- Debugging Output Subprograms --
7616   ----------------------------------
7617
7618   procedure Write_Entity_Flags (Id : Entity_Id; Prefix : String);
7619   --  Writes a series of entries giving a line for each flag that is
7620   --  set to True. Each line is prefixed by the given string
7621
7622   procedure Write_Entity_Info (Id : Entity_Id; Prefix : String);
7623   --  A debugging procedure to write out information about an entity
7624
7625   procedure Write_Field6_Name  (Id : Entity_Id);
7626   procedure Write_Field7_Name  (Id : Entity_Id);
7627   procedure Write_Field8_Name  (Id : Entity_Id);
7628   procedure Write_Field9_Name  (Id : Entity_Id);
7629   procedure Write_Field10_Name (Id : Entity_Id);
7630   procedure Write_Field11_Name (Id : Entity_Id);
7631   procedure Write_Field12_Name (Id : Entity_Id);
7632   procedure Write_Field13_Name (Id : Entity_Id);
7633   procedure Write_Field14_Name (Id : Entity_Id);
7634   procedure Write_Field15_Name (Id : Entity_Id);
7635   procedure Write_Field16_Name (Id : Entity_Id);
7636   procedure Write_Field17_Name (Id : Entity_Id);
7637   procedure Write_Field18_Name (Id : Entity_Id);
7638   procedure Write_Field19_Name (Id : Entity_Id);
7639   procedure Write_Field20_Name (Id : Entity_Id);
7640   procedure Write_Field21_Name (Id : Entity_Id);
7641   procedure Write_Field22_Name (Id : Entity_Id);
7642   procedure Write_Field23_Name (Id : Entity_Id);
7643   procedure Write_Field24_Name (Id : Entity_Id);
7644   procedure Write_Field25_Name (Id : Entity_Id);
7645   procedure Write_Field26_Name (Id : Entity_Id);
7646   procedure Write_Field27_Name (Id : Entity_Id);
7647   procedure Write_Field28_Name (Id : Entity_Id);
7648   procedure Write_Field29_Name (Id : Entity_Id);
7649   procedure Write_Field30_Name (Id : Entity_Id);
7650   procedure Write_Field31_Name (Id : Entity_Id);
7651   procedure Write_Field32_Name (Id : Entity_Id);
7652   procedure Write_Field33_Name (Id : Entity_Id);
7653   procedure Write_Field34_Name (Id : Entity_Id);
7654   procedure Write_Field35_Name (Id : Entity_Id);
7655   --  These routines are used in Treepr to output a nice symbolic name for
7656   --  the given field, depending on the Ekind. No blanks or end of lines are
7657   --  output, just the characters of the field name.
7658
7659   --------------------
7660   -- Inline Pragmas --
7661   --------------------
7662
7663   --  Note that these inline pragmas are referenced by the XEINFO utility
7664   --  program in preparing the corresponding C header, and only those
7665   --  subprograms meeting the requirements documented in the section on
7666   --  XEINFO may be referenced in this section.
7667
7668   pragma Inline (Abstract_States);
7669   pragma Inline (Accept_Address);
7670   pragma Inline (Access_Disp_Table);
7671   pragma Inline (Actual_Subtype);
7672   pragma Inline (Address_Taken);
7673   pragma Inline (Alias);
7674   pragma Inline (Alignment);
7675   pragma Inline (Associated_Formal_Package);
7676   pragma Inline (Associated_Node_For_Itype);
7677   pragma Inline (Associated_Storage_Pool);
7678   pragma Inline (Barrier_Function);
7679   pragma Inline (Block_Node);
7680   pragma Inline (Body_Entity);
7681   pragma Inline (Body_Needed_For_SAL);
7682   pragma Inline (Body_References);
7683   pragma Inline (BIP_Initialization_Call);
7684   pragma Inline (CR_Discriminant);
7685   pragma Inline (C_Pass_By_Copy);
7686   pragma Inline (Can_Never_Be_Null);
7687   pragma Inline (Can_Use_Internal_Rep);
7688   pragma Inline (Checks_May_Be_Suppressed);
7689   pragma Inline (Class_Wide_Type);
7690   pragma Inline (Cloned_Subtype);
7691   pragma Inline (Component_Bit_Offset);
7692   pragma Inline (Component_Clause);
7693   pragma Inline (Component_Size);
7694   pragma Inline (Component_Type);
7695   pragma Inline (Contract);
7696   pragma Inline (Corresponding_Concurrent_Type);
7697   pragma Inline (Corresponding_Discriminant);
7698   pragma Inline (Corresponding_Equality);
7699   pragma Inline (Corresponding_Protected_Entry);
7700   pragma Inline (Corresponding_Record_Type);
7701   pragma Inline (Corresponding_Remote_Type);
7702   pragma Inline (Current_Use_Clause);
7703   pragma Inline (Current_Value);
7704   pragma Inline (DTC_Entity);
7705   pragma Inline (DT_Entry_Count);
7706   pragma Inline (DT_Offset_To_Top_Func);
7707   pragma Inline (DT_Position);
7708   pragma Inline (Debug_Info_Off);
7709   pragma Inline (Debug_Renaming_Link);
7710   pragma Inline (Default_Aspect_Component_Value);
7711   pragma Inline (Default_Aspect_Value);
7712   pragma Inline (Default_Expr_Function);
7713   pragma Inline (Default_Expressions_Processed);
7714   pragma Inline (Default_Value);
7715   pragma Inline (Delay_Cleanups);
7716   pragma Inline (Delay_Subprogram_Descriptors);
7717   pragma Inline (Delta_Value);
7718   pragma Inline (Dependent_Instances);
7719   pragma Inline (Depends_On_Private);
7720   pragma Inline (Digits_Value);
7721   pragma Inline (Direct_Primitive_Operations);
7722   pragma Inline (Directly_Designated_Type);
7723   pragma Inline (Discard_Names);
7724   pragma Inline (Discriminal);
7725   pragma Inline (Discriminal_Link);
7726   pragma Inline (Discriminant_Checking_Func);
7727   pragma Inline (Discriminant_Constraint);
7728   pragma Inline (Discriminant_Default_Value);
7729   pragma Inline (Discriminant_Number);
7730   pragma Inline (Dispatch_Table_Wrappers);
7731   pragma Inline (Elaborate_Body_Desirable);
7732   pragma Inline (Elaboration_Entity);
7733   pragma Inline (Elaboration_Entity_Required);
7734   pragma Inline (Encapsulating_State);
7735   pragma Inline (Enclosing_Scope);
7736   pragma Inline (Entry_Accepted);
7737   pragma Inline (Entry_Bodies_Array);
7738   pragma Inline (Entry_Cancel_Parameter);
7739   pragma Inline (Entry_Component);
7740   pragma Inline (Entry_Formal);
7741   pragma Inline (Entry_Index_Constant);
7742   pragma Inline (Entry_Index_Type);
7743   pragma Inline (Entry_Parameters_Type);
7744   pragma Inline (Enum_Pos_To_Rep);
7745   pragma Inline (Enumeration_Pos);
7746   pragma Inline (Enumeration_Rep);
7747   pragma Inline (Enumeration_Rep_Expr);
7748   pragma Inline (Equivalent_Type);
7749   pragma Inline (Esize);
7750   pragma Inline (Exception_Code);
7751   pragma Inline (Extra_Accessibility);
7752   pragma Inline (Extra_Accessibility_Of_Result);
7753   pragma Inline (Extra_Constrained);
7754   pragma Inline (Extra_Formal);
7755   pragma Inline (Extra_Formals);
7756   pragma Inline (Finalization_Master);
7757   pragma Inline (Finalizer);
7758   pragma Inline (First_Entity);
7759   pragma Inline (First_Exit_Statement);
7760   pragma Inline (First_Index);
7761   pragma Inline (First_Literal);
7762   pragma Inline (First_Optional_Parameter);
7763   pragma Inline (First_Private_Entity);
7764   pragma Inline (First_Rep_Item);
7765   pragma Inline (Freeze_Node);
7766   pragma Inline (From_Limited_With);
7767   pragma Inline (Full_View);
7768   pragma Inline (Generic_Homonym);
7769   pragma Inline (Generic_Renamings);
7770   pragma Inline (Handler_Records);
7771   pragma Inline (Has_Aliased_Components);
7772   pragma Inline (Has_Alignment_Clause);
7773   pragma Inline (Has_All_Calls_Remote);
7774   pragma Inline (Has_Anonymous_Master);
7775   pragma Inline (Has_Atomic_Components);
7776   pragma Inline (Has_Biased_Representation);
7777   pragma Inline (Has_Completion);
7778   pragma Inline (Has_Completion_In_Body);
7779   pragma Inline (Has_Complex_Representation);
7780   pragma Inline (Has_Component_Size_Clause);
7781   pragma Inline (Has_Constrained_Partial_View);
7782   pragma Inline (Has_Contiguous_Rep);
7783   pragma Inline (Has_Controlled_Component);
7784   pragma Inline (Has_Controlling_Result);
7785   pragma Inline (Has_Convention_Pragma);
7786   pragma Inline (Has_Default_Aspect);
7787   pragma Inline (Has_Delayed_Aspects);
7788   pragma Inline (Has_Delayed_Freeze);
7789   pragma Inline (Has_Delayed_Rep_Aspects);
7790   pragma Inline (Has_Discriminants);
7791   pragma Inline (Has_Dispatch_Table);
7792   pragma Inline (Has_Dynamic_Predicate_Aspect);
7793   pragma Inline (Has_Enumeration_Rep_Clause);
7794   pragma Inline (Has_Exit);
7795   pragma Inline (Has_External_Tag_Rep_Clause);
7796   pragma Inline (Has_Forward_Instantiation);
7797   pragma Inline (Has_Fully_Qualified_Name);
7798   pragma Inline (Has_Gigi_Rep_Item);
7799   pragma Inline (Has_Homonym);
7800   pragma Inline (Has_Implicit_Dereference);
7801   pragma Inline (Has_Independent_Components);
7802   pragma Inline (Has_Inheritable_Invariants);
7803   pragma Inline (Has_Initial_Value);
7804   pragma Inline (Has_Invariants);
7805   pragma Inline (Has_Loop_Entry_Attributes);
7806   pragma Inline (Has_Machine_Radix_Clause);
7807   pragma Inline (Has_Master_Entity);
7808   pragma Inline (Has_Missing_Return);
7809   pragma Inline (Has_Nested_Block_With_Handler);
7810   pragma Inline (Has_Non_Standard_Rep);
7811   pragma Inline (Has_Object_Size_Clause);
7812   pragma Inline (Has_Per_Object_Constraint);
7813   pragma Inline (Has_Postconditions);
7814   pragma Inline (Has_Pragma_Controlled);
7815   pragma Inline (Has_Pragma_Elaborate_Body);
7816   pragma Inline (Has_Pragma_Inline);
7817   pragma Inline (Has_Pragma_Inline_Always);
7818   pragma Inline (Has_Pragma_No_Inline);
7819   pragma Inline (Has_Pragma_Ordered);
7820   pragma Inline (Has_Pragma_Pack);
7821   pragma Inline (Has_Pragma_Preelab_Init);
7822   pragma Inline (Has_Pragma_Pure);
7823   pragma Inline (Has_Pragma_Pure_Function);
7824   pragma Inline (Has_Pragma_Thread_Local_Storage);
7825   pragma Inline (Has_Pragma_Unmodified);
7826   pragma Inline (Has_Pragma_Unreferenced);
7827   pragma Inline (Has_Pragma_Unreferenced_Objects);
7828   pragma Inline (Has_Predicates);
7829   pragma Inline (Has_Primitive_Operations);
7830   pragma Inline (Has_Private_Ancestor);
7831   pragma Inline (Has_Private_Declaration);
7832   pragma Inline (Has_Qualified_Name);
7833   pragma Inline (Has_RACW);
7834   pragma Inline (Has_Record_Rep_Clause);
7835   pragma Inline (Has_Recursive_Call);
7836   pragma Inline (Has_Shift_Operator);
7837   pragma Inline (Has_Size_Clause);
7838   pragma Inline (Has_Small_Clause);
7839   pragma Inline (Has_Specified_Layout);
7840   pragma Inline (Has_Specified_Stream_Input);
7841   pragma Inline (Has_Specified_Stream_Output);
7842   pragma Inline (Has_Specified_Stream_Read);
7843   pragma Inline (Has_Specified_Stream_Write);
7844   pragma Inline (Has_Static_Discriminants);
7845   pragma Inline (Has_Static_Predicate_Aspect);
7846   pragma Inline (Has_Storage_Size_Clause);
7847   pragma Inline (Has_Stream_Size_Clause);
7848   pragma Inline (Has_Task);
7849   pragma Inline (Has_Thunks);
7850   pragma Inline (Has_Unchecked_Union);
7851   pragma Inline (Has_Unknown_Discriminants);
7852   pragma Inline (Has_Up_Level_Access);
7853   pragma Inline (Has_Visible_Refinement);
7854   pragma Inline (Has_Volatile_Components);
7855   pragma Inline (Has_Xref_Entry);
7856   pragma Inline (Hiding_Loop_Variable);
7857   pragma Inline (Homonym);
7858   pragma Inline (Import_Pragma);
7859   pragma Inline (In_Package_Body);
7860   pragma Inline (In_Private_Part);
7861   pragma Inline (In_Use);
7862   pragma Inline (Inner_Instances);
7863   pragma Inline (Interface_Alias);
7864   pragma Inline (Interface_Name);
7865   pragma Inline (Interfaces);
7866   pragma Inline (Is_AST_Entry);
7867   pragma Inline (Is_Abstract_Subprogram);
7868   pragma Inline (Is_Abstract_Type);
7869   pragma Inline (Is_Access_Constant);
7870   pragma Inline (Is_Access_Protected_Subprogram_Type);
7871   pragma Inline (Is_Access_Subprogram_Type);
7872   pragma Inline (Is_Access_Type);
7873   pragma Inline (Is_Ada_2005_Only);
7874   pragma Inline (Is_Ada_2012_Only);
7875   pragma Inline (Is_Aggregate_Type);
7876   pragma Inline (Is_Aliased);
7877   pragma Inline (Is_Array_Type);
7878   pragma Inline (Is_Assignable);
7879   pragma Inline (Is_Asynchronous);
7880   pragma Inline (Is_Atomic);
7881   pragma Inline (Is_Bit_Packed_Array);
7882   pragma Inline (Is_CPP_Class);
7883   pragma Inline (Is_Called);
7884   pragma Inline (Is_Character_Type);
7885   pragma Inline (Is_Child_Unit);
7886   pragma Inline (Is_Class_Wide_Equivalent_Type);
7887   pragma Inline (Is_Class_Wide_Type);
7888   pragma Inline (Is_Compilation_Unit);
7889   pragma Inline (Is_Completely_Hidden);
7890   pragma Inline (Is_Composite_Type);
7891   pragma Inline (Is_Concurrent_Body);
7892   pragma Inline (Is_Concurrent_Record_Type);
7893   pragma Inline (Is_Concurrent_Type);
7894   pragma Inline (Is_Constr_Subt_For_UN_Aliased);
7895   pragma Inline (Is_Constr_Subt_For_U_Nominal);
7896   pragma Inline (Is_Constrained);
7897   pragma Inline (Is_Constructor);
7898   pragma Inline (Is_Controlled);
7899   pragma Inline (Is_Controlling_Formal);
7900   pragma Inline (Is_Decimal_Fixed_Point_Type);
7901   pragma Inline (Is_Descendent_Of_Address);
7902   pragma Inline (Is_Digits_Type);
7903   pragma Inline (Is_Discrete_Or_Fixed_Point_Type);
7904   pragma Inline (Is_Discrete_Type);
7905   pragma Inline (Is_Discrim_SO_Function);
7906   pragma Inline (Is_Discriminant_Check_Function);
7907   pragma Inline (Is_Dispatch_Table_Entity);
7908   pragma Inline (Is_Dispatching_Operation);
7909   pragma Inline (Is_Elementary_Type);
7910   pragma Inline (Is_Eliminated);
7911   pragma Inline (Is_Entry);
7912   pragma Inline (Is_Entry_Formal);
7913   pragma Inline (Is_Enumeration_Type);
7914   pragma Inline (Is_Exported);
7915   pragma Inline (Is_First_Subtype);
7916   pragma Inline (Is_Fixed_Point_Type);
7917   pragma Inline (Is_Floating_Point_Type);
7918   pragma Inline (Is_For_Access_Subtype);
7919   pragma Inline (Is_Formal);
7920   pragma Inline (Is_Formal_Object);
7921   pragma Inline (Is_Formal_Subprogram);
7922   pragma Inline (Is_Frozen);
7923   pragma Inline (Is_Generic_Actual_Type);
7924   pragma Inline (Is_Generic_Instance);
7925   pragma Inline (Is_Generic_Subprogram);
7926   pragma Inline (Is_Generic_Type);
7927   pragma Inline (Is_Generic_Unit);
7928   pragma Inline (Is_Hidden);
7929   pragma Inline (Is_Hidden_Open_Scope);
7930   pragma Inline (Is_Immediately_Visible);
7931   pragma Inline (Is_Implementation_Defined);
7932   pragma Inline (Is_Imported);
7933   pragma Inline (Is_Incomplete_Or_Private_Type);
7934   pragma Inline (Is_Incomplete_Type);
7935   pragma Inline (Is_Inlined);
7936   pragma Inline (Is_Instantiated);
7937   pragma Inline (Is_Integer_Type);
7938   pragma Inline (Is_Interface);
7939   pragma Inline (Is_Internal);
7940   pragma Inline (Is_Interrupt_Handler);
7941   pragma Inline (Is_Intrinsic_Subprogram);
7942   pragma Inline (Is_Invariant_Procedure);
7943   pragma Inline (Is_Itype);
7944   pragma Inline (Is_Known_Non_Null);
7945   pragma Inline (Is_Known_Null);
7946   pragma Inline (Is_Known_Valid);
7947   pragma Inline (Is_Limited_Composite);
7948   pragma Inline (Is_Limited_Interface);
7949   pragma Inline (Is_Limited_Record);
7950   pragma Inline (Is_Local_Anonymous_Access);
7951   pragma Inline (Is_Machine_Code_Subprogram);
7952   pragma Inline (Is_Modular_Integer_Type);
7953   pragma Inline (Is_Named_Number);
7954   pragma Inline (Is_Non_Static_Subtype);
7955   pragma Inline (Is_Null_Init_Proc);
7956   pragma Inline (Is_Numeric_Type);
7957   pragma Inline (Is_Object);
7958   pragma Inline (Is_Obsolescent);
7959   pragma Inline (Is_Only_Out_Parameter);
7960   pragma Inline (Is_Optional_Parameter);
7961   pragma Inline (Is_Ordinary_Fixed_Point_Type);
7962   pragma Inline (Is_Overloadable);
7963   pragma Inline (Is_Package_Body_Entity);
7964   pragma Inline (Is_Packed);
7965   pragma Inline (Is_Packed_Array_Type);
7966   pragma Inline (Is_Potentially_Use_Visible);
7967   pragma Inline (Is_Predicate_Function);
7968   pragma Inline (Is_Predicate_Function_M);
7969   pragma Inline (Is_Preelaborated);
7970   pragma Inline (Is_Primitive);
7971   pragma Inline (Is_Primitive_Wrapper);
7972   pragma Inline (Is_Private_Composite);
7973   pragma Inline (Is_Private_Descendant);
7974   pragma Inline (Is_Private_Primitive);
7975   pragma Inline (Is_Private_Type);
7976   pragma Inline (Is_Processed_Transient);
7977   pragma Inline (Is_Protected_Type);
7978   pragma Inline (Is_Public);
7979   pragma Inline (Is_Pure);
7980   pragma Inline (Is_Pure_Unit_Access_Type);
7981   pragma Inline (Is_RACW_Stub_Type);
7982   pragma Inline (Is_Raised);
7983   pragma Inline (Is_Real_Type);
7984   pragma Inline (Is_Record_Type);
7985   pragma Inline (Is_Remote_Call_Interface);
7986   pragma Inline (Is_Remote_Types);
7987   pragma Inline (Is_Renaming_Of_Object);
7988   pragma Inline (Is_Return_Object);
7989   pragma Inline (Is_Safe_To_Reevaluate);
7990   pragma Inline (Is_Scalar_Type);
7991   pragma Inline (Is_Shared_Passive);
7992   pragma Inline (Is_Signed_Integer_Type);
7993   pragma Inline (Is_Statically_Allocated);
7994   pragma Inline (Is_Subprogram);
7995   pragma Inline (Is_Tag);
7996   pragma Inline (Is_Tagged_Type);
7997   pragma Inline (Is_Task_Type);
7998   pragma Inline (Is_Thunk);
7999   pragma Inline (Is_Trivial_Subprogram);
8000   pragma Inline (Is_True_Constant);
8001   pragma Inline (Is_Type);
8002   pragma Inline (Is_Unchecked_Union);
8003   pragma Inline (Is_Underlying_Record_View);
8004   pragma Inline (Is_Unsigned_Type);
8005   pragma Inline (Is_VMS_Exception);
8006   pragma Inline (Is_Valued_Procedure);
8007   pragma Inline (Is_Visible_Formal);
8008   pragma Inline (Is_Visible_Lib_Unit);
8009   pragma Inline (Itype_Printed);
8010   pragma Inline (Kill_Elaboration_Checks);
8011   pragma Inline (Kill_Range_Checks);
8012   pragma Inline (Known_To_Have_Preelab_Init);
8013   pragma Inline (Last_Aggregate_Assignment);
8014   pragma Inline (Last_Assignment);
8015   pragma Inline (Last_Entity);
8016   pragma Inline (Limited_View);
8017   pragma Inline (Linker_Section_Pragma);
8018   pragma Inline (Lit_Indexes);
8019   pragma Inline (Lit_Strings);
8020   pragma Inline (Low_Bound_Tested);
8021   pragma Inline (Machine_Radix_10);
8022   pragma Inline (Master_Id);
8023   pragma Inline (Materialize_Entity);
8024   pragma Inline (May_Inherit_Delayed_Rep_Aspects);
8025   pragma Inline (Mechanism);
8026   pragma Inline (Modulus);
8027   pragma Inline (Must_Be_On_Byte_Boundary);
8028   pragma Inline (Must_Have_Preelab_Init);
8029   pragma Inline (Needs_Debug_Info);
8030   pragma Inline (Needs_No_Actuals);
8031   pragma Inline (Never_Set_In_Source);
8032   pragma Inline (Next_Index);
8033   pragma Inline (Next_Inlined_Subprogram);
8034   pragma Inline (Next_Literal);
8035   pragma Inline (No_Pool_Assigned);
8036   pragma Inline (No_Return);
8037   pragma Inline (No_Strict_Aliasing);
8038   pragma Inline (Non_Binary_Modulus);
8039   pragma Inline (Non_Limited_View);
8040   pragma Inline (Nonzero_Is_True);
8041   pragma Inline (Normalized_First_Bit);
8042   pragma Inline (Normalized_Position);
8043   pragma Inline (Normalized_Position_Max);
8044   pragma Inline (OK_To_Rename);
8045   pragma Inline (OK_To_Reorder_Components);
8046   pragma Inline (Optimize_Alignment_Space);
8047   pragma Inline (Optimize_Alignment_Time);
8048   pragma Inline (Original_Access_Type);
8049   pragma Inline (Original_Array_Type);
8050   pragma Inline (Original_Record_Component);
8051   pragma Inline (Overlays_Constant);
8052   pragma Inline (Overridden_Operation);
8053   pragma Inline (PPC_Wrapper);
8054   pragma Inline (Package_Instantiation);
8055   pragma Inline (Packed_Array_Type);
8056   pragma Inline (Parameter_Mode);
8057   pragma Inline (Parent_Subtype);
8058   pragma Inline (Part_Of_Constituents);
8059   pragma Inline (Postcondition_Proc);
8060   pragma Inline (Prival);
8061   pragma Inline (Prival_Link);
8062   pragma Inline (Private_Dependents);
8063   pragma Inline (Private_View);
8064   pragma Inline (Protected_Body_Subprogram);
8065   pragma Inline (Protected_Formal);
8066   pragma Inline (Protection_Object);
8067   pragma Inline (RM_Size);
8068   pragma Inline (Reachable);
8069   pragma Inline (Referenced);
8070   pragma Inline (Referenced_As_LHS);
8071   pragma Inline (Referenced_As_Out_Parameter);
8072   pragma Inline (Refinement_Constituents);
8073   pragma Inline (Register_Exception_Call);
8074   pragma Inline (Related_Array_Object);
8075   pragma Inline (Related_Expression);
8076   pragma Inline (Related_Instance);
8077   pragma Inline (Related_Type);
8078   pragma Inline (Relative_Deadline_Variable);
8079   pragma Inline (Renamed_Entity);
8080   pragma Inline (Renamed_In_Spec);
8081   pragma Inline (Renamed_Object);
8082   pragma Inline (Renaming_Map);
8083   pragma Inline (Requires_Overriding);
8084   pragma Inline (Return_Applies_To);
8085   pragma Inline (Return_Present);
8086   pragma Inline (Returns_By_Ref);
8087   pragma Inline (Reverse_Bit_Order);
8088   pragma Inline (Reverse_Storage_Order);
8089   pragma Inline (Scalar_Range);
8090   pragma Inline (Scale_Value);
8091   pragma Inline (Scope_Depth_Value);
8092   pragma Inline (Sec_Stack_Needed_For_Return);
8093   pragma Inline (Shadow_Entities);
8094   pragma Inline (Shared_Var_Procs_Instance);
8095   pragma Inline (Size_Check_Code);
8096   pragma Inline (Size_Depends_On_Discriminant);
8097   pragma Inline (Size_Known_At_Compile_Time);
8098   pragma Inline (Small_Value);
8099   pragma Inline (SPARK_Aux_Pragma);
8100   pragma Inline (SPARK_Aux_Pragma_Inherited);
8101   pragma Inline (SPARK_Pragma);
8102   pragma Inline (SPARK_Pragma_Inherited);
8103   pragma Inline (Spec_Entity);
8104   pragma Inline (Static_Elaboration_Desired);
8105   pragma Inline (Static_Initialization);
8106   pragma Inline (Static_Predicate);
8107   pragma Inline (Status_Flag_Or_Transient_Decl);
8108   pragma Inline (Storage_Size_Variable);
8109   pragma Inline (Stored_Constraint);
8110   pragma Inline (Strict_Alignment);
8111   pragma Inline (String_Literal_Length);
8112   pragma Inline (String_Literal_Low_Bound);
8113   pragma Inline (Subprograms_For_Type);
8114   pragma Inline (Suppress_Elaboration_Warnings);
8115   pragma Inline (Suppress_Initialization);
8116   pragma Inline (Suppress_Style_Checks);
8117   pragma Inline (Suppress_Value_Tracking_On_Call);
8118   pragma Inline (Task_Body_Procedure);
8119   pragma Inline (Thunk_Entity);
8120   pragma Inline (Treat_As_Volatile);
8121   pragma Inline (Underlying_Full_View);
8122   pragma Inline (Underlying_Record_View);
8123   pragma Inline (Universal_Aliasing);
8124   pragma Inline (Unset_Reference);
8125   pragma Inline (Used_As_Generic_Actual);
8126   pragma Inline (Uses_Lock_Free);
8127   pragma Inline (Uses_Sec_Stack);
8128   pragma Inline (Warnings_Off);
8129   pragma Inline (Warnings_Off_Used);
8130   pragma Inline (Warnings_Off_Used_Unmodified);
8131   pragma Inline (Warnings_Off_Used_Unreferenced);
8132   pragma Inline (Was_Hidden);
8133   pragma Inline (Wrapped_Entity);
8134
8135   pragma Inline (Init_Alignment);
8136   pragma Inline (Init_Component_Bit_Offset);
8137   pragma Inline (Init_Component_Size);
8138   pragma Inline (Init_Digits_Value);
8139   pragma Inline (Init_Esize);
8140   pragma Inline (Init_RM_Size);
8141
8142   pragma Inline (Set_Abstract_States);
8143   pragma Inline (Set_Accept_Address);
8144   pragma Inline (Set_Access_Disp_Table);
8145   pragma Inline (Set_Actual_Subtype);
8146   pragma Inline (Set_Address_Taken);
8147   pragma Inline (Set_Alias);
8148   pragma Inline (Set_Alignment);
8149   pragma Inline (Set_Associated_Formal_Package);
8150   pragma Inline (Set_Associated_Node_For_Itype);
8151   pragma Inline (Set_Associated_Storage_Pool);
8152   pragma Inline (Set_Barrier_Function);
8153   pragma Inline (Set_Block_Node);
8154   pragma Inline (Set_Body_Entity);
8155   pragma Inline (Set_Body_Needed_For_SAL);
8156   pragma Inline (Set_Body_References);
8157   pragma Inline (Set_BIP_Initialization_Call);
8158   pragma Inline (Set_CR_Discriminant);
8159   pragma Inline (Set_C_Pass_By_Copy);
8160   pragma Inline (Set_Can_Never_Be_Null);
8161   pragma Inline (Set_Can_Use_Internal_Rep);
8162   pragma Inline (Set_Checks_May_Be_Suppressed);
8163   pragma Inline (Set_Class_Wide_Type);
8164   pragma Inline (Set_Cloned_Subtype);
8165   pragma Inline (Set_Component_Bit_Offset);
8166   pragma Inline (Set_Component_Clause);
8167   pragma Inline (Set_Component_Size);
8168   pragma Inline (Set_Component_Type);
8169   pragma Inline (Set_Contract);
8170   pragma Inline (Set_Corresponding_Concurrent_Type);
8171   pragma Inline (Set_Corresponding_Discriminant);
8172   pragma Inline (Set_Corresponding_Equality);
8173   pragma Inline (Set_Corresponding_Protected_Entry);
8174   pragma Inline (Set_Corresponding_Record_Type);
8175   pragma Inline (Set_Corresponding_Remote_Type);
8176   pragma Inline (Set_Current_Use_Clause);
8177   pragma Inline (Set_Current_Value);
8178   pragma Inline (Set_DTC_Entity);
8179   pragma Inline (Set_DT_Entry_Count);
8180   pragma Inline (Set_DT_Offset_To_Top_Func);
8181   pragma Inline (Set_DT_Position);
8182   pragma Inline (Set_Debug_Info_Off);
8183   pragma Inline (Set_Debug_Renaming_Link);
8184   pragma Inline (Set_Default_Aspect_Component_Value);
8185   pragma Inline (Set_Default_Aspect_Value);
8186   pragma Inline (Set_Default_Expr_Function);
8187   pragma Inline (Set_Default_Expressions_Processed);
8188   pragma Inline (Set_Default_Value);
8189   pragma Inline (Set_Delay_Cleanups);
8190   pragma Inline (Set_Delay_Subprogram_Descriptors);
8191   pragma Inline (Set_Delta_Value);
8192   pragma Inline (Set_Dependent_Instances);
8193   pragma Inline (Set_Depends_On_Private);
8194   pragma Inline (Set_Digits_Value);
8195   pragma Inline (Set_Direct_Primitive_Operations);
8196   pragma Inline (Set_Directly_Designated_Type);
8197   pragma Inline (Set_Discard_Names);
8198   pragma Inline (Set_Discriminal);
8199   pragma Inline (Set_Discriminal_Link);
8200   pragma Inline (Set_Discriminant_Checking_Func);
8201   pragma Inline (Set_Discriminant_Constraint);
8202   pragma Inline (Set_Discriminant_Default_Value);
8203   pragma Inline (Set_Discriminant_Number);
8204   pragma Inline (Set_Dispatch_Table_Wrappers);
8205   pragma Inline (Set_Elaborate_Body_Desirable);
8206   pragma Inline (Set_Elaboration_Entity);
8207   pragma Inline (Set_Elaboration_Entity_Required);
8208   pragma Inline (Set_Encapsulating_State);
8209   pragma Inline (Set_Enclosing_Scope);
8210   pragma Inline (Set_Entry_Accepted);
8211   pragma Inline (Set_Entry_Bodies_Array);
8212   pragma Inline (Set_Entry_Cancel_Parameter);
8213   pragma Inline (Set_Entry_Component);
8214   pragma Inline (Set_Entry_Formal);
8215   pragma Inline (Set_Entry_Parameters_Type);
8216   pragma Inline (Set_Enum_Pos_To_Rep);
8217   pragma Inline (Set_Enumeration_Pos);
8218   pragma Inline (Set_Enumeration_Rep);
8219   pragma Inline (Set_Enumeration_Rep_Expr);
8220   pragma Inline (Set_Equivalent_Type);
8221   pragma Inline (Set_Esize);
8222   pragma Inline (Set_Exception_Code);
8223   pragma Inline (Set_Extra_Accessibility);
8224   pragma Inline (Set_Extra_Accessibility_Of_Result);
8225   pragma Inline (Set_Extra_Constrained);
8226   pragma Inline (Set_Extra_Formal);
8227   pragma Inline (Set_Extra_Formals);
8228   pragma Inline (Set_Finalization_Master);
8229   pragma Inline (Set_Finalizer);
8230   pragma Inline (Set_First_Entity);
8231   pragma Inline (Set_First_Exit_Statement);
8232   pragma Inline (Set_First_Index);
8233   pragma Inline (Set_First_Literal);
8234   pragma Inline (Set_First_Optional_Parameter);
8235   pragma Inline (Set_First_Private_Entity);
8236   pragma Inline (Set_First_Rep_Item);
8237   pragma Inline (Set_Freeze_Node);
8238   pragma Inline (Set_From_Limited_With);
8239   pragma Inline (Set_Full_View);
8240   pragma Inline (Set_Generic_Homonym);
8241   pragma Inline (Set_Generic_Renamings);
8242   pragma Inline (Set_Handler_Records);
8243   pragma Inline (Set_Has_Aliased_Components);
8244   pragma Inline (Set_Has_Alignment_Clause);
8245   pragma Inline (Set_Has_All_Calls_Remote);
8246   pragma Inline (Set_Has_Anonymous_Master);
8247   pragma Inline (Set_Has_Atomic_Components);
8248   pragma Inline (Set_Has_Biased_Representation);
8249   pragma Inline (Set_Has_Completion);
8250   pragma Inline (Set_Has_Completion_In_Body);
8251   pragma Inline (Set_Has_Complex_Representation);
8252   pragma Inline (Set_Has_Component_Size_Clause);
8253   pragma Inline (Set_Has_Constrained_Partial_View);
8254   pragma Inline (Set_Has_Contiguous_Rep);
8255   pragma Inline (Set_Has_Controlled_Component);
8256   pragma Inline (Set_Has_Controlling_Result);
8257   pragma Inline (Set_Has_Convention_Pragma);
8258   pragma Inline (Set_Has_Default_Aspect);
8259   pragma Inline (Set_Has_Delayed_Aspects);
8260   pragma Inline (Set_Has_Delayed_Freeze);
8261   pragma Inline (Set_Has_Delayed_Rep_Aspects);
8262   pragma Inline (Set_Has_Discriminants);
8263   pragma Inline (Set_Has_Dispatch_Table);
8264   pragma Inline (Set_Has_Dynamic_Predicate_Aspect);
8265   pragma Inline (Set_Has_Enumeration_Rep_Clause);
8266   pragma Inline (Set_Has_Exit);
8267   pragma Inline (Set_Has_External_Tag_Rep_Clause);
8268   pragma Inline (Set_Has_Forward_Instantiation);
8269   pragma Inline (Set_Has_Fully_Qualified_Name);
8270   pragma Inline (Set_Has_Gigi_Rep_Item);
8271   pragma Inline (Set_Has_Homonym);
8272   pragma Inline (Set_Has_Implicit_Dereference);
8273   pragma Inline (Set_Has_Independent_Components);
8274   pragma Inline (Set_Has_Inheritable_Invariants);
8275   pragma Inline (Set_Has_Initial_Value);
8276   pragma Inline (Set_Has_Invariants);
8277   pragma Inline (Set_Has_Loop_Entry_Attributes);
8278   pragma Inline (Set_Has_Machine_Radix_Clause);
8279   pragma Inline (Set_Has_Master_Entity);
8280   pragma Inline (Set_Has_Missing_Return);
8281   pragma Inline (Set_Has_Nested_Block_With_Handler);
8282   pragma Inline (Set_Has_Non_Standard_Rep);
8283   pragma Inline (Set_Has_Object_Size_Clause);
8284   pragma Inline (Set_Has_Per_Object_Constraint);
8285   pragma Inline (Set_Has_Postconditions);
8286   pragma Inline (Set_Has_Pragma_Controlled);
8287   pragma Inline (Set_Has_Pragma_Elaborate_Body);
8288   pragma Inline (Set_Has_Pragma_Inline);
8289   pragma Inline (Set_Has_Pragma_Inline_Always);
8290   pragma Inline (Set_Has_Pragma_No_Inline);
8291   pragma Inline (Set_Has_Pragma_Ordered);
8292   pragma Inline (Set_Has_Pragma_Pack);
8293   pragma Inline (Set_Has_Pragma_Preelab_Init);
8294   pragma Inline (Set_Has_Pragma_Pure);
8295   pragma Inline (Set_Has_Pragma_Pure_Function);
8296   pragma Inline (Set_Has_Pragma_Thread_Local_Storage);
8297   pragma Inline (Set_Has_Pragma_Unmodified);
8298   pragma Inline (Set_Has_Pragma_Unreferenced);
8299   pragma Inline (Set_Has_Pragma_Unreferenced_Objects);
8300   pragma Inline (Set_Has_Predicates);
8301   pragma Inline (Set_Has_Primitive_Operations);
8302   pragma Inline (Set_Has_Private_Ancestor);
8303   pragma Inline (Set_Has_Private_Declaration);
8304   pragma Inline (Set_Has_Qualified_Name);
8305   pragma Inline (Set_Has_RACW);
8306   pragma Inline (Set_Has_Record_Rep_Clause);
8307   pragma Inline (Set_Has_Recursive_Call);
8308   pragma Inline (Set_Has_Shift_Operator);
8309   pragma Inline (Set_Has_Size_Clause);
8310   pragma Inline (Set_Has_Small_Clause);
8311   pragma Inline (Set_Has_Specified_Layout);
8312   pragma Inline (Set_Has_Specified_Stream_Input);
8313   pragma Inline (Set_Has_Specified_Stream_Output);
8314   pragma Inline (Set_Has_Specified_Stream_Read);
8315   pragma Inline (Set_Has_Specified_Stream_Write);
8316   pragma Inline (Set_Has_Static_Discriminants);
8317   pragma Inline (Set_Has_Static_Predicate_Aspect);
8318   pragma Inline (Set_Has_Storage_Size_Clause);
8319   pragma Inline (Set_Has_Stream_Size_Clause);
8320   pragma Inline (Set_Has_Task);
8321   pragma Inline (Set_Has_Thunks);
8322   pragma Inline (Set_Has_Unchecked_Union);
8323   pragma Inline (Set_Has_Unknown_Discriminants);
8324   pragma Inline (Set_Has_Up_Level_Access);
8325   pragma Inline (Set_Has_Visible_Refinement);
8326   pragma Inline (Set_Has_Volatile_Components);
8327   pragma Inline (Set_Has_Xref_Entry);
8328   pragma Inline (Set_Hiding_Loop_Variable);
8329   pragma Inline (Set_Homonym);
8330   pragma Inline (Set_Import_Pragma);
8331   pragma Inline (Set_In_Package_Body);
8332   pragma Inline (Set_In_Private_Part);
8333   pragma Inline (Set_In_Use);
8334   pragma Inline (Set_Inner_Instances);
8335   pragma Inline (Set_Interface_Alias);
8336   pragma Inline (Set_Interface_Name);
8337   pragma Inline (Set_Interfaces);
8338   pragma Inline (Set_Is_AST_Entry);
8339   pragma Inline (Set_Is_Abstract_Subprogram);
8340   pragma Inline (Set_Is_Abstract_Type);
8341   pragma Inline (Set_Is_Access_Constant);
8342   pragma Inline (Set_Is_Ada_2005_Only);
8343   pragma Inline (Set_Is_Ada_2012_Only);
8344   pragma Inline (Set_Is_Aliased);
8345   pragma Inline (Set_Is_Asynchronous);
8346   pragma Inline (Set_Is_Atomic);
8347   pragma Inline (Set_Is_Bit_Packed_Array);
8348   pragma Inline (Set_Is_CPP_Class);
8349   pragma Inline (Set_Is_Called);
8350   pragma Inline (Set_Is_Character_Type);
8351   pragma Inline (Set_Is_Child_Unit);
8352   pragma Inline (Set_Is_Class_Wide_Equivalent_Type);
8353   pragma Inline (Set_Is_Compilation_Unit);
8354   pragma Inline (Set_Is_Completely_Hidden);
8355   pragma Inline (Set_Is_Concurrent_Record_Type);
8356   pragma Inline (Set_Is_Constr_Subt_For_UN_Aliased);
8357   pragma Inline (Set_Is_Constr_Subt_For_U_Nominal);
8358   pragma Inline (Set_Is_Constrained);
8359   pragma Inline (Set_Is_Constructor);
8360   pragma Inline (Set_Is_Controlled);
8361   pragma Inline (Set_Is_Controlling_Formal);
8362   pragma Inline (Set_Is_Descendent_Of_Address);
8363   pragma Inline (Set_Is_Discrim_SO_Function);
8364   pragma Inline (Set_Is_Discriminant_Check_Function);
8365   pragma Inline (Set_Is_Dispatch_Table_Entity);
8366   pragma Inline (Set_Is_Dispatching_Operation);
8367   pragma Inline (Set_Is_Eliminated);
8368   pragma Inline (Set_Is_Entry_Formal);
8369   pragma Inline (Set_Is_Exported);
8370   pragma Inline (Set_Is_First_Subtype);
8371   pragma Inline (Set_Is_For_Access_Subtype);
8372   pragma Inline (Set_Is_Formal_Subprogram);
8373   pragma Inline (Set_Is_Frozen);
8374   pragma Inline (Set_Is_Generic_Actual_Type);
8375   pragma Inline (Set_Is_Generic_Instance);
8376   pragma Inline (Set_Is_Generic_Type);
8377   pragma Inline (Set_Is_Hidden);
8378   pragma Inline (Set_Is_Hidden_Open_Scope);
8379   pragma Inline (Set_Is_Immediately_Visible);
8380   pragma Inline (Set_Is_Implementation_Defined);
8381   pragma Inline (Set_Is_Imported);
8382   pragma Inline (Set_Is_Inlined);
8383   pragma Inline (Set_Is_Instantiated);
8384   pragma Inline (Set_Is_Interface);
8385   pragma Inline (Set_Is_Internal);
8386   pragma Inline (Set_Is_Interrupt_Handler);
8387   pragma Inline (Set_Is_Intrinsic_Subprogram);
8388   pragma Inline (Set_Is_Invariant_Procedure);
8389   pragma Inline (Set_Is_Itype);
8390   pragma Inline (Set_Is_Known_Non_Null);
8391   pragma Inline (Set_Is_Known_Null);
8392   pragma Inline (Set_Is_Known_Valid);
8393   pragma Inline (Set_Is_Limited_Composite);
8394   pragma Inline (Set_Is_Limited_Interface);
8395   pragma Inline (Set_Is_Limited_Record);
8396   pragma Inline (Set_Is_Local_Anonymous_Access);
8397   pragma Inline (Set_Is_Machine_Code_Subprogram);
8398   pragma Inline (Set_Is_Non_Static_Subtype);
8399   pragma Inline (Set_Is_Null_Init_Proc);
8400   pragma Inline (Set_Is_Obsolescent);
8401   pragma Inline (Set_Is_Only_Out_Parameter);
8402   pragma Inline (Set_Is_Optional_Parameter);
8403   pragma Inline (Set_Is_Package_Body_Entity);
8404   pragma Inline (Set_Is_Packed);
8405   pragma Inline (Set_Is_Packed_Array_Type);
8406   pragma Inline (Set_Is_Potentially_Use_Visible);
8407   pragma Inline (Set_Is_Predicate_Function);
8408   pragma Inline (Set_Is_Predicate_Function_M);
8409   pragma Inline (Set_Is_Preelaborated);
8410   pragma Inline (Set_Is_Primitive);
8411   pragma Inline (Set_Is_Primitive_Wrapper);
8412   pragma Inline (Set_Is_Private_Composite);
8413   pragma Inline (Set_Is_Private_Descendant);
8414   pragma Inline (Set_Is_Private_Primitive);
8415   pragma Inline (Set_Is_Processed_Transient);
8416   pragma Inline (Set_Is_Public);
8417   pragma Inline (Set_Is_Pure);
8418   pragma Inline (Set_Is_Pure_Unit_Access_Type);
8419   pragma Inline (Set_Is_RACW_Stub_Type);
8420   pragma Inline (Set_Is_Raised);
8421   pragma Inline (Set_Is_Remote_Call_Interface);
8422   pragma Inline (Set_Is_Remote_Types);
8423   pragma Inline (Set_Is_Renaming_Of_Object);
8424   pragma Inline (Set_Is_Return_Object);
8425   pragma Inline (Set_Is_Safe_To_Reevaluate);
8426   pragma Inline (Set_Is_Shared_Passive);
8427   pragma Inline (Set_Is_Statically_Allocated);
8428   pragma Inline (Set_Is_Tag);
8429   pragma Inline (Set_Is_Tagged_Type);
8430   pragma Inline (Set_Is_Thunk);
8431   pragma Inline (Set_Is_Trivial_Subprogram);
8432   pragma Inline (Set_Is_True_Constant);
8433   pragma Inline (Set_Is_Unchecked_Union);
8434   pragma Inline (Set_Is_Underlying_Record_View);
8435   pragma Inline (Set_Is_Unsigned_Type);
8436   pragma Inline (Set_Is_VMS_Exception);
8437   pragma Inline (Set_Is_Valued_Procedure);
8438   pragma Inline (Set_Is_Visible_Formal);
8439   pragma Inline (Set_Is_Visible_Lib_Unit);
8440   pragma Inline (Set_Is_Volatile);
8441   pragma Inline (Set_Itype_Printed);
8442   pragma Inline (Set_Kill_Elaboration_Checks);
8443   pragma Inline (Set_Kill_Range_Checks);
8444   pragma Inline (Set_Known_To_Have_Preelab_Init);
8445   pragma Inline (Set_Last_Aggregate_Assignment);
8446   pragma Inline (Set_Last_Assignment);
8447   pragma Inline (Set_Last_Entity);
8448   pragma Inline (Set_Limited_View);
8449   pragma Inline (Set_Linker_Section_Pragma);
8450   pragma Inline (Set_Lit_Indexes);
8451   pragma Inline (Set_Lit_Strings);
8452   pragma Inline (Set_Low_Bound_Tested);
8453   pragma Inline (Set_Machine_Radix_10);
8454   pragma Inline (Set_Master_Id);
8455   pragma Inline (Set_Materialize_Entity);
8456   pragma Inline (Set_May_Inherit_Delayed_Rep_Aspects);
8457   pragma Inline (Set_Mechanism);
8458   pragma Inline (Set_Modulus);
8459   pragma Inline (Set_Must_Be_On_Byte_Boundary);
8460   pragma Inline (Set_Must_Have_Preelab_Init);
8461   pragma Inline (Set_Needs_Debug_Info);
8462   pragma Inline (Set_Needs_No_Actuals);
8463   pragma Inline (Set_Never_Set_In_Source);
8464   pragma Inline (Set_Next_Inlined_Subprogram);
8465   pragma Inline (Set_No_Pool_Assigned);
8466   pragma Inline (Set_No_Return);
8467   pragma Inline (Set_No_Strict_Aliasing);
8468   pragma Inline (Set_Non_Binary_Modulus);
8469   pragma Inline (Set_Non_Limited_View);
8470   pragma Inline (Set_Nonzero_Is_True);
8471   pragma Inline (Set_Normalized_First_Bit);
8472   pragma Inline (Set_Normalized_Position);
8473   pragma Inline (Set_Normalized_Position_Max);
8474   pragma Inline (Set_OK_To_Rename);
8475   pragma Inline (Set_OK_To_Reorder_Components);
8476   pragma Inline (Set_Optimize_Alignment_Space);
8477   pragma Inline (Set_Optimize_Alignment_Time);
8478   pragma Inline (Set_Original_Access_Type);
8479   pragma Inline (Set_Original_Array_Type);
8480   pragma Inline (Set_Original_Record_Component);
8481   pragma Inline (Set_Overlays_Constant);
8482   pragma Inline (Set_Overridden_Operation);
8483   pragma Inline (Set_PPC_Wrapper);
8484   pragma Inline (Set_Package_Instantiation);
8485   pragma Inline (Set_Packed_Array_Type);
8486   pragma Inline (Set_Parent_Subtype);
8487   pragma Inline (Set_Part_Of_Constituents);
8488   pragma Inline (Set_Postcondition_Proc);
8489   pragma Inline (Set_Prival);
8490   pragma Inline (Set_Prival_Link);
8491   pragma Inline (Set_Private_Dependents);
8492   pragma Inline (Set_Private_View);
8493   pragma Inline (Set_Protected_Body_Subprogram);
8494   pragma Inline (Set_Protected_Formal);
8495   pragma Inline (Set_Protection_Object);
8496   pragma Inline (Set_RM_Size);
8497   pragma Inline (Set_Reachable);
8498   pragma Inline (Set_Referenced);
8499   pragma Inline (Set_Referenced_As_LHS);
8500   pragma Inline (Set_Referenced_As_Out_Parameter);
8501   pragma Inline (Set_Refinement_Constituents);
8502   pragma Inline (Set_Register_Exception_Call);
8503   pragma Inline (Set_Related_Array_Object);
8504   pragma Inline (Set_Related_Expression);
8505   pragma Inline (Set_Related_Instance);
8506   pragma Inline (Set_Related_Type);
8507   pragma Inline (Set_Relative_Deadline_Variable);
8508   pragma Inline (Set_Renamed_Entity);
8509   pragma Inline (Set_Renamed_In_Spec);
8510   pragma Inline (Set_Renamed_Object);
8511   pragma Inline (Set_Renaming_Map);
8512   pragma Inline (Set_Requires_Overriding);
8513   pragma Inline (Set_Return_Applies_To);
8514   pragma Inline (Set_Return_Present);
8515   pragma Inline (Set_Returns_By_Ref);
8516   pragma Inline (Set_Reverse_Bit_Order);
8517   pragma Inline (Set_Reverse_Storage_Order);
8518   pragma Inline (Set_Scalar_Range);
8519   pragma Inline (Set_Scale_Value);
8520   pragma Inline (Set_Scope_Depth_Value);
8521   pragma Inline (Set_Sec_Stack_Needed_For_Return);
8522   pragma Inline (Set_Shadow_Entities);
8523   pragma Inline (Set_Shared_Var_Procs_Instance);
8524   pragma Inline (Set_Size_Check_Code);
8525   pragma Inline (Set_Size_Depends_On_Discriminant);
8526   pragma Inline (Set_Size_Known_At_Compile_Time);
8527   pragma Inline (Set_Small_Value);
8528   pragma Inline (Set_SPARK_Aux_Pragma);
8529   pragma Inline (Set_SPARK_Aux_Pragma_Inherited);
8530   pragma Inline (Set_SPARK_Pragma);
8531   pragma Inline (Set_SPARK_Pragma_Inherited);
8532   pragma Inline (Set_Spec_Entity);
8533   pragma Inline (Set_Static_Elaboration_Desired);
8534   pragma Inline (Set_Static_Initialization);
8535   pragma Inline (Set_Static_Predicate);
8536   pragma Inline (Set_Status_Flag_Or_Transient_Decl);
8537   pragma Inline (Set_Storage_Size_Variable);
8538   pragma Inline (Set_Stored_Constraint);
8539   pragma Inline (Set_Strict_Alignment);
8540   pragma Inline (Set_String_Literal_Length);
8541   pragma Inline (Set_String_Literal_Low_Bound);
8542   pragma Inline (Set_Subprograms_For_Type);
8543   pragma Inline (Set_Suppress_Elaboration_Warnings);
8544   pragma Inline (Set_Suppress_Initialization);
8545   pragma Inline (Set_Suppress_Style_Checks);
8546   pragma Inline (Set_Suppress_Value_Tracking_On_Call);
8547   pragma Inline (Set_Task_Body_Procedure);
8548   pragma Inline (Set_Thunk_Entity);
8549   pragma Inline (Set_Treat_As_Volatile);
8550   pragma Inline (Set_Underlying_Full_View);
8551   pragma Inline (Set_Underlying_Record_View);
8552   pragma Inline (Set_Universal_Aliasing);
8553   pragma Inline (Set_Unset_Reference);
8554   pragma Inline (Set_Used_As_Generic_Actual);
8555   pragma Inline (Set_Uses_Lock_Free);
8556   pragma Inline (Set_Uses_Sec_Stack);
8557   pragma Inline (Set_Warnings_Off);
8558   pragma Inline (Set_Warnings_Off_Used);
8559   pragma Inline (Set_Warnings_Off_Used_Unmodified);
8560   pragma Inline (Set_Warnings_Off_Used_Unreferenced);
8561   pragma Inline (Set_Was_Hidden);
8562   pragma Inline (Set_Wrapped_Entity);
8563
8564   --  END XEINFO INLINES
8565
8566   --  The following Inline pragmas are *not* read by xeinfo when building
8567   --  the C version of this interface automatically (so the C version will
8568   --  end up making out of line calls). The pragma scan in xeinfo will be
8569   --  terminated on encountering the END XEINFO INLINES line. We inline
8570   --  things here which are small, but not of the canonical attribute
8571   --  access/set format that can be handled by xeinfo.
8572
8573   pragma Inline (Base_Type);
8574   pragma Inline (Is_Base_Type);
8575   pragma Inline (Is_Package_Or_Generic_Package);
8576   pragma Inline (Is_Volatile);
8577   pragma Inline (Is_Wrapper_Package);
8578   pragma Inline (Known_RM_Size);
8579   pragma Inline (Known_Static_Component_Bit_Offset);
8580   pragma Inline (Known_Static_RM_Size);
8581   pragma Inline (Scope_Depth);
8582   pragma Inline (Scope_Depth_Set);
8583   pragma Inline (Unknown_RM_Size);
8584
8585end Einfo;
8586