OSDN Git Service

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