gcc/ada/sem_ch7.ads

   1 ------------------------------------------------------------------------------
   2 --                                                                          --
   3 --                         GNAT COMPILER COMPONENTS                         --
   4 --                                                                          --
   5 --                              S E M _ C H 7                               --
   6 --                                                                          --
   7 --                                 S p e c                                  --
   8 --                                                                          --
   9 --          Copyright (C) 1992-2007, Free Software Foundation, Inc.         --
  10 --                                                                          --
  11 -- GNAT is free software;  you can  redistribute it  and/or modify it under --
  12 -- terms of the  GNU General Public License as published  by the Free Soft- --
  13 -- ware  Foundation;  either version 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 Types; use Types;
  27
  28 package Sem_Ch7 is
  29
  30    procedure Analyze_Package_Body                       (N : Node_Id);
  31    procedure Analyze_Package_Declaration                (N : Node_Id);
  32    procedure Analyze_Package_Specification              (N : Node_Id);
  33    procedure Analyze_Private_Type_Declaration           (N : Node_Id);
  34
  35    procedure End_Package_Scope (P : Entity_Id);
  36    --  Calls Uninstall_Declarations, and then pops the scope stack
  37
  38    procedure Exchange_Declarations (Id : Entity_Id);
  39    --  Exchange private and full declaration on entry/exit from a package
  40    --  declaration or body. The semantic links of the respective nodes
  41    --  are preserved in the exchange.
  42
  43    procedure Install_Visible_Declarations (P : Entity_Id);
  44    procedure Install_Private_Declarations (P : Entity_Id);
  45
  46    --  On entrance to a package body, make declarations in package spec
  47    --  immediately visible.
  48
  49    --  When compiling the body of a package,  both routines are called in
  50    --  succession. When compiling the body of a child package, the call
  51    --  to Install_Private_Declaration is immediate for private children,
  52    --  but is deferred until the compilation of the  private part of the
  53    --  child for public child packages.
  54
  55    function Unit_Requires_Body (P : Entity_Id) return Boolean;
  56    --  Check if a unit requires a body. A specification requires a body
  57    --  if it contains declarations that require completion in a body.
  58
  59    procedure May_Need_Implicit_Body (E : Entity_Id);
  60    --  If a package declaration contains tasks or RACWs and does not require
  61    --  a body, create an implicit body at the end of the current declarative
  62    --  part to activate those tasks or contain the bodies for the RACW
  63    --  calling stubs.
  64
  65    procedure New_Private_Type (N : Node_Id; Id : Entity_Id; Def : Node_Id);
  66    --  Common processing for private type declarations and for formal
  67    --  private type declarations. For private types, N and Def are the type
  68    --  declaration node; for formal private types, Def is the formal type
  69    --  definition.
  70
  71    procedure Uninstall_Declarations (P : Entity_Id);
  72    --  At the end of a package declaration or body, declarations in the
  73    --  visible part are no longer immediately visible, and declarations in
  74    --  the private part are not visible at all. For inner packages, place
  75    --  visible entities at the end of their homonym chains. For compilation
  76    --  units, make all entities invisible. In both cases, exchange private
  77    --  and visible declarations to restore order of elaboration.
  78
  79 end Sem_Ch7;