OSDN Git Service

./:
[pf3gnuchains/gcc-fork.git] / gcc / ada / sinfo.ads
1 ------------------------------------------------------------------------------
2 --                                                                          --
3 --                         GNAT COMPILER COMPONENTS                         --
4 --                                                                          --
5 --                                S I N F O                                 --
6 --                                                                          --
7 --                                 S p e c                                  --
8 --                                                                          --
9 --          Copyright (C) 1992-2007, 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 --  This package defines the structure of the abstract syntax tree. The Tree
35 --  package provides a basic tree structure. Sinfo describes how this structure
36 --  is used to represent the syntax of an Ada program.
37
38 --  The grammar in the RM is followed very closely in the tree
39 --  design, and is repeated as part of this source file.
40
41 --  The tree contains not only the full syntactic representation of the
42 --  program, but also the results of semantic analysis. In particular, the
43 --  nodes for defining identifiers, defining character literals and defining
44 --  operator symbols, collectively referred to as entities, represent what
45 --  would normally be regarded as the symbol table information. In addition a
46 --  number of the tree nodes contain semantic information.
47
48 --  WARNING: Several files are automatically generated from this package.
49 --  See below for details.
50
51 with Namet;  use Namet;
52 with Types;  use Types;
53 with Uintp;  use Uintp;
54 with Urealp; use Urealp;
55
56 package Sinfo is
57
58    ---------------------------------
59    -- Making Changes to This File --
60    ---------------------------------
61
62    --  If changes are made to this file, a number of related steps must be
63    --  carried out to ensure consistency. First, if a field access function is
64    --  added, it appears in seven places:
65
66    --    The documentation associated with the node
67    --    The spec of the access function in sinfo.ads
68    --    The body of the access function in sinfo.adb
69    --    The pragma Inline at the end of sinfo.ads for the access function
70    --    The spec of the set procedure in sinfo.ads
71    --    The body of the set procedure in sinfo.adb
72    --    The pragma Inline at the end of sinfo.ads for the set procedure
73
74    --  The field chosen must be consistent in all places, and, for a node that
75    --  is a subexpression, must not overlap any of the standard expression
76    --  fields.
77
78    --  In addition, if any of the standard expression fields is changed, then
79    --  the utility program which creates the Treeprs spec (in file treeprs.ads)
80    --  must be updated appropriately, since it special cases expression fields.
81
82    --  If a new tree node is added, then the following changes are made
83
84    --    Add it to the documentation in the appropriate place
85    --    Add its fields to this documentation section
86    --    Define it in the appropriate classification in Node_Kind
87    --    In the body (sinfo), add entries to the access functions for all
88    --     its fields (except standard expression fields) to include the new
89    --     node in the checks.
90    --    Add an appropriate section to the case statement in sprint.adb
91    --    Add an appropriate section to the case statement in sem.adb
92    --    Add an appropriate section to the case statement in exp_util.adb
93    --     (Insert_Actions procedure)
94    --    For a subexpression, add an appropriate section to the case
95    --     statement in sem_eval.adb
96    --    For a subexpression, add an appropriate section to the case
97    --     statement in sem_res.adb
98
99    --  Finally, four utility programs must be run:
100
101    --    Run CSinfo to check that you have made the changes consistently. It
102    --     checks most of the rules given above, with clear error messages. This
103    --     utility reads sinfo.ads and sinfo.adb and generates a report to
104    --     standard output.
105
106    --    Run XSinfo to create sinfo.h, the corresponding C header. This
107    --     utility reads sinfo.ads and generates sinfo.h. Note that it does
108    --     not need to read sinfo.adb, since the contents of the body are
109    --     algorithmically determinable from the spec.
110
111    --    Run XTreeprs to create treeprs.ads, an updated version of the module
112    --     that is used to drive the tree print routine. This utility reads (but
113    --     does not modify) treeprs.adt, the template that provides the basic
114    --     structure of the file, and then fills in the data from the comments
115    --     in sinfo.ads.
116
117    --    Run XNmake to create nmake.ads and nmake.adb, the package body and
118    --     spec of the Nmake package which contains functions for constructing
119    --     nodes.
120
121    --  All of the above steps except CSinfo are done automatically by the
122    --  build scripts when you do a full bootstrap.
123
124    --  Note: sometime we could write a utility that actually generated the body
125    --  of sinfo from the spec instead of simply checking it, since, as noted
126    --  above, the contents of the body can be determined from the spec.
127
128    --------------------------------
129    -- Implicit Nodes in the Tree --
130    --------------------------------
131
132    --  Generally the structure of the tree very closely follows the grammar as
133    --  defined in the RM. However, certain nodes are omitted to save space and
134    --  simplify semantic processing. Two general classes of such omitted nodes
135    --  are as follows:
136
137    --   If the only possibilities for a non-terminal are one or more other
138    --   non-terminals (i.e. the rule is a "skinny" rule), then usually the
139    --   corresponding node is omitted from the tree, and the target construct
140    --   appears directly. For example, a real type definition is either
141    --   floating point definition or a fixed point definition. No explicit node
142    --   appears for real type definition. Instead either the floating point
143    --   definition or fixed point definition appears directly.
144
145    --   If a non-terminal corresponds to a list of some other non-terminal
146    --   (possibly with separating punctuation), then usually it is omitted from
147    --   the tree, and a list of components appears instead. For example,
148    --   sequence of statements does not appear explicitly in the tree. Instead
149    --   a list of statements appears directly.
150
151    --  Some additional cases of omitted nodes occur and are documented
152    --  individually. In particular, many nodes are omitted in the tree
153    --  generated for an expression.
154
155    -------------------------------------------
156    -- Handling of Defining Identifier Lists --
157    -------------------------------------------
158
159    --  In several declarative forms in the syntax, lists of defining
160    --  identifiers appear (object declarations, component declarations, number
161    --  declarations etc.)
162
163    --  The semantics of such statements are equivalent to a series of identical
164    --  declarations of single defining identifiers (except that conformance
165    --  checks require the same grouping of identifiers in the parameter case).
166
167    --  To simplify semantic processing, the parser breaks down such multiple
168    --  declaration cases into sequences of single declarations, duplicating
169    --  type and initialization information as required. The flags More_Ids and
170    --  Prev_Ids are used to record the original form of the source in the case
171    --  where the original source used a list of names, More_Ids being set on
172    --  all but the last name and Prev_Ids being set on all but the first name.
173    --  These flags are used to reconstruct the original source (e.g. in the
174    --  Sprint package), and also are included in the conformance checks, but
175    --  otherwise have no semantic significance.
176
177    --  Note: the reason that we use More_Ids and Prev_Ids rather than
178    --  First_Name and Last_Name flags is so that the flags are off in the
179    --  normal one identifier case, which minimizes tree print output.
180
181    -----------------------
182    -- Use of Node Lists --
183    -----------------------
184
185    --  With a few exceptions, if a construction of the form {non-terminal}
186    --  appears in the tree, lists are used in the corresponding tree node (see
187    --  package Nlists for handling of node lists). In this case a field of the
188    --  parent node points to a list of nodes for the non-terminal. The field
189    --  name for such fields has a plural name which always ends in "s". For
190    --  example, a case statement has a field Alternatives pointing to list of
191    --  case statement alternative nodes.
192
193    --  Only fields pointing to lists have names ending in "s", so generally the
194    --  structure is strongly typed, fields not ending in s point to single
195    --  nodes, and fields ending in s point to lists.
196
197    --  The following example shows how a traversal of a list is written. We
198    --  suppose here that Stmt points to a N_Case_Statement node which has a
199    --  list field called Alternatives:
200
201    --   Alt := First (Alternatives (Stmt));
202    --   while Present (Alt) loop
203    --      ..
204    --      -- processing for case statement alternative Alt
205    --      ..
206    --      Alt := Next (Alt);
207    --   end loop;
208
209    --  The Present function tests for Empty, which in this case signals the end
210    --  of the list. First returns Empty immediately if the list is empty.
211    --  Present is defined in Atree, First and Next are defined in Nlists.
212
213    --  The exceptions to this rule occur with {DEFINING_IDENTIFIERS} in all
214    --  contexts, which is handled as described in the previous section, and
215    --  with {,library_unit_NAME} in the N_With_Clause mode, which is handled
216    --  using the First_Name and Last_Name flags, as further detailed in the
217    --  description of the N_With_Clause node.
218
219    -------------
220    -- Pragmas --
221    -------------
222
223    --  Pragmas can appear in many different context, but are not included in
224    --  the grammar. Still they must appear in the tree, so they can be properly
225    --  processed.
226
227    --  Two approaches are used. In some cases, an extra field is defined in an
228    --  appropriate node that contains a list of pragmas appearing in the
229    --  expected context. For example pragmas can appear before an
230    --  Accept_Alternative in a Selective_Accept_Statement, and these pragmas
231    --  appear in the Pragmas_Before field of the N_Accept_Alternative node.
232
233    --  The other approach is to simply allow pragmas to appear in syntactic
234    --  lists where the grammar (of course) does not include the possibility.
235    --  For example, the Variants field of an N_Variant_Part node points to a
236    --  list that can contain both N_Pragma and N_Variant nodes.
237
238    --  To make processing easier in the latter case, the Nlists package
239    --  provides a set of routines (First_Non_Pragma, Last_Non_Pragma,
240    --  Next_Non_Pragma, Prev_Non_Pragma) that allow such lists to be handled
241    --  ignoring all pragmas.
242
243    --  In the case of the variants list, we can either write:
244
245    --      Variant := First (Variants (N));
246    --      while Present (Variant) loop
247    --         ...
248    --         Variant := Next (Variant);
249    --      end loop;
250
251    --  or
252
253    --      Variant := First_Non_Pragma (Variants (N));
254    --      while Present (Variant) loop
255    --         ...
256    --         Variant := Next_Non_Pragma (Variant);
257    --      end loop;
258
259    --  In the first form of the loop, Variant can either be an N_Pragma or an
260    --  N_Variant node. In the second form, Variant can only be N_Variant since
261    --  all pragmas are skipped.
262
263    ---------------------
264    -- Optional Fields --
265    ---------------------
266
267    --  Fields which correspond to a section of the syntax enclosed in square
268    --  brackets are generally omitted (and the corresponding field set to Empty
269    --  for a node, or No_List for a list). The documentation of such fields
270    --  notes these cases. One exception to this rule occurs in the case of
271    --  possibly empty statement sequences (such as the sequence of statements
272    --  in an entry call alternative). Such cases appear in the syntax rules as
273    --  [SEQUENCE_OF_STATEMENTS] and the fields corresponding to such optional
274    --  statement sequences always contain an empty list (not No_List) if no
275    --  statements are present.
276
277    --  Note: the utility program that constructs the body and spec of the Nmake
278    --  package relies on the format of the comments to determine if a field
279    --  should have a default value in the corresponding make routine. The rule
280    --  is that if the first line of the description of the field contains the
281    --  string "(set to xxx if", then a default value of xxx is provided for
282    --  this field in the corresponding Make_yyy routine.
283
284    -----------------------------------
285    -- Note on Body/Spec Terminology --
286    -----------------------------------
287
288    --  In informal discussions about Ada, it is customary to refer to package
289    --  and subprogram specs and bodies. However, this is not technically
290    --  correct, what is normally referred to as a spec or specification is in
291    --  fact a package declaration or subprogram declaration. We are careful in
292    --  GNAT to use the correct terminology and in particular, the full word
293    --  specification is never used as an incorrect substitute for declaration.
294    --  The structure and terminology used in the tree also reflects the grammar
295    --  and thus uses declaration and specification in the technically correct
296    --  manner.
297
298    --  However, there are contexts in which the informal terminology is useful.
299    --  We have the word "body" to refer to the Interp_Etype declared by the
300    --  declaration of a unit body, and in some contexts we need similar term to
301    --  refer to the entity declared by the package or subprogram declaration,
302    --  and simply using declaration can be confusing since the body also has a
303    --  declaration.
304
305    --  An example of such a context is the link between the package body and
306    --  its declaration. With_Declaration is confusing, since the package body
307    --  itself is a declaration.
308
309    --  To deal with this problem, we reserve the informal term Spec, i.e. the
310    --  popular abbreviation used in this context, to refer to the entity
311    --  declared by the package or subprogram declaration. So in the above
312    --  example case, the field in the body is called With_Spec.
313
314    --  Another important context for the use of the word Spec is in error
315    --  messages, where a hyper-correct use of declaration would be confusing to
316    --  a typical Ada programmer, and even for an expert programmer can cause
317    --  confusion since the body has a declaration as well.
318
319    --  So, to summarize:
320
321    --     Declaration    always refers to the syntactic entity that is called
322    --                    a declaration. In particular, subprogram declaration
323    --                    and package declaration are used to describe the
324    --                    syntactic entity that includes the semicolon.
325
326    --     Specification  always refers to the syntactic entity that is called
327    --                    a specification. In particular, the terms procedure
328    --                    specification, function specification, package
329    --                    specification, subprogram specification always refer
330    --                    to the syntactic entity that has no semicolon.
331
332    --     Spec           is an informal term, used to refer to the entity
333    --                    that is declared by a task declaration, protected
334    --                    declaration, generic declaration, subprogram
335    --                    declaration or package declaration.
336
337    --  This convention is followed throughout the GNAT documentation
338    --  both internal and external, and in all error message text.
339
340    ------------------------
341    -- Internal Use Nodes --
342    ------------------------
343
344    --  These are Node_Kind settings used in the internal implementation which
345    --  are not logically part of the specification.
346
347    --  N_Unused_At_Start
348    --  Completely unused entry at the start of the enumeration type. This
349    --  is inserted so that no legitimate value is zero, which helps to get
350    --  better debugging behavior, since zero is a likely uninitialized value).
351
352    --  N_Unused_At_End
353    --  Completely unused entry at the end of the enumeration type. This is
354    --  handy so that arrays with Node_Kind as the index type have an extra
355    --  entry at the end (see for example the use of the Pchar_Pos_Array in
356    --  Treepr, where the extra entry provides the limit value when dealing with
357    --  the last used entry in the array).
358
359    -----------------------------------------
360    -- Note on the settings of Sloc fields --
361    -----------------------------------------
362
363    --  The Sloc field of nodes that come from the source is set by the parser.
364    --  For internal nodes, and nodes generated during expansion the Sloc is
365    --  usually set in the call to the constructor for the node. In general the
366    --  Sloc value chosen for an internal node is the Sloc of the source node
367    --  whose processing is responsible for the expansion. For example, the Sloc
368    --  of an inherited primitive operation is the Sloc of the corresponding
369    --  derived type declaration.
370
371    --  For the nodes of a generic instantiation, the Sloc value is encoded to
372    --  represent both the original Sloc in the generic unit, and the Sloc of
373    --  the instantiation itself. See Sinput.ads for details.
374
375    --  Subprogram instances create two callable entities: one is the visible
376    --  subprogram instance, and the other is an anonymous subprogram nested
377    --  within a wrapper package that contains the renamings for the actuals.
378    --  Both of these entities have the Sloc of the defining entity in the
379    --  instantiation node. This simplifies some ASIS queries.
380
381    -----------------------
382    -- Field Definitions --
383    -----------------------
384
385    --  In the following node definitions, all fields, both syntactic and
386    --  semantic, are documented. The one exception is in the case of entities
387    --  (defining indentifiers, character literals and operator symbols), where
388    --  the usage of the fields depends on the entity kind. Entity fields are
389    --  fully documented in the separate package Einfo.
390
391    --  In the node definitions, three common sets of fields are abbreviated to
392    --  save both space in the documentation, and also space in the string
393    --  (defined in Tree_Print_Strings) used to print trees. The following
394    --  abbreviations are used:
395
396    --  Note: the utility program that creates the Treeprs spec (in the file
397    --  xtreeprs.adb) knows about the special fields here, so it must be
398    --  modified if any change is made to these fields.
399
400    --    "plus fields for binary operator"
401    --       Chars                    (Name1)      Name_Id for the operator
402    --       Left_Opnd                (Node2)      left operand expression
403    --       Right_Opnd               (Node3)      right operand expression
404    --       Entity                   (Node4-Sem)  defining entity for operator
405    --       Associated_Node          (Node4-Sem)  for generic processing
406    --       Do_Overflow_Check        (Flag17-Sem) set if overflow check needed
407    --       Has_Private_View         (Flag11-Sem) set in generic units.
408
409    --    "plus fields for unary operator"
410    --       Chars                    (Name1)      Name_Id for the operator
411    --       Right_Opnd               (Node3)      right operand expression
412    --       Entity                   (Node4-Sem)  defining entity for operator
413    --       Associated_Node          (Node4-Sem)  for generic processing
414    --       Do_Overflow_Check        (Flag17-Sem) set if overflow check needed
415    --       Has_Private_View         (Flag11-Sem) set in generic units.
416
417    --    "plus fields for expression"
418    --       Paren_Count                           number of parentheses levels
419    --       Etype                    (Node5-Sem)  type of the expression
420    --       Is_Overloaded            (Flag5-Sem)  >1 type interpretation exists
421    --       Is_Static_Expression     (Flag6-Sem)  set for static expression
422    --       Raises_Constraint_Error  (Flag7-Sem)  evaluation raises CE
423    --       Must_Not_Freeze          (Flag8-Sem)  set if must not freeze
424    --       Do_Range_Check           (Flag9-Sem)  set if a range check needed
425    --       Assignment_OK            (Flag15-Sem) set if modification is OK
426    --       Is_Controlling_Actual    (Flag16-Sem) set for controlling argument
427
428    --  Note: see under (EXPRESSION) for further details on the use of
429    --  the Paren_Count field to record the number of parentheses levels.
430
431    --  Node_Kind is the type used in the Nkind field to indicate the node kind.
432    --  The actual definition of this type is given later (the reason for this
433    --  is that we want the descriptions ordered by logical chapter in the RM,
434    --  but the type definition is reordered to facilitate the definition of
435    --  some subtype ranges. The individual descriptions of the nodes show how
436    --  the various fields are used in each node kind, as well as providing
437    --  logical names for the fields. Functions and procedures are provided for
438    --  accessing and setting these fields using these logical names.
439
440    -----------------------
441    -- Gigi Restrictions --
442    -----------------------
443
444    --  The tree passed to Gigi is more restricted than the general tree form.
445    --  For example, as a result of expansion, most of the tasking nodes can
446    --  never appear. For each node to which either a complete or partial
447    --  restriction applies, a note entitled "Gigi restriction" appears which
448    --  documents the restriction.
449
450    --  Note that most of these restrictions apply only to trees generated when
451    --  code is being generated, since they involved expander actions that
452    --  destroy the tree.
453
454    ------------------------
455    -- Common Flag Fields --
456    ------------------------
457
458    --  The following flag fields appear in all nodes
459
460    --  Analyzed (Flag1)
461    --    This flag is used to indicate that a node (and all its children have
462    --    been analyzed. It is used to avoid reanalysis of a node that has
463    --    already been analyzed, both for efficiency and functional correctness
464    --    reasons.
465
466    --  Comes_From_Source (Flag2)
467    --    This flag is on for any nodes built by the scanner or parser from the
468    --    source program, and off for any nodes built by the analyzer or
469    --    expander. It indicates that a node comes from the original source.
470    --    This flag is defined in Atree.
471
472    --  Error_Posted (Flag3)
473    --    This flag is used to avoid multiple error messages being posted on or
474    --    referring to the same node. This flag is set if an error message
475    --    refers to a node or is posted on its source location, and has the
476    --    effect of inhibiting further messages involving this same node.
477
478    --  Local_Raise_Statements (Elist1)
479    --    This field is present in exception handler nodes. It is set to
480    --    No_Elist in the normal case. If there is at least one raise statement
481    --    which can potentially be handled as a local raise, then this field
482    --    points to a list of raise nodes, which are calls to a routine to raise
483    --    an exception. These are raise nodes which can be optimized into gotos
484    --    if the handler turns out to meet the conditions which permit this
485    --    transformation. Note that this does NOT include instances of the
486    --    N_Raise_xxx_Error nodes since the transformation of these nodes is
487    --    handled by the back end (using the N_Push/N_Pop mechanism).
488
489    --  Has_Dynamic_Length_Check (Flag10-Sem)
490    --    This flag is present on all nodes. It is set to indicate that one of
491    --    the routines in unit Checks has generated a length check action which
492    --    has been inserted at the flagged node. This is used to avoid the
493    --    generation of duplicate checks.
494
495    --  Has_Dynamic_Range_Check (Flag12-Sem)
496    --    This flag is present on all nodes. It is set to indicate that one of
497    --    the routines in unit Checks has generated a range check action which
498    --    has been inserted at the flagged node. This is used to avoid the
499    --    generation of duplicate checks.
500
501    --  Has_Local_Raise (Flag8-Sem)
502    --    Present in exception handler nodes. Set if the handler can be entered
503    --    via a local raise that gets transformed to a goto statement. This will
504    --    always be set if Local_Raise_Statements is non-empty, but can also be
505    --    set as a result of generation of N_Raise_xxx nodes, or flags set in
506    --    nodes requiring generation of back end checks.
507
508    ------------------------------------
509    -- Description of Semantic Fields --
510    ------------------------------------
511
512    --  The meaning of the syntactic fields is generally clear from their names
513    --  without any further description, since the names are chosen to
514    --  correspond very closely to the syntax in the reference manual. This
515    --  section describes the usage of the semantic fields, which are used to
516    --  contain additional information determined during semantic analysis.
517
518    --  ABE_Is_Certain (Flag18-Sem)
519    --    This flag is set in an instantiation node or a call node is determined
520    --    to be sure to raise an ABE. This is used to trigger special handling
521    --    of such cases, particularly in the instantiation case where we avoid
522    --    instantiating the body if this flag is set. This flag is also present
523    --    in an N_Formal_Package_Declaration_Node since formal package
524    --    declarations are treated like instantiations, but it is always set to
525    --    False in this context.
526
527    --  Accept_Handler_Records (List5-Sem)
528    --    This field is present only in an N_Accept_Alternative node. It is used
529    --    to temporarily hold the exception handler records from an accept
530    --    statement in a selective accept. These exception handlers will
531    --    eventually be placed in the Handler_Records list of the procedure
532    --    built for this accept (see Expand_N_Selective_Accept procedure in
533    --    Exp_Ch9 for further details).
534
535    --  Access_Types_To_Process (Elist2-Sem)
536    --    Present in N_Freeze_Entity nodes for Incomplete or private types.
537    --    Contains the list of access types which may require specific treatment
538    --    when the nature of the type completion is completely known. An example
539    --    of such treatement is the generation of the associated_final_chain.
540
541    --  Actions (List1-Sem)
542    --    This field contains a sequence of actions that are associated with the
543    --    node holding the field. See the individual node types for details of
544    --    how this field is used, as well as the description of the specific use
545    --    for a particular node type.
546
547    --  Activation_Chain_Entity (Node3-Sem)
548    --    This is used in tree nodes representing task activators (blocks,
549    --    subprogram bodies, package declarations, and task bodies). It is
550    --    initially Empty, and then gets set to point to the entity for the
551    --    declared Activation_Chain variable when the first task is declared.
552    --    When tasks are declared in the corresponding declarative region this
553    --    entity is located by name (its name is always _Chain) and the declared
554    --    tasks are added to the chain. Note that N_Extended_Return_Statement
555    --    does not have this attribute, although it does have an activation
556    --    chain. This chain is used to store the tasks temporarily, and is not
557    --    used for activating them. On successful completion of the return
558    --    statement, the tasks are moved to the caller's chain, and the caller
559    --    activates them.
560
561    --  Acts_As_Spec (Flag4-Sem)
562    --    A flag set in the N_Subprogram_Body node for a subprogram body which
563    --    is acting as its own spec. This flag also appears in the compilation
564    --    unit node at the library level for such a subprogram (see further
565    --    description in spec of Lib package).
566
567    --  Actual_Designated_Subtype (Node4-Sem)
568    --    Present in N_Free_Statement and N_Explicit_Dereference nodes. If gigi
569    --    needs to known the dynamic constrained subtype of the designated
570    --    object, this attribute is set to that type. This is done for
571    --    N_Free_Statements for access-to-classwide types and access to
572    --    unconstrained packed array types, and for N_Explicit_Dereference when
573    --    the designated type is an unconstrained packed array and the
574    --    dereference is the prefix of a 'Size attribute reference.
575
576    --  Aggregate_Bounds (Node3-Sem)
577    --    Present in array N_Aggregate nodes. If the aggregate contains
578    --    component associations this field points to an N_Range node whose
579    --    bounds give the lowest and highest discrete choice values. If the
580    --    named aggregate contains a dynamic or null choice this field is empty.
581    --    If the aggregate contains positional elements this field points to an
582    --    N_Integer_Literal node giving the number of positional elements. Note
583    --    that if the aggregate contains positional elements and an other choice
584    --    the N_Integer_Literal only accounts for the number of positional
585    --    elements.
586
587    --  All_Others (Flag11-Sem)
588    --    Present in an N_Others_Choice node. This flag is set in the case of an
589    --    others exception where all exceptions are to be caught, even those
590    --    that are not normally handled (in particular the tasking abort
591    --    signal). This is used for translation of the at end handler into a
592    --    normal exception handler.
593
594    --  Assignment_OK (Flag15-Sem)
595    --    This flag is set in a subexpression node for an object, indicating
596    --    that the associated object can be modified, even if this would not
597    --    normally be permissible (either by direct assignment, or by being
598    --    passed as an out or in-out parameter). This is used by the expander
599    --    for a number of purposes, including initialzation of constants and
600    --    limited type objects (such as tasks), setting discriminant fields,
601    --    setting tag values, etc. N_Object_Declaration nodes also have this
602    --    flag defined. Here it is used to indicate that an initialization
603    --    expression is valid, even where it would normally not be allowed (e.g.
604    --    where the type involved is limited).
605
606    --  Associated_Node (Node4-Sem)
607    --    Present in nodes that can denote an entity: identifiers, character
608    --    literals, operator symbols, expanded names, operator nodes, and
609    --    attribute reference nodes (all these nodes have an Entity field). This
610    --    field is also present in N_Aggregate, N_Selected_Component, and
611    --    N_Extension_Aggregate nodes. This field is used in generic processing
612    --    to create links between the generic template and the generic copy. See
613    --    Sem_Ch12.Get_Associated_Node for full details. Note that this field
614    --    overlaps Entity, which is fine, since, as explained in Sem_Ch12, the
615    --    normal function of Entity is not required at the point where the
616    --    Associated_Node is set. Note also, that in generic templates, this
617    --    means that the Entity field does not necessarily point to an Entity.
618    --    Since the back end is expected to ignore generic templates, this is
619    --    harmless.
620
621    --  At_End_Proc (Node1)
622    --    This field is present in an N_Handled_Sequence_Of_Statements node. It
623    --    contains an identifier reference for the cleanup procedure to be
624    --    called. See description of this node for further details.
625
626    --  Backwards_OK (Flag6-Sem)
627    --    A flag present in the N_Assignment_Statement node. It is used only if
628    --    the type being assigned is an array type, and is set if analysis
629    --    determines that it is definitely safe to do the copy backwards, i.e.
630    --    starting at the highest addressed element. Note that if neither of the
631    --    flags Forwards_OK or Backwards_OK is set, it means that the front end
632    --    could not determine that either direction is definitely safe, and a
633    --    runtime check is required.
634
635    --  Body_To_Inline (Node3-Sem)
636    --    present in subprogram declarations. Denotes analyzed but unexpanded
637    --    body of subprogram, to be used when inlining calls. Present when the
638    --    subprogram has an Inline pragma and inlining is enabled. If the
639    --    declaration is completed by a renaming_as_body, and the renamed en-
640    --    tity is a subprogram, the Body_To_Inline is the name of that entity,
641    --    which is used directly in later calls to the original subprogram.
642
643    --  Body_Required (Flag13-Sem)
644    --    A flag that appears in the N_Compilation_Unit node indicating that the
645    --    corresponding unit requires a body. For the package case, this
646    --    indicates that a completion is required. In Ada 95, if the flag is not
647    --    set for the package case, then a body may not be present. In Ada 83,
648    --    if the flag is not set for the package case, then body is optional.
649    --    For a subprogram declaration, the flag is set except in the case where
650    --    a pragma Import or Interface applies, in which case no body is
651    --    permitted (in Ada 83 or Ada 95).
652
653    --  By_Ref (Flag5-Sem)
654    --    A flag present in N_Return_Statement and
655    --    N_Extended_Return_Statement.
656    --    It is set when the returned expression is already allocated on the
657    --    secondary stack and thus the result is passed by reference rather
658    --    than copied another time.
659
660    --  Check_Address_Alignment (Flag11-Sem)
661    --    A flag present in N_Attribute_Definition clause for a 'Address
662    --    attribute definition. This flag is set if a dynamic check should be
663    --    generated at the freeze point for the entity to which this address
664    --    clause applies. The reason that we need this flag is that we want to
665    --    check for range checks being suppressed at the point where the
666    --    attribute definition clause is given, rather than testing this at the
667    --    freeze point.
668
669    --  Coextensions (Elist4-Sem)
670    --    Present in allocators nodes. Points to list of allocators for the
671    --    access discriminants of the allocated object.
672
673    --  Comes_From_Extended_Return_Statement (Flag18-Sem)
674    --    Present in N_Return_Statement nodes. True if this node was
675    --    constructed as part of the expansion of an
676    --    N_Extended_Return_Statement.
677
678    --  Compile_Time_Known_Aggregate (Flag18-Sem)
679    --    Present in N_Aggregate nodes. Set for aggregates which can be fully
680    --    evaluated at compile time without raising constraint error. Such
681    --    aggregates can be passed as is to Gigi without any expansion. See
682    --    Sem_Aggr for the specific conditions under which an aggregate has this
683    --    flag set. See also the flag Static_Processing_OK.
684
685    --  Condition_Actions (List3-Sem)
686    --    This field appears in else-if nodes and in the iteration scheme node
687    --    for while loops. This field is only used during semantic processing to
688    --    temporarily hold actions inserted into the tree. In the tree passed to
689    --    gigi, the condition actions field is always set to No_List. For
690    --    details on how this field is used, see the routine Insert_Actions in
691    --    package Exp_Util, and also the expansion routines for the relevant
692    --    nodes.
693
694    --  Controlling_Argument (Node1-Sem)
695    --    This field is set in procedure and function call nodes if the call is
696    --    a dispatching call (it is Empty for a non-dispatching call). It
697    --    indicates the source of the call's controlling tag. For procedure
698    --    calls, the Controlling_Argument is one of the actuals. For function
699    --    that has a dispatching result, it is an entity in the context of the
700    --    call that can provide a tag, or else it is the tag of the root type of
701    --    the class. It can also specify a tag directly rather than being a
702    --    tagged object. The latter is needed by the implementations of AI-239
703    --    and AI-260.
704
705    --  Conversion_OK (Flag14-Sem)
706    --    A flag set on type conversion nodes to indicate that the conversion is
707    --    to be considered as being valid, even though it is the case that the
708    --    conversion is not valid Ada. This is used for Enum_Rep, Fixed_Value
709    --    and Integer_Value attributes, for internal conversions done for
710    --    fixed-point operations, and for certain conversions for calls to
711    --    initialization procedures. If Conversion_OK is set, then Etype must be
712    --    set (the analyzer assumes that Etype has been set). For the case of
713    --    fixed-point operands, it also indicates that the conversion is to be
714    --    direct conversion of the underlying integer result, with no regard to
715    --    the small operand.
716
717    --  Corresponding_Body (Node5-Sem)
718    --    This field is set in subprogram declarations, package declarations,
719    --    entry declarations of protected types, and in generic units. It
720    --    points to the defining entity for the corresponding body (NOT the
721    --    node for the body itself).
722
723    --  Corresponding_Formal_Spec (Node3-Sem)
724    --    This field is set in subprogram renaming declarations, where it points
725    --    to the defining entity for a formal subprogram in the case where the
726    --    renaming corresponds to a generic formal subprogram association in an
727    --    instantiation. The field is Empty if the renaming does not correspond
728    --    to such a formal association.
729
730    --  Corresponding_Generic_Association (Node5-Sem)
731    --    This field is defined for object declarations and object renaming
732    --    declarations. It is set for the declarations within an instance that
733    --    map generic formals to their actuals. If set, the field points to
734    --    a generic_association which is the original parent of the expression
735    --    or name appearing in the declaration. This simplifies ASIS queries.
736
737    --  Corresponding_Integer_Value (Uint4-Sem)
738    --    This field is set in real literals of fixed-point types (it is not
739    --    used for floating-point types). It contains the integer value used
740    --    to represent the fixed-point value. It is also set on the universal
741    --    real literals used to represent bounds of fixed-point base types
742    --    and their first named subtypes.
743
744    --  Corresponding_Spec (Node5-Sem)
745    --    This field is set in subprogram, package, task, and protected body
746    --    nodes, where it points to the defining entity in the corresponding
747    --    spec. The attribute is also set in N_With_Clause nodes, where it
748    --    points to the defining entity for the with'ed spec, and in a
749    --    subprogram renaming declaration when it is a Renaming_As_Body. The
750    --    field is Empty if there is no corresponding spec, as in the case of a
751    --    subprogram body that serves as its own spec.
752
753    --  Corresponding_Stub (Node3-Sem)
754    --    This field is present in an N_Subunit node. It holds the node in
755    --    the parent unit that is the stub declaration for the subunit. it is
756    --    set when analysis of the stub forces loading of the proper body. If
757    --    expansion of the proper body creates new declarative nodes, they are
758    --    inserted at the point of the corresponding_stub.
759
760    --  Dcheck_Function (Node5-Sem)
761    --    This field is present in an N_Variant node, It references the entity
762    --    for the discriminant checking function for the variant.
763
764    --  Debug_Statement (Node3)
765    --    This field is present in an N_Pragma node. It is used only for a Debug
766    --    pragma. The parameter is of the form of an expression, as required by
767    --    the pragma syntax, but is actually a procedure call. To simplify
768    --    semantic processing, the parser creates a copy of the argument
769    --    rearranged into a procedure call statement and places it in the
770    --    Debug_Statement field. Note that this field is considered syntactic
771    --    field, since it is created by the parser.
772
773    --  Default_Expression (Node5-Sem)
774    --    This field is Empty if there is no default expression. If there is a
775    --    simple default expression (one with no side effects), then this field
776    --    simply contains a copy of the Expression field (both point to the tree
777    --    for the default expression). Default_Expression is used for
778    --    conformance checking.
779
780    --  Discr_Check_Funcs_Built (Flag11-Sem)
781    --    This flag is present in N_Full_Type_Declaration nodes. It is set when
782    --    discriminant checking functions are constructed. The purpose is to
783    --    avoid attempting to set these functions more than once.
784
785    --  Do_Accessibility_Check (Flag13-Sem)
786    --    This flag is set on N_Parameter_Specification nodes to indicate
787    --    that an accessibility check is required for the parameter. It is
788    --    not yet decided who takes care of this check (TBD ???).
789
790    --  Do_Discriminant_Check (Flag13-Sem)
791    --    This flag is set on N_Selected_Component nodes to indicate that a
792    --    discriminant check is required using the discriminant check routine
793    --    associated with the selector. The actual check is generated by the
794    --    expander when processing selected components.
795
796    --  Do_Division_Check (Flag13-Sem)
797    --    This flag is set on a division operator (/ mod rem) to indicate
798    --    that a zero divide check is required. The actual check is dealt
799    --    with by the backend (all the front end does is to set the flag).
800
801    --  Do_Length_Check (Flag4-Sem)
802    --    This flag is set in an N_Assignment_Statement, N_Op_And, N_Op_Or,
803    --    N_Op_Xor, or N_Type_Conversion node to indicate that a length check
804    --    is required. It is not determined who deals with this flag (???).
805
806    --  Do_Overflow_Check (Flag17-Sem)
807    --    This flag is set on an operator where an overflow check is required on
808    --    the operation. The actual check is dealt with by the backend (all the
809    --    front end does is to set the flag). The other cases where this flag is
810    --    used is on a Type_Conversion node and for attribute reference nodes.
811    --    For a type conversion, it means that the conversion is from one base
812    --    type to another, and the value may not fit in the target base type.
813    --    See also the description of Do_Range_Check for this case. The only
814    --    attribute references which use this flag are Pred and Succ, where it
815    --    means that the result should be checked for going outside the base
816    --    range.
817
818    --  Do_Range_Check (Flag9-Sem)
819    --    This flag is set on an expression which appears in a context where
820    --    a range check is required. The target type is clear from the
821    --    context. The contexts in which this flag can appear are limited to
822    --    the following.
823
824    --      Right side of an assignment. In this case the target type is
825    --      taken from the left side of the assignment, which is referenced
826    --      by the Name of the N_Assignment_Statement node.
827
828    --      Subscript expressions in an indexed component. In this case the
829    --      target type is determined from the type of the array, which is
830    --      referenced by the Prefix of the N_Indexed_Component node.
831
832    --      Argument expression for a parameter, appearing either directly in
833    --      the Parameter_Associations list of a call or as the Expression of an
834    --      N_Parameter_Association node that appears in this list. In either
835    --      case, the check is against the type of the formal. Note that the
836    --      flag is relevant only in IN and IN OUT parameters, and will be
837    --      ignored for OUT parameters, where no check is required in the call,
838    --      and if a check is required on the return, it is generated explicitly
839    --      with a type conversion.
840
841    --      Initialization expression for the initial value in an object
842    --      declaration. In this case the Do_Range_Check flag is set on
843    --      the initialization expression, and the check is against the
844    --      range of the type of the object being declared.
845
846    --      The expression of a type conversion. In this case the range check is
847    --      against the target type of the conversion. See also the use of
848    --      Do_Overflow_Check on a type conversion. The distinction is that the
849    --      overflow check protects against a value that is outside the range of
850    --      the target base type, whereas a range check checks that the
851    --      resulting value (which is a value of the base type of the target
852    --      type), satisfies the range constraint of the target type.
853
854    --    Note: when a range check is required in contexts other than those
855    --    listed above (e.g. in a return statement), an additional type
856    --    conversion node is introduced to represent the required check.
857
858    --  Do_Storage_Check (Flag17-Sem)
859    --    This flag is set in an N_Allocator node to indicate that a storage
860    --    check is required for the allocation, or in an N_Subprogram_Body node
861    --    to indicate that a stack check is required in the subprogram prolog.
862    --    The N_Allocator case is handled by the routine that expands the call
863    --    to the runtime routine. The N_Subprogram_Body case is handled by the
864    --    backend, and all the semantics does is set the flag.
865
866    --  Do_Tag_Check (Flag13-Sem)
867    --    This flag is set on an N_Assignment_Statement, N_Function_Call,
868    --    N_Procedure_Call_Statement, N_Type_Conversion,
869    --    N_Return_Statement, or N_Extended_Return_Statement
870    --    node to indicate that the tag check can be suppressed. It is not
871    --    yet decided how this flag is used (TBD ???).
872
873    --  Elaborate_Present (Flag4-Sem)
874    --    This flag is set in the N_With_Clause node to indicate that pragma
875    --    Elaborate pragma appears for the with'ed units.
876
877    --  Elaborate_All_Desirable (Flag9-Sem)
878    --    This flag is set in the N_With_Clause mode to indicate that the static
879    --    elaboration processing has determined that an Elaborate_All pragma is
880    --    desirable for correct elaboration for this unit.
881
882    --  Elaborate_All_Present (Flag14-Sem)
883    --    This flag is set in the N_With_Clause node to indicate that a
884    --    pragma Elaborate_All pragma appears for the with'ed units.
885
886    --  Elaborate_Desirable (Flag11-Sem)
887    --    This flag is set in the N_With_Clause mode to indicate that the static
888    --    elaboration processing has determined that an Elaborate pragma is
889    --    desirable for correct elaboration for this unit.
890
891    --  Elaboration_Boolean (Node2-Sem)
892    --    This field is present in function and procedure specification
893    --    nodes. If set, it points to the entity for a Boolean flag that
894    --    must be tested for certain calls to check for access before
895    --    elaboration. See body of Sem_Elab for further details. This
896    --    field is Empty if no elaboration boolean is required.
897
898    --  Else_Actions (List3-Sem)
899    --    This field is present in conditional expression nodes. During code
900    --    expansion we use the Insert_Actions procedure (in Exp_Util) to insert
901    --    actions at an appropriate place in the tree to get elaborated at the
902    --    right time. For conditional expressions, we have to be sure that the
903    --    actions for the Else branch are only elaborated if the condition is
904    --    False. The Else_Actions field is used as a temporary parking place for
905    --    these actions. The final tree is always rewritten to eliminate the
906    --    need for this field, so in the tree passed to Gigi, this field is
907    --    always set to No_List.
908
909    --  Enclosing_Variant (Node2-Sem)
910    --    This field is present in the N_Variant node and identifies the
911    --    Node_Id corresponding to the immediately enclosing variant when
912    --    the variant is nested, and N_Empty otherwise. Set during semantic
913    --    processing of the variant part of a record type.
914
915    --  Entity (Node4-Sem)
916    --    Appears in all direct names (identifier, character literal, operator
917    --    symbol), as well as expanded names, and attributes that denote
918    --    entities, such as 'Class. Points to the entity for the corresponding
919    --    defining occurrence. Set after name resolution. In the case of
920    --    identifiers in a WITH list, the corresponding defining occurrence is
921    --    in a separately compiled file, and this pointer must be set using the
922    --    library Load procedure. Note that during name resolution, the value in
923    --    Entity may be temporarily incorrect (e.g. during overload resolution,
924    --    Entity is initially set to the first possible correct interpretation,
925    --    and then later modified if necessary to contain the correct value
926    --    after resolution). Note that this field overlaps Associated_Node,
927    --    which is used during generic processing (see Sem_Ch12 for details).
928    --    Note also that in generic templates, this means that the Entity field
929    --    does not always point to an Entity. Since the back end is expected to
930    --    ignore generic templates, this is harmless. Note that this field also
931    --    appears in N_Attribute_Definition_Clause nodes. It is used only for
932    --    stream attributes definition clauses. In this case, it denotes a
933    --    (possibly dummy) subprogram entity that is conceptually declared at
934    --    the point of the clause. Thus the visibility of the attribute
935    --    definition clause (in the sense of 8.3(23) as amended by AI-195) can
936    --    be checked by testing the visibility of that subprogram.
937
938    --  Entity_Or_Associated_Node (Node4-Sem)
939    --    A synonym for both Entity and Associated_Node. Used by convention in
940    --    the code when referencing this field in cases where it is not known
941    --    whether the field contains an Entity or an Associated_Node.
942
943    --  Etype (Node5-Sem)
944    --    Appears in all expression nodes, all direct names, and all entities.
945    --    Points to the entity for the related type. Set after type resolution.
946    --    Normally this is the actual subtype of the expression. However, in
947    --    certain contexts such as the right side of an assignment, subscripts,
948    --    arguments to calls, returned value in a function, initial value etc.
949    --    it is the desired target type. In the event that this is different
950    --    from the actual type, the Do_Range_Check flag will be set if a range
951    --    check is required. Note: if the Is_Overloaded flag is set, then Etype
952    --    points to an essentially arbitrary choice from the possible set of
953    --    types.
954
955    --  Exception_Junk (Flag8-Sem)
956    --    This flag is set in a various nodes appearing in a statement sequence
957    --    to indicate that the corresponding node is an artifact of the
958    --    generated code for exception handling, and should be ignored when
959    --    analyzing the control flow of the relevant sequence of statements
960    --    (e.g. to check that it does not end with a bad return statement).
961
962    --  Exception_Label (Node5-Sem)
963    --    Appears in N_Push_xxx_Label nodes. Points to the entity of the label
964    --    to be used for transforming the corresponding exception into a goto,
965    --    or contains Empty, if this exception is not to be transformed. Also
966    --    appears in N_Exception_Handler nodes, where, if set, it indicates
967    --    that there may be a local raise for the handler, so that expansion
968    --    to allow a goto is required (and this field contains the label for
969    --    this goto). See Exp_Ch11.Expand_Local_Exception_Handlers for details.
970
971    --  Expansion_Delayed (Flag11-Sem)
972    --    Set on aggregates and extension aggregates that need a top-down rather
973    --    than bottom up expansion. Typically aggregate expansion happens bottom
974    --    up. For nested aggregates the expansion is delayed until the enclosing
975    --    aggregate itself is expanded, e.g. in the context of a declaration. To
976    --    delay it we set this flag. This is done to avoid creating a temporary
977    --    for each level of a nested aggregates, and also to prevent the
978    --    premature generation of constraint checks. This is also a requirement
979    --    if we want to generate the proper attachment to the internal
980    --    finalization lists (for record with controlled components). Top down
981    --    expansion of aggregates is also used for in-place array aggregate
982    --    assignment or initialization. When the full context is known, the
983    --    target of the assignment or initialization is used to generate the
984    --    left-hand side of individual assignment to each sub-component.
985
986    --  First_Inlined_Subprogram (Node3-Sem)
987    --    Present in the N_Compilation_Unit node for the main program. Points to
988    --    a chain of entities for subprograms that are to be inlined. The
989    --    Next_Inlined_Subprogram field of these entities is used as a link
990    --    pointer with Empty marking the end of the list. This field is Empty if
991    --    there are no inlined subprograms or inlining is not active.
992
993    --  First_Named_Actual (Node4-Sem)
994    --    Present in procedure call statement and function call nodes, and also
995    --    in Intrinsic nodes. Set during semantic analysis to point to the first
996    --    named parameter where parameters are ordered by declaration order (as
997    --    opposed to the actual order in the call which may be different due to
998    --    named associations). Note: this field points to the explicit actual
999    --    parameter itself, not the N_Parameter_Association node (its parent).
1000
1001    --  First_Real_Statement (Node2-Sem)
1002    --    Present in N_Handled_Sequence_Of_Statements node. Normally set to
1003    --    Empty. Used only when declarations are moved into the statement part
1004    --    of a construct as a result of wrapping an AT END handler that is
1005    --    required to cover the declarations. In this case, this field is used
1006    --    to remember the location in the statements list of the first real
1007    --    statement, i.e. the statement that used to be first in the statement
1008    --    list before the declarations were prepended.
1009
1010    --  First_Subtype_Link (Node5-Sem)
1011    --    Present in N_Freeze_Entity node for an anonymous base type that is
1012    --    implicitly created by the declaration of a first subtype. It points to
1013    --    the entity for the first subtype.
1014
1015    --  Float_Truncate (Flag11-Sem)
1016    --    A flag present in type conversion nodes. This is used for float to
1017    --    integer conversions where truncation is required rather than rounding.
1018    --    Note that Gigi does not handle type conversions from real to integer
1019    --    with rounding (see Expand_N_Type_Conversion).
1020
1021    --  Forwards_OK (Flag5-Sem)
1022    --    A flag present in the N_Assignment_Statement node. It is used only if
1023    --    the type being assigned is an array type, and is set if analysis
1024    --    determines that it is definitely safe to do the copy forwards, i.e.
1025    --    starting at the lowest addressed element. Note that if neither of the
1026    --    flags Forwards_OK or Backwards_OK is set, it means that the front end
1027    --    could not determine that either direction is definitely safe, and a
1028    --    runtime check is required.
1029
1030    --  From_At_Mod (Flag4-Sem)
1031    --    This flag is set on the attribute definition clause node that is
1032    --    generated by a transformation of an at mod phrase in a record
1033    --    representation clause. This is used to give slightly different (Ada 83
1034    --    compatible) semantics to such a clause, namely it is used to specify a
1035    --    minimum acceptable alignment for the base type and all subtypes. In
1036    --    Ada 95 terms, the actual alignment of the base type and all subtypes
1037    --    must be a multiple of the given value, and the representation clause
1038    --    is considered to be type specific instead of subtype specific.
1039
1040    --  From_Default (Flag6-Sem)
1041    --    This flag is set on the subprogram renaming declaration created in an
1042    --    instance for a formal subprogram, when the formal is declared with a
1043    --    box, and there is no explicit actual. If the flag is present, the
1044    --    declaration is treated as an implicit reference to the formal in the
1045    --    ali file.
1046
1047    --  Generic_Parent (Node5-Sem)
1048    --    Generic_Parent is defined on declaration nodes that are instances. The
1049    --    value of Generic_Parent is the generic entity from which the instance
1050    --    is obtained. Generic_Parent is also defined for the renaming
1051    --    declarations and object declarations created for the actuals in an
1052    --    instantiation. The generic parent of such a declaration is the
1053    --    corresponding generic association in the Instantiation node.
1054
1055    --  Generic_Parent_Type (Node4-Sem)
1056    --    Generic_Parent_Type is defined on Subtype_Declaration nodes for the
1057    --    actuals of formal private and derived types. Within the instance, the
1058    --    operations on the actual are those inherited from the parent. For a
1059    --    formal private type, the parent type is the generic type itself. The
1060    --    Generic_Parent_Type is also used in an instance to determine whether a
1061    --    private operation overrides an inherited one.
1062
1063    --  Handler_List_Entry (Node2-Sem)
1064    --    This field is present in N_Object_Declaration nodes. It is set only
1065    --    for the Handler_Record entry generated for an exception in zero cost
1066    --    exception handling mode. It references the corresponding item in the
1067    --    handler list, and is used to delete this entry if the corresponding
1068    --    handler is deleted during optimization. For further details on why
1069    --    this is required, see Exp_Ch11.Remove_Handler_Entries.
1070
1071    --  Has_No_Elaboration_Code (Flag17-Sem)
1072    --    A flag that appears in the N_Compilation_Unit node to indicate whether
1073    --    or not elaboration code is present for this unit. It is initially set
1074    --    true for subprogram specs and bodies and for all generic units and
1075    --    false for non-generic package specs and bodies. Gigi may set the flag
1076    --    in the non-generic package case if it determines that no elaboration
1077    --    code is generated. Note that this flag is not related to the
1078    --    Is_Preelaborated status, there can be preelaborated packages that
1079    --    generate elaboration code, and non- preelaborated packages which do
1080    --    not generate elaboration code.
1081
1082    --  Has_Priority_Pragma (Flag6-Sem)
1083    --    A flag present in N_Subprogram_Body, N_Task_Definition and
1084    --    N_Protected_Definition nodes to flag the presence of either a Priority
1085    --    or Interrupt_Priority pragma in the declaration sequence (public or
1086    --    private in the task and protected cases)
1087
1088    --  Has_Private_View (Flag11-Sem)
1089    --    A flag present in generic nodes that have an entity, to indicate that
1090    --    the node has a private type. Used to exchange private and full
1091    --    declarations if the visibility at instantiation is different from the
1092    --    visibility at generic definition.
1093
1094    --  Has_Self_Reference (Flag13-Sem)
1095    --    Present in N_Aggregate and N_Extension_Aggregate. Indicates that one
1096    --    of the expressions contains an access attribute reference to the
1097    --    enclosing type. Such a self-reference can only appear in default-
1098    --    initialized aggregate for a record type.
1099
1100    --  Has_Storage_Size_Pragma (Flag5-Sem)
1101    --    A flag present in an N_Task_Definition node to flag the presence of a
1102    --    Storage_Size pragma.
1103
1104    --  Has_Task_Info_Pragma (Flag7-Sem)
1105    --    A flag present in an N_Task_Definition node to flag the presence of a
1106    --    Task_Info pragma. Used to detect duplicate pragmas.
1107
1108    --  Has_Task_Name_Pragma (Flag8-Sem)
1109    --    A flag present in N_Task_Definition nodes to flag the presence of a
1110    --    Task_Name pragma in the declaration sequence for the task.
1111
1112    --  Has_Wide_Character (Flag11-Sem)
1113    --    Present in string literals, set if any wide character (i.e. character
1114    --    code outside the Character range) appears in the string.
1115
1116    --  Hidden_By_Use_Clause (Elist4-Sem)
1117    --     An entity list present in use clauses that appear within
1118    --     instantiations. For the resolution of local entities, entities
1119    --     introduced by these use clauses have priority over global ones, and
1120    --     outer entities must be explicitly hidden/restored on exit.
1121
1122    --  Implicit_With (Flag16-Sem)
1123    --    This flag is set in the N_With_Clause node that is implicitly
1124    --    generated for runtime units that are loaded by the expander, and also
1125    --    for package System, if it is loaded implicitly by a use of the
1126    --    'Address or 'Tag attribute.
1127
1128    --  Includes_Infinities (Flag11-Sem)
1129    --    This flag is present in N_Range nodes. It is set for the range of
1130    --    unconstrained float types defined in Standard, which include not only
1131    --    the given range of values, but also legtitimately can include infinite
1132    --    values. This flag is false for any float type for which an explicit
1133    --    range is given by the programmer, even if that range is identical to
1134    --    the range for Float.
1135
1136    --  Instance_Spec (Node5-Sem)
1137    --    This field is present in generic instantiation nodes, and also in
1138    --    formal package declaration nodes (formal package declarations are
1139    --    treated in a manner very similar to package instantiations). It points
1140    --    to the node for the spec of the instance, inserted as part of the
1141    --    semantic processing for instantiations in Sem_Ch12.
1142
1143    --  Is_Asynchronous_Call_Block (Flag7-Sem)
1144    --    A flag set in a Block_Statement node to indicate that it is the
1145    --    expansion of an asynchronous entry call. Such a block needs cleanup
1146    --    handler to assure that the call is cancelled.
1147
1148    --  Is_Coextension (Flag18-Sem)
1149    --    Present in allocator nodes, to indicate that this is an allocator
1150    --    for an access discriminant of a dynamically allocated object. The
1151    --    coextension must be deallocated and finalized at the same time as
1152    --    the enclosing object.
1153
1154    --  Is_Component_Left_Opnd  (Flag13-Sem)
1155    --  Is_Component_Right_Opnd (Flag14-Sem)
1156    --    Present in concatenation nodes, to indicate that the corresponding
1157    --    operand is of the component type of the result. Used in resolving
1158    --    concatenation nodes in instances.
1159
1160    --  Is_Controlling_Actual (Flag16-Sem)
1161    --    This flag is set on in an expression that is a controlling argument in
1162    --    a dispatching call. It is off in all other cases. See Sem_Disp for
1163    --    details of its use.
1164
1165    --  Is_Entry_Barrier_Function (Flag8-Sem)
1166    --    This flag is set in an N_Subprogram_Body node which is the expansion
1167    --    of an entry barrier from a protected entry body. It is used for the
1168    --    circuitry checking for incorrect use of Current_Task.
1169
1170    --  Is_In_Discriminant_Check (Flag11-Sem)
1171    --    This flag is present in a selected component, and is used to indicate
1172    --    that the reference occurs within a discriminant check. The
1173    --    significance is that optimizations based on assuming that the
1174    --    discriminant check has a correct value cannot be performed in this
1175    --    case (or the disriminant check may be optimized away!)
1176
1177    --  Is_Machine_Number (Flag11-Sem)
1178    --    This flag is set in an N_Real_Literal node to indicate that the value
1179    --    is a machine number. This avoids some unnecessary cases of converting
1180    --    real literals to machine numbers.
1181
1182    --  Is_Null_Loop (Flag16-Sem)
1183    --    This flag is set in an N_Loop_Statement node if the corresponding loop
1184    --    can be determined to be null at compile time. This is used to suppress
1185    --    any warnings that would otherwise be issued inside the loop since they
1186    --    are probably not useful.
1187
1188    --  Is_Overloaded (Flag5-Sem)
1189    --    A flag present in all expression nodes. Used temporarily during
1190    --    overloading determination. The setting of this flag is not relevant
1191    --    once overloading analysis is complete.
1192
1193    --  Is_Power_Of_2_For_Shift (Flag13-Sem)
1194    --    A flag present only in N_Op_Expon nodes. It is set when the
1195    --    exponentiation is of the forma 2 ** N, where the type of N is an
1196    --    unsigned integral subtype whose size does not exceed the size of
1197    --    Standard_Integer (i.e. a type that can be safely converted to
1198    --    Natural), and the exponentiation appears as the right operand of an
1199    --    integer multiplication or an integer division where the dividend is
1200    --    unsigned. It is also required that overflow checking is off for both
1201    --    the exponentiation and the multiply/divide node. If this set of
1202    --    conditions holds, and the flag is set, then the division or
1203    --    multiplication can be (and is) converted to a shift.
1204
1205    --  Is_Overloaded (Flag5-Sem)
1206    --    A flag present in all expression nodes. Used temporarily during
1207    --    overloading determination. The setting of this flag is not relevant
1208    --    once overloading analysis is complete.
1209
1210    --  Is_Protected_Subprogram_Body (Flag7-Sem)
1211    --    A flag set in a Subprogram_Body block to indicate that it is the
1212    --    implemenation of a protected subprogram. Such a body needs cleanup
1213    --    handler to make sure that the associated protected object is unlocked
1214    --    when the subprogram completes.
1215
1216    --  Is_Static_Coextension (Flag14-Sem)
1217    --    Present in N_Allocator nodes. Set if the allocator is a coextension
1218    --    of an object allocated on the stack rather than the heap.
1219
1220    --  Is_Static_Expression (Flag6-Sem)
1221    --    Indicates that an expression is a static expression (RM 4.9). See spec
1222    --    of package Sem_Eval for full details on the use of this flag.
1223
1224    --  Is_Subprogram_Descriptor (Flag16-Sem)
1225    --    Present in N_Object_Declaration, and set only for the object
1226    --    declaration generated for a subprogram descriptor in fast exception
1227    --    mode. See Exp_Ch11 for details of use.
1228
1229    --  Is_Task_Allocation_Block (Flag6-Sem)
1230    --    A flag set in a Block_Statement node to indicate that it is the
1231    --    expansion of a task allocator, or the allocator of an object
1232    --    containing tasks. Such a block requires a cleanup handler to call
1233    --    Expunge_Unactivted_Tasks to complete any tasks that have been
1234    --    allocated but not activated when the allocator completes abnormally.
1235
1236    --  Is_Task_Master (Flag5-Sem)
1237    --    A flag set in a Subprogram_Body, Block_Statement or Task_Body node to
1238    --    indicate that the construct is a task master (i.e. has declared tasks
1239    --    or declares an access to a task type).
1240
1241    --  Itype (Node1-Sem)
1242    --    Used in N_Itype_Reference node to reference an itype for which it is
1243    --    important to ensure that it is defined. See description of this node
1244    --    for further details.
1245
1246    --  Kill_Range_Check (Flag11-Sem)
1247    --    Used in an N_Unchecked_Type_Conversion node to indicate that the
1248    --    result should not be subjected to range checks. This is used for the
1249    --    implementation of Normalize_Scalars.
1250
1251    --  Label_Construct (Node2-Sem)
1252    --    Used in an N_Implicit_Label_Declaration node. Refers to an N_Label,
1253    --    N_Block_Statement or N_Loop_Statement node to which the label
1254    --    declaration applies. This is not currently used in the compiler
1255    --    itself, but it is useful in the implementation of ASIS queries.
1256    --    This field is left empty for the special labels generated as part
1257    --    of expanding raise statements with a local exception handler.
1258
1259    --  Library_Unit (Node4-Sem)
1260    --    In a stub node, Library_Unit points to the compilation unit node of
1261    --    the corresponding subunit.
1262    --
1263    --    In a with clause node, Library_Unit points to the spec of the with'ed
1264    --    unit.
1265    --
1266    --    In a compilation unit node, the usage depends on the unit type:
1267    --
1268    --     For a subprogram body, Library_Unit points to the compilation unit
1269    --     node of the corresponding spec, unless Acts_As_Spec is set, in which
1270    --     case it points to itself.
1271    --
1272    --     For a package body, Library_Unit points to the compilation unit of
1273    --     the corresponding package spec.
1274    --
1275    --     For a subprogram spec to which pragma Inline applies, Library_Unit
1276    --     points to the compilation unit node of the corresponding body, if
1277    --     inlining is active.
1278    --
1279    --     For a generic declaration, Library_Unit points to the compilation
1280    --     unit node of the corresponding generic body.
1281    --
1282    --     For a subunit, Library_Unit points to the compilation unit node of
1283    --     the parent body.
1284    --
1285    --    Note that this field is not used to hold the parent pointer for child
1286    --    unit (which might in any case need to use it for some other purpose as
1287    --    described above). Instead for a child unit, implicit with's are
1288    --    generated for all parents.
1289
1290    --  Loop_Actions (List2-Sem)
1291    --    A list present in Component_Association nodes in array aggregates.
1292    --    Used to collect actions that must be executed within the loop because
1293    --    they may need to be evaluated anew each time through.
1294
1295    --  Limited_View_Installed (Flag18-Sem)
1296    --    Present in With_Clauses and in package specifications. If set on
1297    --    with_clause, it indicates that this clause has created the current
1298    --    limited view of the designated package. On a package specification, it
1299    --    indicates that the limited view has already been created because the
1300    --    package is mentioned in a limited_with_clause in the closure of the
1301    --    unit being compiled.
1302
1303    --  Local_Raise_Not_OK (Flag7-Sem)
1304    --    Present in N_Exception_Handler nodes. Set if the handler contains
1305    --    a construct (reraise statement, or call to subprogram in package
1306    --    GNAT.Current_Exception) that makes the handler unsuitable as a target
1307    --    for a local raise (one that could otherwise be converted to a goto).
1308
1309    --  Must_Be_Byte_Aligned (Flag14-Sem)
1310    --    This flag is present in N_Attribute_Reference nodes. It can be set
1311    --    only for the Address and Unrestricted_Access attributes. If set it
1312    --    means that the object for which the address/access is given must be on
1313    --    a byte (more accurately a storage unit) boundary. If necessary, a copy
1314    --    of the object is to be made before taking the address (this copy is in
1315    --    the current scope on the stack frame). This is used for certain cases
1316    --    of code generated by the expander that passes parameters by address.
1317    --
1318    --    The reason the copy is not made by the front end is that the back end
1319    --    has more information about type layout and may be able to (but is not
1320    --    guaranteed to) prevent making unnecessary copies.
1321
1322    --  Must_Not_Freeze (Flag8-Sem)
1323    --    A flag present in all expression nodes. Normally expressions cause
1324    --    freezing as described in the RM. If this flag is set, then this is
1325    --    inhibited. This is used by the analyzer and expander to label nodes
1326    --    that are created by semantic analysis or expansion and which must not
1327    --    cause freezing even though they normally would. This flag is also
1328    --    present in an N_Subtype_Indication node, since we also use these in
1329    --    calls to Freeze_Expression.
1330
1331    --  Next_Entity (Node2-Sem)
1332    --    Present in defining identifiers, defining character literals and
1333    --    defining operator symbols (i.e. in all entities). The entities of a
1334    --    scope are chained, and this field is used as the forward pointer for
1335    --    this list. See Einfo for further details.
1336
1337    --  Next_Named_Actual (Node4-Sem)
1338    --    Present in parameter association node. Set during semantic analysis to
1339    --    point to the next named parameter, where parameters are ordered by
1340    --    declaration order (as opposed to the actual order in the call, which
1341    --    may be different due to named associations). Not that this field
1342    --    points to the explicit actual parameter itself, not to the
1343    --    N_Parameter_Association node (its parent).
1344
1345    --  Next_Rep_Item (Node5-Sem)
1346    --    Present in pragma nodes and attribute definition nodes. Used to link
1347    --    representation items that apply to an entity. See description of
1348    --    First_Rep_Item field in Einfo for full details.
1349
1350    --  Next_Use_Clause (Node3-Sem)
1351    --    While use clauses are active during semantic processing, they are
1352    --    chained from the scope stack entry, using Next_Use_Clause as a link
1353    --    pointer, with Empty marking the end of the list. The head pointer is
1354    --    in the scope stack entry (First_Use_Clause). At the end of semantic
1355    --    processing (i.e. when Gigi sees the tree, the contents of this field
1356    --    is undefined and should not be read).
1357
1358    --  No_Ctrl_Actions (Flag7-Sem)
1359    --    Present in N_Assignment_Statement to indicate that no finalize nor nor
1360    --    adjust should take place on this assignment eventhough the rhs is
1361    --    controlled. This is used in init procs and aggregate expansions where
1362    --    the generated assignments are more initialisations than real
1363    --    assignments.
1364
1365    --  No_Elaboration_Check (Flag14-Sem)
1366    --    Present in N_Function_Call and N_Procedure_Call_Statement. Indicates
1367    --    that no elaboration check is needed on the call, because it appears in
1368    --    the context of a local Suppress pragma. This is used on calls within
1369    --    task bodies, where the actual elaboration checks are applied after
1370    --    analysis, when the local scope stack is not present.
1371
1372    --  No_Entities_Ref_In_Spec (Flag8-Sem)
1373    --    Present in N_With_Clause nodes. Set if the with clause is on the
1374    --    package or subprogram spec where the main unit is the corresponding
1375    --    body, and no entities of the with'ed unit are referenced by the spec
1376    --    (an entity may still be referenced in the body, so this flag is used
1377    --    to generate the proper message (see Sem_Util.Check_Unused_Withs for
1378    --    full details)
1379
1380    --  No_Initialization (Flag13-Sem)
1381    --    Present in N_Object_Declaration & N_Allocator to indicate that the
1382    --    object must not be initialized (by Initialize or call to an init
1383    --    proc). This is needed for controlled aggregates. When the Object
1384    --    declaration has an expression, this flag means that this expression
1385    --    should not be taken into account (needed for in place initialization
1386    --    with aggregates)
1387
1388    --  No_Truncation (Flag17-Sem)
1389    --    Present in N_Unchecked_Type_Conversion node. This flag has an effect
1390    --    only if the RM_Size of the source is greater than the RM_Size of the
1391    --    target for scalar operands. Normally in such a case we truncate some
1392    --    higher order bits of the source, and then sign/zero extend the result
1393    --    to form the output value. But if this flag is set, then we do not do
1394    --    any truncation, so for example, if an 8 bit input is converted to 5
1395    --    bit result which is in fact stored in 8 bits, then the high order
1396    --    three bits of the target result will be copied from the source. This
1397    --    is used for properly setting out of range values for use by pragmas
1398    --    Initialize_Scalars and Normalize_Scalars.
1399
1400    --  Original_Discriminant (Node2-Sem)
1401    --    Present in identifiers. Used in references to discriminants that
1402    --    appear in generic units. Because the names of the discriminants may be
1403    --    different in an instance, we use this field to recover the position of
1404    --    the discriminant in the original type, and replace it with the
1405    --    discriminant at the same position in the instantiated type.
1406
1407    --  Original_Entity (Node2-Sem)
1408    --    Present in numeric literals. Used to denote the named number that has
1409    --    been constant-folded into the given literal. If literal is from
1410    --    source, or the result of some other constant-folding operation, then
1411    --    Original_Entity is empty. This field is needed to handle properly
1412    --    named numbers in generic units, where the Associated_Node field
1413    --    interferes with the Entity field, making it impossible to preserve the
1414    --    original entity at the point of instantiation (ASIS problem).
1415
1416    --  Others_Discrete_Choices (List1-Sem)
1417    --    When a case statement or variant is analyzed, the semantic checks
1418    --    determine the actual list of choices that correspond to an others
1419    --    choice. This list is materialized for later use by the expander and
1420    --    the Others_Discrete_Choices field of an N_Others_Choice node points to
1421    --    this materialized list of choices, which is in standard format for a
1422    --    list of discrete choices, except that of course it cannot contain an
1423    --    N_Others_Choice entry.
1424
1425    --  Parameter_List_Truncated (Flag17-Sem)
1426    --    Present in N_Function_Call and N_Procedure_Call_Statement nodes. Set
1427    --    (for OpenVMS ports of GNAT only) if the parameter list is truncated as
1428    --    a result of a First_Optional_Parameter specification in an
1429    --    Import_Function, Import_Procedure, or Import_Valued_Procedure pragma.
1430    --    The truncation is done by the expander by removing trailing parameters
1431    --    from the argument list, in accordance with the set of rules allowing
1432    --    such parameter removal. In particular, parameters can be removed
1433    --    working from the end of the parameter list backwards up to and
1434    --    including the entry designated by First_Optional_Parameter in the
1435    --    Import pragma. Parameters can be removed if they are implicit and the
1436    --    default value is a known-at-compile-time value, including the use of
1437    --    the Null_Parameter attribute, or if explicit parameter values are
1438    --    present that match the corresponding defaults.
1439
1440    --  Parent_Spec (Node4-Sem)
1441    --    For a library unit that is a child unit spec (package or subprogram
1442    --    declaration, generic declaration or instantiation, or library level
1443    --    rename, this field points to the compilation unit node for the parent
1444    --    package specification. This field is Empty for library bodies (the
1445    --    parent spec in this case can be found from the corresponding spec).
1446
1447    --  Present_Expr (Uint3-Sem)
1448    --    Present in an N_Variant node. This has a meaningful value only after
1449    --    Gigi has back annotated the tree with representation information. At
1450    --    this point, it contains a reference to a gcc expression that depends
1451    --    on the values of one or more discriminants. Give a set of discriminant
1452    --    values, this expression evaluates to False (zero) if variant is not
1453    --    present, and True (non-zero) if it is present. See unit Repinfo for
1454    --    further details on gigi back annotation. This field is used during
1455    --    ASIS processing (data decomposition annex) to determine if a field is
1456    --    present or not.
1457
1458    --  Print_In_Hex (Flag13-Sem)
1459    --    Set on an N_Integer_Literal node to indicate that the value should be
1460    --    printed in hexadecimal in the sprint listing. Has no effect on
1461    --    legality or semantics of program, only on the displayed output. This
1462    --    is used to clarify output from the packed array cases.
1463
1464    --  Procedure_To_Call (Node2-Sem)
1465    --    Present in N_Allocator, N_Free_Statement, N_Return_Statement,
1466    --    and N_Extended_Return_Statement nodes. References the entity for the
1467    --    declaration of the procedure to be called to accomplish the required
1468    --    operation (i.e. for the Allocate procedure in the case of N_Allocator
1469    --    and N_Return_Statement and N_Extended_Return_Statement (for
1470    --    allocating the return value), and for the Deallocate procedure in the
1471    --    case of N_Free_Statement.
1472
1473    --  Raises_Constraint_Error (Flag7-Sem)
1474    --    Set on an expression whose evaluation will definitely fail constraint
1475    --    error check. In the case of static expressions, this flag must be set
1476    --    accurately (and if it is set, the expression is typically illegal
1477    --    unless it appears as a non-elaborated branch of a short-circuit form).
1478    --    For a non-static expression, this flag may be set whenever an
1479    --    expression (e.g. an aggregate) is known to raise constraint error. If
1480    --    set, the expression definitely will raise CE if elaborated at runtime.
1481    --    If not set, the expression may or may not raise CE. In other words, on
1482    --    static expressions, the flag is set accurately, on non-static
1483    --    expressions it is set conservatively.
1484
1485    --  Redundant_Use (Flag13-Sem)
1486    --    Present in nodes that can appear as an operand in a use clause or use
1487    --    type clause (identifiers, expanded names, attribute references). Set
1488    --    to indicate that a use is redundant (and therefore need not be undone
1489    --    on scope exit).
1490
1491    --  Renaming_Exception (Node2-Sem)
1492    --    Present in N_Exception_Declaration node. Used to point back to the
1493    --    exception renaming for an exception declared within a subprogram.
1494    --    What happens is that an exception declared in a subprogram is moved
1495    --    to the library level with a unique name, and the original exception
1496    --    becomes a renaming. This link from the library level exception to the
1497    --    renaming declaration allows registering of the proper exception name.
1498
1499    --  Return_Statement_Entity (Node5-Sem)
1500    --    Present in N_Return_Statement and N_Extended_Return_Statement.
1501    --    Points to an E_Return_Statement representing the return statement.
1502
1503    --  Return_Object_Declarations (List3)
1504    --    Present in N_Extended_Return_Statement.
1505    --    Points to a list initially containing a single
1506    --    N_Object_Declaration representing the return object.
1507    --    We use a list (instead of just a pointer to the object decl)
1508    --    because Analyze wants to insert extra actions on this list.
1509
1510    --  Rounded_Result (Flag18-Sem)
1511    --    Present in N_Type_Conversion, N_Op_Divide and N_Op_Multiply nodes.
1512    --    Used in the fixed-point cases to indicate that the result must be
1513    --    rounded as a result of the use of the 'Round attribute. Also used for
1514    --    integer N_Op_Divide nodes to indicate that the result should be
1515    --    rounded to the nearest integer (breaking ties away from zero), rather
1516    --    than truncated towards zero as usual. These rounded integer operations
1517    --    are the result of expansion of rounded fixed-point divide, conversion
1518    --    and multiplication operations.
1519
1520    --  Scope (Node3-Sem)
1521    --    Present in defining identifiers, defining character literals and
1522    --    defining operator symbols (i.e. in all entities). The entities of a
1523    --    scope all use this field to reference the corresponding scope entity.
1524    --    See Einfo for further details.
1525
1526    --  Shift_Count_OK (Flag4-Sem)
1527    --    A flag present in shift nodes to indicate that the shift count is
1528    --    known to be in range, i.e. is in the range from zero to word length
1529    --    minus one. If this flag is not set, then the shift count may be
1530    --    outside this range, i.e. larger than the word length, and the code
1531    --    must ensure that such shift counts give the appropriate result.
1532
1533    --  Source_Type (Node1-Sem)
1534    --    Used in an N_Validate_Unchecked_Conversion node to point to the
1535    --    source type entity for the unchecked conversion instantiation
1536    --    which gigi must do size validation for.
1537
1538    --  Static_Processing_OK (Flag4-Sem)
1539    --    Present in N_Aggregate nodes. When the Compile_Time_Known_Aggregate
1540    --    flag is set, the full value of the aggregate can be determined at
1541    --    compile time and the aggregate can be passed as is to the back-end.
1542    --    In this event it is irrelevant whether this flag is set or not.
1543    --    However, if the flag Compile_Time_Known_Aggregate is not set but
1544    --    Static_Processing_OK is set, the aggregate can (but need not) be
1545    --    converted into a compile time known aggregate by the expander. See
1546    --    Sem_Aggr for the specific conditions under which an aggregate has its
1547    --    Static_Processing_OK flag set.
1548
1549    --  Storage_Pool (Node1-Sem)
1550    --    Present in N_Allocator, N_Free_Statement, N_Return_Statement, and
1551    --    N_Extended_Return_Statement nodes. References the entity for the
1552    --    storage pool to be used for the allocate or free call or for the
1553    --    allocation of the returned value from function. Empty indicates that
1554    --    the global default default pool is to be used. Note that in the case
1555    --    of a return statement, this field is set only if the function returns
1556    --    value of a type whose size is not known at compile time on the
1557    --    secondary stack.
1558
1559    --  Target_Type (Node2-Sem)
1560    --    Used in an N_Validate_Unchecked_Conversion node to point to the target
1561    --    type entity for the unchecked conversion instantiation which gigi must
1562    --    do size validation for.
1563
1564    --  Then_Actions (List3-Sem)
1565    --    This field is present in conditional expression nodes. During code
1566    --    expansion we use the Insert_Actions procedure (in Exp_Util) to insert
1567    --    actions at an appropriate place in the tree to get elaborated at the
1568    --    right time. For conditional expressions, we have to be sure that the
1569    --    actions for the Then branch are only elaborated if the condition is
1570    --    True. The Then_Actions field is used as a temporary parking place for
1571    --    these actions. The final tree is always rewritten to eliminate the
1572    --    need for this field, so in the tree passed to Gigi, this field is
1573    --    always set to No_List.
1574
1575    --  Treat_Fixed_As_Integer (Flag14-Sem)
1576    --    This flag appears in operator nodes for divide, multiply, mod and rem
1577    --    on fixed-point operands. It indicates that the operands are to be
1578    --    treated as integer values, ignoring small values. This flag is only
1579    --    set as a result of expansion of fixed-point operations. Typically a
1580    --    fixed-point multplication in the source generates subsidiary
1581    --    multiplication and division operations that work with the underlying
1582    --    integer values and have this flag set. Note that this flag is not
1583    --    needed on other arithmetic operations (add, neg, subtract etc) since
1584    --    in these cases it is always the case that fixed is treated as integer.
1585    --    The Etype field MUST be set if this flag is set. The analyzer knows to
1586    --    leave such nodes alone, and whoever makes them must set the correct
1587    --    Etype value.
1588
1589    --  TSS_Elist (Elist3-Sem)
1590    --    Present in N_Freeze_Entity nodes. Holds an element list containing
1591    --    entries for each TSS (type support subprogram) associated with the
1592    --    frozen type. The elements of the list are the entities for the
1593    --    subprograms (see package Exp_TSS for further details). Set to No_Elist
1594    --    if there are no type support subprograms for the type or if the freeze
1595    --    node is not for a type.
1596
1597    --  Unreferenced_In_Spec (Flag7-Sem)
1598    --    Present in N_With_Clause nodes. Set if the with clause is on the
1599    --    package or subprogram spec where the main unit is the corresponding
1600    --    body, and is not referenced by the spec (it may still be referenced by
1601    --    the body, so this flag is used to generate the proper message (see
1602    --    Sem_Util.Check_Unused_Withs for details)
1603
1604    --  Was_Originally_Stub (Flag13-Sem)
1605    --    This flag is set in the node for a proper body that replaces stub.
1606    --    During the analysis procedure, stubs in some situations get rewritten
1607    --    by the corresponding bodies, and we set this flag to remember that
1608    --    this happened. Note that it is not good enough to rely on the use of
1609    --    Original_Node here because of the case of nested instantiations where
1610    --    the substituted node can be copied.
1611
1612    --  Zero_Cost_Handling (Flag5-Sem)
1613    --    This flag is set in all handled sequence of statement and exception
1614    --    handler nodes if eceptions are to be handled using the zero-cost
1615    --    mechanism (see Ada.Exceptions and System.Exceptions in files
1616    --    a-except.ads/adb and s-except.ads for full details). What gigi needs
1617    --    to do for such a handler is simply to put the code in the handler
1618    --    somewhere. The front end has generated all necessary labels.
1619
1620    --------------------------------------------------
1621    -- Note on Use of End_Label and End_Span Fields --
1622    --------------------------------------------------
1623
1624    --  Several constructs have end lines:
1625
1626    --    Loop Statement             end loop [loop_IDENTIFIER];
1627    --    Package Specification      end [[PARENT_UNIT_NAME .] IDENTIFIER]
1628    --    Task Definition            end [task_IDENTIFIER]
1629    --    Protected Definition       end [protected_IDENTIFIER]
1630    --    Protected Body             end [protected_IDENTIFIER]
1631
1632    --    Block Statement            end [block_IDENTIFIER];
1633    --    Subprogram Body            end [DESIGNATOR];
1634    --    Package Body               end [[PARENT_UNIT_NAME .] IDENTIFIER];
1635    --    Task Body                  end [task_IDENTIFIER];
1636    --    Accept Statement           end [entry_IDENTIFIER]];
1637    --    Entry Body                 end [entry_IDENTIFIER];
1638
1639    --    If Statement               end if;
1640    --    Case Statement             end case;
1641
1642    --    Record Definition          end record;
1643    --    Enumeration Definition     );
1644
1645    --  The End_Label and End_Span fields are used to mark the locations of
1646    --  these lines, and also keep track of the label in the case where a label
1647    --  is present.
1648
1649    --  For the first group above, the End_Label field of the corresponding node
1650    --  is used to point to the label identifier. In the case where there is no
1651    --  label in the source, the parser supplies a dummy identifier (with
1652    --  Comes_From_Source set to False), and the Sloc of this dummy identifier
1653    --  marks the location of the token following the END token.
1654
1655    --  For the second group, the use of End_Label is similar, but the End_Label
1656    --  is found in the N_Handled_Sequence_Of_Statements node. This is done
1657    --  simply because in some cases there is no room in the parent node.
1658
1659    --  For the third group, there is never any label, and instead of using
1660    --  End_Label, we use the End_Span field which gives the location of the
1661    --  token following END, relative to the starting Sloc of the construct,
1662    --  i.e. add Sloc (Node) + End_Span (Node) to get the Sloc of the IF or CASE
1663    --  following the End_Label.
1664
1665    --  The record definition case is handled specially, we treat it as though
1666    --  it required an optional label which is never present, and so the parser
1667    --  always builds a dummy identifier with Comes From Source set False. The
1668    --  reason we do this, rather than using End_Span in this case, is that we
1669    --  want to generate a cross-ref entry for the end of a record, since it
1670    --  represents a scope for name declaration purposes.
1671
1672    --  The enumeration definition case is handled in an exactly similar manner,
1673    --  building a dummy identifier to get a cross-reference.
1674
1675    --  Note: the reason we store the difference as a Uint, instead of storing
1676    --  the Source_Ptr value directly, is that Source_Ptr values cannot be
1677    --  distinguished from other types of values, and we count on all general
1678    --  use fields being self describing. To make things easier for clients,
1679    --  note that we provide function End_Location, and procedure
1680    --  Set_End_Location to allow access to the logical value (which is the
1681    --  Source_Ptr value for the end token).
1682
1683    ---------------------
1684    -- Syntactic Nodes --
1685    ---------------------
1686
1687       ---------------------
1688       -- 2.3  Identifier --
1689       ---------------------
1690
1691       --  IDENTIFIER ::= IDENTIFIER_LETTER {[UNDERLINE] LETTER_OR_DIGIT}
1692       --  LETTER_OR_DIGIT ::= IDENTIFIER_LETTER | DIGIT
1693
1694       --  An IDENTIFIER shall not be a reserved word
1695
1696       --  In the Ada grammar identifiers are the bottom level tokens which have
1697       --  very few semantics. Actual program identifiers are direct names. If
1698       --  we were being 100% honest with the grammar, then we would have a node
1699       --  called N_Direct_Name which would point to an identifier. However,
1700       --  that's too many extra nodes, so we just use the N_Identifier node
1701       --  directly as a direct name, and it contains the expression fields and
1702       --  Entity field that correspond to its use as a direct name. In those
1703       --  few cases where identifiers appear in contexts where they are not
1704       --  direct names (pragmas, pragma argument associations, attribute
1705       --  references and attribute definition clauses), the Chars field of the
1706       --  node contains the Name_Id for the identifier name.
1707
1708       --  Note: in GNAT, a reserved word can be treated as an identifier in two
1709       --  cases. First, an incorrect use of a reserved word as an identifier is
1710       --  diagnosed and then treated as a normal identifier. Second, an
1711       --  attribute designator of the form of a reserved word (access, delta,
1712       --  digits, range) is treated as an identifier.
1713
1714       --  Note: The set of letters that is permitted in an identifier depends
1715       --  on the character set in use. See package Csets for full details.
1716
1717       --  N_Identifier
1718       --  Sloc points to identifier
1719       --  Chars (Name1) contains the Name_Id for the identifier
1720       --  Entity (Node4-Sem)
1721       --  Associated_Node (Node4-Sem)
1722       --  Original_Discriminant (Node2-Sem)
1723       --  Redundant_Use (Flag13-Sem)
1724       --  Has_Private_View (Flag11-Sem) (set in generic units)
1725       --  plus fields for expression
1726
1727       --------------------------
1728       -- 2.4  Numeric Literal --
1729       --------------------------
1730
1731       --  NUMERIC_LITERAL ::= DECIMAL_LITERAL | BASED_LITERAL
1732
1733       ----------------------------
1734       -- 2.4.1  Decimal Literal --
1735       ----------------------------
1736
1737       --  DECIMAL_LITERAL ::= NUMERAL [.NUMERAL] [EXPONENT]
1738
1739       --  NUMERAL ::= DIGIT {[UNDERLINE] DIGIT}
1740
1741       --  EXPONENT ::= E [+] NUMERAL | E - NUMERAL
1742
1743       --  Decimal literals appear in the tree as either integer literal nodes
1744       --  or real literal nodes, depending on whether a period is present.
1745
1746       --  Note: literal nodes appear as a result of direct use of literals
1747       --  in the source program, and also as the result of evaluating
1748       --  expressions at compile time. In the latter case, it is possible
1749       --  to construct real literals that have no syntactic representation
1750       --  using the standard literal format. Such literals are listed by
1751       --  Sprint using the notation [numerator / denominator].
1752
1753       --  Note: the value of an integer literal node created by the front end
1754       --  is never outside the range of values of the base type. However, it
1755       --  can be the case that the value is outside the range of the
1756       --  particular subtype. This happens in the case of integer overflows
1757       --  with checks suppressed.
1758
1759       --  N_Integer_Literal
1760       --  Sloc points to literal
1761       --  Original_Entity (Node2-Sem) If not Empty, holds Named_Number that
1762       --  has been constant-folded into its literal value.
1763       --  Intval (Uint3) contains integer value of literal
1764       --  plus fields for expression
1765       --  Print_In_Hex (Flag13-Sem)
1766
1767       --  N_Real_Literal
1768       --  Sloc points to literal
1769       --  Original_Entity (Node2-Sem) If not Empty, holds Named_Number that
1770       --  has been constant-folded into its literal value.
1771       --  Realval (Ureal3) contains real value of literal
1772       --  Corresponding_Integer_Value (Uint4-Sem)
1773       --  Is_Machine_Number (Flag11-Sem)
1774       --  plus fields for expression
1775
1776       --------------------------
1777       -- 2.4.2  Based Literal --
1778       --------------------------
1779
1780       --  BASED_LITERAL ::=
1781       --   BASE # BASED_NUMERAL [.BASED_NUMERAL] # [EXPONENT]
1782
1783       --  BASE ::= NUMERAL
1784
1785       --  BASED_NUMERAL ::=
1786       --    EXTENDED_DIGIT {[UNDERLINE] EXTENDED_DIGIT}
1787
1788       --  EXTENDED_DIGIT ::= DIGIT | A | B | C | D | E | F
1789
1790       --  Based literals appear in the tree as either integer literal nodes
1791       --  or real literal nodes, depending on whether a period is present.
1792
1793       ----------------------------
1794       -- 2.5  Character Literal --
1795       ----------------------------
1796
1797       --  CHARACTER_LITERAL ::= ' GRAPHIC_CHARACTER '
1798
1799       --  N_Character_Literal
1800       --  Sloc points to literal
1801       --  Chars (Name1) contains the Name_Id for the identifier
1802       --  Char_Literal_Value (Uint2) contains the literal value
1803       --  Entity (Node4-Sem)
1804       --  Associated_Node (Node4-Sem)
1805       --  Has_Private_View (Flag11-Sem) set in generic units.
1806       --  plus fields for expression
1807
1808       --  Note: the Entity field will be missing (set to Empty) for character
1809       --  literals whose type is Standard.Wide_Character or Standard.Character
1810       --  or a type derived from one of these two. In this case the character
1811       --  literal stands for its own coding. The reason we take this irregular
1812       --  short cut is to avoid the need to build lots of junk defining
1813       --  character literal nodes.
1814
1815       -------------------------
1816       -- 2.6  String Literal --
1817       -------------------------
1818
1819       --  STRING LITERAL ::= "{STRING_ELEMENT}"
1820
1821       --  A STRING_ELEMENT is either a pair of quotation marks ("), or a
1822       --  single GRAPHIC_CHARACTER other than a quotation mark.
1823
1824       --  N_String_Literal
1825       --  Sloc points to literal
1826       --  Strval (Str3) contains Id of string value
1827       --  Has_Wide_Character (Flag11-Sem)
1828       --  plus fields for expression
1829
1830       ------------------
1831       -- 2.7  Comment --
1832       ------------------
1833
1834       --  A COMMENT starts with two adjacent hyphens and extends up to the
1835       --  end of the line. A COMMENT may appear on any line of a program.
1836
1837       --  Comments are skipped by the scanner and do not appear in the tree.
1838       --  It is possible to reconstruct the position of comments with respect
1839       --  to the elements of the tree by using the source position (Sloc)
1840       --  pointers that appear in every tree node.
1841
1842       -----------------
1843       -- 2.8  Pragma --
1844       -----------------
1845
1846       --  PRAGMA ::= pragma IDENTIFIER
1847       --    [(PRAGMA_ARGUMENT_ASSOCIATION {, PRAGMA_ARGUMENT_ASSOCIATION})];
1848
1849       --  Note that a pragma may appear in the tree anywhere a declaration
1850       --  or a statement may appear, as well as in some other situations
1851       --  which are explicitly documented.
1852
1853       --  N_Pragma
1854       --  Sloc points to PRAGMA
1855       --  Chars (Name1) identifier name from pragma identifier
1856       --  Pragma_Argument_Associations (List2) (set to No_List if none)
1857       --  Debug_Statement (Node3) (set to Empty if not Debug, Assert)
1858       --  Next_Rep_Item (Node5-Sem)
1859
1860       --  Note: we should have a section on what pragmas are passed on to
1861       --  the back end to be processed. This section should note that pragma
1862       --  Psect_Object is always converted to Common_Object, but there are
1863       --  undoubtedly many other similar notes required ???
1864
1865       --------------------------------------
1866       -- 2.8  Pragma Argument Association --
1867       --------------------------------------
1868
1869       --  PRAGMA_ARGUMENT_ASSOCIATION ::=
1870       --    [pragma_argument_IDENTIFIER =>] NAME
1871       --  | [pragma_argument_IDENTIFIER =>] EXPRESSION
1872
1873       --  N_Pragma_Argument_Association
1874       --  Sloc points to first token in association
1875       --  Chars (Name1) (set to No_Name if no pragma argument identifier)
1876       --  Expression (Node3)
1877
1878       ------------------------
1879       -- 2.9  Reserved Word --
1880       ------------------------
1881
1882       --  Reserved words are parsed by the scanner, and returned as the
1883       --  corresponding token types (e.g. PACKAGE is returned as Tok_Package)
1884
1885       ----------------------------
1886       -- 3.1  Basic Declaration --
1887       ----------------------------
1888
1889       --  BASIC_DECLARATION ::=
1890       --    TYPE_DECLARATION          | SUBTYPE_DECLARATION
1891       --  | OBJECT_DECLARATION        | NUMBER_DECLARATION
1892       --  | SUBPROGRAM_DECLARATION    | ABSTRACT_SUBPROGRAM_DECLARATION
1893       --  | PACKAGE_DECLARATION       | RENAMING_DECLARATION
1894       --  | EXCEPTION_DECLARATION     | GENERIC_DECLARATION
1895       --  | GENERIC_INSTANTIATION
1896
1897       --  Basic declaration also includes IMPLICIT_LABEL_DECLARATION
1898       --  see further description in section on semantic nodes.
1899
1900       --  Also, in the tree that is constructed, a pragma may appear
1901       --  anywhere that a declaration may appear.
1902
1903       ------------------------------
1904       -- 3.1  Defining Identifier --
1905       ------------------------------
1906
1907       --  DEFINING_IDENTIFIER ::= IDENTIFIER
1908
1909       --  A defining identifier is an entity, which has additional fields
1910       --  depending on the setting of the Ekind field. These additional
1911       --  fields are defined (and access subprograms declared) in package
1912       --  Einfo.
1913
1914       --  Note: N_Defining_Identifier is an extended node whose fields are
1915       --  deliberate layed out to match the layout of fields in an ordinary
1916       --  N_Identifier node allowing for easy alteration of an identifier
1917       --  node into a defining identifier node. For details, see procedure
1918       --  Sinfo.CN.Change_Identifier_To_Defining_Identifier.
1919
1920       --  N_Defining_Identifier
1921       --  Sloc points to identifier
1922       --  Chars (Name1) contains the Name_Id for the identifier
1923       --  Next_Entity (Node2-Sem)
1924       --  Scope (Node3-Sem)
1925       --  Etype (Node5-Sem)
1926
1927       -----------------------------
1928       -- 3.2.1  Type Declaration --
1929       -----------------------------
1930
1931       --  TYPE_DECLARATION ::=
1932       --    FULL_TYPE_DECLARATION
1933       --  | INCOMPLETE_TYPE_DECLARATION
1934       --  | PRIVATE_TYPE_DECLARATION
1935       --  | PRIVATE_EXTENSION_DECLARATION
1936
1937       ----------------------------------
1938       -- 3.2.1  Full Type Declaration --
1939       ----------------------------------
1940
1941       --  FULL_TYPE_DECLARATION ::=
1942       --    type DEFINING_IDENTIFIER [KNOWN_DISCRIMINANT_PART]
1943       --      is TYPE_DEFINITION;
1944       --  | TASK_TYPE_DECLARATION
1945       --  | PROTECTED_TYPE_DECLARATION
1946
1947       --  The full type declaration node is used only for the first case. The
1948       --  second case (concurrent type declaration), is represented directly
1949       --  by a task type declaration or a protected type declaration.
1950
1951       --  N_Full_Type_Declaration
1952       --  Sloc points to TYPE
1953       --  Defining_Identifier (Node1)
1954       --  Discriminant_Specifications (List4) (set to No_List if none)
1955       --  Type_Definition (Node3)
1956       --  Discr_Check_Funcs_Built (Flag11-Sem)
1957
1958       ----------------------------
1959       -- 3.2.1  Type Definition --
1960       ----------------------------
1961
1962       --  TYPE_DEFINITION ::=
1963       --    ENUMERATION_TYPE_DEFINITION  | INTEGER_TYPE_DEFINITION
1964       --  | REAL_TYPE_DEFINITION         | ARRAY_TYPE_DEFINITION
1965       --  | RECORD_TYPE_DEFINITION       | ACCESS_TYPE_DEFINITION
1966       --  | DERIVED_TYPE_DEFINITION      | INTERFACE_TYPE_DEFINITION
1967
1968       --------------------------------
1969       -- 3.2.2  Subtype Declaration --
1970       --------------------------------
1971
1972       --  SUBTYPE_DECLARATION ::=
1973       --    subtype DEFINING_IDENTIFIER is [NULL_EXCLUSION] SUBTYPE_INDICATION;
1974
1975       --  The subtype indication field is set to Empty for subtypes
1976       --  declared in package Standard (Positive, Natural).
1977
1978       --  N_Subtype_Declaration
1979       --  Sloc points to SUBTYPE
1980       --  Defining_Identifier (Node1)
1981       --  Null_Exclusion_Present (Flag11)
1982       --  Subtype_Indication (Node5)
1983       --  Generic_Parent_Type (Node4-Sem) (set for an actual derived type).
1984       --  Exception_Junk (Flag8-Sem)
1985
1986       -------------------------------
1987       -- 3.2.2  Subtype Indication --
1988       -------------------------------
1989
1990       --  SUBTYPE_INDICATION ::= SUBTYPE_MARK [CONSTRAINT]
1991
1992       --  Note: if no constraint is present, the subtype indication appears
1993       --  directly in the tree as a subtype mark. The N_Subtype_Indication
1994       --  node is used only if a constraint is present.
1995
1996       --  Note: [For Ada 2005 (AI-231)]: Because Ada 2005 extends this rule
1997       --  with the null-exclusion part (see AI-231), we had to introduce a new
1998       --  attribute in all the parents of subtype_indication nodes to indicate
1999       --  if the null-exclusion is present.
2000
2001       --  Note: the reason that this node has expression fields is that a
2002       --  subtype indication can appear as an operand of a membership test.
2003
2004       --  N_Subtype_Indication
2005       --  Sloc points to first token of subtype mark
2006       --  Subtype_Mark (Node4)
2007       --  Constraint (Node3)
2008       --  Etype (Node5-Sem)
2009       --  Must_Not_Freeze (Flag8-Sem)
2010
2011       --  Note: Etype is a copy of the Etype field of the Subtype_Mark. The
2012       --  reason for this redundancy is so that in a list of array index types,
2013       --  the Etype can be uniformly accessed to determine the subscript type.
2014       --  This means that no Itype is constructed for the actual subtype that
2015       --  is created by the subtype indication. If such an Itype is required,
2016       --  it is constructed in the context in which the indication appears.
2017
2018       -------------------------
2019       -- 3.2.2  Subtype Mark --
2020       -------------------------
2021
2022       --  SUBTYPE_MARK ::= subtype_NAME
2023
2024       -----------------------
2025       -- 3.2.2  Constraint --
2026       -----------------------
2027
2028       --  CONSTRAINT ::= SCALAR_CONSTRAINT | COMPOSITE_CONSTRAINT
2029
2030       ------------------------------
2031       -- 3.2.2  Scalar Constraint --
2032       ------------------------------
2033
2034       --  SCALAR_CONSTRAINT ::=
2035       --    RANGE_CONSTRAINT | DIGITS_CONSTRAINT | DELTA_CONSTRAINT
2036
2037       ---------------------------------
2038       -- 3.2.2  Composite Constraint --
2039       ---------------------------------
2040
2041       --  COMPOSITE_CONSTRAINT ::=
2042       --    INDEX_CONSTRAINT | DISCRIMINANT_CONSTRAINT
2043
2044       -------------------------------
2045       -- 3.3.1  Object Declaration --
2046       -------------------------------
2047
2048       --  OBJECT_DECLARATION ::=
2049       --    DEFINING_IDENTIFIER_LIST : [aliased] [constant]
2050       --      [NULL_EXCLUSION] SUBTYPE_INDICATION [:= EXPRESSION];
2051       --  | DEFINING_IDENTIFIER_LIST : [aliased] [constant]
2052       --      ACCESS_DEFINITION [:= EXPRESSION];
2053       --  | DEFINING_IDENTIFIER_LIST : [aliased] [constant]
2054       --      ARRAY_TYPE_DEFINITION [:= EXPRESSION];
2055       --  | SINGLE_TASK_DECLARATION
2056       --  | SINGLE_PROTECTED_DECLARATION
2057
2058       --  Note: aliased is not permitted in Ada 83 mode
2059
2060       --  The N_Object_Declaration node is only for the first two cases.
2061       --  Single task declaration is handled by P_Task (9.1)
2062       --  Single protected declaration is handled by P_protected (9.5)
2063
2064       --  Although the syntax allows multiple identifiers in the list, the
2065       --  semantics is as though successive declarations were given with
2066       --  identical type definition and expression components. To simplify
2067       --  semantic processing, the parser represents a multiple declaration
2068       --  case as a sequence of single declarations, using the More_Ids and
2069       --  Prev_Ids flags to preserve the original source form as described
2070       --  in the section on "Handling of Defining Identifier Lists".
2071
2072       --  The flag Has_Init_Expression is set if an initializing expression
2073       --  is present. Normally it is set if and only if Expression contains
2074       --  a non-empty value, but there is an exception to this. When the
2075       --  initializing expression is an aggregate which requires explicit
2076       --  assignments, the Expression field gets set to Empty, but this flag
2077       --  is still set, so we don't forget we had an initializing expression.
2078
2079       --  Note: if a range check is required for the initialization
2080       --  expression then the Do_Range_Check flag is set in the Expression,
2081       --  with the check being done against the type given by the object
2082       --  definition, which is also the Etype of the defining identifier.
2083
2084       --  Note: the contents of the Expression field must be ignored (i.e.
2085       --  treated as though it were Empty) if No_Initialization is set True.
2086
2087       --  Note: the back end places some restrictions on the form of the
2088       --  Expression field. If the object being declared is Atomic, then
2089       --  the Expression may not have the form of an aggregate (since this
2090       --  might cause the back end to generate separate assignments). It
2091       --  also cannot be a reference to an object marked as a true constant
2092       --  (Is_True_Constant flag set), where the object is itself initalized
2093       --  with an aggregate. If necessary the front end must generate an
2094       --  extra temporary (with Is_True_Constant set False), and initialize
2095       --  this temporary as required (the temporary itself is not atomic).
2096
2097       --  Note: there is not node kind for object definition. Instead, the
2098       --  corresponding field holds a subtype indication, an array type
2099       --  definition, or (Ada 2005, AI-406) an access definition.
2100
2101       --  N_Object_Declaration
2102       --  Sloc points to first identifier
2103       --  Defining_Identifier (Node1)
2104       --  Aliased_Present (Flag4) set if ALIASED appears
2105       --  Constant_Present (Flag17) set if CONSTANT appears
2106       --  Null_Exclusion_Present (Flag11)
2107       --  Object_Definition (Node4) subtype indic./array type def./ access def.
2108       --  Expression (Node3) (set to Empty if not present)
2109       --  Handler_List_Entry (Node2-Sem)
2110       --  Corresponding_Generic_Association (Node5-Sem)
2111       --  More_Ids (Flag5) (set to False if no more identifiers in list)
2112       --  Prev_Ids (Flag6) (set to False if no previous identifiers in list)
2113       --  No_Initialization (Flag13-Sem)
2114       --  Assignment_OK (Flag15-Sem)
2115       --  Exception_Junk (Flag8-Sem)
2116       --  Is_Subprogram_Descriptor (Flag16-Sem)
2117       --  Has_Init_Expression (Flag14)
2118
2119       -------------------------------------
2120       -- 3.3.1  Defining Identifier List --
2121       -------------------------------------
2122
2123       --  DEFINING_IDENTIFIER_LIST ::=
2124       --    DEFINING_IDENTIFIER {, DEFINING_IDENTIFIER}
2125
2126       -------------------------------
2127       -- 3.3.2  Number Declaration --
2128       -------------------------------
2129
2130       --  NUMBER_DECLARATION ::=
2131       --    DEFINING_IDENTIFIER_LIST : constant := static_EXPRESSION;
2132
2133       --  Although the syntax allows multiple identifiers in the list, the
2134       --  semantics is as though successive declarations were given with
2135       --  identical expressions. To simplify semantic processing, the parser
2136       --  represents a multiple declaration case as a sequence of single
2137       --  declarations, using the More_Ids and Prev_Ids flags to preserve
2138       --  the original source form as described in the section on "Handling
2139       --  of Defining Identifier Lists".
2140
2141       --  N_Number_Declaration
2142       --  Sloc points to first identifier
2143       --  Defining_Identifier (Node1)
2144       --  Expression (Node3)
2145       --  More_Ids (Flag5) (set to False if no more identifiers in list)
2146       --  Prev_Ids (Flag6) (set to False if no previous identifiers in list)
2147
2148       ----------------------------------
2149       -- 3.4  Derived Type Definition --
2150       ----------------------------------
2151
2152       --  DERIVED_TYPE_DEFINITION ::=
2153       --    [abstract] [limited] new [NULL_EXCLUSION] parent_SUBTYPE_INDICATION
2154       --    [[and INTERFACE_LIST] RECORD_EXTENSION_PART]
2155
2156       --  Note: ABSTRACT, LIMITED and record extension part are not permitted
2157       --  in Ada 83 mode
2158
2159       --  Note: a record extension part is required if ABSTRACT is present
2160
2161       --  N_Derived_Type_Definition
2162       --  Sloc points to NEW
2163       --  Abstract_Present (Flag4)
2164       --  Null_Exclusion_Present (Flag11) (set to False if not present)
2165       --  Subtype_Indication (Node5)
2166       --  Record_Extension_Part (Node3) (set to Empty if not present)
2167       --  Limited_Present (Flag17)
2168       --  Task_Present (Flag5) set in task interfaces
2169       --  Protected_Present (Flag6) set in protected interfaces
2170       --  Synchronized_Present (Flag7) set in interfaces
2171       --  Interface_List (List2) (set to No_List if none)
2172       --  Interface_Present (Flag16) set in abstract interfaces
2173
2174       --  Note: Task_Present, Protected_Present, Synchronized_Present,
2175       --        Interface_List, and Interface_Present are used for abstract
2176       --        interfaces (see comments for INTERFACE_TYPE_DEFINITION).
2177
2178       ---------------------------
2179       -- 3.5  Range Constraint --
2180       ---------------------------
2181
2182       --  RANGE_CONSTRAINT ::= range RANGE
2183
2184       --  N_Range_Constraint
2185       --  Sloc points to RANGE
2186       --  Range_Expression (Node4)
2187
2188       ----------------
2189       -- 3.5  Range --
2190       ----------------
2191
2192       --  RANGE ::=
2193       --    RANGE_ATTRIBUTE_REFERENCE
2194       --  | SIMPLE_EXPRESSION .. SIMPLE_EXPRESSION
2195
2196       --  Note: the case of a range given as a range attribute reference
2197       --  appears directly in the tree as an attribute reference.
2198
2199       --  Note: the field name for a reference to a range is Range_Expression
2200       --  rather than Range, because range is a reserved keyword in Ada!
2201
2202       --  Note: the reason that this node has expression fields is that a
2203       --  range can appear as an operand of a membership test. The Etype
2204       --  field is the type of the range (we do NOT construct an implicit
2205       --  subtype to represent the range exactly).
2206
2207       --  N_Range
2208       --  Sloc points to ..
2209       --  Low_Bound (Node1)
2210       --  High_Bound (Node2)
2211       --  Includes_Infinities (Flag11)
2212       --  plus fields for expression
2213
2214       --  Note: if the range appears in a context, such as a subtype
2215       --  declaration, where range checks are required on one or both of
2216       --  the expression fields, then type conversion nodes are inserted
2217       --  to represent the required checks.
2218
2219       ----------------------------------------
2220       -- 3.5.1  Enumeration Type Definition --
2221       ----------------------------------------
2222
2223       --  ENUMERATION_TYPE_DEFINITION ::=
2224       --    (ENUMERATION_LITERAL_SPECIFICATION
2225       --      {, ENUMERATION_LITERAL_SPECIFICATION})
2226
2227       --  Note: the Literals field in the node described below is null for
2228       --  the case of the standard types CHARACTER and WIDE_CHARACTER, for
2229       --  which special processing handles these types as special cases.
2230
2231       --  N_Enumeration_Type_Definition
2232       --  Sloc points to left parenthesis
2233       --  Literals (List1) (Empty for CHARACTER or WIDE_CHARACTER)
2234       --  End_Label (Node4) (set to Empty if internally generated record)
2235
2236       ----------------------------------------------
2237       -- 3.5.1  Enumeration Literal Specification --
2238       ----------------------------------------------
2239
2240       --  ENUMERATION_LITERAL_SPECIFICATION ::=
2241       --    DEFINING_IDENTIFIER | DEFINING_CHARACTER_LITERAL
2242
2243       ---------------------------------------
2244       -- 3.5.1  Defining Character Literal --
2245       ---------------------------------------
2246
2247       --  DEFINING_CHARACTER_LITERAL ::= CHARACTER_LITERAL
2248
2249       --  A defining character literal is an entity, which has additional
2250       --  fields depending on the setting of the Ekind field. These
2251       --  additional fields are defined (and access subprograms declared)
2252       --  in package Einfo.
2253
2254       --  Note: N_Defining_Character_Literal is an extended node whose fields
2255       --  are deliberate layed out to match the layout of fields in an ordinary
2256       --  N_Character_Literal node allowing for easy alteration of a character
2257       --  literal node into a defining character literal node. For details, see
2258       --  Sinfo.CN.Change_Character_Literal_To_Defining_Character_Literal.
2259
2260       --  N_Defining_Character_Literal
2261       --  Sloc points to literal
2262       --  Chars (Name1) contains the Name_Id for the identifier
2263       --  Next_Entity (Node2-Sem)
2264       --  Scope (Node3-Sem)
2265       --  Etype (Node5-Sem)
2266
2267       ------------------------------------
2268       -- 3.5.4  Integer Type Definition --
2269       ------------------------------------
2270
2271       --  Note: there is an error in this rule in the latest version of the
2272       --  grammar, so we have retained the old rule pending clarification.
2273
2274       --  INTEGER_TYPE_DEFINITION ::=
2275       --    SIGNED_INTEGER_TYPE_DEFINITION
2276       --  | MODULAR_TYPE_DEFINITION
2277
2278       -------------------------------------------
2279       -- 3.5.4  Signed Integer Type Definition --
2280       -------------------------------------------
2281
2282       --  SIGNED_INTEGER_TYPE_DEFINITION ::=
2283       --    range static_SIMPLE_EXPRESSION .. static_SIMPLE_EXPRESSION
2284
2285       --  Note: the Low_Bound and High_Bound fields are set to Empty
2286       --  for integer types defined in package Standard.
2287
2288       --  N_Signed_Integer_Type_Definition
2289       --  Sloc points to RANGE
2290       --  Low_Bound (Node1)
2291       --  High_Bound (Node2)
2292
2293       ------------------------------------
2294       -- 3.5.4  Modular Type Definition --
2295       ------------------------------------
2296
2297       --  MODULAR_TYPE_DEFINITION ::= mod static_EXPRESSION
2298
2299       --  N_Modular_Type_Definition
2300       --  Sloc points to MOD
2301       --  Expression (Node3)
2302
2303       ---------------------------------
2304       -- 3.5.6  Real Type Definition --
2305       ---------------------------------
2306
2307       --  REAL_TYPE_DEFINITION ::=
2308       --    FLOATING_POINT_DEFINITION | FIXED_POINT_DEFINITION
2309
2310       --------------------------------------
2311       -- 3.5.7  Floating Point Definition --
2312       --------------------------------------
2313
2314       --  FLOATING_POINT_DEFINITION ::=
2315       --    digits static_SIMPLE_EXPRESSION [REAL_RANGE_SPECIFICATION]
2316
2317       --  Note: The Digits_Expression and Real_Range_Specifications fields
2318       --  are set to Empty for floating-point types declared in Standard.
2319
2320       --  N_Floating_Point_Definition
2321       --  Sloc points to DIGITS
2322       --  Digits_Expression (Node2)
2323       --  Real_Range_Specification (Node4) (set to Empty if not present)
2324
2325       -------------------------------------
2326       -- 3.5.7  Real Range Specification --
2327       -------------------------------------
2328
2329       --  REAL_RANGE_SPECIFICATION ::=
2330       --    range static_SIMPLE_EXPRESSION .. static_SIMPLE_EXPRESSION
2331
2332       --  N_Real_Range_Specification
2333       --  Sloc points to RANGE
2334       --  Low_Bound (Node1)
2335       --  High_Bound (Node2)
2336
2337       -----------------------------------
2338       -- 3.5.9  Fixed Point Definition --
2339       -----------------------------------
2340
2341       --  FIXED_POINT_DEFINITION ::=
2342       --    ORDINARY_FIXED_POINT_DEFINITION | DECIMAL_FIXED_POINT_DEFINITION
2343
2344       --------------------------------------------
2345       -- 3.5.9  Ordinary Fixed Point Definition --
2346       --------------------------------------------
2347
2348       --  ORDINARY_FIXED_POINT_DEFINITION ::=
2349       --    delta static_EXPRESSION REAL_RANGE_SPECIFICATION
2350
2351       --  Note: In Ada 83, the EXPRESSION must be a SIMPLE_EXPRESSION
2352
2353       --  N_Ordinary_Fixed_Point_Definition
2354       --  Sloc points to DELTA
2355       --  Delta_Expression (Node3)
2356       --  Real_Range_Specification (Node4)
2357
2358       -------------------------------------------
2359       -- 3.5.9  Decimal Fixed Point Definition --
2360       -------------------------------------------
2361
2362       --  DECIMAL_FIXED_POINT_DEFINITION ::=
2363       --    delta static_EXPRESSION
2364       --      digits static_EXPRESSION [REAL_RANGE_SPECIFICATION]
2365
2366       --  Note: decimal types are not permitted in Ada 83 mode
2367
2368       --  N_Decimal_Fixed_Point_Definition
2369       --  Sloc points to DELTA
2370       --  Delta_Expression (Node3)
2371       --  Digits_Expression (Node2)
2372       --  Real_Range_Specification (Node4) (set to Empty if not present)
2373
2374       ------------------------------
2375       -- 3.5.9  Digits Constraint --
2376       ------------------------------
2377
2378       --  DIGITS_CONSTRAINT ::=
2379       --    digits static_EXPRESSION [RANGE_CONSTRAINT]
2380
2381       --  Note: in Ada 83, the EXPRESSION must be a SIMPLE_EXPRESSION
2382       --  Note: in Ada 95, reduced accuracy subtypes are obsolescent
2383
2384       --  N_Digits_Constraint
2385       --  Sloc points to DIGITS
2386       --  Digits_Expression (Node2)
2387       --  Range_Constraint (Node4) (set to Empty if not present)
2388
2389       --------------------------------
2390       -- 3.6  Array Type Definition --
2391       --------------------------------
2392
2393       --  ARRAY_TYPE_DEFINITION ::=
2394       --    UNCONSTRAINED_ARRAY_DEFINITION | CONSTRAINED_ARRAY_DEFINITION
2395
2396       -----------------------------------------
2397       -- 3.6  Unconstrained Array Definition --
2398       -----------------------------------------
2399
2400       --  UNCONSTRAINED_ARRAY_DEFINITION ::=
2401       --    array (INDEX_SUBTYPE_DEFINITION {, INDEX_SUBTYPE_DEFINITION}) of
2402       --      COMPONENT_DEFINITION
2403
2404       --  Note: dimensionality of array is indicated by number of entries in
2405       --  the Subtype_Marks list, which has one entry for each dimension.
2406
2407       --  N_Unconstrained_Array_Definition
2408       --  Sloc points to ARRAY
2409       --  Subtype_Marks (List2)
2410       --  Component_Definition (Node4)
2411
2412       -----------------------------------
2413       -- 3.6  Index Subtype Definition --
2414       -----------------------------------
2415
2416       --  INDEX_SUBTYPE_DEFINITION ::= SUBTYPE_MARK range <>
2417
2418       --  There is no explicit node in the tree for an index subtype
2419       --  definition since the N_Unconstrained_Array_Definition node
2420       --  incorporates the type marks which appear in this context.
2421
2422       ---------------------------------------
2423       -- 3.6  Constrained Array Definition --
2424       ---------------------------------------
2425
2426       --  CONSTRAINED_ARRAY_DEFINITION ::=
2427       --    array (DISCRETE_SUBTYPE_DEFINITION
2428       --      {, DISCRETE_SUBTYPE_DEFINITION})
2429       --        of COMPONENT_DEFINITION
2430
2431       --  Note: dimensionality of array is indicated by number of entries
2432       --  in the Discrete_Subtype_Definitions list, which has one entry
2433       --  for each dimension.
2434
2435       --  N_Constrained_Array_Definition
2436       --  Sloc points to ARRAY
2437       --  Discrete_Subtype_Definitions (List2)
2438       --  Component_Definition (Node4)
2439
2440       --------------------------------------
2441       -- 3.6  Discrete Subtype Definition --
2442       --------------------------------------
2443
2444       --  DISCRETE_SUBTYPE_DEFINITION ::=
2445       --    discrete_SUBTYPE_INDICATION | RANGE
2446
2447       -------------------------------
2448       -- 3.6  Component Definition --
2449       -------------------------------
2450
2451       --  COMPONENT_DEFINITION ::=
2452       --    [aliased] [NULL_EXCLUSION] SUBTYPE_INDICATION | ACCESS_DEFINITION
2453
2454       --  Note: although the syntax does not permit a component definition to
2455       --  be an anonymous array (and the parser will diagnose such an attempt
2456       --  with an appropriate message), it is possible for anonymous arrays
2457       --  to appear as component definitions. The semantics and back end handle
2458       --  this case properly, and the expander in fact generates such cases.
2459       --  Access_Definition is an optional field that gives support to
2460       --  Ada 2005 (AI-230). The parser generates nodes that have either the
2461       --  Subtype_Indication field or else the Access_Definition field.
2462
2463       --  N_Component_Definition
2464       --  Sloc points to ALIASED, ACCESS or to first token of subtype mark
2465       --  Aliased_Present (Flag4)
2466       --  Null_Exclusion_Present (Flag11)
2467       --  Subtype_Indication (Node5) (set to Empty if not present)
2468       --  Access_Definition (Node3) (set to Empty if not present)
2469
2470       -----------------------------
2471       -- 3.6.1  Index Constraint --
2472       -----------------------------
2473
2474       --  INDEX_CONSTRAINT ::= (DISCRETE_RANGE {, DISCRETE_RANGE})
2475
2476       --  It is not in general possible to distinguish between discriminant
2477       --  constraints and index constraints at parse time, since a simple
2478       --  name could be either the subtype mark of a discrete range, or an
2479       --  expression in a discriminant association with no name. Either
2480       --  entry appears simply as the name, and the semantic parse must
2481       --  distinguish between the two cases. Thus we use a common tree
2482       --  node format for both of these constraint types.
2483
2484       --  See Discriminant_Constraint for format of node
2485
2486       ---------------------------
2487       -- 3.6.1  Discrete Range --
2488       ---------------------------
2489
2490       --  DISCRETE_RANGE ::= discrete_SUBTYPE_INDICATION | RANGE
2491
2492       ----------------------------
2493       -- 3.7  Discriminant Part --
2494       ----------------------------
2495
2496       --  DISCRIMINANT_PART ::=
2497       --    UNKNOWN_DISCRIMINANT_PART | KNOWN_DISCRIMINANT_PART
2498
2499       ------------------------------------
2500       -- 3.7  Unknown Discriminant Part --
2501       ------------------------------------
2502
2503       --  UNKNOWN_DISCRIMINANT_PART ::= (<>)
2504
2505       --  Note: unknown discriminant parts are not permitted in Ada 83 mode
2506
2507       --  There is no explicit node in the tree for an unknown discriminant
2508       --  part. Instead the Unknown_Discriminants_Present flag is set in the
2509       --  parent node.
2510
2511       ----------------------------------
2512       -- 3.7  Known Discriminant Part --
2513       ----------------------------------
2514
2515       --  KNOWN_DISCRIMINANT_PART ::=
2516       --    (DISCRIMINANT_SPECIFICATION {; DISCRIMINANT_SPECIFICATION})
2517
2518       -------------------------------------
2519       -- 3.7  Discriminant Specification --
2520       -------------------------------------
2521
2522       --  DISCRIMINANT_SPECIFICATION ::=
2523       --    DEFINING_IDENTIFIER_LIST : [NULL_EXCLUSION] SUBTYPE_MARK
2524       --      [:= DEFAULT_EXPRESSION]
2525       --  | DEFINING_IDENTIFIER_LIST : ACCESS_DEFINITION
2526       --      [:= DEFAULT_EXPRESSION]
2527
2528       --  Although the syntax allows multiple identifiers in the list, the
2529       --  semantics is as though successive specifications were given with
2530       --  identical type definition and expression components. To simplify
2531       --  semantic processing, the parser represents a multiple declaration
2532       --  case as a sequence of single specifications, using the More_Ids and
2533       --  Prev_Ids flags to preserve the original source form as described
2534       --  in the section on "Handling of Defining Identifier Lists".
2535
2536       --  N_Discriminant_Specification
2537       --  Sloc points to first identifier
2538       --  Defining_Identifier (Node1)
2539       --  Null_Exclusion_Present (Flag11)
2540       --  Discriminant_Type (Node5) subtype mark or access parameter definition
2541       --  Expression (Node3) (set to Empty if no default expression)
2542       --  More_Ids (Flag5) (set to False if no more identifiers in list)
2543       --  Prev_Ids (Flag6) (set to False if no previous identifiers in list)
2544
2545       -----------------------------
2546       -- 3.7  Default Expression --
2547       -----------------------------
2548
2549       --  DEFAULT_EXPRESSION ::= EXPRESSION
2550
2551       ------------------------------------
2552       -- 3.7.1  Discriminant Constraint --
2553       ------------------------------------
2554
2555       --  DISCRIMINANT_CONSTRAINT ::=
2556       --    (DISCRIMINANT_ASSOCIATION {, DISCRIMINANT_ASSOCIATION})
2557
2558       --  It is not in general possible to distinguish between discriminant
2559       --  constraints and index constraints at parse time, since a simple
2560       --  name could be either the subtype mark of a discrete range, or an
2561       --  expression in a discriminant association with no name. Either
2562       --  entry appears simply as the name, and the semantic parse must
2563       --  distinguish between the two cases. Thus we use a common tree
2564       --  node format for both of these constraint types.
2565
2566       --  N_Index_Or_Discriminant_Constraint
2567       --  Sloc points to left paren
2568       --  Constraints (List1) points to list of discrete ranges or
2569       --    discriminant associations
2570
2571       -------------------------------------
2572       -- 3.7.1  Discriminant Association --
2573       -------------------------------------
2574
2575       --  DISCRIMINANT_ASSOCIATION ::=
2576       --    [discriminant_SELECTOR_NAME
2577       --      {| discriminant_SELECTOR_NAME} =>] EXPRESSION
2578
2579       --  Note: a discriminant association that has no selector name list
2580       --  appears directly as an expression in the tree.
2581
2582       --  N_Discriminant_Association
2583       --  Sloc points to first token of discriminant association
2584       --  Selector_Names (List1) (always non-empty, since if no selector
2585       --   names are present, this node is not used, see comment above)
2586       --  Expression (Node3)
2587
2588       ---------------------------------
2589       -- 3.8  Record Type Definition --
2590       ---------------------------------
2591
2592       --  RECORD_TYPE_DEFINITION ::=
2593       --    [[abstract] tagged] [limited] RECORD_DEFINITION
2594
2595       --  Note: ABSTRACT, TAGGED, LIMITED are not permitted in Ada 83 mode
2596
2597       --  There is no explicit node in the tree for a record type definition.
2598       --  Instead the flags for Tagged_Present and Limited_Present appear in
2599       --  the N_Record_Definition node for a record definition appearing in
2600       --  the context of a record type definition.
2601
2602       ----------------------------
2603       -- 3.8  Record Definition --
2604       ----------------------------
2605
2606       --  RECORD_DEFINITION ::=
2607       --    record
2608       --      COMPONENT_LIST
2609       --    end record
2610       --  | null record
2611
2612       --  Note: the Abstract_Present, Tagged_Present and Limited_Present
2613       --  flags appear only for a record definition appearing in a record
2614       --  type definition.
2615
2616       --  Note: the NULL RECORD case is not permitted in Ada 83
2617
2618       --  N_Record_Definition
2619       --  Sloc points to RECORD or NULL
2620       --  End_Label (Node4) (set to Empty if internally generated record)
2621       --  Abstract_Present (Flag4)
2622       --  Tagged_Present (Flag15)
2623       --  Limited_Present (Flag17)
2624       --  Component_List (Node1) empty in null record case
2625       --  Null_Present (Flag13) set in null record case
2626       --  Task_Present (Flag5) set in task interfaces
2627       --  Protected_Present (Flag6) set in protected interfaces
2628       --  Synchronized_Present (Flag7) set in interfaces
2629       --  Interface_Present (Flag16) set in abstract interfaces
2630       --  Interface_List (List2) (set to No_List if none)
2631
2632       --  Note: Task_Present, Protected_Present, Synchronized _Present,
2633       --        Interface_List and Interface_Present are used for abstract
2634       --        interfaces (see comments for INTERFACE_TYPE_DEFINITION).
2635
2636       -------------------------
2637       -- 3.8  Component List --
2638       -------------------------
2639
2640       --  COMPONENT_LIST ::=
2641       --    COMPONENT_ITEM {COMPONENT_ITEM}
2642       --  | {COMPONENT_ITEM} VARIANT_PART
2643       --  | null;
2644
2645       --  N_Component_List
2646       --  Sloc points to first token of component list
2647       --  Component_Items (List3)
2648       --  Variant_Part (Node4) (set to Empty if no variant part)
2649       --  Null_Present (Flag13)
2650
2651       -------------------------
2652       -- 3.8  Component Item --
2653       -------------------------
2654
2655       --  COMPONENT_ITEM ::= COMPONENT_DECLARATION | REPRESENTATION_CLAUSE
2656
2657       --  Note: A component item can also be a pragma, and in the tree
2658       --  that is obtained after semantic processing, a component item
2659       --  can be an N_Null node resulting from a non-recognized pragma.
2660
2661       --------------------------------
2662       -- 3.8  Component Declaration --
2663       --------------------------------
2664
2665       --  COMPONENT_DECLARATION ::=
2666       --    DEFINING_IDENTIFIER_LIST : COMPONENT_DEFINITION
2667       --      [:= DEFAULT_EXPRESSION]
2668
2669       --  Note: although the syntax does not permit a component definition to
2670       --  be an anonymous array (and the parser will diagnose such an attempt
2671       --  with an appropriate message), it is possible for anonymous arrays
2672       --  to appear as component definitions. The semantics and back end handle
2673       --  this case properly, and the expander in fact generates such cases.
2674
2675       --  Although the syntax allows multiple identifiers in the list, the
2676       --  semantics is as though successive declarations were given with the
2677       --  same component definition and expression components. To simplify
2678       --  semantic processing, the parser represents a multiple declaration
2679       --  case as a sequence of single declarations, using the More_Ids and
2680       --  Prev_Ids flags to preserve the original source form as described
2681       --  in the section on "Handling of Defining Identifier Lists".
2682
2683       --  N_Component_Declaration
2684       --  Sloc points to first identifier
2685       --  Defining_Identifier (Node1)
2686       --  Component_Definition (Node4)
2687       --  Expression (Node3) (set to Empty if no default expression)
2688       --  More_Ids (Flag5) (set to False if no more identifiers in list)
2689       --  Prev_Ids (Flag6) (set to False if no previous identifiers in list)
2690
2691       -------------------------
2692       -- 3.8.1  Variant Part --
2693       -------------------------
2694
2695       --  VARIANT_PART ::=
2696       --    case discriminant_DIRECT_NAME is
2697       --      VARIANT
2698       --      {VARIANT}
2699       --    end case;
2700
2701       --  Note: the variants list can contain pragmas as well as variants.
2702       --  In a properly formed program there is at least one variant.
2703
2704       --  N_Variant_Part
2705       --  Sloc points to CASE
2706       --  Name (Node2)
2707       --  Variants (List1)
2708
2709       --------------------
2710       -- 3.8.1  Variant --
2711       --------------------
2712
2713       --  VARIANT ::=
2714       --    when DISCRETE_CHOICE_LIST =>
2715       --      COMPONENT_LIST
2716
2717       --  N_Variant
2718       --  Sloc points to WHEN
2719       --  Discrete_Choices (List4)
2720       --  Component_List (Node1)
2721       --  Enclosing_Variant (Node2-Sem)
2722       --  Present_Expr (Uint3-Sem)
2723       --  Dcheck_Function (Node5-Sem)
2724
2725       ---------------------------------
2726       -- 3.8.1  Discrete Choice List --
2727       ---------------------------------
2728
2729       --  DISCRETE_CHOICE_LIST ::= DISCRETE_CHOICE {| DISCRETE_CHOICE}
2730
2731       ----------------------------
2732       -- 3.8.1  Discrete Choice --
2733       ----------------------------
2734
2735       --  DISCRETE_CHOICE ::= EXPRESSION | DISCRETE_RANGE | others
2736
2737       --  Note: in Ada 83 mode, the expression must be a simple expression
2738
2739       --  The only choice that appears explicitly is the OTHERS choice, as
2740       --  defined here. Other cases of discrete choice (expression and
2741       --  discrete range) appear directly. This production is also used
2742       --  for the OTHERS possibility of an exception choice.
2743
2744       --  Note: in accordance with the syntax, the parser does not check that
2745       --  OTHERS appears at the end on its own in a choice list context. This
2746       --  is a semantic check.
2747
2748       --  N_Others_Choice
2749       --  Sloc points to OTHERS
2750       --  Others_Discrete_Choices (List1-Sem)
2751       --  All_Others (Flag11-Sem)
2752
2753       ----------------------------------
2754       -- 3.9.1  Record Extension Part --
2755       ----------------------------------
2756
2757       --  RECORD_EXTENSION_PART ::= with RECORD_DEFINITION
2758
2759       --  Note: record extension parts are not permitted in Ada 83 mode
2760
2761       --------------------------------------
2762       -- 3.9.4  Interface Type Definition --
2763       --------------------------------------
2764
2765       --  INTERFACE_TYPE_DEFINITION ::=
2766       --    [limited | task | protected | synchronized]
2767       --    interface [interface_list]
2768
2769       --  Note: Interfaces are implemented with N_Record_Definition and
2770       --        N_Derived_Type_Definition nodes because most of the support
2771       --        for the analysis of abstract types has been reused to
2772       --        analyze abstract interfaces.
2773
2774       ----------------------------------
2775       -- 3.10  Access Type Definition --
2776       ----------------------------------
2777
2778       --  ACCESS_TYPE_DEFINITION ::=
2779       --    ACCESS_TO_OBJECT_DEFINITION
2780       --  | ACCESS_TO_SUBPROGRAM_DEFINITION
2781
2782       --------------------------
2783       -- 3.10  Null Exclusion --
2784       --------------------------
2785
2786       --  NULL_EXCLUSION ::= not null
2787
2788       ---------------------------------------
2789       -- 3.10  Access To Object Definition --
2790       ---------------------------------------
2791
2792       --  ACCESS_TO_OBJECT_DEFINITION ::=
2793       --    [NULL_EXCLUSION] access [GENERAL_ACCESS_MODIFIER]
2794       --    SUBTYPE_INDICATION
2795
2796       --  N_Access_To_Object_Definition
2797       --  Sloc points to ACCESS
2798       --  All_Present (Flag15)
2799       --  Null_Exclusion_Present (Flag11)
2800       --  Subtype_Indication (Node5)
2801       --  Constant_Present (Flag17)
2802
2803       -----------------------------------
2804       -- 3.10  General Access Modifier --
2805       -----------------------------------
2806
2807       --  GENERAL_ACCESS_MODIFIER ::= all | constant
2808
2809       --  Note: general access modifiers are not permitted in Ada 83 mode
2810
2811       --  There is no explicit node in the tree for general access modifier.
2812       --  Instead the All_Present or Constant_Present flags are set in the
2813       --  parent node.
2814
2815       -------------------------------------------
2816       -- 3.10  Access To Subprogram Definition --
2817       -------------------------------------------
2818
2819       --  ACCESS_TO_SUBPROGRAM_DEFINITION
2820       --    [NULL_EXCLUSION] access [protected] procedure PARAMETER_PROFILE
2821       --  | [NULL_EXCLUSION] access [protected] function
2822       --    PARAMETER_AND_RESULT_PROFILE
2823
2824       --  Note: access to subprograms are not permitted in Ada 83 mode
2825
2826       --  N_Access_Function_Definition
2827       --  Sloc points to ACCESS
2828       --  Null_Exclusion_Present (Flag11)
2829       --  Protected_Present (Flag6)
2830       --  Parameter_Specifications (List3) (set to No_List if no formal part)
2831       --  Result_Definition (Node4) result subtype (subtype mark or access def)
2832
2833       --  N_Access_Procedure_Definition
2834       --  Sloc points to ACCESS
2835       --  Null_Exclusion_Present (Flag11)
2836       --  Protected_Present (Flag6)
2837       --  Parameter_Specifications (List3) (set to No_List if no formal part)
2838
2839       -----------------------------
2840       -- 3.10  Access Definition --
2841       -----------------------------
2842
2843       --  ACCESS_DEFINITION ::=
2844       --    [NULL_EXCLUSION] access [GENERAL_ACCESS_MODIFIER] SUBTYPE_MARK
2845       --  | ACCESS_TO_SUBPROGRAM_DEFINITION
2846
2847       --  Note: access to subprograms are an Ada 2005 (AI-254) extension
2848
2849       --  N_Access_Definition
2850       --  Sloc points to ACCESS
2851       --  Null_Exclusion_Present (Flag11)
2852       --  All_Present (Flag15)
2853       --  Constant_Present (Flag17)
2854       --  Subtype_Mark (Node4)
2855       --  Access_To_Subprogram_Definition (Node3) (set to Empty if not present)
2856
2857       -----------------------------------------
2858       -- 3.10.1  Incomplete Type Declaration --
2859       -----------------------------------------
2860
2861       --  INCOMPLETE_TYPE_DECLARATION ::=
2862       --    type DEFINING_IDENTIFIER [DISCRIMINANT_PART] [IS TAGGED];
2863
2864       --  N_Incomplete_Type_Declaration
2865       --  Sloc points to TYPE
2866       --  Defining_Identifier (Node1)
2867       --  Discriminant_Specifications (List4) (set to No_List if no
2868       --   discriminant part, or if the discriminant part is an
2869       --   unknown discriminant part)
2870       --  Unknown_Discriminants_Present (Flag13) set if (<>) discriminant
2871       --  Tagged_Present (Flag15)
2872
2873       ----------------------------
2874       -- 3.11  Declarative Part --
2875       ----------------------------
2876
2877       --  DECLARATIVE_PART ::= {DECLARATIVE_ITEM}
2878
2879       --  Note: although the parser enforces the syntactic requirement that
2880       --  a declarative part can contain only declarations, the semantic
2881       --  processing may add statements to the list of actions in a
2882       --  declarative part, so the code generator should be prepared
2883       --  to accept a statement in this position.
2884
2885       ----------------------------
2886       -- 3.11  Declarative Item --
2887       ----------------------------
2888
2889       --  DECLARATIVE_ITEM ::= BASIC_DECLARATIVE_ITEM | BODY
2890
2891       ----------------------------------
2892       -- 3.11  Basic Declarative Item --
2893       ----------------------------------
2894
2895       --  BASIC_DECLARATIVE_ITEM ::=
2896       --    BASIC_DECLARATION | REPRESENTATION_CLAUSE | USE_CLAUSE
2897
2898       ----------------
2899       -- 3.11  Body --
2900       ----------------
2901
2902       --  BODY ::= PROPER_BODY | BODY_STUB
2903
2904       -----------------------
2905       -- 3.11  Proper Body --
2906       -----------------------
2907
2908       --  PROPER_BODY ::=
2909       --    SUBPROGRAM_BODY | PACKAGE_BODY | TASK_BODY | PROTECTED_BODY
2910
2911       ---------------
2912       -- 4.1  Name --
2913       ---------------
2914
2915       --  NAME ::=
2916       --    DIRECT_NAME        | EXPLICIT_DEREFERENCE
2917       --  | INDEXED_COMPONENT  | SLICE
2918       --  | SELECTED_COMPONENT | ATTRIBUTE_REFERENCE
2919       --  | TYPE_CONVERSION    | FUNCTION_CALL
2920       --  | CHARACTER_LITERAL
2921
2922       ----------------------
2923       -- 4.1  Direct Name --
2924       ----------------------
2925
2926       --  DIRECT_NAME ::= IDENTIFIER | OPERATOR_SYMBOL
2927
2928       -----------------
2929       -- 4.1  Prefix --
2930       -----------------
2931
2932       --  PREFIX ::= NAME | IMPLICIT_DEREFERENCE
2933
2934       -------------------------------
2935       -- 4.1  Explicit Dereference --
2936       -------------------------------
2937
2938       --  EXPLICIT_DEREFERENCE ::= NAME . all
2939
2940       --  N_Explicit_Dereference
2941       --  Sloc points to ALL
2942       --  Prefix (Node3)
2943       --  Actual_Designated_Subtype (Node4-Sem)
2944       --  plus fields for expression
2945
2946       -------------------------------
2947       -- 4.1  Implicit Dereference --
2948       -------------------------------
2949
2950       --  IMPLICIT_DEREFERENCE ::= NAME
2951
2952       ------------------------------
2953       -- 4.1.1  Indexed Component --
2954       ------------------------------
2955
2956       --  INDEXED_COMPONENT ::= PREFIX (EXPRESSION {, EXPRESSION})
2957
2958       --  Note: the parser may generate this node in some situations where it
2959       --  should be a function call. The semantic  pass must correct this
2960       --  misidentification (which is inevitable at the parser level).
2961
2962       --  N_Indexed_Component
2963       --  Sloc contains a copy of the Sloc value of the Prefix
2964       --  Prefix (Node3)
2965       --  Expressions (List1)
2966       --  plus fields for expression
2967
2968       --  Note: if any of the subscripts requires a range check, then the
2969       --  Do_Range_Check flag is set on the corresponding expression, with
2970       --  the index type being determined from the type of the Prefix, which
2971       --  references the array being indexed.
2972
2973       --  Note: in a fully analyzed and expanded indexed component node, and
2974       --  hence in any such node that gigi sees, if the prefix is an access
2975       --  type, then an explicit dereference operation has been inserted.
2976
2977       ------------------
2978       -- 4.1.2  Slice --
2979       ------------------
2980
2981       --  SLICE ::= PREFIX (DISCRETE_RANGE)
2982
2983       --  Note: an implicit subtype is created to describe the resulting
2984       --  type, so that the bounds of this type are the bounds of the slice.
2985
2986       --  N_Slice
2987       --  Sloc points to first token of prefix
2988       --  Prefix (Node3)
2989       --  Discrete_Range (Node4)
2990       --  plus fields for expression
2991
2992       -------------------------------
2993       -- 4.1.3  Selected Component --
2994       -------------------------------
2995
2996       --  SELECTED_COMPONENT ::= PREFIX . SELECTOR_NAME
2997
2998       --  Note: selected components that are semantically expanded names get
2999       --  changed during semantic processing into the separate N_Expanded_Name
3000       --  node. See description of this node in the section on semantic nodes.
3001
3002       --  N_Selected_Component
3003       --  Sloc points to period
3004       --  Prefix (Node3)
3005       --  Selector_Name (Node2)
3006       --  Associated_Node (Node4-Sem)
3007       --  Do_Discriminant_Check (Flag13-Sem)
3008       --  Is_In_Discriminant_Check (Flag11-Sem)
3009       --  plus fields for expression
3010
3011       --------------------------
3012       -- 4.1.3  Selector Name --
3013       --------------------------
3014
3015       --  SELECTOR_NAME ::= IDENTIFIER | CHARACTER_LITERAL | OPERATOR_SYMBOL
3016
3017       --------------------------------
3018       -- 4.1.4  Attribute Reference --
3019       --------------------------------
3020
3021       --  ATTRIBUTE_REFERENCE ::= PREFIX ' ATTRIBUTE_DESIGNATOR
3022
3023       --  Note: the syntax is quite ambiguous at this point. Consider:
3024
3025       --    A'Length (X)  X is part of the attribute designator
3026       --    A'Pos (X)     X is an explicit actual parameter of function A'Pos
3027       --    A'Class (X)   X is the expression of a type conversion
3028
3029       --  It would be possible for the parser to distinguish these cases
3030       --  by looking at the attribute identifier. However, that would mean
3031       --  more work in introducing new implementation defined attributes,
3032       --  and also it would mean that special processing for attributes
3033       --  would be scattered around, instead of being centralized in the
3034       --  semantic routine that handles an N_Attribute_Reference node.
3035       --  Consequently, the parser in all the above cases stores the
3036       --  expression (X in these examples) as a single element list in
3037       --  in the Expressions field of the N_Attribute_Reference node.
3038
3039       --  Similarly, for attributes like Max which take two arguments,
3040       --  we store the two arguments as a two element list in the
3041       --  Expressions field. Of course it is clear at parse time that
3042       --  this case is really a function call with an attribute as the
3043       --  prefix, but it turns out to be convenient to handle the two
3044       --  argument case in a similar manner to the one argument case,
3045       --  and indeed in general the parser will accept any number of
3046       --  expressions in this position and store them as a list in the
3047       --  attribute reference node. This allows for future addition of
3048       --  attributes that take more than two arguments.
3049
3050       --  Note: named associates are not permitted in function calls where
3051       --  the function is an attribute (see RM 6.4(3)) so it is legitimate
3052       --  to skip the normal subprogram argument processing.
3053
3054       --  Note: for the attributes whose designators are technically keywords,
3055       --  i.e. digits, access, delta, range, the Attribute_Name field contains
3056       --  the corresponding name, even though no identifier is involved.
3057
3058       --  Note: the generated code may contain stream attributes applied to
3059       --  limited types for which no stream routines exist officially. In such
3060       --  case, the result is to use the stream attribute for the underlying
3061       --  full type, or in the case of a protected type, the components
3062       --  (including any disriminants) are merely streamed in order.
3063
3064       --  See Exp_Attr for a complete description of which attributes are
3065       --  passed onto Gigi, and which are handled entirely by the front end.
3066
3067       --  Gigi restriction: For the Pos attribute, the prefix cannot be
3068       --  a non-standard enumeration type or a nonzero/zero semantics
3069       --  boolean type, so the value is simply the stored representation.
3070
3071       --  Gigi requirement: For the Mechanism_Code attribute, if the prefix
3072       --  references a subprogram that is a renaming, then the front end must
3073       --  rewrite the attribute to refer directly to the renamed entity.
3074
3075       --  Note: In generated code, the Address and Unrestricted_Access
3076       --  attributes can be applied to any expression, and the meaning is
3077       --  to create an object containing the value (the object is in the
3078       --  current stack frame), and pass the address of this value. If the
3079       --  Must_Be_Byte_Aligned flag is set, then the object whose address
3080       --  is taken must be on a byte (storage unit) boundary, and if it is
3081       --  not (or may not be), then the generated code must create a copy
3082       --  that is byte aligned, and pass the address of this copy.
3083
3084       --  N_Attribute_Reference
3085       --  Sloc points to apostrophe
3086       --  Prefix (Node3)
3087       --  Attribute_Name (Name2) identifier name from attribute designator
3088       --  Expressions (List1) (set to No_List if no associated expressions)
3089       --  Entity (Node4-Sem) used if the attribute yields a type
3090       --  Associated_Node (Node4-Sem)
3091       --  Do_Overflow_Check (Flag17-Sem)
3092       --  Redundant_Use (Flag13-Sem)
3093       --  Must_Be_Byte_Aligned (Flag14)
3094       --  plus fields for expression
3095
3096       ---------------------------------
3097       -- 4.1.4  Attribute Designator --
3098       ---------------------------------
3099
3100       --  ATTRIBUTE_DESIGNATOR ::=
3101       --    IDENTIFIER [(static_EXPRESSION)]
3102       --  | access | delta | digits
3103
3104       --  There is no explicit node in the tree for an attribute designator.
3105       --  Instead the Attribute_Name and Expressions fields of the parent
3106       --  node (N_Attribute_Reference node) hold the information.
3107
3108       --  Note: if ACCESS, DELTA or DIGITS appears in an attribute
3109       --  designator, then they are treated as identifiers internally
3110       --  rather than the keywords of the same name.
3111
3112       --------------------------------------
3113       -- 4.1.4  Range Attribute Reference --
3114       --------------------------------------
3115
3116       --  RANGE_ATTRIBUTE_REFERENCE ::= PREFIX ' RANGE_ATTRIBUTE_DESIGNATOR
3117
3118       --  A range attribute reference is represented in the tree using the
3119       --  normal N_Attribute_Reference node.
3120
3121       ---------------------------------------
3122       -- 4.1.4  Range Attribute Designator --
3123       ---------------------------------------
3124
3125       --  RANGE_ATTRIBUTE_DESIGNATOR ::= Range [(static_EXPRESSION)]
3126
3127       --  A range attribute designator is represented in the tree using the
3128       --  normal N_Attribute_Reference node.
3129
3130       --------------------
3131       -- 4.3  Aggregate --
3132       --------------------
3133
3134       --  AGGREGATE ::=
3135       --    RECORD_AGGREGATE | EXTENSION_AGGREGATE | ARRAY_AGGREGATE
3136
3137       -----------------------------
3138       -- 4.3.1  Record Aggregate --
3139       -----------------------------
3140
3141       --  RECORD_AGGREGATE ::= (RECORD_COMPONENT_ASSOCIATION_LIST)
3142
3143       --  N_Aggregate
3144       --  Sloc points to left parenthesis
3145       --  Expressions (List1) (set to No_List if none or null record case)
3146       --  Component_Associations (List2) (set to No_List if none)
3147       --  Null_Record_Present (Flag17)
3148       --  Aggregate_Bounds (Node3-Sem)
3149       --  Associated_Node (Node4-Sem)
3150       --  Static_Processing_OK (Flag4-Sem)
3151       --  Compile_Time_Known_Aggregate (Flag18-Sem)
3152       --  Expansion_Delayed (Flag11-Sem)
3153       --  Has_Self_Reference (Flag13-Sem)
3154       --  plus fields for expression
3155
3156       --  Note: this structure is used for both record and array aggregates
3157       --  since the two cases are not separable by the parser. The parser
3158       --  makes no attempt to enforce consistency here, so it is up to the
3159       --  semantic phase to make sure that the aggregate is consistent (i.e.
3160       --  that it is not a "half-and-half" case that mixes record and array
3161       --  syntax. In particular, for a record aggregate, the expressions
3162       --  field will be set if there are positional associations.
3163
3164       --  Note: N_Aggregate is not used for all aggregates; in particular,
3165       --  there is a separate node kind for extension aggregates.
3166
3167       --  Note: gigi/gcc can handle array aggregates correctly providing that
3168       --  they are entirely positional, and the array subtype involved has a
3169       --  known at compile time length and is not bit packed, or a convention
3170       --  Fortran array with more than one dimension. If these conditions
3171       --  are not met, then the front end must translate the aggregate into
3172       --  an appropriate set of assignments into a temporary.
3173
3174       --  Note: for the record aggregate case, gigi/gcc can handle all cases
3175       --  of record aggregates, including those for packed, and rep-claused
3176       --  records, and also variant records, providing that there are no
3177       --  variable length fields whose size is not known at runtime, and
3178       --  providing that the aggregate is presented in fully named form.
3179
3180       ----------------------------------------------
3181       -- 4.3.1  Record Component Association List --
3182       ----------------------------------------------
3183
3184       --  RECORD_COMPONENT_ASSOCIATION_LIST ::=
3185       --     RECORD_COMPONENT_ASSOCIATION {, RECORD_COMPONENT_ASSOCIATION}
3186       --   | null record
3187
3188       --  There is no explicit node in the tree for a record component
3189       --  association list. Instead the Null_Record_Present flag is set in
3190       --  the parent node for the NULL RECORD case.
3191
3192       ------------------------------------------------------
3193       -- 4.3.1  Record Component Association (also 4.3.3) --
3194       ------------------------------------------------------
3195
3196       --  RECORD_COMPONENT_ASSOCIATION ::=
3197       --    [COMPONENT_CHOICE_LIST =>] EXPRESSION
3198
3199       --  N_Component_Association
3200       --  Sloc points to first selector name
3201       --  Choices (List1)
3202       --  Loop_Actions (List2-Sem)
3203       --  Expression (Node3)
3204       --  Box_Present (Flag15)
3205
3206       --  Note: this structure is used for both record component associations
3207       --  and array component associations, since the two cases aren't always
3208       --  separable by the parser. The choices list may represent either a
3209       --  list of selector names in the record aggregate case, or a list of
3210       --  discrete choices in the array aggregate case or an N_Others_Choice
3211       --  node (which appears as a singleton list). Box_Present gives support
3212       --  to Ada 2005 (AI-287).
3213
3214       -----------------------------------
3215       -- 4.3.1  Commponent Choice List --
3216       -----------------------------------
3217
3218       --  COMPONENT_CHOICE_LIST ::=
3219       --    component_SELECTOR_NAME {| component_SELECTOR_NAME}
3220       --  | others
3221
3222       --  The entries of a component choice list appear in the Choices list
3223       --  of the associated N_Component_Association, as either selector
3224       --  names, or as an N_Others_Choice node.
3225
3226       --------------------------------
3227       -- 4.3.2  Extension Aggregate --
3228       --------------------------------
3229
3230       --  EXTENSION_AGGREGATE ::=
3231       --    (ANCESTOR_PART with RECORD_COMPONENT_ASSOCIATION_LIST)
3232
3233       --  Note: extension aggregates are not permitted in Ada 83 mode
3234
3235       --  N_Extension_Aggregate
3236       --  Sloc points to left parenthesis
3237       --  Ancestor_Part (Node3)
3238       --  Associated_Node (Node4-Sem)
3239       --  Expressions (List1) (set to No_List if none or null record case)
3240       --  Component_Associations (List2) (set to No_List if none)
3241       --  Null_Record_Present (Flag17)
3242       --  Expansion_Delayed (Flag11-Sem)
3243       --  Has_Self_Reference (Flag13-Sem)
3244       --  plus fields for expression
3245
3246       --------------------------
3247       -- 4.3.2  Ancestor Part --
3248       --------------------------
3249
3250       --  ANCESTOR_PART ::= EXPRESSION | SUBTYPE_MARK
3251
3252       ----------------------------
3253       -- 4.3.3  Array Aggregate --
3254       ----------------------------
3255
3256       --  ARRAY_AGGREGATE ::=
3257       --    POSITIONAL_ARRAY_AGGREGATE | NAMED_ARRAY_AGGREGATE
3258
3259       ---------------------------------------
3260       -- 4.3.3  Positional Array Aggregate --
3261       ---------------------------------------
3262
3263       --  POSITIONAL_ARRAY_AGGREGATE ::=
3264       --    (EXPRESSION, EXPRESSION {, EXPRESSION})
3265       --  | (EXPRESSION {, EXPRESSION}, others => EXPRESSION)
3266
3267       --  See Record_Aggregate (4.3.1) for node structure
3268
3269       ----------------------------------
3270       -- 4.3.3  Named Array Aggregate --
3271       ----------------------------------
3272
3273       --  NAMED_ARRAY_AGGREGATE ::=
3274       --  | (ARRAY_COMPONENT_ASSOCIATION {, ARRAY_COMPONENT_ASSOCIATION})
3275
3276       --  See Record_Aggregate (4.3.1) for node structure
3277
3278       ----------------------------------------
3279       -- 4.3.3  Array Component Association --
3280       ----------------------------------------
3281
3282       --  ARRAY_COMPONENT_ASSOCIATION ::=
3283       --    DISCRETE_CHOICE_LIST => EXPRESSION
3284
3285       --  See Record_Component_Association (4.3.1) for node structure
3286
3287       --------------------------------------------------
3288       -- 4.4  Expression/Relation/Term/Factor/Primary --
3289       --------------------------------------------------
3290
3291       --  EXPRESSION ::=
3292       --    RELATION {and RELATION} | RELATION {and then RELATION}
3293       --  | RELATION {or RELATION}  | RELATION {or else RELATION}
3294       --  | RELATION {xor RELATION}
3295
3296       --  RELATION ::=
3297       --    SIMPLE_EXPRESSION [RELATIONAL_OPERATOR SIMPLE_EXPRESSION]
3298       --  | SIMPLE_EXPRESSION [not] in RANGE
3299       --  | SIMPLE_EXPRESSION [not] in SUBTYPE_MARK
3300
3301       --  SIMPLE_EXPRESSION ::=
3302       --    [UNARY_ADDING_OPERATOR] TERM {BINARY_ADDING_OPERATOR TERM}
3303
3304       --  TERM ::= FACTOR {MULTIPLYING_OPERATOR FACTOR}
3305
3306       --  FACTOR ::= PRIMARY [** PRIMARY] | abs PRIMARY | not PRIMARY
3307
3308       --  No nodes are generated for any of these constructs. Instead, the
3309       --  node for the operator appears directly. When we refer to an
3310       --  expression in this description, we mean any of the possible
3311       --  consistuent components of an expression (e.g. identifier is
3312       --  an example of an expression).
3313
3314       ------------------
3315       -- 4.4  Primary --
3316       ------------------
3317
3318       --  PRIMARY ::=
3319       --    NUMERIC_LITERAL  | null
3320       --  | STRING_LITERAL   | AGGREGATE
3321       --  | NAME             | QUALIFIED_EXPRESSION
3322       --  | ALLOCATOR        | (EXPRESSION)
3323
3324       --  Usually there is no explicit node in the tree for primary. Instead
3325       --  the constituent (e.g. AGGREGATE) appears directly. There are two
3326       --  exceptions. First, there is an explicit node for a null primary.
3327
3328       --  N_Null
3329       --  Sloc points to NULL
3330       --  plus fields for expression
3331
3332       --  Second, the case of (EXPRESSION) is handled specially. Ada requires
3333       --  that the parser keep track of which subexpressions are enclosed
3334       --  in parentheses, and how many levels of parentheses are used. This
3335       --  information is required for optimization purposes, and also for
3336       --  some semantic checks (e.g. (((1))) in a procedure spec does not
3337       --  conform with ((((1)))) in the body).
3338
3339       --  The parentheses are recorded by keeping a Paren_Count field in every
3340       --  subexpression node (it is actually present in all nodes, but only
3341       --  used in subexpression nodes). This count records the number of
3342       --  levels of parentheses. If the number of levels in the source exceeds
3343       --  the maximum accomodated by this count, then the count is simply left
3344       --  at the maximum value. This means that there are some pathalogical
3345       --  cases of failure to detect conformance failures (e.g. an expression
3346       --  with 500 levels of parens will conform with one with 501 levels),
3347       --  but we do not need to lose sleep over this.
3348
3349       --  Historical note: in versions of GNAT prior to 1.75, there was a node
3350       --  type N_Parenthesized_Expression used to accurately record unlimited
3351       --  numbers of levels of parentheses. However, it turned out to be a
3352       --  real nuisance to have to take into account the possible presence of
3353       --  this node during semantic analysis, since basically parentheses have
3354       --  zero relevance to semantic analysis.
3355
3356       --  Note: the level of parentheses always present in things like
3357       --  aggregates does not count, only the parentheses in the primary
3358       --  (EXPRESSION) affect the setting of the Paren_Count field.
3359
3360       --  2nd Note: the contents of the Expression field must be ignored (i.e.
3361       --  treated as though it were Empty) if No_Initialization is set True.
3362
3363       --------------------------------------
3364       -- 4.5  Short Circuit Control Forms --
3365       --------------------------------------
3366
3367       --  EXPRESSION ::=
3368       --    RELATION {and then RELATION} | RELATION {or else RELATION}
3369
3370       --  Gigi restriction: For both these control forms, the operand and
3371       --  result types are always Standard.Boolean. The expander inserts the
3372       --  required conversion operations where needed to ensure this is the
3373       --  case.
3374
3375       --  N_And_Then
3376       --  Sloc points to AND of AND THEN
3377       --  Left_Opnd (Node2)
3378       --  Right_Opnd (Node3)
3379       --  Actions (List1-Sem)
3380       --  plus fields for expression
3381
3382       --  N_Or_Else
3383       --  Sloc points to OR of OR ELSE
3384       --  Left_Opnd (Node2)
3385       --  Right_Opnd (Node3)
3386       --  Actions (List1-Sem)
3387       --  plus fields for expression
3388
3389       --  Note: The Actions field is used to hold actions associated with
3390       --  the right hand operand. These have to be treated specially since
3391       --  they are not unconditionally executed. See Insert_Actions for a
3392       --  more detailed description of how these actions are handled.
3393
3394       ---------------------------
3395       -- 4.5  Membership Tests --
3396       ---------------------------
3397
3398       --  RELATION ::=
3399       --    SIMPLE_EXPRESSION [not] in RANGE
3400       --  | SIMPLE_EXPRESSION [not] in SUBTYPE_MARK
3401
3402       --  Note: although the grammar above allows only a range or a
3403       --  subtype mark, the parser in fact will accept any simple
3404       --  expression in place of a subtype mark. This means that the
3405       --  semantic analyzer must be prepared to deal with, and diagnose
3406       --  a simple expression other than a name for the right operand.
3407       --  This simplifies error recovery in the parser.
3408
3409       --  N_In
3410       --  Sloc points to IN
3411       --  Left_Opnd (Node2)
3412       --  Right_Opnd (Node3)
3413       --  plus fields for expression
3414
3415       --  N_Not_In
3416       --  Sloc points to NOT of NOT IN
3417       --  Left_Opnd (Node2)
3418       --  Right_Opnd (Node3)
3419       --  plus fields for expression
3420
3421       --------------------
3422       -- 4.5  Operators --
3423       --------------------
3424
3425       --  LOGICAL_OPERATOR             ::=  and | or  | xor
3426
3427       --  RELATIONAL_OPERATOR          ::=  =   | /=  | <   | <= | > | >=
3428
3429       --  BINARY_ADDING_OPERATOR       ::=  +   |  -  | &
3430
3431       --  UNARY_ADDING_OPERATOR        ::=  +   |  -
3432
3433       --  MULTIPLYING_OPERATOR         ::=  *   |  /  | mod | rem
3434
3435       --  HIGHEST_PRECEDENCE_OPERATOR  ::=  **  | abs | not
3436
3437       --  Sprint syntax if Treat_Fixed_As_Integer is set:
3438
3439       --     x #* y
3440       --     x #/ y
3441       --     x #mod y
3442       --     x #rem y
3443
3444       --  Gigi restriction: For * / mod rem with fixed-point operands, Gigi
3445       --  will only be given nodes with the Treat_Fixed_As_Integer flag set.
3446       --  All handling of smalls for multiplication and division is handled
3447       --  by the front end (mod and rem result only from expansion). Gigi
3448       --  thus never needs to worry about small values (for other operators
3449       --  operating on fixed-point, e.g. addition, the small value does not
3450       --  have any semantic effect anyway, these are always integer operations.
3451
3452       --  Gigi restriction: For all operators taking Boolean operands, the
3453       --  type is always Standard.Boolean. The expander inserts the required
3454       --  conversion operations where needed to ensure this is the case.
3455
3456       --  N_Op_And
3457       --  Sloc points to AND
3458       --  Do_Length_Check (Flag4-Sem)
3459       --  plus fields for binary operator
3460       --  plus fields for expression
3461
3462       --  N_Op_Or
3463       --  Sloc points to OR
3464       --  Do_Length_Check (Flag4-Sem)
3465       --  plus fields for binary operator
3466       --  plus fields for expression
3467
3468       --  N_Op_Xor
3469       --  Sloc points to XOR
3470       --  Do_Length_Check (Flag4-Sem)
3471       --  plus fields for binary operator
3472       --  plus fields for expression
3473
3474       --  N_Op_Eq
3475       --  Sloc points to =
3476       --  plus fields for binary operator
3477       --  plus fields for expression
3478
3479       --  N_Op_Ne
3480       --  Sloc points to /=
3481       --  plus fields for binary operator
3482       --  plus fields for expression
3483
3484       --  N_Op_Lt
3485       --  Sloc points to <
3486       --  plus fields for binary operator
3487       --  plus fields for expression
3488
3489       --  N_Op_Le
3490       --  Sloc points to <=
3491       --  plus fields for binary operator
3492       --  plus fields for expression
3493
3494       --  N_Op_Gt
3495       --  Sloc points to >
3496       --  plus fields for binary operator
3497       --  plus fields for expression
3498
3499       --  N_Op_Ge
3500       --  Sloc points to >=
3501       --  plus fields for binary operator
3502       --  plus fields for expression
3503
3504       --  N_Op_Add
3505       --  Sloc points to + (binary)
3506       --  plus fields for binary operator
3507       --  plus fields for expression
3508
3509       --  N_Op_Subtract
3510       --  Sloc points to - (binary)
3511       --  plus fields for binary operator
3512       --  plus fields for expression
3513
3514       --  N_Op_Concat
3515       --  Sloc points to &
3516       --  Is_Component_Left_Opnd (Flag13-Sem)
3517       --  Is_Component_Right_Opnd (Flag14-Sem)
3518       --  plus fields for binary operator
3519       --  plus fields for expression
3520
3521       --  N_Op_Multiply
3522       --  Sloc points to *
3523       --  Treat_Fixed_As_Integer (Flag14-Sem)
3524       --  Rounded_Result (Flag18-Sem)
3525       --  plus fields for binary operator
3526       --  plus fields for expression
3527
3528       --  N_Op_Divide
3529       --  Sloc points to /
3530       --  Treat_Fixed_As_Integer (Flag14-Sem)
3531       --  Do_Division_Check (Flag13-Sem)
3532       --  Rounded_Result (Flag18-Sem)
3533       --  plus fields for binary operator
3534       --  plus fields for expression
3535
3536       --  N_Op_Mod
3537       --  Sloc points to MOD
3538       --  Treat_Fixed_As_Integer (Flag14-Sem)
3539       --  Do_Division_Check (Flag13-Sem)
3540       --  plus fields for binary operator
3541       --  plus fields for expression
3542
3543       --  N_Op_Rem
3544       --  Sloc points to REM
3545       --  Treat_Fixed_As_Integer (Flag14-Sem)
3546       --  Do_Division_Check (Flag13-Sem)
3547       --  plus fields for binary operator
3548       --  plus fields for expression
3549
3550       --  N_Op_Expon
3551       --  Is_Power_Of_2_For_Shift (Flag13-Sem)
3552       --  Sloc points to **
3553       --  plus fields for binary operator
3554       --  plus fields for expression
3555
3556       --  N_Op_Plus
3557       --  Sloc points to + (unary)
3558       --  plus fields for unary operator
3559       --  plus fields for expression
3560
3561       --  N_Op_Minus
3562       --  Sloc points to - (unary)
3563       --  plus fields for unary operator
3564       --  plus fields for expression
3565
3566       --  N_Op_Abs
3567       --  Sloc points to ABS
3568       --  plus fields for unary operator
3569       --  plus fields for expression
3570
3571       --  N_Op_Not
3572       --  Sloc points to NOT
3573       --  plus fields for unary operator
3574       --  plus fields for expression
3575
3576       --  See also shift operators in section B.2
3577
3578       --  Note on fixed-point operations passed to Gigi: For adding operators,
3579       --  the semantics is to treat these simply as integer operations, with
3580       --  the small values being ignored (the bounds are already stored in
3581       --  units of small, so that constraint checking works as usual). For the
3582       --  case of multiply/divide/rem/mod operations, Gigi will only see fixed
3583       --  point operands if the Treat_Fixed_As_Integer flag is set and will
3584       --  thus treat these nodes in identical manner, ignoring small values.
3585
3586       --------------------------
3587       -- 4.6  Type Conversion --
3588       --------------------------
3589
3590       --  TYPE_CONVERSION ::=
3591       --    SUBTYPE_MARK (EXPRESSION) | SUBTYPE_MARK (NAME)
3592
3593       --  In the (NAME) case, the name is stored as the expression
3594
3595       --  Note: the parser never generates a type conversion node, since it
3596       --  looks like an indexed component which is generated by preference.
3597       --  The semantic pass must correct this misidentification.
3598
3599       --  Gigi handles conversions that involve no change in the root type,
3600       --  and also all conversions from integer to floating-point types.
3601       --  Conversions from floating-point to integer are only handled in
3602       --  the case where Float_Truncate flag set. Other conversions from
3603       --  floating-point to integer (involving rounding) and all conversions
3604       --  involving fixed-point types are handled by the expander.
3605
3606       --  Sprint syntax if Float_Truncate set: X^(Y)
3607       --  Sprint syntax if Conversion_OK set X?(Y)
3608       --  Sprint syntax if both flags set X?^(Y)
3609
3610       --  Note: If either the operand or result type is fixed-point, Gigi will
3611       --  only see a type conversion node with Conversion_OK set. The front end
3612       --  takes care of all handling of small's for fixed-point conversions.
3613
3614       --  N_Type_Conversion
3615       --  Sloc points to first token of subtype mark
3616       --  Subtype_Mark (Node4)
3617       --  Expression (Node3)
3618       --  Do_Tag_Check (Flag13-Sem)
3619       --  Do_Length_Check (Flag4-Sem)
3620       --  Do_Overflow_Check (Flag17-Sem)
3621       --  Float_Truncate (Flag11-Sem)
3622       --  Rounded_Result (Flag18-Sem)
3623       --  Conversion_OK (Flag14-Sem)
3624       --  plus fields for expression
3625
3626       --  Note: if a range check is required, then the Do_Range_Check flag
3627       --  is set in the Expression with the check being done against the
3628       --  target type range (after the base type conversion, if any).
3629
3630       -------------------------------
3631       -- 4.7  Qualified Expression --
3632       -------------------------------
3633
3634       --  QUALIFIED_EXPRESSION ::=
3635       --    SUBTYPE_MARK ' (EXPRESSION) | SUBTYPE_MARK ' AGGREGATE
3636
3637       --  Note: the parentheses in the (EXPRESSION) case are deemed to enclose
3638       --  the expression, so the Expression field of this node always points
3639       --  to a parenthesized expression in this case (i.e. Paren_Count will
3640       --  always be non-zero for the referenced expression if it is not an
3641       --  aggregate).
3642
3643       --  N_Qualified_Expression
3644       --  Sloc points to apostrophe
3645       --  Subtype_Mark (Node4)
3646       --  Expression (Node3) expression or aggregate
3647       --  plus fields for expression
3648
3649       --------------------
3650       -- 4.8  Allocator --
3651       --------------------
3652
3653       --  ALLOCATOR ::=
3654       --    new [NULL_EXCLUSION] SUBTYPE_INDICATION | new QUALIFIED_EXPRESSION
3655
3656       --  Sprint syntax (when storage pool present)
3657       --    new xxx (storage_pool = pool)
3658
3659       --  N_Allocator
3660       --  Sloc points to NEW
3661       --  Expression (Node3) subtype indication or qualified expression
3662       --  Null_Exclusion_Present (Flag11)
3663       --  Storage_Pool (Node1-Sem)
3664       --  Procedure_To_Call (Node2-Sem)
3665       --  Coextensions (Elist4-Sem)
3666       --  No_Initialization (Flag13-Sem)
3667       --  Is_Static_Coextension (Flag14-Sem)
3668       --  Do_Storage_Check (Flag17-Sem)
3669       --  Is_Coextension (Flag18-Sem)
3670       --  plus fields for expression
3671
3672       ---------------------------------
3673       -- 5.1  Sequence Of Statements --
3674       ---------------------------------
3675
3676       --  SEQUENCE_OF_STATEMENTS ::= STATEMENT {STATEMENT}
3677
3678       --  Note: Although the parser will not accept a declaration as a
3679       --  statement, the semantic analyzer may insert declarations (e.g.
3680       --  declarations of implicit types needed for execution of other
3681       --  statements) into a sequence of statements, so the code genmerator
3682       --  should be prepared to accept a declaration where a statement is
3683       --  expected. Note also that pragmas can appear as statements.
3684
3685       --------------------
3686       -- 5.1  Statement --
3687       --------------------
3688
3689       --  STATEMENT ::=
3690       --    {LABEL} SIMPLE_STATEMENT | {LABEL} COMPOUND_STATEMENT
3691
3692       --  There is no explicit node in the tree for a statement. Instead, the
3693       --  individual statement appears directly. Labels are treated  as a
3694       --  kind of statement, i.e. they are linked into a statement list at
3695       --  the point they appear, so the labeled statement appears following
3696       --  the label or labels in the statement list.
3697
3698       ---------------------------
3699       -- 5.1  Simple Statement --
3700       ---------------------------
3701
3702       --  SIMPLE_STATEMENT ::=        NULL_STATEMENT
3703       --  | ASSIGNMENT_STATEMENT    | EXIT_STATEMENT
3704       --  | GOTO_STATEMENT          | PROCEDURE_CALL_STATEMENT
3705       --  | SIMPLE_RETURN_STATEMENT | ENTRY_CALL_STATEMENT
3706       --  | REQUEUE_STATEMENT       | DELAY_STATEMENT
3707       --  | ABORT_STATEMENT         | RAISE_STATEMENT
3708       --  | CODE_STATEMENT
3709
3710       -----------------------------
3711       -- 5.1  Compound Statement --
3712       -----------------------------
3713
3714       --  COMPOUND_STATEMENT ::=
3715       --    IF_STATEMENT              | CASE_STATEMENT
3716       --  | LOOP_STATEMENT            | BLOCK_STATEMENT
3717       --  | EXTENDED_RETURN_STATEMENT
3718       --  | ACCEPT_STATEMENT          | SELECT_STATEMENT
3719
3720       -------------------------
3721       -- 5.1  Null Statement --
3722       -------------------------
3723
3724       --  NULL_STATEMENT ::= null;
3725
3726       --  N_Null_Statement
3727       --  Sloc points to NULL
3728
3729       ----------------
3730       -- 5.1  Label --
3731       ----------------
3732
3733       --  LABEL ::= <<label_STATEMENT_IDENTIFIER>>
3734
3735       --  Note that the occurrence of a label is not a defining identifier,
3736       --  but rather a referencing occurrence. The defining occurrence is
3737       --  in the implicit label declaration which occurs in the innermost
3738       --  enclosing block.
3739
3740       --  N_Label
3741       --  Sloc points to <<
3742       --  Identifier (Node1) direct name of statement identifier
3743       --  Exception_Junk (Flag8-Sem)
3744
3745       -------------------------------
3746       -- 5.1  Statement Identifier --
3747       -------------------------------
3748
3749       --  STATEMENT_INDENTIFIER ::= DIRECT_NAME
3750
3751       --  The IDENTIFIER of a STATEMENT_IDENTIFIER shall be an identifier
3752       --  (not an OPERATOR_SYMBOL)
3753
3754       -------------------------------
3755       -- 5.2  Assignment Statement --
3756       -------------------------------
3757
3758       --  ASSIGNMENT_STATEMENT ::=
3759       --    variable_NAME := EXPRESSION;
3760
3761       --  N_Assignment_Statement
3762       --  Sloc points to :=
3763       --  Name (Node2)
3764       --  Expression (Node3)
3765       --  Do_Tag_Check (Flag13-Sem)
3766       --  Do_Length_Check (Flag4-Sem)
3767       --  Forwards_OK (Flag5-Sem)
3768       --  Backwards_OK (Flag6-Sem)
3769       --  No_Ctrl_Actions (Flag7-Sem)
3770
3771       --  Note: if a range check is required, then the Do_Range_Check flag
3772       --  is set in the Expression (right hand side), with the check being
3773       --  done against the type of the Name (left hand side).
3774
3775       --  Note: the back end places some restrictions on the form of the
3776       --  Expression field. If the object being assigned to is Atomic, then
3777       --  the Expression may not have the form of an aggregate (since this
3778       --  might cause the back end to generate separate assignments). It
3779       --  also cannot be a reference to an object marked as a true constant
3780       --  (Is_True_Constant flag set), where the object is itself initalized
3781       --  with an aggregate. If necessary the front end must generate an
3782       --  extra temporary (with Is_True_Constant set False), and initialize
3783       --  this temporary as required (the temporary itself is not atomic).
3784
3785       -----------------------
3786       -- 5.3  If Statement --
3787       -----------------------
3788
3789       --  IF_STATEMENT ::=
3790       --    if CONDITION then
3791       --      SEQUENCE_OF_STATEMENTS
3792       --    {elsif CONDITION then
3793       --      SEQUENCE_OF_STATEMENTS}
3794       --    [else
3795       --      SEQUENCE_OF_STATEMENTS]
3796       --    end if;
3797
3798       --  Gigi restriction: This expander ensures that the type of the
3799       --  Condition fields is always Standard.Boolean, even if the type
3800       --  in the source is some non-standard boolean type.
3801
3802       --  N_If_Statement
3803       --  Sloc points to IF
3804       --  Condition (Node1)
3805       --  Then_Statements (List2)
3806       --  Elsif_Parts (List3) (set to No_List if none present)
3807       --  Else_Statements (List4) (set to No_List if no else part present)
3808       --  End_Span (Uint5) (set to No_Uint if expander generated)
3809
3810       --  N_Elsif_Part
3811       --  Sloc points to ELSIF
3812       --  Condition (Node1)
3813       --  Then_Statements (List2)
3814       --  Condition_Actions (List3-Sem)
3815
3816       --------------------
3817       -- 5.3  Condition --
3818       --------------------
3819
3820       --  CONDITION ::= boolean_EXPRESSION
3821
3822       -------------------------
3823       -- 5.4  Case Statement --
3824       -------------------------
3825
3826       --  CASE_STATEMENT ::=
3827       --    case EXPRESSION is
3828       --      CASE_STATEMENT_ALTERNATIVE
3829       --      {CASE_STATEMENT_ALTERNATIVE}
3830       --    end case;
3831
3832       --  Note: the Alternatives can contain pragmas. These only occur at
3833       --  the start of the list, since any pragmas occurring after the first
3834       --  alternative are absorbed into the corresponding statement sequence.
3835
3836       --  N_Case_Statement
3837       --  Sloc points to CASE
3838       --  Expression (Node3)
3839       --  Alternatives (List4)
3840       --  End_Span (Uint5) (set to No_Uint if expander generated)
3841
3842       -------------------------------------
3843       -- 5.4  Case Statement Alternative --
3844       -------------------------------------
3845
3846       --  CASE_STATEMENT_ALTERNATIVE ::=
3847       --    when DISCRETE_CHOICE_LIST =>
3848       --      SEQUENCE_OF_STATEMENTS
3849
3850       --  N_Case_Statement_Alternative
3851       --  Sloc points to WHEN
3852       --  Discrete_Choices (List4)
3853       --  Statements (List3)
3854
3855       -------------------------
3856       -- 5.5  Loop Statement --
3857       -------------------------
3858
3859       --  LOOP_STATEMENT ::=
3860       --    [loop_STATEMENT_IDENTIFIER :]
3861       --      [ITERATION_SCHEME] loop
3862       --        SEQUENCE_OF_STATEMENTS
3863       --      end loop [loop_IDENTIFIER];
3864
3865       --  Note: The occurrence of a loop label is not a defining identifier
3866       --  but rather a referencing occurrence. The defining occurrence is in
3867       --  the implicit label declaration which occurs in the innermost
3868       --  enclosing block.
3869
3870       --  Note: there is always a loop statement identifier present in
3871       --  the tree, even if none was given in the source. In the case where
3872       --  no loop identifier is given in the source, the parser creates
3873       --  a name of the form _Loop_n, where n is a decimal integer (the
3874       --  two underlines ensure that the loop names created in this manner
3875       --  do not conflict with any user defined identifiers), and the flag
3876       --  Has_Created_Identifier is set to True. The only exception to the
3877       --  rule that all loop statement nodes have identifiers occurs for
3878       --  loops constructed by the expander, and the semantic analyzer will
3879       --  create and supply dummy loop identifiers in these cases.
3880
3881       --  N_Loop_Statement
3882       --  Sloc points to LOOP
3883       --  Identifier (Node1) loop identifier (set to Empty if no identifier)
3884       --  Iteration_Scheme (Node2) (set to Empty if no iteration scheme)
3885       --  Statements (List3)
3886       --  End_Label (Node4)
3887       --  Has_Created_Identifier (Flag15)
3888       --  Is_Null_Loop (Flag16)
3889
3890       --------------------------
3891       -- 5.5 Iteration Scheme --
3892       --------------------------
3893
3894       --  ITERATION_SCHEME ::=
3895       --    while CONDITION | for LOOP_PARAMETER_SPECIFICATION
3896
3897       --  Gigi restriction: This expander ensures that the type of the
3898       --  Condition field is always Standard.Boolean, even if the type
3899       --  in the source is some non-standard boolean type.
3900
3901       --  N_Iteration_Scheme
3902       --  Sloc points to WHILE or FOR
3903       --  Condition (Node1) (set to Empty if FOR case)
3904       --  Condition_Actions (List3-Sem)
3905       --  Loop_Parameter_Specification (Node4) (set to Empty if WHILE case)
3906
3907       ---------------------------------------
3908       -- 5.5  Loop parameter specification --
3909       ---------------------------------------
3910
3911       --  LOOP_PARAMETER_SPECIFICATION ::=
3912       --    DEFINING_IDENTIFIER in [reverse] DISCRETE_SUBTYPE_DEFINITION
3913
3914       --  N_Loop_Parameter_Specification
3915       --  Sloc points to first identifier
3916       --  Defining_Identifier (Node1)
3917       --  Reverse_Present (Flag15)
3918       --  Discrete_Subtype_Definition (Node4)
3919
3920       --------------------------
3921       -- 5.6  Block Statement --
3922       --------------------------
3923
3924       --  BLOCK_STATEMENT ::=
3925       --    [block_STATEMENT_IDENTIFIER:]
3926       --      [declare
3927       --        DECLARATIVE_PART]
3928       --      begin
3929       --        HANDLED_SEQUENCE_OF_STATEMENTS
3930       --      end [block_IDENTIFIER];
3931
3932       --  Note that the occurrence of a block identifier is not a defining
3933       --  identifier, but rather a referencing occurrence. The defining
3934       --  occurrence is an E_Block entity declared by the implicit label
3935       --  declaration which occurs in the innermost enclosing block statement
3936       --  or body; the block identifier denotes that E_Block.
3937
3938       --  For block statements that come from source code, there is always a
3939       --  block statement identifier present in the tree, denoting an
3940       --  E_Block. In the case where no block identifier is given in the
3941       --  source, the parser creates a name of the form B_n, where n is a
3942       --  decimal integer, and the flag Has_Created_Identifier is set to
3943       --  True. Blocks constructed by the expander usually have no identifier,
3944       --  and no corresponding entity.
3945
3946       --  Note: the block statement created for an extended return statement
3947       --  has an entity, and this entity is an E_Return_Statement, rather than
3948       --  the usual E_Block.
3949
3950       --  Note: Exception_Junk is set for the wrapping blocks created during
3951       --  local raise optimization (Exp_Ch11.Expand_Local_Exception_Handlers).
3952
3953       --  N_Block_Statement
3954       --  Sloc points to DECLARE or BEGIN
3955       --  Identifier (Node1) block direct name (set to Empty if not present)
3956       --  Declarations (List2) (set to No_List if no DECLARE part)
3957       --  Handled_Statement_Sequence (Node4)
3958       --  Is_Task_Master (Flag5-Sem)
3959       --  Activation_Chain_Entity (Node3-Sem)
3960       --  Has_Created_Identifier (Flag15)
3961       --  Is_Task_Allocation_Block (Flag6)
3962       --  Is_Asynchronous_Call_Block (Flag7)
3963       --  Exception_Junk (Flag8-Sem)
3964
3965       -------------------------
3966       -- 5.7  Exit Statement --
3967       -------------------------
3968
3969       --  EXIT_STATEMENT ::= exit [loop_NAME] [when CONDITION];
3970
3971       --  Gigi restriction: This expander ensures that the type of the
3972       --  Condition field is always Standard.Boolean, even if the type
3973       --  in the source is some non-standard boolean type.
3974
3975       --  N_Exit_Statement
3976       --  Sloc points to EXIT
3977       --  Name (Node2) (set to Empty if no loop name present)
3978       --  Condition (Node1) (set to Empty if no when part present)
3979
3980       -------------------------
3981       -- 5.9  Goto Statement --
3982       -------------------------
3983
3984       --  GOTO_STATEMENT ::= goto label_NAME;
3985
3986       --  N_Goto_Statement
3987       --  Sloc points to GOTO
3988       --  Name (Node2)
3989       --  Exception_Junk (Flag8-Sem)
3990
3991       ---------------------------------
3992       -- 6.1  Subprogram Declaration --
3993       ---------------------------------
3994
3995       --  SUBPROGRAM_DECLARATION ::= SUBPROGRAM_SPECIFICATION;
3996
3997       --  N_Subprogram_Declaration
3998       --  Sloc points to FUNCTION or PROCEDURE
3999       --  Specification (Node1)
4000       --  Body_To_Inline (Node3-Sem)
4001       --  Corresponding_Body (Node5-Sem)
4002       --  Parent_Spec (Node4-Sem)
4003
4004       ------------------------------------------
4005       -- 6.1  Abstract Subprogram Declaration --
4006       ------------------------------------------
4007
4008       --  ABSTRACT_SUBPROGRAM_DECLARATION ::=
4009       --    SUBPROGRAM_SPECIFICATION is abstract;
4010
4011       --  N_Abstract_Subprogram_Declaration
4012       --  Sloc points to ABSTRACT
4013       --  Specification (Node1)
4014
4015       -----------------------------------
4016       -- 6.1  Subprogram Specification --
4017       -----------------------------------
4018
4019       --  SUBPROGRAM_SPECIFICATION ::=
4020       --    [[not] overriding]
4021       --    procedure DEFINING_PROGRAM_UNIT_NAME PARAMETER_PROFILE
4022       --  | [[not] overriding]
4023       --    function DEFINING_DESIGNATOR PARAMETER_AND_RESULT_PROFILE
4024
4025       --  Note: there are no separate nodes for the profiles, instead the
4026       --  information appears directly in the following nodes.
4027
4028       --  N_Function_Specification
4029       --  Sloc points to FUNCTION
4030       --  Defining_Unit_Name (Node1) (the designator)
4031       --  Elaboration_Boolean (Node2-Sem)
4032       --  Parameter_Specifications (List3) (set to No_List if no formal part)
4033       --  Null_Exclusion_Present (Flag11)
4034       --  Result_Definition (Node4) for result subtype
4035       --  Generic_Parent (Node5-Sem)
4036       --  Must_Override (Flag14) set if overriding indicator present
4037       --  Must_Not_Override (Flag15) set if not_overriding indicator present
4038
4039       --  N_Procedure_Specification
4040       --  Sloc points to PROCEDURE
4041       --  Defining_Unit_Name (Node1)
4042       --  Elaboration_Boolean (Node2-Sem)
4043       --  Parameter_Specifications (List3) (set to No_List if no formal part)
4044       --  Generic_Parent (Node5-Sem)
4045       --  Null_Present (Flag13) set for null procedure case (Ada 2005 feature)
4046       --  Must_Override (Flag14) set if overriding indicator present
4047       --  Must_Not_Override (Flag15) set if not_overriding indicator present
4048
4049       --  Note: overriding indicator is an Ada 2005 feature
4050
4051       ---------------------
4052       -- 6.1  Designator --
4053       ---------------------
4054
4055       --  DESIGNATOR ::=
4056       --    [PARENT_UNIT_NAME .] IDENTIFIER | OPERATOR_SYMBOL
4057
4058       --  Designators that are simply identifiers or operator symbols appear
4059       --  directly in the tree in this form. The following node is used only
4060       --  in the case where the designator has a parent unit name component.
4061
4062       --  N_Designator
4063       --  Sloc points to period
4064       --  Name (Node2) holds the parent unit name. Note that this is always
4065       --   non-Empty, since this node is only used for the case where a
4066       --   parent library unit package name is present.
4067       --  Identifier (Node1)
4068
4069       --  Note that the identifier can also be an operator symbol here
4070
4071       ------------------------------
4072       -- 6.1  Defining Designator --
4073       ------------------------------
4074
4075       --  DEFINING_DESIGNATOR ::=
4076       --    DEFINING_PROGRAM_UNIT_NAME | DEFINING_OPERATOR_SYMBOL
4077
4078       -------------------------------------
4079       -- 6.1  Defining Program Unit Name --
4080       -------------------------------------
4081
4082       --  DEFINING_PROGRAM_UNIT_NAME ::=
4083       --    [PARENT_UNIT_NAME .] DEFINING_IDENTIFIER
4084
4085       --  The parent unit name is present only in the case of a child unit
4086       --  name (permissible only for Ada 95 for a library level unit, i.e.
4087       --  a unit at scope level one). If no such name is present, the defining
4088       --  program unit name is represented simply as the defining identifier.
4089       --  In the child unit case, the following node is used to represent the
4090       --  child unit name.
4091
4092       --  N_Defining_Program_Unit_Name
4093       --  Sloc points to period
4094       --  Name (Node2) holds the parent unit name. Note that this is always
4095       --   non-Empty, since this node is only used for the case where a
4096       --   parent unit name is present.
4097       --  Defining_Identifier (Node1)
4098
4099       --------------------------
4100       -- 6.1  Operator Symbol --
4101       --------------------------
4102
4103       --  OPERATOR_SYMBOL ::= STRING_LITERAL
4104
4105       --  Note: the fields of the N_Operator_Symbol node are laid out to
4106       --  match the corresponding fields of an N_Character_Literal node. This
4107       --  allows easy conversion of the operator symbol node into a character
4108       --  literal node in the case where a string constant of the form of an
4109       --  operator symbol is scanned out as such, but turns out semantically
4110       --  to be a string literal that is not an operator. For details see
4111       --  Sinfo.CN.Change_Operator_Symbol_To_String_Literal.
4112
4113       --  N_Operator_Symbol
4114       --  Sloc points to literal
4115       --  Chars (Name1) contains the Name_Id for the operator symbol
4116       --  Strval (Str3) Id of string value. This is used if the operator
4117       --   symbol turns out to be a normal string after all.
4118       --  Entity (Node4-Sem)
4119       --  Associated_Node (Node4-Sem)
4120       --  Has_Private_View (Flag11-Sem) set in generic units.
4121       --  Etype (Node5-Sem)
4122
4123       --  Note: the Strval field may be set to No_String for generated
4124       --  operator symbols that are known not to be string literals
4125       --  semantically.
4126
4127       -----------------------------------
4128       -- 6.1  Defining Operator Symbol --
4129       -----------------------------------
4130
4131       --  DEFINING_OPERATOR_SYMBOL ::= OPERATOR_SYMBOL
4132
4133       --  A defining operator symbol is an entity, which has additional
4134       --  fields depending on the setting of the Ekind field. These
4135       --  additional fields are defined (and access subprograms declared)
4136       --  in package Einfo.
4137
4138       --  Note: N_Defining_Operator_Symbol is an extended node whose fields
4139       --  are deliberately layed out to match the layout of fields in an
4140       --  ordinary N_Operator_Symbol node allowing for easy alteration of
4141       --  an operator symbol node into a defining operator symbol node.
4142       --  See Sinfo.CN.Change_Operator_Symbol_To_Defining_Operator_Symbol
4143       --  for further details.
4144
4145       --  N_Defining_Operator_Symbol
4146       --  Sloc points to literal
4147       --  Chars (Name1) contains the Name_Id for the operator symbol
4148       --  Next_Entity (Node2-Sem)
4149       --  Scope (Node3-Sem)
4150       --  Etype (Node5-Sem)
4151
4152       ----------------------------
4153       -- 6.1  Parameter Profile --
4154       ----------------------------
4155
4156       --  PARAMETER_PROFILE ::= [FORMAL_PART]
4157
4158       ---------------------------------------
4159       -- 6.1  Parameter and Result Profile --
4160       ---------------------------------------
4161
4162       --  PARAMETER_AND_RESULT_PROFILE ::=
4163       --    [FORMAL_PART] return [NULL_EXCLUSION] SUBTYPE_MARK
4164       --  | [FORMAL_PART] return ACCESS_DEFINITION
4165
4166       --  There is no explicit node in the tree for a parameter and result
4167       --  profile. Instead the information appears directly in the parent.
4168
4169       ----------------------
4170       -- 6.1  Formal part --
4171       ----------------------
4172
4173       --  FORMAL_PART ::=
4174       --    (PARAMETER_SPECIFICATION {; PARAMETER_SPECIFICATION})
4175
4176       ----------------------------------
4177       -- 6.1  Parameter specification --
4178       ----------------------------------
4179
4180       --  PARAMETER_SPECIFICATION ::=
4181       --    DEFINING_IDENTIFIER_LIST : MODE [NULL_EXCLUSION] SUBTYPE_MARK
4182       --      [:= DEFAULT_EXPRESSION]
4183       --  | DEFINING_IDENTIFIER_LIST : ACCESS_DEFINITION
4184       --      [:= DEFAULT_EXPRESSION]
4185
4186       --  Although the syntax allows multiple identifiers in the list, the
4187       --  semantics is as though successive specifications were given with
4188       --  identical type definition and expression components. To simplify
4189       --  semantic processing, the parser represents a multiple declaration
4190       --  case as a sequence of single Specifications, using the More_Ids and
4191       --  Prev_Ids flags to preserve the original source form as described
4192       --  in the section on "Handling of Defining Identifier Lists".
4193
4194       --  N_Parameter_Specification
4195       --  Sloc points to first identifier
4196       --  Defining_Identifier (Node1)
4197       --  In_Present (Flag15)
4198       --  Out_Present (Flag17)
4199       --  Null_Exclusion_Present (Flag11)
4200       --  Parameter_Type (Node2) subtype mark or access definition
4201       --  Expression (Node3) (set to Empty if no default expression present)
4202       --  Do_Accessibility_Check (Flag13-Sem)
4203       --  More_Ids (Flag5) (set to False if no more identifiers in list)
4204       --  Prev_Ids (Flag6) (set to False if no previous identifiers in list)
4205       --  Default_Expression (Node5-Sem)
4206
4207       ---------------
4208       -- 6.1  Mode --
4209       ---------------
4210
4211       --  MODE ::= [in] | in out | out
4212
4213       --  There is no explicit node in the tree for the Mode. Instead the
4214       --  In_Present and Out_Present flags are set in the parent node to
4215       --  record the presence of keywords specifying the mode.
4216
4217       --------------------------
4218       -- 6.3  Subprogram Body --
4219       --------------------------
4220
4221       --  SUBPROGRAM_BODY ::=
4222       --    SUBPROGRAM_SPECIFICATION is
4223       --      DECLARATIVE_PART
4224       --    begin
4225       --      HANDLED_SEQUENCE_OF_STATEMENTS
4226       --    end [DESIGNATOR];
4227
4228       --  N_Subprogram_Body
4229       --  Sloc points to FUNCTION or PROCEDURE
4230       --  Specification (Node1)
4231       --  Declarations (List2)
4232       --  Handled_Statement_Sequence (Node4)
4233       --  Activation_Chain_Entity (Node3-Sem)
4234       --  Corresponding_Spec (Node5-Sem)
4235       --  Acts_As_Spec (Flag4-Sem)
4236       --  Bad_Is_Detected (Flag15) used only by parser
4237       --  Do_Storage_Check (Flag17-Sem)
4238       --  Has_Priority_Pragma (Flag6-Sem)
4239       --  Is_Protected_Subprogram_Body (Flag7-Sem)
4240       --  Is_Entry_Barrier_Function (Flag8-Sem)
4241       --  Is_Task_Master (Flag5-Sem)
4242       --  Was_Originally_Stub (Flag13-Sem)
4243
4244       -----------------------------------
4245       -- 6.4  Procedure Call Statement --
4246       -----------------------------------
4247
4248       --  PROCEDURE_CALL_STATEMENT ::=
4249       --    procedure_NAME; | procedure_PREFIX ACTUAL_PARAMETER_PART;
4250
4251       --  Note: the reason that a procedure call has expression fields is
4252       --  that it semantically resembles an expression, e.g. overloading is
4253       --  allowed and a type is concocted for semantic processing purposes.
4254       --  Certain of these fields, such as Parens are not relevant, but it
4255       --  is easier to just supply all of them together!
4256
4257       --  N_Procedure_Call_Statement
4258       --  Sloc points to first token of name or prefix
4259       --  Name (Node2) stores name or prefix
4260       --  Parameter_Associations (List3) (set to No_List if no
4261       --   actual parameter part)
4262       --  First_Named_Actual (Node4-Sem)
4263       --  Controlling_Argument (Node1-Sem) (set to Empty if not dispatching)
4264       --  Do_Tag_Check (Flag13-Sem)
4265       --  No_Elaboration_Check (Flag14-Sem)
4266       --  Parameter_List_Truncated (Flag17-Sem)
4267       --  ABE_Is_Certain (Flag18-Sem)
4268       --  plus fields for expression
4269
4270       --  If any IN parameter requires a range check, then the corresponding
4271       --  argument expression has the Do_Range_Check flag set, and the range
4272       --  check is done against the formal type. Note that this argument
4273       --  expression may appear directly in the Parameter_Associations list,
4274       --  or may be a descendent of an N_Parameter_Association node that
4275       --  appears in this list.
4276
4277       ------------------------
4278       -- 6.4  Function Call --
4279       ------------------------
4280
4281       --  FUNCTION_CALL ::=
4282       --    function_NAME | function_PREFIX ACTUAL_PARAMETER_PART
4283
4284       --  Note: the parser may generate an indexed component node or simply
4285       --  a name node instead of a function call node. The semantic pass must
4286       --  correct this misidentification.
4287
4288       --  N_Function_Call
4289       --  Sloc points to first token of name or prefix
4290       --  Name (Node2) stores name or prefix
4291       --  Parameter_Associations (List3) (set to No_List if no
4292       --   actual parameter part)
4293       --  First_Named_Actual (Node4-Sem)
4294       --  Controlling_Argument (Node1-Sem) (set to Empty if not dispatching)
4295       --  Do_Tag_Check (Flag13-Sem)
4296       --  No_Elaboration_Check (Flag14-Sem)
4297       --  Parameter_List_Truncated (Flag17-Sem)
4298       --  ABE_Is_Certain (Flag18-Sem)
4299       --  plus fields for expression
4300
4301       --------------------------------
4302       -- 6.4  Actual Parameter Part --
4303       --------------------------------
4304
4305       --  ACTUAL_PARAMETER_PART ::=
4306       --    (PARAMETER_ASSOCIATION {,PARAMETER_ASSOCIATION})
4307
4308       --------------------------------
4309       -- 6.4  Parameter Association --
4310       --------------------------------
4311
4312       --  PARAMETER_ASSOCIATION ::=
4313       --    [formal_parameter_SELECTOR_NAME =>] EXPLICIT_ACTUAL_PARAMETER
4314
4315       --  Note: the N_Parameter_Association node is built only if a formal
4316       --  parameter selector name is present, otherwise the parameter
4317       --  association appears in the tree simply as the node for the
4318       --  explicit actual parameter.
4319
4320       --  N_Parameter_Association
4321       --  Sloc points to formal parameter
4322       --  Selector_Name (Node2) (always non-Empty)
4323       --  Explicit_Actual_Parameter (Node3)
4324       --  Next_Named_Actual (Node4-Sem)
4325
4326       ---------------------------
4327       -- 6.4  Actual Parameter --
4328       ---------------------------
4329
4330       --  EXPLICIT_ACTUAL_PARAMETER ::= EXPRESSION | variable_NAME
4331
4332       ---------------------------
4333       -- 6.5  Return Statement --
4334       ---------------------------
4335
4336       --  RETURN_STATEMENT ::= return [EXPRESSION]; -- Ada 95
4337
4338       --  In Ada 2005, we have:
4339
4340       --  SIMPLE_RETURN_STATEMENT ::= return [EXPRESSION];
4341
4342       --  EXTENDED_RETURN_STATEMENT ::=
4343       --    return DEFINING_IDENTIFIER : [aliased] RETURN_SUBTYPE_INDICATION
4344       --                                           [:= EXPRESSION] [do
4345       --      HANDLED_SEQUENCE_OF_STATEMENTS
4346       --    end return];
4347
4348       --  RETURN_SUBTYPE_INDICATION ::= SUBTYPE_INDICATION | ACCESS_DEFINITION
4349
4350       --  So in Ada 2005, RETURN_STATEMENT is no longer a nonterminal
4351
4352       --  N_Return_Statement
4353       --  Sloc points to RETURN
4354       --  Return_Statement_Entity (Node5-Sem)
4355       --  Expression (Node3) (set to Empty if no expression present)
4356       --  Storage_Pool (Node1-Sem)
4357       --  Procedure_To_Call (Node2-Sem)
4358       --  Do_Tag_Check (Flag13-Sem)
4359       --  By_Ref (Flag5-Sem)
4360       --  Comes_From_Extended_Return_Statement (Flag18-Sem)
4361
4362       --  ???N_Return_Statement represents a simple_return_statement,
4363       --  and should be renamed to N_Simple_Return_Statement.
4364
4365       --  Note: Return_Statement_Entity points to an E_Return_Statement
4366
4367       --  If a range check is required, then Do_Range_Check is set on the
4368       --  Expression. The check is against the return subtype of the function.
4369
4370       --  N_Extended_Return_Statement
4371       --  Sloc points to RETURN
4372       --  Return_Statement_Entity (Node5-Sem)
4373       --  Return_Object_Declarations (List3)
4374       --  Handled_Statement_Sequence (Node4) (set to Empty if not present)
4375       --  Storage_Pool (Node1-Sem)
4376       --  Procedure_To_Call (Node2-Sem)
4377       --  Do_Tag_Check (Flag13-Sem)
4378       --  By_Ref (Flag5-Sem)
4379
4380       --  Note: Return_Statement_Entity points to an E_Return_Statement.
4381       --  Note that Return_Object_Declarations is a list containing the
4382       --  N_Object_Declaration -- see comment on this field above.
4383       --  The declared object will have Is_Return_Object = True.
4384       --  There is no such syntactic category as return_object_declaration
4385       --  in the RM. Return_Object_Declarations represents this portion of
4386       --  the syntax for EXTENDED_RETURN_STATEMENT:
4387       --      DEFINING_IDENTIFIER : [aliased] RETURN_SUBTYPE_INDICATION
4388       --                                      [:= EXPRESSION]
4389
4390       --  There are two entities associated with an extended_return_statement:
4391       --  the Return_Statement_Entity represents the statement itself, and the
4392       --  Defining_Identifier of the Object_Declaration in
4393       --  Return_Object_Declarations represents the object being
4394       --  returned. N_Return_Statement has only the former.
4395
4396       ------------------------------
4397       -- 7.1  Package Declaration --
4398       ------------------------------
4399
4400       --  PACKAGE_DECLARATION ::= PACKAGE_SPECIFICATION;
4401
4402       --  Note: the activation chain entity for a package spec is used for
4403       --  all tasks declared in the package spec, or in the package body.
4404
4405       --  N_Package_Declaration
4406       --  Sloc points to PACKAGE
4407       --  Specification (Node1)
4408       --  Corresponding_Body (Node5-Sem)
4409       --  Parent_Spec (Node4-Sem)
4410       --  Activation_Chain_Entity (Node3-Sem)
4411
4412       --------------------------------
4413       -- 7.1  Package Specification --
4414       --------------------------------
4415
4416       --  PACKAGE_SPECIFICATION ::=
4417       --    package DEFINING_PROGRAM_UNIT_NAME is
4418       --      {BASIC_DECLARATIVE_ITEM}
4419       --    [private
4420       --      {BASIC_DECLARATIVE_ITEM}]
4421       --    end [[PARENT_UNIT_NAME .] IDENTIFIER]
4422
4423       --  N_Package_Specification
4424       --  Sloc points to PACKAGE
4425       --  Defining_Unit_Name (Node1)
4426       --  Visible_Declarations (List2)
4427       --  Private_Declarations (List3) (set to No_List if no private
4428       --   part present)
4429       --  End_Label (Node4)
4430       --  Generic_Parent (Node5-Sem)
4431       --  Limited_View_Installed (Flag18-Sem)
4432
4433       -----------------------
4434       -- 7.1  Package Body --
4435       -----------------------
4436
4437       --  PACKAGE_BODY ::=
4438       --    package body DEFINING_PROGRAM_UNIT_NAME is
4439       --      DECLARATIVE_PART
4440       --    [begin
4441       --      HANDLED_SEQUENCE_OF_STATEMENTS]
4442       --    end [[PARENT_UNIT_NAME .] IDENTIFIER];
4443
4444       --  N_Package_Body
4445       --  Sloc points to PACKAGE
4446       --  Defining_Unit_Name (Node1)
4447       --  Declarations (List2)
4448       --  Handled_Statement_Sequence (Node4) (set to Empty if no HSS present)
4449       --  Corresponding_Spec (Node5-Sem)
4450       --  Was_Originally_Stub (Flag13-Sem)
4451
4452       --  Note: if a source level package does not contain a handled sequence
4453       --  of statements, then the parser supplies a dummy one with a null
4454       --  sequence of statements. Comes_From_Source will be False in this
4455       --  constructed sequence. The reason we need this is for the End_Label
4456       --  field in the HSS.
4457
4458       -----------------------------------
4459       -- 7.4  Private Type Declaration --
4460       -----------------------------------
4461
4462       --  PRIVATE_TYPE_DECLARATION ::=
4463       --    type DEFINING_IDENTIFIER [DISCRIMINANT_PART]
4464       --      is [[abstract] tagged] [limited] private;
4465
4466       --  Note: TAGGED is not permitted in Ada 83 mode
4467
4468       --  N_Private_Type_Declaration
4469       --  Sloc points to TYPE
4470       --  Defining_Identifier (Node1)
4471       --  Discriminant_Specifications (List4) (set to No_List if no
4472       --   discriminant part)
4473       --  Unknown_Discriminants_Present (Flag13) set if (<>) discriminant
4474       --  Abstract_Present (Flag4)
4475       --  Tagged_Present (Flag15)
4476       --  Limited_Present (Flag17)
4477
4478       ----------------------------------------
4479       -- 7.4  Private Extension Declaration --
4480       ----------------------------------------
4481
4482       --  PRIVATE_EXTENSION_DECLARATION ::=
4483       --    type DEFINING_IDENTIFIER [DISCRIMINANT_PART] is
4484       --      [abstract] [limited | synchronized]
4485       --        new ancestor_SUBTYPE_INDICATION [and INTERFACE_LIST]
4486       --           with private;
4487
4488       --  Note: LIMITED, and private extension declarations are not allowed
4489       --        in Ada 83 mode.
4490
4491       --  N_Private_Extension_Declaration
4492       --  Sloc points to TYPE
4493       --  Defining_Identifier (Node1)
4494       --  Discriminant_Specifications (List4) (set to No_List if no
4495       --   discriminant part)
4496       --  Unknown_Discriminants_Present (Flag13) set if (<>) discriminant
4497       --  Abstract_Present (Flag4)
4498       --  Limited_Present (Flag17)
4499       --  Synchronized_Present (Flag7)
4500       --  Subtype_Indication (Node5)
4501       --  Interface_List (List2) (set to No_List if none)
4502
4503       ---------------------
4504       -- 8.4  Use Clause --
4505       ---------------------
4506
4507       --  USE_CLAUSE ::= USE_PACKAGE_CLAUSE | USE_TYPE_CLAUSE
4508
4509       -----------------------------
4510       -- 8.4  Use Package Clause --
4511       -----------------------------
4512
4513       --  USE_PACKAGE_CLAUSE ::= use package_NAME {, package_NAME};
4514
4515       --  N_Use_Package_Clause
4516       --  Sloc points to USE
4517       --  Names (List2)
4518       --  Next_Use_Clause (Node3-Sem)
4519       --  Hidden_By_Use_Clause (Elist4-Sem)
4520
4521       --------------------------
4522       -- 8.4  Use Type Clause --
4523       --------------------------
4524
4525       --  USE_TYPE_CLAUSE ::= use type SUBTYPE_MARK {, SUBTYPE_MARK};
4526
4527       --  Note: use type clause is not permitted in Ada 83 mode
4528
4529       --  N_Use_Type_Clause
4530       --  Sloc points to USE
4531       --  Subtype_Marks (List2)
4532       --  Next_Use_Clause (Node3-Sem)
4533       --  Hidden_By_Use_Clause (Elist4-Sem)
4534
4535       -------------------------------
4536       -- 8.5  Renaming Declaration --
4537       -------------------------------
4538
4539       --  RENAMING_DECLARATION ::=
4540       --    OBJECT_RENAMING_DECLARATION
4541       --  | EXCEPTION_RENAMING_DECLARATION
4542       --  | PACKAGE_RENAMING_DECLARATION
4543       --  | SUBPROGRAM_RENAMING_DECLARATION
4544       --  | GENERIC_RENAMING_DECLARATION
4545
4546       --------------------------------------
4547       -- 8.5  Object Renaming Declaration --
4548       --------------------------------------
4549
4550       --  OBJECT_RENAMING_DECLARATION ::=
4551       --    DEFINING_IDENTIFIER :
4552       --      [NULL_EXCLUSION] SUBTYPE_MARK renames object_NAME;
4553       --  | DEFINING_IDENTIFIER :
4554       --      ACCESS_DEFINITION renames object_NAME;
4555
4556       --  Note: Access_Definition is an optional field that gives support to
4557       --  Ada 2005 (AI-230). The parser generates nodes that have either the
4558       --  Subtype_Indication field or else the Access_Definition field.
4559
4560       --  N_Object_Renaming_Declaration
4561       --  Sloc points to first identifier
4562       --  Defining_Identifier (Node1)
4563       --  Null_Exclusion_Present (Flag11) (set to False if not present)
4564       --  Subtype_Mark (Node4) (set to Empty if not present)
4565       --  Access_Definition (Node3) (set to Empty if not present)
4566       --  Name (Node2)
4567       --  Corresponding_Generic_Association (Node5-Sem)
4568
4569       -----------------------------------------
4570       -- 8.5  Exception Renaming Declaration --
4571       -----------------------------------------
4572
4573       --  EXCEPTION_RENAMING_DECLARATION ::=
4574       --    DEFINING_IDENTIFIER : exception renames exception_NAME;
4575
4576       --  N_Exception_Renaming_Declaration
4577       --  Sloc points to first identifier
4578       --  Defining_Identifier (Node1)
4579       --  Name (Node2)
4580
4581       ---------------------------------------
4582       -- 8.5  Package Renaming Declaration --
4583       ---------------------------------------
4584
4585       --  PACKAGE_RENAMING_DECLARATION ::=
4586       --    package DEFINING_PROGRAM_UNIT_NAME renames package_NAME;
4587
4588       --  N_Package_Renaming_Declaration
4589       --  Sloc points to PACKAGE
4590       --  Defining_Unit_Name (Node1)
4591       --  Name (Node2)
4592       --  Parent_Spec (Node4-Sem)
4593
4594       ------------------------------------------
4595       -- 8.5  Subprogram Renaming Declaration --
4596       ------------------------------------------
4597
4598       --  SUBPROGRAM_RENAMING_DECLARATION ::=
4599       --    SUBPROGRAM_SPECIFICATION renames callable_entity_NAME;
4600
4601       --  N_Subprogram_Renaming_Declaration
4602       --  Sloc points to RENAMES
4603       --  Specification (Node1)
4604       --  Name (Node2)
4605       --  Parent_Spec (Node4-Sem)
4606       --  Corresponding_Spec (Node5-Sem)
4607       --  Corresponding_Formal_Spec (Node3-Sem)
4608       --  From_Default (Flag6-Sem)
4609
4610       -----------------------------------------
4611       -- 8.5.5  Generic Renaming Declaration --
4612       -----------------------------------------
4613
4614       --  GENERIC_RENAMING_DECLARATION ::=
4615       --    generic package DEFINING_PROGRAM_UNIT_NAME
4616       --      renames generic_package_NAME
4617       --  | generic procedure DEFINING_PROGRAM_UNIT_NAME
4618       --      renames generic_procedure_NAME
4619       --  | generic function DEFINING_PROGRAM_UNIT_NAME
4620       --      renames generic_function_NAME
4621
4622       --  N_Generic_Package_Renaming_Declaration
4623       --  Sloc points to GENERIC
4624       --  Defining_Unit_Name (Node1)
4625       --  Name (Node2)
4626       --  Parent_Spec (Node4-Sem)
4627
4628       --  N_Generic_Procedure_Renaming_Declaration
4629       --  Sloc points to GENERIC
4630       --  Defining_Unit_Name (Node1)
4631       --  Name (Node2)
4632       --  Parent_Spec (Node4-Sem)
4633
4634       --  N_Generic_Function_Renaming_Declaration
4635       --  Sloc points to GENERIC
4636       --  Defining_Unit_Name (Node1)
4637       --  Name (Node2)
4638       --  Parent_Spec (Node4-Sem)
4639
4640       --------------------------------
4641       -- 9.1  Task Type Declaration --
4642       --------------------------------
4643
4644       --  TASK_TYPE_DECLARATION ::=
4645       --    task type DEFINING_IDENTIFIER [KNOWN_DISCRIMINANT_PART]
4646       --      [is [new INTERFACE_LIST with] TASK_DEFINITITION];
4647
4648       --  N_Task_Type_Declaration
4649       --  Sloc points to TASK
4650       --  Defining_Identifier (Node1)
4651       --  Discriminant_Specifications (List4) (set to No_List if no
4652       --   discriminant part)
4653       --  Interface_List (List2) (set to No_List if none)
4654       --  Task_Definition (Node3) (set to Empty if not present)
4655       --  Corresponding_Body (Node5-Sem)
4656
4657       ----------------------------------
4658       -- 9.1  Single Task Declaration --
4659       ----------------------------------
4660
4661       --  SINGLE_TASK_DECLARATION ::=
4662       --    task DEFINING_IDENTIFIER
4663       --      [is [new INTERFACE_LIST with] TASK_DEFINITITION];
4664
4665       --  N_Single_Task_Declaration
4666       --  Sloc points to TASK
4667       --  Defining_Identifier (Node1)
4668       --  Interface_List (List2) (set to No_List if none)
4669       --  Task_Definition (Node3) (set to Empty if not present)
4670
4671       --------------------------
4672       -- 9.1  Task Definition --
4673       --------------------------
4674
4675       --  TASK_DEFINITION ::=
4676       --      {TASK_ITEM}
4677       --    [private
4678       --      {TASK_ITEM}]
4679       --    end [task_IDENTIFIER]
4680
4681       --  Note: as a result of semantic analysis, the list of task items can
4682       --  include implicit type declarations resulting from entry families.
4683
4684       --  N_Task_Definition
4685       --  Sloc points to first token of task definition
4686       --  Visible_Declarations (List2)
4687       --  Private_Declarations (List3) (set to No_List if no private part)
4688       --  End_Label (Node4)
4689       --  Has_Priority_Pragma (Flag6-Sem)
4690       --  Has_Storage_Size_Pragma (Flag5-Sem)
4691       --  Has_Task_Info_Pragma (Flag7-Sem)
4692       --  Has_Task_Name_Pragma (Flag8-Sem)
4693
4694       --------------------
4695       -- 9.1  Task Item --
4696       --------------------
4697
4698       --  TASK_ITEM ::= ENTRY_DECLARATION | REPRESENTATION_CLAUSE
4699
4700       --------------------
4701       -- 9.1  Task Body --
4702       --------------------
4703
4704       --  TASK_BODY ::=
4705       --    task body task_DEFINING_IDENTIFIER is
4706       --      DECLARATIVE_PART
4707       --    begin
4708       --      HANDLED_SEQUENCE_OF_STATEMENTS
4709       --    end [task_IDENTIFIER];
4710
4711       --  Gigi restriction: This node never appears
4712
4713       --  N_Task_Body
4714       --  Sloc points to TASK
4715       --  Defining_Identifier (Node1)
4716       --  Declarations (List2)
4717       --  Handled_Statement_Sequence (Node4)
4718       --  Is_Task_Master (Flag5-Sem)
4719       --  Activation_Chain_Entity (Node3-Sem)
4720       --  Corresponding_Spec (Node5-Sem)
4721       --  Was_Originally_Stub (Flag13-Sem)
4722
4723       -------------------------------------
4724       -- 9.4  Protected Type Declaration --
4725       -------------------------------------
4726
4727       --  PROTECTED_TYPE_DECLARATION ::=
4728       --    protected type DEFINING_IDENTIFIER [KNOWN_DISCRIMINANT_PART]
4729       --      is [new INTERFACE_LIST with] PROTECTED_DEFINITION;
4730
4731       --  Note: protected type declarations are not permitted in Ada 83 mode
4732
4733       --  N_Protected_Type_Declaration
4734       --  Sloc points to PROTECTED
4735       --  Defining_Identifier (Node1)
4736       --  Discriminant_Specifications (List4) (set to No_List if no
4737       --   discriminant part)
4738       --  Interface_List (List2) (set to No_List if none)
4739       --  Protected_Definition (Node3)
4740       --  Corresponding_Body (Node5-Sem)
4741
4742       ---------------------------------------
4743       -- 9.4  Single Protected Declaration --
4744       ---------------------------------------
4745
4746       --  SINGLE_PROTECTED_DECLARATION ::=
4747       --    protected DEFINING_IDENTIFIER
4748       --      is [new INTERFACE_LIST with] PROTECTED_DEFINITION;
4749
4750       --  Note: single protected declarations are not allowed in Ada 83 mode
4751
4752       --  N_Single_Protected_Declaration
4753       --  Sloc points to PROTECTED
4754       --  Defining_Identifier (Node1)
4755       --  Interface_List (List2) (set to No_List if none)
4756       --  Protected_Definition (Node3)
4757
4758       -------------------------------
4759       -- 9.4  Protected Definition --
4760       -------------------------------
4761
4762       --  PROTECTED_DEFINITION ::=
4763       --      {PROTECTED_OPERATION_DECLARATION}
4764       --    [private
4765       --      {PROTECTED_ELEMENT_DECLARATION}]
4766       --    end [protected_IDENTIFIER]
4767
4768       --  N_Protected_Definition
4769       --  Sloc points to first token of protected definition
4770       --  Visible_Declarations (List2)
4771       --  Private_Declarations (List3) (set to No_List if no private part)
4772       --  End_Label (Node4)
4773       --  Has_Priority_Pragma (Flag6-Sem)
4774
4775       ------------------------------------------
4776       -- 9.4  Protected Operation Declaration --
4777       ------------------------------------------
4778
4779       --  PROTECTED_OPERATION_DECLARATION ::=
4780       --    SUBPROGRAM_DECLARATION
4781       --  | ENTRY_DECLARATION
4782       --  | REPRESENTATION_CLAUSE
4783
4784       ----------------------------------------
4785       -- 9.4  Protected Element Declaration --
4786       ----------------------------------------
4787
4788       --  PROTECTED_ELEMENT_DECLARATION ::=
4789       --    PROTECTED_OPERATION_DECLARATION | COMPONENT_DECLARATION
4790
4791       -------------------------
4792       -- 9.4  Protected Body --
4793       -------------------------
4794
4795       --  PROTECTED_BODY ::=
4796       --    protected body DEFINING_IDENTIFIER is
4797       --      {PROTECTED_OPERATION_ITEM}
4798       --    end [protected_IDENTIFIER];
4799
4800       --  Note: protected bodies are not allowed in Ada 83 mode
4801
4802       --  Gigi restriction: This node never appears
4803
4804       --  N_Protected_Body
4805       --  Sloc points to PROTECTED
4806       --  Defining_Identifier (Node1)
4807       --  Declarations (List2) protected operation items (and pragmas)
4808       --  End_Label (Node4)
4809       --  Corresponding_Spec (Node5-Sem)
4810       --  Was_Originally_Stub (Flag13-Sem)
4811
4812       -----------------------------------
4813       -- 9.4  Protected Operation Item --
4814       -----------------------------------
4815
4816       --  PROTECTED_OPERATION_ITEM ::=
4817       --    SUBPROGRAM_DECLARATION
4818       --  | SUBPROGRAM_BODY
4819       --  | ENTRY_BODY
4820       --  | REPRESENTATION_CLAUSE
4821
4822       ------------------------------
4823       -- 9.5.2  Entry Declaration --
4824       ------------------------------
4825
4826       --  ENTRY_DECLARATION ::=
4827       --    [[not] overriding]
4828       --    entry DEFINING_IDENTIFIER
4829       --      [(DISCRETE_SUBTYPE_DEFINITION)] PARAMETER_PROFILE;
4830
4831       --  N_Entry_Declaration
4832       --  Sloc points to ENTRY
4833       --  Defining_Identifier (Node1)
4834       --  Discrete_Subtype_Definition (Node4) (set to Empty if not present)
4835       --  Parameter_Specifications (List3) (set to No_List if no formal part)
4836       --  Corresponding_Body (Node5-Sem)
4837       --  Must_Override (Flag14) set if overriding indicator present
4838       --  Must_Not_Override (Flag15) set if not_overriding indicator present
4839
4840       --  Note: overriding indicator is an Ada 2005 feature
4841
4842       -----------------------------
4843       -- 9.5.2  Accept statement --
4844       -----------------------------
4845
4846       --  ACCEPT_STATEMENT ::=
4847       --    accept entry_DIRECT_NAME
4848       --      [(ENTRY_INDEX)] PARAMETER_PROFILE [do
4849       --        HANDLED_SEQUENCE_OF_STATEMENTS
4850       --    end [entry_IDENTIFIER]];
4851
4852       --  Gigi restriction: This node never appears
4853
4854       --  Note: there are no explicit declarations allowed in an accept
4855       --  statement. However, the implicit declarations for any statement
4856       --  identifiers (labels and block/loop identifiers) are declarations
4857       --  that belong logically to the accept statement, and that is why
4858       --  there is a Declarations field in this node.
4859
4860       --  N_Accept_Statement
4861       --  Sloc points to ACCEPT
4862       --  Entry_Direct_Name (Node1)
4863       --  Entry_Index (Node5) (set to Empty if not present)
4864       --  Parameter_Specifications (List3) (set to No_List if no formal part)
4865       --  Handled_Statement_Sequence (Node4)
4866       --  Declarations (List2) (set to No_List if no declarations)
4867
4868       ------------------------
4869       -- 9.5.2  Entry Index --
4870       ------------------------
4871
4872       --  ENTRY_INDEX ::= EXPRESSION
4873
4874       -----------------------
4875       -- 9.5.2  Entry Body --
4876       -----------------------
4877
4878       --  ENTRY_BODY ::=
4879       --    entry DEFINING_IDENTIFIER ENTRY_BODY_FORMAL_PART ENTRY_BARRIER is
4880       --      DECLARATIVE_PART
4881       --    begin
4882       --      HANDLED_SEQUENCE_OF_STATEMENTS
4883       --    end [entry_IDENTIFIER];
4884
4885       --  ENTRY_BARRIER ::= when CONDITION
4886
4887       --  Note: we store the CONDITION of the ENTRY_BARRIER in the node for
4888       --  the ENTRY_BODY_FORMAL_PART to avoid the N_Entry_Body node getting
4889       --  too full (it would otherwise have too many fields)
4890
4891       --  Gigi restriction: This node never appears
4892
4893       --  N_Entry_Body
4894       --  Sloc points to ENTRY
4895       --  Defining_Identifier (Node1)
4896       --  Entry_Body_Formal_Part (Node5)
4897       --  Declarations (List2)
4898       --  Handled_Statement_Sequence (Node4)
4899       --  Activation_Chain_Entity (Node3-Sem)
4900
4901       -----------------------------------
4902       -- 9.5.2  Entry Body Formal Part --
4903       -----------------------------------
4904
4905       --  ENTRY_BODY_FORMAL_PART ::=
4906       --    [(ENTRY_INDEX_SPECIFICATION)] PARAMETER_PROFILE
4907
4908       --  Note that an entry body formal part node is present even if it is
4909       --  empty. This reflects the grammar, in which it is the components of
4910       --  the entry body formal part that are optional, not the entry body
4911       --  formal part itself. Also this means that the barrier condition
4912       --  always has somewhere to be stored.
4913
4914       --  Gigi restriction: This node never appears
4915
4916       --  N_Entry_Body_Formal_Part
4917       --  Sloc points to first token
4918       --  Entry_Index_Specification (Node4) (set to Empty if not present)
4919       --  Parameter_Specifications (List3) (set to No_List if no formal part)
4920       --  Condition (Node1) from entry barrier of entry body
4921
4922       --------------------------
4923       -- 9.5.2  Entry Barrier --
4924       --------------------------
4925
4926       --  ENTRY_BARRIER ::= when CONDITION
4927
4928       --------------------------------------
4929       -- 9.5.2  Entry Index Specification --
4930       --------------------------------------
4931
4932       --  ENTRY_INDEX_SPECIFICATION ::=
4933       --    for DEFINING_IDENTIFIER in DISCRETE_SUBTYPE_DEFINITION
4934
4935       --  Gigi restriction: This node never appears
4936
4937       --  N_Entry_Index_Specification
4938       --  Sloc points to FOR
4939       --  Defining_Identifier (Node1)
4940       --  Discrete_Subtype_Definition (Node4)
4941
4942       ---------------------------------
4943       -- 9.5.3  Entry Call Statement --
4944       ---------------------------------
4945
4946       --  ENTRY_CALL_STATEMENT ::= entry_NAME [ACTUAL_PARAMETER_PART];
4947
4948       --  The parser may generate a procedure call for this construct. The
4949       --  semantic pass must correct this misidentification where needed.
4950
4951       --  Gigi restriction: This node never appears
4952
4953       --  N_Entry_Call_Statement
4954       --  Sloc points to first token of name
4955       --  Name (Node2)
4956       --  Parameter_Associations (List3) (set to No_List if no
4957       --   actual parameter part)
4958       --  First_Named_Actual (Node4-Sem)
4959
4960       ------------------------------
4961       -- 9.5.4  Requeue Statement --
4962       ------------------------------
4963
4964       --  REQUEUE_STATEMENT ::= requeue entry_NAME [with abort];
4965
4966       --  Note: requeue statements are not permitted in Ada 83 mode
4967
4968       --  Gigi restriction: This node never appears
4969
4970       --  N_Requeue_Statement
4971       --  Sloc points to REQUEUE
4972       --  Name (Node2)
4973       --  Abort_Present (Flag15)
4974
4975       --------------------------
4976       -- 9.6  Delay Statement --
4977       --------------------------
4978
4979       --  DELAY_STATEMENT ::=
4980       --    DELAY_UNTIL_STATEMENT
4981       --  | DELAY_RELATIVE_STATEMENT
4982
4983       --------------------------------
4984       -- 9.6  Delay Until Statement --
4985       --------------------------------
4986
4987       --  DELAY_UNTIL_STATEMENT ::= delay until delay_EXPRESSION;
4988
4989       --  Note: delay until statements are not permitted in Ada 83 mode
4990
4991       --  Gigi restriction: This node never appears
4992
4993       --  N_Delay_Until_Statement
4994       --  Sloc points to DELAY
4995       --  Expression (Node3)
4996
4997       -----------------------------------
4998       -- 9.6  Delay Relative Statement --
4999       -----------------------------------
5000
5001       --  DELAY_RELATIVE_STATEMENT ::= delay delay_EXPRESSION;
5002
5003       --  Gigi restriction: This node never appears
5004
5005       --  N_Delay_Relative_Statement
5006       --  Sloc points to DELAY
5007       --  Expression (Node3)
5008
5009       ---------------------------
5010       -- 9.7  Select Statement --
5011       ---------------------------
5012
5013       --  SELECT_STATEMENT ::=
5014       --    SELECTIVE_ACCEPT
5015       --  | TIMED_ENTRY_CALL
5016       --  | CONDITIONAL_ENTRY_CALL
5017       --  | ASYNCHRONOUS_SELECT
5018
5019       -----------------------------
5020       -- 9.7.1  Selective Accept --
5021       -----------------------------
5022
5023       --  SELECTIVE_ACCEPT ::=
5024       --    select
5025       --      [GUARD]
5026       --        SELECT_ALTERNATIVE
5027       --    {or
5028       --      [GUARD]
5029       --        SELECT_ALTERNATIVE}
5030       --    [else
5031       --      SEQUENCE_OF_STATEMENTS]
5032       --    end select;
5033
5034       --  Gigi restriction: This node never appears
5035
5036       --  Note: the guard expression, if present, appears in the node for
5037       --  the select alternative.
5038
5039       --  N_Selective_Accept
5040       --  Sloc points to SELECT
5041       --  Select_Alternatives (List1)
5042       --  Else_Statements (List4) (set to No_List if no else part)
5043
5044       ------------------
5045       -- 9.7.1  Guard --
5046       ------------------
5047
5048       --  GUARD ::= when CONDITION =>
5049
5050       --  As noted above, the CONDITION that is part of a GUARD is included
5051       --  in the node for the select alernative for convenience.
5052
5053       -------------------------------
5054       -- 9.7.1  Select Alternative --
5055       -------------------------------
5056
5057       --  SELECT_ALTERNATIVE ::=
5058       --    ACCEPT_ALTERNATIVE
5059       --  | DELAY_ALTERNATIVE
5060       --  | TERMINATE_ALTERNATIVE
5061
5062       -------------------------------
5063       -- 9.7.1  Accept Alternative --
5064       -------------------------------
5065
5066       --  ACCEPT_ALTERNATIVE ::=
5067       --    ACCEPT_STATEMENT [SEQUENCE_OF_STATEMENTS]
5068
5069       --  Gigi restriction: This node never appears
5070
5071       --  N_Accept_Alternative
5072       --  Sloc points to ACCEPT
5073       --  Accept_Statement (Node2)
5074       --  Condition (Node1) from the guard (set to Empty if no guard present)
5075       --  Statements (List3) (set to Empty_List if no statements)
5076       --  Pragmas_Before (List4) pragmas before alt (set to No_List if none)
5077       --  Accept_Handler_Records (List5-Sem)
5078
5079       ------------------------------
5080       -- 9.7.1  Delay Alternative --
5081       ------------------------------
5082
5083       --  DELAY_ALTERNATIVE ::=
5084       --    DELAY_STATEMENT [SEQUENCE_OF_STATEMENTS]
5085
5086       --  Gigi restriction: This node never appears
5087
5088       --  N_Delay_Alternative
5089       --  Sloc points to DELAY
5090       --  Delay_Statement (Node2)
5091       --  Condition (Node1) from the guard (set to Empty if no guard present)
5092       --  Statements (List3) (set to Empty_List if no statements)
5093       --  Pragmas_Before (List4) pragmas before alt (set to No_List if none)
5094
5095       ----------------------------------
5096       -- 9.7.1  Terminate Alternative --
5097       ----------------------------------
5098
5099       --  TERMINATE_ALTERNATIVE ::= terminate;
5100
5101       --  Gigi restriction: This node never appears
5102
5103       --  N_Terminate_Alternative
5104       --  Sloc points to TERMINATE
5105       --  Condition (Node1) from the guard (set to Empty if no guard present)
5106       --  Pragmas_Before (List4) pragmas before alt (set to No_List if none)
5107       --  Pragmas_After (List5) pragmas after alt (set to No_List if none)
5108
5109       -----------------------------
5110       -- 9.7.2  Timed Entry Call --
5111       -----------------------------
5112
5113       --  TIMED_ENTRY_CALL ::=
5114       --    select
5115       --      ENTRY_CALL_ALTERNATIVE
5116       --    or
5117       --      DELAY_ALTERNATIVE
5118       --    end select;
5119
5120       --  Gigi restriction: This node never appears
5121
5122       --  N_Timed_Entry_Call
5123       --  Sloc points to SELECT
5124       --  Entry_Call_Alternative (Node1)
5125       --  Delay_Alternative (Node4)
5126
5127       -----------------------------------
5128       -- 9.7.2  Entry Call Alternative --
5129       -----------------------------------
5130
5131       --  ENTRY_CALL_ALTERNATIVE ::=
5132       --    PROCEDURE_OR_ENTRY_CALL [SEQUENCE_OF_STATEMENTS]
5133
5134       --  PROCEDURE_OR_ENTRY_CALL ::=
5135       --    PROCEDURE_CALL_STATEMENT | ENTRY_CALL_STATEMENT
5136
5137       --  Gigi restriction: This node never appears
5138
5139       --  N_Entry_Call_Alternative
5140       --  Sloc points to first token of entry call statement
5141       --  Entry_Call_Statement (Node1)
5142       --  Statements (List3) (set to Empty_List if no statements)
5143       --  Pragmas_Before (List4) pragmas before alt (set to No_List if none)
5144
5145       -----------------------------------
5146       -- 9.7.3  Conditional Entry Call --
5147       -----------------------------------
5148
5149       --  CONDITIONAL_ENTRY_CALL ::=
5150       --    select
5151       --      ENTRY_CALL_ALTERNATIVE
5152       --    else
5153       --      SEQUENCE_OF_STATEMENTS
5154       --    end select;
5155
5156       --  Gigi restriction: This node never appears
5157
5158       --  N_Conditional_Entry_Call
5159       --  Sloc points to SELECT
5160       --  Entry_Call_Alternative (Node1)
5161       --  Else_Statements (List4)
5162
5163       --------------------------------
5164       -- 9.7.4  Asynchronous Select --
5165       --------------------------------
5166
5167       --  ASYNCHRONOUS_SELECT ::=
5168       --    select
5169       --      TRIGGERING_ALTERNATIVE
5170       --    then abort
5171       --      ABORTABLE_PART
5172       --    end select;
5173
5174       --  Note: asynchronous select is not permitted in Ada 83 mode
5175
5176       --  Gigi restriction: This node never appears
5177
5178       --  N_Asynchronous_Select
5179       --  Sloc points to SELECT
5180       --  Triggering_Alternative (Node1)
5181       --  Abortable_Part (Node2)
5182
5183       -----------------------------------
5184       -- 9.7.4  Triggering Alternative --
5185       -----------------------------------
5186
5187       --  TRIGGERING_ALTERNATIVE ::=
5188       --    TRIGGERING_STATEMENT [SEQUENCE_OF_STATEMENTS]
5189
5190       --  Gigi restriction: This node never appears
5191
5192       --  N_Triggering_Alternative
5193       --  Sloc points to first token of triggering statement
5194       --  Triggering_Statement (Node1)
5195       --  Statements (List3) (set to Empty_List if no statements)
5196       --  Pragmas_Before (List4) pragmas before alt (set to No_List if none)
5197
5198       ---------------------------------
5199       -- 9.7.4  Triggering Statement --
5200       ---------------------------------
5201
5202       --  TRIGGERING_STATEMENT ::= PROCEDURE_OR_ENTRY_CALL | DELAY_STATEMENT
5203
5204       ---------------------------
5205       -- 9.7.4  Abortable Part --
5206       ---------------------------
5207
5208       --  ABORTABLE_PART ::= SEQUENCE_OF_STATEMENTS
5209
5210       --  Gigi restriction: This node never appears
5211
5212       --  N_Abortable_Part
5213       --  Sloc points to ABORT
5214       --  Statements (List3)
5215
5216       --------------------------
5217       -- 9.8  Abort Statement --
5218       --------------------------
5219
5220       --  ABORT_STATEMENT ::= abort task_NAME {, task_NAME};
5221
5222       --  Gigi restriction: This node never appears
5223
5224       --  N_Abort_Statement
5225       --  Sloc points to ABORT
5226       --  Names (List2)
5227
5228       -------------------------
5229       -- 10.1.1  Compilation --
5230       -------------------------
5231
5232       --  COMPILATION ::= {COMPILATION_UNIT}
5233
5234       --  There is no explicit node in the tree for a compilation, since in
5235       --  general the compiler is processing only a single compilation unit
5236       --  at a time. It is possible to parse multiple units in syntax check
5237       --  only mode, but they the trees are discarded in any case.
5238
5239       ------------------------------
5240       -- 10.1.1  Compilation Unit --
5241       ------------------------------
5242
5243       --  COMPILATION_UNIT ::=
5244       --    CONTEXT_CLAUSE LIBRARY_ITEM
5245       --  | CONTEXT_CLAUSE SUBUNIT
5246
5247       --  The N_Compilation_Unit node itself respresents the above syntax.
5248       --  However, there are two additional items not reflected in the above
5249       --  syntax. First we have the global declarations that are added by the
5250       --  code generator. These are outer level declarations (so they cannot
5251       --  be represented as being inside the units). An example is the wrapper
5252       --  subprograms that are created to do ABE checking. As always a list of
5253       --  declarations can contain actions as well (i.e. statements), and such
5254       --  statements are executed as part of the elaboration of the unit. Note
5255       --  that all such declarations are elaborated before the library unit.
5256
5257       --  Similarly, certain actions need to be elaborated at the completion
5258       --  of elaboration of the library unit (notably the statement that sets
5259       --  the Boolean flag indicating that elaboration is complete).
5260
5261       --  The third item not reflected in the syntax is pragmas that appear
5262       --  after the compilation unit. As always pragmas are a problem since
5263       --  they are not part of the formal syntax, but can be stuck into the
5264       --  source following a set of ad hoc rules, and we have to find an ad
5265       --  hoc way of sticking them into the tree. For pragmas that appear
5266       --  before the library unit, we just consider them to be part of the
5267       --  context clause, and pragmas can appear in the Context_Items list
5268       --  of the compilation unit. However, pragmas can also appear after
5269       --  the library item.
5270
5271       --  To deal with all these problems, we create an auxiliary node for
5272       --  a compilation unit, referenced from the N_Compilation_Unit node
5273       --  that contains these three items.
5274
5275       --  N_Compilation_Unit
5276       --  Sloc points to first token of defining unit name
5277       --  Library_Unit (Node4-Sem) corresponding/parent spec/body
5278       --  Context_Items (List1) context items and pragmas preceding unit
5279       --  Private_Present (Flag15) set if library unit has private keyword
5280       --  Unit (Node2) library item or subunit
5281       --  Aux_Decls_Node (Node5) points to the N_Compilation_Unit_Aux node
5282       --  Has_No_Elaboration_Code (Flag17-Sem)
5283       --  Body_Required (Flag13-Sem) set for spec if body is required
5284       --  Acts_As_Spec (Flag4-Sem) flag for subprogram body with no spec
5285       --  First_Inlined_Subprogram (Node3-Sem)
5286
5287       --  N_Compilation_Unit_Aux
5288       --  Sloc is a copy of the Sloc from the N_Compilation_Unit node
5289       --  Declarations (List2) (set to No_List if no global declarations)
5290       --  Actions (List1) (set to No_List if no actions)
5291       --  Pragmas_After (List5) pragmas after unit (set to No_List if none)
5292       --  Config_Pragmas (List4) config pragmas (set to Empty_List if none)
5293
5294       --------------------------
5295       -- 10.1.1  Library Item --
5296       --------------------------
5297
5298       --  LIBRARY_ITEM ::=
5299       --    [private] LIBRARY_UNIT_DECLARATION
5300       --  | LIBRARY_UNIT_BODY
5301       --  | [private] LIBRARY_UNIT_RENAMING_DECLARATION
5302
5303       --  Note: PRIVATE is not allowed in Ada 83 mode
5304
5305       --  There is no explicit node in the tree for library item, instead
5306       --  the declaration or body, and the flag for private if present,
5307       --  appear in the N_Compilation_Unit clause.
5308
5309       ----------------------------------------
5310       -- 10.1.1  Library Unit Declararation --
5311       ----------------------------------------
5312
5313       --  LIBRARY_UNIT_DECLARATION ::=
5314       --    SUBPROGRAM_DECLARATION | PACKAGE_DECLARATION
5315       --  | GENERIC_DECLARATION    | GENERIC_INSTANTIATION
5316
5317       -------------------------------------------------
5318       -- 10.1.1  Library Unit Renaming Declararation --
5319       -------------------------------------------------
5320
5321       --  LIBRARY_UNIT_RENAMING_DECLARATION ::=
5322       --    PACKAGE_RENAMING_DECLARATION
5323       --  | GENERIC_RENAMING_DECLARATION
5324       --  | SUBPROGRAM_RENAMING_DECLARATION
5325
5326       -------------------------------
5327       -- 10.1.1  Library unit body --
5328       -------------------------------
5329
5330       --  LIBRARY_UNIT_BODY ::= SUBPROGRAM_BODY | PACKAGE_BODY
5331
5332       ------------------------------
5333       -- 10.1.1  Parent Unit Name --
5334       ------------------------------
5335
5336       --  PARENT_UNIT_NAME ::= NAME
5337
5338       ----------------------------
5339       -- 10.1.2  Context clause --
5340       ----------------------------
5341
5342       --  CONTEXT_CLAUSE ::= {CONTEXT_ITEM}
5343
5344       --  The context clause can include pragmas, and any pragmas that appear
5345       --  before the context clause proper (i.e. all configuration pragmas,
5346       --  also appear at the front of this list).
5347
5348       --------------------------
5349       -- 10.1.2  Context_Item --
5350       --------------------------
5351
5352       --  CONTEXT_ITEM ::= WITH_CLAUSE | USE_CLAUSE  | WITH_TYPE_CLAUSE
5353
5354       -------------------------
5355       -- 10.1.2  With clause --
5356       -------------------------
5357
5358       --  WITH_CLAUSE ::=
5359       --    with library_unit_NAME {,library_unit_NAME};
5360
5361       --  A separate With clause is built for each name, so that we have
5362       --  a Corresponding_Spec field for each with'ed spec. The flags
5363       --  First_Name and Last_Name are used to reconstruct the exact
5364       --  source form. When a list of names appears in one with clause,
5365       --  the first name in the list has First_Name set, and the last
5366       --  has Last_Name set. If the with clause has only one name, then
5367       --  both of the flags First_Name and Last_Name are set in this name.
5368
5369       --  Note: in the case of implicit with's that are installed by the
5370       --  Rtsfind routine, Implicit_With is set, and the Sloc is typically
5371       --  set to Standard_Location, but it is incorrect to test the Sloc
5372       --  to find out if a with clause is implicit, test the flag instead.
5373
5374       --  N_With_Clause
5375       --  Sloc points to first token of library unit name
5376       --  Name (Node2)
5377       --  Library_Unit (Node4-Sem)
5378       --  Corresponding_Spec (Node5-Sem)
5379       --  First_Name (Flag5) (set to True if first name or only one name)
5380       --  Last_Name (Flag6) (set to True if last name or only one name)
5381       --  Context_Installed (Flag13-Sem)
5382       --  Elaborate_Present (Flag4-Sem)
5383       --  Elaborate_All_Present (Flag14-Sem)
5384       --  Elaborate_All_Desirable (Flag9-Sem)
5385       --  Elaborate_Desirable (Flag11-Sem)
5386       --  Private_Present (Flag15) set if with_clause has private keyword
5387       --  Implicit_With (Flag16-Sem)
5388       --  Limited_Present (Flag17)  set if LIMITED is present
5389       --  Limited_View_Installed (Flag18-Sem)
5390       --  Unreferenced_In_Spec (Flag7-Sem)
5391       --  No_Entities_Ref_In_Spec (Flag8-Sem)
5392
5393       --  Note: Limited_Present and Limited_View_Installed give support to
5394       --        Ada 2005 (AI-50217).
5395       --  Similarly, Private_Present gives support to AI-50262.
5396
5397       ----------------------
5398       -- With_Type clause --
5399       ----------------------
5400
5401       --  This is a GNAT extension, used to implement mutually recursive
5402       --  types declared in different packages.
5403       --  Note: this is now obsolete. The functionality of this construct
5404       --  is now implemented by the Ada 2005 Limited_with_Clause.
5405
5406       ---------------------
5407       -- 10.2  Body stub --
5408       ---------------------
5409
5410       --  BODY_STUB ::=
5411       --    SUBPROGRAM_BODY_STUB
5412       --  | PACKAGE_BODY_STUB
5413       --  | TASK_BODY_STUB
5414       --  | PROTECTED_BODY_STUB
5415
5416       ----------------------------------
5417       -- 10.1.3  Subprogram Body Stub --
5418       ----------------------------------
5419
5420       --  SUBPROGRAM_BODY_STUB ::=
5421       --    SUBPROGRAM_SPECIFICATION is separate;
5422
5423       --  N_Subprogram_Body_Stub
5424       --  Sloc points to FUNCTION or PROCEDURE
5425       --  Specification (Node1)
5426       --  Library_Unit (Node4-Sem) points to the subunit
5427       --  Corresponding_Body (Node5-Sem)
5428
5429       -------------------------------
5430       -- 10.1.3  Package Body Stub --
5431       -------------------------------
5432
5433       --  PACKAGE_BODY_STUB ::=
5434       --    package body DEFINING_IDENTIFIER is separate;
5435
5436       --  N_Package_Body_Stub
5437       --  Sloc points to PACKAGE
5438       --  Defining_Identifier (Node1)
5439       --  Library_Unit (Node4-Sem) points to the subunit
5440       --  Corresponding_Body (Node5-Sem)
5441
5442       ----------------------------
5443       -- 10.1.3  Task Body Stub --
5444       ----------------------------
5445
5446       --  TASK_BODY_STUB ::=
5447       --    task body DEFINING_IDENTIFIER is separate;
5448
5449       --  N_Task_Body_Stub
5450       --  Sloc points to TASK
5451       --  Defining_Identifier (Node1)
5452       --  Library_Unit (Node4-Sem) points to the subunit
5453       --  Corresponding_Body (Node5-Sem)
5454
5455       ---------------------------------
5456       -- 10.1.3  Protected Body Stub --
5457       ---------------------------------
5458
5459       --  PROTECTED_BODY_STUB ::=
5460       --    protected body DEFINING_IDENTIFIER is separate;
5461
5462       --  Note: protected body stubs are not allowed in Ada 83 mode
5463
5464       --  N_Protected_Body_Stub
5465       --  Sloc points to PROTECTED
5466       --  Defining_Identifier (Node1)
5467       --  Library_Unit (Node4-Sem) points to the subunit
5468       --  Corresponding_Body (Node5-Sem)
5469
5470       ---------------------
5471       -- 10.1.3  Subunit --
5472       ---------------------
5473
5474       --  SUBUNIT ::= separate (PARENT_UNIT_NAME) PROPER_BODY
5475
5476       --  N_Subunit
5477       --  Sloc points to SEPARATE
5478       --  Name (Node2) is the name of the parent unit
5479       --  Proper_Body (Node1) is the subunit body
5480       --  Corresponding_Stub (Node3-Sem) is the stub declaration for the unit.
5481
5482       ---------------------------------
5483       -- 11.1  Exception Declaration --
5484       ---------------------------------
5485
5486       --  EXCEPTION_DECLARATION ::= DEFINING_IDENTIFIER_LIST : exception;
5487
5488       --  For consistency with object declarations etc, the parser converts
5489       --  the case of multiple identifiers being declared to a series of
5490       --  declarations in which the expression is copied, using the More_Ids
5491       --  and Prev_Ids flags to remember the souce form as described in the
5492       --  section on "Handling of Defining Identifier Lists".
5493
5494       --  N_Exception_Declaration
5495       --  Sloc points to EXCEPTION
5496       --  Defining_Identifier (Node1)
5497       --  Expression (Node3-Sem)
5498       --  Renaming_Exception (Node2-Sem)
5499       --  More_Ids (Flag5) (set to False if no more identifiers in list)
5500       --  Prev_Ids (Flag6) (set to False if no previous identifiers in list)
5501
5502       ------------------------------------------
5503       -- 11.2  Handled Sequence Of Statements --
5504       ------------------------------------------
5505
5506       --  HANDLED_SEQUENCE_OF_STATEMENTS ::=
5507       --      SEQUENCE_OF_STATEMENTS
5508       --    [exception
5509       --      EXCEPTION_HANDLER
5510       --      {EXCEPTION_HANDLER}]
5511       --    [at end
5512       --      cleanup_procedure_call (param, param, param, ...);]
5513
5514       --  The AT END phrase is a GNAT extension to provide for cleanups. It is
5515       --  used only internally currently, but is considered to be syntactic.
5516       --  At the moment, the only cleanup action allowed is a single call to
5517       --  a parameterless procedure, and the Identifier field of the node is
5518       --  the procedure to be called. Also there is a current restriction
5519       --  that exception handles and a cleanup cannot be present in the same
5520       --  frame, so at least one of Exception_Handlers or the Identifier must
5521       --  be missing.
5522
5523       --  Actually, more accurately, this restriction applies to the original
5524       --  source program. In the expanded tree, if the At_End_Proc field is
5525       --  present, then there will also be an exception handler of the form:
5526
5527       --     when all others =>
5528       --        cleanup;
5529       --        raise;
5530
5531       --  where cleanup is the procedure to be generated. The reason we do
5532       --  this is so that the front end can handle the necessary entries in
5533       --  the exception tables, and other exception handler actions required
5534       --  as part of the normal handling for exception handlers.
5535
5536       --  The AT END cleanup handler protects only the sequence of statements
5537       --  (not the associated declarations of the parent), just like exception
5538       --  handlers. The big difference is that the cleanup procedure is called
5539       --  on either a normal or an abnormal exit from the statement sequence.
5540
5541       --  Note: the list of Exception_Handlers can contain pragmas as well
5542       --  as actual handlers. In practice these pragmas can only occur at
5543       --  the start of the list, since any pragmas occurring later on will
5544       --  be included in the statement list of the corresponding handler.
5545
5546       --  Note: although in the Ada syntax, the sequence of statements in
5547       --  a handled sequence of statements can only contain statements, we
5548       --  allow free mixing of declarations and statements in the resulting
5549       --  expanded tree. This is for example used to deal with the case of
5550       --  a cleanup procedure that must handle declarations as well as the
5551       --  statements of a block.
5552
5553       --  N_Handled_Sequence_Of_Statements
5554       --  Sloc points to first token of first statement
5555       --  Statements (List3)
5556       --  End_Label (Node4) (set to Empty if expander generated)
5557       --  Exception_Handlers (List5) (set to No_List if none present)
5558       --  At_End_Proc (Node1) (set to Empty if no clean up procedure)
5559       --  First_Real_Statement (Node2-Sem)
5560       --  Zero_Cost_Handling (Flag5-Sem)
5561
5562       --  Note: the parent always contains a Declarations field which contains
5563       --  declarations associated with the handled sequence of statements. This
5564       --  is true even in the case of an accept statement (see description of
5565       --  the N_Accept_Statement node).
5566
5567       --  End_Label refers to the containing construct
5568
5569       -----------------------------
5570       -- 11.2  Exception Handler --
5571       -----------------------------
5572
5573       --  EXCEPTION_HANDLER ::=
5574       --    when [CHOICE_PARAMETER_SPECIFICATION :]
5575       --      EXCEPTION_CHOICE {| EXCEPTION_CHOICE} =>
5576       --        SEQUENCE_OF_STATEMENTS
5577
5578       --  Note: choice parameter specification is not allowed in Ada 83 mode
5579
5580       --  N_Exception_Handler
5581       --  Sloc points to WHEN
5582       --  Choice_Parameter (Node2) (set to Empty if not present)
5583       --  Exception_Choices (List4)
5584       --  Statements (List3)
5585       --  Exception_Label (Node5-Sem) (set to Empty of not present)
5586       --  Zero_Cost_Handling (Flag5-Sem)
5587       --  Local_Raise_Statements (Elist1-Sem) (set to No_Elist if not present)
5588       --  Local_Raise_Not_OK (Flag7-Sem)
5589       --  Has_Local_Raise (Flag8-Sem)
5590
5591       ------------------------------------------
5592       -- 11.2  Choice parameter specification --
5593       ------------------------------------------
5594
5595       --  CHOICE_PARAMETER_SPECIFICATION ::= DEFINING_IDENTIFIER
5596
5597       ----------------------------
5598       -- 11.2  Exception Choice --
5599       ----------------------------
5600
5601       --  EXCEPTION_CHOICE ::= exception_NAME | others
5602
5603       --  Except in the case of OTHERS, no explicit node appears in the tree
5604       --  for exception choice. Instead the exception name appears directly.
5605       --  An OTHERS choice is represented by a N_Others_Choice node (see
5606       --  section 3.8.1.
5607
5608       --  Note: for the exception choice created for an at end handler, the
5609       --  exception choice is an N_Others_Choice node with All_Others set.
5610
5611       ---------------------------
5612       -- 11.3  Raise Statement --
5613       ---------------------------
5614
5615       --  RAISE_STATEMENT ::= raise [exception_NAME];
5616
5617       --  In Ada 2005, we have
5618
5619       --  RAISE_STATEMENT ::= raise; | raise exception_NAME [with EXPRESSION];
5620
5621       --  N_Raise_Statement
5622       --  Sloc points to RAISE
5623       --  Name (Node2) (set to Empty if no exception name present)
5624       --  Expression (Node3) (set to Empty if no expression present)
5625
5626       -------------------------------
5627       -- 12.1  Generic Declaration --
5628       -------------------------------
5629
5630       --  GENERIC_DECLARATION ::=
5631       --    GENERIC_SUBPROGRAM_DECLARATION | GENERIC_PACKAGE_DECLARATION
5632
5633       ------------------------------------------
5634       -- 12.1  Generic Subprogram Declaration --
5635       ------------------------------------------
5636
5637       --  GENERIC_SUBPROGRAM_DECLARATION ::=
5638       --    GENERIC_FORMAL_PART SUBPROGRAM_SPECIFICATION;
5639
5640       --  Note: Generic_Formal_Declarations can include pragmas
5641
5642       --  N_Generic_Subprogram_Declaration
5643       --  Sloc points to GENERIC
5644       --  Specification (Node1) subprogram specification
5645       --  Corresponding_Body (Node5-Sem)
5646       --  Generic_Formal_Declarations (List2) from generic formal part
5647       --  Parent_Spec (Node4-Sem)
5648
5649       ---------------------------------------
5650       -- 12.1  Generic Package Declaration --
5651       ---------------------------------------
5652
5653       --  GENERIC_PACKAGE_DECLARATION ::=
5654       --    GENERIC_FORMAL_PART PACKAGE_SPECIFICATION;
5655
5656       --  Note: when we do generics right, the Activation_Chain_Entity entry
5657       --  for this node can be removed (since the expander won't see generic
5658       --  units any more)???.
5659
5660       --  Note: Generic_Formal_Declarations can include pragmas
5661
5662       --  N_Generic_Package_Declaration
5663       --  Sloc points to GENERIC
5664       --  Specification (Node1) package specification
5665       --  Corresponding_Body (Node5-Sem)
5666       --  Generic_Formal_Declarations (List2) from generic formal part
5667       --  Parent_Spec (Node4-Sem)
5668       --  Activation_Chain_Entity (Node3-Sem)
5669
5670       -------------------------------
5671       -- 12.1  Generic Formal Part --
5672       -------------------------------
5673
5674       --  GENERIC_FORMAL_PART ::=
5675       --    generic {GENERIC_FORMAL_PARAMETER_DECLARATION | USE_CLAUSE}
5676
5677       ------------------------------------------------
5678       -- 12.1  Generic Formal Parameter Declaration --
5679       ------------------------------------------------
5680
5681       --  GENERIC_FORMAL_PARAMETER_DECLARATION ::=
5682       --    FORMAL_OBJECT_DECLARATION
5683       --  | FORMAL_TYPE_DECLARATION
5684       --  | FORMAL_SUBPROGRAM_DECLARATION
5685       --  | FORMAL_PACKAGE_DECLARATION
5686
5687       ---------------------------------
5688       -- 12.3  Generic Instantiation --
5689       ---------------------------------
5690
5691       --  GENERIC_INSTANTIATION ::=
5692       --    package DEFINING_PROGRAM_UNIT_NAME is
5693       --      new generic_package_NAME [GENERIC_ACTUAL_PART];
5694       --  | [[not] overriding]
5695       --    procedure DEFINING_PROGRAM_UNIT_NAME is
5696       --      new generic_procedure_NAME [GENERIC_ACTUAL_PART];
5697       --  | [[not] overriding]
5698       --    function DEFINING_DESIGNATOR is
5699       --      new generic_function_NAME [GENERIC_ACTUAL_PART];
5700
5701       --  N_Package_Instantiation
5702       --  Sloc points to PACKAGE
5703       --  Defining_Unit_Name (Node1)
5704       --  Name (Node2)
5705       --  Generic_Associations (List3) (set to No_List if no
5706       --   generic actual part)
5707       --  Parent_Spec (Node4-Sem)
5708       --  Instance_Spec (Node5-Sem)
5709       --  ABE_Is_Certain (Flag18-Sem)
5710
5711       --  N_Procedure_Instantiation
5712       --  Sloc points to PROCEDURE
5713       --  Defining_Unit_Name (Node1)
5714       --  Name (Node2)
5715       --  Parent_Spec (Node4-Sem)
5716       --  Generic_Associations (List3) (set to No_List if no
5717       --   generic actual part)
5718       --  Instance_Spec (Node5-Sem)
5719       --  Must_Override (Flag14) set if overriding indicator present
5720       --  Must_Not_Override (Flag15) set if not_overriding indicator present
5721       --  ABE_Is_Certain (Flag18-Sem)
5722
5723       --  N_Function_Instantiation
5724       --  Sloc points to FUNCTION
5725       --  Defining_Unit_Name (Node1)
5726       --  Name (Node2)
5727       --  Generic_Associations (List3) (set to No_List if no
5728       --   generic actual part)
5729       --  Parent_Spec (Node4-Sem)
5730       --  Instance_Spec (Node5-Sem)
5731       --  Must_Override (Flag14) set if overriding indicator present
5732       --  Must_Not_Override (Flag15) set if not_overriding indicator present
5733       --  ABE_Is_Certain (Flag18-Sem)
5734
5735       --  Note: overriding indicator is an Ada 2005 feature
5736
5737       ------------------------------
5738       -- 12.3 Generic Actual Part --
5739       ------------------------------
5740
5741       --  GENERIC_ACTUAL_PART ::=
5742       --    (GENERIC_ASSOCIATION {, GENERIC_ASSOCIATION})
5743
5744       -------------------------------
5745       -- 12.3  Generic Association --
5746       -------------------------------
5747
5748       --  GENERIC_ASSOCIATION ::=
5749       --    [generic_formal_parameter_SELECTOR_NAME =>]
5750
5751       --  Note: unlike the procedure call case, a generic association node
5752       --  is generated for every association, even if no formal is present.
5753       --  In this case the parser will leave the Selector_Name field set
5754       --  to Empty, to be filled in later by the semantic pass.
5755
5756       --  In Ada 2005, a formal may be associated with a box, if the
5757       --  association is part of the list of actuals for a formal package.
5758       --  If the association is given by  OTHERS => <>, the association is
5759       --  an N_Others_Choice.
5760
5761       --  N_Generic_Association
5762       --  Sloc points to first token of generic association
5763       --  Selector_Name (Node2) (set to Empty if no formal
5764       --   parameter selector name)
5765       --  Explicit_Generic_Actual_Parameter (Node1) (Empty if box present)
5766       --  Box_Present (Flag15) (for formal_package associations with a box)
5767
5768       ---------------------------------------------
5769       -- 12.3  Explicit Generic Actual Parameter --
5770       ---------------------------------------------
5771
5772       --  EXPLICIT_GENERIC_ACTUAL_PARAMETER ::=
5773       --    EXPRESSION      | variable_NAME   | subprogram_NAME
5774       --  | entry_NAME      | SUBTYPE_MARK    | package_instance_NAME
5775
5776       -------------------------------------
5777       -- 12.4  Formal Object Declaration --
5778       -------------------------------------
5779
5780       --  FORMAL_OBJECT_DECLARATION ::=
5781       --    DEFINING_IDENTIFIER_LIST :
5782       --      MODE [NULL_EXCLUSION] SUBTYPE_MARK [:= DEFAULT_EXPRESSION];
5783       --  | DEFINING_IDENTIFIER_LIST :
5784       --      MODE ACCESS_DEFINITION [:= DEFAULT_EXPRESSION];
5785
5786       --  Although the syntax allows multiple identifiers in the list, the
5787       --  semantics is as though successive declarations were given with
5788       --  identical type definition and expression components. To simplify
5789       --  semantic processing, the parser represents a multiple declaration
5790       --  case as a sequence of single declarations, using the More_Ids and
5791       --  Prev_Ids flags to preserve the original source form as described
5792       --  in the section on "Handling of Defining Identifier Lists".
5793
5794       --  N_Formal_Object_Declaration
5795       --  Sloc points to first identifier
5796       --  Defining_Identifier (Node1)
5797       --  In_Present (Flag15)
5798       --  Out_Present (Flag17)
5799       --  Null_Exclusion_Present (Flag11) (set to False if not present)
5800       --  Subtype_Mark (Node4) (set to Empty if not present)
5801       --  Access_Definition (Node3) (set to Empty if not present)
5802       --  Default_Expression (Node5) (set to Empty if no default expression)
5803       --  More_Ids (Flag5) (set to False if no more identifiers in list)
5804       --  Prev_Ids (Flag6) (set to False if no previous identifiers in list)
5805
5806       -----------------------------------
5807       -- 12.5  Formal Type Declaration --
5808       -----------------------------------
5809
5810       --  FORMAL_TYPE_DECLARATION ::=
5811       --    type DEFINING_IDENTIFIER [DISCRIMINANT_PART]
5812       --      is FORMAL_TYPE_DEFINITION;
5813
5814       --  N_Formal_Type_Declaration
5815       --  Sloc points to TYPE
5816       --  Defining_Identifier (Node1)
5817       --  Formal_Type_Definition (Node3)
5818       --  Discriminant_Specifications (List4) (set to No_List if no
5819       --   discriminant part)
5820       --  Unknown_Discriminants_Present (Flag13) set if (<>) discriminant
5821
5822       ----------------------------------
5823       -- 12.5  Formal type definition --
5824       ----------------------------------
5825
5826       --  FORMAL_TYPE_DEFINITION ::=
5827       --    FORMAL_PRIVATE_TYPE_DEFINITION
5828       --  | FORMAL_DERIVED_TYPE_DEFINITION
5829       --  | FORMAL_DISCRETE_TYPE_DEFINITION
5830       --  | FORMAL_SIGNED_INTEGER_TYPE_DEFINITION
5831       --  | FORMAL_MODULAR_TYPE_DEFINITION
5832       --  | FORMAL_FLOATING_POINT_DEFINITION
5833       --  | FORMAL_ORDINARY_FIXED_POINT_DEFINITION
5834       --  | FORMAL_DECIMAL_FIXED_POINT_DEFINITION
5835       --  | FORMAL_ARRAY_TYPE_DEFINITION
5836       --  | FORMAL_ACCESS_TYPE_DEFINITION
5837       --  | FORMAL_INTERFACE_TYPE_DEFINITION
5838
5839       ---------------------------------------------
5840       -- 12.5.1  Formal Private Type Definition --
5841       ---------------------------------------------
5842
5843       --  FORMAL_PRIVATE_TYPE_DEFINITION ::=
5844       --    [[abstract] tagged] [limited] private
5845
5846       --  Note: TAGGED is not allowed in Ada 83 mode
5847
5848       --  N_Formal_Private_Type_Definition
5849       --  Sloc points to PRIVATE
5850       --  Abstract_Present (Flag4)
5851       --  Tagged_Present (Flag15)
5852       --  Limited_Present (Flag17)
5853
5854       --------------------------------------------
5855       -- 12.5.1  Formal Derived Type Definition --
5856       --------------------------------------------
5857
5858       --  FORMAL_DERIVED_TYPE_DEFINITION ::=
5859       --    [abstract] [limited | synchronized]
5860       --       new SUBTYPE_MARK [[and INTERFACE_LIST] with private]
5861       --  Note: this construct is not allowed in Ada 83 mode
5862
5863       --  N_Formal_Derived_Type_Definition
5864       --  Sloc points to NEW
5865       --  Subtype_Mark (Node4)
5866       --  Private_Present (Flag15)
5867       --  Abstract_Present (Flag4)
5868       --  Limited_Present (Flag17)
5869       --  Synchronized_Present (Flag7)
5870       --  Interface_List (List2) (set to No_List if none)
5871
5872       ---------------------------------------------
5873       -- 12.5.2  Formal Discrete Type Definition --
5874       ---------------------------------------------
5875
5876       --  FORMAL_DISCRETE_TYPE_DEFINITION ::= (<>)
5877
5878       --  N_Formal_Discrete_Type_Definition
5879       --  Sloc points to (
5880
5881       ---------------------------------------------------
5882       -- 12.5.2  Formal Signed Integer Type Definition --
5883       ---------------------------------------------------
5884
5885       --  FORMAL_SIGNED_INTEGER_TYPE_DEFINITION ::= range <>
5886
5887       --  N_Formal_Signed_Integer_Type_Definition
5888       --  Sloc points to RANGE
5889
5890       --------------------------------------------
5891       -- 12.5.2  Formal Modular Type Definition --
5892       --------------------------------------------
5893
5894       --  FORMAL_MODULAR_TYPE_DEFINITION ::= mod <>
5895
5896       --  N_Formal_Modular_Type_Definition
5897       --  Sloc points to MOD
5898
5899       ----------------------------------------------
5900       -- 12.5.2  Formal Floating Point Definition --
5901       ----------------------------------------------
5902
5903       --  FORMAL_FLOATING_POINT_DEFINITION ::= digits <>
5904
5905       --  N_Formal_Floating_Point_Definition
5906       --  Sloc points to DIGITS
5907
5908       ----------------------------------------------------
5909       -- 12.5.2  Formal Ordinary Fixed Point Definition --
5910       ----------------------------------------------------
5911
5912       --  FORMAL_ORDINARY_FIXED_POINT_DEFINITION ::= delta <>
5913
5914       --  N_Formal_Ordinary_Fixed_Point_Definition
5915       --  Sloc points to DELTA
5916
5917       ---------------------------------------------------
5918       -- 12.5.2  Formal Decimal Fixed Point Definition --
5919       ---------------------------------------------------
5920
5921       --  FORMAL_DECIMAL_FIXED_POINT_DEFINITION ::= delta <> digits <>
5922
5923       --  Note: formal decimal fixed point definition not allowed in Ada 83
5924
5925       --  N_Formal_Decimal_Fixed_Point_Definition
5926       --  Sloc points to DELTA
5927
5928       ------------------------------------------
5929       -- 12.5.3  Formal Array Type Definition --
5930       ------------------------------------------
5931
5932       --  FORMAL_ARRAY_TYPE_DEFINITION ::= ARRAY_TYPE_DEFINITION
5933
5934       -------------------------------------------
5935       -- 12.5.4  Formal Access Type Definition --
5936       -------------------------------------------
5937
5938       --  FORMAL_ACCESS_TYPE_DEFINITION ::= ACCESS_TYPE_DEFINITION
5939
5940       ----------------------------------------------
5941       -- 12.5.5  Formal Interface Type Definition --
5942       ----------------------------------------------
5943
5944       --  FORMAL_INTERFACE_TYPE_DEFINITION ::= INTERFACE_TYPE_DEFINITION
5945
5946       -----------------------------------------
5947       -- 12.6  Formal Subprogram Declaration --
5948       -----------------------------------------
5949
5950       --  FORMAL_SUBPROGRAM_DECLARATION ::=
5951       --    FORMAL_CONCRETE_SUBPROGRAM_DECLARATION
5952       --  | FORMAL_ABSTRACT_SUBPROGRAM_DECLARATION
5953
5954       --------------------------------------------------
5955       -- 12.6  Formal Concrete Subprogram Declaration --
5956       --------------------------------------------------
5957
5958       --  FORMAL_CONCRETE_SUBPROGRAM_DECLARATION ::=
5959       --    with SUBPROGRAM_SPECIFICATION [is SUBPROGRAM_DEFAULT];
5960
5961       --  N_Formal_Concrete_Subprogram_Declaration
5962       --  Sloc points to WITH
5963       --  Specification (Node1)
5964       --  Default_Name (Node2) (set to Empty if no subprogram default)
5965       --  Box_Present (Flag15)
5966
5967       --  Note: if no subprogram default is present, then Name is set
5968       --  to Empty, and Box_Present is False.
5969
5970       --------------------------------------------------
5971       -- 12.6  Formal Abstract Subprogram Declaration --
5972       --------------------------------------------------
5973
5974       --  FORMAL_ABSTRACT_SUBPROGRAM_DECLARATION ::=
5975       --    with SUBPROGRAM_SPECIFICATION is abstract [SUBPROGRAM_DEFAULT];
5976
5977       --  N_Formal_Abstract_Subprogram_Declaration
5978       --  Sloc points to WITH
5979       --  Specification (Node1)
5980       --  Default_Name (Node2) (set to Empty if no subprogram default)
5981       --  Box_Present (Flag15)
5982
5983       --  Note: if no subprogram default is present, then Name is set
5984       --  to Empty, and Box_Present is False.
5985
5986       ------------------------------
5987       -- 12.6  Subprogram Default --
5988       ------------------------------
5989
5990       --  SUBPROGRAM_DEFAULT ::= DEFAULT_NAME | <>
5991
5992       --  There is no separate node in the tree for a subprogram default.
5993       --  Instead the parent (N_Formal_Concrete_Subprogram_Declaration
5994       --  or N_Formal_Abstract_Subprogram_Declaration) node contains the
5995       --  default name or box indication, as needed.
5996
5997       ------------------------
5998       -- 12.6  Default Name --
5999       ------------------------
6000
6001       --  DEFAULT_NAME ::= NAME
6002
6003       --------------------------------------
6004       -- 12.7  Formal Package Declaration --
6005       --------------------------------------
6006
6007       --  FORMAL_PACKAGE_DECLARATION ::=
6008       --    with package DEFINING_IDENTIFIER
6009       --      is new generic_package_NAME FORMAL_PACKAGE_ACTUAL_PART;
6010
6011       --  Note: formal package declarations not allowed in Ada 83 mode
6012
6013       --  N_Formal_Package_Declaration
6014       --  Sloc points to WITH
6015       --  Defining_Identifier (Node1)
6016       --  Name (Node2)
6017       --  Generic_Associations (List3) (set to No_List if (<>) case or
6018       --   empty generic actual part)
6019       --  Box_Present (Flag15)
6020       --  Instance_Spec (Node5-Sem)
6021       --  ABE_Is_Certain (Flag18-Sem)
6022
6023       --------------------------------------
6024       -- 12.7  Formal Package Actual Part --
6025       --------------------------------------
6026
6027       --  FORMAL_PACKAGE_ACTUAL_PART ::=
6028       --    ([OTHERS] => <>)
6029       --    | [GENERIC_ACTUAL_PART]
6030       --    (FORMAL_PACKAGE_ASSOCIATION {. FORMAL_PACKAGE_ASSOCIATION}
6031
6032       --  FORMAL_PACKAGE_ASSOCIATION ::=
6033       --   GENERIC_ASSOCIATION
6034       --  | GENERIC_FORMAL_PARAMETER_SELECTOR_NAME => <>
6035
6036       --  There is no explicit node in the tree for a formal package actual
6037       --  part. Instead the information appears in the parent node (i.e. the
6038       --  formal package declaration node itself).
6039
6040       --  There is no explicit node for a formal package association. All of
6041       --  them are represented either by a generic association, possibly with
6042       --  Box_Present, or by an N_Others_Choice.
6043
6044       ---------------------------------
6045       -- 13.1  Representation clause --
6046       ---------------------------------
6047
6048       --  REPRESENTATION_CLAUSE ::=
6049       --    ATTRIBUTE_DEFINITION_CLAUSE
6050       --  | ENUMERATION_REPRESENTATION_CLAUSE
6051       --  | RECORD_REPRESENTATION_CLAUSE
6052       --  | AT_CLAUSE
6053
6054       ----------------------
6055       -- 13.1  Local Name --
6056       ----------------------
6057
6058       --  LOCAL_NAME :=
6059       --    DIRECT_NAME
6060       --  | DIRECT_NAME'ATTRIBUTE_DESIGNATOR
6061       --  | library_unit_NAME
6062
6063       --  The construct DIRECT_NAME'ATTRIBUTE_DESIGNATOR appears in the tree
6064       --  as an attribute reference, which has essentially the same form.
6065
6066       ---------------------------------------
6067       -- 13.3  Attribute definition clause --
6068       ---------------------------------------
6069
6070       --  ATTRIBUTE_DEFINITION_CLAUSE ::=
6071       --    for LOCAL_NAME'ATTRIBUTE_DESIGNATOR use EXPRESSION;
6072       --  | for LOCAL_NAME'ATTRIBUTE_DESIGNATOR use NAME;
6073
6074       --  In Ada 83, the expression must be a simple expression and the
6075       --  local name must be a direct name.
6076
6077       --  Note: the only attribute definition clause that is processed by
6078       --  gigi is an address clause. For all other cases, the information
6079       --  is extracted by the front end and either results in setting entity
6080       --  information, e.g. Esize for the Size clause, or in appropriate
6081       --  expansion actions (e.g. in the case of Storage_Size).
6082
6083       --  For an address clause, Gigi constructs the appropriate addressing
6084       --  code. It also ensures that no aliasing optimizations are made
6085       --  for the object for which the address clause appears.
6086
6087       --  Note: for an address clause used to achieve an overlay:
6088
6089       --    A : Integer;
6090       --    B : Integer;
6091       --    for B'Address use A'Address;
6092
6093       --  the above rule means that Gigi will ensure that no optimizations
6094       --  will be made for B that would violate the implementation advice
6095       --  of RM 13.3(19). However, this advice applies only to B and not
6096       --  to A, which seems unfortunate. The GNAT front end will mark the
6097       --  object A as volatile to also prevent unwanted optimization
6098       --  assumptions based on no aliasing being made for B.
6099
6100       --  N_Attribute_Definition_Clause
6101       --  Sloc points to FOR
6102       --  Name (Node2) the local name
6103       --  Chars (Name1) the identifier name from the attribute designator
6104       --  Expression (Node3) the expression or name
6105       --  Entity (Node4-Sem)
6106       --  Next_Rep_Item (Node5-Sem)
6107       --  From_At_Mod (Flag4-Sem)
6108       --  Check_Address_Alignment (Flag11-Sem)
6109
6110       ---------------------------------------------
6111       -- 13.4  Enumeration representation clause --
6112       ---------------------------------------------
6113
6114       --  ENUMERATION_REPRESENTATION_CLAUSE ::=
6115       --    for first_subtype_LOCAL_NAME use ENUMERATION_AGGREGATE;
6116
6117       --  In Ada 83, the name must be a direct name
6118
6119       --  N_Enumeration_Representation_Clause
6120       --  Sloc points to FOR
6121       --  Identifier (Node1) direct name
6122       --  Array_Aggregate (Node3)
6123       --  Next_Rep_Item (Node5-Sem)
6124
6125       ---------------------------------
6126       -- 13.4  Enumeration aggregate --
6127       ---------------------------------
6128
6129       --  ENUMERATION_AGGREGATE ::= ARRAY_AGGREGATE
6130
6131       ------------------------------------------
6132       -- 13.5.1  Record representation clause --
6133       ------------------------------------------
6134
6135       --  RECORD_REPRESENTATION_CLAUSE ::=
6136       --    for first_subtype_LOCAL_NAME use
6137       --      record [MOD_CLAUSE]
6138       --        {COMPONENT_CLAUSE}
6139       --      end record;
6140
6141       --  Gigi restriction: Mod_Clause is always Empty (if present it is
6142       --  replaced by a corresponding Alignment attribute definition clause).
6143
6144       --  Note: Component_Clauses can include pragmas
6145
6146       --  N_Record_Representation_Clause
6147       --  Sloc points to FOR
6148       --  Identifier (Node1) direct name
6149       --  Mod_Clause (Node2) (set to Empty if no mod clause present)
6150       --  Component_Clauses (List3)
6151       --  Next_Rep_Item (Node5-Sem)
6152
6153       ------------------------------
6154       -- 13.5.1  Component clause --
6155       ------------------------------
6156
6157       --  COMPONENT_CLAUSE ::=
6158       --    component_LOCAL_NAME at POSITION
6159       --      range FIRST_BIT .. LAST_BIT;
6160
6161       --  N_Component_Clause
6162       --  Sloc points to AT
6163       --  Component_Name (Node1) points to Name or Attribute_Reference
6164       --  Position (Node2)
6165       --  First_Bit (Node3)
6166       --  Last_Bit (Node4)
6167
6168       ----------------------
6169       -- 13.5.1  Position --
6170       ----------------------
6171
6172       --  POSITION ::= static_EXPRESSION
6173
6174       -----------------------
6175       -- 13.5.1  First_Bit --
6176       -----------------------
6177
6178       --  FIRST_BIT ::= static_SIMPLE_EXPRESSION
6179
6180       ----------------------
6181       -- 13.5.1  Last_Bit --
6182       ----------------------
6183
6184       --  LAST_BIT ::= static_SIMPLE_EXPRESSION
6185
6186       --------------------------
6187       -- 13.8  Code statement --
6188       --------------------------
6189
6190       --  CODE_STATEMENT ::= QUALIFIED_EXPRESSION;
6191
6192       --  Note: in GNAT, the qualified expression has the form
6193
6194       --    Asm_Insn'(Asm (...));
6195
6196       --  See package System.Machine_Code in file s-maccod.ads for details on
6197       --  the allowed parameters to Asm. There are two ways this node can
6198       --  arise, as a code statement, in which case the expression is the
6199       --  qualified expression, or as a result of the expansion of an intrinsic
6200       --  call to the Asm or Asm_Input procedure.
6201
6202       --  N_Code_Statement
6203       --  Sloc points to first token of the expression
6204       --  Expression (Node3)
6205
6206       --  Note: package Exp_Code contains an abstract functional interface
6207       --  for use by Gigi in accessing the data from N_Code_Statement nodes.
6208
6209       ------------------------
6210       -- 13.12  Restriction --
6211       ------------------------
6212
6213       --  RESTRICTION ::=
6214       --    restriction_IDENTIFIER
6215       --  | restriction_parameter_IDENTIFIER => EXPRESSION
6216
6217       --  There is no explicit node for restrictions. Instead the restriction
6218       --  appears in normal pragma syntax as a pragma argument association,
6219       --  which has the same syntactic form.
6220
6221       --------------------------
6222       -- B.2  Shift Operators --
6223       --------------------------
6224
6225       --  Calls to the intrinsic shift functions are converted to one of
6226       --  the following shift nodes, which have the form of normal binary
6227       --  operator names. Note that for a given shift operation, one node
6228       --  covers all possible types, as for normal operators.
6229
6230       --  Note: it is perfectly permissible for the expander to generate
6231       --  shift operation nodes directly, in which case they will be analyzed
6232       --  and parsed in the usual manner.
6233
6234       --  Sprint syntax: shift-function-name!(expr, count)
6235
6236       --  Note: the Left_Opnd field holds the first argument (the value to
6237       --  be shifted). The Right_Opnd field holds the second argument (the
6238       --  shift count). The Chars field is the name of the intrinsic function.
6239
6240       --  N_Op_Rotate_Left
6241       --  Sloc points to the function name
6242       --  plus fields for binary operator
6243       --  plus fields for expression
6244       --  Shift_Count_OK (Flag4-Sem)
6245
6246       --  N_Op_Rotate_Right
6247       --  Sloc points to the function name
6248       --  plus fields for binary operator
6249       --  plus fields for expression
6250       --  Shift_Count_OK (Flag4-Sem)
6251
6252       --  N_Op_Shift_Left
6253       --  Sloc points to the function name
6254       --  plus fields for binary operator
6255       --  plus fields for expression
6256       --  Shift_Count_OK (Flag4-Sem)
6257
6258       --  N_Op_Shift_Right_Arithmetic
6259       --  Sloc points to the function name
6260       --  plus fields for binary operator
6261       --  plus fields for expression
6262       --  Shift_Count_OK (Flag4-Sem)
6263
6264       --  N_Op_Shift_Right
6265       --  Sloc points to the function name
6266       --  plus fields for binary operator
6267       --  plus fields for expression
6268       --  Shift_Count_OK (Flag4-Sem)
6269
6270    --------------------------
6271    -- Obsolescent Features --
6272    --------------------------
6273
6274       --  The syntax descriptions and tree nodes for obsolescent features are
6275       --  grouped together, corresponding to their location in appendix I in
6276       --  the RM. However, parsing and semantic analysis for these constructs
6277       --  is located in an appropriate chapter (see individual notes).
6278
6279       ---------------------------
6280       -- J.3  Delta Constraint --
6281       ---------------------------
6282
6283       --  Note: the parse routine for this construct is located in section
6284       --  3.5.9 of Par-Ch3, and semantic analysis is in Sem_Ch3, which is
6285       --  where delta constraint logically belongs.
6286
6287       --  DELTA_CONSTRAINT ::= DELTA static_EXPRESSION [RANGE_CONSTRAINT]
6288
6289       --  N_Delta_Constraint
6290       --  Sloc points to DELTA
6291       --  Delta_Expression (Node3)
6292       --  Range_Constraint (Node4) (set to Empty if not present)
6293
6294       --------------------
6295       -- J.7  At Clause --
6296       --------------------
6297
6298       --  AT_CLAUSE ::= for DIRECT_NAME use at EXPRESSION;
6299
6300       --  Note: the parse routine for this construct is located in Par-Ch13,
6301       --  and the semantic analysis is in Sem_Ch13, where at clause logically
6302       --  belongs if it were not obsolescent.
6303
6304       --  Note: in Ada 83 the expression must be a simple expression
6305
6306       --  Gigi restriction: This node never appears, it is rewritten as an
6307       --  address attribute definition clause.
6308
6309       --  N_At_Clause
6310       --  Sloc points to FOR
6311       --  Identifier (Node1)
6312       --  Expression (Node3)
6313
6314       ---------------------
6315       -- J.8  Mod clause --
6316       ---------------------
6317
6318       --  MOD_CLAUSE ::= at mod static_EXPRESSION;
6319
6320       --  Note: the parse routine for this construct is located in Par-Ch13,
6321       --  and the semantic analysis is in Sem_Ch13, where mod clause logically
6322       --  belongs if it were not obsolescent.
6323
6324       --  Note: in Ada 83, the expression must be a simple expression
6325
6326       --  Gigi restriction: this node never appears. It is replaced
6327       --  by a corresponding Alignment attribute definition clause.
6328
6329       --  Note: pragmas can appear before and after the MOD_CLAUSE since
6330       --  its name has "clause" in it. This is rather strange, but is quite
6331       --  definitely specified. The pragmas before are collected in the
6332       --  Pragmas_Before field of the mod clause node itself, and pragmas
6333       --  after are simply swallowed up in the list of component clauses.
6334
6335       --  N_Mod_Clause
6336       --  Sloc points to AT
6337       --  Expression (Node3)
6338       --  Pragmas_Before (List4) Pragmas before mod clause (No_List if none)
6339
6340    --------------------
6341    -- Semantic Nodes --
6342    --------------------
6343
6344    --  These semantic nodes are used to hold additional semantic information.
6345    --  They are inserted into the tree as a result of semantic processing.
6346    --  Although there are no legitimate source syntax constructions that
6347    --  correspond directly to these nodes, we need a source syntax for the
6348    --  reconstructed tree printed by Sprint, and the node descriptions here
6349    --  show this syntax.
6350
6351       ----------------------------
6352       -- Conditional Expression --
6353       ----------------------------
6354
6355       --  This node is used to represent an expression corresponding to the
6356       --  C construct (condition ? then-expression : else_expression), where
6357       --  Expressions is a three element list, whose first expression is the
6358       --  condition, and whose second and third expressions are the then and
6359       --  else expressions respectively.
6360
6361       --  Note: the Then_Actions and Else_Actions fields are always set to
6362       --  No_List in the tree passed to Gigi. These fields are used only
6363       --  for temporary processing purposes in the expander.
6364
6365       --  Sprint syntax: (if expr then expr else expr)
6366
6367       --  N_Conditional_Expression
6368       --  Sloc points to related node
6369       --  Expressions (List1)
6370       --  Then_Actions (List2-Sem)
6371       --  Else_Actions (List3-Sem)
6372       --  plus fields for expression
6373
6374       --  Note: in the case where a debug source file is generated, the Sloc
6375       --  for this node points to the IF keyword in the Sprint file output.
6376
6377       -------------------
6378       -- Expanded_Name --
6379       -------------------
6380
6381       --  The N_Expanded_Name node is used to represent a selected component
6382       --  name that has been resolved to an expanded name. The semantic phase
6383       --  replaces N_Selected_Component nodes that represent names by the use
6384       --  of this node, leaving the N_Selected_Component node used only when
6385       --  the prefix is a record or protected type.
6386
6387       --  The fields of the N_Expanded_Name node are layed out identically
6388       --  to those of the N_Selected_Component node, allowing conversion of
6389       --  an expanded name node to a selected component node to be done
6390       --  easily, see Sinfo.CN.Change_Selected_Component_To_Expanded_Name.
6391
6392       --  There is no special sprint syntax for an expanded name
6393
6394       --  N_Expanded_Name
6395       --  Sloc points to the period
6396       --  Chars (Name1) copy of Chars field of selector name
6397       --  Prefix (Node3)
6398       --  Selector_Name (Node2)
6399       --  Entity (Node4-Sem)
6400       --  Associated_Node (Node4-Sem)
6401       --  Redundant_Use (Flag13-Sem)
6402       --  Has_Private_View (Flag11-Sem) set in generic units.
6403       --  plus fields for expression
6404
6405       --------------------
6406       -- Free Statement --
6407       --------------------
6408
6409       --  The N_Free_Statement node is generated as a result of a call to an
6410       --  instantiation of Unchecked_Deallocation. The instantiation of this
6411       --  generic is handled specially and generates this node directly.
6412
6413       --  Sprint syntax: free expression
6414
6415       --  N_Free_Statement
6416       --  Sloc is copied from the unchecked deallocation call
6417       --  Expression (Node3) argument to unchecked deallocation call
6418       --  Storage_Pool (Node1-Sem)
6419       --  Procedure_To_Call (Node2-Sem)
6420       --  Actual_Designated_Subtype (Node4-Sem)
6421
6422       --  Note: in the case where a debug source file is generated, the Sloc
6423       --  for this node points to the FREE keyword in the Sprint file output.
6424
6425       -------------------
6426       -- Freeze Entity --
6427       -------------------
6428
6429       --  This node marks the point in a declarative part at which an entity
6430       --  declared therein becomes frozen. The expander places initialization
6431       --  procedures for types at those points. Gigi uses the freezing point
6432       --  to elaborate entities that may depend on previous private types.
6433
6434       --  See the section in Einfo "Delayed Freezing and Elaboration" for
6435       --  a full description of the use of this node.
6436
6437       --  The Entity field points back to the entity for the type (whose
6438       --  Freeze_Node field points back to this freeze node).
6439
6440       --  The Actions field contains a list of declarations and statements
6441       --  generated by the expander which are associated with the freeze
6442       --  node, and are elaborated as though the freeze node were replaced
6443       --  by this sequence of actions.
6444
6445       --  Note: the Sloc field in the freeze node references a construct
6446       --  associated with the freezing point. This is used for posting
6447       --  messages in some error/warning situations, e.g. the case where
6448       --  a primitive operation of a tagged type is declared too late.
6449
6450       --  Sprint syntax: freeze entity-name [
6451       --                   freeze actions
6452       --                 ]
6453
6454       --  N_Freeze_Entity
6455       --  Sloc points near freeze point (see above special note)
6456       --  Entity (Node4-Sem)
6457       --  Access_Types_To_Process (Elist2-Sem) (set to No_Elist if none)
6458       --  TSS_Elist (Elist3-Sem) (set to No_Elist if no associated TSS's)
6459       --  Actions (List1) (set to No_List if no freeze actions)
6460       --  First_Subtype_Link (Node5-Sem) (set to Empty if no link)
6461
6462       --  The Actions field holds actions associated with the freeze. These
6463       --  actions are elaborated at the point where the type is frozen.
6464
6465       --  Note: in the case where a debug source file is generated, the Sloc
6466       --  for this node points to the FREEZE keyword in the Sprint file output.
6467
6468       --------------------------------
6469       -- Implicit Label Declaration --
6470       --------------------------------
6471
6472       --  An implicit label declaration is created for every occurrence of a
6473       --  label on a statement or a label on a block or loop. It is chained
6474       --  in the declarations of the innermost enclosing block as specified
6475       --  in RM section 5.1 (3).
6476
6477       --  The Defining_Identifier is the actual identifier for the
6478       --  statement identifier. Note that the occurrence of the label
6479       --  is a reference, NOT the defining occurrence. The defining
6480       --  occurrence occurs at the head of the innermost enclosing
6481       --  block, and is represented by this node.
6482
6483       --  Note: from the grammar, this might better be called an implicit
6484       --  statement identifier declaration, but the term we choose seems
6485       --  friendlier, since at least informally statement identifiers are
6486       --  called labels in both cases (i.e. when used in labels, and when
6487       --  used as the identifiers of blocks and loops).
6488
6489       --  Note: although this is logically a semantic node, since it does
6490       --  not correspond directly to a source syntax construction, these
6491       --  nodes are actually created by the parser in a post pass done just
6492       --  after parsing is complete, before semantic analysis is started (see
6493       --  the Par.Labl subunit in file par-labl.adb).
6494
6495       --  Sprint syntax: labelname : label;
6496
6497       --  N_Implicit_Label_Declaration
6498       --  Sloc points to the << of the label
6499       --  Defining_Identifier (Node1)
6500       --  Label_Construct (Node2-Sem)
6501
6502       --  Note: in the case where a debug source file is generated, the Sloc
6503       --  for this node points to the label name in the generated declaration.
6504
6505       ---------------------
6506       -- Itype_Reference --
6507       ---------------------
6508
6509       --  This node is used to create a reference to an Itype. The only
6510       --  purpose is to make sure that the Itype is defined if this is the
6511       --  first reference.
6512
6513       --  A typical use of this node is when an Itype is to be referenced in
6514       --  two branches of an if statement. In this case it is important that
6515       --  the first use of the Itype not be inside the conditional, since
6516       --  then it might not be defined if the wrong branch of the if is
6517       --  taken in the case where the definition generates elaboration code.
6518
6519       --  The Itype field points to the referenced Itype
6520
6521       --  sprint syntax: reference itype-name
6522
6523       --  N_Itype_Reference
6524       --  Sloc points to the node generating the reference
6525       --  Itype (Node1-Sem)
6526
6527       --  Note: in the case where a debug source file is generated, the Sloc
6528       --  for this node points to the REFERENCE keyword in the file output.
6529
6530       ---------------------
6531       -- Raise_xxx_Error --
6532       ---------------------
6533
6534       --  One of these nodes is created during semantic analysis to replace
6535       --  a node for an expression that is determined to definitely raise
6536       --  the corresponding exception.
6537
6538       --  The N_Raise_xxx_Error node may also stand alone in place
6539       --  of a declaration or statement, in which case it simply causes
6540       --  the exception to be raised (i.e. it is equivalent to a raise
6541       --  statement that raises the corresponding exception). This use
6542       --  is distinguished by the fact that the Etype in this case is
6543       --  Standard_Void_Type, In the subexprssion case, the Etype is the
6544       --  same as the type of the subexpression which it replaces.
6545
6546       --  If Condition is empty, then the raise is unconditional. If the
6547       --  Condition field is non-empty, it is a boolean expression which
6548       --  is first evaluated, and the exception is raised only if the
6549       --  value of the expression is True. In the unconditional case, the
6550       --  creation of this node is usually accompanied by a warning message
6551       --  error. The creation of this node will usually be accompanied by a
6552       --  message (unless it appears within the right operand of a short
6553       --  circuit form whose left argument is static and decisively
6554       --  eliminates elaboration of the raise operation. The condition field
6555       --  can ONLY be present when the node is used as a statement form, it
6556       --  may NOT be present in the case where the node appears within an
6557       --  expression.
6558
6559       --  The exception is generated with a message that contains the
6560       --  file name and line number, and then appended text. The Reason
6561       --  code shows the text to be added. The Reason code is an element
6562       --  of the type Types.RT_Exception_Code, and indicates both the
6563       --  message to be added, and the exception to be raised (which must
6564       --  match the node type). The value is stored by storing a Uint which
6565       --  is the Pos value of the enumeration element in this type.
6566
6567       --  Gigi restriction: This expander ensures that the type of the
6568       --  Condition field is always Standard.Boolean, even if the type
6569       --  in the source is some non-standard boolean type.
6570
6571       --  Sprint syntax: [xxx_error "msg"]
6572       --             or: [xxx_error when condition "msg"]
6573
6574       --  N_Raise_Constraint_Error
6575       --  Sloc references related construct
6576       --  Condition (Node1) (set to Empty if no condition)
6577       --  Reason (Uint3)
6578       --  plus fields for expression
6579
6580       --  N_Raise_Program_Error
6581       --  Sloc references related construct
6582       --  Condition (Node1) (set to Empty if no condition)
6583       --  Reason (Uint3)
6584       --  plus fields for expression
6585
6586       --  N_Raise_Storage_Error
6587       --  Sloc references related construct
6588       --  Condition (Node1) (set to Empty if no condition)
6589       --  Reason (Uint3)
6590       --  plus fields for expression
6591
6592       --  Note: Sloc is copied from the expression generating the exception.
6593       --  In the case where a debug source file is generated, the Sloc for
6594       --  this node points to the left bracket in the Sprint file output.
6595
6596       --  Note: the back end may be required to translate these nodes into
6597       --  appropriate goto statements. See description of N_Push/Pop_xxx_Label.
6598
6599       ---------------------------------------------
6600       -- Optimization of Exception Raise to Goto --
6601       ---------------------------------------------
6602
6603       --  In some cases, the front end will determine that any exception raised
6604       --  by the back end for a certain exception should be transformed into a
6605       --  goto statement.
6606
6607       --  There are three kinds of exceptions raised by the back end (note that
6608       --  for this purpose we consider gigi to be part of the back end in the
6609       --  gcc case):
6610
6611       --     1. Exceptions resulting from N_Raise_xxx_Error nodes
6612       --     2. Exceptions from checks triggered by Do_xxx_Check flags
6613       --     3. Other cases not specifically marked by the front end
6614
6615       --  Normally all such exceptions are translated into calls to the proper
6616       --  Rcheck_xx procedure, where xx encodes both the exception to be raised
6617       --  and the exception message.
6618
6619       --  The front end may determine that for a particular sequence of code,
6620       --  exceptions in any of these three categories for a particular builtin
6621       --  exception should result in a goto, rather than a call to Rcheck_xx.
6622       --  The exact sequence to be generated is:
6623
6624       --      Local_Raise (exception'Identity);
6625       --      goto Label
6626
6627       --  The front end marks such a sequence of code by bracketing it with
6628       --  push and pop nodes:
6629
6630       --       N_Push_xxx_Label (referencing the label)
6631       --       ...
6632       --       (code where transformation is expected for exception xxx)
6633       --       ...
6634       --       N_Pop_xxx_Label
6635
6636       --  The use of push/pop reflects the fact that such regions can properly
6637       --  nest, and one special case is a subregion in which no transformation
6638       --  is allowed. Such a region is marked by a N_Push_xxx_Label node whose
6639       --  Exception_Label field is Empty.
6640
6641       --  N_Push_Constraint_Error_Label
6642       --  Sloc references first statement in region covered
6643       --  Exception_Label (Node5-Sem)
6644
6645       --  N_Push_Program_Error_Label
6646       --  Sloc references first statement in region covered
6647       --  Exception_Label (Node5-Sem)
6648
6649       --  N_Push_Storage_Error_Label
6650       --  Sloc references first statement in region covered
6651       --  Exception_Label (Node5-Sem)
6652
6653       --  N_Pop_Constraint_Error_Label
6654       --  Sloc references last statement in region covered
6655
6656       --  N_Pop_Program_Error_Label
6657       --  Sloc references last statement in region covered
6658
6659       --  N_Pop_Storage_Error_Label
6660       --  Sloc references last statement in region covered
6661
6662       ---------------
6663       -- Reference --
6664       ---------------
6665
6666       --  For a number of purposes, we need to construct references to objects.
6667       --  These references are subsequently treated as normal access values.
6668       --  An example is the construction of the parameter block passed to a
6669       --  task entry. The N_Reference node is provided for this purpose. It is
6670       --  similar in effect to the use of the Unrestricted_Access attribute,
6671       --  and like Unrestricted_Access can be applied to objects which would
6672       --  not be valid prefixes for the Unchecked_Access attribute (e.g.
6673       --  objects which are not aliased, and slices). In addition it can be
6674       --  applied to composite type values as well as objects, including string
6675       --  values and aggregates.
6676
6677       --  Note: we use the Prefix field for this expression so that the
6678       --  resulting node can be treated using common code with the attribute
6679       --  nodes for the 'Access and related attributes. Logically it would make
6680       --  more sense to call it an Expression field, but then we would have to
6681       --  special case the treatment of the N_Reference node.
6682
6683       --  Sprint syntax: prefix'reference
6684
6685       --  N_Reference
6686       --  Sloc is copied from the expression
6687       --  Prefix (Node3)
6688       --  plus fields for expression
6689
6690       --  Note: in the case where a debug source file is generated, the Sloc
6691       --  for this node points to the quote in the Sprint file output.
6692
6693       ---------------------
6694       -- Subprogram_Info --
6695       ---------------------
6696
6697       --  This node generates the appropriate Subprogram_Info value for a
6698       --  given procedure. See Ada.Exceptions for further details
6699
6700       --  Sprint syntax: subprog'subprogram_info
6701
6702       --  N_Subprogram_Info
6703       --  Sloc points to the entity for the procedure
6704       --  Identifier (Node1) identifier referencing the procedure
6705       --  Etype (Node5-Sem) type (always set to Ada.Exceptions.Code_Loc
6706
6707       --  Note: in the case where a debug source file is generated, the Sloc
6708       --  for this node points to the quote in the Sprint file output.
6709
6710       --------------------------
6711       -- Unchecked Expression --
6712       --------------------------
6713
6714       --  An unchecked expression is one that must be analyzed and resolved
6715       --  with all checks off, regardless of the current setting of scope
6716       --  suppress flags.
6717
6718       --  Sprint syntax: `(expression)
6719
6720       --  Note: this node is always removed from the tree (and replaced by
6721       --  its constituent expression) on completion of analysis, so it only
6722       --  appears in intermediate trees, and will never be seen by Gigi.
6723
6724       --  N_Unchecked_Expression
6725       --  Sloc is a copy of the Sloc of the expression
6726       --  Expression (Node3)
6727       --  plus fields for expression
6728
6729       --  Note: in the case where a debug source file is generated, the Sloc
6730       --  for this node points to the back quote in the Sprint file output.
6731
6732       -------------------------------
6733       -- Unchecked Type Conversion --
6734       -------------------------------
6735
6736       --  An unchecked type conversion node represents the semantic action
6737       --  corresponding to a call to an instantiation of Unchecked_Conversion.
6738       --  It is generated as a result of actual use of Unchecked_Conversion
6739       --  and also the expander generates unchecked type conversion nodes
6740       --  directly for expansion of complex semantic actions.
6741
6742       --  Note: an unchecked type conversion is a variable as far as the
6743       --  semantics are concerned, which is convenient for the expander.
6744       --  This does not change what Ada source programs are legal, since
6745       --  clearly a function call to an instantiation of Unchecked_Conversion
6746       --  is not a variable in any case.
6747
6748       --  Sprint syntax: subtype-mark!(expression)
6749
6750       --  N_Unchecked_Type_Conversion
6751       --  Sloc points to related node in source
6752       --  Subtype_Mark (Node4)
6753       --  Expression (Node3)
6754       --  Kill_Range_Check (Flag11-Sem)
6755       --  No_Truncation (Flag17-Sem)
6756       --  plus fields for expression
6757
6758       --  Note: in the case where a debug source file is generated, the Sloc
6759       --  for this node points to the exclamation in the Sprint file output.
6760
6761       -----------------------------------
6762       -- Validate_Unchecked_Conversion --
6763       -----------------------------------
6764
6765       --  The front end does most of the validation of unchecked conversion,
6766       --  including checking sizes (this is done after the back end is called
6767       --  to take advantage of back-annotation of calculated sizes).
6768
6769       --  The front end also deals with specific cases that are not allowed
6770       --  e.g. involving unconstrained array types.
6771
6772       --  For the case of the standard gigi backend, this means that all
6773       --  checks are done in the front-end.
6774
6775       --  However, in the case of specialized back-ends, notably the JVM
6776       --  backend for JGNAT, additional requirements and restrictions apply
6777       --  to unchecked conversion, and these are most conveniently performed
6778       --  in the specialized back-end.
6779
6780       --  To accommodate this requirement, for such back ends, the following
6781       --  special node is generated recording an unchecked conversion that
6782       --  needs to be validated. The back end should post an appropriate
6783       --  error message if the unchecked conversion is invalid or warrants
6784       --  a special warning message.
6785
6786       --  Source_Type and Target_Type point to the entities for the two
6787       --  types involved in the unchecked conversion instantiation that
6788       --  is to be validated.
6789
6790       --  Sprint syntax: validate Unchecked_Conversion (source, target);
6791
6792       --  N_Validate_Unchecked_Conversion
6793       --  Sloc points to instantiation (location for warning message)
6794       --  Source_Type (Node1-Sem)
6795       --  Target_Type (Node2-Sem)
6796
6797       --  Note: in the case where a debug source file is generated, the Sloc
6798       --  for this node points to the VALIDATE keyword in the file output.
6799
6800    -----------
6801    -- Empty --
6802    -----------
6803
6804    --  Used as the contents of the Nkind field of the dummy Empty node
6805    --  and in some other situations to indicate an uninitialized value.
6806
6807    --  N_Empty
6808    --  Chars (Name1) is set to No_Name
6809
6810    -----------
6811    -- Error --
6812    -----------
6813
6814    --  Used as the contents of the Nkind field of the dummy Error node.
6815    --  Has an Etype field, which gets set to Any_Type later on, to help
6816    --  error recovery (Error_Posted is also set in the Error node).
6817
6818    --  N_Error
6819    --  Chars (Name1) is set to Error_Name
6820    --  Etype (Node5-Sem)
6821
6822    --------------------------
6823    -- Node Type Definition --
6824    --------------------------
6825
6826    --  The following is the definition of the Node_Kind type. As previously
6827    --  discussed, this is separated off to allow rearrangement of the order
6828    --  to facilitiate definition of subtype ranges. The comments show the
6829    --  subtype classes which apply to each set of node kinds. The first
6830    --  entry in the comment characterizes the following list of nodes.
6831
6832    type Node_Kind is (
6833       N_Unused_At_Start,
6834
6835       --  N_Representation_Clause
6836
6837       N_At_Clause,
6838       N_Component_Clause,
6839       N_Enumeration_Representation_Clause,
6840       N_Mod_Clause,
6841       N_Record_Representation_Clause,
6842
6843       --  N_Representation_Clause, N_Has_Chars
6844
6845       N_Attribute_Definition_Clause,
6846
6847       --  N_Has_Chars
6848
6849       N_Empty,
6850       N_Pragma,
6851       N_Pragma_Argument_Association,
6852
6853       --  N_Has_Etype
6854
6855       N_Error,
6856
6857       --  N_Entity, N_Has_Etype, N_Has_Chars
6858
6859       N_Defining_Character_Literal,
6860       N_Defining_Identifier,
6861       N_Defining_Operator_Symbol,
6862
6863       --  N_Subexpr, N_Has_Etype, N_Has_Chars, N_Has_Entity
6864
6865       N_Expanded_Name,
6866
6867       --  N_Direct_Name, N_Subexpr, N_Has_Etype,
6868       --  N_Has_Chars, N_Has_Entity
6869
6870       N_Identifier,
6871       N_Operator_Symbol,
6872
6873       --  N_Direct_Name, N_Subexpr, N_Has_Etype,
6874       --  N_Has_Chars, N_Has_Entity
6875
6876       N_Character_Literal,
6877
6878       --  N_Binary_Op, N_Op, N_Subexpr,
6879       --  N_Has_Etype, N_Has_Chars, N_Has_Entity
6880
6881       N_Op_Add,
6882       N_Op_Concat,
6883       N_Op_Expon,
6884       N_Op_Subtract,
6885
6886       --  N_Binary_Op, N_Op, N_Subexpr, N_Has_Treat_Fixed_As_Integer
6887       --  N_Has_Etype, N_Has_Chars, N_Has_Entity, N_Multiplying_Operator
6888
6889       N_Op_Divide,
6890       N_Op_Mod,
6891       N_Op_Multiply,
6892       N_Op_Rem,
6893
6894       --  N_Binary_Op, N_Op, N_Subexpr, N_Has_Etype
6895       --  N_Has_Entity, N_Has_Chars, N_Op_Boolean
6896
6897       N_Op_And,
6898
6899       --  N_Binary_Op, N_Op, N_Subexpr, N_Has_Etype
6900       --  N_Has_Entity, N_Has_Chars, N_Op_Boolean, N_Op_Compare
6901
6902       N_Op_Eq,
6903       N_Op_Ge,
6904       N_Op_Gt,
6905       N_Op_Le,
6906       N_Op_Lt,
6907       N_Op_Ne,
6908
6909       --  N_Binary_Op, N_Op, N_Subexpr, N_Has_Etype
6910       --  N_Has_Entity, N_Has_Chars, N_Op_Boolean
6911
6912       N_Op_Or,
6913       N_Op_Xor,
6914
6915       --  N_Binary_Op, N_Op, N_Subexpr, N_Has_Etype,
6916       --  N_Op_Shift, N_Has_Chars, N_Has_Entity
6917
6918       N_Op_Rotate_Left,
6919       N_Op_Rotate_Right,
6920       N_Op_Shift_Left,
6921       N_Op_Shift_Right,
6922       N_Op_Shift_Right_Arithmetic,
6923
6924       --  N_Unary_Op, N_Op, N_Subexpr, N_Has_Etype,
6925       --  N_Has_Chars, N_Has_Entity
6926
6927       N_Op_Abs,
6928       N_Op_Minus,
6929       N_Op_Not,
6930       N_Op_Plus,
6931
6932       --  N_Subexpr, N_Has_Etype, N_Has_Entity
6933
6934       N_Attribute_Reference,
6935
6936       --  N_Subexpr, N_Has_Etype, N_Membership_Test
6937
6938       N_In,
6939       N_Not_In,
6940
6941       --  N_Subexpr, N_Has_Etype
6942
6943       N_And_Then,
6944       N_Conditional_Expression,
6945       N_Explicit_Dereference,
6946       N_Function_Call,
6947
6948       N_Indexed_Component,
6949       N_Integer_Literal,
6950
6951       N_Null,
6952       N_Or_Else,
6953       N_Procedure_Call_Statement,
6954       N_Qualified_Expression,
6955
6956       --  N_Raise_xxx_Error, N_Subexpr, N_Has_Etype
6957
6958       N_Raise_Constraint_Error,
6959       N_Raise_Program_Error,
6960       N_Raise_Storage_Error,
6961
6962       --  N_Subexpr, N_Has_Etype
6963
6964       N_Aggregate,
6965       N_Allocator,
6966       N_Extension_Aggregate,
6967       N_Range,
6968       N_Real_Literal,
6969       N_Reference,
6970       N_Selected_Component,
6971       N_Slice,
6972       N_String_Literal,
6973       N_Subprogram_Info,
6974       N_Type_Conversion,
6975       N_Unchecked_Expression,
6976       N_Unchecked_Type_Conversion,
6977
6978       --  N_Has_Etype
6979
6980       N_Subtype_Indication,
6981
6982       --  N_Declaration
6983
6984       N_Component_Declaration,
6985       N_Entry_Declaration,
6986       N_Formal_Object_Declaration,
6987       N_Formal_Type_Declaration,
6988       N_Full_Type_Declaration,
6989       N_Incomplete_Type_Declaration,
6990       N_Loop_Parameter_Specification,
6991       N_Object_Declaration,
6992       N_Protected_Type_Declaration,
6993       N_Private_Extension_Declaration,
6994       N_Private_Type_Declaration,
6995       N_Subtype_Declaration,
6996
6997       --  N_Subprogram_Specification, N_Declaration
6998
6999       N_Function_Specification,
7000       N_Procedure_Specification,
7001
7002       --  N_Access_To_Subprogram_Definition
7003
7004       N_Access_Function_Definition,
7005       N_Access_Procedure_Definition,
7006
7007       --  N_Later_Decl_Item
7008
7009       N_Task_Type_Declaration,
7010
7011       --  N_Body_Stub, N_Later_Decl_Item
7012
7013       N_Package_Body_Stub,
7014       N_Protected_Body_Stub,
7015       N_Subprogram_Body_Stub,
7016       N_Task_Body_Stub,
7017
7018       --  N_Generic_Instantiation, N_Later_Decl_Item
7019       --  N_Subprogram_Instantiation
7020
7021       N_Function_Instantiation,
7022       N_Procedure_Instantiation,
7023
7024       --  N_Generic_Instantiation, N_Later_Decl_Item
7025
7026       N_Package_Instantiation,
7027
7028       --  N_Unit_Body, N_Later_Decl_Item, N_Proper_Body
7029
7030       N_Package_Body,
7031       N_Subprogram_Body,
7032
7033       --  N_Later_Decl_Item, N_Proper_Body
7034
7035       N_Protected_Body,
7036       N_Task_Body,
7037
7038       --  N_Later_Decl_Item
7039
7040       N_Implicit_Label_Declaration,
7041       N_Package_Declaration,
7042       N_Single_Task_Declaration,
7043       N_Subprogram_Declaration,
7044       N_Use_Package_Clause,
7045
7046       --  N_Generic_Declaration, N_Later_Decl_Item
7047
7048       N_Generic_Package_Declaration,
7049       N_Generic_Subprogram_Declaration,
7050
7051       --  N_Array_Type_Definition
7052
7053       N_Constrained_Array_Definition,
7054       N_Unconstrained_Array_Definition,
7055
7056       --  N_Renaming_Declaration
7057
7058       N_Exception_Renaming_Declaration,
7059       N_Object_Renaming_Declaration,
7060       N_Package_Renaming_Declaration,
7061       N_Subprogram_Renaming_Declaration,
7062
7063       --  N_Generic_Renaming_Declaration, N_Renaming_Declaration
7064
7065       N_Generic_Function_Renaming_Declaration,
7066       N_Generic_Package_Renaming_Declaration,
7067       N_Generic_Procedure_Renaming_Declaration,
7068
7069       --  N_Statement_Other_Than_Procedure_Call
7070
7071       N_Abort_Statement,
7072       N_Accept_Statement,
7073       N_Assignment_Statement,
7074       N_Asynchronous_Select,
7075       N_Block_Statement,
7076       N_Case_Statement,
7077       N_Code_Statement,
7078       N_Conditional_Entry_Call,
7079
7080       --  N_Statement_Other_Than_Procedure_Call. N_Delay_Statement
7081
7082       N_Delay_Relative_Statement,
7083       N_Delay_Until_Statement,
7084
7085       --  N_Statement_Other_Than_Procedure_Call
7086
7087       N_Entry_Call_Statement,
7088       N_Free_Statement,
7089       N_Goto_Statement,
7090       N_Loop_Statement,
7091       N_Null_Statement,
7092       N_Raise_Statement,
7093       N_Requeue_Statement,
7094       N_Return_Statement,
7095       N_Extended_Return_Statement,
7096       N_Selective_Accept,
7097       N_Timed_Entry_Call,
7098
7099       --  N_Statement_Other_Than_Procedure_Call, N_Has_Condition
7100
7101       N_Exit_Statement,
7102       N_If_Statement,
7103
7104       --  N_Has_Condition
7105
7106       N_Accept_Alternative,
7107       N_Delay_Alternative,
7108       N_Elsif_Part,
7109       N_Entry_Body_Formal_Part,
7110       N_Iteration_Scheme,
7111       N_Terminate_Alternative,
7112
7113       --  N_Formal_Subprogram_Declaration
7114
7115       N_Formal_Abstract_Subprogram_Declaration,
7116       N_Formal_Concrete_Subprogram_Declaration,
7117
7118       --  N_Push_xxx_Label, N_Push_Pop_xxx_Label
7119
7120       N_Push_Constraint_Error_Label,
7121       N_Push_Program_Error_Label,
7122       N_Push_Storage_Error_Label,
7123
7124       --  N_Pop_xxx_Label, N_Push_Pop_xxx_Label
7125
7126       N_Pop_Constraint_Error_Label,
7127       N_Pop_Program_Error_Label,
7128       N_Pop_Storage_Error_Label,
7129
7130       --  Other nodes (not part of any subtype class)
7131
7132       N_Abortable_Part,
7133       N_Abstract_Subprogram_Declaration,
7134       N_Access_Definition,
7135       N_Access_To_Object_Definition,
7136       N_Case_Statement_Alternative,
7137       N_Compilation_Unit,
7138       N_Compilation_Unit_Aux,
7139       N_Component_Association,
7140       N_Component_Definition,
7141       N_Component_List,
7142       N_Derived_Type_Definition,
7143       N_Decimal_Fixed_Point_Definition,
7144       N_Defining_Program_Unit_Name,
7145       N_Delta_Constraint,
7146       N_Designator,
7147       N_Digits_Constraint,
7148       N_Discriminant_Association,
7149       N_Discriminant_Specification,
7150       N_Enumeration_Type_Definition,
7151       N_Entry_Body,
7152       N_Entry_Call_Alternative,
7153       N_Entry_Index_Specification,
7154       N_Exception_Declaration,
7155       N_Exception_Handler,
7156       N_Floating_Point_Definition,
7157       N_Formal_Decimal_Fixed_Point_Definition,
7158       N_Formal_Derived_Type_Definition,
7159       N_Formal_Discrete_Type_Definition,
7160       N_Formal_Floating_Point_Definition,
7161       N_Formal_Modular_Type_Definition,
7162       N_Formal_Ordinary_Fixed_Point_Definition,
7163       N_Formal_Package_Declaration,
7164       N_Formal_Private_Type_Definition,
7165       N_Formal_Signed_Integer_Type_Definition,
7166       N_Freeze_Entity,
7167       N_Generic_Association,
7168       N_Handled_Sequence_Of_Statements,
7169       N_Index_Or_Discriminant_Constraint,
7170       N_Itype_Reference,
7171       N_Label,
7172       N_Modular_Type_Definition,
7173       N_Number_Declaration,
7174       N_Ordinary_Fixed_Point_Definition,
7175       N_Others_Choice,
7176       N_Package_Specification,
7177       N_Parameter_Association,
7178       N_Parameter_Specification,
7179       N_Protected_Definition,
7180       N_Range_Constraint,
7181       N_Real_Range_Specification,
7182       N_Record_Definition,
7183       N_Signed_Integer_Type_Definition,
7184       N_Single_Protected_Declaration,
7185       N_Subunit,
7186       N_Task_Definition,
7187       N_Triggering_Alternative,
7188       N_Use_Type_Clause,
7189       N_Validate_Unchecked_Conversion,
7190       N_Variant,
7191       N_Variant_Part,
7192       N_With_Clause,
7193       N_Unused_At_End);
7194
7195    for Node_Kind'Size use 8;
7196    --  The data structures in Atree assume this!
7197
7198    ----------------------------
7199    -- Node Class Definitions --
7200    ----------------------------
7201
7202    subtype N_Access_To_Subprogram_Definition is Node_Kind range
7203      N_Access_Function_Definition ..
7204      N_Access_Procedure_Definition;
7205
7206    subtype N_Array_Type_Definition is Node_Kind range
7207      N_Constrained_Array_Definition ..
7208      N_Unconstrained_Array_Definition;
7209
7210    subtype N_Binary_Op is Node_Kind range
7211      N_Op_Add ..
7212      N_Op_Shift_Right_Arithmetic;
7213
7214    subtype N_Body_Stub is Node_Kind range
7215      N_Package_Body_Stub ..
7216      N_Task_Body_Stub;
7217
7218    subtype N_Declaration is Node_Kind range
7219      N_Component_Declaration ..
7220      N_Procedure_Specification;
7221    --  Note: this includes all constructs normally thought of as declarations
7222    --  except those which are separately grouped as later declarations.
7223
7224    subtype N_Delay_Statement is Node_Kind range
7225       N_Delay_Relative_Statement ..
7226       N_Delay_Until_Statement;
7227
7228    subtype N_Direct_Name is Node_Kind range
7229      N_Identifier ..
7230      N_Character_Literal;
7231
7232    subtype N_Entity is Node_Kind range
7233      N_Defining_Character_Literal ..
7234      N_Defining_Operator_Symbol;
7235
7236    subtype N_Formal_Subprogram_Declaration is Node_Kind range
7237      N_Formal_Abstract_Subprogram_Declaration ..
7238      N_Formal_Concrete_Subprogram_Declaration;
7239
7240    subtype N_Generic_Declaration is Node_Kind range
7241      N_Generic_Package_Declaration ..
7242      N_Generic_Subprogram_Declaration;
7243
7244    subtype N_Generic_Instantiation is Node_Kind range
7245      N_Function_Instantiation ..
7246      N_Package_Instantiation;
7247
7248    subtype N_Generic_Renaming_Declaration is Node_Kind range
7249      N_Generic_Function_Renaming_Declaration ..
7250      N_Generic_Procedure_Renaming_Declaration;
7251
7252    subtype N_Has_Chars is Node_Kind range
7253      N_Attribute_Definition_Clause ..
7254      N_Op_Plus;
7255
7256    subtype N_Has_Entity is Node_Kind range
7257      N_Expanded_Name ..
7258      N_Attribute_Reference;
7259    --  Nodes that have Entity fields
7260    --  Warning: DOES NOT INCLUDE N_Freeze_Entity!
7261
7262    subtype N_Has_Etype is Node_Kind range
7263      N_Error ..
7264      N_Subtype_Indication;
7265
7266    subtype N_Has_Treat_Fixed_As_Integer is Node_Kind range
7267       N_Op_Divide ..
7268       N_Op_Rem;
7269
7270    subtype N_Multiplying_Operator is Node_Kind range
7271       N_Op_Divide ..
7272       N_Op_Rem;
7273
7274    subtype N_Later_Decl_Item is Node_Kind range
7275      N_Task_Type_Declaration ..
7276      N_Generic_Subprogram_Declaration;
7277    --  Note: this is Ada 83 relevant only (see Ada 83 RM 3.9 (2)) and
7278    --  includes only those items which can appear as later declarative
7279    --  items. This also includes N_Implicit_Label_Declaration which is
7280    --  not specifically in the grammar but may appear as a valid later
7281    --  declarative items. It does NOT include N_Pragma which can also
7282    --  appear among later declarative items. It does however include
7283    --  N_Protected_Body, which is a bit peculiar, but harmless since
7284    --  this cannot appear in Ada 83 mode anyway.
7285
7286    subtype N_Membership_Test is Node_Kind range
7287       N_In ..
7288       N_Not_In;
7289
7290    subtype N_Op is Node_Kind range
7291      N_Op_Add ..
7292      N_Op_Plus;
7293
7294    subtype N_Op_Boolean is Node_Kind range
7295      N_Op_And ..
7296      N_Op_Xor;
7297    --  Binary operators which take operands of a boolean type, and yield
7298    --  a result of a boolean type.
7299
7300    subtype N_Op_Compare is Node_Kind range
7301      N_Op_Eq ..
7302      N_Op_Ne;
7303
7304    subtype N_Op_Shift is Node_Kind range
7305      N_Op_Rotate_Left ..
7306      N_Op_Shift_Right_Arithmetic;
7307
7308    subtype N_Proper_Body is Node_Kind range
7309      N_Package_Body ..
7310      N_Task_Body;
7311
7312    subtype N_Push_xxx_Label is Node_Kind range
7313      N_Push_Constraint_Error_Label ..
7314      N_Push_Storage_Error_Label;
7315
7316    subtype N_Pop_xxx_Label is Node_Kind range
7317      N_Pop_Constraint_Error_Label ..
7318      N_Pop_Storage_Error_Label;
7319
7320    subtype N_Push_Pop_xxx_Label is Node_Kind range
7321      N_Push_Constraint_Error_Label ..
7322      N_Pop_Storage_Error_Label;
7323
7324    subtype N_Raise_xxx_Error is Node_Kind range
7325      N_Raise_Constraint_Error ..
7326      N_Raise_Storage_Error;
7327
7328    subtype N_Renaming_Declaration is Node_Kind range
7329      N_Exception_Renaming_Declaration ..
7330      N_Generic_Procedure_Renaming_Declaration;
7331
7332    subtype N_Representation_Clause is Node_Kind range
7333      N_At_Clause ..
7334      N_Attribute_Definition_Clause;
7335
7336    subtype N_Statement_Other_Than_Procedure_Call is Node_Kind range
7337      N_Abort_Statement ..
7338      N_If_Statement;
7339    --  Note that this includes all statement types except for the cases of the
7340    --  N_Procedure_Call_Statement which is considered to be a subexpression
7341    --  (since overloading is possible, so it needs to go through the normal
7342    --  overloading resolution for expressions).
7343
7344    subtype N_Subprogram_Instantiation is Node_Kind range
7345      N_Function_Instantiation ..
7346      N_Procedure_Instantiation;
7347
7348    subtype N_Has_Condition is Node_Kind range
7349      N_Exit_Statement ..
7350      N_Terminate_Alternative;
7351    --  Nodes with condition fields (does not include N_Raise_xxx_Error)
7352
7353    subtype N_Subexpr is Node_Kind range
7354      N_Expanded_Name ..
7355      N_Unchecked_Type_Conversion;
7356    --  Nodes with expression fields
7357
7358    subtype N_Subprogram_Specification is Node_Kind range
7359      N_Function_Specification ..
7360      N_Procedure_Specification;
7361
7362    subtype N_Unary_Op is Node_Kind range
7363      N_Op_Abs ..
7364      N_Op_Plus;
7365
7366    subtype N_Unit_Body is Node_Kind range
7367      N_Package_Body ..
7368      N_Subprogram_Body;
7369
7370    ---------------------------
7371    -- Node Access Functions --
7372    ---------------------------
7373
7374    --  The following functions return the contents of the indicated field of
7375    --  the node referenced by the argument, which is a Node_Id. They provide
7376    --  logical access to fields in the node which could be accessed using the
7377    --  Atree.Unchecked_Access package, but the idea is always to use these
7378    --  higher level routines which preserve strong typing. In debug mode,
7379    --  these routines check that they are being applied to an appropriate
7380    --  node, as well as checking that the node is in range.
7381
7382    function ABE_Is_Certain
7383      (N : Node_Id) return Boolean;    -- Flag18
7384
7385    function Abort_Present
7386      (N : Node_Id) return Boolean;    -- Flag15
7387
7388    function Abortable_Part
7389      (N : Node_Id) return Node_Id;    -- Node2
7390
7391    function Abstract_Present
7392      (N : Node_Id) return Boolean;    -- Flag4
7393
7394    function Accept_Handler_Records
7395      (N : Node_Id) return List_Id;    -- List5
7396
7397    function Accept_Statement
7398      (N : Node_Id) return Node_Id;    -- Node2
7399
7400    function Access_Definition
7401      (N : Node_Id) return Node_Id;    -- Node3
7402
7403    function Access_To_Subprogram_Definition
7404      (N : Node_Id) return Node_Id;    -- Node3
7405
7406    function Access_Types_To_Process
7407      (N : Node_Id) return Elist_Id;   -- Elist2
7408
7409    function Actions
7410      (N : Node_Id) return List_Id;    -- List1
7411
7412    function Activation_Chain_Entity
7413      (N : Node_Id) return Node_Id;    -- Node3
7414
7415    function Acts_As_Spec
7416      (N : Node_Id) return Boolean;    -- Flag4
7417
7418    function Actual_Designated_Subtype
7419      (N : Node_Id) return Node_Id;    -- Node4
7420
7421    function Aggregate_Bounds
7422      (N : Node_Id) return Node_Id;    -- Node3
7423
7424    function Aliased_Present
7425      (N : Node_Id) return Boolean;    -- Flag4
7426
7427    function All_Others
7428      (N : Node_Id) return Boolean;    -- Flag11
7429
7430    function All_Present
7431      (N : Node_Id) return Boolean;    -- Flag15
7432
7433    function Alternatives
7434      (N : Node_Id) return List_Id;    -- List4
7435
7436    function Ancestor_Part
7437      (N : Node_Id) return Node_Id;    -- Node3
7438
7439    function Array_Aggregate
7440      (N : Node_Id) return Node_Id;    -- Node3
7441
7442    function Assignment_OK
7443      (N : Node_Id) return Boolean;    -- Flag15
7444
7445    function Associated_Node
7446      (N : Node_Id) return Node_Id;    -- Node4
7447
7448    function At_End_Proc
7449      (N : Node_Id) return Node_Id;    -- Node1
7450
7451    function Attribute_Name
7452      (N : Node_Id) return Name_Id;    -- Name2
7453
7454    function Aux_Decls_Node
7455      (N : Node_Id) return Node_Id;    -- Node5
7456
7457    function Backwards_OK
7458      (N : Node_Id) return Boolean;    -- Flag6
7459
7460    function Bad_Is_Detected
7461      (N : Node_Id) return Boolean;    -- Flag15
7462
7463    function By_Ref
7464      (N : Node_Id) return Boolean;    -- Flag5
7465
7466    function Body_Required
7467      (N : Node_Id) return Boolean;    -- Flag13
7468
7469    function Body_To_Inline
7470      (N : Node_Id) return Node_Id;    -- Node3
7471
7472    function Box_Present
7473      (N : Node_Id) return Boolean;    -- Flag15
7474
7475    function Char_Literal_Value
7476      (N : Node_Id) return Uint;       -- Uint2
7477
7478    function Chars
7479      (N : Node_Id) return Name_Id;    -- Name1
7480
7481    function Check_Address_Alignment
7482      (N : Node_Id) return Boolean;    -- Flag11
7483
7484    function Choice_Parameter
7485      (N : Node_Id) return Node_Id;    -- Node2
7486
7487    function Choices
7488      (N : Node_Id) return List_Id;    -- List1
7489
7490    function Coextensions
7491       (N : Node_Id) return Elist_Id;  -- Elist4
7492
7493    function Comes_From_Extended_Return_Statement
7494      (N : Node_Id) return Boolean;    -- Flag18
7495
7496    function Compile_Time_Known_Aggregate
7497      (N : Node_Id) return Boolean;    -- Flag18
7498
7499    function Component_Associations
7500      (N : Node_Id) return List_Id;    -- List2
7501
7502    function Component_Clauses
7503      (N : Node_Id) return List_Id;    -- List3
7504
7505    function Component_Definition
7506      (N : Node_Id) return Node_Id;    -- Node4
7507
7508    function Component_Items
7509      (N : Node_Id) return List_Id;    -- List3
7510
7511    function Component_List
7512      (N : Node_Id) return Node_Id;    -- Node1
7513
7514    function Component_Name
7515      (N : Node_Id) return Node_Id;    -- Node1
7516
7517    function Condition
7518      (N : Node_Id) return Node_Id;    -- Node1
7519
7520    function Condition_Actions
7521      (N : Node_Id) return List_Id;    -- List3
7522
7523    function Config_Pragmas
7524      (N : Node_Id) return List_Id;    -- List4
7525
7526    function Constant_Present
7527      (N : Node_Id) return Boolean;    -- Flag17
7528
7529    function Constraint
7530      (N : Node_Id) return Node_Id;    -- Node3
7531
7532    function Constraints
7533      (N : Node_Id) return List_Id;    -- List1
7534
7535    function Context_Installed
7536      (N : Node_Id) return Boolean;    -- Flag13
7537
7538    function Context_Items
7539      (N : Node_Id) return List_Id;    -- List1
7540
7541    function Controlling_Argument
7542      (N : Node_Id) return Node_Id;    -- Node1
7543
7544    function Conversion_OK
7545      (N : Node_Id) return Boolean;    -- Flag14
7546
7547    function Corresponding_Body
7548      (N : Node_Id) return Node_Id;    -- Node5
7549
7550    function Corresponding_Formal_Spec
7551      (N : Node_Id) return Node_Id;    -- Node3
7552
7553    function Corresponding_Generic_Association
7554      (N : Node_Id) return Node_Id;    -- Node5
7555
7556    function Corresponding_Integer_Value
7557      (N : Node_Id) return Uint;       -- Uint4
7558
7559    function Corresponding_Spec
7560      (N : Node_Id) return Node_Id;    -- Node5
7561
7562    function Corresponding_Stub
7563      (N : Node_Id) return Node_Id;    -- Node3
7564
7565    function Dcheck_Function
7566      (N : Node_Id) return Entity_Id;  -- Node5
7567
7568    function Debug_Statement
7569      (N : Node_Id) return Node_Id;    -- Node3
7570
7571    function Declarations
7572      (N : Node_Id) return List_Id;    -- List2
7573
7574    function Default_Expression
7575      (N : Node_Id) return Node_Id;    -- Node5
7576
7577    function Default_Name
7578      (N : Node_Id) return Node_Id;    -- Node2
7579
7580    function Defining_Identifier
7581      (N : Node_Id) return Entity_Id;  -- Node1
7582
7583    function Defining_Unit_Name
7584      (N : Node_Id) return Node_Id;    -- Node1
7585
7586    function Delay_Alternative
7587      (N : Node_Id) return Node_Id;    -- Node4
7588
7589    function Delay_Statement
7590      (N : Node_Id) return Node_Id;    -- Node2
7591
7592    function Delta_Expression
7593      (N : Node_Id) return Node_Id;    -- Node3
7594
7595    function Digits_Expression
7596      (N : Node_Id) return Node_Id;    -- Node2
7597
7598    function Discr_Check_Funcs_Built
7599      (N : Node_Id) return Boolean;    -- Flag11
7600
7601    function Discrete_Choices
7602      (N : Node_Id) return List_Id;    -- List4
7603
7604    function Discrete_Range
7605      (N : Node_Id) return Node_Id;    -- Node4
7606
7607    function Discrete_Subtype_Definition
7608      (N : Node_Id) return Node_Id;    -- Node4
7609
7610    function Discrete_Subtype_Definitions
7611      (N : Node_Id) return List_Id;    -- List2
7612
7613    function Discriminant_Specifications
7614      (N : Node_Id) return List_Id;    -- List4
7615
7616    function Discriminant_Type
7617      (N : Node_Id) return Node_Id;    -- Node5
7618
7619    function Do_Accessibility_Check
7620      (N : Node_Id) return Boolean;    -- Flag13
7621
7622    function Do_Discriminant_Check
7623      (N : Node_Id) return Boolean;    -- Flag13
7624
7625    function Do_Division_Check
7626      (N : Node_Id) return Boolean;    -- Flag13
7627
7628    function Do_Length_Check
7629      (N : Node_Id) return Boolean;    -- Flag4
7630
7631    function Do_Overflow_Check
7632      (N : Node_Id) return Boolean;    -- Flag17
7633
7634    function Do_Range_Check
7635      (N : Node_Id) return Boolean;    -- Flag9
7636
7637    function Do_Storage_Check
7638      (N : Node_Id) return Boolean;    -- Flag17
7639
7640    function Do_Tag_Check
7641      (N : Node_Id) return Boolean;    -- Flag13
7642
7643    function Elaborate_All_Desirable
7644      (N : Node_Id) return Boolean;    -- Flag9
7645
7646    function Elaborate_All_Present
7647      (N : Node_Id) return Boolean;    -- Flag14
7648
7649    function Elaborate_Desirable
7650      (N : Node_Id) return Boolean;    -- Flag11
7651
7652    function Elaborate_Present
7653      (N : Node_Id) return Boolean;    -- Flag4
7654
7655    function Elaboration_Boolean
7656      (N : Node_Id) return Node_Id;    -- Node2
7657
7658    function Else_Actions
7659      (N : Node_Id) return List_Id;    -- List3
7660
7661    function Else_Statements
7662      (N : Node_Id) return List_Id;    -- List4
7663
7664    function Elsif_Parts
7665      (N : Node_Id) return List_Id;    -- List3
7666
7667    function Enclosing_Variant
7668      (N : Node_Id) return Node_Id;    -- Node2
7669
7670    function End_Label
7671      (N : Node_Id) return Node_Id;    -- Node4
7672
7673    function End_Span
7674      (N : Node_Id) return Uint;       -- Uint5
7675
7676    function Entity
7677      (N : Node_Id) return Node_Id;    -- Node4
7678
7679    function Entity_Or_Associated_Node
7680      (N : Node_Id) return Node_Id;    -- Node4
7681
7682    function Entry_Body_Formal_Part
7683      (N : Node_Id) return Node_Id;    -- Node5
7684
7685    function Entry_Call_Alternative
7686      (N : Node_Id) return Node_Id;    -- Node1
7687
7688    function Entry_Call_Statement
7689      (N : Node_Id) return Node_Id;    -- Node1
7690
7691    function Entry_Direct_Name
7692      (N : Node_Id) return Node_Id;    -- Node1
7693
7694    function Entry_Index
7695      (N : Node_Id) return Node_Id;    -- Node5
7696
7697    function Entry_Index_Specification
7698      (N : Node_Id) return Node_Id;    -- Node4
7699
7700    function Etype
7701      (N : Node_Id) return Node_Id;    -- Node5
7702
7703    function Exception_Choices
7704      (N : Node_Id) return List_Id;    -- List4
7705
7706    function Exception_Handlers
7707      (N : Node_Id) return List_Id;    -- List5
7708
7709    function Exception_Junk
7710      (N : Node_Id) return Boolean;    -- Flag8
7711
7712    function Exception_Label
7713      (N : Node_Id) return Node_Id;    -- Node5
7714
7715    function Explicit_Actual_Parameter
7716      (N : Node_Id) return Node_Id;    -- Node3
7717
7718    function Expansion_Delayed
7719      (N : Node_Id) return Boolean;    -- Flag11
7720
7721    function Explicit_Generic_Actual_Parameter
7722      (N : Node_Id) return Node_Id;    -- Node1
7723
7724    function Expression
7725      (N : Node_Id) return Node_Id;    -- Node3
7726
7727    function Expressions
7728      (N : Node_Id) return List_Id;    -- List1
7729
7730    function First_Bit
7731      (N : Node_Id) return Node_Id;    -- Node3
7732
7733    function First_Inlined_Subprogram
7734      (N : Node_Id) return Entity_Id;  -- Node3
7735
7736    function First_Name
7737      (N : Node_Id) return Boolean;    -- Flag5
7738
7739    function First_Named_Actual
7740      (N : Node_Id) return Node_Id;    -- Node4
7741
7742    function First_Real_Statement
7743      (N : Node_Id) return Node_Id;    -- Node2
7744
7745    function First_Subtype_Link
7746      (N : Node_Id) return Entity_Id;  -- Node5
7747
7748    function Float_Truncate
7749      (N : Node_Id) return Boolean;    -- Flag11
7750
7751    function Formal_Type_Definition
7752      (N : Node_Id) return Node_Id;    -- Node3
7753
7754    function Forwards_OK
7755      (N : Node_Id) return Boolean;    -- Flag5
7756
7757    function From_At_Mod
7758      (N : Node_Id) return Boolean;    -- Flag4
7759
7760    function From_Default
7761      (N : Node_Id) return Boolean;    -- Flag6
7762
7763    function Generic_Associations
7764      (N : Node_Id) return List_Id;    -- List3
7765
7766    function Generic_Formal_Declarations
7767      (N : Node_Id) return List_Id;    -- List2
7768
7769    function Generic_Parent
7770      (N : Node_Id) return Node_Id;    -- Node5
7771
7772    function Generic_Parent_Type
7773      (N : Node_Id) return Node_Id;    -- Node4
7774
7775    function Handled_Statement_Sequence
7776      (N : Node_Id) return Node_Id;    -- Node4
7777
7778    function Handler_List_Entry
7779      (N : Node_Id) return Node_Id;    -- Node2
7780
7781    function Has_Created_Identifier
7782      (N : Node_Id) return Boolean;    -- Flag15
7783
7784    function Has_Dynamic_Length_Check
7785      (N : Node_Id) return Boolean;    -- Flag10
7786
7787    function Has_Dynamic_Range_Check
7788      (N : Node_Id) return Boolean;    -- Flag12
7789
7790    function Has_Init_Expression
7791      (N : Node_Id) return Boolean;    -- Flag14
7792
7793    function Has_Local_Raise
7794      (N : Node_Id) return Boolean;    -- Flag8
7795
7796    function Has_No_Elaboration_Code
7797      (N : Node_Id) return Boolean;    -- Flag17
7798
7799    function Has_Priority_Pragma
7800      (N : Node_Id) return Boolean;    -- Flag6
7801
7802    function Has_Private_View
7803      (N : Node_Id) return Boolean;    -- Flag11
7804
7805    function Has_Self_Reference
7806      (N : Node_Id) return Boolean;    -- Flag13
7807
7808    function Has_Storage_Size_Pragma
7809      (N : Node_Id) return Boolean;    -- Flag5
7810
7811    function Has_Task_Info_Pragma
7812      (N : Node_Id) return Boolean;    -- Flag7
7813
7814    function Has_Task_Name_Pragma
7815      (N : Node_Id) return Boolean;    -- Flag8
7816
7817    function Has_Wide_Character
7818      (N : Node_Id) return Boolean;    -- Flag11
7819
7820    function Hidden_By_Use_Clause
7821      (N : Node_Id) return Elist_Id;   -- Elist4
7822
7823    function High_Bound
7824      (N : Node_Id) return Node_Id;    -- Node2
7825
7826    function Identifier
7827      (N : Node_Id) return Node_Id;    -- Node1
7828
7829    function Interface_List
7830      (N : Node_Id) return List_Id;    -- List2
7831
7832    function Interface_Present
7833      (N : Node_Id) return Boolean;    -- Flag16
7834
7835    function Implicit_With
7836      (N : Node_Id) return Boolean;    -- Flag16
7837
7838    function In_Present
7839      (N : Node_Id) return Boolean;    -- Flag15
7840
7841    function Includes_Infinities
7842      (N : Node_Id) return Boolean;    -- Flag11
7843
7844    function Instance_Spec
7845      (N : Node_Id) return Node_Id;    -- Node5
7846
7847    function Intval
7848      (N : Node_Id) return Uint;       -- Uint3
7849
7850    function Is_Asynchronous_Call_Block
7851      (N : Node_Id) return Boolean;    -- Flag7
7852
7853    function Is_Coextension
7854      (N : Node_Id) return Boolean;    -- Flag18
7855
7856    function Is_Component_Left_Opnd
7857      (N : Node_Id) return Boolean;    -- Flag13
7858
7859    function Is_Component_Right_Opnd
7860      (N : Node_Id) return Boolean;    -- Flag14
7861
7862    function Is_Controlling_Actual
7863      (N : Node_Id) return Boolean;    -- Flag16
7864
7865    function Is_Entry_Barrier_Function
7866      (N : Node_Id) return Boolean;    -- Flag8
7867
7868    function Is_In_Discriminant_Check
7869      (N : Node_Id) return Boolean;    -- Flag11
7870
7871    function Is_Machine_Number
7872      (N : Node_Id) return Boolean;    -- Flag11
7873
7874    function Is_Null_Loop
7875      (N : Node_Id) return Boolean;    -- Flag16
7876
7877    function Is_Overloaded
7878      (N : Node_Id) return Boolean;    -- Flag5
7879
7880    function Is_Power_Of_2_For_Shift
7881      (N : Node_Id) return Boolean;    -- Flag13
7882
7883    function Is_Protected_Subprogram_Body
7884      (N : Node_Id) return Boolean;    -- Flag7
7885
7886    function Is_Static_Coextension
7887      (N : Node_Id) return Boolean;    -- Flag14
7888
7889    function Is_Static_Expression
7890      (N : Node_Id) return Boolean;    -- Flag6
7891
7892    function Is_Subprogram_Descriptor
7893      (N : Node_Id) return Boolean;    -- Flag16
7894
7895    function Is_Task_Allocation_Block
7896      (N : Node_Id) return Boolean;    -- Flag6
7897
7898    function Is_Task_Master
7899      (N : Node_Id) return Boolean;    -- Flag5
7900
7901    function Iteration_Scheme
7902      (N : Node_Id) return Node_Id;    -- Node2
7903
7904    function Itype
7905      (N : Node_Id) return Entity_Id;  -- Node1
7906
7907    function Kill_Range_Check
7908      (N : Node_Id) return Boolean;    -- Flag11
7909
7910    function Label_Construct
7911      (N : Node_Id) return Node_Id;    -- Node2
7912
7913    function Left_Opnd
7914      (N : Node_Id) return Node_Id;    -- Node2
7915
7916    function Last_Bit
7917      (N : Node_Id) return Node_Id;    -- Node4
7918
7919    function Last_Name
7920      (N : Node_Id) return Boolean;    -- Flag6
7921
7922    function Library_Unit
7923      (N : Node_Id) return Node_Id;    -- Node4
7924
7925    function Limited_View_Installed
7926      (N : Node_Id) return Boolean;    -- Flag18
7927
7928    function Limited_Present
7929      (N : Node_Id) return Boolean;    -- Flag17
7930
7931    function Literals
7932      (N : Node_Id) return List_Id;    -- List1
7933
7934    function Local_Raise_Not_OK
7935      (N : Node_Id) return Boolean;    -- Flag7
7936
7937    function Local_Raise_Statements
7938      (N : Node_Id) return Elist_Id;   -- Elist1
7939
7940    function Loop_Actions
7941      (N : Node_Id) return List_Id;    -- List2
7942
7943    function Loop_Parameter_Specification
7944      (N : Node_Id) return Node_Id;    -- Node4
7945
7946    function Low_Bound
7947      (N : Node_Id) return Node_Id;    -- Node1
7948
7949    function Mod_Clause
7950      (N : Node_Id) return Node_Id;    -- Node2
7951
7952    function More_Ids
7953      (N : Node_Id) return Boolean;    -- Flag5
7954
7955    function Must_Be_Byte_Aligned
7956      (N : Node_Id) return Boolean;    -- Flag14
7957
7958    function Must_Not_Freeze
7959      (N : Node_Id) return Boolean;    -- Flag8
7960
7961    function Must_Not_Override
7962      (N : Node_Id) return Boolean;    -- Flag15
7963
7964    function Must_Override
7965      (N : Node_Id) return Boolean;    -- Flag14
7966
7967    function Name
7968      (N : Node_Id) return Node_Id;    -- Node2
7969
7970    function Names
7971      (N : Node_Id) return List_Id;    -- List2
7972
7973    function Next_Entity
7974      (N : Node_Id) return Node_Id;    -- Node2
7975
7976    function Next_Named_Actual
7977      (N : Node_Id) return Node_Id;    -- Node4
7978
7979    function Next_Rep_Item
7980      (N : Node_Id) return Node_Id;    -- Node5
7981
7982    function Next_Use_Clause
7983      (N : Node_Id) return Node_Id;    -- Node3
7984
7985    function No_Ctrl_Actions
7986      (N : Node_Id) return Boolean;    -- Flag7
7987
7988    function No_Elaboration_Check
7989      (N : Node_Id) return Boolean;    -- Flag14
7990
7991    function No_Entities_Ref_In_Spec
7992      (N : Node_Id) return Boolean;    -- Flag8
7993
7994    function No_Initialization
7995      (N : Node_Id) return Boolean;    -- Flag13
7996
7997    function No_Truncation
7998      (N : Node_Id) return Boolean;    -- Flag17
7999
8000    function Null_Present
8001      (N : Node_Id) return Boolean;    -- Flag13
8002
8003    function Null_Exclusion_Present
8004      (N : Node_Id) return Boolean;    -- Flag11
8005
8006    function Null_Record_Present
8007      (N : Node_Id) return Boolean;    -- Flag17
8008
8009    function Object_Definition
8010      (N : Node_Id) return Node_Id;    -- Node4
8011
8012    function Original_Discriminant
8013      (N : Node_Id) return Node_Id;    -- Node2
8014
8015    function Original_Entity
8016      (N : Node_Id) return Entity_Id;  -- Node2
8017
8018    function Others_Discrete_Choices
8019      (N : Node_Id) return List_Id;    -- List1
8020
8021    function Out_Present
8022      (N : Node_Id) return Boolean;    -- Flag17
8023
8024    function Parameter_Associations
8025      (N : Node_Id) return List_Id;    -- List3
8026
8027    function Parameter_List_Truncated
8028      (N : Node_Id) return Boolean;    -- Flag17
8029
8030    function Parameter_Specifications
8031      (N : Node_Id) return List_Id;    -- List3
8032
8033    function Parameter_Type
8034      (N : Node_Id) return Node_Id;    -- Node2
8035
8036    function Parent_Spec
8037      (N : Node_Id) return Node_Id;    -- Node4
8038
8039    function Position
8040      (N : Node_Id) return Node_Id;    -- Node2
8041
8042    function Pragma_Argument_Associations
8043      (N : Node_Id) return List_Id;    -- List2
8044
8045    function Pragmas_After
8046      (N : Node_Id) return List_Id;    -- List5
8047
8048    function Pragmas_Before
8049      (N : Node_Id) return List_Id;    -- List4
8050
8051    function Prefix
8052      (N : Node_Id) return Node_Id;    -- Node3
8053
8054    function Present_Expr
8055      (N : Node_Id) return Uint;       -- Uint3
8056
8057    function Prev_Ids
8058      (N : Node_Id) return Boolean;    -- Flag6
8059
8060    function Print_In_Hex
8061      (N : Node_Id) return Boolean;    -- Flag13
8062
8063    function Private_Declarations
8064      (N : Node_Id) return List_Id;    -- List3
8065
8066    function Private_Present
8067      (N : Node_Id) return Boolean;    -- Flag15
8068
8069    function Procedure_To_Call
8070      (N : Node_Id) return Node_Id;    -- Node2
8071
8072    function Proper_Body
8073      (N : Node_Id) return Node_Id;    -- Node1
8074
8075    function Protected_Definition
8076      (N : Node_Id) return Node_Id;    -- Node3
8077
8078    function Protected_Present
8079      (N : Node_Id) return Boolean;    -- Flag6
8080
8081    function Raises_Constraint_Error
8082      (N : Node_Id) return Boolean;    -- Flag7
8083
8084    function Range_Constraint
8085      (N : Node_Id) return Node_Id;    -- Node4
8086
8087    function Range_Expression
8088      (N : Node_Id) return Node_Id;    -- Node4
8089
8090    function Real_Range_Specification
8091      (N : Node_Id) return Node_Id;    -- Node4
8092
8093    function Realval
8094      (N : Node_Id) return Ureal;      -- Ureal3
8095
8096    function Reason
8097      (N : Node_Id) return Uint;       -- Uint3
8098
8099    function Record_Extension_Part
8100      (N : Node_Id) return Node_Id;    -- Node3
8101
8102    function Redundant_Use
8103      (N : Node_Id) return Boolean;    -- Flag13
8104
8105    function Renaming_Exception
8106      (N : Node_Id) return Node_Id;    -- Node2
8107
8108    function Result_Definition
8109      (N : Node_Id) return Node_Id;    -- Node4
8110
8111    function Return_Object_Declarations
8112      (N : Node_Id) return List_Id;    -- List3
8113
8114    function Return_Statement_Entity
8115      (N : Node_Id) return Node_Id;    -- Node5
8116
8117    function Reverse_Present
8118      (N : Node_Id) return Boolean;    -- Flag15
8119
8120    function Right_Opnd
8121      (N : Node_Id) return Node_Id;    -- Node3
8122
8123    function Rounded_Result
8124      (N : Node_Id) return Boolean;    -- Flag18
8125
8126    function Scope
8127      (N : Node_Id) return Node_Id;    -- Node3
8128
8129    function Select_Alternatives
8130      (N : Node_Id) return List_Id;    -- List1
8131
8132    function Selector_Name
8133      (N : Node_Id) return Node_Id;    -- Node2
8134
8135    function Selector_Names
8136      (N : Node_Id) return List_Id;    -- List1
8137
8138    function Shift_Count_OK
8139      (N : Node_Id) return Boolean;    -- Flag4
8140
8141    function Source_Type
8142      (N : Node_Id) return Entity_Id;  -- Node1
8143
8144    function Specification
8145      (N : Node_Id) return Node_Id;    -- Node1
8146
8147    function Statements
8148      (N : Node_Id) return List_Id;    -- List3
8149
8150    function Static_Processing_OK
8151      (N : Node_Id) return Boolean;    -- Flag4
8152
8153    function Storage_Pool
8154      (N : Node_Id) return Node_Id;    -- Node1
8155
8156    function Strval
8157      (N : Node_Id) return String_Id;  -- Str3
8158
8159    function Subtype_Indication
8160      (N : Node_Id) return Node_Id;    -- Node5
8161
8162    function Subtype_Mark
8163      (N : Node_Id) return Node_Id;    -- Node4
8164
8165    function Subtype_Marks
8166      (N : Node_Id) return List_Id;    -- List2
8167
8168    function Synchronized_Present
8169      (N : Node_Id) return Boolean;    -- Flag7
8170
8171    function Tagged_Present
8172      (N : Node_Id) return Boolean;    -- Flag15
8173
8174    function Target_Type
8175      (N : Node_Id) return Entity_Id;  -- Node2
8176
8177    function Task_Definition
8178      (N : Node_Id) return Node_Id;    -- Node3
8179
8180    function Task_Present
8181      (N : Node_Id) return Boolean;    -- Flag5
8182
8183    function Then_Actions
8184      (N : Node_Id) return List_Id;    -- List2
8185
8186    function Then_Statements
8187      (N : Node_Id) return List_Id;    -- List2
8188
8189    function Treat_Fixed_As_Integer
8190      (N : Node_Id) return Boolean;    -- Flag14
8191
8192    function Triggering_Alternative
8193      (N : Node_Id) return Node_Id;    -- Node1
8194
8195    function Triggering_Statement
8196      (N : Node_Id) return Node_Id;    -- Node1
8197
8198    function TSS_Elist
8199      (N : Node_Id) return Elist_Id;   -- Elist3
8200
8201    function Type_Definition
8202      (N : Node_Id) return Node_Id;    -- Node3
8203
8204    function Unit
8205      (N : Node_Id) return Node_Id;    -- Node2
8206
8207    function Unknown_Discriminants_Present
8208      (N : Node_Id) return Boolean;    -- Flag13
8209
8210    function Unreferenced_In_Spec
8211      (N : Node_Id) return Boolean;    -- Flag7
8212
8213    function Variant_Part
8214      (N : Node_Id) return Node_Id;    -- Node4
8215
8216    function Variants
8217      (N : Node_Id) return List_Id;    -- List1
8218
8219    function Visible_Declarations
8220      (N : Node_Id) return List_Id;    -- List2
8221
8222    function Was_Originally_Stub
8223      (N : Node_Id) return Boolean;    -- Flag13
8224
8225    function Zero_Cost_Handling
8226      (N : Node_Id) return Boolean;    -- Flag5
8227
8228    --  End functions (note used by xsinfo utility program to end processing)
8229
8230    ----------------------------
8231    -- Node Update Procedures --
8232    ----------------------------
8233
8234    --  These are the corresponding node update routines, which again provide
8235    --  a high level logical access with type checking. In addition to setting
8236    --  the indicated field of the node N to the given Val, in the case of
8237    --  tree pointers (List1-4), the parent pointer of the Val node is set to
8238    --  point back to node N. This automates the setting of the parent pointer.
8239
8240    procedure Set_ABE_Is_Certain
8241      (N : Node_Id; Val : Boolean := True);    -- Flag18
8242
8243    procedure Set_Abort_Present
8244      (N : Node_Id; Val : Boolean := True);    -- Flag15
8245
8246    procedure Set_Abortable_Part
8247      (N : Node_Id; Val : Node_Id);            -- Node2
8248
8249    procedure Set_Abstract_Present
8250      (N : Node_Id; Val : Boolean := True);    -- Flag4
8251
8252    procedure Set_Accept_Handler_Records
8253      (N : Node_Id; Val : List_Id);            -- List5
8254
8255    procedure Set_Accept_Statement
8256      (N : Node_Id; Val : Node_Id);            -- Node2
8257
8258    procedure Set_Access_Definition
8259      (N : Node_Id; Val : Node_Id);            -- Node3
8260
8261    procedure Set_Access_To_Subprogram_Definition
8262      (N : Node_Id; Val : Node_Id);            -- Node3
8263
8264    procedure Set_Access_Types_To_Process
8265      (N : Node_Id; Val : Elist_Id);           -- Elist2
8266
8267    procedure Set_Actions
8268      (N : Node_Id; Val : List_Id);            -- List1
8269
8270    procedure Set_Activation_Chain_Entity
8271      (N : Node_Id; Val : Node_Id);            -- Node3
8272
8273    procedure Set_Acts_As_Spec
8274      (N : Node_Id; Val : Boolean := True);    -- Flag4
8275
8276    procedure Set_Actual_Designated_Subtype
8277      (N : Node_Id; Val : Node_Id);            -- Node4
8278
8279    procedure Set_Aggregate_Bounds
8280      (N : Node_Id; Val : Node_Id);            -- Node3
8281
8282    procedure Set_Aliased_Present
8283      (N : Node_Id; Val : Boolean := True);    -- Flag4
8284
8285    procedure Set_All_Others
8286      (N : Node_Id; Val : Boolean := True);    -- Flag11
8287
8288    procedure Set_All_Present
8289      (N : Node_Id; Val : Boolean := True);    -- Flag15
8290
8291    procedure Set_Alternatives
8292      (N : Node_Id; Val : List_Id);            -- List4
8293
8294    procedure Set_Ancestor_Part
8295      (N : Node_Id; Val : Node_Id);            -- Node3
8296
8297    procedure Set_Array_Aggregate
8298      (N : Node_Id; Val : Node_Id);            -- Node3
8299
8300    procedure Set_Assignment_OK
8301      (N : Node_Id; Val : Boolean := True);    -- Flag15
8302
8303    procedure Set_Associated_Node
8304      (N : Node_Id; Val : Node_Id);            -- Node4
8305
8306    procedure Set_Attribute_Name
8307      (N : Node_Id; Val : Name_Id);            -- Name2
8308
8309    procedure Set_At_End_Proc
8310      (N : Node_Id; Val : Node_Id);            -- Node1
8311
8312    procedure Set_Aux_Decls_Node
8313      (N : Node_Id; Val : Node_Id);            -- Node5
8314
8315    procedure Set_Backwards_OK
8316      (N : Node_Id; Val : Boolean := True);    -- Flag6
8317
8318    procedure Set_Bad_Is_Detected
8319      (N : Node_Id; Val : Boolean := True);    -- Flag15
8320
8321    procedure Set_Body_Required
8322      (N : Node_Id; Val : Boolean := True);    -- Flag13
8323
8324    procedure Set_Body_To_Inline
8325      (N : Node_Id; Val : Node_Id);            -- Node3
8326
8327    procedure Set_Box_Present
8328      (N : Node_Id; Val : Boolean := True);    -- Flag15
8329
8330    procedure Set_By_Ref
8331      (N : Node_Id; Val : Boolean := True);    -- Flag5
8332
8333    procedure Set_Char_Literal_Value
8334      (N : Node_Id; Val : Uint);               -- Uint2
8335
8336    procedure Set_Chars
8337      (N : Node_Id; Val : Name_Id);            -- Name1
8338
8339    procedure Set_Check_Address_Alignment
8340      (N : Node_Id; Val : Boolean := True);    -- Flag11
8341
8342    procedure Set_Choice_Parameter
8343      (N : Node_Id; Val : Node_Id);            -- Node2
8344
8345    procedure Set_Coextensions
8346      (N : Node_Id; Val : Elist_Id);           -- Elist4
8347
8348    procedure Set_Choices
8349      (N : Node_Id; Val : List_Id);            -- List1
8350
8351    procedure Set_Comes_From_Extended_Return_Statement
8352      (N : Node_Id; Val : Boolean := True);    -- Flag18
8353
8354    procedure Set_Compile_Time_Known_Aggregate
8355      (N : Node_Id; Val : Boolean := True);    -- Flag18
8356
8357    procedure Set_Component_Associations
8358      (N : Node_Id; Val : List_Id);            -- List2
8359
8360    procedure Set_Component_Clauses
8361      (N : Node_Id; Val : List_Id);            -- List3
8362
8363    procedure Set_Component_Definition
8364      (N : Node_Id; Val : Node_Id);            -- Node4
8365
8366    procedure Set_Component_Items
8367      (N : Node_Id; Val : List_Id);            -- List3
8368
8369    procedure Set_Component_List
8370      (N : Node_Id; Val : Node_Id);            -- Node1
8371
8372    procedure Set_Component_Name
8373      (N : Node_Id; Val : Node_Id);            -- Node1
8374
8375    procedure Set_Condition
8376      (N : Node_Id; Val : Node_Id);            -- Node1
8377
8378    procedure Set_Condition_Actions
8379      (N : Node_Id; Val : List_Id);            -- List3
8380
8381    procedure Set_Config_Pragmas
8382      (N : Node_Id; Val : List_Id);            -- List4
8383
8384    procedure Set_Constant_Present
8385      (N : Node_Id; Val : Boolean := True);    -- Flag17
8386
8387    procedure Set_Constraint
8388      (N : Node_Id; Val : Node_Id);            -- Node3
8389
8390    procedure Set_Constraints
8391      (N : Node_Id; Val : List_Id);            -- List1
8392
8393    procedure Set_Context_Installed
8394      (N : Node_Id; Val : Boolean := True);    -- Flag13
8395
8396    procedure Set_Context_Items
8397      (N : Node_Id; Val : List_Id);            -- List1
8398
8399    procedure Set_Controlling_Argument
8400      (N : Node_Id; Val : Node_Id);            -- Node1
8401
8402    procedure Set_Conversion_OK
8403      (N : Node_Id; Val : Boolean := True);    -- Flag14
8404
8405    procedure Set_Corresponding_Body
8406      (N : Node_Id; Val : Node_Id);            -- Node5
8407
8408    procedure Set_Corresponding_Formal_Spec
8409      (N : Node_Id; Val : Node_Id);            -- Node3
8410
8411    procedure Set_Corresponding_Generic_Association
8412      (N : Node_Id; Val : Node_Id);            -- Node5
8413
8414    procedure Set_Corresponding_Integer_Value
8415      (N : Node_Id; Val : Uint);               -- Uint4
8416
8417    procedure Set_Corresponding_Spec
8418      (N : Node_Id; Val : Node_Id);            -- Node5
8419
8420    procedure Set_Corresponding_Stub
8421      (N : Node_Id; Val : Node_Id);            -- Node3
8422
8423    procedure Set_Dcheck_Function
8424      (N : Node_Id; Val : Entity_Id);          -- Node5
8425
8426    procedure Set_Debug_Statement
8427      (N : Node_Id; Val : Node_Id);            -- Node3
8428
8429    procedure Set_Declarations
8430      (N : Node_Id; Val : List_Id);            -- List2
8431
8432    procedure Set_Default_Expression
8433      (N : Node_Id; Val : Node_Id);            -- Node5
8434
8435    procedure Set_Default_Name
8436      (N : Node_Id; Val : Node_Id);            -- Node2
8437
8438    procedure Set_Defining_Identifier
8439      (N : Node_Id; Val : Entity_Id);          -- Node1
8440
8441    procedure Set_Defining_Unit_Name
8442      (N : Node_Id; Val : Node_Id);            -- Node1
8443
8444    procedure Set_Delay_Alternative
8445      (N : Node_Id; Val : Node_Id);            -- Node4
8446
8447    procedure Set_Delay_Statement
8448      (N : Node_Id; Val : Node_Id);            -- Node2
8449
8450    procedure Set_Delta_Expression
8451      (N : Node_Id; Val : Node_Id);            -- Node3
8452
8453    procedure Set_Digits_Expression
8454      (N : Node_Id; Val : Node_Id);            -- Node2
8455
8456    procedure Set_Discr_Check_Funcs_Built
8457      (N : Node_Id; Val : Boolean := True);    -- Flag11
8458
8459    procedure Set_Discrete_Choices
8460      (N : Node_Id; Val : List_Id);            -- List4
8461
8462    procedure Set_Discrete_Range
8463      (N : Node_Id; Val : Node_Id);            -- Node4
8464
8465    procedure Set_Discrete_Subtype_Definition
8466      (N : Node_Id; Val : Node_Id);            -- Node4
8467
8468    procedure Set_Discrete_Subtype_Definitions
8469      (N : Node_Id; Val : List_Id);            -- List2
8470
8471    procedure Set_Discriminant_Specifications
8472      (N : Node_Id; Val : List_Id);            -- List4
8473
8474    procedure Set_Discriminant_Type
8475      (N : Node_Id; Val : Node_Id);            -- Node5
8476
8477    procedure Set_Do_Accessibility_Check
8478      (N : Node_Id; Val : Boolean := True);    -- Flag13
8479
8480    procedure Set_Do_Discriminant_Check
8481      (N : Node_Id; Val : Boolean := True);    -- Flag13
8482
8483    procedure Set_Do_Division_Check
8484      (N : Node_Id; Val : Boolean := True);    -- Flag13
8485
8486    procedure Set_Do_Length_Check
8487      (N : Node_Id; Val : Boolean := True);    -- Flag4
8488
8489    procedure Set_Do_Overflow_Check
8490      (N : Node_Id; Val : Boolean := True);    -- Flag17
8491
8492    procedure Set_Do_Range_Check
8493      (N : Node_Id; Val : Boolean := True);    -- Flag9
8494
8495    procedure Set_Do_Storage_Check
8496      (N : Node_Id; Val : Boolean := True);    -- Flag17
8497
8498    procedure Set_Do_Tag_Check
8499      (N : Node_Id; Val : Boolean := True);    -- Flag13
8500
8501    procedure Set_Elaborate_All_Desirable
8502      (N : Node_Id; Val : Boolean := True);    -- Flag9
8503
8504    procedure Set_Elaborate_All_Present
8505      (N : Node_Id; Val : Boolean := True);    -- Flag14
8506
8507    procedure Set_Elaborate_Desirable
8508      (N : Node_Id; Val : Boolean := True);    -- Flag11
8509
8510    procedure Set_Elaborate_Present
8511      (N : Node_Id; Val : Boolean := True);    -- Flag4
8512
8513    procedure Set_Elaboration_Boolean
8514      (N : Node_Id; Val : Node_Id);            -- Node2
8515
8516    procedure Set_Else_Actions
8517      (N : Node_Id; Val : List_Id);            -- List3
8518
8519    procedure Set_Else_Statements
8520      (N : Node_Id; Val : List_Id);            -- List4
8521
8522    procedure Set_Elsif_Parts
8523      (N : Node_Id; Val : List_Id);            -- List3
8524
8525    procedure Set_Enclosing_Variant
8526      (N : Node_Id; Val : Node_Id);            -- Node2
8527
8528    procedure Set_End_Label
8529      (N : Node_Id; Val : Node_Id);            -- Node4
8530
8531    procedure Set_End_Span
8532      (N : Node_Id; Val : Uint);               -- Uint5
8533
8534    procedure Set_Entity
8535      (N : Node_Id; Val : Node_Id);            -- Node4
8536
8537    procedure Set_Entry_Body_Formal_Part
8538      (N : Node_Id; Val : Node_Id);            -- Node5
8539
8540    procedure Set_Entry_Call_Alternative
8541      (N : Node_Id; Val : Node_Id);            -- Node1
8542
8543    procedure Set_Entry_Call_Statement
8544      (N : Node_Id; Val : Node_Id);            -- Node1
8545
8546    procedure Set_Entry_Direct_Name
8547      (N : Node_Id; Val : Node_Id);            -- Node1
8548
8549    procedure Set_Entry_Index
8550      (N : Node_Id; Val : Node_Id);            -- Node5
8551
8552    procedure Set_Entry_Index_Specification
8553      (N : Node_Id; Val : Node_Id);            -- Node4
8554
8555    procedure Set_Etype
8556      (N : Node_Id; Val : Node_Id);            -- Node5
8557
8558    procedure Set_Exception_Choices
8559      (N : Node_Id; Val : List_Id);            -- List4
8560
8561    procedure Set_Exception_Handlers
8562      (N : Node_Id; Val : List_Id);            -- List5
8563
8564    procedure Set_Exception_Junk
8565      (N : Node_Id; Val : Boolean := True);    -- Flag8
8566
8567    procedure Set_Exception_Label
8568      (N : Node_Id; Val : Node_Id);            -- Node5
8569
8570    procedure Set_Expansion_Delayed
8571      (N : Node_Id; Val : Boolean := True);    -- Flag11
8572
8573    procedure Set_Explicit_Actual_Parameter
8574      (N : Node_Id; Val : Node_Id);            -- Node3
8575
8576    procedure Set_Explicit_Generic_Actual_Parameter
8577      (N : Node_Id; Val : Node_Id);            -- Node1
8578
8579    procedure Set_Expression
8580      (N : Node_Id; Val : Node_Id);            -- Node3
8581
8582    procedure Set_Expressions
8583      (N : Node_Id; Val : List_Id);            -- List1
8584
8585    procedure Set_First_Bit
8586      (N : Node_Id; Val : Node_Id);            -- Node3
8587
8588    procedure Set_First_Inlined_Subprogram
8589      (N : Node_Id; Val : Entity_Id);          -- Node3
8590
8591    procedure Set_First_Name
8592      (N : Node_Id; Val : Boolean := True);    -- Flag5
8593
8594    procedure Set_First_Named_Actual
8595      (N : Node_Id; Val : Node_Id);            -- Node4
8596
8597    procedure Set_First_Real_Statement
8598      (N : Node_Id; Val : Node_Id);            -- Node2
8599
8600    procedure Set_First_Subtype_Link
8601      (N : Node_Id; Val : Entity_Id);          -- Node5
8602
8603    procedure Set_Float_Truncate
8604      (N : Node_Id; Val : Boolean := True);    -- Flag11
8605
8606    procedure Set_Formal_Type_Definition
8607      (N : Node_Id; Val : Node_Id);            -- Node3
8608
8609    procedure Set_Forwards_OK
8610      (N : Node_Id; Val : Boolean := True);    -- Flag5
8611
8612    procedure Set_From_At_Mod
8613      (N : Node_Id; Val : Boolean := True);    -- Flag4
8614
8615    procedure Set_From_Default
8616      (N : Node_Id; Val : Boolean := True);    -- Flag6
8617
8618    procedure Set_Generic_Associations
8619      (N : Node_Id; Val : List_Id);            -- List3
8620
8621    procedure Set_Generic_Formal_Declarations
8622      (N : Node_Id; Val : List_Id);            -- List2
8623
8624    procedure Set_Generic_Parent
8625      (N : Node_Id; Val : Node_Id);            -- Node5
8626
8627    procedure Set_Generic_Parent_Type
8628      (N : Node_Id; Val : Node_Id);            -- Node4
8629
8630    procedure Set_Handled_Statement_Sequence
8631      (N : Node_Id; Val : Node_Id);            -- Node4
8632
8633    procedure Set_Handler_List_Entry
8634      (N : Node_Id; Val : Node_Id);            -- Node2
8635
8636    procedure Set_Has_Created_Identifier
8637      (N : Node_Id; Val : Boolean := True);    -- Flag15
8638
8639    procedure Set_Has_Dynamic_Length_Check
8640      (N : Node_Id; Val : Boolean := True);    -- Flag10
8641
8642    procedure Set_Has_Dynamic_Range_Check
8643      (N : Node_Id; Val : Boolean := True);    -- Flag12
8644
8645    procedure Set_Has_Init_Expression
8646      (N : Node_Id; Val : Boolean := True);    -- Flag14
8647
8648    procedure Set_Has_Local_Raise
8649      (N : Node_Id; Val : Boolean := True);    -- Flag8
8650
8651    procedure Set_Has_No_Elaboration_Code
8652      (N : Node_Id; Val : Boolean := True);    -- Flag17
8653
8654    procedure Set_Has_Priority_Pragma
8655      (N : Node_Id; Val : Boolean := True);    -- Flag6
8656
8657    procedure Set_Has_Private_View
8658      (N : Node_Id; Val : Boolean := True);    -- Flag11
8659
8660    procedure Set_Has_Self_Reference
8661      (N : Node_Id; Val : Boolean := True);    -- Flag13
8662
8663    procedure Set_Has_Storage_Size_Pragma
8664      (N : Node_Id; Val : Boolean := True);    -- Flag5
8665
8666    procedure Set_Has_Task_Info_Pragma
8667      (N : Node_Id; Val : Boolean := True);    -- Flag7
8668
8669    procedure Set_Has_Task_Name_Pragma
8670      (N : Node_Id; Val : Boolean := True);    -- Flag8
8671
8672    procedure Set_Has_Wide_Character
8673      (N : Node_Id; Val : Boolean := True);    -- Flag11
8674
8675    procedure Set_Hidden_By_Use_Clause
8676      (N : Node_Id; Val : Elist_Id);           -- Elist4
8677
8678    procedure Set_High_Bound
8679      (N : Node_Id; Val : Node_Id);            -- Node2
8680
8681    procedure Set_Identifier
8682      (N : Node_Id; Val : Node_Id);            -- Node1
8683
8684    procedure Set_Interface_List
8685      (N : Node_Id; Val : List_Id);            -- List2
8686
8687    procedure Set_Interface_Present
8688      (N : Node_Id; Val : Boolean := True);    -- Flag16
8689
8690    procedure Set_Implicit_With
8691      (N : Node_Id; Val : Boolean := True);    -- Flag16
8692
8693    procedure Set_In_Present
8694      (N : Node_Id; Val : Boolean := True);    -- Flag15
8695
8696    procedure Set_Includes_Infinities
8697      (N : Node_Id; Val : Boolean := True);    -- Flag11
8698
8699    procedure Set_Instance_Spec
8700      (N : Node_Id; Val : Node_Id);            -- Node5
8701
8702    procedure Set_Intval
8703      (N : Node_Id; Val : Uint);               -- Uint3
8704
8705    procedure Set_Is_Asynchronous_Call_Block
8706      (N : Node_Id; Val : Boolean := True);    -- Flag7
8707
8708    procedure Set_Is_Coextension
8709      (N : Node_Id; Val : Boolean := True);    -- Flag18
8710
8711    procedure Set_Is_Component_Left_Opnd
8712      (N : Node_Id; Val : Boolean := True);    -- Flag13
8713
8714    procedure Set_Is_Component_Right_Opnd
8715      (N : Node_Id; Val : Boolean := True);    -- Flag14
8716
8717    procedure Set_Is_Controlling_Actual
8718      (N : Node_Id; Val : Boolean := True);    -- Flag16
8719
8720    procedure Set_Is_Entry_Barrier_Function
8721      (N : Node_Id; Val : Boolean := True);    -- Flag8
8722
8723    procedure Set_Is_In_Discriminant_Check
8724      (N : Node_Id; Val : Boolean := True);    -- Flag11
8725
8726    procedure Set_Is_Machine_Number
8727      (N : Node_Id; Val : Boolean := True);    -- Flag11
8728
8729    procedure Set_Is_Null_Loop
8730      (N : Node_Id; Val : Boolean := True);    -- Flag16
8731
8732    procedure Set_Is_Overloaded
8733      (N : Node_Id; Val : Boolean := True);    -- Flag5
8734
8735    procedure Set_Is_Power_Of_2_For_Shift
8736      (N : Node_Id; Val : Boolean := True);    -- Flag13
8737
8738    procedure Set_Is_Protected_Subprogram_Body
8739      (N : Node_Id; Val : Boolean := True);    -- Flag7
8740
8741    procedure Set_Is_Static_Coextension
8742      (N : Node_Id; Val : Boolean := True);    -- Flag14
8743
8744    procedure Set_Is_Static_Expression
8745      (N : Node_Id; Val : Boolean := True);    -- Flag6
8746
8747    procedure Set_Is_Subprogram_Descriptor
8748      (N : Node_Id; Val : Boolean := True);    -- Flag16
8749
8750    procedure Set_Is_Task_Allocation_Block
8751      (N : Node_Id; Val : Boolean := True);    -- Flag6
8752
8753    procedure Set_Is_Task_Master
8754      (N : Node_Id; Val : Boolean := True);    -- Flag5
8755
8756    procedure Set_Iteration_Scheme
8757      (N : Node_Id; Val : Node_Id);            -- Node2
8758
8759    procedure Set_Itype
8760      (N : Node_Id; Val : Entity_Id);          -- Node1
8761
8762    procedure Set_Kill_Range_Check
8763      (N : Node_Id; Val : Boolean := True);    -- Flag11
8764
8765    procedure Set_Last_Bit
8766      (N : Node_Id; Val : Node_Id);            -- Node4
8767
8768    procedure Set_Last_Name
8769      (N : Node_Id; Val : Boolean := True);    -- Flag6
8770
8771    procedure Set_Library_Unit
8772      (N : Node_Id; Val : Node_Id);            -- Node4
8773
8774    procedure Set_Label_Construct
8775      (N : Node_Id; Val : Node_Id);            -- Node2
8776
8777    procedure Set_Left_Opnd
8778      (N : Node_Id; Val : Node_Id);            -- Node2
8779
8780    procedure Set_Limited_View_Installed
8781      (N : Node_Id; Val : Boolean := True);    -- Flag18
8782
8783    procedure Set_Limited_Present
8784      (N : Node_Id; Val : Boolean := True);    -- Flag17
8785
8786    procedure Set_Literals
8787      (N : Node_Id; Val : List_Id);            -- List1
8788
8789    procedure Set_Local_Raise_Not_OK
8790      (N : Node_Id; Val : Boolean := True);    -- Flag7
8791
8792    procedure Set_Local_Raise_Statements
8793      (N : Node_Id; Val : Elist_Id);           -- Elist1
8794
8795    procedure Set_Loop_Actions
8796      (N : Node_Id; Val : List_Id);            -- List2
8797
8798    procedure Set_Loop_Parameter_Specification
8799      (N : Node_Id; Val : Node_Id);            -- Node4
8800
8801    procedure Set_Low_Bound
8802      (N : Node_Id; Val : Node_Id);            -- Node1
8803
8804    procedure Set_Mod_Clause
8805      (N : Node_Id; Val : Node_Id);            -- Node2
8806
8807    procedure Set_More_Ids
8808      (N : Node_Id; Val : Boolean := True);    -- Flag5
8809
8810    procedure Set_Must_Be_Byte_Aligned
8811      (N : Node_Id; Val : Boolean := True);    -- Flag14
8812
8813    procedure Set_Must_Not_Freeze
8814      (N : Node_Id; Val : Boolean := True);    -- Flag8
8815
8816    procedure Set_Must_Not_Override
8817      (N : Node_Id; Val : Boolean := True);    -- Flag15
8818
8819    procedure Set_Must_Override
8820      (N : Node_Id; Val : Boolean := True);    -- Flag14
8821
8822    procedure Set_Name
8823      (N : Node_Id; Val : Node_Id);            -- Node2
8824
8825    procedure Set_Names
8826      (N : Node_Id; Val : List_Id);            -- List2
8827
8828    procedure Set_Next_Entity
8829      (N : Node_Id; Val : Node_Id);            -- Node2
8830
8831    procedure Set_Next_Named_Actual
8832      (N : Node_Id; Val : Node_Id);            -- Node4
8833
8834    procedure Set_Next_Rep_Item
8835      (N : Node_Id; Val : Node_Id);            -- Node5
8836
8837    procedure Set_Next_Use_Clause
8838      (N : Node_Id; Val : Node_Id);            -- Node3
8839
8840    procedure Set_No_Ctrl_Actions
8841      (N : Node_Id; Val : Boolean := True);    -- Flag7
8842
8843    procedure Set_No_Elaboration_Check
8844      (N : Node_Id; Val : Boolean := True);    -- Flag14
8845
8846    procedure Set_No_Entities_Ref_In_Spec
8847      (N : Node_Id; Val : Boolean := True);    -- Flag8
8848
8849    procedure Set_No_Initialization
8850      (N : Node_Id; Val : Boolean := True);    -- Flag13
8851
8852    procedure Set_No_Truncation
8853      (N : Node_Id; Val : Boolean := True);    -- Flag17
8854
8855    procedure Set_Null_Present
8856      (N : Node_Id; Val : Boolean := True);    -- Flag13
8857
8858    procedure Set_Null_Exclusion_Present
8859      (N : Node_Id; Val : Boolean := True);    -- Flag11
8860
8861    procedure Set_Null_Record_Present
8862      (N : Node_Id; Val : Boolean := True);    -- Flag17
8863
8864    procedure Set_Object_Definition
8865      (N : Node_Id; Val : Node_Id);            -- Node4
8866
8867    procedure Set_Original_Discriminant
8868      (N : Node_Id; Val : Node_Id);            -- Node2
8869
8870    procedure Set_Original_Entity
8871      (N : Node_Id; Val : Entity_Id);          -- Node2
8872
8873    procedure Set_Others_Discrete_Choices
8874      (N : Node_Id; Val : List_Id);            -- List1
8875
8876    procedure Set_Out_Present
8877      (N : Node_Id; Val : Boolean := True);    -- Flag17
8878
8879    procedure Set_Parameter_Associations
8880      (N : Node_Id; Val : List_Id);            -- List3
8881
8882    procedure Set_Parameter_List_Truncated
8883      (N : Node_Id; Val : Boolean := True);    -- Flag17
8884
8885    procedure Set_Parameter_Specifications
8886      (N : Node_Id; Val : List_Id);            -- List3
8887
8888    procedure Set_Parameter_Type
8889      (N : Node_Id; Val : Node_Id);            -- Node2
8890
8891    procedure Set_Parent_Spec
8892      (N : Node_Id; Val : Node_Id);            -- Node4
8893
8894    procedure Set_Position
8895      (N : Node_Id; Val : Node_Id);            -- Node2
8896
8897    procedure Set_Pragma_Argument_Associations
8898      (N : Node_Id; Val : List_Id);            -- List2
8899
8900    procedure Set_Pragmas_After
8901      (N : Node_Id; Val : List_Id);            -- List5
8902
8903    procedure Set_Pragmas_Before
8904      (N : Node_Id; Val : List_Id);            -- List4
8905
8906    procedure Set_Prefix
8907      (N : Node_Id; Val : Node_Id);            -- Node3
8908
8909    procedure Set_Present_Expr
8910      (N : Node_Id; Val : Uint);               -- Uint3
8911
8912    procedure Set_Prev_Ids
8913      (N : Node_Id; Val : Boolean := True);    -- Flag6
8914
8915    procedure Set_Print_In_Hex
8916      (N : Node_Id; Val : Boolean := True);    -- Flag13
8917
8918    procedure Set_Private_Declarations
8919      (N : Node_Id; Val : List_Id);            -- List3
8920
8921    procedure Set_Private_Present
8922      (N : Node_Id; Val : Boolean := True);    -- Flag15
8923
8924    procedure Set_Procedure_To_Call
8925      (N : Node_Id; Val : Node_Id);            -- Node2
8926
8927    procedure Set_Proper_Body
8928      (N : Node_Id; Val : Node_Id);            -- Node1
8929
8930    procedure Set_Protected_Definition
8931      (N : Node_Id; Val : Node_Id);            -- Node3
8932
8933    procedure Set_Protected_Present
8934      (N : Node_Id; Val : Boolean := True);    -- Flag6
8935
8936    procedure Set_Raises_Constraint_Error
8937      (N : Node_Id; Val : Boolean := True);    -- Flag7
8938
8939    procedure Set_Range_Constraint
8940      (N : Node_Id; Val : Node_Id);            -- Node4
8941
8942    procedure Set_Range_Expression
8943      (N : Node_Id; Val : Node_Id);            -- Node4
8944
8945    procedure Set_Real_Range_Specification
8946      (N : Node_Id; Val : Node_Id);            -- Node4
8947
8948    procedure Set_Realval
8949      (N : Node_Id; Val : Ureal);              -- Ureal3
8950
8951    procedure Set_Reason
8952      (N : Node_Id; Val : Uint);               -- Uint3
8953
8954    procedure Set_Record_Extension_Part
8955      (N : Node_Id; Val : Node_Id);            -- Node3
8956
8957    procedure Set_Redundant_Use
8958      (N : Node_Id; Val : Boolean := True);    -- Flag13
8959
8960    procedure Set_Renaming_Exception
8961      (N : Node_Id; Val : Node_Id);            -- Node2
8962
8963    procedure Set_Result_Definition
8964      (N : Node_Id; Val : Node_Id);            -- Node4
8965
8966    procedure Set_Return_Object_Declarations
8967      (N : Node_Id; Val : List_Id);            -- List3
8968
8969    procedure Set_Return_Statement_Entity
8970      (N : Node_Id; Val : Node_Id);            -- Node5
8971
8972    procedure Set_Reverse_Present
8973      (N : Node_Id; Val : Boolean := True);    -- Flag15
8974
8975    procedure Set_Right_Opnd
8976      (N : Node_Id; Val : Node_Id);            -- Node3
8977
8978    procedure Set_Rounded_Result
8979      (N : Node_Id; Val : Boolean := True);    -- Flag18
8980
8981    procedure Set_Scope
8982      (N : Node_Id; Val : Node_Id);            -- Node3
8983
8984    procedure Set_Select_Alternatives
8985      (N : Node_Id; Val : List_Id);            -- List1
8986
8987    procedure Set_Selector_Name
8988      (N : Node_Id; Val : Node_Id);            -- Node2
8989
8990    procedure Set_Selector_Names
8991      (N : Node_Id; Val : List_Id);            -- List1
8992
8993    procedure Set_Shift_Count_OK
8994      (N : Node_Id; Val : Boolean := True);    -- Flag4
8995
8996    procedure Set_Source_Type
8997      (N : Node_Id; Val : Entity_Id);          -- Node1
8998
8999    procedure Set_Specification
9000      (N : Node_Id; Val : Node_Id);            -- Node1
9001
9002    procedure Set_Statements
9003      (N : Node_Id; Val : List_Id);            -- List3
9004
9005    procedure Set_Static_Processing_OK
9006      (N : Node_Id; Val : Boolean);            -- Flag4
9007
9008    procedure Set_Storage_Pool
9009      (N : Node_Id; Val : Node_Id);            -- Node1
9010
9011    procedure Set_Strval
9012      (N : Node_Id; Val : String_Id);          -- Str3
9013
9014    procedure Set_Subtype_Indication
9015      (N : Node_Id; Val : Node_Id);            -- Node5
9016
9017    procedure Set_Subtype_Mark
9018      (N : Node_Id; Val : Node_Id);            -- Node4
9019
9020    procedure Set_Subtype_Marks
9021      (N : Node_Id; Val : List_Id);            -- List2
9022
9023    procedure Set_Synchronized_Present
9024      (N : Node_Id; Val : Boolean := True);    -- Flag7
9025
9026    procedure Set_Tagged_Present
9027      (N : Node_Id; Val : Boolean := True);    -- Flag15
9028
9029    procedure Set_Target_Type
9030      (N : Node_Id; Val : Entity_Id);          -- Node2
9031
9032    procedure Set_Task_Definition
9033      (N : Node_Id; Val : Node_Id);            -- Node3
9034
9035    procedure Set_Task_Present
9036      (N : Node_Id; Val : Boolean := True);    -- Flag5
9037
9038    procedure Set_Then_Actions
9039      (N : Node_Id; Val : List_Id);            -- List2
9040
9041    procedure Set_Then_Statements
9042      (N : Node_Id; Val : List_Id);            -- List2
9043
9044    procedure Set_Treat_Fixed_As_Integer
9045      (N : Node_Id; Val : Boolean := True);    -- Flag14
9046
9047    procedure Set_Triggering_Alternative
9048      (N : Node_Id; Val : Node_Id);            -- Node1
9049
9050    procedure Set_Triggering_Statement
9051      (N : Node_Id; Val : Node_Id);            -- Node1
9052
9053    procedure Set_TSS_Elist
9054      (N : Node_Id; Val : Elist_Id);           -- Elist3
9055
9056    procedure Set_Type_Definition
9057      (N : Node_Id; Val : Node_Id);            -- Node3
9058
9059    procedure Set_Unit
9060      (N : Node_Id; Val : Node_Id);            -- Node2
9061
9062    procedure Set_Unknown_Discriminants_Present
9063      (N : Node_Id; Val : Boolean := True);    -- Flag13
9064
9065    procedure Set_Unreferenced_In_Spec
9066      (N : Node_Id; Val : Boolean := True);    -- Flag7
9067
9068    procedure Set_Variant_Part
9069      (N : Node_Id; Val : Node_Id);            -- Node4
9070
9071    procedure Set_Variants
9072      (N : Node_Id; Val : List_Id);            -- List1
9073
9074    procedure Set_Visible_Declarations
9075      (N : Node_Id; Val : List_Id);            -- List2
9076
9077    procedure Set_Was_Originally_Stub
9078      (N : Node_Id; Val : Boolean := True);    -- Flag13
9079
9080    procedure Set_Zero_Cost_Handling
9081      (N : Node_Id; Val : Boolean := True);    -- Flag5
9082
9083    -------------------------
9084    -- Iterator Procedures --
9085    -------------------------
9086
9087    --  The call to Next_xxx (N) is equivalent to N := Next_xxx (N)
9088
9089    procedure Next_Entity       (N : in out Node_Id);
9090    procedure Next_Named_Actual (N : in out Node_Id);
9091    procedure Next_Rep_Item     (N : in out Node_Id);
9092    procedure Next_Use_Clause   (N : in out Node_Id);
9093
9094    --------------------------------------
9095    -- Logical Access to End_Span Field --
9096    --------------------------------------
9097
9098    function End_Location (N : Node_Id) return Source_Ptr;
9099    --  N is an N_If_Statement or N_Case_Statement node, and this
9100    --  function returns the location of the IF token in the END IF
9101    --  sequence by translating the value of the End_Span field.
9102
9103    procedure Set_End_Location (N : Node_Id; S : Source_Ptr);
9104    --  N is an N_If_Statement or N_Case_Statement node. This procedure
9105    --  sets the End_Span field to correspond to the given value S. In
9106    --  other words, End_Span is set to the difference between S and
9107    --  Sloc (N), the starting location.
9108
9109    -----------------------------
9110    -- Syntactic Parent Tables --
9111    -----------------------------
9112
9113    --  These tables show for each node, and for each of the five fields,
9114    --  whether the corresponding field is syntactic (True) or semantic (False).
9115    --  Unused entries are also set to False.
9116
9117    subtype Field_Num is Natural range 1 .. 5;
9118
9119    Is_Syntactic_Field : constant array (Node_Kind, Field_Num) of Boolean := (
9120
9121    --  Following entries can be built automatically from the sinfo sources
9122    --  using the makeisf utility (currently this program is in spitbol).
9123
9124      N_Identifier =>
9125        (1 => True,    --  Chars (Name1)
9126         2 => False,   --  Original_Discriminant (Node2-Sem)
9127         3 => False,   --  unused
9128         4 => False,   --  Entity (Node4-Sem)
9129         5 => False),  --  Etype (Node5-Sem)
9130
9131      N_Integer_Literal =>
9132        (1 => False,   --  unused
9133         2 => False,   --  Original_Entity (Node2-Sem)
9134         3 => True,    --  Intval (Uint3)
9135         4 => False,   --  unused
9136         5 => False),  --  Etype (Node5-Sem)
9137
9138      N_Real_Literal =>
9139        (1 => False,   --  unused
9140         2 => False,   --  Original_Entity (Node2-Sem)
9141         3 => True,    --  Realval (Ureal3)
9142         4 => False,   --  Corresponding_Integer_Value (Uint4-Sem)
9143         5 => False),  --  Etype (Node5-Sem)
9144
9145      N_Character_Literal =>
9146        (1 => True,    --  Chars (Name1)
9147         2 => True,    --  Char_Literal_Value (Uint2)
9148         3 => False,   --  unused
9149         4 => False,   --  Entity (Node4-Sem)
9150         5 => False),  --  Etype (Node5-Sem)
9151
9152      N_String_Literal =>
9153        (1 => False,   --  unused
9154         2 => False,   --  unused
9155         3 => True,    --  Strval (Str3)
9156         4 => False,   --  unused
9157         5 => False),  --  Etype (Node5-Sem)
9158
9159      N_Pragma =>
9160        (1 => True,    --  Chars (Name1)
9161         2 => True,    --  Pragma_Argument_Associations (List2)
9162         3 => True,    --  Debug_Statement (Node3)
9163         4 => False,   --  Entity (Node4-Sem)
9164         5 => False),  --  Next_Rep_Item (Node5-Sem)
9165
9166      N_Pragma_Argument_Association =>
9167        (1 => True,    --  Chars (Name1)
9168         2 => False,   --  unused
9169         3 => True,    --  Expression (Node3)
9170         4 => False,   --  unused
9171         5 => False),  --  unused
9172
9173      N_Defining_Identifier =>
9174        (1 => True,    --  Chars (Name1)
9175         2 => False,   --  Next_Entity (Node2-Sem)
9176         3 => False,   --  Scope (Node3-Sem)
9177         4 => False,   --  unused
9178         5 => False),  --  Etype (Node5-Sem)
9179
9180      N_Full_Type_Declaration =>
9181        (1 => True,    --  Defining_Identifier (Node1)
9182         2 => False,   --  unused
9183         3 => True,    --  Type_Definition (Node3)
9184         4 => True,    --  Discriminant_Specifications (List4)
9185         5 => False),  --  unused
9186
9187      N_Subtype_Declaration =>
9188        (1 => True,    --  Defining_Identifier (Node1)
9189         2 => False,   --  unused
9190         3 => False,   --  unused
9191         4 => False,   --  Generic_Parent_Type (Node4-Sem)
9192         5 => True),   --  Subtype_Indication (Node5)
9193
9194      N_Subtype_Indication =>
9195        (1 => False,   --  unused
9196         2 => False,   --  unused
9197         3 => True,    --  Constraint (Node3)
9198         4 => True,    --  Subtype_Mark (Node4)
9199         5 => False),  --  Etype (Node5-Sem)
9200
9201      N_Object_Declaration =>
9202        (1 => True,    --  Defining_Identifier (Node1)
9203         2 => False,   --  Handler_List_Entry (Node2-Sem)
9204         3 => True,    --  Expression (Node3)
9205         4 => True,    --  Object_Definition (Node4)
9206         5 => False),  --  Corresponding_Generic_Association (Node5-Sem)
9207
9208      N_Number_Declaration =>
9209        (1 => True,    --  Defining_Identifier (Node1)
9210         2 => False,   --  unused
9211         3 => True,    --  Expression (Node3)
9212         4 => False,   --  unused
9213         5 => False),  --  unused
9214
9215      N_Derived_Type_Definition =>
9216        (1 => False,   --  unused
9217         2 => True,    --  Interface_List (List2)
9218         3 => True,    --  Record_Extension_Part (Node3)
9219         4 => False,   --  unused
9220         5 => True),   --  Subtype_Indication (Node5)
9221
9222      N_Range_Constraint =>
9223        (1 => False,   --  unused
9224         2 => False,   --  unused
9225         3 => False,   --  unused
9226         4 => True,    --  Range_Expression (Node4)
9227         5 => False),  --  unused
9228
9229      N_Range =>
9230        (1 => True,    --  Low_Bound (Node1)
9231         2 => True,    --  High_Bound (Node2)
9232         3 => False,   --  unused
9233         4 => False,   --  unused
9234         5 => False),  --  Etype (Node5-Sem)
9235
9236      N_Enumeration_Type_Definition =>
9237        (1 => True,    --  Literals (List1)
9238         2 => False,   --  unused
9239         3 => False,   --  unused
9240         4 => True,    --  End_Label (Node4)
9241         5 => False),  --  unused
9242
9243      N_Defining_Character_Literal =>
9244        (1 => True,    --  Chars (Name1)
9245         2 => False,   --  Next_Entity (Node2-Sem)
9246         3 => False,   --  Scope (Node3-Sem)
9247         4 => False,   --  unused
9248         5 => False),  --  Etype (Node5-Sem)
9249
9250      N_Signed_Integer_Type_Definition =>
9251        (1 => True,    --  Low_Bound (Node1)
9252         2 => True,    --  High_Bound (Node2)
9253         3 => False,   --  unused
9254         4 => False,   --  unused
9255         5 => False),  --  unused
9256
9257      N_Modular_Type_Definition =>
9258        (1 => False,   --  unused
9259         2 => False,   --  unused
9260         3 => True,    --  Expression (Node3)
9261         4 => False,   --  unused
9262         5 => False),  --  unused
9263
9264      N_Floating_Point_Definition =>
9265        (1 => False,   --  unused
9266         2 => True,    --  Digits_Expression (Node2)
9267         3 => False,   --  unused
9268         4 => True,    --  Real_Range_Specification (Node4)
9269         5 => False),  --  unused
9270
9271      N_Real_Range_Specification =>
9272        (1 => True,    --  Low_Bound (Node1)
9273         2 => True,    --  High_Bound (Node2)
9274         3 => False,   --  unused
9275         4 => False,   --  unused
9276         5 => False),  --  unused
9277
9278      N_Ordinary_Fixed_Point_Definition =>
9279        (1 => False,   --  unused
9280         2 => False,   --  unused
9281         3 => True,    --  Delta_Expression (Node3)
9282         4 => True,    --  Real_Range_Specification (Node4)
9283         5 => False),  --  unused
9284
9285      N_Decimal_Fixed_Point_Definition =>
9286        (1 => False,   --  unused
9287         2 => True,    --  Digits_Expression (Node2)
9288         3 => True,    --  Delta_Expression (Node3)
9289         4 => True,    --  Real_Range_Specification (Node4)
9290         5 => False),  --  unused
9291
9292      N_Digits_Constraint =>
9293        (1 => False,   --  unused
9294         2 => True,    --  Digits_Expression (Node2)
9295         3 => False,   --  unused
9296         4 => True,    --  Range_Constraint (Node4)
9297         5 => False),  --  unused
9298
9299      N_Unconstrained_Array_Definition =>
9300        (1 => False,   --  unused
9301         2 => True,    --  Subtype_Marks (List2)
9302         3 => False,   --  unused
9303         4 => True,    --  Component_Definition (Node4)
9304         5 => False),  --  unused
9305
9306      N_Constrained_Array_Definition =>
9307        (1 => False,   --  unused
9308         2 => True,    --  Discrete_Subtype_Definitions (List2)
9309         3 => False,   --  unused
9310         4 => True,    --  Component_Definition (Node4)
9311         5 => False),  --  unused
9312
9313      N_Component_Definition =>
9314        (1 => False,   --  unused
9315         2 => False,   --  unused
9316         3 => True,    --  Access_Definition (Node3)
9317         4 => False,   --  unused
9318         5 => True),   --  Subtype_Indication (Node5)
9319
9320      N_Discriminant_Specification =>
9321        (1 => True,    --  Defining_Identifier (Node1)
9322         2 => False,   --  unused
9323         3 => True,    --  Expression (Node3)
9324         4 => False,   --  unused
9325         5 => True),   --  Discriminant_Type (Node5)
9326
9327      N_Index_Or_Discriminant_Constraint =>
9328        (1 => True,    --  Constraints (List1)
9329         2 => False,   --  unused
9330         3 => False,   --  unused
9331         4 => False,   --  unused
9332         5 => False),  --  unused
9333
9334      N_Discriminant_Association =>
9335        (1 => True,    --  Selector_Names (List1)
9336         2 => False,   --  unused
9337         3 => True,    --  Expression (Node3)
9338         4 => False,   --  unused
9339         5 => False),  --  unused
9340
9341      N_Record_Definition =>
9342        (1 => True,    --  Component_List (Node1)
9343         2 => True,    --  Interface_List (List2)
9344         3 => False,   --  unused
9345         4 => True,    --  End_Label (Node4)
9346         5 => False),  --  unused
9347
9348      N_Component_List =>
9349        (1 => False,   --  unused
9350         2 => False,   --  unused
9351         3 => True,    --  Component_Items (List3)
9352         4 => True,    --  Variant_Part (Node4)
9353         5 => False),  --  unused
9354
9355      N_Component_Declaration =>
9356        (1 => True,    --  Defining_Identifier (Node1)
9357         2 => False,   --  unused
9358         3 => True,    --  Expression (Node3)
9359         4 => True,    --  Component_Definition (Node4)
9360         5 => False),  --  unused
9361
9362      N_Variant_Part =>
9363        (1 => True,    --  Variants (List1)
9364         2 => True,    --  Name (Node2)
9365         3 => False,   --  unused
9366         4 => False,   --  unused
9367         5 => False),  --  unused
9368
9369      N_Variant =>
9370        (1 => True,    --  Component_List (Node1)
9371         2 => False,   --  Enclosing_Variant (Node2-Sem)
9372         3 => False,   --  Present_Expr (Uint3-Sem)
9373         4 => True,    --  Discrete_Choices (List4)
9374         5 => False),  --  Dcheck_Function (Node5-Sem)
9375
9376      N_Others_Choice =>
9377        (1 => False,   --  Others_Discrete_Choices (List1-Sem)
9378         2 => False,   --  unused
9379         3 => False,   --  unused
9380         4 => False,   --  unused
9381         5 => False),  --  unused
9382
9383      N_Access_To_Object_Definition =>
9384        (1 => False,   --  unused
9385         2 => False,   --  unused
9386         3 => False,   --  unused
9387         4 => False,   --  unused
9388         5 => True),   --  Subtype_Indication (Node5)
9389
9390      N_Access_Function_Definition =>
9391        (1 => False,   --  unused
9392         2 => False,   --  unused
9393         3 => True,    --  Parameter_Specifications (List3)
9394         4 => True,    --  Result_Definition (Node4)
9395         5 => False),  --  unused
9396
9397      N_Access_Procedure_Definition =>
9398        (1 => False,   --  unused
9399         2 => False,   --  unused
9400         3 => True,    --  Parameter_Specifications (List3)
9401         4 => False,   --  unused
9402         5 => False),  --  unused
9403
9404      N_Access_Definition =>
9405        (1 => False,   --  unused
9406         2 => False,   --  unused
9407         3 => True,    --  Access_To_Subprogram_Definition (Node3)
9408         4 => True,    --  Subtype_Mark (Node4)
9409         5 => False),  --  unused
9410
9411      N_Incomplete_Type_Declaration =>
9412        (1 => True,    --  Defining_Identifier (Node1)
9413         2 => False,   --  unused
9414         3 => False,   --  unused
9415         4 => True,    --  Discriminant_Specifications (List4)
9416         5 => False),  --  unused
9417
9418      N_Explicit_Dereference =>
9419        (1 => False,   --  unused
9420         2 => False,   --  unused
9421         3 => True,    --  Prefix (Node3)
9422         4 => False,   --  Actual_Designated_Subtype (Node4-Sem)
9423         5 => False),  --  Etype (Node5-Sem)
9424
9425      N_Indexed_Component =>
9426        (1 => True,    --  Expressions (List1)
9427         2 => False,   --  unused
9428         3 => True,    --  Prefix (Node3)
9429         4 => False,   --  unused
9430         5 => False),  --  Etype (Node5-Sem)
9431
9432      N_Slice =>
9433        (1 => False,   --  unused
9434         2 => False,   --  unused
9435         3 => True,    --  Prefix (Node3)
9436         4 => True,    --  Discrete_Range (Node4)
9437         5 => False),  --  Etype (Node5-Sem)
9438
9439      N_Selected_Component =>
9440        (1 => False,   --  unused
9441         2 => True,    --  Selector_Name (Node2)
9442         3 => True,    --  Prefix (Node3)
9443         4 => False,   --  unused
9444         5 => False),  --  Etype (Node5-Sem)
9445
9446      N_Attribute_Reference =>
9447        (1 => True,    --  Expressions (List1)
9448         2 => True,    --  Attribute_Name (Name2)
9449         3 => True,    --  Prefix (Node3)
9450         4 => False,   --  Entity (Node4-Sem)
9451         5 => False),  --  Etype (Node5-Sem)
9452
9453      N_Aggregate =>
9454        (1 => True,    --  Expressions (List1)
9455         2 => True,    --  Component_Associations (List2)
9456         3 => False,   --  Aggregate_Bounds (Node3-Sem)
9457         4 => False,   --  unused
9458         5 => False),  --  Etype (Node5-Sem)
9459
9460      N_Component_Association =>
9461        (1 => True,    --  Choices (List1)
9462         2 => False,   --  Loop_Actions (List2-Sem)
9463         3 => True,    --  Expression (Node3)
9464         4 => False,   --  unused
9465         5 => False),  --  unused
9466
9467      N_Extension_Aggregate =>
9468        (1 => True,    --  Expressions (List1)
9469         2 => True,    --  Component_Associations (List2)
9470         3 => True,    --  Ancestor_Part (Node3)
9471         4 => False,   --  unused
9472         5 => False),  --  Etype (Node5-Sem)
9473
9474      N_Null =>
9475        (1 => False,   --  unused
9476         2 => False,   --  unused
9477         3 => False,   --  unused
9478         4 => False,   --  unused
9479         5 => False),  --  Etype (Node5-Sem)
9480
9481      N_And_Then =>
9482        (1 => False,   --  Actions (List1-Sem)
9483         2 => True,    --  Left_Opnd (Node2)
9484         3 => True,    --  Right_Opnd (Node3)
9485         4 => False,   --  unused
9486         5 => False),  --  Etype (Node5-Sem)
9487
9488      N_Or_Else =>
9489        (1 => False,   --  Actions (List1-Sem)
9490         2 => True,    --  Left_Opnd (Node2)
9491         3 => True,    --  Right_Opnd (Node3)
9492         4 => False,   --  unused
9493         5 => False),  --  Etype (Node5-Sem)
9494
9495      N_In =>
9496        (1 => False,   --  unused
9497         2 => True,    --  Left_Opnd (Node2)
9498         3 => True,    --  Right_Opnd (Node3)
9499         4 => False,   --  unused
9500         5 => False),  --  Etype (Node5-Sem)
9501
9502      N_Not_In =>
9503        (1 => False,   --  unused
9504         2 => True,    --  Left_Opnd (Node2)
9505         3 => True,    --  Right_Opnd (Node3)
9506         4 => False,   --  unused
9507         5 => False),  --  Etype (Node5-Sem)
9508
9509      N_Op_And =>
9510        (1 => True,    --  Chars (Name1)
9511         2 => True,    --  Left_Opnd (Node2)
9512         3 => True,    --  Right_Opnd (Node3)
9513         4 => False,   --  Entity (Node4-Sem)
9514         5 => False),  --  Etype (Node5-Sem)
9515
9516      N_Op_Or =>
9517        (1 => True,    --  Chars (Name1)
9518         2 => True,    --  Left_Opnd (Node2)
9519         3 => True,    --  Right_Opnd (Node3)
9520         4 => False,   --  Entity (Node4-Sem)
9521         5 => False),  --  Etype (Node5-Sem)
9522
9523      N_Op_Xor =>
9524        (1 => True,    --  Chars (Name1)
9525         2 => True,    --  Left_Opnd (Node2)
9526         3 => True,    --  Right_Opnd (Node3)
9527         4 => False,   --  Entity (Node4-Sem)
9528         5 => False),  --  Etype (Node5-Sem)
9529
9530      N_Op_Eq =>
9531        (1 => True,    --  Chars (Name1)
9532         2 => True,    --  Left_Opnd (Node2)
9533         3 => True,    --  Right_Opnd (Node3)
9534         4 => False,   --  Entity (Node4-Sem)
9535         5 => False),  --  Etype (Node5-Sem)
9536
9537      N_Op_Ne =>
9538        (1 => True,    --  Chars (Name1)
9539         2 => True,    --  Left_Opnd (Node2)
9540         3 => True,    --  Right_Opnd (Node3)
9541         4 => False,   --  Entity (Node4-Sem)
9542         5 => False),  --  Etype (Node5-Sem)
9543
9544      N_Op_Lt =>
9545        (1 => True,    --  Chars (Name1)
9546         2 => True,    --  Left_Opnd (Node2)
9547         3 => True,    --  Right_Opnd (Node3)
9548         4 => False,   --  Entity (Node4-Sem)
9549         5 => False),  --  Etype (Node5-Sem)
9550
9551      N_Op_Le =>
9552        (1 => True,    --  Chars (Name1)
9553         2 => True,    --  Left_Opnd (Node2)
9554         3 => True,    --  Right_Opnd (Node3)
9555         4 => False,   --  Entity (Node4-Sem)
9556         5 => False),  --  Etype (Node5-Sem)
9557
9558      N_Op_Gt =>
9559        (1 => True,    --  Chars (Name1)
9560         2 => True,    --  Left_Opnd (Node2)
9561         3 => True,    --  Right_Opnd (Node3)
9562         4 => False,   --  Entity (Node4-Sem)
9563         5 => False),  --  Etype (Node5-Sem)
9564
9565      N_Op_Ge =>
9566        (1 => True,    --  Chars (Name1)
9567         2 => True,    --  Left_Opnd (Node2)
9568         3 => True,    --  Right_Opnd (Node3)
9569         4 => False,   --  Entity (Node4-Sem)
9570         5 => False),  --  Etype (Node5-Sem)
9571
9572      N_Op_Add =>
9573        (1 => True,    --  Chars (Name1)
9574         2 => True,    --  Left_Opnd (Node2)
9575         3 => True,    --  Right_Opnd (Node3)
9576         4 => False,   --  Entity (Node4-Sem)
9577         5 => False),  --  Etype (Node5-Sem)
9578
9579      N_Op_Subtract =>
9580        (1 => True,    --  Chars (Name1)
9581         2 => True,    --  Left_Opnd (Node2)
9582         3 => True,    --  Right_Opnd (Node3)
9583         4 => False,   --  Entity (Node4-Sem)
9584         5 => False),  --  Etype (Node5-Sem)
9585
9586      N_Op_Concat =>
9587        (1 => True,    --  Chars (Name1)
9588         2 => True,    --  Left_Opnd (Node2)
9589         3 => True,    --  Right_Opnd (Node3)
9590         4 => False,   --  Entity (Node4-Sem)
9591         5 => False),  --  Etype (Node5-Sem)
9592
9593      N_Op_Multiply =>
9594        (1 => True,    --  Chars (Name1)
9595         2 => True,    --  Left_Opnd (Node2)
9596         3 => True,    --  Right_Opnd (Node3)
9597         4 => False,   --  Entity (Node4-Sem)
9598         5 => False),  --  Etype (Node5-Sem)
9599
9600      N_Op_Divide =>
9601        (1 => True,    --  Chars (Name1)
9602         2 => True,    --  Left_Opnd (Node2)
9603         3 => True,    --  Right_Opnd (Node3)
9604         4 => False,   --  Entity (Node4-Sem)
9605         5 => False),  --  Etype (Node5-Sem)
9606
9607      N_Op_Mod =>
9608        (1 => True,    --  Chars (Name1)
9609         2 => True,    --  Left_Opnd (Node2)
9610         3 => True,    --  Right_Opnd (Node3)
9611         4 => False,   --  Entity (Node4-Sem)
9612         5 => False),  --  Etype (Node5-Sem)
9613
9614      N_Op_Rem =>
9615        (1 => True,    --  Chars (Name1)
9616         2 => True,    --  Left_Opnd (Node2)
9617         3 => True,    --  Right_Opnd (Node3)
9618         4 => False,   --  Entity (Node4-Sem)
9619         5 => False),  --  Etype (Node5-Sem)
9620
9621      N_Op_Expon =>
9622        (1 => True,    --  Chars (Name1)
9623         2 => True,    --  Left_Opnd (Node2)
9624         3 => True,    --  Right_Opnd (Node3)
9625         4 => False,   --  Entity (Node4-Sem)
9626         5 => False),  --  Etype (Node5-Sem)
9627
9628      N_Op_Plus =>
9629        (1 => True,    --  Chars (Name1)
9630         2 => False,   --  unused
9631         3 => True,    --  Right_Opnd (Node3)
9632         4 => False,   --  Entity (Node4-Sem)
9633         5 => False),  --  Etype (Node5-Sem)
9634
9635      N_Op_Minus =>
9636        (1 => True,    --  Chars (Name1)
9637         2 => False,   --  unused
9638         3 => True,    --  Right_Opnd (Node3)
9639         4 => False,   --  Entity (Node4-Sem)
9640         5 => False),  --  Etype (Node5-Sem)
9641
9642      N_Op_Abs =>
9643        (1 => True,    --  Chars (Name1)
9644         2 => False,   --  unused
9645         3 => True,    --  Right_Opnd (Node3)
9646         4 => False,   --  Entity (Node4-Sem)
9647         5 => False),  --  Etype (Node5-Sem)
9648
9649      N_Op_Not =>
9650        (1 => True,    --  Chars (Name1)
9651         2 => False,   --  unused
9652         3 => True,    --  Right_Opnd (Node3)
9653         4 => False,   --  Entity (Node4-Sem)
9654         5 => False),  --  Etype (Node5-Sem)
9655
9656      N_Type_Conversion =>
9657        (1 => False,   --  unused
9658         2 => False,   --  unused
9659         3 => True,    --  Expression (Node3)
9660         4 => True,    --  Subtype_Mark (Node4)
9661         5 => False),  --  Etype (Node5-Sem)
9662
9663      N_Qualified_Expression =>
9664        (1 => False,   --  unused
9665         2 => False,   --  unused
9666         3 => True,    --  Expression (Node3)
9667         4 => True,    --  Subtype_Mark (Node4)
9668         5 => False),  --  Etype (Node5-Sem)
9669
9670      N_Allocator =>
9671        (1 => False,   --  Storage_Pool (Node1-Sem)
9672         2 => False,   --  Procedure_To_Call (Node2-Sem)
9673         3 => True,    --  Expression (Node3)
9674         4 => False,   --  Coextensions (Elist4-Sem)
9675         5 => False),  --  Etype (Node5-Sem)
9676
9677      N_Null_Statement =>
9678        (1 => False,   --  unused
9679         2 => False,   --  unused
9680         3 => False,   --  unused
9681         4 => False,   --  unused
9682         5 => False),  --  unused
9683
9684      N_Label =>
9685        (1 => True,    --  Identifier (Node1)
9686         2 => False,   --  unused
9687         3 => False,   --  unused
9688         4 => False,   --  unused
9689         5 => False),  --  unused
9690
9691      N_Assignment_Statement =>
9692        (1 => False,   --  unused
9693         2 => True,    --  Name (Node2)
9694         3 => True,    --  Expression (Node3)
9695         4 => False,   --  unused
9696         5 => False),  --  unused
9697
9698      N_If_Statement =>
9699        (1 => True,    --  Condition (Node1)
9700         2 => True,    --  Then_Statements (List2)
9701         3 => True,    --  Elsif_Parts (List3)
9702         4 => True,    --  Else_Statements (List4)
9703         5 => True),   --  End_Span (Uint5)
9704
9705      N_Elsif_Part =>
9706        (1 => True,    --  Condition (Node1)
9707         2 => True,    --  Then_Statements (List2)
9708         3 => False,   --  Condition_Actions (List3-Sem)
9709         4 => False,   --  unused
9710         5 => False),  --  unused
9711
9712      N_Case_Statement =>
9713        (1 => False,   --  unused
9714         2 => False,   --  unused
9715         3 => True,    --  Expression (Node3)
9716         4 => True,    --  Alternatives (List4)
9717         5 => True),   --  End_Span (Uint5)
9718
9719      N_Case_Statement_Alternative =>
9720        (1 => False,   --  unused
9721         2 => False,   --  unused
9722         3 => True,    --  Statements (List3)
9723         4 => True,    --  Discrete_Choices (List4)
9724         5 => False),  --  unused
9725
9726      N_Loop_Statement =>
9727        (1 => True,    --  Identifier (Node1)
9728         2 => True,    --  Iteration_Scheme (Node2)
9729         3 => True,    --  Statements (List3)
9730         4 => True,    --  End_Label (Node4)
9731         5 => False),  --  unused
9732
9733      N_Iteration_Scheme =>
9734        (1 => True,    --  Condition (Node1)
9735         2 => False,   --  unused
9736         3 => False,   --  Condition_Actions (List3-Sem)
9737         4 => True,    --  Loop_Parameter_Specification (Node4)
9738         5 => False),  --  unused
9739
9740      N_Loop_Parameter_Specification =>
9741        (1 => True,    --  Defining_Identifier (Node1)
9742         2 => False,   --  unused
9743         3 => False,   --  unused
9744         4 => True,    --  Discrete_Subtype_Definition (Node4)
9745         5 => False),  --  unused
9746
9747      N_Block_Statement =>
9748        (1 => True,    --  Identifier (Node1)
9749         2 => True,    --  Declarations (List2)
9750         3 => False,   --  Activation_Chain_Entity (Node3-Sem)
9751         4 => True,    --  Handled_Statement_Sequence (Node4)
9752         5 => False),  --  unused
9753
9754      N_Exit_Statement =>
9755        (1 => True,    --  Condition (Node1)
9756         2 => True,    --  Name (Node2)
9757         3 => False,   --  unused
9758         4 => False,   --  unused
9759         5 => False),  --  unused
9760
9761      N_Goto_Statement =>
9762        (1 => False,   --  unused
9763         2 => True,    --  Name (Node2)
9764         3 => False,   --  unused
9765         4 => False,   --  unused
9766         5 => False),  --  unused
9767
9768      N_Subprogram_Declaration =>
9769        (1 => True,    --  Specification (Node1)
9770         2 => False,   --  unused
9771         3 => False,   --  Body_To_Inline (Node3-Sem)
9772         4 => False,   --  Parent_Spec (Node4-Sem)
9773         5 => False),  --  Corresponding_Body (Node5-Sem)
9774
9775      N_Abstract_Subprogram_Declaration =>
9776        (1 => True,    --  Specification (Node1)
9777         2 => False,   --  unused
9778         3 => False,   --  unused
9779         4 => False,   --  unused
9780         5 => False),  --  unused
9781
9782      N_Function_Specification =>
9783        (1 => True,    --  Defining_Unit_Name (Node1)
9784         2 => False,   --  Elaboration_Boolean (Node2-Sem)
9785         3 => True,    --  Parameter_Specifications (List3)
9786         4 => True,    --  Result_Definition (Node4)
9787         5 => False),  --  Generic_Parent (Node5-Sem)
9788
9789      N_Procedure_Specification =>
9790        (1 => True,    --  Defining_Unit_Name (Node1)
9791         2 => False,   --  Elaboration_Boolean (Node2-Sem)
9792         3 => True,    --  Parameter_Specifications (List3)
9793         4 => False,   --  unused
9794         5 => False),  --  Generic_Parent (Node5-Sem)
9795
9796      N_Designator =>
9797        (1 => True,    --  Identifier (Node1)
9798         2 => True,    --  Name (Node2)
9799         3 => False,   --  unused
9800         4 => False,   --  unused
9801         5 => False),  --  unused
9802
9803      N_Defining_Program_Unit_Name =>
9804        (1 => True,    --  Defining_Identifier (Node1)
9805         2 => True,    --  Name (Node2)
9806         3 => False,   --  unused
9807         4 => False,   --  unused
9808         5 => False),  --  unused
9809
9810      N_Operator_Symbol =>
9811        (1 => True,    --  Chars (Name1)
9812         2 => False,   --  unused
9813         3 => True,    --  Strval (Str3)
9814         4 => False,   --  Entity (Node4-Sem)
9815         5 => False),  --  Etype (Node5-Sem)
9816
9817      N_Defining_Operator_Symbol =>
9818        (1 => True,    --  Chars (Name1)
9819         2 => False,   --  Next_Entity (Node2-Sem)
9820         3 => False,   --  Scope (Node3-Sem)
9821         4 => False,   --  unused
9822         5 => False),  --  Etype (Node5-Sem)
9823
9824      N_Parameter_Specification =>
9825        (1 => True,    --  Defining_Identifier (Node1)
9826         2 => True,    --  Parameter_Type (Node2)
9827         3 => True,    --  Expression (Node3)
9828         4 => False,   --  unused
9829         5 => False),  --  Default_Expression (Node5-Sem)
9830
9831      N_Subprogram_Body =>
9832        (1 => True,    --  Specification (Node1)
9833         2 => True,    --  Declarations (List2)
9834         3 => False,   --  Activation_Chain_Entity (Node3-Sem)
9835         4 => True,    --  Handled_Statement_Sequence (Node4)
9836         5 => False),  --  Corresponding_Spec (Node5-Sem)
9837
9838      N_Procedure_Call_Statement =>
9839        (1 => False,   --  Controlling_Argument (Node1-Sem)
9840         2 => True,    --  Name (Node2)
9841         3 => True,    --  Parameter_Associations (List3)
9842         4 => False,   --  First_Named_Actual (Node4-Sem)
9843         5 => False),  --  Etype (Node5-Sem)
9844
9845      N_Function_Call =>
9846        (1 => False,   --  Controlling_Argument (Node1-Sem)
9847         2 => True,    --  Name (Node2)
9848         3 => True,    --  Parameter_Associations (List3)
9849         4 => False,   --  First_Named_Actual (Node4-Sem)
9850         5 => False),  --  Etype (Node5-Sem)
9851
9852      N_Parameter_Association =>
9853        (1 => False,   --  unused
9854         2 => True,    --  Selector_Name (Node2)
9855         3 => True,    --  Explicit_Actual_Parameter (Node3)
9856         4 => False,   --  Next_Named_Actual (Node4-Sem)
9857         5 => False),  --  unused
9858
9859      N_Return_Statement =>
9860        (1 => False,   --  Storage_Pool (Node1-Sem)
9861         2 => False,   --  Procedure_To_Call (Node2-Sem)
9862         3 => True,    --  Expression (Node3)
9863         4 => False,   --  unused
9864         5 => False),  --  Return_Statement_Entity (Node5-Sem)
9865
9866      N_Extended_Return_Statement =>
9867        (1 => False,   --  Storage_Pool (Node1-Sem)
9868         2 => False,   --  Procedure_To_Call (Node2-Sem)
9869         3 => True,    --  Return_Object_Declarations (List3)
9870         4 => True,    --  Handled_Statement_Sequence (Node4)
9871         5 => False),  --  Return_Statement_Entity (Node5-Sem)
9872
9873      N_Package_Declaration =>
9874        (1 => True,    --  Specification (Node1)
9875         2 => False,   --  unused
9876         3 => False,   --  Activation_Chain_Entity (Node3-Sem)
9877         4 => False,   --  Parent_Spec (Node4-Sem)
9878         5 => False),  --  Corresponding_Body (Node5-Sem)
9879
9880      N_Package_Specification =>
9881        (1 => True,    --  Defining_Unit_Name (Node1)
9882         2 => True,    --  Visible_Declarations (List2)
9883         3 => True,    --  Private_Declarations (List3)
9884         4 => True,    --  End_Label (Node4)
9885         5 => False),  --  Generic_Parent (Node5-Sem)
9886
9887      N_Package_Body =>
9888        (1 => True,    --  Defining_Unit_Name (Node1)
9889         2 => True,    --  Declarations (List2)
9890         3 => False,   --  unused
9891         4 => True,    --  Handled_Statement_Sequence (Node4)
9892         5 => False),  --  Corresponding_Spec (Node5-Sem)
9893
9894      N_Private_Type_Declaration =>
9895        (1 => True,    --  Defining_Identifier (Node1)
9896         2 => False,   --  unused
9897         3 => False,   --  unused
9898         4 => True,    --  Discriminant_Specifications (List4)
9899         5 => False),  --  unused
9900
9901      N_Private_Extension_Declaration =>
9902        (1 => True,    --  Defining_Identifier (Node1)
9903         2 => True,    --  Interface_List (List2)
9904         3 => False,   --  unused
9905         4 => True,    --  Discriminant_Specifications (List4)
9906         5 => True),   --  Subtype_Indication (Node5)
9907
9908      N_Use_Package_Clause =>
9909        (1 => False,   --  unused
9910         2 => True,    --  Names (List2)
9911         3 => False,   --  Next_Use_Clause (Node3-Sem)
9912         4 => False,   --  Hidden_By_Use_Clause (Elist4-Sem)
9913         5 => False),  --  unused
9914
9915      N_Use_Type_Clause =>
9916        (1 => False,   --  unused
9917         2 => True,    --  Subtype_Marks (List2)
9918         3 => False,   --  Next_Use_Clause (Node3-Sem)
9919         4 => False,   --  Hidden_By_Use_Clause (Elist4-Sem)
9920         5 => False),  --  unused
9921
9922      N_Object_Renaming_Declaration =>
9923        (1 => True,    --  Defining_Identifier (Node1)
9924         2 => True,    --  Name (Node2)
9925         3 => True,    --  Access_Definition (Node3)
9926         4 => True,    --  Subtype_Mark (Node4)
9927         5 => False),  --  Corresponding_Generic_Association (Node5-Sem)
9928
9929      N_Exception_Renaming_Declaration =>
9930        (1 => True,    --  Defining_Identifier (Node1)
9931         2 => True,    --  Name (Node2)
9932         3 => False,   --  unused
9933         4 => False,   --  unused
9934         5 => False),  --  unused
9935
9936      N_Package_Renaming_Declaration =>
9937        (1 => True,    --  Defining_Unit_Name (Node1)
9938         2 => True,    --  Name (Node2)
9939         3 => False,   --  unused
9940         4 => False,   --  Parent_Spec (Node4-Sem)
9941         5 => False),  --  unused
9942
9943      N_Subprogram_Renaming_Declaration =>
9944        (1 => True,    --  Specification (Node1)
9945         2 => True,    --  Name (Node2)
9946         3 => False,   --  Corresponding_Formal_Spec (Node3-Sem)
9947         4 => False,   --  Parent_Spec (Node4-Sem)
9948         5 => False),  --  Corresponding_Spec (Node5-Sem)
9949
9950      N_Generic_Package_Renaming_Declaration =>
9951        (1 => True,    --  Defining_Unit_Name (Node1)
9952         2 => True,    --  Name (Node2)
9953         3 => False,   --  unused
9954         4 => False,   --  Parent_Spec (Node4-Sem)
9955         5 => False),  --  unused
9956
9957      N_Generic_Procedure_Renaming_Declaration =>
9958        (1 => True,    --  Defining_Unit_Name (Node1)
9959         2 => True,    --  Name (Node2)
9960         3 => False,   --  unused
9961         4 => False,   --  Parent_Spec (Node4-Sem)
9962         5 => False),  --  unused
9963
9964      N_Generic_Function_Renaming_Declaration =>
9965        (1 => True,    --  Defining_Unit_Name (Node1)
9966         2 => True,    --  Name (Node2)
9967         3 => False,   --  unused
9968         4 => False,   --  Parent_Spec (Node4-Sem)
9969         5 => False),  --  unused
9970
9971      N_Task_Type_Declaration =>
9972        (1 => True,    --  Defining_Identifier (Node1)
9973         2 => True,    --  Interface_List (List2)
9974         3 => True,    --  Task_Definition (Node3)
9975         4 => True,    --  Discriminant_Specifications (List4)
9976         5 => False),  --  Corresponding_Body (Node5-Sem)
9977
9978      N_Single_Task_Declaration =>
9979        (1 => True,    --  Defining_Identifier (Node1)
9980         2 => True,    --  Interface_List (List2)
9981         3 => True,    --  Task_Definition (Node3)
9982         4 => False,   --  unused
9983         5 => False),  --  unused
9984
9985      N_Task_Definition =>
9986        (1 => False,   --  unused
9987         2 => True,    --  Visible_Declarations (List2)
9988         3 => True,    --  Private_Declarations (List3)
9989         4 => True,    --  End_Label (Node4)
9990         5 => False),  --  unused
9991
9992      N_Task_Body =>
9993        (1 => True,    --  Defining_Identifier (Node1)
9994         2 => True,    --  Declarations (List2)
9995         3 => False,   --  Activation_Chain_Entity (Node3-Sem)
9996         4 => True,    --  Handled_Statement_Sequence (Node4)
9997         5 => False),  --  Corresponding_Spec (Node5-Sem)
9998
9999      N_Protected_Type_Declaration =>
10000        (1 => True,    --  Defining_Identifier (Node1)
10001         2 => True,    --  Interface_List (List2)
10002         3 => True,    --  Protected_Definition (Node3)
10003         4 => True,    --  Discriminant_Specifications (List4)
10004         5 => False),  --  Corresponding_Body (Node5-Sem)
10005
10006      N_Single_Protected_Declaration =>
10007        (1 => True,    --  Defining_Identifier (Node1)
10008         2 => True,    --  Interface_List (List2)
10009         3 => True,    --  Protected_Definition (Node3)
10010         4 => False,   --  unused
10011         5 => False),  --  unused
10012
10013      N_Protected_Definition =>
10014        (1 => False,   --  unused
10015         2 => True,    --  Visible_Declarations (List2)
10016         3 => True,    --  Private_Declarations (List3)
10017         4 => True,    --  End_Label (Node4)
10018         5 => False),  --  unused
10019
10020      N_Protected_Body =>
10021        (1 => True,    --  Defining_Identifier (Node1)
10022         2 => True,    --  Declarations (List2)
10023         3 => False,   --  unused
10024         4 => True,    --  End_Label (Node4)
10025         5 => False),  --  Corresponding_Spec (Node5-Sem)
10026
10027      N_Entry_Declaration =>
10028        (1 => True,    --  Defining_Identifier (Node1)
10029         2 => False,   --  unused
10030         3 => True,    --  Parameter_Specifications (List3)
10031         4 => True,    --  Discrete_Subtype_Definition (Node4)
10032         5 => False),  --  Corresponding_Body (Node5-Sem)
10033
10034      N_Accept_Statement =>
10035        (1 => True,    --  Entry_Direct_Name (Node1)
10036         2 => True,    --  Declarations (List2)
10037         3 => True,    --  Parameter_Specifications (List3)
10038         4 => True,    --  Handled_Statement_Sequence (Node4)
10039         5 => True),   --  Entry_Index (Node5)
10040
10041      N_Entry_Body =>
10042        (1 => True,    --  Defining_Identifier (Node1)
10043         2 => True,    --  Declarations (List2)
10044         3 => False,   --  Activation_Chain_Entity (Node3-Sem)
10045         4 => True,    --  Handled_Statement_Sequence (Node4)
10046         5 => True),   --  Entry_Body_Formal_Part (Node5)
10047
10048      N_Entry_Body_Formal_Part =>
10049        (1 => True,    --  Condition (Node1)
10050         2 => False,   --  unused
10051         3 => True,    --  Parameter_Specifications (List3)
10052         4 => True,    --  Entry_Index_Specification (Node4)
10053         5 => False),  --  unused
10054
10055      N_Entry_Index_Specification =>
10056        (1 => True,    --  Defining_Identifier (Node1)
10057         2 => False,   --  unused
10058         3 => False,   --  unused
10059         4 => True,    --  Discrete_Subtype_Definition (Node4)
10060         5 => False),  --  unused
10061
10062      N_Entry_Call_Statement =>
10063        (1 => False,   --  unused
10064         2 => True,    --  Name (Node2)
10065         3 => True,    --  Parameter_Associations (List3)
10066         4 => False,   --  First_Named_Actual (Node4-Sem)
10067         5 => False),  --  unused
10068
10069      N_Requeue_Statement =>
10070        (1 => False,   --  unused
10071         2 => True,    --  Name (Node2)
10072         3 => False,   --  unused
10073         4 => False,   --  unused
10074         5 => False),  --  unused
10075
10076      N_Delay_Until_Statement =>
10077        (1 => False,   --  unused
10078         2 => False,   --  unused
10079         3 => True,    --  Expression (Node3)
10080         4 => False,   --  unused
10081         5 => False),  --  unused
10082
10083      N_Delay_Relative_Statement =>
10084        (1 => False,   --  unused
10085         2 => False,   --  unused
10086         3 => True,    --  Expression (Node3)
10087         4 => False,   --  unused
10088         5 => False),  --  unused
10089
10090      N_Selective_Accept =>
10091        (1 => True,    --  Select_Alternatives (List1)
10092         2 => False,   --  unused
10093         3 => False,   --  unused
10094         4 => True,    --  Else_Statements (List4)
10095         5 => False),  --  unused
10096
10097      N_Accept_Alternative =>
10098        (1 => True,    --  Condition (Node1)
10099         2 => True,    --  Accept_Statement (Node2)
10100         3 => True,    --  Statements (List3)
10101         4 => True,    --  Pragmas_Before (List4)
10102         5 => False),  --  Accept_Handler_Records (List5-Sem)
10103
10104      N_Delay_Alternative =>
10105        (1 => True,    --  Condition (Node1)
10106         2 => True,    --  Delay_Statement (Node2)
10107         3 => True,    --  Statements (List3)
10108         4 => True,    --  Pragmas_Before (List4)
10109         5 => False),  --  unused
10110
10111      N_Terminate_Alternative =>
10112        (1 => True,    --  Condition (Node1)
10113         2 => False,   --  unused
10114         3 => False,   --  unused
10115         4 => True,    --  Pragmas_Before (List4)
10116         5 => True),   --  Pragmas_After (List5)
10117
10118      N_Timed_Entry_Call =>
10119        (1 => True,    --  Entry_Call_Alternative (Node1)
10120         2 => False,   --  unused
10121         3 => False,   --  unused
10122         4 => True,    --  Delay_Alternative (Node4)
10123         5 => False),  --  unused
10124
10125      N_Entry_Call_Alternative =>
10126        (1 => True,    --  Entry_Call_Statement (Node1)
10127         2 => False,   --  unused
10128         3 => True,    --  Statements (List3)
10129         4 => True,    --  Pragmas_Before (List4)
10130         5 => False),  --  unused
10131
10132      N_Conditional_Entry_Call =>
10133        (1 => True,    --  Entry_Call_Alternative (Node1)
10134         2 => False,   --  unused
10135         3 => False,   --  unused
10136         4 => True,    --  Else_Statements (List4)
10137         5 => False),  --  unused
10138
10139      N_Asynchronous_Select =>
10140        (1 => True,    --  Triggering_Alternative (Node1)
10141         2 => True,    --  Abortable_Part (Node2)
10142         3 => False,   --  unused
10143         4 => False,   --  unused
10144         5 => False),  --  unused
10145
10146      N_Triggering_Alternative =>
10147        (1 => True,    --  Triggering_Statement (Node1)
10148         2 => False,   --  unused
10149         3 => True,    --  Statements (List3)
10150         4 => True,    --  Pragmas_Before (List4)
10151         5 => False),  --  unused
10152
10153      N_Abortable_Part =>
10154        (1 => False,   --  unused
10155         2 => False,   --  unused
10156         3 => True,    --  Statements (List3)
10157         4 => False,   --  unused
10158         5 => False),  --  unused
10159
10160      N_Abort_Statement =>
10161        (1 => False,   --  unused
10162         2 => True,    --  Names (List2)
10163         3 => False,   --  unused
10164         4 => False,   --  unused
10165         5 => False),  --  unused
10166
10167      N_Compilation_Unit =>
10168        (1 => True,    --  Context_Items (List1)
10169         2 => True,    --  Unit (Node2)
10170         3 => False,   --  First_Inlined_Subprogram (Node3-Sem)
10171         4 => False,   --  Library_Unit (Node4-Sem)
10172         5 => True),   --  Aux_Decls_Node (Node5)
10173
10174      N_Compilation_Unit_Aux =>
10175        (1 => True,    --  Actions (List1)
10176         2 => True,    --  Declarations (List2)
10177         3 => False,   --  unused
10178         4 => True,    --  Config_Pragmas (List4)
10179         5 => True),   --  Pragmas_After (List5)
10180
10181      N_With_Clause =>
10182        (1 => False,   --  unused
10183         2 => True,    --  Name (Node2)
10184         3 => False,   --  unused
10185         4 => False,   --  Library_Unit (Node4-Sem)
10186         5 => False),  --  Corresponding_Spec (Node5-Sem)
10187
10188      N_Subprogram_Body_Stub =>
10189        (1 => True,    --  Specification (Node1)
10190         2 => False,   --  unused
10191         3 => False,   --  unused
10192         4 => False,   --  Library_Unit (Node4-Sem)
10193         5 => False),  --  Corresponding_Body (Node5-Sem)
10194
10195      N_Package_Body_Stub =>
10196        (1 => True,    --  Defining_Identifier (Node1)
10197         2 => False,   --  unused
10198         3 => False,   --  unused
10199         4 => False,   --  Library_Unit (Node4-Sem)
10200         5 => False),  --  Corresponding_Body (Node5-Sem)
10201
10202      N_Task_Body_Stub =>
10203        (1 => True,    --  Defining_Identifier (Node1)
10204         2 => False,   --  unused
10205         3 => False,   --  unused
10206         4 => False,   --  Library_Unit (Node4-Sem)
10207         5 => False),  --  Corresponding_Body (Node5-Sem)
10208
10209      N_Protected_Body_Stub =>
10210        (1 => True,    --  Defining_Identifier (Node1)
10211         2 => False,   --  unused
10212         3 => False,   --  unused
10213         4 => False,   --  Library_Unit (Node4-Sem)
10214         5 => False),  --  Corresponding_Body (Node5-Sem)
10215
10216      N_Subunit =>
10217        (1 => True,    --  Proper_Body (Node1)
10218         2 => True,    --  Name (Node2)
10219         3 => False,   --  Corresponding_Stub (Node3-Sem)
10220         4 => False,   --  unused
10221         5 => False),  --  unused
10222
10223      N_Exception_Declaration =>
10224        (1 => True,    --  Defining_Identifier (Node1)
10225         2 => False,   --  unused
10226         3 => False,   --  Expression (Node3-Sem)
10227         4 => False,   --  unused
10228         5 => False),  --  unused
10229
10230      N_Handled_Sequence_Of_Statements =>
10231        (1 => True,    --  At_End_Proc (Node1)
10232         2 => False,   --  First_Real_Statement (Node2-Sem)
10233         3 => True,    --  Statements (List3)
10234         4 => True,    --  End_Label (Node4)
10235         5 => True),   --  Exception_Handlers (List5)
10236
10237      N_Exception_Handler =>
10238        (1 => False,   --  Local_Raise_Statements (Elist1)
10239         2 => True,    --  Choice_Parameter (Node2)
10240         3 => True,    --  Statements (List3)
10241         4 => True,    --  Exception_Choices (List4)
10242         5 => False),  --  Exception_Label (Node5)
10243
10244      N_Raise_Statement =>
10245        (1 => False,   --  unused
10246         2 => True,    --  Name (Node2)
10247         3 => True,    --  Expression (Node3)
10248         4 => False,   --  unused
10249         5 => False),  --  unused
10250
10251      N_Generic_Subprogram_Declaration =>
10252        (1 => True,    --  Specification (Node1)
10253         2 => True,    --  Generic_Formal_Declarations (List2)
10254         3 => False,   --  unused
10255         4 => False,   --  Parent_Spec (Node4-Sem)
10256         5 => False),  --  Corresponding_Body (Node5-Sem)
10257
10258      N_Generic_Package_Declaration =>
10259        (1 => True,    --  Specification (Node1)
10260         2 => True,    --  Generic_Formal_Declarations (List2)
10261         3 => False,   --  Activation_Chain_Entity (Node3-Sem)
10262         4 => False,   --  Parent_Spec (Node4-Sem)
10263         5 => False),  --  Corresponding_Body (Node5-Sem)
10264
10265      N_Package_Instantiation =>
10266        (1 => True,    --  Defining_Unit_Name (Node1)
10267         2 => True,    --  Name (Node2)
10268         3 => True,    --  Generic_Associations (List3)
10269         4 => False,   --  Parent_Spec (Node4-Sem)
10270         5 => False),  --  Instance_Spec (Node5-Sem)
10271
10272      N_Procedure_Instantiation =>
10273        (1 => True,    --  Defining_Unit_Name (Node1)
10274         2 => True,    --  Name (Node2)
10275         3 => True,    --  Generic_Associations (List3)
10276         4 => False,   --  Parent_Spec (Node4-Sem)
10277         5 => False),  --  Instance_Spec (Node5-Sem)
10278
10279      N_Function_Instantiation =>
10280        (1 => True,    --  Defining_Unit_Name (Node1)
10281         2 => True,    --  Name (Node2)
10282         3 => True,    --  Generic_Associations (List3)
10283         4 => False,   --  Parent_Spec (Node4-Sem)
10284         5 => False),  --  Instance_Spec (Node5-Sem)
10285
10286      N_Generic_Association =>
10287        (1 => True,    --  Explicit_Generic_Actual_Parameter (Node1)
10288         2 => True,    --  Selector_Name (Node2)
10289         3 => False,   --  unused
10290         4 => False,   --  unused
10291         5 => False),  --  unused
10292
10293      N_Formal_Object_Declaration =>
10294        (1 => True,    --  Defining_Identifier (Node1)
10295         2 => False,   --  unused
10296         3 => True,    --  Access_Definition (Node3)
10297         4 => True,    --  Subtype_Mark (Node4)
10298         5 => True),   --  Default_Expression (Node5)
10299
10300      N_Formal_Type_Declaration =>
10301        (1 => True,    --  Defining_Identifier (Node1)
10302         2 => False,   --  unused
10303         3 => True,    --  Formal_Type_Definition (Node3)
10304         4 => True,    --  Discriminant_Specifications (List4)
10305         5 => False),  --  unused
10306
10307      N_Formal_Private_Type_Definition =>
10308        (1 => False,   --  unused
10309         2 => False,   --  unused
10310         3 => False,   --  unused
10311         4 => False,   --  unused
10312         5 => False),  --  unused
10313
10314      N_Formal_Derived_Type_Definition =>
10315        (1 => False,   --  unused
10316         2 => True,    --  Interface_List (List2)
10317         3 => False,   --  unused
10318         4 => True,    --  Subtype_Mark (Node4)
10319         5 => False),  --  unused
10320
10321      N_Formal_Discrete_Type_Definition =>
10322        (1 => False,   --  unused
10323         2 => False,   --  unused
10324         3 => False,   --  unused
10325         4 => False,   --  unused
10326         5 => False),  --  unused
10327
10328      N_Formal_Signed_Integer_Type_Definition =>
10329        (1 => False,   --  unused
10330         2 => False,   --  unused
10331         3 => False,   --  unused
10332         4 => False,   --  unused
10333         5 => False),  --  unused
10334
10335      N_Formal_Modular_Type_Definition =>
10336        (1 => False,   --  unused
10337         2 => False,   --  unused
10338         3 => False,   --  unused
10339         4 => False,   --  unused
10340         5 => False),  --  unused
10341
10342      N_Formal_Floating_Point_Definition =>
10343        (1 => False,   --  unused
10344         2 => False,   --  unused
10345         3 => False,   --  unused
10346         4 => False,   --  unused
10347         5 => False),  --  unused
10348
10349      N_Formal_Ordinary_Fixed_Point_Definition =>
10350        (1 => False,   --  unused
10351         2 => False,   --  unused
10352         3 => False,   --  unused
10353         4 => False,   --  unused
10354         5 => False),  --  unused
10355
10356      N_Formal_Decimal_Fixed_Point_Definition =>
10357        (1 => False,   --  unused
10358         2 => False,   --  unused
10359         3 => False,   --  unused
10360         4 => False,   --  unused
10361         5 => False),  --  unused
10362
10363      N_Formal_Concrete_Subprogram_Declaration =>
10364        (1 => True,    --  Specification (Node1)
10365         2 => True,    --  Default_Name (Node2)
10366         3 => False,   --  unused
10367         4 => False,   --  unused
10368         5 => False),  --  unused
10369
10370      N_Formal_Abstract_Subprogram_Declaration =>
10371        (1 => True,    --  Specification (Node1)
10372         2 => True,    --  Default_Name (Node2)
10373         3 => False,   --  unused
10374         4 => False,   --  unused
10375         5 => False),  --  unused
10376
10377      N_Formal_Package_Declaration =>
10378        (1 => True,    --  Defining_Identifier (Node1)
10379         2 => True,    --  Name (Node2)
10380         3 => True,    --  Generic_Associations (List3)
10381         4 => False,   --  unused
10382         5 => False),  --  Instance_Spec (Node5-Sem)
10383
10384      N_Attribute_Definition_Clause =>
10385        (1 => True,    --  Chars (Name1)
10386         2 => True,    --  Name (Node2)
10387         3 => True,    --  Expression (Node3)
10388         4 => False,   --  unused
10389         5 => False),  --  Next_Rep_Item (Node5-Sem)
10390
10391      N_Enumeration_Representation_Clause =>
10392        (1 => True,    --  Identifier (Node1)
10393         2 => False,   --  unused
10394         3 => True,    --  Array_Aggregate (Node3)
10395         4 => False,   --  unused
10396         5 => False),  --  Next_Rep_Item (Node5-Sem)
10397
10398      N_Record_Representation_Clause =>
10399        (1 => True,    --  Identifier (Node1)
10400         2 => True,    --  Mod_Clause (Node2)
10401         3 => True,    --  Component_Clauses (List3)
10402         4 => False,   --  unused
10403         5 => False),  --  Next_Rep_Item (Node5-Sem)
10404
10405      N_Component_Clause =>
10406        (1 => True,    --  Component_Name (Node1)
10407         2 => True,    --  Position (Node2)
10408         3 => True,    --  First_Bit (Node3)
10409         4 => True,    --  Last_Bit (Node4)
10410         5 => False),  --  unused
10411
10412      N_Code_Statement =>
10413        (1 => False,   --  unused
10414         2 => False,   --  unused
10415         3 => True,    --  Expression (Node3)
10416         4 => False,   --  unused
10417         5 => False),  --  unused
10418
10419      N_Op_Rotate_Left =>
10420        (1 => True,    --  Chars (Name1)
10421         2 => True,    --  Left_Opnd (Node2)
10422         3 => True,    --  Right_Opnd (Node3)
10423         4 => False,   --  Entity (Node4-Sem)
10424         5 => False),  --  Etype (Node5-Sem)
10425
10426      N_Op_Rotate_Right =>
10427        (1 => True,    --  Chars (Name1)
10428         2 => True,    --  Left_Opnd (Node2)
10429         3 => True,    --  Right_Opnd (Node3)
10430         4 => False,   --  Entity (Node4-Sem)
10431         5 => False),  --  Etype (Node5-Sem)
10432
10433      N_Op_Shift_Left =>
10434        (1 => True,    --  Chars (Name1)
10435         2 => True,    --  Left_Opnd (Node2)
10436         3 => True,    --  Right_Opnd (Node3)
10437         4 => False,   --  Entity (Node4-Sem)
10438         5 => False),  --  Etype (Node5-Sem)
10439
10440      N_Op_Shift_Right_Arithmetic =>
10441        (1 => True,    --  Chars (Name1)
10442         2 => True,    --  Left_Opnd (Node2)
10443         3 => True,    --  Right_Opnd (Node3)
10444         4 => False,   --  Entity (Node4-Sem)
10445         5 => False),  --  Etype (Node5-Sem)
10446
10447      N_Op_Shift_Right =>
10448        (1 => True,    --  Chars (Name1)
10449         2 => True,    --  Left_Opnd (Node2)
10450         3 => True,    --  Right_Opnd (Node3)
10451         4 => False,   --  Entity (Node4-Sem)
10452         5 => False),  --  Etype (Node5-Sem)
10453
10454      N_Delta_Constraint =>
10455        (1 => False,   --  unused
10456         2 => False,   --  unused
10457         3 => True,    --  Delta_Expression (Node3)
10458         4 => True,    --  Range_Constraint (Node4)
10459         5 => False),  --  unused
10460
10461      N_At_Clause =>
10462        (1 => True,    --  Identifier (Node1)
10463         2 => False,   --  unused
10464         3 => True,    --  Expression (Node3)
10465         4 => False,   --  unused
10466         5 => False),  --  unused
10467
10468      N_Mod_Clause =>
10469        (1 => False,   --  unused
10470         2 => False,   --  unused
10471         3 => True,    --  Expression (Node3)
10472         4 => True,    --  Pragmas_Before (List4)
10473         5 => False),  --  unused
10474
10475      N_Conditional_Expression =>
10476        (1 => True,    --  Expressions (List1)
10477         2 => False,   --  Then_Actions (List2-Sem)
10478         3 => False,   --  Else_Actions (List3-Sem)
10479         4 => False,   --  unused
10480         5 => False),  --  Etype (Node5-Sem)
10481
10482      N_Expanded_Name =>
10483        (1 => True,    --  Chars (Name1)
10484         2 => True,    --  Selector_Name (Node2)
10485         3 => True,    --  Prefix (Node3)
10486         4 => False,   --  Entity (Node4-Sem)
10487         5 => False),  --  Etype (Node5-Sem)
10488
10489      N_Free_Statement =>
10490        (1 => False,   --  Storage_Pool (Node1-Sem)
10491         2 => False,   --  Procedure_To_Call (Node2-Sem)
10492         3 => True,    --  Expression (Node3)
10493         4 => False,   --  Actual_Designated_Subtype (Node4-Sem)
10494         5 => False),  --  unused
10495
10496      N_Freeze_Entity =>
10497        (1 => True,    --  Actions (List1)
10498         2 => False,   --  Access_Types_To_Process (Elist2-Sem)
10499         3 => False,   --  TSS_Elist (Elist3-Sem)
10500         4 => False,   --  Entity (Node4-Sem)
10501         5 => False),  --  First_Subtype_Link (Node5-Sem)
10502
10503      N_Implicit_Label_Declaration =>
10504        (1 => True,    --  Defining_Identifier (Node1)
10505         2 => False,   --  Label_Construct (Node2-Sem)
10506         3 => False,   --  unused
10507         4 => False,   --  unused
10508         5 => False),  --  unused
10509
10510      N_Itype_Reference =>
10511        (1 => False,   --  Itype (Node1-Sem)
10512         2 => False,   --  unused
10513         3 => False,   --  unused
10514         4 => False,   --  unused
10515         5 => False),  --  unused
10516
10517      N_Raise_Constraint_Error =>
10518        (1 => True,    --  Condition (Node1)
10519         2 => False,   --  unused
10520         3 => True,    --  Reason (Uint3)
10521         4 => False,   --  unused
10522         5 => False),  --  Etype (Node5-Sem)
10523
10524      N_Raise_Program_Error =>
10525        (1 => True,    --  Condition (Node1)
10526         2 => False,   --  unused
10527         3 => True,    --  Reason (Uint3)
10528         4 => False,   --  unused
10529         5 => False),  --  Etype (Node5-Sem)
10530
10531      N_Raise_Storage_Error =>
10532        (1 => True,    --  Condition (Node1)
10533         2 => False,   --  unused
10534         3 => True,    --  Reason (Uint3)
10535         4 => False,   --  unused
10536         5 => False),  --  Etype (Node5-Sem)
10537
10538      N_Push_Constraint_Error_Label =>
10539        (1 => False,   --  unused
10540         2 => False,   --  unused
10541         3 => False,   --  unused
10542         4 => False,   --  unused
10543         5 => False),  --  unused
10544
10545      N_Push_Program_Error_Label =>
10546        (1 => False,   --  Exception_Label
10547         2 => False,   --  unused
10548         3 => False,   --  unused
10549         4 => False,   --  unused
10550         5 => False),  --  Exception_Label
10551
10552      N_Push_Storage_Error_Label =>
10553        (1 => False,   --  Exception_Label
10554         2 => False,   --  unused
10555         3 => False,   --  unused
10556         4 => False,   --  unused
10557         5 => False),  --  Exception_Label
10558
10559      N_Pop_Constraint_Error_Label =>
10560        (1 => False,   --  unused
10561         2 => False,   --  unused
10562         3 => False,   --  unused
10563         4 => False,   --  unused
10564         5 => False),  --  unused
10565
10566      N_Pop_Program_Error_Label =>
10567        (1 => False,   --  unused
10568         2 => False,   --  unused
10569         3 => False,   --  unused
10570         4 => False,   --  unused
10571         5 => False),  --  unused
10572
10573      N_Pop_Storage_Error_Label =>
10574        (1 => False,   --  unused
10575         2 => False,   --  unused
10576         3 => False,   --  unused
10577         4 => False,   --  unused
10578         5 => False),  --  unused
10579
10580      N_Reference =>
10581        (1 => False,   --  unused
10582         2 => False,   --  unused
10583         3 => True,    --  Prefix (Node3)
10584         4 => False,   --  unused
10585         5 => False),  --  Etype (Node5-Sem)
10586
10587      N_Subprogram_Info =>
10588        (1 => True,    --  Identifier (Node1)
10589         2 => False,   --  unused
10590         3 => False,   --  unused
10591         4 => False,   --  unused
10592         5 => False),  --  Etype (Node5-Sem)
10593
10594      N_Unchecked_Expression =>
10595        (1 => False,   --  unused
10596         2 => False,   --  unused
10597         3 => True,    --  Expression (Node3)
10598         4 => False,   --  unused
10599         5 => False),  --  Etype (Node5-Sem)
10600
10601      N_Unchecked_Type_Conversion =>
10602        (1 => False,   --  unused
10603         2 => False,   --  unused
10604         3 => True,    --  Expression (Node3)
10605         4 => True,    --  Subtype_Mark (Node4)
10606         5 => False),  --  Etype (Node5-Sem)
10607
10608      N_Validate_Unchecked_Conversion =>
10609        (1 => False,   --  Source_Type (Node1-Sem)
10610         2 => False,   --  Target_Type (Node2-Sem)
10611         3 => False,   --  unused
10612         4 => False,   --  unused
10613         5 => False),  --  unused
10614
10615    --  End of inserted output from makeisf program
10616
10617    --  Entries for Empty, Error and Unused. Even thought these have a Chars
10618    --  field for debugging purposes, they are not really syntactic fields, so
10619    --  we mark all fields as unused.
10620
10621      N_Empty =>
10622        (1 => False,   --  unused
10623         2 => False,   --  unused
10624         3 => False,   --  unused
10625         4 => False,   --  unused
10626         5 => False),  --  unused
10627
10628      N_Error =>
10629        (1 => False,   --  unused
10630         2 => False,   --  unused
10631         3 => False,   --  unused
10632         4 => False,   --  unused
10633         5 => False),  --  unused
10634
10635      N_Unused_At_Start =>
10636        (1 => False,   --  unused
10637         2 => False,   --  unused
10638         3 => False,   --  unused
10639         4 => False,   --  unused
10640         5 => False),  --  unused
10641
10642      N_Unused_At_End =>
10643        (1 => False,   --  unused
10644         2 => False,   --  unused
10645         3 => False,   --  unused
10646         4 => False,   --  unused
10647         5 => False)); --  unused
10648
10649    --------------------
10650    -- Inline Pragmas --
10651    --------------------
10652
10653    pragma Inline (ABE_Is_Certain);
10654    pragma Inline (Abort_Present);
10655    pragma Inline (Abortable_Part);
10656    pragma Inline (Abstract_Present);
10657    pragma Inline (Accept_Handler_Records);
10658    pragma Inline (Accept_Statement);
10659    pragma Inline (Access_Definition);
10660    pragma Inline (Access_To_Subprogram_Definition);
10661    pragma Inline (Access_Types_To_Process);
10662    pragma Inline (Actions);
10663    pragma Inline (Activation_Chain_Entity);
10664    pragma Inline (Acts_As_Spec);
10665    pragma Inline (Actual_Designated_Subtype);
10666    pragma Inline (Aggregate_Bounds);
10667    pragma Inline (Aliased_Present);
10668    pragma Inline (All_Others);
10669    pragma Inline (All_Present);
10670    pragma Inline (Alternatives);
10671    pragma Inline (Ancestor_Part);
10672    pragma Inline (Array_Aggregate);
10673    pragma Inline (Assignment_OK);
10674    pragma Inline (Associated_Node);
10675    pragma Inline (At_End_Proc);
10676    pragma Inline (Attribute_Name);
10677    pragma Inline (Aux_Decls_Node);
10678    pragma Inline (Backwards_OK);
10679    pragma Inline (Bad_Is_Detected);
10680    pragma Inline (Body_To_Inline);
10681    pragma Inline (Body_Required);
10682    pragma Inline (By_Ref);
10683    pragma Inline (Box_Present);
10684    pragma Inline (Char_Literal_Value);
10685    pragma Inline (Chars);
10686    pragma Inline (Check_Address_Alignment);
10687    pragma Inline (Choice_Parameter);
10688    pragma Inline (Choices);
10689    pragma Inline (Coextensions);
10690    pragma Inline (Comes_From_Extended_Return_Statement);
10691    pragma Inline (Compile_Time_Known_Aggregate);
10692    pragma Inline (Component_Associations);
10693    pragma Inline (Component_Clauses);
10694    pragma Inline (Component_Definition);
10695    pragma Inline (Component_Items);
10696    pragma Inline (Component_List);
10697    pragma Inline (Component_Name);
10698    pragma Inline (Condition);
10699    pragma Inline (Condition_Actions);
10700    pragma Inline (Config_Pragmas);
10701    pragma Inline (Constant_Present);
10702    pragma Inline (Constraint);
10703    pragma Inline (Constraints);
10704    pragma Inline (Context_Installed);
10705    pragma Inline (Context_Items);
10706    pragma Inline (Controlling_Argument);
10707    pragma Inline (Conversion_OK);
10708    pragma Inline (Corresponding_Body);
10709    pragma Inline (Corresponding_Formal_Spec);
10710    pragma Inline (Corresponding_Generic_Association);
10711    pragma Inline (Corresponding_Integer_Value);
10712    pragma Inline (Corresponding_Spec);
10713    pragma Inline (Corresponding_Stub);
10714    pragma Inline (Dcheck_Function);
10715    pragma Inline (Debug_Statement);
10716    pragma Inline (Declarations);
10717    pragma Inline (Default_Expression);
10718    pragma Inline (Default_Name);
10719    pragma Inline (Defining_Identifier);
10720    pragma Inline (Defining_Unit_Name);
10721    pragma Inline (Delay_Alternative);
10722    pragma Inline (Delay_Statement);
10723    pragma Inline (Delta_Expression);
10724    pragma Inline (Digits_Expression);
10725    pragma Inline (Discr_Check_Funcs_Built);
10726    pragma Inline (Discrete_Choices);
10727    pragma Inline (Discrete_Range);
10728    pragma Inline (Discrete_Subtype_Definition);
10729    pragma Inline (Discrete_Subtype_Definitions);
10730    pragma Inline (Discriminant_Specifications);
10731    pragma Inline (Discriminant_Type);
10732    pragma Inline (Do_Accessibility_Check);
10733    pragma Inline (Do_Discriminant_Check);
10734    pragma Inline (Do_Length_Check);
10735    pragma Inline (Do_Division_Check);
10736    pragma Inline (Do_Overflow_Check);
10737    pragma Inline (Do_Range_Check);
10738    pragma Inline (Do_Storage_Check);
10739    pragma Inline (Do_Tag_Check);
10740    pragma Inline (Elaborate_Present);
10741    pragma Inline (Elaborate_All_Desirable);
10742    pragma Inline (Elaborate_All_Present);
10743    pragma Inline (Elaborate_Desirable);
10744    pragma Inline (Elaboration_Boolean);
10745    pragma Inline (Else_Actions);
10746    pragma Inline (Else_Statements);
10747    pragma Inline (Elsif_Parts);
10748    pragma Inline (Enclosing_Variant);
10749    pragma Inline (End_Label);
10750    pragma Inline (End_Span);
10751    pragma Inline (Entity);
10752    pragma Inline (Entity_Or_Associated_Node);
10753    pragma Inline (Entry_Body_Formal_Part);
10754    pragma Inline (Entry_Call_Alternative);
10755    pragma Inline (Entry_Call_Statement);
10756    pragma Inline (Entry_Direct_Name);
10757    pragma Inline (Entry_Index);
10758    pragma Inline (Entry_Index_Specification);
10759    pragma Inline (Etype);
10760    pragma Inline (Exception_Choices);
10761    pragma Inline (Exception_Handlers);
10762    pragma Inline (Exception_Junk);
10763    pragma Inline (Exception_Label);
10764    pragma Inline (Expansion_Delayed);
10765    pragma Inline (Explicit_Actual_Parameter);
10766    pragma Inline (Explicit_Generic_Actual_Parameter);
10767    pragma Inline (Expression);
10768    pragma Inline (Expressions);
10769    pragma Inline (First_Bit);
10770    pragma Inline (First_Inlined_Subprogram);
10771    pragma Inline (First_Name);
10772    pragma Inline (First_Named_Actual);
10773    pragma Inline (First_Real_Statement);
10774    pragma Inline (First_Subtype_Link);
10775    pragma Inline (Float_Truncate);
10776    pragma Inline (Formal_Type_Definition);
10777    pragma Inline (Forwards_OK);
10778    pragma Inline (From_At_Mod);
10779    pragma Inline (From_Default);
10780    pragma Inline (Generic_Associations);
10781    pragma Inline (Generic_Formal_Declarations);
10782    pragma Inline (Generic_Parent);
10783    pragma Inline (Generic_Parent_Type);
10784    pragma Inline (Handled_Statement_Sequence);
10785    pragma Inline (Handler_List_Entry);
10786    pragma Inline (Has_Created_Identifier);
10787    pragma Inline (Has_Dynamic_Length_Check);
10788    pragma Inline (Has_Dynamic_Range_Check);
10789    pragma Inline (Has_Init_Expression);
10790    pragma Inline (Has_Local_Raise);
10791    pragma Inline (Has_Self_Reference);
10792    pragma Inline (Has_No_Elaboration_Code);
10793    pragma Inline (Has_Priority_Pragma);
10794    pragma Inline (Has_Private_View);
10795    pragma Inline (Has_Storage_Size_Pragma);
10796    pragma Inline (Has_Task_Info_Pragma);
10797    pragma Inline (Has_Task_Name_Pragma);
10798    pragma Inline (Has_Wide_Character);
10799    pragma Inline (Hidden_By_Use_Clause);
10800    pragma Inline (High_Bound);
10801    pragma Inline (Identifier);
10802    pragma Inline (Implicit_With);
10803    pragma Inline (Interface_List);
10804    pragma Inline (Interface_Present);
10805    pragma Inline (Includes_Infinities);
10806    pragma Inline (In_Present);
10807    pragma Inline (Instance_Spec);
10808    pragma Inline (Intval);
10809    pragma Inline (Is_Asynchronous_Call_Block);
10810    pragma Inline (Is_Coextension);
10811    pragma Inline (Is_Component_Left_Opnd);
10812    pragma Inline (Is_Component_Right_Opnd);
10813    pragma Inline (Is_Controlling_Actual);
10814    pragma Inline (Is_Entry_Barrier_Function);
10815    pragma Inline (Is_In_Discriminant_Check);
10816    pragma Inline (Is_Machine_Number);
10817    pragma Inline (Is_Null_Loop);
10818    pragma Inline (Is_Overloaded);
10819    pragma Inline (Is_Power_Of_2_For_Shift);
10820    pragma Inline (Is_Protected_Subprogram_Body);
10821    pragma Inline (Is_Static_Coextension);
10822    pragma Inline (Is_Static_Expression);
10823    pragma Inline (Is_Subprogram_Descriptor);
10824    pragma Inline (Is_Task_Allocation_Block);
10825    pragma Inline (Is_Task_Master);
10826    pragma Inline (Iteration_Scheme);
10827    pragma Inline (Itype);
10828    pragma Inline (Kill_Range_Check);
10829    pragma Inline (Last_Bit);
10830    pragma Inline (Last_Name);
10831    pragma Inline (Library_Unit);
10832    pragma Inline (Label_Construct);
10833    pragma Inline (Left_Opnd);
10834    pragma Inline (Limited_View_Installed);
10835    pragma Inline (Limited_Present);
10836    pragma Inline (Literals);
10837    pragma Inline (Local_Raise_Not_OK);
10838    pragma Inline (Local_Raise_Statements);
10839    pragma Inline (Loop_Actions);
10840    pragma Inline (Loop_Parameter_Specification);
10841    pragma Inline (Low_Bound);
10842    pragma Inline (Mod_Clause);
10843    pragma Inline (More_Ids);
10844    pragma Inline (Must_Be_Byte_Aligned);
10845    pragma Inline (Must_Not_Freeze);
10846    pragma Inline (Must_Not_Override);
10847    pragma Inline (Must_Override);
10848    pragma Inline (Name);
10849    pragma Inline (Names);
10850    pragma Inline (Next_Entity);
10851    pragma Inline (Next_Named_Actual);
10852    pragma Inline (Next_Rep_Item);
10853    pragma Inline (Next_Use_Clause);
10854    pragma Inline (No_Ctrl_Actions);
10855    pragma Inline (No_Elaboration_Check);
10856    pragma Inline (No_Entities_Ref_In_Spec);
10857    pragma Inline (No_Initialization);
10858    pragma Inline (No_Truncation);
10859    pragma Inline (Null_Present);
10860    pragma Inline (Null_Exclusion_Present);
10861    pragma Inline (Null_Record_Present);
10862    pragma Inline (Object_Definition);
10863    pragma Inline (Original_Discriminant);
10864    pragma Inline (Original_Entity);
10865    pragma Inline (Others_Discrete_Choices);
10866    pragma Inline (Out_Present);
10867    pragma Inline (Parameter_Associations);
10868    pragma Inline (Parameter_Specifications);
10869    pragma Inline (Parameter_List_Truncated);
10870    pragma Inline (Parameter_Type);
10871    pragma Inline (Parent_Spec);
10872    pragma Inline (Position);
10873    pragma Inline (Pragma_Argument_Associations);
10874    pragma Inline (Pragmas_After);
10875    pragma Inline (Pragmas_Before);
10876    pragma Inline (Prefix);
10877    pragma Inline (Present_Expr);
10878    pragma Inline (Prev_Ids);
10879    pragma Inline (Print_In_Hex);
10880    pragma Inline (Private_Declarations);
10881    pragma Inline (Private_Present);
10882    pragma Inline (Procedure_To_Call);
10883    pragma Inline (Proper_Body);
10884    pragma Inline (Protected_Definition);
10885    pragma Inline (Protected_Present);
10886    pragma Inline (Raises_Constraint_Error);
10887    pragma Inline (Range_Constraint);
10888    pragma Inline (Range_Expression);
10889    pragma Inline (Real_Range_Specification);
10890    pragma Inline (Realval);
10891    pragma Inline (Reason);
10892    pragma Inline (Record_Extension_Part);
10893    pragma Inline (Redundant_Use);
10894    pragma Inline (Renaming_Exception);
10895    pragma Inline (Result_Definition);
10896    pragma Inline (Return_Object_Declarations);
10897    pragma Inline (Return_Statement_Entity);
10898    pragma Inline (Reverse_Present);
10899    pragma Inline (Right_Opnd);
10900    pragma Inline (Rounded_Result);
10901    pragma Inline (Scope);
10902    pragma Inline (Select_Alternatives);
10903    pragma Inline (Selector_Name);
10904    pragma Inline (Selector_Names);
10905    pragma Inline (Shift_Count_OK);
10906    pragma Inline (Source_Type);
10907    pragma Inline (Specification);
10908    pragma Inline (Statements);
10909    pragma Inline (Static_Processing_OK);
10910    pragma Inline (Storage_Pool);
10911    pragma Inline (Strval);
10912    pragma Inline (Subtype_Indication);
10913    pragma Inline (Subtype_Mark);
10914    pragma Inline (Subtype_Marks);
10915    pragma Inline (Synchronized_Present);
10916    pragma Inline (Tagged_Present);
10917    pragma Inline (Target_Type);
10918    pragma Inline (Task_Definition);
10919    pragma Inline (Task_Present);
10920    pragma Inline (Then_Actions);
10921    pragma Inline (Then_Statements);
10922    pragma Inline (Triggering_Alternative);
10923    pragma Inline (Triggering_Statement);
10924    pragma Inline (Treat_Fixed_As_Integer);
10925    pragma Inline (TSS_Elist);
10926    pragma Inline (Type_Definition);
10927    pragma Inline (Unit);
10928    pragma Inline (Unknown_Discriminants_Present);
10929    pragma Inline (Unreferenced_In_Spec);
10930    pragma Inline (Variant_Part);
10931    pragma Inline (Variants);
10932    pragma Inline (Visible_Declarations);
10933    pragma Inline (Was_Originally_Stub);
10934    pragma Inline (Zero_Cost_Handling);
10935
10936    pragma Inline (Set_ABE_Is_Certain);
10937    pragma Inline (Set_Abort_Present);
10938    pragma Inline (Set_Abortable_Part);
10939    pragma Inline (Set_Abstract_Present);
10940    pragma Inline (Set_Accept_Handler_Records);
10941    pragma Inline (Set_Accept_Statement);
10942    pragma Inline (Set_Access_Definition);
10943    pragma Inline (Set_Access_To_Subprogram_Definition);
10944    pragma Inline (Set_Access_Types_To_Process);
10945    pragma Inline (Set_Actions);
10946    pragma Inline (Set_Activation_Chain_Entity);
10947    pragma Inline (Set_Acts_As_Spec);
10948    pragma Inline (Set_Actual_Designated_Subtype);
10949    pragma Inline (Set_Aggregate_Bounds);
10950    pragma Inline (Set_Aliased_Present);
10951    pragma Inline (Set_All_Others);
10952    pragma Inline (Set_All_Present);
10953    pragma Inline (Set_Alternatives);
10954    pragma Inline (Set_Ancestor_Part);
10955    pragma Inline (Set_Array_Aggregate);
10956    pragma Inline (Set_Assignment_OK);
10957    pragma Inline (Set_Associated_Node);
10958    pragma Inline (Set_At_End_Proc);
10959    pragma Inline (Set_Attribute_Name);
10960    pragma Inline (Set_Aux_Decls_Node);
10961    pragma Inline (Set_Backwards_OK);
10962    pragma Inline (Set_Bad_Is_Detected);
10963    pragma Inline (Set_Body_To_Inline);
10964    pragma Inline (Set_Body_Required);
10965    pragma Inline (Set_By_Ref);
10966    pragma Inline (Set_Box_Present);
10967    pragma Inline (Set_Char_Literal_Value);
10968    pragma Inline (Set_Chars);
10969    pragma Inline (Set_Check_Address_Alignment);
10970    pragma Inline (Set_Choice_Parameter);
10971    pragma Inline (Set_Choices);
10972    pragma Inline (Set_Coextensions);
10973    pragma Inline (Set_Comes_From_Extended_Return_Statement);
10974    pragma Inline (Set_Compile_Time_Known_Aggregate);
10975    pragma Inline (Set_Component_Associations);
10976    pragma Inline (Set_Component_Clauses);
10977    pragma Inline (Set_Component_Definition);
10978    pragma Inline (Set_Component_Items);
10979    pragma Inline (Set_Component_List);
10980    pragma Inline (Set_Component_Name);
10981    pragma Inline (Set_Condition);
10982    pragma Inline (Set_Condition_Actions);
10983    pragma Inline (Set_Config_Pragmas);
10984    pragma Inline (Set_Constant_Present);
10985    pragma Inline (Set_Constraint);
10986    pragma Inline (Set_Constraints);
10987    pragma Inline (Set_Context_Installed);
10988    pragma Inline (Set_Context_Items);
10989    pragma Inline (Set_Controlling_Argument);
10990    pragma Inline (Set_Conversion_OK);
10991    pragma Inline (Set_Corresponding_Body);
10992    pragma Inline (Set_Corresponding_Formal_Spec);
10993    pragma Inline (Set_Corresponding_Generic_Association);
10994    pragma Inline (Set_Corresponding_Integer_Value);
10995    pragma Inline (Set_Corresponding_Spec);
10996    pragma Inline (Set_Corresponding_Stub);
10997    pragma Inline (Set_Dcheck_Function);
10998    pragma Inline (Set_Debug_Statement);
10999    pragma Inline (Set_Declarations);
11000    pragma Inline (Set_Default_Expression);
11001    pragma Inline (Set_Default_Name);
11002    pragma Inline (Set_Defining_Identifier);
11003    pragma Inline (Set_Defining_Unit_Name);
11004    pragma Inline (Set_Delay_Alternative);
11005    pragma Inline (Set_Delay_Statement);
11006    pragma Inline (Set_Delta_Expression);
11007    pragma Inline (Set_Digits_Expression);
11008    pragma Inline (Set_Discr_Check_Funcs_Built);
11009    pragma Inline (Set_Discrete_Choices);
11010    pragma Inline (Set_Discrete_Range);
11011    pragma Inline (Set_Discrete_Subtype_Definition);
11012    pragma Inline (Set_Discrete_Subtype_Definitions);
11013    pragma Inline (Set_Discriminant_Specifications);
11014    pragma Inline (Set_Discriminant_Type);
11015    pragma Inline (Set_Do_Accessibility_Check);
11016    pragma Inline (Set_Do_Discriminant_Check);
11017    pragma Inline (Set_Do_Length_Check);
11018    pragma Inline (Set_Do_Division_Check);
11019    pragma Inline (Set_Do_Overflow_Check);
11020    pragma Inline (Set_Do_Range_Check);
11021    pragma Inline (Set_Do_Storage_Check);
11022    pragma Inline (Set_Do_Tag_Check);
11023    pragma Inline (Set_Elaborate_Present);
11024    pragma Inline (Set_Elaborate_All_Desirable);
11025    pragma Inline (Set_Elaborate_All_Present);
11026    pragma Inline (Set_Elaborate_Desirable);
11027    pragma Inline (Set_Elaboration_Boolean);
11028    pragma Inline (Set_Else_Actions);
11029    pragma Inline (Set_Else_Statements);
11030    pragma Inline (Set_Elsif_Parts);
11031    pragma Inline (Set_Enclosing_Variant);
11032    pragma Inline (Set_End_Label);
11033    pragma Inline (Set_End_Span);
11034    pragma Inline (Set_Entity);
11035    pragma Inline (Set_Entry_Body_Formal_Part);
11036    pragma Inline (Set_Entry_Call_Alternative);
11037    pragma Inline (Set_Entry_Call_Statement);
11038    pragma Inline (Set_Entry_Direct_Name);
11039    pragma Inline (Set_Entry_Index);
11040    pragma Inline (Set_Entry_Index_Specification);
11041    pragma Inline (Set_Etype);
11042    pragma Inline (Set_Exception_Choices);
11043    pragma Inline (Set_Exception_Handlers);
11044    pragma Inline (Set_Exception_Junk);
11045    pragma Inline (Set_Exception_Label);
11046    pragma Inline (Set_Expansion_Delayed);
11047    pragma Inline (Set_Explicit_Actual_Parameter);
11048    pragma Inline (Set_Explicit_Generic_Actual_Parameter);
11049    pragma Inline (Set_Expression);
11050    pragma Inline (Set_Expressions);
11051    pragma Inline (Set_First_Bit);
11052    pragma Inline (Set_First_Inlined_Subprogram);
11053    pragma Inline (Set_First_Name);
11054    pragma Inline (Set_First_Named_Actual);
11055    pragma Inline (Set_First_Real_Statement);
11056    pragma Inline (Set_First_Subtype_Link);
11057    pragma Inline (Set_Float_Truncate);
11058    pragma Inline (Set_Formal_Type_Definition);
11059    pragma Inline (Set_Forwards_OK);
11060    pragma Inline (Set_From_At_Mod);
11061    pragma Inline (Set_From_Default);
11062    pragma Inline (Set_Generic_Associations);
11063    pragma Inline (Set_Generic_Formal_Declarations);
11064    pragma Inline (Set_Generic_Parent);
11065    pragma Inline (Set_Generic_Parent_Type);
11066    pragma Inline (Set_Handled_Statement_Sequence);
11067    pragma Inline (Set_Handler_List_Entry);
11068    pragma Inline (Set_Has_Created_Identifier);
11069    pragma Inline (Set_Has_Dynamic_Length_Check);
11070    pragma Inline (Set_Has_Init_Expression);
11071    pragma Inline (Set_Has_Local_Raise);
11072    pragma Inline (Set_Has_Dynamic_Range_Check);
11073    pragma Inline (Set_Has_No_Elaboration_Code);
11074    pragma Inline (Set_Has_Priority_Pragma);
11075    pragma Inline (Set_Has_Private_View);
11076    pragma Inline (Set_Has_Storage_Size_Pragma);
11077    pragma Inline (Set_Has_Task_Info_Pragma);
11078    pragma Inline (Set_Has_Task_Name_Pragma);
11079    pragma Inline (Set_Has_Wide_Character);
11080    pragma Inline (Set_Hidden_By_Use_Clause);
11081    pragma Inline (Set_High_Bound);
11082    pragma Inline (Set_Identifier);
11083    pragma Inline (Set_Implicit_With);
11084    pragma Inline (Set_Includes_Infinities);
11085    pragma Inline (Set_Interface_List);
11086    pragma Inline (Set_Interface_Present);
11087    pragma Inline (Set_In_Present);
11088    pragma Inline (Set_Instance_Spec);
11089    pragma Inline (Set_Intval);
11090    pragma Inline (Set_Is_Asynchronous_Call_Block);
11091    pragma Inline (Set_Is_Coextension);
11092    pragma Inline (Set_Is_Component_Left_Opnd);
11093    pragma Inline (Set_Is_Component_Right_Opnd);
11094    pragma Inline (Set_Is_Controlling_Actual);
11095    pragma Inline (Set_Is_Entry_Barrier_Function);
11096    pragma Inline (Set_Is_In_Discriminant_Check);
11097    pragma Inline (Set_Is_Machine_Number);
11098    pragma Inline (Set_Is_Null_Loop);
11099    pragma Inline (Set_Is_Overloaded);
11100    pragma Inline (Set_Is_Power_Of_2_For_Shift);
11101    pragma Inline (Set_Is_Protected_Subprogram_Body);
11102    pragma Inline (Set_Has_Self_Reference);
11103    pragma Inline (Set_Is_Static_Coextension);
11104    pragma Inline (Set_Is_Static_Expression);
11105    pragma Inline (Set_Is_Subprogram_Descriptor);
11106    pragma Inline (Set_Is_Task_Allocation_Block);
11107    pragma Inline (Set_Is_Task_Master);
11108    pragma Inline (Set_Iteration_Scheme);
11109    pragma Inline (Set_Itype);
11110    pragma Inline (Set_Kill_Range_Check);
11111    pragma Inline (Set_Last_Bit);
11112    pragma Inline (Set_Last_Name);
11113    pragma Inline (Set_Library_Unit);
11114    pragma Inline (Set_Label_Construct);
11115    pragma Inline (Set_Left_Opnd);
11116    pragma Inline (Set_Limited_View_Installed);
11117    pragma Inline (Set_Limited_Present);
11118    pragma Inline (Set_Literals);
11119    pragma Inline (Set_Local_Raise_Not_OK);
11120    pragma Inline (Set_Local_Raise_Statements);
11121    pragma Inline (Set_Loop_Actions);
11122    pragma Inline (Set_Loop_Parameter_Specification);
11123    pragma Inline (Set_Low_Bound);
11124    pragma Inline (Set_Mod_Clause);
11125    pragma Inline (Set_More_Ids);
11126    pragma Inline (Set_Must_Be_Byte_Aligned);
11127    pragma Inline (Set_Must_Not_Freeze);
11128    pragma Inline (Set_Must_Not_Override);
11129    pragma Inline (Set_Must_Override);
11130    pragma Inline (Set_Name);
11131    pragma Inline (Set_Names);
11132    pragma Inline (Set_Next_Entity);
11133    pragma Inline (Set_Next_Named_Actual);
11134    pragma Inline (Set_Next_Use_Clause);
11135    pragma Inline (Set_No_Ctrl_Actions);
11136    pragma Inline (Set_No_Elaboration_Check);
11137    pragma Inline (Set_No_Entities_Ref_In_Spec);
11138    pragma Inline (Set_No_Initialization);
11139    pragma Inline (Set_No_Truncation);
11140    pragma Inline (Set_Null_Present);
11141    pragma Inline (Set_Null_Exclusion_Present);
11142    pragma Inline (Set_Null_Record_Present);
11143    pragma Inline (Set_Object_Definition);
11144    pragma Inline (Set_Original_Discriminant);
11145    pragma Inline (Set_Original_Entity);
11146    pragma Inline (Set_Others_Discrete_Choices);
11147    pragma Inline (Set_Out_Present);
11148    pragma Inline (Set_Parameter_Associations);
11149    pragma Inline (Set_Parameter_Specifications);
11150    pragma Inline (Set_Parameter_List_Truncated);
11151    pragma Inline (Set_Parameter_Type);
11152    pragma Inline (Set_Parent_Spec);
11153    pragma Inline (Set_Position);
11154    pragma Inline (Set_Pragma_Argument_Associations);
11155    pragma Inline (Set_Pragmas_After);
11156    pragma Inline (Set_Pragmas_Before);
11157    pragma Inline (Set_Prefix);
11158    pragma Inline (Set_Present_Expr);
11159    pragma Inline (Set_Prev_Ids);
11160    pragma Inline (Set_Print_In_Hex);
11161    pragma Inline (Set_Private_Declarations);
11162    pragma Inline (Set_Private_Present);
11163    pragma Inline (Set_Procedure_To_Call);
11164    pragma Inline (Set_Proper_Body);
11165    pragma Inline (Set_Protected_Definition);
11166    pragma Inline (Set_Protected_Present);
11167    pragma Inline (Set_Raises_Constraint_Error);
11168    pragma Inline (Set_Range_Constraint);
11169    pragma Inline (Set_Range_Expression);
11170    pragma Inline (Set_Real_Range_Specification);
11171    pragma Inline (Set_Realval);
11172    pragma Inline (Set_Reason);
11173    pragma Inline (Set_Record_Extension_Part);
11174    pragma Inline (Set_Redundant_Use);
11175    pragma Inline (Set_Renaming_Exception);
11176    pragma Inline (Set_Result_Definition);
11177    pragma Inline (Set_Return_Object_Declarations);
11178    pragma Inline (Set_Reverse_Present);
11179    pragma Inline (Set_Right_Opnd);
11180    pragma Inline (Set_Rounded_Result);
11181    pragma Inline (Set_Scope);
11182    pragma Inline (Set_Select_Alternatives);
11183    pragma Inline (Set_Selector_Name);
11184    pragma Inline (Set_Selector_Names);
11185    pragma Inline (Set_Shift_Count_OK);
11186    pragma Inline (Set_Source_Type);
11187    pragma Inline (Set_Specification);
11188    pragma Inline (Set_Statements);
11189    pragma Inline (Set_Static_Processing_OK);
11190    pragma Inline (Set_Storage_Pool);
11191    pragma Inline (Set_Strval);
11192    pragma Inline (Set_Subtype_Indication);
11193    pragma Inline (Set_Subtype_Mark);
11194    pragma Inline (Set_Subtype_Marks);
11195    pragma Inline (Set_Synchronized_Present);
11196    pragma Inline (Set_Tagged_Present);
11197    pragma Inline (Set_Target_Type);
11198    pragma Inline (Set_Task_Definition);
11199    pragma Inline (Set_Task_Present);
11200    pragma Inline (Set_Then_Actions);
11201    pragma Inline (Set_Then_Statements);
11202    pragma Inline (Set_Triggering_Alternative);
11203    pragma Inline (Set_Triggering_Statement);
11204    pragma Inline (Set_Treat_Fixed_As_Integer);
11205    pragma Inline (Set_TSS_Elist);
11206    pragma Inline (Set_Type_Definition);
11207    pragma Inline (Set_Unit);
11208    pragma Inline (Set_Unknown_Discriminants_Present);
11209    pragma Inline (Set_Unreferenced_In_Spec);
11210    pragma Inline (Set_Variant_Part);
11211    pragma Inline (Set_Variants);
11212    pragma Inline (Set_Visible_Declarations);
11213    pragma Inline (Set_Was_Originally_Stub);
11214    pragma Inline (Set_Zero_Cost_Handling);
11215
11216 end Sinfo;