home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-dist / gnat-2.06-src.tgz / tar.out / fsf / gnat / ada / sem_ch12.ads < prev    next >
Text File  |  1996-09-28  |  5KB  |  86 lines
  1. ------------------------------------------------------------------------------
  2. --                                                                          --
  3. --                         GNAT COMPILER COMPONENTS                         --
  4. --                                                                          --
  5. --                             S E M _ C H 1 2                              --
  6. --                                                                          --
  7. --                                 S p e c                                  --
  8. --                                                                          --
  9. --                            $Revision: 1.8 $                              --
  10. --                                                                          --
  11. --           Copyright (c) 1992,1993,1994 NYU, All Rights Reserved          --
  12. --                                                                          --
  13. -- GNAT is free software;  you can  redistribute it  and/or modify it under --
  14. -- terms of the  GNU General Public License as published  by the Free Soft- --
  15. -- ware  Foundation;  either version 2,  or (at your option) any later ver- --
  16. -- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
  17. -- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
  18. -- or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License --
  19. -- for  more details.  You should have  received  a copy of the GNU General --
  20. -- Public License  distributed with GNAT;  see file COPYING.  If not, write --
  21. -- to the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. --
  22. --                                                                          --
  23. ------------------------------------------------------------------------------
  24.  
  25. with Types; use Types;
  26.  
  27. package Sem_Ch12 is
  28.    procedure Analyze_Generic_Package_Declaration        (N : Node_Id);
  29.    procedure Analyze_Generic_Subprogram_Declaration     (N : Node_Id);
  30.    procedure Analyze_Package_Instantiation              (N : Node_Id);
  31.    procedure Analyze_Procedure_Instantiation            (N : Node_Id);
  32.    procedure Analyze_Function_Instantiation             (N : Node_Id);
  33.    procedure Analyze_Formal_Object_Declaration          (N : Node_Id);
  34.    procedure Analyze_Formal_Type_Declaration            (N : Node_Id);
  35.    procedure Analyze_Formal_Subprogram                  (N : Node_Id);
  36.    procedure Analyze_Formal_Package                     (N : Node_Id);
  37.  
  38.    function Copy_Generic_Node
  39.      (N             : Node_Id;
  40.       Parent_Id     : Node_Id;
  41.       Instantiating : Boolean)
  42.       return          Node_Id;
  43.    --  Copy the tree for a generic unit or its body. The unit is copied
  44.    --  repeatedly: once to produce a copy on which semantic analysis of
  45.    --  the generic is performed, and once for each instantiation. The tree
  46.    --  being copied is not semantically analyzed, except that references to
  47.    --  global entities are marked on terminal nodes.
  48.  
  49.    procedure Instantiate_Package_Body
  50.      (N        : Node_Id;
  51.       Act_Decl : Node_Id);
  52.    --  Called after semantic analysis, to complete the instantiation of
  53.    --  package bodies. In this fashion complex cross-dependencies between
  54.    --  several package declarations and bodies containing generics can
  55.    --  be compiled which otherwise would diagnose spurious circularities.
  56.    --  For example, it is possible to compile two packages A and B that
  57.    --  have the follwing structure:
  58.    --
  59.    --    package A is                         package B is
  60.    --       generic ...                          generic ...
  61.    --       package G_A is                       package G_B is
  62.    --
  63.    --    with B;                              with A;
  64.    --    package body A is                    package body B is
  65.    --       package N_B is new G_B (..)          package N_A is new G_A (..)
  66.  
  67.    procedure Instantiate_Subprogram_Body
  68.      (N        : Node_Id;
  69.       Act_Decl : Node_Id);
  70.    --  Called after semantic analysis to complete the instantiation of
  71.    --  subprogram bodies.
  72.  
  73.    procedure Save_Global_References (N : Node_Id);
  74.    --  Traverse the original generic unit, and capture all references to
  75.    --  entities that are defined outside of the generic in the analyzed
  76.    --  tree for the template. These references are copied into the original
  77.    --  tree, so that they appear automatically in  every instantiation.
  78.    --  A critical invariant in this approach is that if an id in the generic
  79.    --  resolves to a local entity, the corresponding id in the instance
  80.    --  will resolve to the homologous entity in the instance, even though
  81.    --  the enclosing context for resolution is different,  as long as the
  82.    --  global references have been captured as described here.
  83.  
  84.  
  85. end Sem_Ch12;
  86.