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 --                                                                          --
  10 --        Copyright (C) 1992,1993,1994 Free Software Foundation, Inc.       --
  11 --                                                                          --
  12 -- GNAT is free software;  you can  redistribute it  and/or modify it under --
  13 -- terms of the  GNU General Public License as published  by the Free Soft- --
  14 -- ware  Foundation;  either version 2,  or (at your option) any later ver- --
  15 -- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
  16 -- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
  17 -- or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License --
  18 -- for  more details.  You should have  received  a copy of the GNU General --
  19 -- Public License  distributed with GNAT;  see file COPYING.  If not, write --
  20 -- to  the Free Software Foundation,  59 Temple Place - Suite 330,  Boston, --
  21 -- MA 02111-1307, USA.                                                      --
  22 --                                                                          --
  23 -- GNAT was originally developed  by the GNAT team at  New York University. --
  24 -- Extensive contributions were provided by Ada Core Technologies Inc.      --
  25 --                                                                          --
  26 ------------------------------------------------------------------------------
  27
  28 with Types; use Types;
  29 package Sem_Ch7  is
  30
  31    procedure Analyze_Package_Body                       (N : Node_Id);
  32    procedure Analyze_Package_Declaration                (N : Node_Id);
  33    procedure Analyze_Package_Specification              (N : Node_Id);
  34    procedure Analyze_Private_Type_Declaration           (N : Node_Id);
  35
  36    procedure End_Package_Scope (P : Entity_Id);
  37    --  Calls Uninstall_Declarations, and then pops the scope stack.
  38
  39    procedure Exchange_Declarations (Id : Entity_Id);
  40    --  Exchange private and full declaration on entry/exit from a package
  41    --  declaration or body. The semantic links of the respective nodes
  42    --  are preserved in the exchange.
  43
  44    procedure Install_Visible_Declarations (P : Entity_Id);
  45    procedure Install_Private_Declarations (P : Entity_Id);
  46
  47    --  On entrance to a package body, make declarations in package spec
  48    --  immediately visible.
  49
  50    --  When compiling the body of a package,  both routines are called in
  51    --  succession. When compiling the body of a child package, the call
  52    --  to Install_Private_Declaration is immediate for private children,
  53    --  but is deffered until the compilation of the  private part of the
  54    --  child for public child packages.
  55
  56    procedure Install_Package_Entity (Id : Entity_Id);
  57    --  Basic procedure for the previous two. Places one entity on its
  58    --  visibility chain, and recurses on the visible part if the entity
  59    --  is an inner package.
  60
  61    function Unit_Requires_Body (P : Entity_Id) return Boolean;
  62    --  Check if a unit requires a body. A specification requires a body
  63    --  if it contains declarations that require completion in a body.
  64
  65    procedure May_Need_Implicit_Body (E : Entity_Id);
  66    --  If a package declaration contains tasks and does not require a
  67    --  body, create an implicit body at the end of the current declarative
  68    --  part to activate those tasks.
  69
  70    function Is_Fully_Visible (Type_Id : Entity_Id) return Boolean;
  71    --  Indicates whether the Full Declaration of a private type is visible.
  72
  73    procedure New_Private_Type (N : Node_Id; Id : Entity_Id; Def : Node_Id);
  74    --  Common processing for private type declarations and for formal
  75    --  private type declarations. For private types, N and Def are the type
  76    --  declaration node; for formal private types, Def is the formal type
  77    --  definition.
  78
  79    procedure Uninstall_Declarations (P : Entity_Id);
  80    --  At the end of a package declaration or body, declarations in the
  81    --  visible part are no longer immediately visible, and declarations in
  82    --  the private part are not visible at all. For inner packages, place
  83    --  visible entities at the end of their homonym chains. For compilation
  84    --  units, make all entities invisible. In both cases, exchange private
  85    --  and visible declarations to restore order of elaboration.
  86 end Sem_Ch7;