1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1992-2014, Free Software Foundation, Inc. --
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. --
21 -- GNAT was originally developed by the GNAT team at New York University. --
22 -- Extensive contributions were provided by Ada Core Technologies Inc. --
24 ------------------------------------------------------------------------------
26 with Types
; use Types
;
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
);
35 procedure Analyze_Package_Body_Contract
(Body_Id
: Entity_Id
);
36 -- Analyze all delayed aspects chained on the contract of package body
37 -- Body_Id as if they appeared at the end of a declarative region. The
38 -- aspects that are considered are:
41 procedure Analyze_Package_Contract
(Pack_Id
: Entity_Id
);
42 -- Analyze all delayed aspects chained on the contract of package Pack_Id
43 -- as if they appeared at the end of a declarative region. The aspects
44 -- that are considered are:
49 procedure End_Package_Scope
(P
: Entity_Id
);
50 -- Calls Uninstall_Declarations, and then pops the scope stack
52 procedure Exchange_Declarations
(Id
: Entity_Id
);
53 -- Exchange private and full declaration on entry/exit from a package
54 -- declaration or body. The semantic links of the respective nodes
55 -- are preserved in the exchange.
57 procedure Install_Visible_Declarations
(P
: Entity_Id
);
58 procedure Install_Private_Declarations
(P
: Entity_Id
);
60 -- On entrance to a package body, make declarations in package spec
61 -- immediately visible.
63 -- When compiling the body of a package, both routines are called in
64 -- succession. When compiling the body of a child package, the call
65 -- to Install_Private_Declaration is immediate for private children,
66 -- but is deferred until the compilation of the private part of the
67 -- child for public child packages.
69 function Unit_Requires_Body
71 Ignore_Abstract_State
: Boolean := False) return Boolean;
72 -- Determine whether package Pack_Id requires a body. A specification needs
73 -- a body if it contains declarations that require completion in the body.
74 -- A non-Ghost [generic] package does not require a body when it declares
75 -- Ghost entities exclusively. If flag Ignore_Abstract_State is True, then
76 -- the test for a non-null abstract state (which normally requires a body)
77 -- is not carried out. The flag is not currently used, but may be useful
78 -- in the future if we implement a compatibility mode which warns about
79 -- possible incompatibilities if a SPARK 2014 program is compiled with a
80 -- SPARK-unaware compiler.
82 procedure May_Need_Implicit_Body
(E
: Entity_Id
);
83 -- If a package declaration contains tasks or RACWs and does not require
84 -- a body, create an implicit body at the end of the current declarative
85 -- part to activate those tasks or contain the bodies for the RACW
88 procedure New_Private_Type
(N
: Node_Id
; Id
: Entity_Id
; Def
: Node_Id
);
89 -- Common processing for private type declarations and for formal private
90 -- type declarations. For private types, N and Def are the type declaration
91 -- node; for formal private types, Def is the formal type definition.
93 procedure Uninstall_Declarations
(P
: Entity_Id
);
94 -- At the end of a package declaration or body, declarations in the visible
95 -- part are no longer immediately visible, and declarations in the private
96 -- part are not visible at all. For inner packages, place visible entities
97 -- at the end of their homonym chains. For compilation units, make
98 -- all entities invisible. In both cases, exchange private and visible
99 -- declarations to restore order of elaboration.