annotate gcc/ada/sem_scil.ads @ 158:494b0b89df80 default tip

...
author Shinji KONO <kono@ie.u-ryukyu.ac.jp>
date Mon, 25 May 2020 18:13:55 +0900
parents 1830386684a0
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
111
kono
parents:
diff changeset
1 ------------------------------------------------------------------------------
kono
parents:
diff changeset
2 -- --
kono
parents:
diff changeset
3 -- GNAT COMPILER COMPONENTS --
kono
parents:
diff changeset
4 -- --
kono
parents:
diff changeset
5 -- S E M _ S C I L --
kono
parents:
diff changeset
6 -- --
kono
parents:
diff changeset
7 -- S p e c --
kono
parents:
diff changeset
8 -- --
145
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
9 -- Copyright (C) 2009-2019, Free Software Foundation, Inc. --
111
kono
parents:
diff changeset
10 -- --
kono
parents:
diff changeset
11 -- GNAT is free software; you can redistribute it and/or modify it under --
kono
parents:
diff changeset
12 -- terms of the GNU General Public License as published by the Free Soft- --
kono
parents:
diff changeset
13 -- ware Foundation; either version 3, or (at your option) any later ver- --
kono
parents:
diff changeset
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
kono
parents:
diff changeset
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
kono
parents:
diff changeset
16 -- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
kono
parents:
diff changeset
17 -- for more details. You should have received a copy of the GNU General --
kono
parents:
diff changeset
18 -- Public License distributed with GNAT; see file COPYING3. If not, go to --
kono
parents:
diff changeset
19 -- http://www.gnu.org/licenses for a complete copy of the license. --
kono
parents:
diff changeset
20 -- --
kono
parents:
diff changeset
21 -- GNAT was originally developed by the GNAT team at New York University. --
kono
parents:
diff changeset
22 -- Extensive contributions were provided by Ada Core Technologies Inc. --
kono
parents:
diff changeset
23 -- --
kono
parents:
diff changeset
24 ------------------------------------------------------------------------------
kono
parents:
diff changeset
25
kono
parents:
diff changeset
26 -- This package contains routines involved in the frontend addition and
kono
parents:
diff changeset
27 -- verification of SCIL nodes.
kono
parents:
diff changeset
28
kono
parents:
diff changeset
29 with Atree; use Atree;
kono
parents:
diff changeset
30 with Types; use Types;
kono
parents:
diff changeset
31
kono
parents:
diff changeset
32 package Sem_SCIL is
kono
parents:
diff changeset
33
kono
parents:
diff changeset
34 -- SCIL (Statically Checkable Intermediate Language) is produced by the
kono
parents:
diff changeset
35 -- CodePeer back end (aka gnat2scil). For some constructs (tagged type
kono
parents:
diff changeset
36 -- declarations, dispatching calls, classwide membership tests), the
kono
parents:
diff changeset
37 -- CodePeer back end needs to locate certain nodes in the tree. To allow
kono
parents:
diff changeset
38 -- CodePeer to do this without introducing unwanted dependencies on the
kono
parents:
diff changeset
39 -- details of the FE's expansion strategies, SCIL_Nodes are generated.
kono
parents:
diff changeset
40
kono
parents:
diff changeset
41 -- For example, a dispatching call in the Ada source will, if CodePeer mode
kono
parents:
diff changeset
42 -- is enabled, result in the FE's generation of an N_Scil_Dispatching_Call
kono
parents:
diff changeset
43 -- node decorated with semantic attributes which identify the call itself,
kono
parents:
diff changeset
44 -- the primitive operation being called, the tagged type to which the
kono
parents:
diff changeset
45 -- operation belongs, and the controlling tag value of the call. If the FE
kono
parents:
diff changeset
46 -- implements some new expansion strategy for dispatching calls but this
kono
parents:
diff changeset
47 -- interface is preserved, the CodePeer back end should be unaffected.
kono
parents:
diff changeset
48
kono
parents:
diff changeset
49 function Check_SCIL_Node (N : Node_Id) return Traverse_Result;
kono
parents:
diff changeset
50 -- Process a single node during the tree traversal. Done to verify that
kono
parents:
diff changeset
51 -- SCIL nodes decoration fulfill the requirements of the SCIL backend.
kono
parents:
diff changeset
52
kono
parents:
diff changeset
53 procedure Check_SCIL_Nodes is new Traverse_Proc (Check_SCIL_Node);
kono
parents:
diff changeset
54 -- The traversal procedure itself
kono
parents:
diff changeset
55
kono
parents:
diff changeset
56 function First_Non_SCIL_Node (L : List_Id) return Node_Id;
kono
parents:
diff changeset
57 -- Returns the first non-SCIL node of list L
kono
parents:
diff changeset
58
kono
parents:
diff changeset
59 function Next_Non_SCIL_Node (N : Node_Id) return Node_Id;
kono
parents:
diff changeset
60 -- N must be a member of a list. Returns the next non SCIL node in the list
kono
parents:
diff changeset
61 -- containing N, or Empty if this is the last non SCIL node in the list.
kono
parents:
diff changeset
62
kono
parents:
diff changeset
63 end Sem_SCIL;