OSDN Git Service

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