OSDN Git Service

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