OSDN Git Service

2011-08-02 Ed Schonberg <schonberg@adacore.com>
[pf3gnuchains/gcc-fork.git] / gcc / ada / sem_ch8.adb
1 ------------------------------------------------------------------------------
2 --                                                                          --
3 --                         GNAT COMPILER COMPONENTS                         --
4 --                                                                          --
5 --                              S E M . C H 8                               --
6 --                                                                          --
7 --                                 B o d y                                  --
8 --                                                                          --
9 --          Copyright (C) 1992-2010, Free Software Foundation, Inc.         --
10 --                                                                          --
11 -- GNAT is free software;  you can  redistribute it  and/or modify it under --
12 -- terms of the  GNU General Public License as published  by the Free Soft- --
13 -- ware  Foundation;  either version 3,  or (at your option) any later ver- --
14 -- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE.  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 COPYING3.  If not, go to --
19 -- http://www.gnu.org/licenses for a complete copy of the license.          --
20 --                                                                          --
21 -- GNAT was originally developed  by the GNAT team at  New York University. --
22 -- Extensive contributions were provided by Ada Core Technologies Inc.      --
23 --                                                                          --
24 ------------------------------------------------------------------------------
25
26 with Atree;    use Atree;
27 with Debug;    use Debug;
28 with Einfo;    use Einfo;
29 with Elists;   use Elists;
30 with Errout;   use Errout;
31 with Exp_Tss;  use Exp_Tss;
32 with Exp_Util; use Exp_Util;
33 with Fname;    use Fname;
34 with Freeze;   use Freeze;
35 with Impunit;  use Impunit;
36 with Lib;      use Lib;
37 with Lib.Load; use Lib.Load;
38 with Lib.Xref; use Lib.Xref;
39 with Namet;    use Namet;
40 with Namet.Sp; use Namet.Sp;
41 with Nlists;   use Nlists;
42 with Nmake;    use Nmake;
43 with Opt;      use Opt;
44 with Output;   use Output;
45 with Restrict; use Restrict;
46 with Rident;   use Rident;
47 with Rtsfind;  use Rtsfind;
48 with Sem;      use Sem;
49 with Sem_Aux;  use Sem_Aux;
50 with Sem_Cat;  use Sem_Cat;
51 with Sem_Ch3;  use Sem_Ch3;
52 with Sem_Ch4;  use Sem_Ch4;
53 with Sem_Ch6;  use Sem_Ch6;
54 with Sem_Ch12; use Sem_Ch12;
55 with Sem_Disp; use Sem_Disp;
56 with Sem_Dist; use Sem_Dist;
57 with Sem_Eval; use Sem_Eval;
58 with Sem_Res;  use Sem_Res;
59 with Sem_Util; use Sem_Util;
60 with Sem_Type; use Sem_Type;
61 with Stand;    use Stand;
62 with Sinfo;    use Sinfo;
63 with Sinfo.CN; use Sinfo.CN;
64 with Snames;   use Snames;
65 with Style;    use Style;
66 with Table;
67 with Targparm; use Targparm;
68 with Tbuild;   use Tbuild;
69 with Uintp;    use Uintp;
70
71 package body Sem_Ch8 is
72
73    ------------------------------------
74    -- Visibility and Name Resolution --
75    ------------------------------------
76
77    --  This package handles name resolution and the collection of
78    --  interpretations for overloaded names, prior to overload resolution.
79
80    --  Name resolution is the process that establishes a mapping between source
81    --  identifiers and the entities they denote at each point in the program.
82    --  Each entity is represented by a defining occurrence. Each identifier
83    --  that denotes an entity points to the corresponding defining occurrence.
84    --  This is the entity of the applied occurrence. Each occurrence holds
85    --  an index into the names table, where source identifiers are stored.
86
87    --  Each entry in the names table for an identifier or designator uses the
88    --  Info pointer to hold a link to the currently visible entity that has
89    --  this name (see subprograms Get_Name_Entity_Id and Set_Name_Entity_Id
90    --  in package Sem_Util). The visibility is initialized at the beginning of
91    --  semantic processing to make entities in package Standard immediately
92    --  visible. The visibility table is used in a more subtle way when
93    --  compiling subunits (see below).
94
95    --  Entities that have the same name (i.e. homonyms) are chained. In the
96    --  case of overloaded entities, this chain holds all the possible meanings
97    --  of a given identifier. The process of overload resolution uses type
98    --  information to select from this chain the unique meaning of a given
99    --  identifier.
100
101    --  Entities are also chained in their scope, through the Next_Entity link.
102    --  As a consequence, the name space is organized as a sparse matrix, where
103    --  each row corresponds to a scope, and each column to a source identifier.
104    --  Open scopes, that is to say scopes currently being compiled, have their
105    --  corresponding rows of entities in order, innermost scope first.
106
107    --  The scopes of packages that are mentioned in  context clauses appear in
108    --  no particular order, interspersed among open scopes. This is because
109    --  in the course of analyzing the context of a compilation, a package
110    --  declaration is first an open scope, and subsequently an element of the
111    --  context. If subunits or child units are present, a parent unit may
112    --  appear under various guises at various times in the compilation.
113
114    --  When the compilation of the innermost scope is complete, the entities
115    --  defined therein are no longer visible. If the scope is not a package
116    --  declaration, these entities are never visible subsequently, and can be
117    --  removed from visibility chains. If the scope is a package declaration,
118    --  its visible declarations may still be accessible. Therefore the entities
119    --  defined in such a scope are left on the visibility chains, and only
120    --  their visibility (immediately visibility or potential use-visibility)
121    --  is affected.
122
123    --  The ordering of homonyms on their chain does not necessarily follow
124    --  the order of their corresponding scopes on the scope stack. For
125    --  example, if package P and the enclosing scope both contain entities
126    --  named E, then when compiling the package body the chain for E will
127    --  hold the global entity first,  and the local one (corresponding to
128    --  the current inner scope) next. As a result, name resolution routines
129    --  do not assume any relative ordering of the homonym chains, either
130    --  for scope nesting or to order of appearance of context clauses.
131
132    --  When compiling a child unit, entities in the parent scope are always
133    --  immediately visible. When compiling the body of a child unit, private
134    --  entities in the parent must also be made immediately visible. There
135    --  are separate routines to make the visible and private declarations
136    --  visible at various times (see package Sem_Ch7).
137
138    --              +--------+         +-----+
139    --              | In use |-------->| EU1 |-------------------------->
140    --              +--------+         +-----+
141    --                                    |                      |
142    --      +--------+                 +-----+                +-----+
143    --      | Stand. |---------------->| ES1 |--------------->| ES2 |--->
144    --      +--------+                 +-----+                +-----+
145    --                                    |                      |
146    --              +---------+           |                   +-----+
147    --              | with'ed |------------------------------>| EW2 |--->
148    --              +---------+           |                   +-----+
149    --                                    |                      |
150    --      +--------+                 +-----+                +-----+
151    --      | Scope2 |---------------->| E12 |--------------->| E22 |--->
152    --      +--------+                 +-----+                +-----+
153    --                                    |                      |
154    --      +--------+                 +-----+                +-----+
155    --      | Scope1 |---------------->| E11 |--------------->| E12 |--->
156    --      +--------+                 +-----+                +-----+
157    --          ^                         |                      |
158    --          |                         |                      |
159    --          |   +---------+           |                      |
160    --          |   | with'ed |----------------------------------------->
161    --          |   +---------+           |                      |
162    --          |                         |                      |
163    --      Scope stack                   |                      |
164    --      (innermost first)             |                      |
165    --                                 +----------------------------+
166    --      Names  table =>            | Id1 |     |    |     | Id2 |
167    --                                 +----------------------------+
168
169    --  Name resolution must deal with several syntactic forms: simple names,
170    --  qualified names, indexed names, and various forms of calls.
171
172    --  Each identifier points to an entry in the names table. The resolution
173    --  of a simple name consists in traversing the homonym chain, starting
174    --  from the names table. If an entry is immediately visible, it is the one
175    --  designated by the identifier. If only potentially use-visible entities
176    --  are on the chain, we must verify that they do not hide each other. If
177    --  the entity we find is overloadable, we collect all other overloadable
178    --  entities on the chain as long as they are not hidden.
179    --
180    --  To resolve expanded names, we must find the entity at the intersection
181    --  of the entity chain for the scope (the prefix) and the homonym chain
182    --  for the selector. In general, homonym chains will be much shorter than
183    --  entity chains, so it is preferable to start from the names table as
184    --  well. If the entity found is overloadable, we must collect all other
185    --  interpretations that are defined in the scope denoted by the prefix.
186
187    --  For records, protected types, and tasks, their local entities are
188    --  removed from visibility chains on exit from the corresponding scope.
189    --  From the outside, these entities are always accessed by selected
190    --  notation, and the entity chain for the record type, protected type,
191    --  etc. is traversed sequentially in  order to find the designated entity.
192
193    --  The discriminants of a type and the operations of a protected type or
194    --  task are unchained on  exit from the first view of the type, (such as
195    --  a private or incomplete type declaration, or a protected type speci-
196    --  fication) and re-chained when compiling the second view.
197
198    --  In the case of operators,  we do not make operators on derived types
199    --  explicit. As a result, the notation P."+" may denote either a user-
200    --  defined function with name "+", or else an implicit declaration of the
201    --  operator "+" in package P. The resolution of expanded names always
202    --  tries to resolve an operator name as such an implicitly defined entity,
203    --  in addition to looking for explicit declarations.
204
205    --  All forms of names that denote entities (simple names, expanded names,
206    --  character literals in some cases) have a Entity attribute, which
207    --  identifies the entity denoted by the name.
208
209    ---------------------
210    -- The Scope Stack --
211    ---------------------
212
213    --  The Scope stack keeps track of the scopes currently been compiled.
214    --  Every entity that contains declarations (including records) is placed
215    --  on the scope stack while it is being processed, and removed at the end.
216    --  Whenever a non-package scope is exited, the entities defined therein
217    --  are removed from the visibility table, so that entities in outer scopes
218    --  become visible (see previous description). On entry to Sem, the scope
219    --  stack only contains the package Standard. As usual, subunits complicate
220    --  this picture ever so slightly.
221
222    --  The Rtsfind mechanism can force a call to Semantics while another
223    --  compilation is in progress. The unit retrieved by Rtsfind must be
224    --  compiled in  its own context, and has no access to the visibility of
225    --  the unit currently being compiled. The procedures Save_Scope_Stack and
226    --  Restore_Scope_Stack make entities in current open scopes invisible
227    --  before compiling the retrieved unit, and restore the compilation
228    --  environment afterwards.
229
230    ------------------------
231    -- Compiling subunits --
232    ------------------------
233
234    --  Subunits must be compiled in the environment of the corresponding stub,
235    --  that is to say with the same visibility into the parent (and its
236    --  context) that is available at the point of the stub declaration, but
237    --  with the additional visibility provided by the context clause of the
238    --  subunit itself. As a result, compilation of a subunit forces compilation
239    --  of the parent (see description in lib-). At the point of the stub
240    --  declaration, Analyze is called recursively to compile the proper body of
241    --  the subunit, but without reinitializing the names table, nor the scope
242    --  stack (i.e. standard is not pushed on the stack). In this fashion the
243    --  context of the subunit is added to the context of the parent, and the
244    --  subunit is compiled in the correct environment. Note that in the course
245    --  of processing the context of a subunit, Standard will appear twice on
246    --  the scope stack: once for the parent of the subunit, and once for the
247    --  unit in the context clause being compiled. However, the two sets of
248    --  entities are not linked by homonym chains, so that the compilation of
249    --  any context unit happens in a fresh visibility environment.
250
251    -------------------------------
252    -- Processing of USE Clauses --
253    -------------------------------
254
255    --  Every defining occurrence has a flag indicating if it is potentially use
256    --  visible. Resolution of simple names examines this flag. The processing
257    --  of use clauses consists in setting this flag on all visible entities
258    --  defined in the corresponding package. On exit from the scope of the use
259    --  clause, the corresponding flag must be reset. However, a package may
260    --  appear in several nested use clauses (pathological but legal, alas!)
261    --  which forces us to use a slightly more involved scheme:
262
263    --    a) The defining occurrence for a package holds a flag -In_Use- to
264    --    indicate that it is currently in the scope of a use clause. If a
265    --    redundant use clause is encountered, then the corresponding occurrence
266    --    of the package name is flagged -Redundant_Use-.
267
268    --    b) On exit from a scope, the use clauses in its declarative part are
269    --    scanned. The visibility flag is reset in all entities declared in
270    --    package named in a use clause, as long as the package is not flagged
271    --    as being in a redundant use clause (in which case the outer use
272    --    clause is still in effect, and the direct visibility of its entities
273    --    must be retained).
274
275    --  Note that entities are not removed from their homonym chains on exit
276    --  from the package specification. A subsequent use clause does not need
277    --  to rechain the visible entities, but only to establish their direct
278    --  visibility.
279
280    -----------------------------------
281    -- Handling private declarations --
282    -----------------------------------
283
284    --  The principle that each entity has a single defining occurrence clashes
285    --  with the presence of two separate definitions for private types: the
286    --  first is the private type declaration, and second is the full type
287    --  declaration. It is important that all references to the type point to
288    --  the same defining occurrence, namely the first one. To enforce the two
289    --  separate views of the entity, the corresponding information is swapped
290    --  between the two declarations. Outside of the package, the defining
291    --  occurrence only contains the private declaration information, while in
292    --  the private part and the body of the package the defining occurrence
293    --  contains the full declaration. To simplify the swap, the defining
294    --  occurrence that currently holds the private declaration points to the
295    --  full declaration. During semantic processing the defining occurrence
296    --  also points to a list of private dependents, that is to say access types
297    --  or composite types whose designated types or component types are
298    --  subtypes or derived types of the private type in question. After the
299    --  full declaration has been seen, the private dependents are updated to
300    --  indicate that they have full definitions.
301
302    ------------------------------------
303    -- Handling of Undefined Messages --
304    ------------------------------------
305
306    --  In normal mode, only the first use of an undefined identifier generates
307    --  a message. The table Urefs is used to record error messages that have
308    --  been issued so that second and subsequent ones do not generate further
309    --  messages. However, the second reference causes text to be added to the
310    --  original undefined message noting "(more references follow)". The
311    --  full error list option (-gnatf) forces messages to be generated for
312    --  every reference and disconnects the use of this table.
313
314    type Uref_Entry is record
315       Node : Node_Id;
316       --  Node for identifier for which original message was posted. The
317       --  Chars field of this identifier is used to detect later references
318       --  to the same identifier.
319
320       Err : Error_Msg_Id;
321       --  Records error message Id of original undefined message. Reset to
322       --  No_Error_Msg after the second occurrence, where it is used to add
323       --  text to the original message as described above.
324
325       Nvis : Boolean;
326       --  Set if the message is not visible rather than undefined
327
328       Loc : Source_Ptr;
329       --  Records location of error message. Used to make sure that we do
330       --  not consider a, b : undefined as two separate instances, which
331       --  would otherwise happen, since the parser converts this sequence
332       --  to a : undefined; b : undefined.
333
334    end record;
335
336    package Urefs is new Table.Table (
337      Table_Component_Type => Uref_Entry,
338      Table_Index_Type     => Nat,
339      Table_Low_Bound      => 1,
340      Table_Initial        => 10,
341      Table_Increment      => 100,
342      Table_Name           => "Urefs");
343
344    Candidate_Renaming : Entity_Id;
345    --  Holds a candidate interpretation that appears in a subprogram renaming
346    --  declaration and does not match the given specification, but matches at
347    --  least on the first formal. Allows better error message when given
348    --  specification omits defaulted parameters, a common error.
349
350    -----------------------
351    -- Local Subprograms --
352    -----------------------
353
354    procedure Analyze_Generic_Renaming
355      (N : Node_Id;
356       K : Entity_Kind);
357    --  Common processing for all three kinds of generic renaming declarations.
358    --  Enter new name and indicate that it renames the generic unit.
359
360    procedure Analyze_Renamed_Character
361      (N       : Node_Id;
362       New_S   : Entity_Id;
363       Is_Body : Boolean);
364    --  Renamed entity is given by a character literal, which must belong
365    --  to the return type of the new entity. Is_Body indicates whether the
366    --  declaration is a renaming_as_body. If the original declaration has
367    --  already been frozen (because of an intervening body, e.g.) the body of
368    --  the function must be built now. The same applies to the following
369    --  various renaming procedures.
370
371    procedure Analyze_Renamed_Dereference
372      (N       : Node_Id;
373       New_S   : Entity_Id;
374       Is_Body : Boolean);
375    --  Renamed entity is given by an explicit dereference. Prefix must be a
376    --  conformant access_to_subprogram type.
377
378    procedure Analyze_Renamed_Entry
379      (N       : Node_Id;
380       New_S   : Entity_Id;
381       Is_Body : Boolean);
382    --  If the renamed entity in a subprogram renaming is an entry or protected
383    --  subprogram, build a body for the new entity whose only statement is a
384    --  call to the renamed entity.
385
386    procedure Analyze_Renamed_Family_Member
387      (N       : Node_Id;
388       New_S   : Entity_Id;
389       Is_Body : Boolean);
390    --  Used when the renamed entity is an indexed component. The prefix must
391    --  denote an entry family.
392
393    procedure Analyze_Renamed_Primitive_Operation
394      (N       : Node_Id;
395       New_S   : Entity_Id;
396       Is_Body : Boolean);
397    --  If the renamed entity in a subprogram renaming is a primitive operation
398    --  or a class-wide operation in prefix form, save the target object, which
399    --  must be added to the list of actuals in any subsequent call.
400
401    function Applicable_Use (Pack_Name : Node_Id) return Boolean;
402    --  Common code to Use_One_Package and Set_Use, to determine whether use
403    --  clause must be processed. Pack_Name is an entity name that references
404    --  the package in question.
405
406    procedure Attribute_Renaming (N : Node_Id);
407    --  Analyze renaming of attribute as subprogram. The renaming declaration N
408    --  is rewritten as a subprogram body that returns the attribute reference
409    --  applied to the formals of the function.
410
411    procedure Set_Entity_Or_Discriminal (N : Node_Id; E : Entity_Id);
412    --  Set Entity, with style check if need be. For a discriminant reference,
413    --  replace by the corresponding discriminal, i.e. the parameter of the
414    --  initialization procedure that corresponds to the discriminant.
415
416    procedure Check_Frozen_Renaming (N : Node_Id; Subp : Entity_Id);
417    --  A renaming_as_body may occur after the entity of the original decla-
418    --  ration has been frozen. In that case, the body of the new entity must
419    --  be built now, because the usual mechanism of building the renamed
420    --  body at the point of freezing will not work. Subp is the subprogram
421    --  for which N provides the Renaming_As_Body.
422
423    procedure Check_In_Previous_With_Clause
424      (N   : Node_Id;
425       Nam : Node_Id);
426    --  N is a use_package clause and Nam the package name, or N is a use_type
427    --  clause and Nam is the prefix of the type name. In either case, verify
428    --  that the package is visible at that point in the context: either  it
429    --  appears in a previous with_clause, or because it is a fully qualified
430    --  name and the root ancestor appears in a previous with_clause.
431
432    procedure Check_Library_Unit_Renaming (N : Node_Id; Old_E : Entity_Id);
433    --  Verify that the entity in a renaming declaration that is a library unit
434    --  is itself a library unit and not a nested unit or subunit. Also check
435    --  that if the renaming is a child unit of a generic parent, then the
436    --  renamed unit must also be a child unit of that parent. Finally, verify
437    --  that a renamed generic unit is not an implicit child declared within
438    --  an instance of the parent.
439
440    procedure Chain_Use_Clause (N : Node_Id);
441    --  Chain use clause onto list of uses clauses headed by First_Use_Clause in
442    --  the proper scope table entry. This is usually the current scope, but it
443    --  will be an inner scope when installing the use clauses of the private
444    --  declarations of a parent unit prior to compiling the private part of a
445    --  child unit. This chain is traversed when installing/removing use clauses
446    --  when compiling a subunit or instantiating a generic body on the fly,
447    --  when it is necessary to save and restore full environments.
448
449    function Has_Implicit_Character_Literal (N : Node_Id) return Boolean;
450    --  Find a type derived from Character or Wide_Character in the prefix of N.
451    --  Used to resolved qualified names whose selector is a character literal.
452
453    function Has_Private_With (E : Entity_Id) return Boolean;
454    --  Ada 2005 (AI-262): Determines if the current compilation unit has a
455    --  private with on E.
456
457    procedure Find_Expanded_Name (N : Node_Id);
458    --  The input is a selected component known to be an expanded name. Verify
459    --  legality of selector given the scope denoted by prefix, and change node
460    --  N into a expanded name with a properly set Entity field.
461
462    function Find_Renamed_Entity
463      (N         : Node_Id;
464       Nam       : Node_Id;
465       New_S     : Entity_Id;
466       Is_Actual : Boolean := False) return Entity_Id;
467    --  Find the renamed entity that corresponds to the given parameter profile
468    --  in a subprogram renaming declaration. The renamed entity may be an
469    --  operator, a subprogram, an entry, or a protected operation. Is_Actual
470    --  indicates that the renaming is the one generated for an actual subpro-
471    --  gram in an instance, for which special visibility checks apply.
472
473    function Has_Implicit_Operator (N : Node_Id) return Boolean;
474    --  N is an expanded name whose selector is an operator name (e.g. P."+").
475    --  declarative part contains an implicit declaration of an operator if it
476    --  has a declaration of a type to which one of the predefined operators
477    --  apply. The existence of this routine is an implementation artifact. A
478    --  more straightforward but more space-consuming choice would be to make
479    --  all inherited operators explicit in the symbol table.
480
481    procedure Inherit_Renamed_Profile (New_S : Entity_Id; Old_S : Entity_Id);
482    --  A subprogram defined by a renaming declaration inherits the parameter
483    --  profile of the renamed entity. The subtypes given in the subprogram
484    --  specification are discarded and replaced with those of the renamed
485    --  subprogram, which are then used to recheck the default values.
486
487    function Is_Appropriate_For_Record (T : Entity_Id) return Boolean;
488    --  Prefix is appropriate for record if it is of a record type, or an access
489    --  to such.
490
491    function Is_Appropriate_For_Entry_Prefix (T : Entity_Id) return Boolean;
492    --  True if it is of a task type, a protected type, or else an access to one
493    --  of these types.
494
495    procedure Note_Redundant_Use (Clause : Node_Id);
496    --  Mark the name in a use clause as redundant if the corresponding entity
497    --  is already use-visible. Emit a warning if the use clause comes from
498    --  source and the proper warnings are enabled.
499
500    procedure Premature_Usage (N : Node_Id);
501    --  Diagnose usage of an entity before it is visible
502
503    procedure Use_One_Package (P : Entity_Id; N : Node_Id);
504    --  Make visible entities declared in package P potentially use-visible
505    --  in the current context. Also used in the analysis of subunits, when
506    --  re-installing use clauses of parent units. N is the use_clause that
507    --  names P (and possibly other packages).
508
509    procedure Use_One_Type (Id : Node_Id);
510    --  Id is the subtype mark from a use type clause. This procedure makes
511    --  the primitive operators of the type potentially use-visible.
512
513    procedure Write_Info;
514    --  Write debugging information on entities declared in current scope
515
516    --------------------------------
517    -- Analyze_Exception_Renaming --
518    --------------------------------
519
520    --  The language only allows a single identifier, but the tree holds an
521    --  identifier list. The parser has already issued an error message if
522    --  there is more than one element in the list.
523
524    procedure Analyze_Exception_Renaming (N : Node_Id) is
525       Id  : constant Node_Id := Defining_Identifier (N);
526       Nam : constant Node_Id := Name (N);
527
528    begin
529       --  Exception renaming is not allowed in SPARK or ALFA
530
531       if Formal_Verification_Mode then
532          Error_Msg_F ("|~~exception renaming is not allowed", N);
533       end if;
534
535       --  Proceed with analysis
536
537       Enter_Name (Id);
538       Analyze (Nam);
539
540       Set_Ekind          (Id, E_Exception);
541       Set_Exception_Code (Id, Uint_0);
542       Set_Etype          (Id, Standard_Exception_Type);
543       Set_Is_Pure        (Id, Is_Pure (Current_Scope));
544
545       if not Is_Entity_Name (Nam) or else
546         Ekind (Entity (Nam)) /= E_Exception
547       then
548          Error_Msg_N ("invalid exception name in renaming", Nam);
549       else
550          if Present (Renamed_Object (Entity (Nam))) then
551             Set_Renamed_Object (Id, Renamed_Object (Entity (Nam)));
552          else
553             Set_Renamed_Object (Id, Entity (Nam));
554          end if;
555       end if;
556    end Analyze_Exception_Renaming;
557
558    ---------------------------
559    -- Analyze_Expanded_Name --
560    ---------------------------
561
562    procedure Analyze_Expanded_Name (N : Node_Id) is
563    begin
564       --  If the entity pointer is already set, this is an internal node, or a
565       --  node that is analyzed more than once, after a tree modification. In
566       --  such a case there is no resolution to perform, just set the type. For
567       --  completeness, analyze prefix as well.
568
569       if Present (Entity (N)) then
570          if Is_Type (Entity (N)) then
571             Set_Etype (N, Entity (N));
572          else
573             Set_Etype (N, Etype (Entity (N)));
574          end if;
575
576          Analyze (Prefix (N));
577          return;
578       else
579          Find_Expanded_Name (N);
580       end if;
581    end Analyze_Expanded_Name;
582
583    ---------------------------------------
584    -- Analyze_Generic_Function_Renaming --
585    ---------------------------------------
586
587    procedure Analyze_Generic_Function_Renaming  (N : Node_Id) is
588    begin
589       Analyze_Generic_Renaming (N, E_Generic_Function);
590    end Analyze_Generic_Function_Renaming;
591
592    --------------------------------------
593    -- Analyze_Generic_Package_Renaming --
594    --------------------------------------
595
596    procedure Analyze_Generic_Package_Renaming   (N : Node_Id) is
597    begin
598       --  Apply the Text_IO Kludge here, since we may be renaming one of the
599       --  subpackages of Text_IO, then join common routine.
600
601       Text_IO_Kludge (Name (N));
602
603       Analyze_Generic_Renaming (N, E_Generic_Package);
604    end Analyze_Generic_Package_Renaming;
605
606    ----------------------------------------
607    -- Analyze_Generic_Procedure_Renaming --
608    ----------------------------------------
609
610    procedure Analyze_Generic_Procedure_Renaming (N : Node_Id) is
611    begin
612       Analyze_Generic_Renaming (N, E_Generic_Procedure);
613    end Analyze_Generic_Procedure_Renaming;
614
615    ------------------------------
616    -- Analyze_Generic_Renaming --
617    ------------------------------
618
619    procedure Analyze_Generic_Renaming
620      (N : Node_Id;
621       K : Entity_Kind)
622    is
623       New_P : constant Entity_Id := Defining_Entity (N);
624       Old_P : Entity_Id;
625       Inst  : Boolean   := False; -- prevent junk warning
626
627    begin
628       --  Generic renaming is not allowed in SPARK or ALFA
629
630       if Formal_Verification_Mode then
631          Error_Msg_F ("|~~generic renaming is not allowed", N);
632       end if;
633
634       --  Proceed with analysis
635
636       if Name (N) = Error then
637          return;
638       end if;
639
640       Generate_Definition (New_P);
641
642       if Current_Scope /= Standard_Standard then
643          Set_Is_Pure (New_P, Is_Pure (Current_Scope));
644       end if;
645
646       if Nkind (Name (N)) = N_Selected_Component then
647          Check_Generic_Child_Unit (Name (N), Inst);
648       else
649          Analyze (Name (N));
650       end if;
651
652       if not Is_Entity_Name (Name (N)) then
653          Error_Msg_N ("expect entity name in renaming declaration", Name (N));
654          Old_P := Any_Id;
655       else
656          Old_P := Entity (Name (N));
657       end if;
658
659       Enter_Name (New_P);
660       Set_Ekind (New_P, K);
661
662       if Etype (Old_P) = Any_Type then
663          null;
664
665       elsif Ekind (Old_P) /= K then
666          Error_Msg_N ("invalid generic unit name", Name (N));
667
668       else
669          if Present (Renamed_Object (Old_P)) then
670             Set_Renamed_Object (New_P,  Renamed_Object (Old_P));
671          else
672             Set_Renamed_Object (New_P, Old_P);
673          end if;
674
675          Set_Is_Pure          (New_P, Is_Pure          (Old_P));
676          Set_Is_Preelaborated (New_P, Is_Preelaborated (Old_P));
677
678          Set_Etype (New_P, Etype (Old_P));
679          Set_Has_Completion (New_P);
680
681          if In_Open_Scopes (Old_P) then
682             Error_Msg_N ("within its scope, generic denotes its instance", N);
683          end if;
684
685          Check_Library_Unit_Renaming (N, Old_P);
686       end if;
687    end Analyze_Generic_Renaming;
688
689    -----------------------------
690    -- Analyze_Object_Renaming --
691    -----------------------------
692
693    procedure Analyze_Object_Renaming (N : Node_Id) is
694       Id  : constant Entity_Id := Defining_Identifier (N);
695       Dec : Node_Id;
696       Nam : constant Node_Id   := Name (N);
697       T   : Entity_Id;
698       T2  : Entity_Id;
699
700       function In_Generic_Scope (E : Entity_Id) return Boolean;
701       --  Determine whether entity E is inside a generic cope
702
703       ----------------------
704       -- In_Generic_Scope --
705       ----------------------
706
707       function In_Generic_Scope (E : Entity_Id) return Boolean is
708          S : Entity_Id;
709
710       begin
711          S := Scope (E);
712          while Present (S) and then S /= Standard_Standard loop
713             if Is_Generic_Unit (S) then
714                return True;
715             end if;
716
717             S := Scope (S);
718          end loop;
719
720          return False;
721       end In_Generic_Scope;
722
723    --  Start of processing for Analyze_Object_Renaming
724
725    begin
726       --  Object renaming is not allowed in SPARK or ALFA
727
728       if Formal_Verification_Mode then
729          Error_Msg_F ("|~~object renaming is not allowed", N);
730       end if;
731
732       --  Proceed with analysis
733
734       if Nam = Error then
735          return;
736       end if;
737
738       Set_Is_Pure (Id, Is_Pure (Current_Scope));
739       Enter_Name (Id);
740
741       --  The renaming of a component that depends on a discriminant requires
742       --  an actual subtype, because in subsequent use of the object Gigi will
743       --  be unable to locate the actual bounds. This explicit step is required
744       --  when the renaming is generated in removing side effects of an
745       --  already-analyzed expression.
746
747       if Nkind (Nam) = N_Selected_Component
748         and then Analyzed (Nam)
749       then
750          T := Etype (Nam);
751          Dec :=  Build_Actual_Subtype_Of_Component (Etype (Nam), Nam);
752
753          if Present (Dec) then
754             Insert_Action (N, Dec);
755             T := Defining_Identifier (Dec);
756             Set_Etype (Nam, T);
757          end if;
758
759          --  Complete analysis of the subtype mark in any case, for ASIS use
760
761          if Present (Subtype_Mark (N)) then
762             Find_Type (Subtype_Mark (N));
763          end if;
764
765       elsif Present (Subtype_Mark (N)) then
766          Find_Type (Subtype_Mark (N));
767          T := Entity (Subtype_Mark (N));
768          Analyze (Nam);
769
770          if Nkind (Nam) = N_Type_Conversion
771             and then not Is_Tagged_Type (T)
772          then
773             Error_Msg_N
774               ("renaming of conversion only allowed for tagged types", Nam);
775          end if;
776
777          Resolve (Nam, T);
778
779          --  Check that a class-wide object is not being renamed as an object
780          --  of a specific type. The test for access types is needed to exclude
781          --  cases where the renamed object is a dynamically tagged access
782          --  result, such as occurs in certain expansions.
783
784          if Is_Tagged_Type (T) then
785             Check_Dynamically_Tagged_Expression
786               (Expr        => Nam,
787                Typ         => T,
788                Related_Nod => N);
789          end if;
790
791       --  Ada 2005 (AI-230/AI-254): Access renaming
792
793       else pragma Assert (Present (Access_Definition (N)));
794          T := Access_Definition
795                 (Related_Nod => N,
796                  N           => Access_Definition (N));
797
798          Analyze (Nam);
799
800          --  Ada 2005 AI05-105: if the declaration has an anonymous access
801          --  type, the renamed object must also have an anonymous type, and
802          --  this is a name resolution rule. This was implicit in the last
803          --  part of the first sentence in 8.5.1.(3/2), and is made explicit
804          --  by this recent AI.
805
806          if not Is_Overloaded (Nam) then
807             if Ekind (Etype (Nam)) /= Ekind (T) then
808                Error_Msg_N
809                  ("expect anonymous access type in object renaming", N);
810             end if;
811
812          else
813             declare
814                I    : Interp_Index;
815                It   : Interp;
816                Typ  : Entity_Id := Empty;
817                Seen : Boolean   := False;
818
819             begin
820                Get_First_Interp (Nam, I, It);
821                while Present (It.Typ) loop
822
823                   --  Renaming is ambiguous if more than one candidate
824                   --  interpretation is type-conformant with the context.
825
826                   if Ekind (It.Typ) = Ekind (T) then
827                      if Ekind (T) = E_Anonymous_Access_Subprogram_Type
828                        and then
829                          Type_Conformant
830                            (Designated_Type (T), Designated_Type (It.Typ))
831                      then
832                         if not Seen then
833                            Seen := True;
834                         else
835                            Error_Msg_N
836                              ("ambiguous expression in renaming", Nam);
837                         end if;
838
839                      elsif Ekind (T) = E_Anonymous_Access_Type
840                        and then
841                          Covers (Designated_Type (T), Designated_Type (It.Typ))
842                      then
843                         if not Seen then
844                            Seen := True;
845                         else
846                            Error_Msg_N
847                              ("ambiguous expression in renaming", Nam);
848                         end if;
849                      end if;
850
851                      if Covers (T, It.Typ) then
852                         Typ := It.Typ;
853                         Set_Etype (Nam, Typ);
854                         Set_Is_Overloaded (Nam, False);
855                      end if;
856                   end if;
857
858                   Get_Next_Interp (I, It);
859                end loop;
860             end;
861          end if;
862
863          Resolve (Nam, T);
864
865          --  Ada 2005 (AI-231): "In the case where the type is defined by an
866          --  access_definition, the renamed entity shall be of an access-to-
867          --  constant type if and only if the access_definition defines an
868          --  access-to-constant type" ARM 8.5.1(4)
869
870          if Constant_Present (Access_Definition (N))
871            and then not Is_Access_Constant (Etype (Nam))
872          then
873             Error_Msg_N ("(Ada 2005): the renamed object is not "
874                          & "access-to-constant (RM 8.5.1(6))", N);
875
876          elsif not Constant_Present (Access_Definition (N))
877            and then Is_Access_Constant (Etype (Nam))
878          then
879             Error_Msg_N ("(Ada 2005): the renamed object is not "
880                          & "access-to-variable (RM 8.5.1(6))", N);
881          end if;
882
883          if Is_Access_Subprogram_Type (Etype (Nam)) then
884             Check_Subtype_Conformant
885               (Designated_Type (T), Designated_Type (Etype (Nam)));
886
887          elsif not Subtypes_Statically_Match
888                      (Designated_Type (T), Designated_Type (Etype (Nam)))
889          then
890             Error_Msg_N
891               ("subtype of renamed object does not statically match", N);
892          end if;
893       end if;
894
895       --  Special processing for renaming function return object. Some errors
896       --  and warnings are produced only for calls that come from source.
897
898       if Nkind (Nam) = N_Function_Call then
899          case Ada_Version is
900
901             --  Usage is illegal in Ada 83
902
903             when Ada_83 =>
904                if Comes_From_Source (Nam) then
905                   Error_Msg_N
906                     ("(Ada 83) cannot rename function return object", Nam);
907                end if;
908
909             --  In Ada 95, warn for odd case of renaming parameterless function
910             --  call if this is not a limited type (where this is useful).
911
912             when others =>
913                if Warn_On_Object_Renames_Function
914                  and then No (Parameter_Associations (Nam))
915                  and then not Is_Limited_Type (Etype (Nam))
916                  and then Comes_From_Source (Nam)
917                then
918                   Error_Msg_N
919                     ("?renaming function result object is suspicious", Nam);
920                   Error_Msg_NE
921                     ("\?function & will be called only once", Nam,
922                      Entity (Name (Nam)));
923                   Error_Msg_N -- CODEFIX
924                     ("\?suggest using an initialized constant object instead",
925                      Nam);
926                end if;
927
928                --  If the function call returns an unconstrained type, we must
929                --  build a constrained subtype for the new entity, in a way
930                --  similar to what is done for an object declaration with an
931                --  unconstrained nominal type.
932
933                if Is_Composite_Type (Etype (Nam))
934                  and then not Is_Constrained (Etype (Nam))
935                  and then not Has_Unknown_Discriminants (Etype (Nam))
936                  and then Expander_Active
937                then
938                   declare
939                      Loc  : constant Source_Ptr := Sloc (N);
940                      Subt : constant Entity_Id  := Make_Temporary (Loc, 'T');
941                   begin
942                      Remove_Side_Effects (Nam);
943                      Insert_Action (N,
944                        Make_Subtype_Declaration (Loc,
945                          Defining_Identifier => Subt,
946                          Subtype_Indication  =>
947                            Make_Subtype_From_Expr (Nam, Etype (Nam))));
948                      Rewrite (Subtype_Mark (N), New_Occurrence_Of (Subt, Loc));
949                      Set_Etype (Nam, Subt);
950                   end;
951                end if;
952          end case;
953       end if;
954
955       --  An object renaming requires an exact match of the type. Class-wide
956       --  matching is not allowed.
957
958       if Is_Class_Wide_Type (T)
959         and then Base_Type (Etype (Nam)) /= Base_Type (T)
960       then
961          Wrong_Type (Nam, T);
962       end if;
963
964       T2 := Etype (Nam);
965
966       --  (Ada 2005: AI-326): Handle wrong use of incomplete type
967
968       if Nkind (Nam) = N_Explicit_Dereference
969         and then Ekind (Etype (T2)) = E_Incomplete_Type
970       then
971          Error_Msg_NE ("invalid use of incomplete type&", Id, T2);
972          return;
973
974       elsif Ekind (Etype (T)) = E_Incomplete_Type then
975          Error_Msg_NE ("invalid use of incomplete type&", Id, T);
976          return;
977       end if;
978
979       --  Ada 2005 (AI-327)
980
981       if Ada_Version >= Ada_2005
982         and then Nkind (Nam) = N_Attribute_Reference
983         and then Attribute_Name (Nam) = Name_Priority
984       then
985          null;
986
987       elsif Ada_Version >= Ada_2005
988         and then Nkind (Nam) in N_Has_Entity
989       then
990          declare
991             Nam_Decl : Node_Id;
992             Nam_Ent  : Entity_Id;
993
994          begin
995             if Nkind (Nam) = N_Attribute_Reference then
996                Nam_Ent := Entity (Prefix (Nam));
997             else
998                Nam_Ent := Entity (Nam);
999             end if;
1000
1001             Nam_Decl := Parent (Nam_Ent);
1002
1003             if Has_Null_Exclusion (N)
1004               and then not Has_Null_Exclusion (Nam_Decl)
1005             then
1006                --  Ada 2005 (AI-423): If the object name denotes a generic
1007                --  formal object of a generic unit G, and the object renaming
1008                --  declaration occurs within the body of G or within the body
1009                --  of a generic unit declared within the declarative region
1010                --  of G, then the declaration of the formal object of G must
1011                --  have a null exclusion or a null-excluding subtype.
1012
1013                if Is_Formal_Object (Nam_Ent)
1014                     and then In_Generic_Scope (Id)
1015                then
1016                   if not Can_Never_Be_Null (Etype (Nam_Ent)) then
1017                      Error_Msg_N
1018                        ("renamed formal does not exclude `NULL` "
1019                         & "(RM 8.5.1(4.6/2))", N);
1020
1021                   elsif In_Package_Body (Scope (Id)) then
1022                      Error_Msg_N
1023                        ("formal object does not have a null exclusion"
1024                         & "(RM 8.5.1(4.6/2))", N);
1025                   end if;
1026
1027                --  Ada 2005 (AI-423): Otherwise, the subtype of the object name
1028                --  shall exclude null.
1029
1030                elsif not Can_Never_Be_Null (Etype (Nam_Ent)) then
1031                   Error_Msg_N
1032                     ("renamed object does not exclude `NULL` "
1033                      & "(RM 8.5.1(4.6/2))", N);
1034
1035                --  An instance is illegal if it contains a renaming that
1036                --  excludes null, and the actual does not. The renaming
1037                --  declaration has already indicated that the declaration
1038                --  of the renamed actual in the instance will raise
1039                --  constraint_error.
1040
1041                elsif Nkind (Nam_Decl) = N_Object_Declaration
1042                  and then In_Instance
1043                  and then Present
1044                    (Corresponding_Generic_Association (Nam_Decl))
1045                  and then Nkind (Expression (Nam_Decl))
1046                    = N_Raise_Constraint_Error
1047                then
1048                   Error_Msg_N
1049                     ("renamed actual does not exclude `NULL` "
1050                      & "(RM 8.5.1(4.6/2))", N);
1051
1052                --  Finally, if there is a null exclusion, the subtype mark
1053                --  must not be null-excluding.
1054
1055                elsif No (Access_Definition (N))
1056                  and then Can_Never_Be_Null (T)
1057                then
1058                   Error_Msg_NE
1059                     ("`NOT NULL` not allowed (& already excludes null)",
1060                       N, T);
1061
1062                end if;
1063
1064             elsif Can_Never_Be_Null (T)
1065               and then not Can_Never_Be_Null (Etype (Nam_Ent))
1066             then
1067                Error_Msg_N
1068                  ("renamed object does not exclude `NULL` "
1069                   & "(RM 8.5.1(4.6/2))", N);
1070
1071             elsif Has_Null_Exclusion (N)
1072               and then No (Access_Definition (N))
1073               and then Can_Never_Be_Null (T)
1074             then
1075                Error_Msg_NE
1076                  ("`NOT NULL` not allowed (& already excludes null)", N, T);
1077             end if;
1078          end;
1079       end if;
1080
1081       Set_Ekind (Id, E_Variable);
1082       Init_Size_Align (Id);
1083
1084       if T = Any_Type or else Etype (Nam) = Any_Type then
1085          return;
1086
1087       --  Verify that the renamed entity is an object or a function call. It
1088       --  may have been rewritten in several ways.
1089
1090       elsif Is_Object_Reference (Nam) then
1091          if Comes_From_Source (N)
1092            and then Is_Dependent_Component_Of_Mutable_Object (Nam)
1093          then
1094             Error_Msg_N
1095               ("illegal renaming of discriminant-dependent component", Nam);
1096          end if;
1097
1098       --  A static function call may have been folded into a literal
1099
1100       elsif Nkind (Original_Node (Nam)) = N_Function_Call
1101
1102             --  When expansion is disabled, attribute reference is not
1103             --  rewritten as function call. Otherwise it may be rewritten
1104             --  as a conversion, so check original node.
1105
1106         or else (Nkind (Original_Node (Nam)) = N_Attribute_Reference
1107                   and then Is_Function_Attribute_Name
1108                              (Attribute_Name (Original_Node (Nam))))
1109
1110             --  Weird but legal, equivalent to renaming a function call.
1111             --  Illegal if the literal is the result of constant-folding an
1112             --  attribute reference that is not a function.
1113
1114         or else (Is_Entity_Name (Nam)
1115                   and then Ekind (Entity (Nam)) = E_Enumeration_Literal
1116                   and then
1117                     Nkind (Original_Node (Nam)) /= N_Attribute_Reference)
1118
1119         or else (Nkind (Nam) = N_Type_Conversion
1120                     and then Is_Tagged_Type (Entity (Subtype_Mark (Nam))))
1121       then
1122          null;
1123
1124       elsif Nkind (Nam) = N_Type_Conversion then
1125          Error_Msg_N
1126            ("renaming of conversion only allowed for tagged types", Nam);
1127
1128       --  Ada 2005 (AI-327)
1129
1130       elsif Ada_Version >= Ada_2005
1131         and then Nkind (Nam) = N_Attribute_Reference
1132         and then Attribute_Name (Nam) = Name_Priority
1133       then
1134          null;
1135
1136       --  Allow internally generated x'Reference expression
1137
1138       elsif Nkind (Nam) = N_Reference then
1139          null;
1140
1141       else
1142          Error_Msg_N ("expect object name in renaming", Nam);
1143       end if;
1144
1145       Set_Etype (Id, T2);
1146
1147       if not Is_Variable (Nam) then
1148          Set_Ekind               (Id, E_Constant);
1149          Set_Never_Set_In_Source (Id, True);
1150          Set_Is_True_Constant    (Id, True);
1151       end if;
1152
1153       Set_Renamed_Object (Id, Nam);
1154    end Analyze_Object_Renaming;
1155
1156    ------------------------------
1157    -- Analyze_Package_Renaming --
1158    ------------------------------
1159
1160    procedure Analyze_Package_Renaming (N : Node_Id) is
1161       New_P : constant Entity_Id := Defining_Entity (N);
1162       Old_P : Entity_Id;
1163       Spec  : Node_Id;
1164
1165    begin
1166       if Name (N) = Error then
1167          return;
1168       end if;
1169
1170       --  Apply Text_IO kludge here since we may be renaming a child of Text_IO
1171
1172       Text_IO_Kludge (Name (N));
1173
1174       if Current_Scope /= Standard_Standard then
1175          Set_Is_Pure (New_P, Is_Pure (Current_Scope));
1176       end if;
1177
1178       Enter_Name (New_P);
1179       Analyze (Name (N));
1180
1181       if Is_Entity_Name (Name (N)) then
1182          Old_P := Entity (Name (N));
1183       else
1184          Old_P := Any_Id;
1185       end if;
1186
1187       if Etype (Old_P) = Any_Type then
1188          Error_Msg_N ("expect package name in renaming", Name (N));
1189
1190       elsif Ekind (Old_P) /= E_Package
1191         and then not (Ekind (Old_P) = E_Generic_Package
1192                        and then In_Open_Scopes (Old_P))
1193       then
1194          if Ekind (Old_P) = E_Generic_Package then
1195             Error_Msg_N
1196                ("generic package cannot be renamed as a package", Name (N));
1197          else
1198             Error_Msg_Sloc := Sloc (Old_P);
1199             Error_Msg_NE
1200              ("expect package name in renaming, found& declared#",
1201                Name (N), Old_P);
1202          end if;
1203
1204          --  Set basic attributes to minimize cascaded errors
1205
1206          Set_Ekind (New_P, E_Package);
1207          Set_Etype (New_P, Standard_Void_Type);
1208
1209       --  Here for OK package renaming
1210
1211       else
1212          --  Entities in the old package are accessible through the renaming
1213          --  entity. The simplest implementation is to have both packages share
1214          --  the entity list.
1215
1216          Set_Ekind (New_P, E_Package);
1217          Set_Etype (New_P, Standard_Void_Type);
1218
1219          if Present (Renamed_Object (Old_P)) then
1220             Set_Renamed_Object (New_P,  Renamed_Object (Old_P));
1221          else
1222             Set_Renamed_Object (New_P, Old_P);
1223          end if;
1224
1225          Set_Has_Completion (New_P);
1226
1227          Set_First_Entity (New_P,  First_Entity (Old_P));
1228          Set_Last_Entity  (New_P,  Last_Entity  (Old_P));
1229          Set_First_Private_Entity (New_P, First_Private_Entity (Old_P));
1230          Check_Library_Unit_Renaming (N, Old_P);
1231          Generate_Reference (Old_P, Name (N));
1232
1233          --  If the renaming is in the visible part of a package, then we set
1234          --  Renamed_In_Spec for the renamed package, to prevent giving
1235          --  warnings about no entities referenced. Such a warning would be
1236          --  overenthusiastic, since clients can see entities in the renamed
1237          --  package via the visible package renaming.
1238
1239          declare
1240             Ent : constant Entity_Id := Cunit_Entity (Current_Sem_Unit);
1241          begin
1242             if Ekind (Ent) = E_Package
1243               and then not In_Private_Part (Ent)
1244               and then In_Extended_Main_Source_Unit (N)
1245               and then Ekind (Old_P) = E_Package
1246             then
1247                Set_Renamed_In_Spec (Old_P);
1248             end if;
1249          end;
1250
1251          --  If this is the renaming declaration of a package instantiation
1252          --  within itself, it is the declaration that ends the list of actuals
1253          --  for the instantiation. At this point, the subtypes that rename
1254          --  the actuals are flagged as generic, to avoid spurious ambiguities
1255          --  if the actuals for two distinct formals happen to coincide. If
1256          --  the actual is a private type, the subtype has a private completion
1257          --  that is flagged in the same fashion.
1258
1259          --  Resolution is identical to what is was in the original generic.
1260          --  On exit from the generic instance, these are turned into regular
1261          --  subtypes again, so they are compatible with types in their class.
1262
1263          if not Is_Generic_Instance (Old_P) then
1264             return;
1265          else
1266             Spec := Specification (Unit_Declaration_Node (Old_P));
1267          end if;
1268
1269          if Nkind (Spec) = N_Package_Specification
1270            and then Present (Generic_Parent (Spec))
1271            and then Old_P = Current_Scope
1272            and then Chars (New_P) = Chars (Generic_Parent (Spec))
1273          then
1274             declare
1275                E : Entity_Id;
1276
1277             begin
1278                E := First_Entity (Old_P);
1279                while Present (E)
1280                  and then E /= New_P
1281                loop
1282                   if Is_Type (E)
1283                     and then Nkind (Parent (E)) = N_Subtype_Declaration
1284                   then
1285                      Set_Is_Generic_Actual_Type (E);
1286
1287                      if Is_Private_Type (E)
1288                        and then Present (Full_View (E))
1289                      then
1290                         Set_Is_Generic_Actual_Type (Full_View (E));
1291                      end if;
1292                   end if;
1293
1294                   Next_Entity (E);
1295                end loop;
1296             end;
1297          end if;
1298       end if;
1299    end Analyze_Package_Renaming;
1300
1301    -------------------------------
1302    -- Analyze_Renamed_Character --
1303    -------------------------------
1304
1305    procedure Analyze_Renamed_Character
1306      (N       : Node_Id;
1307       New_S   : Entity_Id;
1308       Is_Body : Boolean)
1309    is
1310       C : constant Node_Id := Name (N);
1311
1312    begin
1313       if Ekind (New_S) = E_Function then
1314          Resolve (C, Etype (New_S));
1315
1316          if Is_Body then
1317             Check_Frozen_Renaming (N, New_S);
1318          end if;
1319
1320       else
1321          Error_Msg_N ("character literal can only be renamed as function", N);
1322       end if;
1323    end Analyze_Renamed_Character;
1324
1325    ---------------------------------
1326    -- Analyze_Renamed_Dereference --
1327    ---------------------------------
1328
1329    procedure Analyze_Renamed_Dereference
1330      (N       : Node_Id;
1331       New_S   : Entity_Id;
1332       Is_Body : Boolean)
1333    is
1334       Nam : constant Node_Id := Name (N);
1335       P   : constant Node_Id := Prefix (Nam);
1336       Typ : Entity_Id;
1337       Ind : Interp_Index;
1338       It  : Interp;
1339
1340    begin
1341       if not Is_Overloaded (P) then
1342          if Ekind (Etype (Nam)) /= E_Subprogram_Type
1343            or else not Type_Conformant (Etype (Nam), New_S)
1344          then
1345             Error_Msg_N ("designated type does not match specification", P);
1346          else
1347             Resolve (P);
1348          end if;
1349
1350          return;
1351
1352       else
1353          Typ := Any_Type;
1354          Get_First_Interp (Nam, Ind, It);
1355
1356          while Present (It.Nam) loop
1357
1358             if Ekind (It.Nam) = E_Subprogram_Type
1359               and then Type_Conformant (It.Nam, New_S)
1360             then
1361                if Typ /= Any_Id then
1362                   Error_Msg_N ("ambiguous renaming", P);
1363                   return;
1364                else
1365                   Typ := It.Nam;
1366                end if;
1367             end if;
1368
1369             Get_Next_Interp (Ind, It);
1370          end loop;
1371
1372          if Typ = Any_Type then
1373             Error_Msg_N ("designated type does not match specification", P);
1374          else
1375             Resolve (N, Typ);
1376
1377             if Is_Body then
1378                Check_Frozen_Renaming (N, New_S);
1379             end if;
1380          end if;
1381       end if;
1382    end Analyze_Renamed_Dereference;
1383
1384    ---------------------------
1385    -- Analyze_Renamed_Entry --
1386    ---------------------------
1387
1388    procedure Analyze_Renamed_Entry
1389      (N       : Node_Id;
1390       New_S   : Entity_Id;
1391       Is_Body : Boolean)
1392    is
1393       Nam   : constant Node_Id := Name (N);
1394       Sel   : constant Node_Id := Selector_Name (Nam);
1395       Old_S : Entity_Id;
1396
1397    begin
1398       if Entity (Sel) = Any_Id then
1399
1400          --  Selector is undefined on prefix. Error emitted already
1401
1402          Set_Has_Completion (New_S);
1403          return;
1404       end if;
1405
1406       --  Otherwise find renamed entity and build body of New_S as a call to it
1407
1408       Old_S := Find_Renamed_Entity (N, Selector_Name (Nam), New_S);
1409
1410       if Old_S = Any_Id then
1411          Error_Msg_N (" no subprogram or entry matches specification",  N);
1412       else
1413          if Is_Body then
1414             Check_Subtype_Conformant (New_S, Old_S, N);
1415             Generate_Reference (New_S, Defining_Entity (N), 'b');
1416             Style.Check_Identifier (Defining_Entity (N), New_S);
1417
1418          else
1419             --  Only mode conformance required for a renaming_as_declaration
1420
1421             Check_Mode_Conformant (New_S, Old_S, N);
1422          end if;
1423
1424          Inherit_Renamed_Profile (New_S, Old_S);
1425
1426          --  The prefix can be an arbitrary expression that yields a task type,
1427          --  so it must be resolved.
1428
1429          Resolve (Prefix (Nam), Scope (Old_S));
1430       end if;
1431
1432       Set_Convention (New_S, Convention (Old_S));
1433       Set_Has_Completion (New_S, Inside_A_Generic);
1434
1435       if Is_Body then
1436          Check_Frozen_Renaming (N, New_S);
1437       end if;
1438    end Analyze_Renamed_Entry;
1439
1440    -----------------------------------
1441    -- Analyze_Renamed_Family_Member --
1442    -----------------------------------
1443
1444    procedure Analyze_Renamed_Family_Member
1445      (N       : Node_Id;
1446       New_S   : Entity_Id;
1447       Is_Body : Boolean)
1448    is
1449       Nam   : constant Node_Id := Name (N);
1450       P     : constant Node_Id := Prefix (Nam);
1451       Old_S : Entity_Id;
1452
1453    begin
1454       if (Is_Entity_Name (P) and then Ekind (Entity (P)) = E_Entry_Family)
1455         or else (Nkind (P) = N_Selected_Component
1456                    and then
1457                  Ekind (Entity (Selector_Name (P))) = E_Entry_Family)
1458       then
1459          if Is_Entity_Name (P) then
1460             Old_S := Entity (P);
1461          else
1462             Old_S := Entity (Selector_Name (P));
1463          end if;
1464
1465          if not Entity_Matches_Spec (Old_S, New_S) then
1466             Error_Msg_N ("entry family does not match specification", N);
1467
1468          elsif Is_Body then
1469             Check_Subtype_Conformant (New_S, Old_S, N);
1470             Generate_Reference (New_S, Defining_Entity (N), 'b');
1471             Style.Check_Identifier (Defining_Entity (N), New_S);
1472          end if;
1473
1474       else
1475          Error_Msg_N ("no entry family matches specification", N);
1476       end if;
1477
1478       Set_Has_Completion (New_S, Inside_A_Generic);
1479
1480       if Is_Body then
1481          Check_Frozen_Renaming (N, New_S);
1482       end if;
1483    end Analyze_Renamed_Family_Member;
1484
1485    -----------------------------------------
1486    -- Analyze_Renamed_Primitive_Operation --
1487    -----------------------------------------
1488
1489    procedure Analyze_Renamed_Primitive_Operation
1490      (N       : Node_Id;
1491       New_S   : Entity_Id;
1492       Is_Body : Boolean)
1493    is
1494       Old_S : Entity_Id;
1495
1496       function Conforms
1497         (Subp : Entity_Id;
1498          Ctyp : Conformance_Type) return Boolean;
1499       --  Verify that the signatures of the renamed entity and the new entity
1500       --  match. The first formal of the renamed entity is skipped because it
1501       --  is the target object in any subsequent call.
1502
1503       function Conforms
1504         (Subp : Entity_Id;
1505          Ctyp : Conformance_Type) return Boolean
1506       is
1507          Old_F : Entity_Id;
1508          New_F : Entity_Id;
1509
1510       begin
1511          if Ekind (Subp) /= Ekind (New_S) then
1512             return False;
1513          end if;
1514
1515          Old_F := Next_Formal (First_Formal (Subp));
1516          New_F := First_Formal (New_S);
1517          while Present (Old_F) and then Present (New_F) loop
1518             if not Conforming_Types (Etype (Old_F), Etype (New_F), Ctyp) then
1519                return False;
1520             end if;
1521
1522             if Ctyp >= Mode_Conformant
1523               and then Ekind (Old_F) /= Ekind (New_F)
1524             then
1525                return False;
1526             end if;
1527
1528             Next_Formal (New_F);
1529             Next_Formal (Old_F);
1530          end loop;
1531
1532          return True;
1533       end Conforms;
1534
1535    begin
1536       if not Is_Overloaded (Selector_Name (Name (N))) then
1537          Old_S := Entity (Selector_Name (Name (N)));
1538
1539          if not Conforms (Old_S, Type_Conformant) then
1540             Old_S := Any_Id;
1541          end if;
1542
1543       else
1544          --  Find the operation that matches the given signature
1545
1546          declare
1547             It  : Interp;
1548             Ind : Interp_Index;
1549
1550          begin
1551             Old_S := Any_Id;
1552             Get_First_Interp (Selector_Name (Name (N)), Ind, It);
1553
1554             while Present (It.Nam) loop
1555                if Conforms (It.Nam, Type_Conformant) then
1556                   Old_S := It.Nam;
1557                end if;
1558
1559                Get_Next_Interp (Ind, It);
1560             end loop;
1561          end;
1562       end if;
1563
1564       if Old_S = Any_Id then
1565          Error_Msg_N (" no subprogram or entry matches specification",  N);
1566
1567       else
1568          if Is_Body then
1569             if not Conforms (Old_S, Subtype_Conformant) then
1570                Error_Msg_N ("subtype conformance error in renaming", N);
1571             end if;
1572
1573             Generate_Reference (New_S, Defining_Entity (N), 'b');
1574             Style.Check_Identifier (Defining_Entity (N), New_S);
1575
1576          else
1577             --  Only mode conformance required for a renaming_as_declaration
1578
1579             if not Conforms (Old_S, Mode_Conformant) then
1580                Error_Msg_N ("mode conformance error in renaming", N);
1581             end if;
1582          end if;
1583
1584          --  Inherit_Renamed_Profile (New_S, Old_S);
1585
1586          --  The prefix can be an arbitrary expression that yields an
1587          --  object, so it must be resolved.
1588
1589          Resolve (Prefix (Name (N)));
1590       end if;
1591    end Analyze_Renamed_Primitive_Operation;
1592
1593    ---------------------------------
1594    -- Analyze_Subprogram_Renaming --
1595    ---------------------------------
1596
1597    procedure Analyze_Subprogram_Renaming (N : Node_Id) is
1598       Formal_Spec : constant Node_Id          := Corresponding_Formal_Spec (N);
1599       Is_Actual   : constant Boolean          := Present (Formal_Spec);
1600       Inst_Node   : Node_Id                   := Empty;
1601       Nam         : constant Node_Id          := Name (N);
1602       New_S       : Entity_Id;
1603       Old_S       : Entity_Id                 := Empty;
1604       Rename_Spec : Entity_Id;
1605       Save_AV     : constant Ada_Version_Type := Ada_Version;
1606       Save_AV_Exp : constant Ada_Version_Type := Ada_Version_Explicit;
1607       Spec        : constant Node_Id          := Specification (N);
1608
1609       procedure Check_Null_Exclusion
1610         (Ren : Entity_Id;
1611          Sub : Entity_Id);
1612       --  Ada 2005 (AI-423): Given renaming Ren of subprogram Sub, check the
1613       --  following AI rules:
1614       --
1615       --    If Ren is a renaming of a formal subprogram and one of its
1616       --    parameters has a null exclusion, then the corresponding formal
1617       --    in Sub must also have one. Otherwise the subtype of the Sub's
1618       --    formal parameter must exclude null.
1619       --
1620       --    If Ren is a renaming of a formal function and its return
1621       --    profile has a null exclusion, then Sub's return profile must
1622       --    have one. Otherwise the subtype of Sub's return profile must
1623       --    exclude null.
1624
1625       function Original_Subprogram (Subp : Entity_Id) return Entity_Id;
1626       --  Find renamed entity when the declaration is a renaming_as_body and
1627       --  the renamed entity may itself be a renaming_as_body. Used to enforce
1628       --  rule that a renaming_as_body is illegal if the declaration occurs
1629       --  before the subprogram it completes is frozen, and renaming indirectly
1630       --  renames the subprogram itself.(Defect Report 8652/0027).
1631
1632       --------------------------
1633       -- Check_Null_Exclusion --
1634       --------------------------
1635
1636       procedure Check_Null_Exclusion
1637         (Ren : Entity_Id;
1638          Sub : Entity_Id)
1639       is
1640          Ren_Formal : Entity_Id;
1641          Sub_Formal : Entity_Id;
1642
1643       begin
1644          --  Parameter check
1645
1646          Ren_Formal := First_Formal (Ren);
1647          Sub_Formal := First_Formal (Sub);
1648          while Present (Ren_Formal)
1649            and then Present (Sub_Formal)
1650          loop
1651             if Has_Null_Exclusion (Parent (Ren_Formal))
1652               and then
1653                 not (Has_Null_Exclusion (Parent (Sub_Formal))
1654                        or else Can_Never_Be_Null (Etype (Sub_Formal)))
1655             then
1656                Error_Msg_NE
1657                  ("`NOT NULL` required for parameter &",
1658                   Parent (Sub_Formal), Sub_Formal);
1659             end if;
1660
1661             Next_Formal (Ren_Formal);
1662             Next_Formal (Sub_Formal);
1663          end loop;
1664
1665          --  Return profile check
1666
1667          if Nkind (Parent (Ren)) = N_Function_Specification
1668            and then Nkind (Parent (Sub)) = N_Function_Specification
1669            and then Has_Null_Exclusion (Parent (Ren))
1670            and then
1671              not (Has_Null_Exclusion (Parent (Sub))
1672                     or else Can_Never_Be_Null (Etype (Sub)))
1673          then
1674             Error_Msg_N
1675               ("return must specify `NOT NULL`",
1676                Result_Definition (Parent (Sub)));
1677          end if;
1678       end Check_Null_Exclusion;
1679
1680       -------------------------
1681       -- Original_Subprogram --
1682       -------------------------
1683
1684       function Original_Subprogram (Subp : Entity_Id) return Entity_Id is
1685          Orig_Decl : Node_Id;
1686          Orig_Subp : Entity_Id;
1687
1688       begin
1689          --  First case: renamed entity is itself a renaming
1690
1691          if Present (Alias (Subp)) then
1692             return Alias (Subp);
1693
1694          elsif
1695            Nkind (Unit_Declaration_Node (Subp)) = N_Subprogram_Declaration
1696              and then Present
1697               (Corresponding_Body (Unit_Declaration_Node (Subp)))
1698          then
1699             --  Check if renamed entity is a renaming_as_body
1700
1701             Orig_Decl :=
1702               Unit_Declaration_Node
1703                 (Corresponding_Body (Unit_Declaration_Node (Subp)));
1704
1705             if Nkind (Orig_Decl) = N_Subprogram_Renaming_Declaration then
1706                Orig_Subp := Entity (Name (Orig_Decl));
1707
1708                if Orig_Subp = Rename_Spec then
1709
1710                   --  Circularity detected
1711
1712                   return Orig_Subp;
1713
1714                else
1715                   return (Original_Subprogram (Orig_Subp));
1716                end if;
1717             else
1718                return Subp;
1719             end if;
1720          else
1721             return Subp;
1722          end if;
1723       end Original_Subprogram;
1724
1725    --  Start of processing for Analyze_Subprogram_Renaming
1726
1727    begin
1728       --  We must test for the attribute renaming case before the Analyze
1729       --  call because otherwise Sem_Attr will complain that the attribute
1730       --  is missing an argument when it is analyzed.
1731
1732       if Nkind (Nam) = N_Attribute_Reference then
1733
1734          --  In the case of an abstract formal subprogram association, rewrite
1735          --  an actual given by a stream attribute as the name of the
1736          --  corresponding stream primitive of the type.
1737
1738          --  In a generic context the stream operations are not generated, and
1739          --  this must be treated as a normal attribute reference, to be
1740          --  expanded in subsequent instantiations.
1741
1742          if Is_Actual and then Is_Abstract_Subprogram (Formal_Spec)
1743            and then Expander_Active
1744          then
1745             declare
1746                Stream_Prim : Entity_Id;
1747                Prefix_Type : constant Entity_Id := Entity (Prefix (Nam));
1748
1749             begin
1750                --  The class-wide forms of the stream attributes are not
1751                --  primitive dispatching operations (even though they
1752                --  internally dispatch to a stream attribute).
1753
1754                if Is_Class_Wide_Type (Prefix_Type) then
1755                   Error_Msg_N
1756                     ("attribute must be a primitive dispatching operation",
1757                      Nam);
1758                   return;
1759                end if;
1760
1761                --  Retrieve the primitive subprogram associated with the
1762                --  attribute. This can only be a stream attribute, since those
1763                --  are the only ones that are dispatching (and the actual for
1764                --  an abstract formal subprogram must be dispatching
1765                --  operation).
1766
1767                begin
1768                   case Attribute_Name (Nam) is
1769                      when Name_Input  =>
1770                         Stream_Prim :=
1771                           Find_Prim_Op (Prefix_Type, TSS_Stream_Input);
1772                      when Name_Output =>
1773                         Stream_Prim :=
1774                           Find_Prim_Op (Prefix_Type, TSS_Stream_Output);
1775                      when Name_Read   =>
1776                         Stream_Prim :=
1777                           Find_Prim_Op (Prefix_Type, TSS_Stream_Read);
1778                      when Name_Write  =>
1779                         Stream_Prim :=
1780                           Find_Prim_Op (Prefix_Type, TSS_Stream_Write);
1781                      when others      =>
1782                         Error_Msg_N
1783                           ("attribute must be a primitive"
1784                             & " dispatching operation", Nam);
1785                         return;
1786                   end case;
1787
1788                exception
1789
1790                   --  If no operation was found, and the type is limited,
1791                   --  the user should have defined one.
1792
1793                   when Program_Error =>
1794                      if Is_Limited_Type (Prefix_Type) then
1795                         Error_Msg_NE
1796                          ("stream operation not defined for type&",
1797                            N, Prefix_Type);
1798                         return;
1799
1800                      --  Otherwise, compiler should have generated default
1801
1802                      else
1803                         raise;
1804                      end if;
1805                end;
1806
1807                --  Rewrite the attribute into the name of its corresponding
1808                --  primitive dispatching subprogram. We can then proceed with
1809                --  the usual processing for subprogram renamings.
1810
1811                declare
1812                   Prim_Name : constant Node_Id :=
1813                                 Make_Identifier (Sloc (Nam),
1814                                   Chars => Chars (Stream_Prim));
1815                begin
1816                   Set_Entity (Prim_Name, Stream_Prim);
1817                   Rewrite (Nam, Prim_Name);
1818                   Analyze (Nam);
1819                end;
1820             end;
1821
1822          --  Normal processing for a renaming of an attribute
1823
1824          else
1825             Attribute_Renaming (N);
1826             return;
1827          end if;
1828       end if;
1829
1830       --  Check whether this declaration corresponds to the instantiation
1831       --  of a formal subprogram.
1832
1833       --  If this is an instantiation, the corresponding actual is frozen and
1834       --  error messages can be made more precise. If this is a default
1835       --  subprogram, the entity is already established in the generic, and is
1836       --  not retrieved by visibility. If it is a default with a box, the
1837       --  candidate interpretations, if any, have been collected when building
1838       --  the renaming declaration. If overloaded, the proper interpretation is
1839       --  determined in Find_Renamed_Entity. If the entity is an operator,
1840       --  Find_Renamed_Entity applies additional visibility checks.
1841
1842       if Is_Actual then
1843          Inst_Node := Unit_Declaration_Node (Formal_Spec);
1844
1845          if Is_Entity_Name (Nam)
1846            and then Present (Entity (Nam))
1847            and then not Comes_From_Source (Nam)
1848            and then not Is_Overloaded (Nam)
1849          then
1850             Old_S := Entity (Nam);
1851             New_S := Analyze_Subprogram_Specification (Spec);
1852
1853             --  Operator case
1854
1855             if Ekind (Entity (Nam)) = E_Operator then
1856
1857                --  Box present
1858
1859                if Box_Present (Inst_Node) then
1860                   Old_S := Find_Renamed_Entity (N, Name (N), New_S, Is_Actual);
1861
1862                --  If there is an immediately visible homonym of the operator
1863                --  and the declaration has a default, this is worth a warning
1864                --  because the user probably did not intend to get the pre-
1865                --  defined operator, visible in the generic declaration. To
1866                --  find if there is an intended candidate, analyze the renaming
1867                --  again in the current context.
1868
1869                elsif Scope (Old_S) = Standard_Standard
1870                  and then Present (Default_Name (Inst_Node))
1871                then
1872                   declare
1873                      Decl   : constant Node_Id := New_Copy_Tree (N);
1874                      Hidden : Entity_Id;
1875
1876                   begin
1877                      Set_Entity (Name (Decl), Empty);
1878                      Analyze (Name (Decl));
1879                      Hidden :=
1880                        Find_Renamed_Entity (Decl, Name (Decl), New_S, True);
1881
1882                      if Present (Hidden)
1883                        and then In_Open_Scopes (Scope (Hidden))
1884                        and then Is_Immediately_Visible (Hidden)
1885                        and then Comes_From_Source (Hidden)
1886                        and then Hidden /= Old_S
1887                      then
1888                         Error_Msg_Sloc := Sloc (Hidden);
1889                         Error_Msg_N ("?default subprogram is resolved " &
1890                                      "in the generic declaration " &
1891                                      "(RM 12.6(17))", N);
1892                         Error_Msg_NE ("\?and will not use & #", N, Hidden);
1893                      end if;
1894                   end;
1895                end if;
1896             end if;
1897
1898          else
1899             Analyze (Nam);
1900             New_S := Analyze_Subprogram_Specification (Spec);
1901          end if;
1902
1903       else
1904          --  Renamed entity must be analyzed first, to avoid being hidden by
1905          --  new name (which might be the same in a generic instance).
1906
1907          Analyze (Nam);
1908
1909          --  The renaming defines a new overloaded entity, which is analyzed
1910          --  like a subprogram declaration.
1911
1912          New_S := Analyze_Subprogram_Specification (Spec);
1913       end if;
1914
1915       if Current_Scope /= Standard_Standard then
1916          Set_Is_Pure (New_S, Is_Pure (Current_Scope));
1917       end if;
1918
1919       Rename_Spec := Find_Corresponding_Spec (N);
1920
1921       --  Case of Renaming_As_Body
1922
1923       if Present (Rename_Spec) then
1924
1925          --  Renaming declaration is the completion of the declaration of
1926          --  Rename_Spec. We build an actual body for it at the freezing point.
1927
1928          Set_Corresponding_Spec (N, Rename_Spec);
1929
1930          --  Deal with special case of stream functions of abstract types
1931          --  and interfaces.
1932
1933          if Nkind (Unit_Declaration_Node (Rename_Spec)) =
1934                                      N_Abstract_Subprogram_Declaration
1935          then
1936             --  Input stream functions are abstract if the object type is
1937             --  abstract. Similarly, all default stream functions for an
1938             --  interface type are abstract. However, these subprograms may
1939             --  receive explicit declarations in representation clauses, making
1940             --  the attribute subprograms usable as defaults in subsequent
1941             --  type extensions.
1942             --  In this case we rewrite the declaration to make the subprogram
1943             --  non-abstract. We remove the previous declaration, and insert
1944             --  the new one at the point of the renaming, to prevent premature
1945             --  access to unfrozen types. The new declaration reuses the
1946             --  specification of the previous one, and must not be analyzed.
1947
1948             pragma Assert
1949               (Is_Primitive (Entity (Nam))
1950                  and then
1951                    Is_Abstract_Type (Find_Dispatching_Type (Entity (Nam))));
1952             declare
1953                Old_Decl : constant Node_Id :=
1954                             Unit_Declaration_Node (Rename_Spec);
1955                New_Decl : constant Node_Id :=
1956                             Make_Subprogram_Declaration (Sloc (N),
1957                               Specification =>
1958                                 Relocate_Node (Specification (Old_Decl)));
1959             begin
1960                Remove (Old_Decl);
1961                Insert_After (N, New_Decl);
1962                Set_Is_Abstract_Subprogram (Rename_Spec, False);
1963                Set_Analyzed (New_Decl);
1964             end;
1965          end if;
1966
1967          Set_Corresponding_Body (Unit_Declaration_Node (Rename_Spec), New_S);
1968
1969          if Ada_Version = Ada_83 and then Comes_From_Source (N) then
1970             Error_Msg_N ("(Ada 83) renaming cannot serve as a body", N);
1971          end if;
1972
1973          Set_Convention (New_S, Convention (Rename_Spec));
1974          Check_Fully_Conformant (New_S, Rename_Spec);
1975          Set_Public_Status (New_S);
1976
1977          --  The specification does not introduce new formals, but only
1978          --  repeats the formals of the original subprogram declaration.
1979          --  For cross-reference purposes, and for refactoring tools, we
1980          --  treat the formals of the renaming declaration as body formals.
1981
1982          Reference_Body_Formals (Rename_Spec, New_S);
1983
1984          --  Indicate that the entity in the declaration functions like the
1985          --  corresponding body, and is not a new entity. The body will be
1986          --  constructed later at the freeze point, so indicate that the
1987          --  completion has not been seen yet.
1988
1989          Set_Ekind (New_S, E_Subprogram_Body);
1990          New_S := Rename_Spec;
1991          Set_Has_Completion (Rename_Spec, False);
1992
1993          --  Ada 2005: check overriding indicator
1994
1995          if Present (Overridden_Operation (Rename_Spec)) then
1996             if Must_Not_Override (Specification (N)) then
1997                Error_Msg_NE
1998                  ("subprogram& overrides inherited operation",
1999                     N, Rename_Spec);
2000             elsif
2001               Style_Check and then not Must_Override (Specification (N))
2002             then
2003                Style.Missing_Overriding (N, Rename_Spec);
2004             end if;
2005
2006          elsif Must_Override (Specification (N)) then
2007             Error_Msg_NE ("subprogram& is not overriding", N, Rename_Spec);
2008          end if;
2009
2010       --  Normal subprogram renaming (not renaming as body)
2011
2012       else
2013          Generate_Definition (New_S);
2014          New_Overloaded_Entity (New_S);
2015
2016          if Is_Entity_Name (Nam)
2017            and then Is_Intrinsic_Subprogram (Entity (Nam))
2018          then
2019             null;
2020          else
2021             Check_Delayed_Subprogram (New_S);
2022          end if;
2023       end if;
2024
2025       --  There is no need for elaboration checks on the new entity, which may
2026       --  be called before the next freezing point where the body will appear.
2027       --  Elaboration checks refer to the real entity, not the one created by
2028       --  the renaming declaration.
2029
2030       Set_Kill_Elaboration_Checks (New_S, True);
2031
2032       if Etype (Nam) = Any_Type then
2033          Set_Has_Completion (New_S);
2034          return;
2035
2036       elsif Nkind (Nam) = N_Selected_Component then
2037
2038          --  A prefix of the form  A.B can designate an entry of task A, a
2039          --  protected operation of protected object A, or finally a primitive
2040          --  operation of object A. In the later case, A is an object of some
2041          --  tagged type, or an access type that denotes one such. To further
2042          --  distinguish these cases, note that the scope of a task entry or
2043          --  protected operation is type of the prefix.
2044
2045          --  The prefix could be an overloaded function call that returns both
2046          --  kinds of operations. This overloading pathology is left to the
2047          --  dedicated reader ???
2048
2049          declare
2050             T : constant Entity_Id := Etype (Prefix (Nam));
2051
2052          begin
2053             if Present (T)
2054               and then
2055                 (Is_Tagged_Type (T)
2056                   or else
2057                     (Is_Access_Type (T)
2058                       and then
2059                         Is_Tagged_Type (Designated_Type (T))))
2060               and then Scope (Entity (Selector_Name (Nam))) /= T
2061             then
2062                Analyze_Renamed_Primitive_Operation
2063                  (N, New_S, Present (Rename_Spec));
2064                return;
2065
2066             else
2067                --  Renamed entity is an entry or protected operation. For those
2068                --  cases an explicit body is built (at the point of freezing of
2069                --  this entity) that contains a call to the renamed entity.
2070
2071                --  This is not allowed for renaming as body if the renamed
2072                --  spec is already frozen (see RM 8.5.4(5) for details).
2073
2074                if Present (Rename_Spec)
2075                  and then Is_Frozen (Rename_Spec)
2076                then
2077                   Error_Msg_N
2078                     ("renaming-as-body cannot rename entry as subprogram", N);
2079                   Error_Msg_NE
2080                     ("\since & is already frozen (RM 8.5.4(5))",
2081                      N, Rename_Spec);
2082                else
2083                   Analyze_Renamed_Entry (N, New_S, Present (Rename_Spec));
2084                end if;
2085
2086                return;
2087             end if;
2088          end;
2089
2090       elsif Nkind (Nam) = N_Explicit_Dereference then
2091
2092          --  Renamed entity is designated by access_to_subprogram expression.
2093          --  Must build body to encapsulate call, as in the entry case.
2094
2095          Analyze_Renamed_Dereference (N, New_S, Present (Rename_Spec));
2096          return;
2097
2098       elsif Nkind (Nam) = N_Indexed_Component then
2099          Analyze_Renamed_Family_Member (N, New_S, Present (Rename_Spec));
2100          return;
2101
2102       elsif Nkind (Nam) = N_Character_Literal then
2103          Analyze_Renamed_Character (N, New_S, Present (Rename_Spec));
2104          return;
2105
2106       elsif not Is_Entity_Name (Nam)
2107         or else not Is_Overloadable (Entity (Nam))
2108       then
2109          Error_Msg_N ("expect valid subprogram name in renaming", N);
2110          return;
2111       end if;
2112
2113       --  Find the renamed entity that matches the given specification. Disable
2114       --  Ada_83 because there is no requirement of full conformance between
2115       --  renamed entity and new entity, even though the same circuit is used.
2116
2117       --  This is a bit of a kludge, which introduces a really irregular use of
2118       --  Ada_Version[_Explicit]. Would be nice to find cleaner way to do this
2119       --  ???
2120
2121       Ada_Version := Ada_Version_Type'Max (Ada_Version, Ada_95);
2122       Ada_Version_Explicit := Ada_Version;
2123
2124       if No (Old_S) then
2125          Old_S := Find_Renamed_Entity (N, Name (N), New_S, Is_Actual);
2126
2127          --  The visible operation may be an inherited abstract operation that
2128          --  was overridden in the private part, in which case a call will
2129          --  dispatch to the overriding operation. Use the overriding one in
2130          --  the renaming declaration, to prevent spurious errors below.
2131
2132          if Is_Overloadable (Old_S)
2133            and then Is_Abstract_Subprogram (Old_S)
2134            and then No (DTC_Entity (Old_S))
2135            and then Present (Alias (Old_S))
2136            and then not Is_Abstract_Subprogram (Alias (Old_S))
2137            and then Present (Overridden_Operation (Alias (Old_S)))
2138          then
2139             Old_S := Alias (Old_S);
2140          end if;
2141
2142          --  When the renamed subprogram is overloaded and used as an actual
2143          --  of a generic, its entity is set to the first available homonym.
2144          --  We must first disambiguate the name, then set the proper entity.
2145
2146          if Is_Actual
2147            and then Is_Overloaded (Nam)
2148          then
2149             Set_Entity (Nam, Old_S);
2150          end if;
2151       end if;
2152
2153       --  Most common case: subprogram renames subprogram. No body is generated
2154       --  in this case, so we must indicate the declaration is complete as is.
2155       --  and inherit various attributes of the renamed subprogram.
2156
2157       if No (Rename_Spec) then
2158          Set_Has_Completion   (New_S);
2159          Set_Is_Imported      (New_S, Is_Imported      (Entity (Nam)));
2160          Set_Is_Pure          (New_S, Is_Pure          (Entity (Nam)));
2161          Set_Is_Preelaborated (New_S, Is_Preelaborated (Entity (Nam)));
2162
2163          --  Ada 2005 (AI-423): Check the consistency of null exclusions
2164          --  between a subprogram and its correct renaming.
2165
2166          --  Note: the Any_Id check is a guard that prevents compiler crashes
2167          --  when performing a null exclusion check between a renaming and a
2168          --  renamed subprogram that has been found to be illegal.
2169
2170          if Ada_Version >= Ada_2005
2171            and then Entity (Nam) /= Any_Id
2172          then
2173             Check_Null_Exclusion
2174               (Ren => New_S,
2175                Sub => Entity (Nam));
2176          end if;
2177
2178          --  Enforce the Ada 2005 rule that the renamed entity cannot require
2179          --  overriding. The flag Requires_Overriding is set very selectively
2180          --  and misses some other illegal cases. The additional conditions
2181          --  checked below are sufficient but not necessary ???
2182
2183          --  The rule does not apply to the renaming generated for an actual
2184          --  subprogram in an instance.
2185
2186          if Is_Actual then
2187             null;
2188
2189          --  Guard against previous errors, and omit renamings of predefined
2190          --  operators.
2191
2192          elsif not Ekind_In (Old_S, E_Function, E_Procedure) then
2193             null;
2194
2195          elsif Requires_Overriding (Old_S)
2196            or else
2197               (Is_Abstract_Subprogram (Old_S)
2198                  and then Present (Find_Dispatching_Type (Old_S))
2199                  and then
2200                    not Is_Abstract_Type (Find_Dispatching_Type (Old_S)))
2201          then
2202             Error_Msg_N
2203               ("renamed entity cannot be "
2204                & "subprogram that requires overriding (RM 8.5.4 (5.1))", N);
2205          end if;
2206       end if;
2207
2208       if Old_S /= Any_Id then
2209          if Is_Actual
2210            and then From_Default (N)
2211          then
2212             --  This is an implicit reference to the default actual
2213
2214             Generate_Reference (Old_S, Nam, Typ => 'i', Force => True);
2215          else
2216             Generate_Reference (Old_S, Nam);
2217          end if;
2218
2219          --  For a renaming-as-body, require subtype conformance, but if the
2220          --  declaration being completed has not been frozen, then inherit the
2221          --  convention of the renamed subprogram prior to checking conformance
2222          --  (unless the renaming has an explicit convention established; the
2223          --  rule stated in the RM doesn't seem to address this ???).
2224
2225          if Present (Rename_Spec) then
2226             Generate_Reference (Rename_Spec, Defining_Entity (Spec), 'b');
2227             Style.Check_Identifier (Defining_Entity (Spec), Rename_Spec);
2228
2229             if not Is_Frozen (Rename_Spec) then
2230                if not Has_Convention_Pragma (Rename_Spec) then
2231                   Set_Convention (New_S, Convention (Old_S));
2232                end if;
2233
2234                if Ekind (Old_S) /= E_Operator then
2235                   Check_Mode_Conformant (New_S, Old_S, Spec);
2236                end if;
2237
2238                if Original_Subprogram (Old_S) = Rename_Spec then
2239                   Error_Msg_N ("unfrozen subprogram cannot rename itself ", N);
2240                end if;
2241             else
2242                Check_Subtype_Conformant (New_S, Old_S, Spec);
2243             end if;
2244
2245             Check_Frozen_Renaming (N, Rename_Spec);
2246
2247             --  Check explicitly that renamed entity is not intrinsic, because
2248             --  in a generic the renamed body is not built. In this case,
2249             --  the renaming_as_body is a completion.
2250
2251             if Inside_A_Generic then
2252                if Is_Frozen (Rename_Spec)
2253                  and then Is_Intrinsic_Subprogram (Old_S)
2254                then
2255                   Error_Msg_N
2256                     ("subprogram in renaming_as_body cannot be intrinsic",
2257                        Name (N));
2258                end if;
2259
2260                Set_Has_Completion (Rename_Spec);
2261             end if;
2262
2263          elsif Ekind (Old_S) /= E_Operator then
2264             Check_Mode_Conformant (New_S, Old_S);
2265
2266             if Is_Actual
2267               and then Error_Posted (New_S)
2268             then
2269                Error_Msg_NE ("invalid actual subprogram: & #!", N, Old_S);
2270             end if;
2271          end if;
2272
2273          if No (Rename_Spec) then
2274
2275             --  The parameter profile of the new entity is that of the renamed
2276             --  entity: the subtypes given in the specification are irrelevant.
2277
2278             Inherit_Renamed_Profile (New_S, Old_S);
2279
2280             --  A call to the subprogram is transformed into a call to the
2281             --  renamed entity. This is transitive if the renamed entity is
2282             --  itself a renaming.
2283
2284             if Present (Alias (Old_S)) then
2285                Set_Alias (New_S, Alias (Old_S));
2286             else
2287                Set_Alias (New_S, Old_S);
2288             end if;
2289
2290             --  Note that we do not set Is_Intrinsic_Subprogram if we have a
2291             --  renaming as body, since the entity in this case is not an
2292             --  intrinsic (it calls an intrinsic, but we have a real body for
2293             --  this call, and it is in this body that the required intrinsic
2294             --  processing will take place).
2295
2296             --  Also, if this is a renaming of inequality, the renamed operator
2297             --  is intrinsic, but what matters is the corresponding equality
2298             --  operator, which may be user-defined.
2299
2300             Set_Is_Intrinsic_Subprogram
2301               (New_S,
2302                 Is_Intrinsic_Subprogram (Old_S)
2303                   and then
2304                     (Chars (Old_S) /= Name_Op_Ne
2305                        or else Ekind (Old_S) = E_Operator
2306                        or else
2307                          Is_Intrinsic_Subprogram
2308                             (Corresponding_Equality (Old_S))));
2309
2310             if Ekind (Alias (New_S)) = E_Operator then
2311                Set_Has_Delayed_Freeze (New_S, False);
2312             end if;
2313
2314             --  If the renaming corresponds to an association for an abstract
2315             --  formal subprogram, then various attributes must be set to
2316             --  indicate that the renaming is an abstract dispatching operation
2317             --  with a controlling type.
2318
2319             if Is_Actual and then Is_Abstract_Subprogram (Formal_Spec) then
2320
2321                --  Mark the renaming as abstract here, so Find_Dispatching_Type
2322                --  see it as corresponding to a generic association for a
2323                --  formal abstract subprogram
2324
2325                Set_Is_Abstract_Subprogram (New_S);
2326
2327                declare
2328                   New_S_Ctrl_Type : constant Entity_Id :=
2329                                       Find_Dispatching_Type (New_S);
2330                   Old_S_Ctrl_Type : constant Entity_Id :=
2331                                       Find_Dispatching_Type (Old_S);
2332
2333                begin
2334                   if Old_S_Ctrl_Type /= New_S_Ctrl_Type then
2335                      Error_Msg_NE
2336                        ("actual must be dispatching subprogram for type&",
2337                         Nam, New_S_Ctrl_Type);
2338
2339                   else
2340                      Set_Is_Dispatching_Operation (New_S);
2341                      Check_Controlling_Formals (New_S_Ctrl_Type, New_S);
2342
2343                      --  If the actual in the formal subprogram is itself a
2344                      --  formal abstract subprogram association, there's no
2345                      --  dispatch table component or position to inherit.
2346
2347                      if Present (DTC_Entity (Old_S)) then
2348                         Set_DTC_Entity  (New_S, DTC_Entity (Old_S));
2349                         Set_DT_Position (New_S, DT_Position (Old_S));
2350                      end if;
2351                   end if;
2352                end;
2353             end if;
2354          end if;
2355
2356          if not Is_Actual
2357            and then (Old_S = New_S
2358                       or else (Nkind (Nam) /= N_Expanded_Name
2359                         and then  Chars (Old_S) = Chars (New_S)))
2360          then
2361             Error_Msg_N ("subprogram cannot rename itself", N);
2362          end if;
2363
2364          Set_Convention (New_S, Convention (Old_S));
2365
2366          if Is_Abstract_Subprogram (Old_S) then
2367             if Present (Rename_Spec) then
2368                Error_Msg_N
2369                  ("a renaming-as-body cannot rename an abstract subprogram",
2370                   N);
2371                Set_Has_Completion (Rename_Spec);
2372             else
2373                Set_Is_Abstract_Subprogram (New_S);
2374             end if;
2375          end if;
2376
2377          Check_Library_Unit_Renaming (N, Old_S);
2378
2379          --  Pathological case: procedure renames entry in the scope of its
2380          --  task. Entry is given by simple name, but body must be built for
2381          --  procedure. Of course if called it will deadlock.
2382
2383          if Ekind (Old_S) = E_Entry then
2384             Set_Has_Completion (New_S, False);
2385             Set_Alias (New_S, Empty);
2386          end if;
2387
2388          if Is_Actual then
2389             Freeze_Before (N, Old_S);
2390             Set_Has_Delayed_Freeze (New_S, False);
2391             Freeze_Before (N, New_S);
2392
2393             --  An abstract subprogram is only allowed as an actual in the case
2394             --  where the formal subprogram is also abstract.
2395
2396             if (Ekind (Old_S) = E_Procedure or else Ekind (Old_S) = E_Function)
2397               and then Is_Abstract_Subprogram (Old_S)
2398               and then not Is_Abstract_Subprogram (Formal_Spec)
2399             then
2400                Error_Msg_N
2401                  ("abstract subprogram not allowed as generic actual", Nam);
2402             end if;
2403          end if;
2404
2405       else
2406          --  A common error is to assume that implicit operators for types are
2407          --  defined in Standard, or in the scope of a subtype. In those cases
2408          --  where the renamed entity is given with an expanded name, it is
2409          --  worth mentioning that operators for the type are not declared in
2410          --  the scope given by the prefix.
2411
2412          if Nkind (Nam) = N_Expanded_Name
2413            and then Nkind (Selector_Name (Nam)) = N_Operator_Symbol
2414            and then Scope (Entity (Nam)) = Standard_Standard
2415          then
2416             declare
2417                T : constant Entity_Id :=
2418                      Base_Type (Etype (First_Formal (New_S)));
2419             begin
2420                Error_Msg_Node_2 := Prefix (Nam);
2421                Error_Msg_NE
2422                  ("operator for type& is not declared in&", Prefix (Nam), T);
2423             end;
2424
2425          else
2426             Error_Msg_NE
2427               ("no visible subprogram matches the specification for&",
2428                 Spec, New_S);
2429          end if;
2430
2431          if Present (Candidate_Renaming) then
2432             declare
2433                F1 : Entity_Id;
2434                F2 : Entity_Id;
2435                T1 : Entity_Id;
2436
2437             begin
2438                F1 := First_Formal (Candidate_Renaming);
2439                F2 := First_Formal (New_S);
2440                T1 := First_Subtype (Etype (F1));
2441
2442                while Present (F1) and then Present (F2) loop
2443                   Next_Formal (F1);
2444                   Next_Formal (F2);
2445                end loop;
2446
2447                if Present (F1) and then Present (Default_Value (F1)) then
2448                   if Present (Next_Formal (F1)) then
2449                      Error_Msg_NE
2450                        ("\missing specification for &" &
2451                           " and other formals with defaults", Spec, F1);
2452                   else
2453                      Error_Msg_NE
2454                     ("\missing specification for &", Spec, F1);
2455                   end if;
2456                end if;
2457
2458                if Nkind (Nam) = N_Operator_Symbol
2459                  and then From_Default (N)
2460                then
2461                   Error_Msg_Node_2 := T1;
2462                   Error_Msg_NE
2463                     ("default & on & is not directly visible",
2464                       Nam, Nam);
2465                end if;
2466             end;
2467          end if;
2468       end if;
2469
2470       --  Ada 2005 AI 404: if the new subprogram is dispatching, verify that
2471       --  controlling access parameters are known non-null for the renamed
2472       --  subprogram. Test also applies to a subprogram instantiation that
2473       --  is dispatching. Test is skipped if some previous error was detected
2474       --  that set Old_S to Any_Id.
2475
2476       if Ada_Version >= Ada_2005
2477         and then Old_S /= Any_Id
2478         and then not Is_Dispatching_Operation (Old_S)
2479         and then Is_Dispatching_Operation (New_S)
2480       then
2481          declare
2482             Old_F : Entity_Id;
2483             New_F : Entity_Id;
2484
2485          begin
2486             Old_F := First_Formal (Old_S);
2487             New_F := First_Formal (New_S);
2488             while Present (Old_F) loop
2489                if Ekind (Etype (Old_F)) = E_Anonymous_Access_Type
2490                  and then Is_Controlling_Formal (New_F)
2491                  and then not Can_Never_Be_Null (Old_F)
2492                then
2493                   Error_Msg_N ("access parameter is controlling,", New_F);
2494                   Error_Msg_NE
2495                     ("\corresponding parameter of& "
2496                      & "must be explicitly null excluding", New_F, Old_S);
2497                end if;
2498
2499                Next_Formal (Old_F);
2500                Next_Formal (New_F);
2501             end loop;
2502          end;
2503       end if;
2504
2505       --  A useful warning, suggested by Ada Bug Finder (Ada-Europe 2005)
2506       --  is to warn if an operator is being renamed as a different operator.
2507       --  If the operator is predefined, examine the kind of the entity, not
2508       --  the abbreviated declaration in Standard.
2509
2510       if Comes_From_Source (N)
2511         and then Present (Old_S)
2512         and then
2513           (Nkind (Old_S) = N_Defining_Operator_Symbol
2514             or else Ekind (Old_S) = E_Operator)
2515         and then Nkind (New_S) = N_Defining_Operator_Symbol
2516         and then Chars (Old_S) /= Chars (New_S)
2517       then
2518          Error_Msg_NE
2519            ("?& is being renamed as a different operator", N, Old_S);
2520       end if;
2521
2522       --  Check for renaming of obsolescent subprogram
2523
2524       Check_Obsolescent_2005_Entity (Entity (Nam), Nam);
2525
2526       --  Another warning or some utility: if the new subprogram as the same
2527       --  name as the old one, the old one is not hidden by an outer homograph,
2528       --  the new one is not a public symbol, and the old one is otherwise
2529       --  directly visible, the renaming is superfluous.
2530
2531       if Chars (Old_S) = Chars (New_S)
2532         and then Comes_From_Source (N)
2533         and then Scope (Old_S) /= Standard_Standard
2534         and then Warn_On_Redundant_Constructs
2535         and then
2536           (Is_Immediately_Visible (Old_S)
2537             or else Is_Potentially_Use_Visible (Old_S))
2538         and then Is_Overloadable (Current_Scope)
2539         and then Chars (Current_Scope) /= Chars (Old_S)
2540       then
2541          Error_Msg_N
2542           ("?redundant renaming, entity is directly visible", Name (N));
2543       end if;
2544
2545       Ada_Version := Save_AV;
2546       Ada_Version_Explicit := Save_AV_Exp;
2547    end Analyze_Subprogram_Renaming;
2548
2549    -------------------------
2550    -- Analyze_Use_Package --
2551    -------------------------
2552
2553    --  Resolve the package names in the use clause, and make all the visible
2554    --  entities defined in the package potentially use-visible. If the package
2555    --  is already in use from a previous use clause, its visible entities are
2556    --  already use-visible. In that case, mark the occurrence as a redundant
2557    --  use. If the package is an open scope, i.e. if the use clause occurs
2558    --  within the package itself, ignore it.
2559
2560    procedure Analyze_Use_Package (N : Node_Id) is
2561       Pack_Name : Node_Id;
2562       Pack      : Entity_Id;
2563
2564    --  Start of processing for Analyze_Use_Package
2565
2566    begin
2567       --  Use package is not allowed in SPARK or ALFA
2568
2569       if Formal_Verification_Mode then
2570          Error_Msg_F ("|~~use clause is not allowed", N);
2571          return;
2572       end if;
2573
2574       --  Proceed with analysis
2575
2576       Set_Hidden_By_Use_Clause (N, No_Elist);
2577
2578       --  Use clause is not allowed in a spec of a predefined package
2579       --  declaration except that packages whose file name starts a-n are OK
2580       --  (these are children of Ada.Numerics, and such packages are never
2581       --  loaded by Rtsfind).
2582
2583       if Is_Predefined_File_Name (Unit_File_Name (Current_Sem_Unit))
2584         and then Name_Buffer (1 .. 3) /= "a-n"
2585         and then
2586           Nkind (Unit (Cunit (Current_Sem_Unit))) = N_Package_Declaration
2587       then
2588          Error_Msg_N ("use clause not allowed in predefined spec", N);
2589       end if;
2590
2591       --  Chain clause to list of use clauses in current scope
2592
2593       if Nkind (Parent (N)) /= N_Compilation_Unit then
2594          Chain_Use_Clause (N);
2595       end if;
2596
2597       --  Loop through package names to identify referenced packages
2598
2599       Pack_Name := First (Names (N));
2600       while Present (Pack_Name) loop
2601          Analyze (Pack_Name);
2602
2603          if Nkind (Parent (N)) = N_Compilation_Unit
2604            and then Nkind (Pack_Name) = N_Expanded_Name
2605          then
2606             declare
2607                Pref : Node_Id;
2608
2609             begin
2610                Pref := Prefix (Pack_Name);
2611                while Nkind (Pref) = N_Expanded_Name loop
2612                   Pref := Prefix (Pref);
2613                end loop;
2614
2615                if Entity (Pref) = Standard_Standard then
2616                   Error_Msg_N
2617                    ("predefined package Standard cannot appear"
2618                      & " in a context clause", Pref);
2619                end if;
2620             end;
2621          end if;
2622
2623          Next (Pack_Name);
2624       end loop;
2625
2626       --  Loop through package names to mark all entities as potentially
2627       --  use visible.
2628
2629       Pack_Name := First (Names (N));
2630       while Present (Pack_Name) loop
2631          if Is_Entity_Name (Pack_Name) then
2632             Pack := Entity (Pack_Name);
2633
2634             if Ekind (Pack) /= E_Package
2635               and then Etype (Pack) /= Any_Type
2636             then
2637                if Ekind (Pack) = E_Generic_Package then
2638                   Error_Msg_N  -- CODEFIX
2639                    ("a generic package is not allowed in a use clause",
2640                       Pack_Name);
2641                else
2642                   Error_Msg_N ("& is not a usable package", Pack_Name);
2643                end if;
2644
2645             else
2646                if Nkind (Parent (N)) = N_Compilation_Unit then
2647                   Check_In_Previous_With_Clause (N, Pack_Name);
2648                end if;
2649
2650                if Applicable_Use (Pack_Name) then
2651                   Use_One_Package (Pack, N);
2652                end if;
2653             end if;
2654
2655          --  Report error because name denotes something other than a package
2656
2657          else
2658             Error_Msg_N ("& is not a package", Pack_Name);
2659          end if;
2660
2661          Next (Pack_Name);
2662       end loop;
2663    end Analyze_Use_Package;
2664
2665    ----------------------
2666    -- Analyze_Use_Type --
2667    ----------------------
2668
2669    procedure Analyze_Use_Type (N : Node_Id) is
2670       E  : Entity_Id;
2671       Id : Node_Id;
2672
2673    begin
2674       Set_Hidden_By_Use_Clause (N, No_Elist);
2675
2676       --  Chain clause to list of use clauses in current scope
2677
2678       if Nkind (Parent (N)) /= N_Compilation_Unit then
2679          Chain_Use_Clause (N);
2680       end if;
2681
2682       --  Commented needed???
2683
2684       if Used_Operations (N) /= No_Elist then
2685          declare
2686             Elmt : Elmt_Id;
2687          begin
2688             Elmt := First_Elmt (Used_Operations (N));
2689             while Present (Elmt) loop
2690                Set_Is_Potentially_Use_Visible (Node (Elmt));
2691                Next_Elmt (Elmt);
2692             end loop;
2693          end;
2694
2695          return;
2696       end if;
2697
2698       Set_Used_Operations (N, New_Elmt_List);
2699       Id := First (Subtype_Marks (N));
2700       while Present (Id) loop
2701          Find_Type (Id);
2702          E := Entity (Id);
2703
2704          if E /= Any_Type then
2705             Use_One_Type (Id);
2706
2707             if Nkind (Parent (N)) = N_Compilation_Unit then
2708                if Nkind (Id) = N_Identifier then
2709                   Error_Msg_N ("type is not directly visible", Id);
2710
2711                elsif Is_Child_Unit (Scope (E))
2712                  and then Scope (E) /= System_Aux_Id
2713                then
2714                   Check_In_Previous_With_Clause (N, Prefix (Id));
2715                end if;
2716             end if;
2717
2718          else
2719             --  If the use_type_clause appears in a compilation unit context,
2720             --  check whether it comes from a unit that may appear in a
2721             --  limited_with_clause, for a better error message.
2722
2723             if Nkind (Parent (N)) = N_Compilation_Unit
2724               and then Nkind (Id) /= N_Identifier
2725             then
2726                declare
2727                   Item : Node_Id;
2728                   Pref : Node_Id;
2729
2730                   function Mentioned (Nam : Node_Id) return Boolean;
2731                   --  Check whether the prefix of expanded name for the type
2732                   --  appears in the prefix of some limited_with_clause.
2733
2734                   ---------------
2735                   -- Mentioned --
2736                   ---------------
2737
2738                   function Mentioned (Nam : Node_Id) return Boolean is
2739                   begin
2740                      return Nkind (Name (Item)) = N_Selected_Component
2741                               and then
2742                             Chars (Prefix (Name (Item))) = Chars (Nam);
2743                   end Mentioned;
2744
2745                begin
2746                   Pref := Prefix (Id);
2747                   Item := First (Context_Items (Parent (N)));
2748
2749                   while Present (Item) and then Item /= N loop
2750                      if Nkind (Item) = N_With_Clause
2751                        and then Limited_Present (Item)
2752                        and then Mentioned (Pref)
2753                      then
2754                         Change_Error_Text
2755                           (Get_Msg_Id, "premature usage of incomplete type");
2756                      end if;
2757
2758                      Next (Item);
2759                   end loop;
2760                end;
2761             end if;
2762          end if;
2763
2764          Next (Id);
2765       end loop;
2766    end Analyze_Use_Type;
2767
2768    --------------------
2769    -- Applicable_Use --
2770    --------------------
2771
2772    function Applicable_Use (Pack_Name : Node_Id) return Boolean is
2773       Pack : constant Entity_Id := Entity (Pack_Name);
2774
2775    begin
2776       if In_Open_Scopes (Pack) then
2777          if Warn_On_Redundant_Constructs
2778            and then Pack = Current_Scope
2779          then
2780             Error_Msg_NE -- CODEFIX
2781               ("& is already use-visible within itself?", Pack_Name, Pack);
2782          end if;
2783
2784          return False;
2785
2786       elsif In_Use (Pack) then
2787          Note_Redundant_Use (Pack_Name);
2788          return False;
2789
2790       elsif Present (Renamed_Object (Pack))
2791         and then In_Use (Renamed_Object (Pack))
2792       then
2793          Note_Redundant_Use (Pack_Name);
2794          return False;
2795
2796       else
2797          return True;
2798       end if;
2799    end Applicable_Use;
2800
2801    ------------------------
2802    -- Attribute_Renaming --
2803    ------------------------
2804
2805    procedure Attribute_Renaming (N : Node_Id) is
2806       Loc        : constant Source_Ptr := Sloc (N);
2807       Nam        : constant Node_Id    := Name (N);
2808       Spec       : constant Node_Id    := Specification (N);
2809       New_S      : constant Entity_Id  := Defining_Unit_Name (Spec);
2810       Aname      : constant Name_Id    := Attribute_Name (Nam);
2811
2812       Form_Num   : Nat      := 0;
2813       Expr_List  : List_Id  := No_List;
2814
2815       Attr_Node  : Node_Id;
2816       Body_Node  : Node_Id;
2817       Param_Spec : Node_Id;
2818
2819    begin
2820       Generate_Definition (New_S);
2821
2822       --  This procedure is called in the context of subprogram renaming, and
2823       --  thus the attribute must be one that is a subprogram. All of those
2824       --  have at least one formal parameter, with the singular exception of
2825       --  AST_Entry (which is a real oddity, it is odd that this can be renamed
2826       --  at all!)
2827
2828       if not Is_Non_Empty_List (Parameter_Specifications (Spec)) then
2829          if Aname /= Name_AST_Entry then
2830             Error_Msg_N
2831               ("subprogram renaming an attribute must have formals", N);
2832             return;
2833          end if;
2834
2835       else
2836          Param_Spec := First (Parameter_Specifications (Spec));
2837          while Present (Param_Spec) loop
2838             Form_Num := Form_Num + 1;
2839
2840             if Nkind (Parameter_Type (Param_Spec)) /= N_Access_Definition then
2841                Find_Type (Parameter_Type (Param_Spec));
2842
2843                --  The profile of the new entity denotes the base type (s) of
2844                --  the types given in the specification. For access parameters
2845                --  there are no subtypes involved.
2846
2847                Rewrite (Parameter_Type (Param_Spec),
2848                 New_Reference_To
2849                   (Base_Type (Entity (Parameter_Type (Param_Spec))), Loc));
2850             end if;
2851
2852             if No (Expr_List) then
2853                Expr_List := New_List;
2854             end if;
2855
2856             Append_To (Expr_List,
2857               Make_Identifier (Loc,
2858                 Chars => Chars (Defining_Identifier (Param_Spec))));
2859
2860             --  The expressions in the attribute reference are not freeze
2861             --  points. Neither is the attribute as a whole, see below.
2862
2863             Set_Must_Not_Freeze (Last (Expr_List));
2864             Next (Param_Spec);
2865          end loop;
2866       end if;
2867
2868       --  Immediate error if too many formals. Other mismatches in number or
2869       --  types of parameters are detected when we analyze the body of the
2870       --  subprogram that we construct.
2871
2872       if Form_Num > 2 then
2873          Error_Msg_N ("too many formals for attribute", N);
2874
2875       --  Error if the attribute reference has expressions that look like
2876       --  formal parameters.
2877
2878       elsif Present (Expressions (Nam)) then
2879          Error_Msg_N ("illegal expressions in attribute reference", Nam);
2880
2881       elsif
2882         Aname = Name_Compose      or else
2883         Aname = Name_Exponent     or else
2884         Aname = Name_Leading_Part or else
2885         Aname = Name_Pos          or else
2886         Aname = Name_Round        or else
2887         Aname = Name_Scaling      or else
2888         Aname = Name_Val
2889       then
2890          if Nkind (N) = N_Subprogram_Renaming_Declaration
2891            and then Present (Corresponding_Formal_Spec (N))
2892          then
2893             Error_Msg_N
2894               ("generic actual cannot be attribute involving universal type",
2895                Nam);
2896          else
2897             Error_Msg_N
2898               ("attribute involving a universal type cannot be renamed",
2899                Nam);
2900          end if;
2901       end if;
2902
2903       --  AST_Entry is an odd case. It doesn't really make much sense to allow
2904       --  it to be renamed, but that's the DEC rule, so we have to do it right.
2905       --  The point is that the AST_Entry call should be made now, and what the
2906       --  function will return is the returned value.
2907
2908       --  Note that there is no Expr_List in this case anyway
2909
2910       if Aname = Name_AST_Entry then
2911          declare
2912             Ent  : constant Entity_Id := Make_Temporary (Loc, 'R', Nam);
2913             Decl : Node_Id;
2914
2915          begin
2916             Decl :=
2917               Make_Object_Declaration (Loc,
2918                 Defining_Identifier => Ent,
2919                 Object_Definition   =>
2920                   New_Occurrence_Of (RTE (RE_AST_Handler), Loc),
2921                 Expression          => Nam,
2922                 Constant_Present    => True);
2923
2924             Set_Assignment_OK (Decl, True);
2925             Insert_Action (N, Decl);
2926             Attr_Node := Make_Identifier (Loc, Chars (Ent));
2927          end;
2928
2929       --  For all other attributes, we rewrite the attribute node to have
2930       --  a list of expressions corresponding to the subprogram formals.
2931       --  A renaming declaration is not a freeze point, and the analysis of
2932       --  the attribute reference should not freeze the type of the prefix.
2933
2934       else
2935          Attr_Node :=
2936            Make_Attribute_Reference (Loc,
2937              Prefix         => Prefix (Nam),
2938              Attribute_Name => Aname,
2939              Expressions    => Expr_List);
2940
2941          Set_Must_Not_Freeze (Attr_Node);
2942          Set_Must_Not_Freeze (Prefix (Nam));
2943       end if;
2944
2945       --  Case of renaming a function
2946
2947       if Nkind (Spec) = N_Function_Specification then
2948          if Is_Procedure_Attribute_Name (Aname) then
2949             Error_Msg_N ("attribute can only be renamed as procedure", Nam);
2950             return;
2951          end if;
2952
2953          Find_Type (Result_Definition (Spec));
2954          Rewrite (Result_Definition (Spec),
2955              New_Reference_To (
2956                Base_Type (Entity (Result_Definition (Spec))), Loc));
2957
2958          Body_Node :=
2959            Make_Subprogram_Body (Loc,
2960              Specification => Spec,
2961              Declarations => New_List,
2962              Handled_Statement_Sequence =>
2963                Make_Handled_Sequence_Of_Statements (Loc,
2964                    Statements => New_List (
2965                      Make_Simple_Return_Statement (Loc,
2966                        Expression => Attr_Node))));
2967
2968       --  Case of renaming a procedure
2969
2970       else
2971          if not Is_Procedure_Attribute_Name (Aname) then
2972             Error_Msg_N ("attribute can only be renamed as function", Nam);
2973             return;
2974          end if;
2975
2976          Body_Node :=
2977            Make_Subprogram_Body (Loc,
2978              Specification => Spec,
2979              Declarations => New_List,
2980              Handled_Statement_Sequence =>
2981                Make_Handled_Sequence_Of_Statements (Loc,
2982                    Statements => New_List (Attr_Node)));
2983       end if;
2984
2985       --  In case of tagged types we add the body of the generated function to
2986       --  the freezing actions of the type (because in the general case such
2987       --  type is still not frozen). We exclude from this processing generic
2988       --  formal subprograms found in instantiations and AST_Entry renamings.
2989
2990       --  We must exclude VM targets because entity AST_Handler is defined in
2991       --  package System.Aux_Dec which is not available in those platforms.
2992
2993       if VM_Target = No_VM
2994         and then not Present (Corresponding_Formal_Spec (N))
2995         and then Etype (Nam) /= RTE (RE_AST_Handler)
2996       then
2997          declare
2998             P : constant Entity_Id := Prefix (Nam);
2999
3000          begin
3001             Find_Type (P);
3002
3003             if Is_Tagged_Type (Etype (P)) then
3004                Ensure_Freeze_Node (Etype (P));
3005                Append_Freeze_Action (Etype (P), Body_Node);
3006             else
3007                Rewrite (N, Body_Node);
3008                Analyze (N);
3009                Set_Etype (New_S, Base_Type (Etype (New_S)));
3010             end if;
3011          end;
3012
3013       --  Generic formal subprograms or AST_Handler renaming
3014
3015       else
3016          Rewrite (N, Body_Node);
3017          Analyze (N);
3018          Set_Etype (New_S, Base_Type (Etype (New_S)));
3019       end if;
3020
3021       if Is_Compilation_Unit (New_S) then
3022          Error_Msg_N
3023            ("a library unit can only rename another library unit", N);
3024       end if;
3025
3026       --  We suppress elaboration warnings for the resulting entity, since
3027       --  clearly they are not needed, and more particularly, in the case
3028       --  of a generic formal subprogram, the resulting entity can appear
3029       --  after the instantiation itself, and thus look like a bogus case
3030       --  of access before elaboration.
3031
3032       Set_Suppress_Elaboration_Warnings (New_S);
3033
3034    end Attribute_Renaming;
3035
3036    ----------------------
3037    -- Chain_Use_Clause --
3038    ----------------------
3039
3040    procedure Chain_Use_Clause (N : Node_Id) is
3041       Pack : Entity_Id;
3042       Level : Int := Scope_Stack.Last;
3043
3044    begin
3045       if not Is_Compilation_Unit (Current_Scope)
3046         or else not Is_Child_Unit (Current_Scope)
3047       then
3048          null;   --  Common case
3049
3050       elsif Defining_Entity (Parent (N)) = Current_Scope then
3051          null;   --  Common case for compilation unit
3052
3053       else
3054          --  If declaration appears in some other scope, it must be in some
3055          --  parent unit when compiling a child.
3056
3057          Pack := Defining_Entity (Parent (N));
3058          if not In_Open_Scopes (Pack) then
3059             null;  --  default as well
3060
3061          else
3062             --  Find entry for parent unit in scope stack
3063
3064             while Scope_Stack.Table (Level).Entity /= Pack loop
3065                Level := Level - 1;
3066             end loop;
3067          end if;
3068       end if;
3069
3070       Set_Next_Use_Clause (N,
3071         Scope_Stack.Table (Level).First_Use_Clause);
3072       Scope_Stack.Table (Level).First_Use_Clause := N;
3073    end Chain_Use_Clause;
3074
3075    ---------------------------
3076    -- Check_Frozen_Renaming --
3077    ---------------------------
3078
3079    procedure Check_Frozen_Renaming (N : Node_Id; Subp : Entity_Id) is
3080       B_Node : Node_Id;
3081       Old_S  : Entity_Id;
3082
3083    begin
3084       if Is_Frozen (Subp)
3085         and then not Has_Completion (Subp)
3086       then
3087          B_Node :=
3088            Build_Renamed_Body
3089              (Parent (Declaration_Node (Subp)), Defining_Entity (N));
3090
3091          if Is_Entity_Name (Name (N)) then
3092             Old_S := Entity (Name (N));
3093
3094             if not Is_Frozen (Old_S)
3095               and then Operating_Mode /= Check_Semantics
3096             then
3097                Append_Freeze_Action (Old_S, B_Node);
3098             else
3099                Insert_After (N, B_Node);
3100                Analyze (B_Node);
3101             end if;
3102
3103             if Is_Intrinsic_Subprogram (Old_S)
3104               and then not In_Instance
3105             then
3106                Error_Msg_N
3107                  ("subprogram used in renaming_as_body cannot be intrinsic",
3108                     Name (N));
3109             end if;
3110
3111          else
3112             Insert_After (N, B_Node);
3113             Analyze (B_Node);
3114          end if;
3115       end if;
3116    end Check_Frozen_Renaming;
3117
3118    -------------------------------
3119    -- Set_Entity_Or_Discriminal --
3120    -------------------------------
3121
3122    procedure Set_Entity_Or_Discriminal (N : Node_Id; E : Entity_Id) is
3123       P : Node_Id;
3124
3125    begin
3126       --  If the entity is not a discriminant, or else expansion is disabled,
3127       --  simply set the entity.
3128
3129       if not In_Spec_Expression
3130         or else Ekind (E) /= E_Discriminant
3131         or else Inside_A_Generic
3132       then
3133          Set_Entity_With_Style_Check (N, E);
3134
3135       --  The replacement of a discriminant by the corresponding discriminal
3136       --  is not done for a task discriminant that appears in a default
3137       --  expression of an entry parameter. See Exp_Ch2.Expand_Discriminant
3138       --  for details on their handling.
3139
3140       elsif Is_Concurrent_Type (Scope (E)) then
3141
3142          P := Parent (N);
3143          while Present (P)
3144            and then not Nkind_In (P, N_Parameter_Specification,
3145                                   N_Component_Declaration)
3146          loop
3147             P := Parent (P);
3148          end loop;
3149
3150          if Present (P)
3151            and then Nkind (P) = N_Parameter_Specification
3152          then
3153             null;
3154
3155          else
3156             Set_Entity (N, Discriminal (E));
3157          end if;
3158
3159          --  Otherwise, this is a discriminant in a context in which
3160          --  it is a reference to the corresponding parameter of the
3161          --  init proc for the enclosing type.
3162
3163       else
3164          Set_Entity (N, Discriminal (E));
3165       end if;
3166    end Set_Entity_Or_Discriminal;
3167
3168    -----------------------------------
3169    -- Check_In_Previous_With_Clause --
3170    -----------------------------------
3171
3172    procedure Check_In_Previous_With_Clause
3173      (N   : Node_Id;
3174       Nam : Entity_Id)
3175    is
3176       Pack : constant Entity_Id := Entity (Original_Node (Nam));
3177       Item : Node_Id;
3178       Par  : Node_Id;
3179
3180    begin
3181       Item := First (Context_Items (Parent (N)));
3182
3183       while Present (Item)
3184         and then Item /= N
3185       loop
3186          if Nkind (Item) = N_With_Clause
3187
3188             --  Protect the frontend against previous critical errors
3189
3190            and then Nkind (Name (Item)) /= N_Selected_Component
3191            and then Entity (Name (Item)) = Pack
3192          then
3193             Par := Nam;
3194
3195             --  Find root library unit in with_clause
3196
3197             while Nkind (Par) = N_Expanded_Name loop
3198                Par := Prefix (Par);
3199             end loop;
3200
3201             if Is_Child_Unit (Entity (Original_Node (Par))) then
3202                Error_Msg_NE ("& is not directly visible", Par, Entity (Par));
3203             else
3204                return;
3205             end if;
3206          end if;
3207
3208          Next (Item);
3209       end loop;
3210
3211       --  On exit, package is not mentioned in a previous with_clause.
3212       --  Check if its prefix is.
3213
3214       if Nkind (Nam) = N_Expanded_Name then
3215          Check_In_Previous_With_Clause (N, Prefix (Nam));
3216
3217       elsif Pack /= Any_Id then
3218          Error_Msg_NE ("& is not visible", Nam, Pack);
3219       end if;
3220    end Check_In_Previous_With_Clause;
3221
3222    ---------------------------------
3223    -- Check_Library_Unit_Renaming --
3224    ---------------------------------
3225
3226    procedure Check_Library_Unit_Renaming (N : Node_Id; Old_E : Entity_Id) is
3227       New_E : Entity_Id;
3228
3229    begin
3230       if Nkind (Parent (N)) /= N_Compilation_Unit then
3231          return;
3232
3233       --  Check for library unit. Note that we used to check for the scope
3234       --  being Standard here, but that was wrong for Standard itself.
3235
3236       elsif not Is_Compilation_Unit (Old_E)
3237         and then not Is_Child_Unit (Old_E)
3238       then
3239          Error_Msg_N ("renamed unit must be a library unit", Name (N));
3240
3241       --  Entities defined in Standard (operators and boolean literals) cannot
3242       --  be renamed as library units.
3243
3244       elsif Scope (Old_E) = Standard_Standard
3245         and then Sloc (Old_E) = Standard_Location
3246       then
3247          Error_Msg_N ("renamed unit must be a library unit", Name (N));
3248
3249       elsif Present (Parent_Spec (N))
3250         and then Nkind (Unit (Parent_Spec (N))) = N_Generic_Package_Declaration
3251         and then not Is_Child_Unit (Old_E)
3252       then
3253          Error_Msg_N
3254            ("renamed unit must be a child unit of generic parent", Name (N));
3255
3256       elsif Nkind (N) in N_Generic_Renaming_Declaration
3257          and then  Nkind (Name (N)) = N_Expanded_Name
3258          and then Is_Generic_Instance (Entity (Prefix (Name (N))))
3259          and then Is_Generic_Unit (Old_E)
3260       then
3261          Error_Msg_N
3262            ("renamed generic unit must be a library unit", Name (N));
3263
3264       elsif Is_Package_Or_Generic_Package (Old_E) then
3265
3266          --  Inherit categorization flags
3267
3268          New_E := Defining_Entity (N);
3269          Set_Is_Pure                  (New_E, Is_Pure           (Old_E));
3270          Set_Is_Preelaborated         (New_E, Is_Preelaborated  (Old_E));
3271          Set_Is_Remote_Call_Interface (New_E,
3272                                        Is_Remote_Call_Interface (Old_E));
3273          Set_Is_Remote_Types          (New_E, Is_Remote_Types   (Old_E));
3274          Set_Is_Shared_Passive        (New_E, Is_Shared_Passive (Old_E));
3275       end if;
3276    end Check_Library_Unit_Renaming;
3277
3278    ---------------
3279    -- End_Scope --
3280    ---------------
3281
3282    procedure End_Scope is
3283       Id    : Entity_Id;
3284       Prev  : Entity_Id;
3285       Outer : Entity_Id;
3286
3287    begin
3288       Id := First_Entity (Current_Scope);
3289       while Present (Id) loop
3290          --  An entity in the current scope is not necessarily the first one
3291          --  on its homonym chain. Find its predecessor if any,
3292          --  If it is an internal entity, it will not be in the visibility
3293          --  chain altogether,  and there is nothing to unchain.
3294
3295          if Id /= Current_Entity (Id) then
3296             Prev := Current_Entity (Id);
3297             while Present (Prev)
3298               and then Present (Homonym (Prev))
3299               and then Homonym (Prev) /= Id
3300             loop
3301                Prev := Homonym (Prev);
3302             end loop;
3303
3304             --  Skip to end of loop if Id is not in the visibility chain
3305
3306             if No (Prev) or else Homonym (Prev) /= Id then
3307                goto Next_Ent;
3308             end if;
3309
3310          else
3311             Prev := Empty;
3312          end if;
3313
3314          Set_Is_Immediately_Visible (Id, False);
3315
3316          Outer := Homonym (Id);
3317          while Present (Outer) and then Scope (Outer) = Current_Scope loop
3318             Outer := Homonym (Outer);
3319          end loop;
3320
3321          --  Reset homonym link of other entities, but do not modify link
3322          --  between entities in current scope, so that the back-end can have
3323          --  a proper count of local overloadings.
3324
3325          if No (Prev) then
3326             Set_Name_Entity_Id (Chars (Id), Outer);
3327
3328          elsif Scope (Prev) /= Scope (Id) then
3329             Set_Homonym (Prev,  Outer);
3330          end if;
3331
3332          <<Next_Ent>>
3333             Next_Entity (Id);
3334       end loop;
3335
3336       --  If the scope generated freeze actions, place them before the
3337       --  current declaration and analyze them. Type declarations and
3338       --  the bodies of initialization procedures can generate such nodes.
3339       --  We follow the parent chain until we reach a list node, which is
3340       --  the enclosing list of declarations. If the list appears within
3341       --  a protected definition, move freeze nodes outside the protected
3342       --  type altogether.
3343
3344       if Present
3345          (Scope_Stack.Table (Scope_Stack.Last).Pending_Freeze_Actions)
3346       then
3347          declare
3348             Decl : Node_Id;
3349             L    : constant List_Id := Scope_Stack.Table
3350                     (Scope_Stack.Last).Pending_Freeze_Actions;
3351
3352          begin
3353             if Is_Itype (Current_Scope) then
3354                Decl := Associated_Node_For_Itype (Current_Scope);
3355             else
3356                Decl := Parent (Current_Scope);
3357             end if;
3358
3359             Pop_Scope;
3360
3361             while not (Is_List_Member (Decl))
3362               or else Nkind_In (Parent (Decl), N_Protected_Definition,
3363                                                N_Task_Definition)
3364             loop
3365                Decl := Parent (Decl);
3366             end loop;
3367
3368             Insert_List_Before_And_Analyze (Decl, L);
3369          end;
3370
3371       else
3372          Pop_Scope;
3373       end if;
3374
3375    end End_Scope;
3376
3377    ---------------------
3378    -- End_Use_Clauses --
3379    ---------------------
3380
3381    procedure End_Use_Clauses (Clause : Node_Id) is
3382       U   : Node_Id;
3383
3384    begin
3385       --  Remove Use_Type clauses first, because they affect the
3386       --  visibility of operators in subsequent used packages.
3387
3388       U := Clause;
3389       while Present (U) loop
3390          if Nkind (U) = N_Use_Type_Clause then
3391             End_Use_Type (U);
3392          end if;
3393
3394          Next_Use_Clause (U);
3395       end loop;
3396
3397       U := Clause;
3398       while Present (U) loop
3399          if Nkind (U) = N_Use_Package_Clause then
3400             End_Use_Package (U);
3401          end if;
3402
3403          Next_Use_Clause (U);
3404       end loop;
3405    end End_Use_Clauses;
3406
3407    ---------------------
3408    -- End_Use_Package --
3409    ---------------------
3410
3411    procedure End_Use_Package (N : Node_Id) is
3412       Pack_Name : Node_Id;
3413       Pack      : Entity_Id;
3414       Id        : Entity_Id;
3415       Elmt      : Elmt_Id;
3416
3417       function Is_Primitive_Operator_In_Use
3418         (Op : Entity_Id;
3419          F  : Entity_Id) return Boolean;
3420       --  Check whether Op is a primitive operator of a use-visible type
3421
3422       ----------------------------------
3423       -- Is_Primitive_Operator_In_Use --
3424       ----------------------------------
3425
3426       function Is_Primitive_Operator_In_Use
3427         (Op : Entity_Id;
3428          F  : Entity_Id) return Boolean
3429       is
3430          T : constant Entity_Id := Etype (F);
3431       begin
3432          return (In_Use (T)
3433                   or else Present (Current_Use_Clause (Base_Type (T))))
3434            and then Scope (T) = Scope (Op);
3435       end Is_Primitive_Operator_In_Use;
3436
3437    --  Start of processing for End_Use_Package
3438
3439    begin
3440       Pack_Name := First (Names (N));
3441       while Present (Pack_Name) loop
3442
3443          --  Test that Pack_Name actually denotes a package before processing
3444
3445          if Is_Entity_Name (Pack_Name)
3446            and then Ekind (Entity (Pack_Name)) = E_Package
3447          then
3448             Pack := Entity (Pack_Name);
3449
3450             if In_Open_Scopes (Pack) then
3451                null;
3452
3453             elsif not Redundant_Use (Pack_Name) then
3454                Set_In_Use (Pack, False);
3455                Set_Current_Use_Clause (Pack, Empty);
3456
3457                Id := First_Entity (Pack);
3458                while Present (Id) loop
3459
3460                   --  Preserve use-visibility of operators that are primitive
3461                   --  operators of a type that is use-visible through an active
3462                   --  use_type clause.
3463
3464                   if Nkind (Id) = N_Defining_Operator_Symbol
3465                        and then
3466                          (Is_Primitive_Operator_In_Use
3467                            (Id, First_Formal (Id))
3468                             or else
3469                           (Present (Next_Formal (First_Formal (Id)))
3470                              and then
3471                                Is_Primitive_Operator_In_Use
3472                                  (Id, Next_Formal (First_Formal (Id)))))
3473                   then
3474                      null;
3475
3476                   else
3477                      Set_Is_Potentially_Use_Visible (Id, False);
3478                   end if;
3479
3480                   if Is_Private_Type (Id)
3481                     and then Present (Full_View (Id))
3482                   then
3483                      Set_Is_Potentially_Use_Visible (Full_View (Id), False);
3484                   end if;
3485
3486                   Next_Entity (Id);
3487                end loop;
3488
3489                if Present (Renamed_Object (Pack)) then
3490                   Set_In_Use (Renamed_Object (Pack), False);
3491                   Set_Current_Use_Clause (Renamed_Object (Pack), Empty);
3492                end if;
3493
3494                if Chars (Pack) = Name_System
3495                  and then Scope (Pack) = Standard_Standard
3496                  and then Present_System_Aux
3497                then
3498                   Id := First_Entity (System_Aux_Id);
3499                   while Present (Id) loop
3500                      Set_Is_Potentially_Use_Visible (Id, False);
3501
3502                      if Is_Private_Type (Id)
3503                        and then Present (Full_View (Id))
3504                      then
3505                         Set_Is_Potentially_Use_Visible (Full_View (Id), False);
3506                      end if;
3507
3508                      Next_Entity (Id);
3509                   end loop;
3510
3511                   Set_In_Use (System_Aux_Id, False);
3512                end if;
3513
3514             else
3515                Set_Redundant_Use (Pack_Name, False);
3516             end if;
3517          end if;
3518
3519          Next (Pack_Name);
3520       end loop;
3521
3522       if Present (Hidden_By_Use_Clause (N)) then
3523          Elmt := First_Elmt (Hidden_By_Use_Clause (N));
3524          while Present (Elmt) loop
3525             declare
3526                E : constant Entity_Id := Node (Elmt);
3527
3528             begin
3529                --  Reset either Use_Visibility or Direct_Visibility, depending
3530                --  on how the entity was hidden by the use clause.
3531
3532                if In_Use (Scope (E))
3533                  and then Used_As_Generic_Actual (Scope (E))
3534                then
3535                   Set_Is_Potentially_Use_Visible (Node (Elmt));
3536                else
3537                   Set_Is_Immediately_Visible (Node (Elmt));
3538                end if;
3539
3540                Next_Elmt (Elmt);
3541             end;
3542          end loop;
3543
3544          Set_Hidden_By_Use_Clause (N, No_Elist);
3545       end if;
3546    end End_Use_Package;
3547
3548    ------------------
3549    -- End_Use_Type --
3550    ------------------
3551
3552    procedure End_Use_Type (N : Node_Id) is
3553       Elmt    : Elmt_Id;
3554       Id      : Entity_Id;
3555       T       : Entity_Id;
3556
3557    --  Start of processing for End_Use_Type
3558
3559    begin
3560       Id := First (Subtype_Marks (N));
3561       while Present (Id) loop
3562
3563          --  A call to Rtsfind may occur while analyzing a use_type clause,
3564          --  in which case the type marks are not resolved yet, and there is
3565          --  nothing to remove.
3566
3567          if not Is_Entity_Name (Id) or else No (Entity (Id)) then
3568             goto Continue;
3569          end if;
3570
3571          T := Entity (Id);
3572
3573          if T = Any_Type or else From_With_Type (T) then
3574             null;
3575
3576          --  Note that the use_type clause may mention a subtype of the type
3577          --  whose primitive operations have been made visible. Here as
3578          --  elsewhere, it is the base type that matters for visibility.
3579
3580          elsif In_Open_Scopes (Scope (Base_Type (T))) then
3581             null;
3582
3583          elsif not Redundant_Use (Id) then
3584             Set_In_Use (T, False);
3585             Set_In_Use (Base_Type (T), False);
3586             Set_Current_Use_Clause (T, Empty);
3587             Set_Current_Use_Clause (Base_Type (T), Empty);
3588          end if;
3589
3590          <<Continue>>
3591             Next (Id);
3592       end loop;
3593
3594       if Is_Empty_Elmt_List (Used_Operations (N)) then
3595          return;
3596
3597       else
3598          Elmt := First_Elmt (Used_Operations (N));
3599          while Present (Elmt) loop
3600             Set_Is_Potentially_Use_Visible (Node (Elmt), False);
3601             Next_Elmt (Elmt);
3602          end loop;
3603       end if;
3604    end End_Use_Type;
3605
3606    ----------------------
3607    -- Find_Direct_Name --
3608    ----------------------
3609
3610    procedure Find_Direct_Name (N : Node_Id) is
3611       E    : Entity_Id;
3612       E2   : Entity_Id;
3613       Msg  : Boolean;
3614
3615       Inst : Entity_Id := Empty;
3616       --  Enclosing instance, if any
3617
3618       Homonyms : Entity_Id;
3619       --  Saves start of homonym chain
3620
3621       Nvis_Entity : Boolean;
3622       --  Set True to indicate that there is at least one entity on the homonym
3623       --  chain which, while not visible, is visible enough from the user point
3624       --  of view to warrant an error message of "not visible" rather than
3625       --  undefined.
3626
3627       Nvis_Is_Private_Subprg : Boolean := False;
3628       --  Ada 2005 (AI-262): Set True to indicate that a form of Beaujolais
3629       --  effect concerning library subprograms has been detected. Used to
3630       --  generate the precise error message.
3631
3632       function From_Actual_Package (E : Entity_Id) return Boolean;
3633       --  Returns true if the entity is declared in a package that is
3634       --  an actual for a formal package of the current instance. Such an
3635       --  entity requires special handling because it may be use-visible
3636       --  but hides directly visible entities defined outside the instance.
3637
3638       function Is_Actual_Parameter return Boolean;
3639       --  This function checks if the node N is an identifier that is an actual
3640       --  parameter of a procedure call. If so it returns True, otherwise it
3641       --  return False. The reason for this check is that at this stage we do
3642       --  not know what procedure is being called if the procedure might be
3643       --  overloaded, so it is premature to go setting referenced flags or
3644       --  making calls to Generate_Reference. We will wait till Resolve_Actuals
3645       --  for that processing
3646
3647       function Known_But_Invisible (E : Entity_Id) return Boolean;
3648       --  This function determines whether the entity E (which is not
3649       --  visible) can reasonably be considered to be known to the writer
3650       --  of the reference. This is a heuristic test, used only for the
3651       --  purposes of figuring out whether we prefer to complain that an
3652       --  entity is undefined or invisible (and identify the declaration
3653       --  of the invisible entity in the latter case). The point here is
3654       --  that we don't want to complain that something is invisible and
3655       --  then point to something entirely mysterious to the writer.
3656
3657       procedure Nvis_Messages;
3658       --  Called if there are no visible entries for N, but there is at least
3659       --  one non-directly visible, or hidden declaration. This procedure
3660       --  outputs an appropriate set of error messages.
3661
3662       procedure Undefined (Nvis : Boolean);
3663       --  This function is called if the current node has no corresponding
3664       --  visible entity or entities. The value set in Msg indicates whether
3665       --  an error message was generated (multiple error messages for the
3666       --  same variable are generally suppressed, see body for details).
3667       --  Msg is True if an error message was generated, False if not. This
3668       --  value is used by the caller to determine whether or not to output
3669       --  additional messages where appropriate. The parameter is set False
3670       --  to get the message "X is undefined", and True to get the message
3671       --  "X is not visible".
3672
3673       -------------------------
3674       -- From_Actual_Package --
3675       -------------------------
3676
3677       function From_Actual_Package (E : Entity_Id) return Boolean is
3678          Scop : constant Entity_Id := Scope (E);
3679          Act  : Entity_Id;
3680
3681       begin
3682          if not In_Instance then
3683             return False;
3684          else
3685             Inst := Current_Scope;
3686             while Present (Inst)
3687               and then Ekind (Inst) /= E_Package
3688               and then not Is_Generic_Instance (Inst)
3689             loop
3690                Inst := Scope (Inst);
3691             end loop;
3692
3693             if No (Inst) then
3694                return False;
3695             end if;
3696
3697             Act := First_Entity (Inst);
3698             while Present (Act) loop
3699                if Ekind (Act) = E_Package then
3700
3701                   --  Check for end of actuals list
3702
3703                   if Renamed_Object (Act) = Inst then
3704                      return False;
3705
3706                   elsif Present (Associated_Formal_Package (Act))
3707                     and then Renamed_Object (Act) = Scop
3708                   then
3709                      --  Entity comes from (instance of) formal package
3710
3711                      return True;
3712
3713                   else
3714                      Next_Entity (Act);
3715                   end if;
3716
3717                else
3718                   Next_Entity (Act);
3719                end if;
3720             end loop;
3721
3722             return False;
3723          end if;
3724       end From_Actual_Package;
3725
3726       -------------------------
3727       -- Is_Actual_Parameter --
3728       -------------------------
3729
3730       function Is_Actual_Parameter return Boolean is
3731       begin
3732          return
3733            Nkind (N) = N_Identifier
3734              and then
3735                (Nkind (Parent (N)) = N_Procedure_Call_Statement
3736                   or else
3737                     (Nkind (Parent (N)) = N_Parameter_Association
3738                        and then N = Explicit_Actual_Parameter (Parent (N))
3739                        and then Nkind (Parent (Parent (N))) =
3740                                           N_Procedure_Call_Statement));
3741       end Is_Actual_Parameter;
3742
3743       -------------------------
3744       -- Known_But_Invisible --
3745       -------------------------
3746
3747       function Known_But_Invisible (E : Entity_Id) return Boolean is
3748          Fname : File_Name_Type;
3749
3750       begin
3751          --  Entities in Standard are always considered to be known
3752
3753          if Sloc (E) <= Standard_Location then
3754             return True;
3755
3756          --  An entity that does not come from source is always considered
3757          --  to be unknown, since it is an artifact of code expansion.
3758
3759          elsif not Comes_From_Source (E) then
3760             return False;
3761
3762          --  In gnat internal mode, we consider all entities known
3763
3764          elsif GNAT_Mode then
3765             return True;
3766          end if;
3767
3768          --  Here we have an entity that is not from package Standard, and
3769          --  which comes from Source. See if it comes from an internal file.
3770
3771          Fname := Unit_File_Name (Get_Source_Unit (E));
3772
3773          --  Case of from internal file
3774
3775          if Is_Internal_File_Name (Fname) then
3776
3777             --  Private part entities in internal files are never considered
3778             --  to be known to the writer of normal application code.
3779
3780             if Is_Hidden (E) then
3781                return False;
3782             end if;
3783
3784             --  Entities from System packages other than System and
3785             --  System.Storage_Elements are not considered to be known.
3786             --  System.Auxxxx files are also considered known to the user.
3787
3788             --  Should refine this at some point to generally distinguish
3789             --  between known and unknown internal files ???
3790
3791             Get_Name_String (Fname);
3792
3793             return
3794               Name_Len < 2
3795                 or else
3796               Name_Buffer (1 .. 2) /= "s-"
3797                 or else
3798               Name_Buffer (3 .. 8) = "stoele"
3799                 or else
3800               Name_Buffer (3 .. 5) = "aux";
3801
3802          --  If not an internal file, then entity is definitely known,
3803          --  even if it is in a private part (the message generated will
3804          --  note that it is in a private part)
3805
3806          else
3807             return True;
3808          end if;
3809       end Known_But_Invisible;
3810
3811       -------------------
3812       -- Nvis_Messages --
3813       -------------------
3814
3815       procedure Nvis_Messages is
3816          Comp_Unit : Node_Id;
3817          Ent       : Entity_Id;
3818          Found     : Boolean := False;
3819          Hidden    : Boolean := False;
3820          Item      : Node_Id;
3821
3822       begin
3823          --  Ada 2005 (AI-262): Generate a precise error concerning the
3824          --  Beaujolais effect that was previously detected
3825
3826          if Nvis_Is_Private_Subprg then
3827
3828             pragma Assert (Nkind (E2) = N_Defining_Identifier
3829                             and then Ekind (E2) = E_Function
3830                             and then Scope (E2) = Standard_Standard
3831                             and then Has_Private_With (E2));
3832
3833             --  Find the sloc corresponding to the private with'ed unit
3834
3835             Comp_Unit := Cunit (Current_Sem_Unit);
3836             Error_Msg_Sloc := No_Location;
3837
3838             Item := First (Context_Items (Comp_Unit));
3839             while Present (Item) loop
3840                if Nkind (Item) = N_With_Clause
3841                  and then Private_Present (Item)
3842                  and then Entity (Name (Item)) = E2
3843                then
3844                   Error_Msg_Sloc := Sloc (Item);
3845                   exit;
3846                end if;
3847
3848                Next (Item);
3849             end loop;
3850
3851             pragma Assert (Error_Msg_Sloc /= No_Location);
3852
3853             Error_Msg_N ("(Ada 2005): hidden by private with clause #", N);
3854             return;
3855          end if;
3856
3857          Undefined (Nvis => True);
3858
3859          if Msg then
3860
3861             --  First loop does hidden declarations
3862
3863             Ent := Homonyms;
3864             while Present (Ent) loop
3865                if Is_Potentially_Use_Visible (Ent) then
3866                   if not Hidden then
3867                      Error_Msg_N -- CODEFIX
3868                        ("multiple use clauses cause hiding!", N);
3869                      Hidden := True;
3870                   end if;
3871
3872                   Error_Msg_Sloc := Sloc (Ent);
3873                   Error_Msg_N -- CODEFIX
3874                     ("hidden declaration#!", N);
3875                end if;
3876
3877                Ent := Homonym (Ent);
3878             end loop;
3879
3880             --  If we found hidden declarations, then that's enough, don't
3881             --  bother looking for non-visible declarations as well.
3882
3883             if Hidden then
3884                return;
3885             end if;
3886
3887             --  Second loop does non-directly visible declarations
3888
3889             Ent := Homonyms;
3890             while Present (Ent) loop
3891                if not Is_Potentially_Use_Visible (Ent) then
3892
3893                   --  Do not bother the user with unknown entities
3894
3895                   if not Known_But_Invisible (Ent) then
3896                      goto Continue;
3897                   end if;
3898
3899                   Error_Msg_Sloc := Sloc (Ent);
3900
3901                   --  Output message noting that there is a non-visible
3902                   --  declaration, distinguishing the private part case.
3903
3904                   if Is_Hidden (Ent) then
3905                      Error_Msg_N ("non-visible (private) declaration#!", N);
3906
3907                   --  If the entity is declared in a generic package, it
3908                   --  cannot be visible, so there is no point in adding it
3909                   --  to the list of candidates if another homograph from a
3910                   --  non-generic package has been seen.
3911
3912                   elsif Ekind (Scope (Ent)) = E_Generic_Package
3913                     and then Found
3914                   then
3915                      null;
3916
3917                   else
3918                      Error_Msg_N -- CODEFIX
3919                        ("non-visible declaration#!", N);
3920
3921                      if Ekind (Scope (Ent)) /= E_Generic_Package then
3922                         Found := True;
3923                      end if;
3924
3925                      if Is_Compilation_Unit (Ent)
3926                        and then
3927                          Nkind (Parent (Parent (N))) = N_Use_Package_Clause
3928                      then
3929                         Error_Msg_Qual_Level := 99;
3930                         Error_Msg_NE -- CODEFIX
3931                           ("\\missing `WITH &;`", N, Ent);
3932                         Error_Msg_Qual_Level := 0;
3933                      end if;
3934
3935                      if Ekind (Ent) = E_Discriminant
3936                        and then Present (Corresponding_Discriminant (Ent))
3937                        and then Scope (Corresponding_Discriminant (Ent)) =
3938                                                         Etype (Scope (Ent))
3939                      then
3940                         Error_Msg_N
3941                           ("inherited discriminant not allowed here" &
3942                             " (RM 3.8 (12), 3.8.1 (6))!", N);
3943                      end if;
3944                   end if;
3945
3946                   --  Set entity and its containing package as referenced. We
3947                   --  can't be sure of this, but this seems a better choice
3948                   --  to avoid unused entity messages.
3949
3950                   if Comes_From_Source (Ent) then
3951                      Set_Referenced (Ent);
3952                      Set_Referenced (Cunit_Entity (Get_Source_Unit (Ent)));
3953                   end if;
3954                end if;
3955
3956                <<Continue>>
3957                Ent := Homonym (Ent);
3958             end loop;
3959          end if;
3960       end Nvis_Messages;
3961
3962       ---------------
3963       -- Undefined --
3964       ---------------
3965
3966       procedure Undefined (Nvis : Boolean) is
3967          Emsg : Error_Msg_Id;
3968
3969       begin
3970          --  We should never find an undefined internal name. If we do, then
3971          --  see if we have previous errors. If so, ignore on the grounds that
3972          --  it is probably a cascaded message (e.g. a block label from a badly
3973          --  formed block). If no previous errors, then we have a real internal
3974          --  error of some kind so raise an exception.
3975
3976          if Is_Internal_Name (Chars (N)) then
3977             if Total_Errors_Detected /= 0 then
3978                return;
3979             else
3980                raise Program_Error;
3981             end if;
3982          end if;
3983
3984          --  A very specialized error check, if the undefined variable is
3985          --  a case tag, and the case type is an enumeration type, check
3986          --  for a possible misspelling, and if so, modify the identifier
3987
3988          --  Named aggregate should also be handled similarly ???
3989
3990          if Nkind (N) = N_Identifier
3991            and then Nkind (Parent (N)) = N_Case_Statement_Alternative
3992          then
3993             declare
3994                Case_Stm : constant Node_Id   := Parent (Parent (N));
3995                Case_Typ : constant Entity_Id := Etype (Expression (Case_Stm));
3996
3997                Lit : Node_Id;
3998
3999             begin
4000                if Is_Enumeration_Type (Case_Typ)
4001                  and then not Is_Standard_Character_Type (Case_Typ)
4002                then
4003                   Lit := First_Literal (Case_Typ);
4004                   Get_Name_String (Chars (Lit));
4005
4006                   if Chars (Lit) /= Chars (N)
4007                     and then Is_Bad_Spelling_Of (Chars (N), Chars (Lit)) then
4008                      Error_Msg_Node_2 := Lit;
4009                      Error_Msg_N -- CODEFIX
4010                        ("& is undefined, assume misspelling of &", N);
4011                      Rewrite (N, New_Occurrence_Of (Lit, Sloc (N)));
4012                      return;
4013                   end if;
4014
4015                   Lit := Next_Literal (Lit);
4016                end if;
4017             end;
4018          end if;
4019
4020          --  Normal processing
4021
4022          Set_Entity (N, Any_Id);
4023          Set_Etype  (N, Any_Type);
4024
4025          --  We use the table Urefs to keep track of entities for which we
4026          --  have issued errors for undefined references. Multiple errors
4027          --  for a single name are normally suppressed, however we modify
4028          --  the error message to alert the programmer to this effect.
4029
4030          for J in Urefs.First .. Urefs.Last loop
4031             if Chars (N) = Chars (Urefs.Table (J).Node) then
4032                if Urefs.Table (J).Err /= No_Error_Msg
4033                  and then Sloc (N) /= Urefs.Table (J).Loc
4034                then
4035                   Error_Msg_Node_1 := Urefs.Table (J).Node;
4036
4037                   if Urefs.Table (J).Nvis then
4038                      Change_Error_Text (Urefs.Table (J).Err,
4039                        "& is not visible (more references follow)");
4040                   else
4041                      Change_Error_Text (Urefs.Table (J).Err,
4042                        "& is undefined (more references follow)");
4043                   end if;
4044
4045                   Urefs.Table (J).Err := No_Error_Msg;
4046                end if;
4047
4048                --  Although we will set Msg False, and thus suppress the
4049                --  message, we also set Error_Posted True, to avoid any
4050                --  cascaded messages resulting from the undefined reference.
4051
4052                Msg := False;
4053                Set_Error_Posted (N, True);
4054                return;
4055             end if;
4056          end loop;
4057
4058          --  If entry not found, this is first undefined occurrence
4059
4060          if Nvis then
4061             Error_Msg_N ("& is not visible!", N);
4062             Emsg := Get_Msg_Id;
4063
4064          else
4065             Error_Msg_N ("& is undefined!", N);
4066             Emsg := Get_Msg_Id;
4067
4068             --  A very bizarre special check, if the undefined identifier
4069             --  is put or put_line, then add a special error message (since
4070             --  this is a very common error for beginners to make).
4071
4072             if Chars (N) = Name_Put or else Chars (N) = Name_Put_Line then
4073                Error_Msg_N -- CODEFIX
4074                  ("\\possible missing `WITH Ada.Text_'I'O; " &
4075                   "USE Ada.Text_'I'O`!", N);
4076
4077             --  Another special check if N is the prefix of a selected
4078             --  component which is a known unit, add message complaining
4079             --  about missing with for this unit.
4080
4081             elsif Nkind (Parent (N)) = N_Selected_Component
4082               and then N = Prefix (Parent (N))
4083               and then Is_Known_Unit (Parent (N))
4084             then
4085                Error_Msg_Node_2 := Selector_Name (Parent (N));
4086                Error_Msg_N -- CODEFIX
4087                  ("\\missing `WITH &.&;`", Prefix (Parent (N)));
4088             end if;
4089
4090             --  Now check for possible misspellings
4091
4092             declare
4093                E      : Entity_Id;
4094                Ematch : Entity_Id := Empty;
4095
4096                Last_Name_Id : constant Name_Id :=
4097                                 Name_Id (Nat (First_Name_Id) +
4098                                            Name_Entries_Count - 1);
4099
4100             begin
4101                for Nam in First_Name_Id .. Last_Name_Id loop
4102                   E := Get_Name_Entity_Id (Nam);
4103
4104                   if Present (E)
4105                      and then (Is_Immediately_Visible (E)
4106                                  or else
4107                                Is_Potentially_Use_Visible (E))
4108                   then
4109                      if Is_Bad_Spelling_Of (Chars (N), Nam) then
4110                         Ematch := E;
4111                         exit;
4112                      end if;
4113                   end if;
4114                end loop;
4115
4116                if Present (Ematch) then
4117                   Error_Msg_NE -- CODEFIX
4118                     ("\possible misspelling of&", N, Ematch);
4119                end if;
4120             end;
4121          end if;
4122
4123          --  Make entry in undefined references table unless the full errors
4124          --  switch is set, in which case by refraining from generating the
4125          --  table entry, we guarantee that we get an error message for every
4126          --  undefined reference.
4127
4128          if not All_Errors_Mode then
4129             Urefs.Append (
4130               (Node => N,
4131                Err  => Emsg,
4132                Nvis => Nvis,
4133                Loc  => Sloc (N)));
4134          end if;
4135
4136          Msg := True;
4137       end Undefined;
4138
4139    --  Start of processing for Find_Direct_Name
4140
4141    begin
4142       --  If the entity pointer is already set, this is an internal node, or
4143       --  a node that is analyzed more than once, after a tree modification.
4144       --  In such a case there is no resolution to perform, just set the type.
4145
4146       if Present (Entity (N)) then
4147          if Is_Type (Entity (N)) then
4148             Set_Etype (N, Entity (N));
4149
4150          else
4151             declare
4152                Entyp : constant Entity_Id := Etype (Entity (N));
4153
4154             begin
4155                --  One special case here. If the Etype field is already set,
4156                --  and references the packed array type corresponding to the
4157                --  etype of the referenced entity, then leave it alone. This
4158                --  happens for trees generated from Exp_Pakd, where expressions
4159                --  can be deliberately "mis-typed" to the packed array type.
4160
4161                if Is_Array_Type (Entyp)
4162                  and then Is_Packed (Entyp)
4163                  and then Present (Etype (N))
4164                  and then Etype (N) = Packed_Array_Type (Entyp)
4165                then
4166                   null;
4167
4168                --  If not that special case, then just reset the Etype
4169
4170                else
4171                   Set_Etype (N, Etype (Entity (N)));
4172                end if;
4173             end;
4174          end if;
4175
4176          return;
4177       end if;
4178
4179       --  Here if Entity pointer was not set, we need full visibility analysis
4180       --  First we generate debugging output if the debug E flag is set.
4181
4182       if Debug_Flag_E then
4183          Write_Str ("Looking for ");
4184          Write_Name (Chars (N));
4185          Write_Eol;
4186       end if;
4187
4188       Homonyms := Current_Entity (N);
4189       Nvis_Entity := False;
4190
4191       E := Homonyms;
4192       while Present (E) loop
4193
4194          --  If entity is immediately visible or potentially use visible, then
4195          --  process the entity and we are done.
4196
4197          if Is_Immediately_Visible (E) then
4198             goto Immediately_Visible_Entity;
4199
4200          elsif Is_Potentially_Use_Visible (E) then
4201             goto Potentially_Use_Visible_Entity;
4202
4203          --  Note if a known but invisible entity encountered
4204
4205          elsif Known_But_Invisible (E) then
4206             Nvis_Entity := True;
4207          end if;
4208
4209          --  Move to next entity in chain and continue search
4210
4211          E := Homonym (E);
4212       end loop;
4213
4214       --  If no entries on homonym chain that were potentially visible,
4215       --  and no entities reasonably considered as non-visible, then
4216       --  we have a plain undefined reference, with no additional
4217       --  explanation required!
4218
4219       if not Nvis_Entity then
4220          Undefined (Nvis => False);
4221
4222       --  Otherwise there is at least one entry on the homonym chain that
4223       --  is reasonably considered as being known and non-visible.
4224
4225       else
4226          Nvis_Messages;
4227       end if;
4228
4229       return;
4230
4231       --  Processing for a potentially use visible entry found. We must search
4232       --  the rest of the homonym chain for two reasons. First, if there is a
4233       --  directly visible entry, then none of the potentially use-visible
4234       --  entities are directly visible (RM 8.4(10)). Second, we need to check
4235       --  for the case of multiple potentially use-visible entries hiding one
4236       --  another and as a result being non-directly visible (RM 8.4(11)).
4237
4238       <<Potentially_Use_Visible_Entity>> declare
4239          Only_One_Visible : Boolean := True;
4240          All_Overloadable : Boolean := Is_Overloadable (E);
4241
4242       begin
4243          E2 := Homonym (E);
4244          while Present (E2) loop
4245             if Is_Immediately_Visible (E2) then
4246
4247                --  If the use-visible entity comes from the actual for a
4248                --  formal package, it hides a directly visible entity from
4249                --  outside the instance.
4250
4251                if From_Actual_Package (E)
4252                  and then Scope_Depth (E2) < Scope_Depth (Inst)
4253                then
4254                   goto Found;
4255                else
4256                   E := E2;
4257                   goto Immediately_Visible_Entity;
4258                end if;
4259
4260             elsif Is_Potentially_Use_Visible (E2) then
4261                Only_One_Visible := False;
4262                All_Overloadable := All_Overloadable and Is_Overloadable (E2);
4263
4264             --  Ada 2005 (AI-262): Protect against a form of Beaujolais effect
4265             --  that can occur in private_with clauses. Example:
4266
4267             --    with A;
4268             --    private with B;              package A is
4269             --    package C is                   function B return Integer;
4270             --      use A;                     end A;
4271             --      V1 : Integer := B;
4272             --    private                      function B return Integer;
4273             --      V2 : Integer := B;
4274             --    end C;
4275
4276             --  V1 resolves to A.B, but V2 resolves to library unit B
4277
4278             elsif Ekind (E2) = E_Function
4279               and then Scope (E2) = Standard_Standard
4280               and then Has_Private_With (E2)
4281             then
4282                Only_One_Visible       := False;
4283                All_Overloadable       := False;
4284                Nvis_Is_Private_Subprg := True;
4285                exit;
4286             end if;
4287
4288             E2 := Homonym (E2);
4289          end loop;
4290
4291          --  On falling through this loop, we have checked that there are no
4292          --  immediately visible entities. Only_One_Visible is set if exactly
4293          --  one potentially use visible entity exists. All_Overloadable is
4294          --  set if all the potentially use visible entities are overloadable.
4295          --  The condition for legality is that either there is one potentially
4296          --  use visible entity, or if there is more than one, then all of them
4297          --  are overloadable.
4298
4299          if Only_One_Visible or All_Overloadable then
4300             goto Found;
4301
4302          --  If there is more than one potentially use-visible entity and at
4303          --  least one of them non-overloadable, we have an error (RM 8.4(11).
4304          --  Note that E points to the first such entity on the homonym list.
4305          --  Special case: if one of the entities is declared in an actual
4306          --  package, it was visible in the generic, and takes precedence over
4307          --  other entities that are potentially use-visible. Same if it is
4308          --  declared in a local instantiation of the current instance.
4309
4310          else
4311             if In_Instance then
4312
4313                --  Find current instance
4314
4315                Inst := Current_Scope;
4316                while Present (Inst)
4317                  and then Inst /= Standard_Standard
4318                loop
4319                   if Is_Generic_Instance (Inst) then
4320                      exit;
4321                   end if;
4322
4323                   Inst := Scope (Inst);
4324                end loop;
4325
4326                E2 := E;
4327                while Present (E2) loop
4328                   if From_Actual_Package (E2)
4329                     or else
4330                       (Is_Generic_Instance (Scope (E2))
4331                         and then Scope_Depth (Scope (E2)) > Scope_Depth (Inst))
4332                   then
4333                      E := E2;
4334                      goto Found;
4335                   end if;
4336
4337                   E2 := Homonym (E2);
4338                end loop;
4339
4340                Nvis_Messages;
4341                return;
4342
4343             elsif
4344               Is_Predefined_File_Name (Unit_File_Name (Current_Sem_Unit))
4345             then
4346                --  A use-clause in the body of a system file creates conflict
4347                --  with some entity in a user scope, while rtsfind is active.
4348                --  Keep only the entity coming from another predefined unit.
4349
4350                E2 := E;
4351                while Present (E2) loop
4352                   if Is_Predefined_File_Name
4353                     (Unit_File_Name (Get_Source_Unit (Sloc (E2))))
4354                   then
4355                      E := E2;
4356                      goto Found;
4357                   end if;
4358
4359                   E2 := Homonym (E2);
4360                end loop;
4361
4362                --  Entity must exist because predefined unit is correct
4363
4364                raise Program_Error;
4365
4366             else
4367                Nvis_Messages;
4368                return;
4369             end if;
4370          end if;
4371       end;
4372
4373       --  Come here with E set to the first immediately visible entity on
4374       --  the homonym chain. This is the one we want unless there is another
4375       --  immediately visible entity further on in the chain for an inner
4376       --  scope (RM 8.3(8)).
4377
4378       <<Immediately_Visible_Entity>> declare
4379          Level : Int;
4380          Scop  : Entity_Id;
4381
4382       begin
4383          --  Find scope level of initial entity. When compiling through
4384          --  Rtsfind, the previous context is not completely invisible, and
4385          --  an outer entity may appear on the chain, whose scope is below
4386          --  the entry for Standard that delimits the current scope stack.
4387          --  Indicate that the level for this spurious entry is outside of
4388          --  the current scope stack.
4389
4390          Level := Scope_Stack.Last;
4391          loop
4392             Scop := Scope_Stack.Table (Level).Entity;
4393             exit when Scop = Scope (E);
4394             Level := Level - 1;
4395             exit when Scop = Standard_Standard;
4396          end loop;
4397
4398          --  Now search remainder of homonym chain for more inner entry
4399          --  If the entity is Standard itself, it has no scope, and we
4400          --  compare it with the stack entry directly.
4401
4402          E2 := Homonym (E);
4403          while Present (E2) loop
4404             if Is_Immediately_Visible (E2) then
4405
4406                --  If a generic package contains a local declaration that
4407                --  has the same name as the generic, there may be a visibility
4408                --  conflict in an instance, where the local declaration must
4409                --  also hide the name of the corresponding package renaming.
4410                --  We check explicitly for a package declared by a renaming,
4411                --  whose renamed entity is an instance that is on the scope
4412                --  stack, and that contains a homonym in the same scope. Once
4413                --  we have found it, we know that the package renaming is not
4414                --  immediately visible, and that the identifier denotes the
4415                --  other entity (and its homonyms if overloaded).
4416
4417                if Scope (E) = Scope (E2)
4418                  and then Ekind (E) = E_Package
4419                  and then Present (Renamed_Object (E))
4420                  and then Is_Generic_Instance (Renamed_Object (E))
4421                  and then In_Open_Scopes (Renamed_Object (E))
4422                  and then Comes_From_Source (N)
4423                then
4424                   Set_Is_Immediately_Visible (E, False);
4425                   E := E2;
4426
4427                else
4428                   for J in Level + 1 .. Scope_Stack.Last loop
4429                      if Scope_Stack.Table (J).Entity = Scope (E2)
4430                        or else Scope_Stack.Table (J).Entity = E2
4431                      then
4432                         Level := J;
4433                         E := E2;
4434                         exit;
4435                      end if;
4436                   end loop;
4437                end if;
4438             end if;
4439
4440             E2 := Homonym (E2);
4441          end loop;
4442
4443          --  At the end of that loop, E is the innermost immediately
4444          --  visible entity, so we are all set.
4445       end;
4446
4447       --  Come here with entity found, and stored in E
4448
4449       <<Found>> begin
4450
4451          --  Check violation of No_Wide_Characters restriction
4452
4453          Check_Wide_Character_Restriction (E, N);
4454
4455          --  When distribution features are available (Get_PCS_Name /=
4456          --  Name_No_DSA), a remote access-to-subprogram type is converted
4457          --  into a record type holding whatever information is needed to
4458          --  perform a remote call on an RCI subprogram. In that case we
4459          --  rewrite any occurrence of the RAS type into the equivalent record
4460          --  type here. 'Access attribute references and RAS dereferences are
4461          --  then implemented using specific TSSs. However when distribution is
4462          --  not available (case of Get_PCS_Name = Name_No_DSA), we bypass the
4463          --  generation of these TSSs, and we must keep the RAS type in its
4464          --  original access-to-subprogram form (since all calls through a
4465          --  value of such type will be local anyway in the absence of a PCS).
4466
4467          if Comes_From_Source (N)
4468            and then Is_Remote_Access_To_Subprogram_Type (E)
4469            and then Expander_Active
4470            and then Get_PCS_Name /= Name_No_DSA
4471          then
4472             Rewrite (N,
4473               New_Occurrence_Of (Equivalent_Type (E), Sloc (N)));
4474             return;
4475          end if;
4476
4477          --  Set the entity. Note that the reason we call Set_Entity for the
4478          --  overloadable case, as opposed to Set_Entity_With_Style_Check is
4479          --  that in the overloaded case, the initial call can set the wrong
4480          --  homonym. The call that sets the right homonym is in Sem_Res and
4481          --  that call does use Set_Entity_With_Style_Check, so we don't miss
4482          --  a style check.
4483
4484          if Is_Overloadable (E) then
4485             Set_Entity (N, E);
4486          else
4487             Set_Entity_With_Style_Check (N, E);
4488          end if;
4489
4490          if Is_Type (E) then
4491             Set_Etype (N, E);
4492          else
4493             Set_Etype (N, Get_Full_View (Etype (E)));
4494          end if;
4495
4496          if Debug_Flag_E then
4497             Write_Str (" found  ");
4498             Write_Entity_Info (E, "      ");
4499          end if;
4500
4501          --  If the Ekind of the entity is Void, it means that all homonyms
4502          --  are hidden from all visibility (RM 8.3(5,14-20)). However, this
4503          --  test is skipped if the current scope is a record and the name is
4504          --  a pragma argument expression (case of Atomic and Volatile pragmas
4505          --  and possibly other similar pragmas added later, which are allowed
4506          --  to reference components in the current record).
4507
4508          if Ekind (E) = E_Void
4509            and then
4510              (not Is_Record_Type (Current_Scope)
4511                or else Nkind (Parent (N)) /= N_Pragma_Argument_Association)
4512          then
4513             Premature_Usage (N);
4514
4515          --  If the entity is overloadable, collect all interpretations of the
4516          --  name for subsequent overload resolution. We optimize a bit here to
4517          --  do this only if we have an overloadable entity that is not on its
4518          --  own on the homonym chain.
4519
4520          elsif Is_Overloadable (E)
4521            and then (Present (Homonym (E)) or else Current_Entity (N) /= E)
4522          then
4523             Collect_Interps (N);
4524
4525             --  If no homonyms were visible, the entity is unambiguous
4526
4527             if not Is_Overloaded (N) then
4528                if not Is_Actual_Parameter then
4529                   Generate_Reference (E, N);
4530                end if;
4531             end if;
4532
4533          --  Case of non-overloadable entity, set the entity providing that
4534          --  we do not have the case of a discriminant reference within a
4535          --  default expression. Such references are replaced with the
4536          --  corresponding discriminal, which is the formal corresponding to
4537          --  to the discriminant in the initialization procedure.
4538
4539          else
4540             --  Entity is unambiguous, indicate that it is referenced here
4541
4542             --  For a renaming of an object, always generate simple reference,
4543             --  we don't try to keep track of assignments in this case.
4544
4545             if Is_Object (E) and then Present (Renamed_Object (E)) then
4546                Generate_Reference (E, N);
4547
4548                --  If the renamed entity is a private protected component,
4549                --  reference the original component as well. This needs to be
4550                --  done because the private renamings are installed before any
4551                --  analysis has occurred. Reference to a private component will
4552                --  resolve to the renaming and the original component will be
4553                --  left unreferenced, hence the following.
4554
4555                if Is_Prival (E) then
4556                   Generate_Reference (Prival_Link (E), N);
4557                end if;
4558
4559             --  One odd case is that we do not want to set the Referenced flag
4560             --  if the entity is a label, and the identifier is the label in
4561             --  the source, since this is not a reference from the point of
4562             --  view of the user.
4563
4564             elsif Nkind (Parent (N)) = N_Label then
4565                declare
4566                   R : constant Boolean := Referenced (E);
4567
4568                begin
4569                   --  Generate reference unless this is an actual parameter
4570                   --  (see comment below)
4571
4572                   if Is_Actual_Parameter then
4573                      Generate_Reference (E, N);
4574                      Set_Referenced (E, R);
4575                   end if;
4576                end;
4577
4578             --  Normal case, not a label: generate reference
4579
4580             --    ??? It is too early to generate a reference here even if the
4581             --    entity is unambiguous, because the tree is not sufficiently
4582             --    typed at this point for Generate_Reference to determine
4583             --    whether this reference modifies the denoted object (because
4584             --    implicit dereferences cannot be identified prior to full type
4585             --    resolution).
4586
4587             --    The Is_Actual_Parameter routine takes care of one of these
4588             --    cases but there are others probably ???
4589
4590             --    If the entity is the LHS of an assignment, and is a variable
4591             --    (rather than a package prefix), we can mark it as a
4592             --    modification right away, to avoid duplicate references.
4593
4594             else
4595                if not Is_Actual_Parameter then
4596                   if Is_LHS (N)
4597                     and then Ekind (E) /= E_Package
4598                     and then Ekind (E) /= E_Generic_Package
4599                   then
4600                      Generate_Reference (E, N, 'm');
4601                   else
4602                      Generate_Reference (E, N);
4603                   end if;
4604                end if;
4605
4606                Check_Nested_Access (E);
4607             end if;
4608
4609             Set_Entity_Or_Discriminal (N, E);
4610          end if;
4611       end;
4612    end Find_Direct_Name;
4613
4614    ------------------------
4615    -- Find_Expanded_Name --
4616    ------------------------
4617
4618    --  This routine searches the homonym chain of the entity until it finds
4619    --  an entity declared in the scope denoted by the prefix. If the entity
4620    --  is private, it may nevertheless be immediately visible, if we are in
4621    --  the scope of its declaration.
4622
4623    procedure Find_Expanded_Name (N : Node_Id) is
4624       Selector  : constant Node_Id := Selector_Name (N);
4625       Candidate : Entity_Id        := Empty;
4626       P_Name    : Entity_Id;
4627       O_Name    : Entity_Id;
4628       Id        : Entity_Id;
4629
4630    begin
4631       P_Name := Entity (Prefix (N));
4632       O_Name := P_Name;
4633
4634       --  If the prefix is a renamed package, look for the entity in the
4635       --  original package.
4636
4637       if Ekind (P_Name) = E_Package
4638         and then Present (Renamed_Object (P_Name))
4639       then
4640          P_Name := Renamed_Object (P_Name);
4641
4642          --  Rewrite node with entity field pointing to renamed object
4643
4644          Rewrite (Prefix (N), New_Copy (Prefix (N)));
4645          Set_Entity (Prefix (N), P_Name);
4646
4647       --  If the prefix is an object of a concurrent type, look for
4648       --  the entity in the associated task or protected type.
4649
4650       elsif Is_Concurrent_Type (Etype (P_Name)) then
4651          P_Name := Etype (P_Name);
4652       end if;
4653
4654       Id := Current_Entity (Selector);
4655
4656       declare
4657          Is_New_Candidate : Boolean;
4658
4659       begin
4660          while Present (Id) loop
4661             if Scope (Id) = P_Name then
4662                Candidate        := Id;
4663                Is_New_Candidate := True;
4664
4665             --  Ada 2005 (AI-217): Handle shadow entities associated with types
4666             --  declared in limited-withed nested packages. We don't need to
4667             --  handle E_Incomplete_Subtype entities because the entities in
4668             --  the limited view are always E_Incomplete_Type entities (see
4669             --  Build_Limited_Views). Regarding the expression used to evaluate
4670             --  the scope, it is important to note that the limited view also
4671             --  has shadow entities associated nested packages. For this reason
4672             --  the correct scope of the entity is the scope of the real entity
4673             --  The non-limited view may itself be incomplete, in which case
4674             --  get the full view if available.
4675
4676             elsif From_With_Type (Id)
4677               and then Is_Type (Id)
4678               and then Ekind (Id) = E_Incomplete_Type
4679               and then Present (Non_Limited_View (Id))
4680               and then Scope (Non_Limited_View (Id)) = P_Name
4681             then
4682                Candidate        := Get_Full_View (Non_Limited_View (Id));
4683                Is_New_Candidate := True;
4684
4685             else
4686                Is_New_Candidate := False;
4687             end if;
4688
4689             if Is_New_Candidate then
4690                if Is_Child_Unit (Id) then
4691                   exit when Is_Visible_Child_Unit (Id)
4692                     or else Is_Immediately_Visible (Id);
4693
4694                else
4695                   exit when not Is_Hidden (Id)
4696                     or else Is_Immediately_Visible (Id);
4697                end if;
4698             end if;
4699
4700             Id := Homonym (Id);
4701          end loop;
4702       end;
4703
4704       if No (Id)
4705         and then (Ekind (P_Name) = E_Procedure
4706                     or else
4707                   Ekind (P_Name) = E_Function)
4708         and then Is_Generic_Instance (P_Name)
4709       then
4710          --  Expanded name denotes entity in (instance of) generic subprogram.
4711          --  The entity may be in the subprogram instance, or may denote one of
4712          --  the formals, which is declared in the enclosing wrapper package.
4713
4714          P_Name := Scope (P_Name);
4715
4716          Id := Current_Entity (Selector);
4717          while Present (Id) loop
4718             exit when Scope (Id) = P_Name;
4719             Id := Homonym (Id);
4720          end loop;
4721       end if;
4722
4723       if No (Id) or else Chars (Id) /= Chars (Selector) then
4724          Set_Etype (N, Any_Type);
4725
4726          --  If we are looking for an entity defined in System, try to find it
4727          --  in the child package that may have been provided as an extension
4728          --  to System. The Extend_System pragma will have supplied the name of
4729          --  the extension, which may have to be loaded.
4730
4731          if Chars (P_Name) = Name_System
4732            and then Scope (P_Name) = Standard_Standard
4733            and then Present (System_Extend_Unit)
4734            and then Present_System_Aux (N)
4735          then
4736             Set_Entity (Prefix (N), System_Aux_Id);
4737             Find_Expanded_Name (N);
4738             return;
4739
4740          elsif Nkind (Selector) = N_Operator_Symbol
4741            and then Has_Implicit_Operator (N)
4742          then
4743             --  There is an implicit instance of the predefined operator in
4744             --  the given scope. The operator entity is defined in Standard.
4745             --  Has_Implicit_Operator makes the node into an Expanded_Name.
4746
4747             return;
4748
4749          elsif Nkind (Selector) = N_Character_Literal
4750            and then Has_Implicit_Character_Literal (N)
4751          then
4752             --  If there is no literal defined in the scope denoted by the
4753             --  prefix, the literal may belong to (a type derived from)
4754             --  Standard_Character, for which we have no explicit literals.
4755
4756             return;
4757
4758          else
4759             --  If the prefix is a single concurrent object, use its name in
4760             --  the error message, rather than that of the anonymous type.
4761
4762             if Is_Concurrent_Type (P_Name)
4763               and then Is_Internal_Name (Chars (P_Name))
4764             then
4765                Error_Msg_Node_2 := Entity (Prefix (N));
4766             else
4767                Error_Msg_Node_2 := P_Name;
4768             end if;
4769
4770             if P_Name = System_Aux_Id then
4771                P_Name := Scope (P_Name);
4772                Set_Entity (Prefix (N), P_Name);
4773             end if;
4774
4775             if Present (Candidate) then
4776
4777                --  If we know that the unit is a child unit we can give a more
4778                --  accurate error message.
4779
4780                if Is_Child_Unit (Candidate) then
4781
4782                   --  If the candidate is a private child unit and we are in
4783                   --  the visible part of a public unit, specialize the error
4784                   --  message. There might be a private with_clause for it,
4785                   --  but it is not currently active.
4786
4787                   if Is_Private_Descendant (Candidate)
4788                     and then Ekind (Current_Scope) = E_Package
4789                     and then not In_Private_Part (Current_Scope)
4790                     and then not Is_Private_Descendant (Current_Scope)
4791                   then
4792                      Error_Msg_N ("private child unit& is not visible here",
4793                                   Selector);
4794
4795                   --  Normal case where we have a missing with for a child unit
4796
4797                   else
4798                      Error_Msg_Qual_Level := 99;
4799                      Error_Msg_NE -- CODEFIX
4800                        ("missing `WITH &;`", Selector, Candidate);
4801                      Error_Msg_Qual_Level := 0;
4802                   end if;
4803
4804                   --  Here we don't know that this is a child unit
4805
4806                else
4807                   Error_Msg_NE ("& is not a visible entity of&", N, Selector);
4808                end if;
4809
4810             else
4811                --  Within the instantiation of a child unit, the prefix may
4812                --  denote the parent instance, but the selector has the name
4813                --  of the original child. Find whether we are within the
4814                --  corresponding instance, and get the proper entity, which
4815                --  can only be an enclosing scope.
4816
4817                if O_Name /= P_Name
4818                  and then In_Open_Scopes (P_Name)
4819                  and then Is_Generic_Instance (P_Name)
4820                then
4821                   declare
4822                      S : Entity_Id := Current_Scope;
4823                      P : Entity_Id;
4824
4825                   begin
4826                      for J in reverse 0 .. Scope_Stack.Last loop
4827                         S := Scope_Stack.Table (J).Entity;
4828
4829                         exit when S = Standard_Standard;
4830
4831                         if Ekind_In (S, E_Function,
4832                                         E_Package,
4833                                         E_Procedure)
4834                         then
4835                            P := Generic_Parent (Specification
4836                                   (Unit_Declaration_Node (S)));
4837
4838                            if Present (P)
4839                              and then Chars (Scope (P)) = Chars (O_Name)
4840                              and then Chars (P) = Chars (Selector)
4841                            then
4842                               Id := S;
4843                               goto Found;
4844                            end if;
4845                         end if;
4846
4847                      end loop;
4848                   end;
4849                end if;
4850
4851                --  If this is a selection from Ada, System or Interfaces, then
4852                --  we assume a missing with for the corresponding package.
4853
4854                if Is_Known_Unit (N) then
4855                   if not Error_Posted (N) then
4856                      Error_Msg_Node_2 := Selector;
4857                      Error_Msg_N -- CODEFIX
4858                        ("missing `WITH &.&;`", Prefix (N));
4859                   end if;
4860
4861                --  If this is a selection from a dummy package, then suppress
4862                --  the error message, of course the entity is missing if the
4863                --  package is missing!
4864
4865                elsif Sloc (Error_Msg_Node_2) = No_Location then
4866                   null;
4867
4868                --  Here we have the case of an undefined component
4869
4870                else
4871
4872                   --  The prefix may hide a homonym in the context that
4873                   --  declares the desired entity. This error can use a
4874                   --  specialized message.
4875
4876                   if In_Open_Scopes (P_Name)
4877                     and then Present (Homonym (P_Name))
4878                     and then Is_Compilation_Unit (Homonym (P_Name))
4879                     and then
4880                      (Is_Immediately_Visible (Homonym (P_Name))
4881                         or else Is_Visible_Child_Unit (Homonym (P_Name)))
4882                   then
4883                      declare
4884                         H : constant Entity_Id := Homonym (P_Name);
4885
4886                      begin
4887                         Id := First_Entity (H);
4888                         while Present (Id) loop
4889                            if Chars (Id) = Chars (Selector) then
4890                               Error_Msg_Qual_Level := 99;
4891                               Error_Msg_Name_1 := Chars (Selector);
4892                               Error_Msg_NE
4893                                 ("% not declared in&", N, P_Name);
4894                               Error_Msg_NE
4895                                 ("\use fully qualified name starting with"
4896                                   & " Standard to make& visible", N, H);
4897                               Error_Msg_Qual_Level := 0;
4898                               goto Done;
4899                            end if;
4900
4901                            Next_Entity (Id);
4902                         end loop;
4903
4904                         --  If not found,  standard error message.
4905
4906                         Error_Msg_NE ("& not declared in&", N, Selector);
4907
4908                         <<Done>> null;
4909                      end;
4910
4911                   else
4912                      Error_Msg_NE ("& not declared in&", N, Selector);
4913                   end if;
4914
4915                   --  Check for misspelling of some entity in prefix
4916
4917                   Id := First_Entity (P_Name);
4918                   while Present (Id) loop
4919                      if Is_Bad_Spelling_Of (Chars (Id), Chars (Selector))
4920                        and then not Is_Internal_Name (Chars (Id))
4921                      then
4922                         Error_Msg_NE -- CODEFIX
4923                           ("possible misspelling of&", Selector, Id);
4924                         exit;
4925                      end if;
4926
4927                      Next_Entity (Id);
4928                   end loop;
4929
4930                   --  Specialize the message if this may be an instantiation
4931                   --  of a child unit that was not mentioned in the context.
4932
4933                   if Nkind (Parent (N)) = N_Package_Instantiation
4934                     and then Is_Generic_Instance (Entity (Prefix (N)))
4935                     and then Is_Compilation_Unit
4936                                (Generic_Parent (Parent (Entity (Prefix (N)))))
4937                   then
4938                      Error_Msg_Node_2 := Selector;
4939                      Error_Msg_N -- CODEFIX
4940                        ("\missing `WITH &.&;`", Prefix (N));
4941                   end if;
4942                end if;
4943             end if;
4944
4945             Id := Any_Id;
4946          end if;
4947       end if;
4948
4949       <<Found>>
4950       if Comes_From_Source (N)
4951         and then Is_Remote_Access_To_Subprogram_Type (Id)
4952         and then Present (Equivalent_Type (Id))
4953       then
4954          --  If we are not actually generating distribution code (i.e. the
4955          --  current PCS is the dummy non-distributed version), then the
4956          --  Equivalent_Type will be missing, and Id should be treated as
4957          --  a regular access-to-subprogram type.
4958
4959          Id := Equivalent_Type (Id);
4960          Set_Chars (Selector, Chars (Id));
4961       end if;
4962
4963       --  Ada 2005 (AI-50217): Check usage of entities in limited withed units
4964
4965       if Ekind (P_Name) = E_Package
4966         and then From_With_Type (P_Name)
4967       then
4968          if From_With_Type (Id)
4969            or else Is_Type (Id)
4970            or else Ekind (Id) = E_Package
4971          then
4972             null;
4973          else
4974             Error_Msg_N
4975               ("limited withed package can only be used to access "
4976                & "incomplete types",
4977                 N);
4978          end if;
4979       end if;
4980
4981       if Is_Task_Type (P_Name)
4982         and then ((Ekind (Id) = E_Entry
4983                      and then Nkind (Parent (N)) /= N_Attribute_Reference)
4984                    or else
4985                     (Ekind (Id) = E_Entry_Family
4986                       and then
4987                         Nkind (Parent (Parent (N))) /= N_Attribute_Reference))
4988       then
4989          --  It is an entry call after all, either to the current task (which
4990          --  will deadlock) or to an enclosing task.
4991
4992          Analyze_Selected_Component (N);
4993          return;
4994       end if;
4995
4996       Change_Selected_Component_To_Expanded_Name (N);
4997
4998       --  Do style check and generate reference, but skip both steps if this
4999       --  entity has homonyms, since we may not have the right homonym set yet.
5000       --  The proper homonym will be set during the resolve phase.
5001
5002       if Has_Homonym (Id) then
5003          Set_Entity (N, Id);
5004       else
5005          Set_Entity_Or_Discriminal (N, Id);
5006
5007          if Is_LHS (N) then
5008             Generate_Reference (Id, N, 'm');
5009          else
5010             Generate_Reference (Id, N);
5011          end if;
5012       end if;
5013
5014       if Is_Type (Id) then
5015          Set_Etype (N, Id);
5016       else
5017          Set_Etype (N, Get_Full_View (Etype (Id)));
5018       end if;
5019
5020       --  Check for violation of No_Wide_Characters
5021
5022       Check_Wide_Character_Restriction (Id, N);
5023
5024       --  If the Ekind of the entity is Void, it means that all homonyms are
5025       --  hidden from all visibility (RM 8.3(5,14-20)).
5026
5027       if Ekind (Id) = E_Void then
5028          Premature_Usage (N);
5029
5030       elsif Is_Overloadable (Id)
5031         and then Present (Homonym (Id))
5032       then
5033          declare
5034             H : Entity_Id := Homonym (Id);
5035
5036          begin
5037             while Present (H) loop
5038                if Scope (H) = Scope (Id)
5039                  and then
5040                    (not Is_Hidden (H)
5041                       or else Is_Immediately_Visible (H))
5042                then
5043                   Collect_Interps (N);
5044                   exit;
5045                end if;
5046
5047                H := Homonym (H);
5048             end loop;
5049
5050             --  If an extension of System is present, collect possible explicit
5051             --  overloadings declared in the extension.
5052
5053             if Chars (P_Name) = Name_System
5054               and then Scope (P_Name) = Standard_Standard
5055               and then Present (System_Extend_Unit)
5056               and then Present_System_Aux (N)
5057             then
5058                H := Current_Entity (Id);
5059
5060                while Present (H) loop
5061                   if Scope (H) = System_Aux_Id then
5062                      Add_One_Interp (N, H, Etype (H));
5063                   end if;
5064
5065                   H := Homonym (H);
5066                end loop;
5067             end if;
5068          end;
5069       end if;
5070
5071       if Nkind (Selector_Name (N)) = N_Operator_Symbol
5072         and then Scope (Id) /= Standard_Standard
5073       then
5074          --  In addition to user-defined operators in the given scope, there
5075          --  may be an implicit instance of the predefined operator. The
5076          --  operator (defined in Standard) is found in Has_Implicit_Operator,
5077          --  and added to the interpretations. Procedure Add_One_Interp will
5078          --  determine which hides which.
5079
5080          if Has_Implicit_Operator (N) then
5081             null;
5082          end if;
5083       end if;
5084    end Find_Expanded_Name;
5085
5086    -------------------------
5087    -- Find_Renamed_Entity --
5088    -------------------------
5089
5090    function Find_Renamed_Entity
5091      (N         : Node_Id;
5092       Nam       : Node_Id;
5093       New_S     : Entity_Id;
5094       Is_Actual : Boolean := False) return Entity_Id
5095    is
5096       Ind   : Interp_Index;
5097       I1    : Interp_Index := 0; -- Suppress junk warnings
5098       It    : Interp;
5099       It1   : Interp;
5100       Old_S : Entity_Id;
5101       Inst  : Entity_Id;
5102
5103       function Enclosing_Instance return Entity_Id;
5104       --  If the renaming determines the entity for the default of a formal
5105       --  subprogram nested within another instance, choose the innermost
5106       --  candidate. This is because if the formal has a box, and we are within
5107       --  an enclosing instance where some candidate interpretations are local
5108       --  to this enclosing instance, we know that the default was properly
5109       --  resolved when analyzing the generic, so we prefer the local
5110       --  candidates to those that are external. This is not always the case
5111       --  but is a reasonable heuristic on the use of nested generics. The
5112       --  proper solution requires a full renaming model.
5113
5114       function Is_Visible_Operation (Op : Entity_Id) return Boolean;
5115       --  If the renamed entity is an implicit operator, check whether it is
5116       --  visible because its operand type is properly visible. This check
5117       --  applies to explicit renamed entities that appear in the source in a
5118       --  renaming declaration or a formal subprogram instance, but not to
5119       --  default generic actuals with a name.
5120
5121       function Report_Overload return Entity_Id;
5122       --  List possible interpretations, and specialize message in the
5123       --  case of a generic actual.
5124
5125       function Within (Inner, Outer : Entity_Id) return Boolean;
5126       --  Determine whether a candidate subprogram is defined within the
5127       --  enclosing instance. If yes, it has precedence over outer candidates.
5128
5129       ------------------------
5130       -- Enclosing_Instance --
5131       ------------------------
5132
5133       function Enclosing_Instance return Entity_Id is
5134          S : Entity_Id;
5135
5136       begin
5137          if not Is_Generic_Instance (Current_Scope)
5138            and then not Is_Actual
5139          then
5140             return Empty;
5141          end if;
5142
5143          S := Scope (Current_Scope);
5144          while S /= Standard_Standard loop
5145             if Is_Generic_Instance (S) then
5146                return S;
5147             end if;
5148
5149             S := Scope (S);
5150          end loop;
5151
5152          return Empty;
5153       end Enclosing_Instance;
5154
5155       --------------------------
5156       -- Is_Visible_Operation --
5157       --------------------------
5158
5159       function Is_Visible_Operation (Op : Entity_Id) return Boolean is
5160          Scop : Entity_Id;
5161          Typ  : Entity_Id;
5162          Btyp : Entity_Id;
5163
5164       begin
5165          if Ekind (Op) /= E_Operator
5166            or else Scope (Op) /= Standard_Standard
5167            or else (In_Instance
5168                       and then
5169                         (not Is_Actual
5170                            or else Present (Enclosing_Instance)))
5171          then
5172             return True;
5173
5174          else
5175             --  For a fixed point type operator, check the resulting type,
5176             --  because it may be a mixed mode integer * fixed operation.
5177
5178             if Present (Next_Formal (First_Formal (New_S)))
5179               and then Is_Fixed_Point_Type (Etype (New_S))
5180             then
5181                Typ := Etype (New_S);
5182             else
5183                Typ := Etype (First_Formal (New_S));
5184             end if;
5185
5186             Btyp := Base_Type (Typ);
5187
5188             if Nkind (Nam) /= N_Expanded_Name then
5189                return (In_Open_Scopes (Scope (Btyp))
5190                         or else Is_Potentially_Use_Visible (Btyp)
5191                         or else In_Use (Btyp)
5192                         or else In_Use (Scope (Btyp)));
5193
5194             else
5195                Scop := Entity (Prefix (Nam));
5196
5197                if Ekind (Scop) = E_Package
5198                  and then Present (Renamed_Object (Scop))
5199                then
5200                   Scop := Renamed_Object (Scop);
5201                end if;
5202
5203                --  Operator is visible if prefix of expanded name denotes
5204                --  scope of type, or else type is defined in System_Aux
5205                --  and the prefix denotes System.
5206
5207                return Scope (Btyp) = Scop
5208                  or else (Scope (Btyp) = System_Aux_Id
5209                            and then Scope (Scope (Btyp)) = Scop);
5210             end if;
5211          end if;
5212       end Is_Visible_Operation;
5213
5214       ------------
5215       -- Within --
5216       ------------
5217
5218       function Within (Inner, Outer : Entity_Id) return Boolean is
5219          Sc : Entity_Id;
5220
5221       begin
5222          Sc := Scope (Inner);
5223          while Sc /= Standard_Standard loop
5224             if Sc = Outer then
5225                return True;
5226             else
5227                Sc := Scope (Sc);
5228             end if;
5229          end loop;
5230
5231          return False;
5232       end Within;
5233
5234       ---------------------
5235       -- Report_Overload --
5236       ---------------------
5237
5238       function Report_Overload return Entity_Id is
5239       begin
5240          if Is_Actual then
5241             Error_Msg_NE -- CODEFIX
5242               ("ambiguous actual subprogram&, " &
5243                  "possible interpretations:", N, Nam);
5244          else
5245             Error_Msg_N -- CODEFIX
5246               ("ambiguous subprogram, " &
5247                  "possible interpretations:", N);
5248          end if;
5249
5250          List_Interps (Nam, N);
5251          return Old_S;
5252       end Report_Overload;
5253
5254    --  Start of processing for Find_Renamed_Entry
5255
5256    begin
5257       Old_S := Any_Id;
5258       Candidate_Renaming := Empty;
5259
5260       if not Is_Overloaded (Nam) then
5261          if Entity_Matches_Spec (Entity (Nam), New_S) then
5262             Candidate_Renaming := New_S;
5263
5264             if Is_Visible_Operation (Entity (Nam)) then
5265                Old_S := Entity (Nam);
5266             end if;
5267
5268          elsif
5269            Present (First_Formal (Entity (Nam)))
5270              and then Present (First_Formal (New_S))
5271              and then (Base_Type (Etype (First_Formal (Entity (Nam))))
5272                         = Base_Type (Etype (First_Formal (New_S))))
5273          then
5274             Candidate_Renaming := Entity (Nam);
5275          end if;
5276
5277       else
5278          Get_First_Interp (Nam, Ind, It);
5279          while Present (It.Nam) loop
5280             if Entity_Matches_Spec (It.Nam, New_S)
5281                and then Is_Visible_Operation (It.Nam)
5282             then
5283                if Old_S /= Any_Id then
5284
5285                   --  Note: The call to Disambiguate only happens if a
5286                   --  previous interpretation was found, in which case I1
5287                   --  has received a value.
5288
5289                   It1 := Disambiguate (Nam, I1, Ind, Etype (Old_S));
5290
5291                   if It1 = No_Interp then
5292                      Inst := Enclosing_Instance;
5293
5294                      if Present (Inst) then
5295                         if Within (It.Nam, Inst) then
5296                            return (It.Nam);
5297                         elsif Within (Old_S, Inst) then
5298                            return (Old_S);
5299                         else
5300                            return Report_Overload;
5301                         end if;
5302
5303                      else
5304                         return Report_Overload;
5305                      end if;
5306
5307                   else
5308                      Old_S := It1.Nam;
5309                      exit;
5310                   end if;
5311
5312                else
5313                   I1 := Ind;
5314                   Old_S := It.Nam;
5315                end if;
5316
5317             elsif
5318               Present (First_Formal (It.Nam))
5319                 and then Present (First_Formal (New_S))
5320                 and then  (Base_Type (Etype (First_Formal (It.Nam)))
5321                             = Base_Type (Etype (First_Formal (New_S))))
5322             then
5323                Candidate_Renaming := It.Nam;
5324             end if;
5325
5326             Get_Next_Interp (Ind, It);
5327          end loop;
5328
5329          Set_Entity (Nam, Old_S);
5330          Set_Is_Overloaded (Nam, False);
5331       end if;
5332
5333       return Old_S;
5334    end Find_Renamed_Entity;
5335
5336    -----------------------------
5337    -- Find_Selected_Component --
5338    -----------------------------
5339
5340    procedure Find_Selected_Component (N : Node_Id) is
5341       P : constant Node_Id := Prefix (N);
5342
5343       P_Name : Entity_Id;
5344       --  Entity denoted by prefix
5345
5346       P_Type : Entity_Id;
5347       --  and its type
5348
5349       Nam : Node_Id;
5350
5351    begin
5352       Analyze (P);
5353
5354       if Nkind (P) = N_Error then
5355          return;
5356
5357       --  If the selector already has an entity, the node has been constructed
5358       --  in the course of expansion, and is known to be valid. Do not verify
5359       --  that it is defined for the type (it may be a private component used
5360       --  in the expansion of record equality).
5361
5362       elsif Present (Entity (Selector_Name (N))) then
5363          if No (Etype (N))
5364            or else Etype (N) = Any_Type
5365          then
5366             declare
5367                Sel_Name : constant Node_Id   := Selector_Name (N);
5368                Selector : constant Entity_Id := Entity (Sel_Name);
5369                C_Etype  : Node_Id;
5370
5371             begin
5372                Set_Etype (Sel_Name, Etype (Selector));
5373
5374                if not Is_Entity_Name (P) then
5375                   Resolve (P);
5376                end if;
5377
5378                --  Build an actual subtype except for the first parameter
5379                --  of an init proc, where this actual subtype is by
5380                --  definition incorrect, since the object is uninitialized
5381                --  (and does not even have defined discriminants etc.)
5382
5383                if Is_Entity_Name (P)
5384                  and then Ekind (Entity (P)) = E_Function
5385                then
5386                   Nam := New_Copy (P);
5387
5388                   if Is_Overloaded (P) then
5389                      Save_Interps (P, Nam);
5390                   end if;
5391
5392                   Rewrite (P,
5393                     Make_Function_Call (Sloc (P), Name => Nam));
5394                   Analyze_Call (P);
5395                   Analyze_Selected_Component (N);
5396                   return;
5397
5398                elsif Ekind (Selector) = E_Component
5399                  and then (not Is_Entity_Name (P)
5400                             or else Chars (Entity (P)) /= Name_uInit)
5401                then
5402                   --  Do not build the subtype when referencing components of
5403                   --  dispatch table wrappers. Required to avoid generating
5404                   --  elaboration code with HI runtimes.
5405
5406                   if RTU_Loaded (Ada_Tags)
5407                     and then RTE_Available (RE_Dispatch_Table_Wrapper)
5408                     and then Scope (Selector) = RTE (RE_Dispatch_Table_Wrapper)
5409                   then
5410                      C_Etype := Empty;
5411
5412                   elsif RTU_Loaded (Ada_Tags)
5413                     and then RTE_Available (RE_No_Dispatch_Table_Wrapper)
5414                     and then Scope (Selector)
5415                                = RTE (RE_No_Dispatch_Table_Wrapper)
5416                   then
5417                      C_Etype := Empty;
5418
5419                   else
5420                      C_Etype :=
5421                        Build_Actual_Subtype_Of_Component (
5422                          Etype (Selector), N);
5423                   end if;
5424
5425                else
5426                   C_Etype := Empty;
5427                end if;
5428
5429                if No (C_Etype) then
5430                   C_Etype := Etype (Selector);
5431                else
5432                   Insert_Action (N, C_Etype);
5433                   C_Etype := Defining_Identifier (C_Etype);
5434                end if;
5435
5436                Set_Etype (N, C_Etype);
5437             end;
5438
5439             --  If this is the name of an entry or protected operation, and
5440             --  the prefix is an access type, insert an explicit dereference,
5441             --  so that entry calls are treated uniformly.
5442
5443             if Is_Access_Type (Etype (P))
5444               and then Is_Concurrent_Type (Designated_Type (Etype (P)))
5445             then
5446                declare
5447                   New_P : constant Node_Id :=
5448                             Make_Explicit_Dereference (Sloc (P),
5449                               Prefix => Relocate_Node (P));
5450                begin
5451                   Rewrite (P, New_P);
5452                   Set_Etype (P, Designated_Type (Etype (Prefix (P))));
5453                end;
5454             end if;
5455
5456          --  If the selected component appears within a default expression
5457          --  and it has an actual subtype, the pre-analysis has not yet
5458          --  completed its analysis, because Insert_Actions is disabled in
5459          --  that context. Within the init proc of the enclosing type we
5460          --  must complete this analysis, if an actual subtype was created.
5461
5462          elsif Inside_Init_Proc then
5463             declare
5464                Typ  : constant Entity_Id := Etype (N);
5465                Decl : constant Node_Id   := Declaration_Node (Typ);
5466             begin
5467                if Nkind (Decl) = N_Subtype_Declaration
5468                  and then not Analyzed (Decl)
5469                  and then Is_List_Member (Decl)
5470                  and then No (Parent (Decl))
5471                then
5472                   Remove (Decl);
5473                   Insert_Action (N, Decl);
5474                end if;
5475             end;
5476          end if;
5477
5478          return;
5479
5480       elsif Is_Entity_Name (P) then
5481          P_Name := Entity (P);
5482
5483          --  Selector name is restricted in SPARK
5484
5485          if SPARK_Mode then
5486             if Is_Subprogram (P_Name) then
5487                Error_Msg_F
5488                  ("|~~prefix of expanded name cannot be a subprogram", P);
5489             elsif Ekind (P_Name) = E_Loop then
5490                Error_Msg_F
5491                  ("|~~prefix of expanded name cannot be a loop statement", P);
5492             end if;
5493          end if;
5494
5495          --  The prefix may denote an enclosing type which is the completion
5496          --  of an incomplete type declaration.
5497
5498          if Is_Type (P_Name) then
5499             Set_Entity (P, Get_Full_View (P_Name));
5500             Set_Etype  (P, Entity (P));
5501             P_Name := Entity (P);
5502          end if;
5503
5504          P_Type := Base_Type (Etype (P));
5505
5506          if Debug_Flag_E then
5507             Write_Str ("Found prefix type to be ");
5508             Write_Entity_Info (P_Type, "      "); Write_Eol;
5509          end if;
5510
5511          --  First check for components of a record object (not the
5512          --  result of a call, which is handled below).
5513
5514          if Is_Appropriate_For_Record (P_Type)
5515            and then not Is_Overloadable (P_Name)
5516            and then not Is_Type (P_Name)
5517          then
5518             --  Selected component of record. Type checking will validate
5519             --  name of selector.
5520             --  ??? could we rewrite an implicit dereference into an explicit
5521             --  one here?
5522
5523             Analyze_Selected_Component (N);
5524
5525          --  Reference to type name in predicate/invariant expression
5526
5527          elsif Is_Appropriate_For_Entry_Prefix (P_Type)
5528            and then not In_Open_Scopes (P_Name)
5529            and then (not Is_Concurrent_Type (Etype (P_Name))
5530                        or else not In_Open_Scopes (Etype (P_Name)))
5531          then
5532             --  Call to protected operation or entry. Type checking is
5533             --  needed on the prefix.
5534
5535             Analyze_Selected_Component (N);
5536
5537          elsif (In_Open_Scopes (P_Name)
5538                  and then Ekind (P_Name) /= E_Void
5539                  and then not Is_Overloadable (P_Name))
5540            or else (Is_Concurrent_Type (Etype (P_Name))
5541                      and then In_Open_Scopes (Etype (P_Name)))
5542          then
5543             --  Prefix denotes an enclosing loop, block, or task, i.e. an
5544             --  enclosing construct that is not a subprogram or accept.
5545
5546             Find_Expanded_Name (N);
5547
5548          elsif Ekind (P_Name) = E_Package then
5549             Find_Expanded_Name (N);
5550
5551          elsif Is_Overloadable (P_Name) then
5552
5553             --  The subprogram may be a renaming (of an enclosing scope) as
5554             --  in the case of the name of the generic within an instantiation.
5555
5556             if Ekind_In (P_Name, E_Procedure, E_Function)
5557               and then Present (Alias (P_Name))
5558               and then Is_Generic_Instance (Alias (P_Name))
5559             then
5560                P_Name := Alias (P_Name);
5561             end if;
5562
5563             if Is_Overloaded (P) then
5564
5565                --  The prefix must resolve to a unique enclosing construct
5566
5567                declare
5568                   Found : Boolean := False;
5569                   Ind   : Interp_Index;
5570                   It    : Interp;
5571
5572                begin
5573                   Get_First_Interp (P, Ind, It);
5574                   while Present (It.Nam) loop
5575                      if In_Open_Scopes (It.Nam) then
5576                         if Found then
5577                            Error_Msg_N (
5578                               "prefix must be unique enclosing scope", N);
5579                            Set_Entity (N, Any_Id);
5580                            Set_Etype  (N, Any_Type);
5581                            return;
5582
5583                         else
5584                            Found := True;
5585                            P_Name := It.Nam;
5586                         end if;
5587                      end if;
5588
5589                      Get_Next_Interp (Ind, It);
5590                   end loop;
5591                end;
5592             end if;
5593
5594             if In_Open_Scopes (P_Name) then
5595                Set_Entity (P, P_Name);
5596                Set_Is_Overloaded (P, False);
5597                Find_Expanded_Name (N);
5598
5599             else
5600                --  If no interpretation as an expanded name is possible, it
5601                --  must be a selected component of a record returned by a
5602                --  function call. Reformat prefix as a function call, the rest
5603                --  is done by type resolution. If the prefix is procedure or
5604                --  entry, as is P.X; this is an error.
5605
5606                if Ekind (P_Name) /= E_Function
5607                  and then (not Is_Overloaded (P)
5608                              or else
5609                            Nkind (Parent (N)) = N_Procedure_Call_Statement)
5610                then
5611                   --  Prefix may mention a package that is hidden by a local
5612                   --  declaration: let the user know. Scan the full homonym
5613                   --  chain, the candidate package may be anywhere on it.
5614
5615                   if Present (Homonym (Current_Entity (P_Name))) then
5616
5617                      P_Name := Current_Entity (P_Name);
5618
5619                      while Present (P_Name) loop
5620                         exit when Ekind (P_Name) = E_Package;
5621                         P_Name := Homonym (P_Name);
5622                      end loop;
5623
5624                      if Present (P_Name) then
5625                         Error_Msg_Sloc := Sloc (Entity (Prefix (N)));
5626
5627                         Error_Msg_NE
5628                           ("package& is hidden by declaration#",
5629                             N, P_Name);
5630
5631                         Set_Entity (Prefix (N), P_Name);
5632                         Find_Expanded_Name (N);
5633                         return;
5634                      else
5635                         P_Name := Entity (Prefix (N));
5636                      end if;
5637                   end if;
5638
5639                   Error_Msg_NE
5640                     ("invalid prefix in selected component&", N, P_Name);
5641                   Change_Selected_Component_To_Expanded_Name (N);
5642                   Set_Entity (N, Any_Id);
5643                   Set_Etype (N, Any_Type);
5644
5645                else
5646                   Nam := New_Copy (P);
5647                   Save_Interps (P, Nam);
5648                   Rewrite (P,
5649                     Make_Function_Call (Sloc (P), Name => Nam));
5650                   Analyze_Call (P);
5651                   Analyze_Selected_Component (N);
5652                end if;
5653             end if;
5654
5655          --  Remaining cases generate various error messages
5656
5657          else
5658             --  Format node as expanded name, to avoid cascaded errors
5659
5660             Change_Selected_Component_To_Expanded_Name (N);
5661             Set_Entity  (N, Any_Id);
5662             Set_Etype   (N, Any_Type);
5663
5664             --  Issue error message, but avoid this if error issued already.
5665             --  Use identifier of prefix if one is available.
5666
5667             if P_Name = Any_Id  then
5668                null;
5669
5670             elsif Ekind (P_Name) = E_Void then
5671                Premature_Usage (P);
5672
5673             elsif Nkind (P) /= N_Attribute_Reference then
5674                Error_Msg_N (
5675                 "invalid prefix in selected component&", P);
5676
5677                if Is_Access_Type (P_Type)
5678                  and then Ekind (Designated_Type (P_Type)) = E_Incomplete_Type
5679                then
5680                   Error_Msg_N
5681                     ("\dereference must not be of an incomplete type " &
5682                        "(RM 3.10.1)", P);
5683                end if;
5684
5685             else
5686                Error_Msg_N (
5687                 "invalid prefix in selected component", P);
5688             end if;
5689          end if;
5690
5691       else
5692          --  If prefix is not the name of an entity, it must be an expression,
5693          --  whose type is appropriate for a record. This is determined by
5694          --  type resolution.
5695
5696          Analyze_Selected_Component (N);
5697       end if;
5698    end Find_Selected_Component;
5699
5700    ---------------
5701    -- Find_Type --
5702    ---------------
5703
5704    procedure Find_Type (N : Node_Id) is
5705       C      : Entity_Id;
5706       Typ    : Entity_Id;
5707       T      : Entity_Id;
5708       T_Name : Entity_Id;
5709
5710    begin
5711       if N = Error then
5712          return;
5713
5714       elsif Nkind (N) = N_Attribute_Reference then
5715
5716          --  Class attribute. This is not valid in Ada 83 mode, but we do not
5717          --  need to enforce that at this point, since the declaration of the
5718          --  tagged type in the prefix would have been flagged already.
5719
5720          if Attribute_Name (N) = Name_Class then
5721             Check_Restriction (No_Dispatch, N);
5722             Find_Type (Prefix (N));
5723
5724             --  Propagate error from bad prefix
5725
5726             if Etype (Prefix (N)) = Any_Type then
5727                Set_Entity (N, Any_Type);
5728                Set_Etype  (N, Any_Type);
5729                return;
5730             end if;
5731
5732             T := Base_Type (Entity (Prefix (N)));
5733
5734             --  Case where type is not known to be tagged. Its appearance in
5735             --  the prefix of the 'Class attribute indicates that the full view
5736             --  will be tagged.
5737
5738             if not Is_Tagged_Type (T) then
5739                if Ekind (T) = E_Incomplete_Type then
5740
5741                   --  It is legal to denote the class type of an incomplete
5742                   --  type. The full type will have to be tagged, of course.
5743                   --  In Ada 2005 this usage is declared obsolescent, so we
5744                   --  warn accordingly. This usage is only legal if the type
5745                   --  is completed in the current scope, and not for a limited
5746                   --  view of a type.
5747
5748                   if not Is_Tagged_Type (T)
5749                     and then Ada_Version >= Ada_2005
5750                   then
5751                      if From_With_Type (T) then
5752                         Error_Msg_N
5753                           ("prefix of Class attribute must be tagged", N);
5754                         Set_Etype (N, Any_Type);
5755                         Set_Entity (N, Any_Type);
5756                         return;
5757
5758                   --  ??? This test is temporarily disabled (always False)
5759                   --  because it causes an unwanted warning on GNAT sources
5760                   --  (built with -gnatg, which includes Warn_On_Obsolescent_
5761                   --  Feature). Once this issue is cleared in the sources, it
5762                   --  can be enabled.
5763
5764                      elsif Warn_On_Obsolescent_Feature
5765                        and then False
5766                      then
5767                         Error_Msg_N
5768                           ("applying 'Class to an untagged incomplete type"
5769                            & " is an obsolescent feature  (RM J.11)", N);
5770                      end if;
5771                   end if;
5772
5773                   Set_Is_Tagged_Type (T);
5774                   Set_Direct_Primitive_Operations (T, New_Elmt_List);
5775                   Make_Class_Wide_Type (T);
5776                   Set_Entity (N, Class_Wide_Type (T));
5777                   Set_Etype  (N, Class_Wide_Type (T));
5778
5779                elsif Ekind (T) = E_Private_Type
5780                  and then not Is_Generic_Type (T)
5781                  and then In_Private_Part (Scope (T))
5782                then
5783                   --  The Class attribute can be applied to an untagged private
5784                   --  type fulfilled by a tagged type prior to the full type
5785                   --  declaration (but only within the parent package's private
5786                   --  part). Create the class-wide type now and check that the
5787                   --  full type is tagged later during its analysis. Note that
5788                   --  we do not mark the private type as tagged, unlike the
5789                   --  case of incomplete types, because the type must still
5790                   --  appear untagged to outside units.
5791
5792                   if No (Class_Wide_Type (T)) then
5793                      Make_Class_Wide_Type (T);
5794                   end if;
5795
5796                   Set_Entity (N, Class_Wide_Type (T));
5797                   Set_Etype  (N, Class_Wide_Type (T));
5798
5799                else
5800                   --  Should we introduce a type Any_Tagged and use Wrong_Type
5801                   --  here, it would be a bit more consistent???
5802
5803                   Error_Msg_NE
5804                     ("tagged type required, found}",
5805                      Prefix (N), First_Subtype (T));
5806                   Set_Entity (N, Any_Type);
5807                   return;
5808                end if;
5809
5810             --  Case of tagged type
5811
5812             else
5813                if Is_Concurrent_Type (T) then
5814                   if No (Corresponding_Record_Type (Entity (Prefix (N)))) then
5815
5816                      --  Previous error. Use current type, which at least
5817                      --  provides some operations.
5818
5819                      C := Entity (Prefix (N));
5820
5821                   else
5822                      C := Class_Wide_Type
5823                             (Corresponding_Record_Type (Entity (Prefix (N))));
5824                   end if;
5825
5826                else
5827                   C := Class_Wide_Type (Entity (Prefix (N)));
5828                end if;
5829
5830                Set_Entity_With_Style_Check (N, C);
5831                Generate_Reference (C, N);
5832                Set_Etype (N, C);
5833             end if;
5834
5835          --  Base attribute, not allowed in Ada 83
5836
5837          elsif Attribute_Name (N) = Name_Base then
5838             if Ada_Version = Ada_83 and then Comes_From_Source (N) then
5839                Error_Msg_N
5840                  ("(Ada 83) Base attribute not allowed in subtype mark", N);
5841
5842             else
5843                Find_Type (Prefix (N));
5844                Typ := Entity (Prefix (N));
5845
5846                if Ada_Version >= Ada_95
5847                  and then not Is_Scalar_Type (Typ)
5848                  and then not Is_Generic_Type (Typ)
5849                then
5850                   Error_Msg_N
5851                     ("prefix of Base attribute must be scalar type",
5852                       Prefix (N));
5853
5854                elsif Warn_On_Redundant_Constructs
5855                  and then Base_Type (Typ) = Typ
5856                then
5857                   Error_Msg_NE -- CODEFIX
5858                     ("?redundant attribute, & is its own base type", N, Typ);
5859                end if;
5860
5861                T := Base_Type (Typ);
5862
5863                --  Rewrite attribute reference with type itself (see similar
5864                --  processing in Analyze_Attribute, case Base). Preserve prefix
5865                --  if present, for other legality checks.
5866
5867                if Nkind (Prefix (N)) = N_Expanded_Name then
5868                   Rewrite (N,
5869                      Make_Expanded_Name (Sloc (N),
5870                        Chars         => Chars (T),
5871                        Prefix        => New_Copy (Prefix (Prefix (N))),
5872                        Selector_Name => New_Reference_To (T, Sloc (N))));
5873
5874                else
5875                   Rewrite (N, New_Reference_To (T, Sloc (N)));
5876                end if;
5877
5878                Set_Entity (N, T);
5879                Set_Etype (N, T);
5880             end if;
5881
5882          elsif Attribute_Name (N) = Name_Stub_Type then
5883
5884             --  This is handled in Analyze_Attribute
5885
5886             Analyze (N);
5887
5888          --  All other attributes are invalid in a subtype mark
5889
5890          else
5891             Error_Msg_N ("invalid attribute in subtype mark", N);
5892          end if;
5893
5894       else
5895          Analyze (N);
5896
5897          if Is_Entity_Name (N) then
5898             T_Name := Entity (N);
5899          else
5900             Error_Msg_N ("subtype mark required in this context", N);
5901             Set_Etype (N, Any_Type);
5902             return;
5903          end if;
5904
5905          if T_Name  = Any_Id or else Etype (N) = Any_Type then
5906
5907             --  Undefined id. Make it into a valid type
5908
5909             Set_Entity (N, Any_Type);
5910
5911          elsif not Is_Type (T_Name)
5912            and then T_Name /= Standard_Void_Type
5913          then
5914             Error_Msg_Sloc := Sloc (T_Name);
5915             Error_Msg_N ("subtype mark required in this context", N);
5916             Error_Msg_NE ("\\found & declared#", N, T_Name);
5917             Set_Entity (N, Any_Type);
5918
5919          else
5920             --  If the type is an incomplete type created to handle
5921             --  anonymous access components of a record type, then the
5922             --  incomplete type is the visible entity and subsequent
5923             --  references will point to it. Mark the original full
5924             --  type as referenced, to prevent spurious warnings.
5925
5926             if Is_Incomplete_Type (T_Name)
5927               and then Present (Full_View (T_Name))
5928               and then not Comes_From_Source (T_Name)
5929             then
5930                Set_Referenced (Full_View (T_Name));
5931             end if;
5932
5933             T_Name := Get_Full_View (T_Name);
5934
5935             --  Ada 2005 (AI-251, AI-50217): Handle interfaces visible through
5936             --  limited-with clauses
5937
5938             if From_With_Type (T_Name)
5939               and then Ekind (T_Name) in Incomplete_Kind
5940               and then Present (Non_Limited_View (T_Name))
5941               and then Is_Interface (Non_Limited_View (T_Name))
5942             then
5943                T_Name := Non_Limited_View (T_Name);
5944             end if;
5945
5946             if In_Open_Scopes (T_Name) then
5947                if Ekind (Base_Type (T_Name)) = E_Task_Type then
5948
5949                   --  In Ada 2005, a task name can be used in an access
5950                   --  definition within its own body. It cannot be used
5951                   --  in the discriminant part of the task declaration,
5952                   --  nor anywhere else in the declaration because entries
5953                   --  cannot have access parameters.
5954
5955                   if Ada_Version >= Ada_2005
5956                     and then Nkind (Parent (N)) = N_Access_Definition
5957                   then
5958                      Set_Entity (N, T_Name);
5959                      Set_Etype  (N, T_Name);
5960
5961                      if Has_Completion (T_Name) then
5962                         return;
5963
5964                      else
5965                         Error_Msg_N
5966                           ("task type cannot be used as type mark " &
5967                            "within its own declaration", N);
5968                      end if;
5969
5970                   else
5971                      Error_Msg_N
5972                        ("task type cannot be used as type mark " &
5973                         "within its own spec or body", N);
5974                   end if;
5975
5976                elsif Ekind (Base_Type (T_Name)) = E_Protected_Type then
5977
5978                   --  In Ada 2005, a protected name can be used in an access
5979                   --  definition within its own body.
5980
5981                   if Ada_Version >= Ada_2005
5982                     and then Nkind (Parent (N)) = N_Access_Definition
5983                   then
5984                      Set_Entity (N, T_Name);
5985                      Set_Etype  (N, T_Name);
5986                      return;
5987
5988                   else
5989                      Error_Msg_N
5990                        ("protected type cannot be used as type mark " &
5991                         "within its own spec or body", N);
5992                   end if;
5993
5994                else
5995                   Error_Msg_N ("type declaration cannot refer to itself", N);
5996                end if;
5997
5998                Set_Etype (N, Any_Type);
5999                Set_Entity (N, Any_Type);
6000                Set_Error_Posted (T_Name);
6001                return;
6002             end if;
6003
6004             Set_Entity (N, T_Name);
6005             Set_Etype  (N, T_Name);
6006          end if;
6007       end if;
6008
6009       if Present (Etype (N)) and then Comes_From_Source (N) then
6010          if Is_Fixed_Point_Type (Etype (N)) then
6011             Check_Restriction (No_Fixed_Point, N);
6012          elsif Is_Floating_Point_Type (Etype (N)) then
6013             Check_Restriction (No_Floating_Point, N);
6014          end if;
6015       end if;
6016    end Find_Type;
6017
6018    ------------------------------------
6019    -- Has_Implicit_Character_Literal --
6020    ------------------------------------
6021
6022    function Has_Implicit_Character_Literal (N : Node_Id) return Boolean is
6023       Id      : Entity_Id;
6024       Found   : Boolean := False;
6025       P       : constant Entity_Id := Entity (Prefix (N));
6026       Priv_Id : Entity_Id := Empty;
6027
6028    begin
6029       if Ekind (P) = E_Package
6030         and then not In_Open_Scopes (P)
6031       then
6032          Priv_Id := First_Private_Entity (P);
6033       end if;
6034
6035       if P = Standard_Standard then
6036          Change_Selected_Component_To_Expanded_Name (N);
6037          Rewrite (N, Selector_Name (N));
6038          Analyze (N);
6039          Set_Etype (Original_Node (N), Standard_Character);
6040          return True;
6041       end if;
6042
6043       Id := First_Entity (P);
6044       while Present (Id)
6045         and then Id /= Priv_Id
6046       loop
6047          if Is_Standard_Character_Type (Id) and then Is_Base_Type (Id) then
6048
6049             --  We replace the node with the literal itself, resolve as a
6050             --  character, and set the type correctly.
6051
6052             if not Found then
6053                Change_Selected_Component_To_Expanded_Name (N);
6054                Rewrite (N, Selector_Name (N));
6055                Analyze (N);
6056                Set_Etype (N, Id);
6057                Set_Etype (Original_Node (N), Id);
6058                Found := True;
6059
6060             else
6061                --  More than one type derived from Character in given scope.
6062                --  Collect all possible interpretations.
6063
6064                Add_One_Interp (N, Id, Id);
6065             end if;
6066          end if;
6067
6068          Next_Entity (Id);
6069       end loop;
6070
6071       return Found;
6072    end Has_Implicit_Character_Literal;
6073
6074    ----------------------
6075    -- Has_Private_With --
6076    ----------------------
6077
6078    function Has_Private_With (E : Entity_Id) return Boolean is
6079       Comp_Unit : constant Node_Id := Cunit (Current_Sem_Unit);
6080       Item      : Node_Id;
6081
6082    begin
6083       Item := First (Context_Items (Comp_Unit));
6084       while Present (Item) loop
6085          if Nkind (Item) = N_With_Clause
6086            and then Private_Present (Item)
6087            and then Entity (Name (Item)) = E
6088          then
6089             return True;
6090          end if;
6091
6092          Next (Item);
6093       end loop;
6094
6095       return False;
6096    end Has_Private_With;
6097
6098    ---------------------------
6099    -- Has_Implicit_Operator --
6100    ---------------------------
6101
6102    function Has_Implicit_Operator (N : Node_Id) return Boolean is
6103       Op_Id   : constant Name_Id   := Chars (Selector_Name (N));
6104       P       : constant Entity_Id := Entity (Prefix (N));
6105       Id      : Entity_Id;
6106       Priv_Id : Entity_Id := Empty;
6107
6108       procedure Add_Implicit_Operator
6109         (T       : Entity_Id;
6110          Op_Type : Entity_Id := Empty);
6111       --  Add implicit interpretation to node N, using the type for which a
6112       --  predefined operator exists. If the operator yields a boolean type,
6113       --  the Operand_Type is implicitly referenced by the operator, and a
6114       --  reference to it must be generated.
6115
6116       ---------------------------
6117       -- Add_Implicit_Operator --
6118       ---------------------------
6119
6120       procedure Add_Implicit_Operator
6121         (T       : Entity_Id;
6122          Op_Type : Entity_Id := Empty)
6123       is
6124          Predef_Op : Entity_Id;
6125
6126       begin
6127          Predef_Op := Current_Entity (Selector_Name (N));
6128
6129          while Present (Predef_Op)
6130            and then Scope (Predef_Op) /= Standard_Standard
6131          loop
6132             Predef_Op := Homonym (Predef_Op);
6133          end loop;
6134
6135          if Nkind (N) = N_Selected_Component then
6136             Change_Selected_Component_To_Expanded_Name (N);
6137          end if;
6138
6139          --  If the context is an unanalyzed function call, determine whether
6140          --  a binary or unary interpretation is required.
6141
6142          if Nkind (Parent (N)) = N_Indexed_Component then
6143             declare
6144                Is_Binary_Call : constant Boolean :=
6145                                   Present
6146                                     (Next (First (Expressions (Parent (N)))));
6147                Is_Binary_Op   : constant Boolean :=
6148                                   First_Entity
6149                                     (Predef_Op) /= Last_Entity (Predef_Op);
6150                Predef_Op2     : constant Entity_Id := Homonym (Predef_Op);
6151
6152             begin
6153                if Is_Binary_Call then
6154                   if Is_Binary_Op then
6155                      Add_One_Interp (N, Predef_Op, T);
6156                   else
6157                      Add_One_Interp (N, Predef_Op2, T);
6158                   end if;
6159
6160                else
6161                   if not Is_Binary_Op then
6162                      Add_One_Interp (N, Predef_Op, T);
6163                   else
6164                      Add_One_Interp (N, Predef_Op2, T);
6165                   end if;
6166                end if;
6167             end;
6168
6169          else
6170             Add_One_Interp (N, Predef_Op, T);
6171
6172             --  For operators with unary and binary interpretations, if
6173             --  context is not a call, add both
6174
6175             if Present (Homonym (Predef_Op)) then
6176                Add_One_Interp (N, Homonym (Predef_Op), T);
6177             end if;
6178          end if;
6179
6180          --  The node is a reference to a predefined operator, and
6181          --  an implicit reference to the type of its operands.
6182
6183          if Present (Op_Type) then
6184             Generate_Operator_Reference (N, Op_Type);
6185          else
6186             Generate_Operator_Reference (N, T);
6187          end if;
6188       end Add_Implicit_Operator;
6189
6190    --  Start of processing for Has_Implicit_Operator
6191
6192    begin
6193       if Ekind (P) = E_Package
6194         and then not In_Open_Scopes (P)
6195       then
6196          Priv_Id := First_Private_Entity (P);
6197       end if;
6198
6199       Id := First_Entity (P);
6200
6201       case Op_Id is
6202
6203          --  Boolean operators: an implicit declaration exists if the scope
6204          --  contains a declaration for a derived Boolean type, or for an
6205          --  array of Boolean type.
6206
6207          when Name_Op_And | Name_Op_Not | Name_Op_Or  | Name_Op_Xor =>
6208             while Id  /= Priv_Id loop
6209                if Valid_Boolean_Arg (Id) and then Is_Base_Type (Id) then
6210                   Add_Implicit_Operator (Id);
6211                   return True;
6212                end if;
6213
6214                Next_Entity (Id);
6215             end loop;
6216
6217          --  Equality: look for any non-limited type (result is Boolean)
6218
6219          when Name_Op_Eq | Name_Op_Ne =>
6220             while Id  /= Priv_Id loop
6221                if Is_Type (Id)
6222                  and then not Is_Limited_Type (Id)
6223                  and then Is_Base_Type (Id)
6224                then
6225                   Add_Implicit_Operator (Standard_Boolean, Id);
6226                   return True;
6227                end if;
6228
6229                Next_Entity (Id);
6230             end loop;
6231
6232          --  Comparison operators: scalar type, or array of scalar
6233
6234          when Name_Op_Lt | Name_Op_Le | Name_Op_Gt | Name_Op_Ge =>
6235             while Id  /= Priv_Id loop
6236                if (Is_Scalar_Type (Id)
6237                     or else (Is_Array_Type (Id)
6238                               and then Is_Scalar_Type (Component_Type (Id))))
6239                  and then Is_Base_Type (Id)
6240                then
6241                   Add_Implicit_Operator (Standard_Boolean, Id);
6242                   return True;
6243                end if;
6244
6245                Next_Entity (Id);
6246             end loop;
6247
6248          --  Arithmetic operators: any numeric type
6249
6250          when Name_Op_Abs      |
6251               Name_Op_Add      |
6252               Name_Op_Mod      |
6253               Name_Op_Rem      |
6254               Name_Op_Subtract |
6255               Name_Op_Multiply |
6256               Name_Op_Divide   |
6257               Name_Op_Expon    =>
6258             while Id  /= Priv_Id loop
6259                if Is_Numeric_Type (Id) and then Is_Base_Type (Id) then
6260                   Add_Implicit_Operator (Id);
6261                   return True;
6262                end if;
6263
6264                Next_Entity (Id);
6265             end loop;
6266
6267          --  Concatenation: any one-dimensional array type
6268
6269          when Name_Op_Concat =>
6270             while Id  /= Priv_Id loop
6271                if Is_Array_Type (Id)
6272                  and then Number_Dimensions (Id) = 1
6273                  and then Is_Base_Type (Id)
6274                then
6275                   Add_Implicit_Operator (Id);
6276                   return True;
6277                end if;
6278
6279                Next_Entity (Id);
6280             end loop;
6281
6282          --  What is the others condition here? Should we be using a
6283          --  subtype of Name_Id that would restrict to operators ???
6284
6285          when others => null;
6286       end case;
6287
6288       --  If we fall through, then we do not have an implicit operator
6289
6290       return False;
6291
6292    end Has_Implicit_Operator;
6293
6294    -----------------------------------
6295    -- Has_Loop_In_Inner_Open_Scopes --
6296    -----------------------------------
6297
6298    function Has_Loop_In_Inner_Open_Scopes (S : Entity_Id) return Boolean is
6299    begin
6300       --  Several scope stacks are maintained by Scope_Stack. The base of the
6301       --  currently active scope stack is denoted by the Is_Active_Stack_Base
6302       --  flag in the scope stack entry. Note that the scope stacks used to
6303       --  simply be delimited implicitly by the presence of Standard_Standard
6304       --  at their base, but there now are cases where this is not sufficient
6305       --  because Standard_Standard actually may appear in the middle of the
6306       --  active set of scopes.
6307
6308       for J in reverse 0 .. Scope_Stack.Last loop
6309
6310          --  S was reached without seing a loop scope first
6311
6312          if Scope_Stack.Table (J).Entity = S then
6313             return False;
6314
6315          --  S was not yet reached, so it contains at least one inner loop
6316
6317          elsif Ekind (Scope_Stack.Table (J).Entity) = E_Loop then
6318             return True;
6319          end if;
6320
6321          --  Check Is_Active_Stack_Base to tell us when to stop, as there are
6322          --  cases where Standard_Standard appears in the middle of the active
6323          --  set of scopes. This affects the declaration and overriding of
6324          --  private inherited operations in instantiations of generic child
6325          --  units.
6326
6327          pragma Assert (not Scope_Stack.Table (J).Is_Active_Stack_Base);
6328       end loop;
6329
6330       raise Program_Error;    --  unreachable
6331    end Has_Loop_In_Inner_Open_Scopes;
6332
6333    --------------------
6334    -- In_Open_Scopes --
6335    --------------------
6336
6337    function In_Open_Scopes (S : Entity_Id) return Boolean is
6338    begin
6339       --  Several scope stacks are maintained by Scope_Stack. The base of the
6340       --  currently active scope stack is denoted by the Is_Active_Stack_Base
6341       --  flag in the scope stack entry. Note that the scope stacks used to
6342       --  simply be delimited implicitly by the presence of Standard_Standard
6343       --  at their base, but there now are cases where this is not sufficient
6344       --  because Standard_Standard actually may appear in the middle of the
6345       --  active set of scopes.
6346
6347       for J in reverse 0 .. Scope_Stack.Last loop
6348          if Scope_Stack.Table (J).Entity = S then
6349             return True;
6350          end if;
6351
6352          --  Check Is_Active_Stack_Base to tell us when to stop, as there are
6353          --  cases where Standard_Standard appears in the middle of the active
6354          --  set of scopes. This affects the declaration and overriding of
6355          --  private inherited operations in instantiations of generic child
6356          --  units.
6357
6358          exit when Scope_Stack.Table (J).Is_Active_Stack_Base;
6359       end loop;
6360
6361       return False;
6362    end In_Open_Scopes;
6363
6364    -----------------------------
6365    -- Inherit_Renamed_Profile --
6366    -----------------------------
6367
6368    procedure Inherit_Renamed_Profile (New_S : Entity_Id; Old_S : Entity_Id) is
6369       New_F : Entity_Id;
6370       Old_F : Entity_Id;
6371       Old_T : Entity_Id;
6372       New_T : Entity_Id;
6373
6374    begin
6375       if Ekind (Old_S) = E_Operator then
6376          New_F := First_Formal (New_S);
6377
6378          while Present (New_F) loop
6379             Set_Etype (New_F, Base_Type (Etype (New_F)));
6380             Next_Formal (New_F);
6381          end loop;
6382
6383          Set_Etype (New_S, Base_Type (Etype (New_S)));
6384
6385       else
6386          New_F := First_Formal (New_S);
6387          Old_F := First_Formal (Old_S);
6388
6389          while Present (New_F) loop
6390             New_T := Etype (New_F);
6391             Old_T := Etype (Old_F);
6392
6393             --  If the new type is a renaming of the old one, as is the
6394             --  case for actuals in instances, retain its name, to simplify
6395             --  later disambiguation.
6396
6397             if Nkind (Parent (New_T)) = N_Subtype_Declaration
6398               and then Is_Entity_Name (Subtype_Indication (Parent (New_T)))
6399               and then Entity (Subtype_Indication (Parent (New_T))) = Old_T
6400             then
6401                null;
6402             else
6403                Set_Etype (New_F, Old_T);
6404             end if;
6405
6406             Next_Formal (New_F);
6407             Next_Formal (Old_F);
6408          end loop;
6409
6410          if Ekind_In (Old_S, E_Function, E_Enumeration_Literal) then
6411             Set_Etype (New_S, Etype (Old_S));
6412          end if;
6413       end if;
6414    end Inherit_Renamed_Profile;
6415
6416    ----------------
6417    -- Initialize --
6418    ----------------
6419
6420    procedure Initialize is
6421    begin
6422       Urefs.Init;
6423    end Initialize;
6424
6425    -------------------------
6426    -- Install_Use_Clauses --
6427    -------------------------
6428
6429    procedure Install_Use_Clauses
6430      (Clause             : Node_Id;
6431       Force_Installation : Boolean := False)
6432    is
6433       U  : Node_Id;
6434       P  : Node_Id;
6435       Id : Entity_Id;
6436
6437    begin
6438       U := Clause;
6439       while Present (U) loop
6440
6441          --  Case of USE package
6442
6443          if Nkind (U) = N_Use_Package_Clause then
6444             P := First (Names (U));
6445             while Present (P) loop
6446                Id := Entity (P);
6447
6448                if Ekind (Id) = E_Package then
6449                   if In_Use (Id) then
6450                      Note_Redundant_Use (P);
6451
6452                   elsif Present (Renamed_Object (Id))
6453                     and then In_Use (Renamed_Object (Id))
6454                   then
6455                      Note_Redundant_Use (P);
6456
6457                   elsif Force_Installation or else Applicable_Use (P) then
6458                      Use_One_Package (Id, U);
6459
6460                   end if;
6461                end if;
6462
6463                Next (P);
6464             end loop;
6465
6466          --  Case of USE TYPE
6467
6468          else
6469             P := First (Subtype_Marks (U));
6470             while Present (P) loop
6471                if not Is_Entity_Name (P)
6472                  or else No (Entity (P))
6473                then
6474                   null;
6475
6476                elsif Entity (P) /= Any_Type then
6477                   Use_One_Type (P);
6478                end if;
6479
6480                Next (P);
6481             end loop;
6482          end if;
6483
6484          Next_Use_Clause (U);
6485       end loop;
6486    end Install_Use_Clauses;
6487
6488    -------------------------------------
6489    -- Is_Appropriate_For_Entry_Prefix --
6490    -------------------------------------
6491
6492    function Is_Appropriate_For_Entry_Prefix (T : Entity_Id) return Boolean is
6493       P_Type : Entity_Id := T;
6494
6495    begin
6496       if Is_Access_Type (P_Type) then
6497          P_Type := Designated_Type (P_Type);
6498       end if;
6499
6500       return Is_Task_Type (P_Type) or else Is_Protected_Type (P_Type);
6501    end Is_Appropriate_For_Entry_Prefix;
6502
6503    -------------------------------
6504    -- Is_Appropriate_For_Record --
6505    -------------------------------
6506
6507    function Is_Appropriate_For_Record (T : Entity_Id) return Boolean is
6508
6509       function Has_Components (T1 : Entity_Id) return Boolean;
6510       --  Determine if given type has components (i.e. is either a record
6511       --  type or a type that has discriminants).
6512
6513       --------------------
6514       -- Has_Components --
6515       --------------------
6516
6517       function Has_Components (T1 : Entity_Id) return Boolean is
6518       begin
6519          return Is_Record_Type (T1)
6520            or else (Is_Private_Type (T1) and then Has_Discriminants (T1))
6521            or else (Is_Task_Type (T1) and then Has_Discriminants (T1))
6522            or else (Is_Incomplete_Type (T1)
6523                      and then From_With_Type (T1)
6524                      and then Present (Non_Limited_View (T1))
6525                      and then Is_Record_Type
6526                                 (Get_Full_View (Non_Limited_View (T1))));
6527       end Has_Components;
6528
6529    --  Start of processing for Is_Appropriate_For_Record
6530
6531    begin
6532       return
6533         Present (T)
6534           and then (Has_Components (T)
6535                      or else (Is_Access_Type (T)
6536                                and then Has_Components (Designated_Type (T))));
6537    end Is_Appropriate_For_Record;
6538
6539    ------------------------
6540    -- Note_Redundant_Use --
6541    ------------------------
6542
6543    procedure Note_Redundant_Use (Clause : Node_Id) is
6544       Pack_Name : constant Entity_Id := Entity (Clause);
6545       Cur_Use   : constant Node_Id   := Current_Use_Clause (Pack_Name);
6546       Decl      : constant Node_Id   := Parent (Clause);
6547
6548       Prev_Use   : Node_Id := Empty;
6549       Redundant  : Node_Id := Empty;
6550       --  The Use_Clause which is actually redundant. In the simplest case it
6551       --  is Pack itself, but when we compile a body we install its context
6552       --  before that of its spec, in which case it is the use_clause in the
6553       --  spec that will appear to be redundant, and we want the warning to be
6554       --  placed on the body. Similar complications appear when the redundancy
6555       --  is between a child unit and one of its ancestors.
6556
6557    begin
6558       Set_Redundant_Use (Clause, True);
6559
6560       if not Comes_From_Source (Clause)
6561         or else In_Instance
6562         or else not Warn_On_Redundant_Constructs
6563       then
6564          return;
6565       end if;
6566
6567       if not Is_Compilation_Unit (Current_Scope) then
6568
6569          --  If the use_clause is in an inner scope, it is made redundant by
6570          --  some clause in the current context, with one exception: If we're
6571          --  compiling a nested package body, and the use_clause comes from the
6572          --  corresponding spec, the clause is not necessarily fully redundant,
6573          --  so we should not warn. If a warning was warranted, it would have
6574          --  been given when the spec was processed.
6575
6576          if Nkind (Parent (Decl)) = N_Package_Specification then
6577             declare
6578                Package_Spec_Entity : constant Entity_Id :=
6579                                        Defining_Unit_Name (Parent (Decl));
6580             begin
6581                if In_Package_Body (Package_Spec_Entity) then
6582                   return;
6583                end if;
6584             end;
6585          end if;
6586
6587          Redundant := Clause;
6588          Prev_Use  := Cur_Use;
6589
6590       elsif Nkind (Unit (Cunit (Current_Sem_Unit))) = N_Package_Body then
6591          declare
6592             Cur_Unit : constant Unit_Number_Type := Get_Source_Unit (Cur_Use);
6593             New_Unit : constant Unit_Number_Type := Get_Source_Unit (Clause);
6594             Scop     : Entity_Id;
6595
6596          begin
6597             if Cur_Unit = New_Unit then
6598
6599                --  Redundant clause in same body
6600
6601                Redundant := Clause;
6602                Prev_Use  := Cur_Use;
6603
6604             elsif Cur_Unit = Current_Sem_Unit then
6605
6606                --  If the new clause is not in the current unit it has been
6607                --  analyzed first, and it makes the other one redundant.
6608                --  However, if the new clause appears in a subunit, Cur_Unit
6609                --  is still the parent, and in that case the redundant one
6610                --  is the one appearing in the subunit.
6611
6612                if Nkind (Unit (Cunit (New_Unit))) = N_Subunit then
6613                   Redundant := Clause;
6614                   Prev_Use  := Cur_Use;
6615
6616                --  Most common case: redundant clause in body,
6617                --  original clause in spec. Current scope is spec entity.
6618
6619                elsif
6620                  Current_Scope =
6621                    Defining_Entity (
6622                      Unit (Library_Unit (Cunit (Current_Sem_Unit))))
6623                then
6624                   Redundant := Cur_Use;
6625                   Prev_Use  := Clause;
6626
6627                else
6628                   --  The new clause may appear in an unrelated unit, when
6629                   --  the parents of a generic are being installed prior to
6630                   --  instantiation. In this case there must be no warning.
6631                   --  We detect this case by checking whether the current top
6632                   --  of the stack is related to the current compilation.
6633
6634                   Scop := Current_Scope;
6635                   while Present (Scop)
6636                     and then Scop /= Standard_Standard
6637                   loop
6638                      if Is_Compilation_Unit (Scop)
6639                        and then not Is_Child_Unit (Scop)
6640                      then
6641                         return;
6642
6643                      elsif Scop = Cunit_Entity (Current_Sem_Unit) then
6644                         exit;
6645                      end if;
6646
6647                      Scop := Scope (Scop);
6648                   end loop;
6649
6650                   Redundant := Cur_Use;
6651                   Prev_Use  := Clause;
6652                end if;
6653
6654             elsif New_Unit = Current_Sem_Unit then
6655                Redundant := Clause;
6656                Prev_Use  := Cur_Use;
6657
6658             else
6659                --  Neither is the current unit, so they appear in parent or
6660                --  sibling units. Warning will be emitted elsewhere.
6661
6662                return;
6663             end if;
6664          end;
6665
6666       elsif Nkind (Unit (Cunit (Current_Sem_Unit))) = N_Package_Declaration
6667         and then Present (Parent_Spec (Unit (Cunit (Current_Sem_Unit))))
6668       then
6669          --  Use_clause is in child unit of current unit, and the child unit
6670          --  appears in the context of the body of the parent, so it has been
6671          --  installed first, even though it is the redundant one. Depending on
6672          --  their placement in the context, the visible or the private parts
6673          --  of the two units, either might appear as redundant, but the
6674          --  message has to be on the current unit.
6675
6676          if Get_Source_Unit (Cur_Use) = Current_Sem_Unit then
6677             Redundant := Cur_Use;
6678             Prev_Use  := Clause;
6679          else
6680             Redundant := Clause;
6681             Prev_Use  := Cur_Use;
6682          end if;
6683
6684          --  If the new use clause appears in the private part of a parent unit
6685          --  it may appear to be redundant w.r.t. a use clause in a child unit,
6686          --  but the previous use clause was needed in the visible part of the
6687          --  child, and no warning should be emitted.
6688
6689          if Nkind (Parent (Decl)) = N_Package_Specification
6690            and then
6691              List_Containing (Decl) = Private_Declarations (Parent (Decl))
6692          then
6693             declare
6694                Par : constant Entity_Id := Defining_Entity (Parent (Decl));
6695                Spec : constant Node_Id  :=
6696                         Specification (Unit (Cunit (Current_Sem_Unit)));
6697
6698             begin
6699                if Is_Compilation_Unit (Par)
6700                  and then Par /= Cunit_Entity (Current_Sem_Unit)
6701                  and then Parent (Cur_Use) = Spec
6702                  and then
6703                    List_Containing (Cur_Use) = Visible_Declarations (Spec)
6704                then
6705                   return;
6706                end if;
6707             end;
6708          end if;
6709
6710       --  Finally, if the current use clause is in the context then
6711       --  the clause is redundant when it is nested within the unit.
6712
6713       elsif Nkind (Parent (Cur_Use)) = N_Compilation_Unit
6714         and then Nkind (Parent (Parent (Clause))) /= N_Compilation_Unit
6715         and then Get_Source_Unit (Cur_Use) = Get_Source_Unit (Clause)
6716       then
6717          Redundant := Clause;
6718          Prev_Use  := Cur_Use;
6719
6720       else
6721          null;
6722       end if;
6723
6724       if Present (Redundant) then
6725          Error_Msg_Sloc := Sloc (Prev_Use);
6726          Error_Msg_NE -- CODEFIX
6727            ("& is already use-visible through previous use clause #?",
6728             Redundant, Pack_Name);
6729       end if;
6730    end Note_Redundant_Use;
6731
6732    ---------------
6733    -- Pop_Scope --
6734    ---------------
6735
6736    procedure Pop_Scope is
6737       SST : Scope_Stack_Entry renames Scope_Stack.Table (Scope_Stack.Last);
6738       S   : constant Entity_Id := SST.Entity;
6739
6740    begin
6741       if Debug_Flag_E then
6742          Write_Info;
6743       end if;
6744
6745       --  Set Default_Storage_Pool field of the library unit if necessary
6746
6747       if Ekind_In (S, E_Package, E_Generic_Package)
6748         and then
6749           Nkind (Parent (Unit_Declaration_Node (S))) = N_Compilation_Unit
6750       then
6751          declare
6752             Aux : constant Node_Id :=
6753                     Aux_Decls_Node (Parent (Unit_Declaration_Node (S)));
6754          begin
6755             if No (Default_Storage_Pool (Aux)) then
6756                Set_Default_Storage_Pool (Aux, Default_Pool);
6757             end if;
6758          end;
6759       end if;
6760
6761       Scope_Suppress           := SST.Save_Scope_Suppress;
6762       Local_Suppress_Stack_Top := SST.Save_Local_Suppress_Stack_Top;
6763       Check_Policy_List        := SST.Save_Check_Policy_List;
6764       Default_Pool             := SST.Save_Default_Storage_Pool;
6765
6766       if Debug_Flag_W then
6767          Write_Str ("<-- exiting scope: ");
6768          Write_Name (Chars (Current_Scope));
6769          Write_Str (", Depth=");
6770          Write_Int (Int (Scope_Stack.Last));
6771          Write_Eol;
6772       end if;
6773
6774       End_Use_Clauses (SST.First_Use_Clause);
6775
6776       --  If the actions to be wrapped are still there they will get lost
6777       --  causing incomplete code to be generated. It is better to abort in
6778       --  this case (and we do the abort even with assertions off since the
6779       --  penalty is incorrect code generation)
6780
6781       if SST.Actions_To_Be_Wrapped_Before /= No_List
6782            or else
6783          SST.Actions_To_Be_Wrapped_After  /= No_List
6784       then
6785          raise Program_Error;
6786       end if;
6787
6788       --  Free last subprogram name if allocated, and pop scope
6789
6790       Free (SST.Last_Subprogram_Name);
6791       Scope_Stack.Decrement_Last;
6792    end Pop_Scope;
6793
6794    ---------------
6795    -- Push_Scope --
6796    ---------------
6797
6798    procedure Push_Scope (S : Entity_Id) is
6799       E : constant Entity_Id := Scope (S);
6800
6801    begin
6802       if Ekind (S) = E_Void then
6803          null;
6804
6805       --  Set scope depth if not a non-concurrent type, and we have not yet set
6806       --  the scope depth. This means that we have the first occurrence of the
6807       --  scope, and this is where the depth is set.
6808
6809       elsif (not Is_Type (S) or else Is_Concurrent_Type (S))
6810         and then not Scope_Depth_Set (S)
6811       then
6812          if S = Standard_Standard then
6813             Set_Scope_Depth_Value (S, Uint_0);
6814
6815          elsif Is_Child_Unit (S) then
6816             Set_Scope_Depth_Value (S, Uint_1);
6817
6818          elsif not Is_Record_Type (Current_Scope) then
6819             if Ekind (S) = E_Loop then
6820                Set_Scope_Depth_Value (S, Scope_Depth (Current_Scope));
6821             else
6822                Set_Scope_Depth_Value (S, Scope_Depth (Current_Scope) + 1);
6823             end if;
6824          end if;
6825       end if;
6826
6827       Scope_Stack.Increment_Last;
6828
6829       declare
6830          SST : Scope_Stack_Entry renames Scope_Stack.Table (Scope_Stack.Last);
6831
6832       begin
6833          SST.Entity                        := S;
6834          SST.Save_Scope_Suppress           := Scope_Suppress;
6835          SST.Save_Local_Suppress_Stack_Top := Local_Suppress_Stack_Top;
6836          SST.Save_Check_Policy_List        := Check_Policy_List;
6837          SST.Save_Default_Storage_Pool     := Default_Pool;
6838
6839          if Scope_Stack.Last > Scope_Stack.First then
6840             SST.Component_Alignment_Default := Scope_Stack.Table
6841                                                  (Scope_Stack.Last - 1).
6842                                                    Component_Alignment_Default;
6843          end if;
6844
6845          SST.Last_Subprogram_Name           := null;
6846          SST.Is_Transient                   := False;
6847          SST.Node_To_Be_Wrapped             := Empty;
6848          SST.Pending_Freeze_Actions         := No_List;
6849          SST.Actions_To_Be_Wrapped_Before   := No_List;
6850          SST.Actions_To_Be_Wrapped_After    := No_List;
6851          SST.First_Use_Clause               := Empty;
6852          SST.Is_Active_Stack_Base           := False;
6853          SST.Previous_Visibility            := False;
6854       end;
6855
6856       if Debug_Flag_W then
6857          Write_Str ("--> new scope: ");
6858          Write_Name (Chars (Current_Scope));
6859          Write_Str (", Id=");
6860          Write_Int (Int (Current_Scope));
6861          Write_Str (", Depth=");
6862          Write_Int (Int (Scope_Stack.Last));
6863          Write_Eol;
6864       end if;
6865
6866       --  Deal with copying flags from the previous scope to this one. This is
6867       --  not necessary if either scope is standard, or if the new scope is a
6868       --  child unit.
6869
6870       if S /= Standard_Standard
6871         and then Scope (S) /= Standard_Standard
6872         and then not Is_Child_Unit (S)
6873       then
6874          if Nkind (E) not in N_Entity then
6875             return;
6876          end if;
6877
6878          --  Copy categorization flags from Scope (S) to S, this is not done
6879          --  when Scope (S) is Standard_Standard since propagation is from
6880          --  library unit entity inwards. Copy other relevant attributes as
6881          --  well (Discard_Names in particular).
6882
6883          --  We only propagate inwards for library level entities,
6884          --  inner level subprograms do not inherit the categorization.
6885
6886          if Is_Library_Level_Entity (S) then
6887             Set_Is_Preelaborated  (S, Is_Preelaborated (E));
6888             Set_Is_Shared_Passive (S, Is_Shared_Passive (E));
6889             Set_Discard_Names     (S, Discard_Names (E));
6890             Set_Suppress_Value_Tracking_On_Call
6891                                   (S, Suppress_Value_Tracking_On_Call (E));
6892             Set_Categorization_From_Scope (E => S, Scop => E);
6893          end if;
6894       end if;
6895
6896       if Is_Child_Unit (S)
6897         and then Present (E)
6898         and then Ekind_In (E, E_Package, E_Generic_Package)
6899         and then
6900           Nkind (Parent (Unit_Declaration_Node (E))) = N_Compilation_Unit
6901       then
6902          declare
6903             Aux : constant Node_Id :=
6904                     Aux_Decls_Node (Parent (Unit_Declaration_Node (E)));
6905          begin
6906             if Present (Default_Storage_Pool (Aux)) then
6907                Default_Pool := Default_Storage_Pool (Aux);
6908             end if;
6909          end;
6910       end if;
6911    end Push_Scope;
6912
6913    ---------------------
6914    -- Premature_Usage --
6915    ---------------------
6916
6917    procedure Premature_Usage (N : Node_Id) is
6918       Kind : constant Node_Kind := Nkind (Parent (Entity (N)));
6919       E    : Entity_Id := Entity (N);
6920
6921    begin
6922       --  Within an instance, the analysis of the actual for a formal object
6923       --  does not see the name of the object itself. This is significant only
6924       --  if the object is an aggregate, where its analysis does not do any
6925       --  name resolution on component associations. (see 4717-008). In such a
6926       --  case, look for the visible homonym on the chain.
6927
6928       if In_Instance
6929         and then Present (Homonym (E))
6930       then
6931          E := Homonym (E);
6932
6933          while Present (E)
6934            and then not In_Open_Scopes (Scope (E))
6935          loop
6936             E := Homonym (E);
6937          end loop;
6938
6939          if Present (E) then
6940             Set_Entity (N, E);
6941             Set_Etype (N, Etype (E));
6942             return;
6943          end if;
6944       end if;
6945
6946       if Kind  = N_Component_Declaration then
6947          Error_Msg_N
6948            ("component&! cannot be used before end of record declaration", N);
6949
6950       elsif Kind  = N_Parameter_Specification then
6951          Error_Msg_N
6952            ("formal parameter&! cannot be used before end of specification",
6953             N);
6954
6955       elsif Kind  = N_Discriminant_Specification then
6956          Error_Msg_N
6957            ("discriminant&! cannot be used before end of discriminant part",
6958             N);
6959
6960       elsif Kind  = N_Procedure_Specification
6961         or else Kind = N_Function_Specification
6962       then
6963          Error_Msg_N
6964            ("subprogram&! cannot be used before end of its declaration",
6965             N);
6966
6967       elsif Kind = N_Full_Type_Declaration then
6968          Error_Msg_N
6969            ("type& cannot be used before end of its declaration!", N);
6970
6971       else
6972          Error_Msg_N
6973            ("object& cannot be used before end of its declaration!", N);
6974       end if;
6975    end Premature_Usage;
6976
6977    ------------------------
6978    -- Present_System_Aux --
6979    ------------------------
6980
6981    function Present_System_Aux (N : Node_Id := Empty) return Boolean is
6982       Loc      : Source_Ptr;
6983       Aux_Name : Unit_Name_Type;
6984       Unum     : Unit_Number_Type;
6985       Withn    : Node_Id;
6986       With_Sys : Node_Id;
6987       The_Unit : Node_Id;
6988
6989       function Find_System (C_Unit : Node_Id) return Entity_Id;
6990       --  Scan context clause of compilation unit to find with_clause
6991       --  for System.
6992
6993       -----------------
6994       -- Find_System --
6995       -----------------
6996
6997       function Find_System (C_Unit : Node_Id) return Entity_Id is
6998          With_Clause : Node_Id;
6999
7000       begin
7001          With_Clause := First (Context_Items (C_Unit));
7002          while Present (With_Clause) loop
7003             if (Nkind (With_Clause) = N_With_Clause
7004               and then Chars (Name (With_Clause)) = Name_System)
7005               and then Comes_From_Source (With_Clause)
7006             then
7007                return With_Clause;
7008             end if;
7009
7010             Next (With_Clause);
7011          end loop;
7012
7013          return Empty;
7014       end Find_System;
7015
7016    --  Start of processing for Present_System_Aux
7017
7018    begin
7019       --  The child unit may have been loaded and analyzed already
7020
7021       if Present (System_Aux_Id) then
7022          return True;
7023
7024       --  If no previous pragma for System.Aux, nothing to load
7025
7026       elsif No (System_Extend_Unit) then
7027          return False;
7028
7029       --  Use the unit name given in the pragma to retrieve the unit.
7030       --  Verify that System itself appears in the context clause of the
7031       --  current compilation. If System is not present, an error will
7032       --  have been reported already.
7033
7034       else
7035          With_Sys := Find_System (Cunit (Current_Sem_Unit));
7036
7037          The_Unit := Unit (Cunit (Current_Sem_Unit));
7038
7039          if No (With_Sys)
7040            and then
7041              (Nkind (The_Unit) = N_Package_Body
7042                 or else (Nkind (The_Unit) = N_Subprogram_Body
7043                            and then
7044                              not Acts_As_Spec (Cunit (Current_Sem_Unit))))
7045          then
7046             With_Sys := Find_System (Library_Unit (Cunit (Current_Sem_Unit)));
7047          end if;
7048
7049          if No (With_Sys)
7050            and then Present (N)
7051          then
7052             --  If we are compiling a subunit, we need to examine its
7053             --  context as well (Current_Sem_Unit is the parent unit);
7054
7055             The_Unit := Parent (N);
7056             while Nkind (The_Unit) /= N_Compilation_Unit loop
7057                The_Unit := Parent (The_Unit);
7058             end loop;
7059
7060             if Nkind (Unit (The_Unit)) = N_Subunit then
7061                With_Sys := Find_System (The_Unit);
7062             end if;
7063          end if;
7064
7065          if No (With_Sys) then
7066             return False;
7067          end if;
7068
7069          Loc := Sloc (With_Sys);
7070          Get_Name_String (Chars (Expression (System_Extend_Unit)));
7071          Name_Buffer (8 .. Name_Len + 7) := Name_Buffer (1 .. Name_Len);
7072          Name_Buffer (1 .. 7) := "system.";
7073          Name_Buffer (Name_Len + 8) := '%';
7074          Name_Buffer (Name_Len + 9) := 's';
7075          Name_Len := Name_Len + 9;
7076          Aux_Name := Name_Find;
7077
7078          Unum :=
7079            Load_Unit
7080              (Load_Name  => Aux_Name,
7081               Required   => False,
7082               Subunit    => False,
7083               Error_Node => With_Sys);
7084
7085          if Unum /= No_Unit then
7086             Semantics (Cunit (Unum));
7087             System_Aux_Id :=
7088               Defining_Entity (Specification (Unit (Cunit (Unum))));
7089
7090             Withn :=
7091               Make_With_Clause (Loc,
7092                 Name =>
7093                   Make_Expanded_Name (Loc,
7094                     Chars  => Chars (System_Aux_Id),
7095                     Prefix => New_Reference_To (Scope (System_Aux_Id), Loc),
7096                     Selector_Name => New_Reference_To (System_Aux_Id, Loc)));
7097
7098             Set_Entity (Name (Withn), System_Aux_Id);
7099
7100             Set_Library_Unit       (Withn, Cunit (Unum));
7101             Set_Corresponding_Spec (Withn, System_Aux_Id);
7102             Set_First_Name         (Withn, True);
7103             Set_Implicit_With      (Withn, True);
7104
7105             Insert_After (With_Sys, Withn);
7106             Mark_Rewrite_Insertion (Withn);
7107             Set_Context_Installed (Withn);
7108
7109             return True;
7110
7111          --  Here if unit load failed
7112
7113          else
7114             Error_Msg_Name_1 := Name_System;
7115             Error_Msg_Name_2 := Chars (Expression (System_Extend_Unit));
7116             Error_Msg_N
7117               ("extension package `%.%` does not exist",
7118                Opt.System_Extend_Unit);
7119             return False;
7120          end if;
7121       end if;
7122    end Present_System_Aux;
7123
7124    -------------------------
7125    -- Restore_Scope_Stack --
7126    -------------------------
7127
7128    procedure Restore_Scope_Stack (Handle_Use : Boolean := True) is
7129       E         : Entity_Id;
7130       S         : Entity_Id;
7131       Comp_Unit : Node_Id;
7132       In_Child  : Boolean := False;
7133       Full_Vis  : Boolean := True;
7134       SS_Last   : constant Int := Scope_Stack.Last;
7135
7136    begin
7137       --  Restore visibility of previous scope stack, if any
7138
7139       for J in reverse 0 .. Scope_Stack.Last loop
7140          exit when  Scope_Stack.Table (J).Entity = Standard_Standard
7141             or else No (Scope_Stack.Table (J).Entity);
7142
7143          S := Scope_Stack.Table (J).Entity;
7144
7145          if not Is_Hidden_Open_Scope (S) then
7146
7147             --  If the parent scope is hidden, its entities are hidden as
7148             --  well, unless the entity is the instantiation currently
7149             --  being analyzed.
7150
7151             if not Is_Hidden_Open_Scope (Scope (S))
7152               or else not Analyzed (Parent (S))
7153               or else Scope (S) = Standard_Standard
7154             then
7155                Set_Is_Immediately_Visible (S, True);
7156             end if;
7157
7158             E := First_Entity (S);
7159             while Present (E) loop
7160                if Is_Child_Unit (E) then
7161                   if not From_With_Type (E) then
7162                      Set_Is_Immediately_Visible (E,
7163                        Is_Visible_Child_Unit (E) or else In_Open_Scopes (E));
7164
7165                   else
7166                      pragma Assert
7167                        (Nkind (Parent (E)) = N_Defining_Program_Unit_Name
7168                           and then
7169                         Nkind (Parent (Parent (E))) = N_Package_Specification);
7170                      Set_Is_Immediately_Visible (E,
7171                        Limited_View_Installed (Parent (Parent (E))));
7172                   end if;
7173                else
7174                   Set_Is_Immediately_Visible (E, True);
7175                end if;
7176
7177                Next_Entity (E);
7178
7179                if not Full_Vis
7180                  and then Is_Package_Or_Generic_Package (S)
7181                then
7182                   --  We are in the visible part of the package scope
7183
7184                   exit when E = First_Private_Entity (S);
7185                end if;
7186             end loop;
7187
7188             --  The visibility of child units (siblings of current compilation)
7189             --  must be restored in any case. Their declarations may appear
7190             --  after the private part of the parent.
7191
7192             if not Full_Vis then
7193                while Present (E) loop
7194                   if Is_Child_Unit (E) then
7195                      Set_Is_Immediately_Visible (E,
7196                        Is_Visible_Child_Unit (E) or else In_Open_Scopes (E));
7197                   end if;
7198
7199                   Next_Entity (E);
7200                end loop;
7201             end if;
7202          end if;
7203
7204          if Is_Child_Unit (S)
7205             and not In_Child     --  check only for current unit
7206          then
7207             In_Child := True;
7208
7209             --  Restore visibility of parents according to whether the child
7210             --  is private and whether we are in its visible part.
7211
7212             Comp_Unit := Parent (Unit_Declaration_Node (S));
7213
7214             if Nkind (Comp_Unit) = N_Compilation_Unit
7215               and then Private_Present (Comp_Unit)
7216             then
7217                Full_Vis := True;
7218
7219             elsif Is_Package_Or_Generic_Package (S)
7220               and then (In_Private_Part (S) or else In_Package_Body (S))
7221             then
7222                Full_Vis := True;
7223
7224             --  if S is the scope of some instance (which has already been
7225             --  seen on the stack) it does not affect the visibility of
7226             --  other scopes.
7227
7228             elsif Is_Hidden_Open_Scope (S) then
7229                null;
7230
7231             elsif (Ekind (S) = E_Procedure
7232                     or else Ekind (S) = E_Function)
7233               and then Has_Completion (S)
7234             then
7235                Full_Vis := True;
7236             else
7237                Full_Vis := False;
7238             end if;
7239          else
7240             Full_Vis := True;
7241          end if;
7242       end loop;
7243
7244       if SS_Last >= Scope_Stack.First
7245         and then Scope_Stack.Table (SS_Last).Entity /= Standard_Standard
7246         and then Handle_Use
7247       then
7248          Install_Use_Clauses (Scope_Stack.Table (SS_Last).First_Use_Clause);
7249       end if;
7250    end Restore_Scope_Stack;
7251
7252    ----------------------
7253    -- Save_Scope_Stack --
7254    ----------------------
7255
7256    procedure Save_Scope_Stack (Handle_Use : Boolean := True) is
7257       E       : Entity_Id;
7258       S       : Entity_Id;
7259       SS_Last : constant Int := Scope_Stack.Last;
7260
7261    begin
7262       if SS_Last >= Scope_Stack.First
7263         and then Scope_Stack.Table (SS_Last).Entity /= Standard_Standard
7264       then
7265          if Handle_Use then
7266             End_Use_Clauses (Scope_Stack.Table (SS_Last).First_Use_Clause);
7267          end if;
7268
7269          --  If the call is from within a compilation unit, as when called from
7270          --  Rtsfind, make current entries in scope stack invisible while we
7271          --  analyze the new unit.
7272
7273          for J in reverse 0 .. SS_Last loop
7274             exit when  Scope_Stack.Table (J).Entity = Standard_Standard
7275                or else No (Scope_Stack.Table (J).Entity);
7276
7277             S := Scope_Stack.Table (J).Entity;
7278             Set_Is_Immediately_Visible (S, False);
7279
7280             E := First_Entity (S);
7281             while Present (E) loop
7282                Set_Is_Immediately_Visible (E, False);
7283                Next_Entity (E);
7284             end loop;
7285          end loop;
7286
7287       end if;
7288    end Save_Scope_Stack;
7289
7290    -------------
7291    -- Set_Use --
7292    -------------
7293
7294    procedure Set_Use (L : List_Id) is
7295       Decl      : Node_Id;
7296       Pack_Name : Node_Id;
7297       Pack      : Entity_Id;
7298       Id        : Entity_Id;
7299
7300    begin
7301       if Present (L) then
7302          Decl := First (L);
7303          while Present (Decl) loop
7304             if Nkind (Decl) = N_Use_Package_Clause then
7305                Chain_Use_Clause (Decl);
7306
7307                Pack_Name := First (Names (Decl));
7308                while Present (Pack_Name) loop
7309                   Pack := Entity (Pack_Name);
7310
7311                   if Ekind (Pack) = E_Package
7312                     and then Applicable_Use (Pack_Name)
7313                   then
7314                      Use_One_Package (Pack, Decl);
7315                   end if;
7316
7317                   Next (Pack_Name);
7318                end loop;
7319
7320             elsif Nkind (Decl) = N_Use_Type_Clause  then
7321                Chain_Use_Clause (Decl);
7322
7323                Id := First (Subtype_Marks (Decl));
7324                while Present (Id) loop
7325                   if Entity (Id) /= Any_Type then
7326                      Use_One_Type (Id);
7327                   end if;
7328
7329                   Next (Id);
7330                end loop;
7331             end if;
7332
7333             Next (Decl);
7334          end loop;
7335       end if;
7336    end Set_Use;
7337
7338    ---------------------
7339    -- Use_One_Package --
7340    ---------------------
7341
7342    procedure Use_One_Package (P : Entity_Id; N : Node_Id) is
7343       Id               : Entity_Id;
7344       Prev             : Entity_Id;
7345       Current_Instance : Entity_Id := Empty;
7346       Real_P           : Entity_Id;
7347       Private_With_OK  : Boolean   := False;
7348
7349    begin
7350       if Ekind (P) /= E_Package then
7351          return;
7352       end if;
7353
7354       Set_In_Use (P);
7355       Set_Current_Use_Clause (P, N);
7356
7357       --  Ada 2005 (AI-50217): Check restriction
7358
7359       if From_With_Type (P) then
7360          Error_Msg_N ("limited withed package cannot appear in use clause", N);
7361       end if;
7362
7363       --  Find enclosing instance, if any
7364
7365       if In_Instance then
7366          Current_Instance := Current_Scope;
7367          while not Is_Generic_Instance (Current_Instance) loop
7368             Current_Instance := Scope (Current_Instance);
7369          end loop;
7370
7371          if No (Hidden_By_Use_Clause (N)) then
7372             Set_Hidden_By_Use_Clause (N, New_Elmt_List);
7373          end if;
7374       end if;
7375
7376       --  If unit is a package renaming, indicate that the renamed
7377       --  package is also in use (the flags on both entities must
7378       --  remain consistent, and a subsequent use of either of them
7379       --  should be recognized as redundant).
7380
7381       if Present (Renamed_Object (P)) then
7382          Set_In_Use (Renamed_Object (P));
7383          Set_Current_Use_Clause (Renamed_Object (P), N);
7384          Real_P := Renamed_Object (P);
7385       else
7386          Real_P := P;
7387       end if;
7388
7389       --  Ada 2005 (AI-262): Check the use_clause of a private withed package
7390       --  found in the private part of a package specification
7391
7392       if In_Private_Part (Current_Scope)
7393         and then Has_Private_With (P)
7394         and then Is_Child_Unit (Current_Scope)
7395         and then Is_Child_Unit (P)
7396         and then Is_Ancestor_Package (Scope (Current_Scope), P)
7397       then
7398          Private_With_OK := True;
7399       end if;
7400
7401       --  Loop through entities in one package making them potentially
7402       --  use-visible.
7403
7404       Id := First_Entity (P);
7405       while Present (Id)
7406         and then (Id /= First_Private_Entity (P)
7407                     or else Private_With_OK) -- Ada 2005 (AI-262)
7408       loop
7409          Prev := Current_Entity (Id);
7410          while Present (Prev) loop
7411             if Is_Immediately_Visible (Prev)
7412               and then (not Is_Overloadable (Prev)
7413                          or else not Is_Overloadable (Id)
7414                          or else (Type_Conformant (Id, Prev)))
7415             then
7416                if No (Current_Instance) then
7417
7418                   --  Potentially use-visible entity remains hidden
7419
7420                   goto Next_Usable_Entity;
7421
7422                --  A use clause within an instance hides outer global entities,
7423                --  which are not used to resolve local entities in the
7424                --  instance. Note that the predefined entities in Standard
7425                --  could not have been hidden in the generic by a use clause,
7426                --  and therefore remain visible. Other compilation units whose
7427                --  entities appear in Standard must be hidden in an instance.
7428
7429                --  To determine whether an entity is external to the instance
7430                --  we compare the scope depth of its scope with that of the
7431                --  current instance. However, a generic actual of a subprogram
7432                --  instance is declared in the wrapper package but will not be
7433                --  hidden by a use-visible entity. similarly, an entity that is
7434                --  declared in an enclosing instance will not be hidden by an
7435                --  an entity declared in a generic actual, which can only have
7436                --  been use-visible in the generic and will not have hidden the
7437                --  entity in the generic parent.
7438
7439                --  If Id is called Standard, the predefined package with the
7440                --  same name is in the homonym chain. It has to be ignored
7441                --  because it has no defined scope (being the only entity in
7442                --  the system with this mandated behavior).
7443
7444                elsif not Is_Hidden (Id)
7445                  and then Present (Scope (Prev))
7446                  and then not Is_Wrapper_Package (Scope (Prev))
7447                  and then Scope_Depth (Scope (Prev)) <
7448                           Scope_Depth (Current_Instance)
7449                  and then (Scope (Prev) /= Standard_Standard
7450                             or else Sloc (Prev) > Standard_Location)
7451                then
7452                   if In_Open_Scopes (Scope (Prev))
7453                     and then Is_Generic_Instance (Scope (Prev))
7454                     and then Present (Associated_Formal_Package (P))
7455                   then
7456                      null;
7457
7458                   else
7459                      Set_Is_Potentially_Use_Visible (Id);
7460                      Set_Is_Immediately_Visible (Prev, False);
7461                      Append_Elmt (Prev, Hidden_By_Use_Clause (N));
7462                   end if;
7463                end if;
7464
7465             --  A user-defined operator is not use-visible if the predefined
7466             --  operator for the type is immediately visible, which is the case
7467             --  if the type of the operand is in an open scope. This does not
7468             --  apply to user-defined operators that have operands of different
7469             --  types, because the predefined mixed mode operations (multiply
7470             --  and divide) apply to universal types and do not hide anything.
7471
7472             elsif Ekind (Prev) = E_Operator
7473               and then Operator_Matches_Spec (Prev, Id)
7474               and then In_Open_Scopes
7475                (Scope (Base_Type (Etype (First_Formal (Id)))))
7476               and then (No (Next_Formal (First_Formal (Id)))
7477                          or else Etype (First_Formal (Id))
7478                            = Etype (Next_Formal (First_Formal (Id)))
7479                          or else Chars (Prev) = Name_Op_Expon)
7480             then
7481                goto Next_Usable_Entity;
7482
7483             --  In an instance, two homonyms may become use_visible through the
7484             --  actuals of distinct formal packages. In the generic, only the
7485             --  current one would have been visible, so make the other one
7486             --  not use_visible.
7487
7488             elsif Present (Current_Instance)
7489               and then Is_Potentially_Use_Visible (Prev)
7490               and then not Is_Overloadable (Prev)
7491               and then Scope (Id) /= Scope (Prev)
7492               and then Used_As_Generic_Actual (Scope (Prev))
7493               and then Used_As_Generic_Actual (Scope (Id))
7494               and then not In_Same_List (Current_Use_Clause (Scope (Prev)),
7495                                          Current_Use_Clause (Scope (Id)))
7496             then
7497                Set_Is_Potentially_Use_Visible (Prev, False);
7498                Append_Elmt (Prev, Hidden_By_Use_Clause (N));
7499             end if;
7500
7501             Prev := Homonym (Prev);
7502          end loop;
7503
7504          --  On exit, we know entity is not hidden, unless it is private
7505
7506          if not Is_Hidden (Id)
7507            and then ((not Is_Child_Unit (Id))
7508                        or else Is_Visible_Child_Unit (Id))
7509          then
7510             Set_Is_Potentially_Use_Visible (Id);
7511
7512             if Is_Private_Type (Id)
7513               and then Present (Full_View (Id))
7514             then
7515                Set_Is_Potentially_Use_Visible (Full_View (Id));
7516             end if;
7517          end if;
7518
7519          <<Next_Usable_Entity>>
7520             Next_Entity (Id);
7521       end loop;
7522
7523       --  Child units are also made use-visible by a use clause, but they may
7524       --  appear after all visible declarations in the parent entity list.
7525
7526       while Present (Id) loop
7527          if Is_Child_Unit (Id)
7528            and then Is_Visible_Child_Unit (Id)
7529          then
7530             Set_Is_Potentially_Use_Visible (Id);
7531          end if;
7532
7533          Next_Entity (Id);
7534       end loop;
7535
7536       if Chars (Real_P) = Name_System
7537         and then Scope (Real_P) = Standard_Standard
7538         and then Present_System_Aux (N)
7539       then
7540          Use_One_Package (System_Aux_Id, N);
7541       end if;
7542
7543    end Use_One_Package;
7544
7545    ------------------
7546    -- Use_One_Type --
7547    ------------------
7548
7549    procedure Use_One_Type (Id : Node_Id) is
7550       Elmt          : Elmt_Id;
7551       Is_Known_Used : Boolean;
7552       Op_List       : Elist_Id;
7553       T             : Entity_Id;
7554
7555       function Spec_Reloaded_For_Body return Boolean;
7556       --  Determine whether the compilation unit is a package body and the use
7557       --  type clause is in the spec of the same package. Even though the spec
7558       --  was analyzed first, its context is reloaded when analysing the body.
7559
7560       procedure Use_Class_Wide_Operations (Typ : Entity_Id);
7561       --  AI05-150: if the use_type_clause carries the "all" qualifier,
7562       --  class-wide operations of ancestor types are use-visible if the
7563       --  ancestor type is visible.
7564
7565       ----------------------------
7566       -- Spec_Reloaded_For_Body --
7567       ----------------------------
7568
7569       function Spec_Reloaded_For_Body return Boolean is
7570       begin
7571          if Nkind (Unit (Cunit (Current_Sem_Unit))) = N_Package_Body then
7572             declare
7573                Spec : constant Node_Id :=
7574                         Parent (List_Containing (Parent (Id)));
7575             begin
7576                return
7577                  Nkind (Spec) = N_Package_Specification
7578                    and then Corresponding_Body (Parent (Spec)) =
7579                               Cunit_Entity (Current_Sem_Unit);
7580             end;
7581          end if;
7582
7583          return False;
7584       end Spec_Reloaded_For_Body;
7585
7586       -------------------------------
7587       -- Use_Class_Wide_Operations --
7588       -------------------------------
7589
7590       procedure Use_Class_Wide_Operations (Typ : Entity_Id) is
7591          Scop : Entity_Id;
7592          Ent  : Entity_Id;
7593
7594          function Is_Class_Wide_Operation_Of
7595         (Op  : Entity_Id;
7596          T   : Entity_Id) return Boolean;
7597          --  Determine whether a subprogram has a class-wide parameter or
7598          --  result that is T'Class.
7599
7600          ---------------------------------
7601          --  Is_Class_Wide_Operation_Of --
7602          ---------------------------------
7603
7604          function Is_Class_Wide_Operation_Of
7605            (Op  : Entity_Id;
7606             T   : Entity_Id) return Boolean
7607          is
7608             Formal : Entity_Id;
7609
7610          begin
7611             Formal := First_Formal (Op);
7612             while Present (Formal) loop
7613                if Etype (Formal) = Class_Wide_Type (T) then
7614                   return True;
7615                end if;
7616                Next_Formal (Formal);
7617             end loop;
7618
7619             if Etype (Op) = Class_Wide_Type (T) then
7620                return True;
7621             end if;
7622
7623             return False;
7624          end Is_Class_Wide_Operation_Of;
7625
7626       --  Start of processing for Use_Class_Wide_Operations
7627
7628       begin
7629          Scop := Scope (Typ);
7630          if not Is_Hidden (Scop) then
7631             Ent := First_Entity (Scop);
7632             while Present (Ent) loop
7633                if Is_Overloadable (Ent)
7634                  and then Is_Class_Wide_Operation_Of (Ent, Typ)
7635                  and then not Is_Potentially_Use_Visible (Ent)
7636                then
7637                   Set_Is_Potentially_Use_Visible (Ent);
7638                   Append_Elmt (Ent, Used_Operations (Parent (Id)));
7639                end if;
7640
7641                Next_Entity (Ent);
7642             end loop;
7643          end if;
7644
7645          if Is_Derived_Type (Typ) then
7646             Use_Class_Wide_Operations (Etype (Base_Type (Typ)));
7647          end if;
7648       end Use_Class_Wide_Operations;
7649
7650    --  Start of processing for Use_One_Type;
7651
7652    begin
7653       --  It is the type determined by the subtype mark (8.4(8)) whose
7654       --  operations become potentially use-visible.
7655
7656       T := Base_Type (Entity (Id));
7657
7658       --  Either the type itself is used, the package where it is declared
7659       --  is in use or the entity is declared in the current package, thus
7660       --  use-visible.
7661
7662       Is_Known_Used :=
7663         In_Use (T)
7664           or else In_Use (Scope (T))
7665           or else Scope (T) = Current_Scope;
7666
7667       Set_Redundant_Use (Id,
7668         Is_Known_Used or else Is_Potentially_Use_Visible (T));
7669
7670       if Ekind (T) = E_Incomplete_Type then
7671          Error_Msg_N ("premature usage of incomplete type", Id);
7672
7673       elsif In_Open_Scopes (Scope (T)) then
7674          null;
7675
7676       --  A limited view cannot appear in a use_type clause. However, an access
7677       --  type whose designated type is limited has the flag but is not itself
7678       --  a limited view unless we only have a limited view of its enclosing
7679       --  package.
7680
7681       elsif From_With_Type (T)
7682         and then From_With_Type (Scope (T))
7683       then
7684          Error_Msg_N
7685            ("incomplete type from limited view "
7686              & "cannot appear in use clause", Id);
7687
7688       --  If the subtype mark designates a subtype in a different package,
7689       --  we have to check that the parent type is visible, otherwise the
7690       --  use type clause is a noop. Not clear how to do that???
7691
7692       elsif not Redundant_Use (Id) then
7693          Set_In_Use (T);
7694
7695          --  If T is tagged, primitive operators on class-wide operands
7696          --  are also available.
7697
7698          if Is_Tagged_Type (T) then
7699             Set_In_Use (Class_Wide_Type (T));
7700          end if;
7701
7702          Set_Current_Use_Clause (T, Parent (Id));
7703          Op_List := Collect_Primitive_Operations (T);
7704
7705          --  Iterate over primitive operations of the type. If an operation is
7706          --  already use_visible, it is the result of a previous use_clause,
7707          --  and already appears on the corresponding entity chain.
7708
7709          Elmt := First_Elmt (Op_List);
7710          while Present (Elmt) loop
7711             if (Nkind (Node (Elmt)) = N_Defining_Operator_Symbol
7712                  or else Chars (Node (Elmt)) in Any_Operator_Name)
7713               and then not Is_Hidden (Node (Elmt))
7714               and then not Is_Potentially_Use_Visible (Node (Elmt))
7715             then
7716                Set_Is_Potentially_Use_Visible (Node (Elmt));
7717                Append_Elmt (Node (Elmt), Used_Operations (Parent (Id)));
7718
7719             elsif Ada_Version >= Ada_2012
7720               and then All_Present (Parent (Id))
7721               and then not Is_Hidden (Node (Elmt))
7722               and then not Is_Potentially_Use_Visible (Node (Elmt))
7723             then
7724                Set_Is_Potentially_Use_Visible (Node (Elmt));
7725                Append_Elmt (Node (Elmt), Used_Operations (Parent (Id)));
7726             end if;
7727
7728             Next_Elmt (Elmt);
7729          end loop;
7730       end if;
7731
7732       if Ada_Version >= Ada_2012
7733         and then All_Present (Parent (Id))
7734         and then Is_Tagged_Type (T)
7735       then
7736          Use_Class_Wide_Operations (T);
7737       end if;
7738
7739       --  If warning on redundant constructs, check for unnecessary WITH
7740
7741       if Warn_On_Redundant_Constructs
7742         and then Is_Known_Used
7743
7744          --                     with P;         with P; use P;
7745          --    package P is     package X is    package body X is
7746          --       type T ...       use P.T;
7747
7748          --  The compilation unit is the body of X. GNAT first compiles the
7749          --  spec of X, then proceeds to the body. At that point P is marked
7750          --  as use visible. The analysis then reinstalls the spec along with
7751          --  its context. The use clause P.T is now recognized as redundant,
7752          --  but in the wrong context. Do not emit a warning in such cases.
7753          --  Do not emit a warning either if we are in an instance, there is
7754          --  no redundancy between an outer use_clause and one that appears
7755          --  within the generic.
7756
7757         and then not Spec_Reloaded_For_Body
7758         and then not In_Instance
7759       then
7760          --  The type already has a use clause
7761
7762          if In_Use (T) then
7763
7764             --  Case where we know the current use clause for the type
7765
7766             if Present (Current_Use_Clause (T)) then
7767                Use_Clause_Known : declare
7768                   Clause1 : constant Node_Id := Parent (Id);
7769                   Clause2 : constant Node_Id := Current_Use_Clause (T);
7770                   Ent1    : Entity_Id;
7771                   Ent2    : Entity_Id;
7772                   Err_No  : Node_Id;
7773                   Unit1   : Node_Id;
7774                   Unit2   : Node_Id;
7775
7776                   function Entity_Of_Unit (U : Node_Id) return Entity_Id;
7777                   --  Return the appropriate entity for determining which unit
7778                   --  has a deeper scope: the defining entity for U, unless U
7779                   --  is a package instance, in which case we retrieve the
7780                   --  entity of the instance spec.
7781
7782                   --------------------
7783                   -- Entity_Of_Unit --
7784                   --------------------
7785
7786                   function Entity_Of_Unit (U : Node_Id) return Entity_Id is
7787                   begin
7788                      if Nkind (U) =  N_Package_Instantiation
7789                        and then Analyzed (U)
7790                      then
7791                         return Defining_Entity (Instance_Spec (U));
7792                      else
7793                         return Defining_Entity (U);
7794                      end if;
7795                   end Entity_Of_Unit;
7796
7797                --  Start of processing for Use_Clause_Known
7798
7799                begin
7800                   --  If both current use type clause and the use type clause
7801                   --  for the type are at the compilation unit level, one of
7802                   --  the units must be an ancestor of the other, and the
7803                   --  warning belongs on the descendant.
7804
7805                   if Nkind (Parent (Clause1)) = N_Compilation_Unit
7806                        and then
7807                      Nkind (Parent (Clause2)) = N_Compilation_Unit
7808                   then
7809
7810                      --  If the unit is a subprogram body that acts as spec,
7811                      --  the context clause is shared with the constructed
7812                      --  subprogram spec. Clearly there is no redundancy.
7813
7814                      if Clause1 = Clause2 then
7815                         return;
7816                      end if;
7817
7818                      Unit1 := Unit (Parent (Clause1));
7819                      Unit2 := Unit (Parent (Clause2));
7820
7821                      --  If both clauses are on same unit, or one is the body
7822                      --  of the other, or one of them is in a subunit, report
7823                      --  redundancy on the later one.
7824
7825                      if Unit1 = Unit2 then
7826                         Error_Msg_Sloc := Sloc (Current_Use_Clause (T));
7827                         Error_Msg_NE -- CODEFIX
7828                           ("& is already use-visible through previous "
7829                            & "use_type_clause #?", Clause1, T);
7830                         return;
7831
7832                      elsif Nkind (Unit1) = N_Subunit then
7833                         Error_Msg_Sloc := Sloc (Current_Use_Clause (T));
7834                         Error_Msg_NE -- CODEFIX
7835                           ("& is already use-visible through previous "
7836                            & "use_type_clause #?", Clause1, T);
7837                         return;
7838
7839                      elsif Nkind_In (Unit2, N_Package_Body, N_Subprogram_Body)
7840                        and then Nkind (Unit1) /= Nkind (Unit2)
7841                        and then Nkind (Unit1) /= N_Subunit
7842                      then
7843                         Error_Msg_Sloc := Sloc (Clause1);
7844                         Error_Msg_NE -- CODEFIX
7845                           ("& is already use-visible through previous "
7846                            & "use_type_clause #?", Current_Use_Clause (T), T);
7847                         return;
7848                      end if;
7849
7850                      --  There is a redundant use type clause in a child unit.
7851                      --  Determine which of the units is more deeply nested.
7852                      --  If a unit is a package instance, retrieve the entity
7853                      --  and its scope from the instance spec.
7854
7855                      Ent1 := Entity_Of_Unit (Unit1);
7856                      Ent2 := Entity_Of_Unit (Unit2);
7857
7858                      if Scope (Ent2) = Standard_Standard  then
7859                         Error_Msg_Sloc := Sloc (Current_Use_Clause (T));
7860                         Err_No := Clause1;
7861
7862                      elsif Scope (Ent1) = Standard_Standard then
7863                         Error_Msg_Sloc := Sloc (Id);
7864                         Err_No := Clause2;
7865
7866                      --  If both units are child units, we determine which one
7867                      --  is the descendant by the scope distance to the
7868                      --  ultimate parent unit.
7869
7870                      else
7871                         declare
7872                            S1, S2 : Entity_Id;
7873
7874                         begin
7875                            S1 := Scope (Ent1);
7876                            S2 := Scope (Ent2);
7877                            while Present (S1)
7878                              and then Present (S2)
7879                              and then S1 /= Standard_Standard
7880                              and then S2 /= Standard_Standard
7881                            loop
7882                               S1 := Scope (S1);
7883                               S2 := Scope (S2);
7884                            end loop;
7885
7886                            if S1 = Standard_Standard then
7887                               Error_Msg_Sloc := Sloc (Id);
7888                               Err_No := Clause2;
7889                            else
7890                               Error_Msg_Sloc := Sloc (Current_Use_Clause (T));
7891                               Err_No := Clause1;
7892                            end if;
7893                         end;
7894                      end if;
7895
7896                      Error_Msg_NE -- CODEFIX
7897                        ("& is already use-visible through previous "
7898                         & "use_type_clause #?", Err_No, Id);
7899
7900                   --  Case where current use type clause and the use type
7901                   --  clause for the type are not both at the compilation unit
7902                   --  level. In this case we don't have location information.
7903
7904                   else
7905                      Error_Msg_NE -- CODEFIX
7906                        ("& is already use-visible through previous "
7907                         & "use type clause?", Id, T);
7908                   end if;
7909                end Use_Clause_Known;
7910
7911             --  Here if Current_Use_Clause is not set for T, another case
7912             --  where we do not have the location information available.
7913
7914             else
7915                Error_Msg_NE -- CODEFIX
7916                  ("& is already use-visible through previous "
7917                   & "use type clause?", Id, T);
7918             end if;
7919
7920          --  The package where T is declared is already used
7921
7922          elsif In_Use (Scope (T)) then
7923             Error_Msg_Sloc := Sloc (Current_Use_Clause (Scope (T)));
7924             Error_Msg_NE -- CODEFIX
7925               ("& is already use-visible through package use clause #?",
7926                Id, T);
7927
7928          --  The current scope is the package where T is declared
7929
7930          else
7931             Error_Msg_Node_2 := Scope (T);
7932             Error_Msg_NE -- CODEFIX
7933               ("& is already use-visible inside package &?", Id, T);
7934          end if;
7935       end if;
7936    end Use_One_Type;
7937
7938    ----------------
7939    -- Write_Info --
7940    ----------------
7941
7942    procedure Write_Info is
7943       Id : Entity_Id := First_Entity (Current_Scope);
7944
7945    begin
7946       --  No point in dumping standard entities
7947
7948       if Current_Scope = Standard_Standard then
7949          return;
7950       end if;
7951
7952       Write_Str ("========================================================");
7953       Write_Eol;
7954       Write_Str ("        Defined Entities in ");
7955       Write_Name (Chars (Current_Scope));
7956       Write_Eol;
7957       Write_Str ("========================================================");
7958       Write_Eol;
7959
7960       if No (Id) then
7961          Write_Str ("-- none --");
7962          Write_Eol;
7963
7964       else
7965          while Present (Id) loop
7966             Write_Entity_Info (Id, " ");
7967             Next_Entity (Id);
7968          end loop;
7969       end if;
7970
7971       if Scope (Current_Scope) = Standard_Standard then
7972
7973          --  Print information on the current unit itself
7974
7975          Write_Entity_Info (Current_Scope, " ");
7976       end if;
7977
7978       Write_Eol;
7979    end Write_Info;
7980
7981    --------
7982    -- ws --
7983    --------
7984
7985    procedure ws is
7986       S : Entity_Id;
7987    begin
7988       for J in reverse 1 .. Scope_Stack.Last loop
7989          S :=  Scope_Stack.Table (J).Entity;
7990          Write_Int (Int (S));
7991          Write_Str (" === ");
7992          Write_Name (Chars (S));
7993          Write_Eol;
7994       end loop;
7995    end ws;
7996
7997 end Sem_Ch8;