annotate gcc/ada/bindo-augmentors.ads @ 145:1830386684a0

gcc-9.2.0
author anatofuz
date Thu, 13 Feb 2020 11:34:05 +0900
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
145
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
1 ------------------------------------------------------------------------------
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
2 -- --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
3 -- GNAT COMPILER COMPONENTS --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
4 -- --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
5 -- B I N D O . A U G M E N T O R S --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
6 -- --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
7 -- S p e c --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
8 -- --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
9 -- Copyright (C) 2019, Free Software Foundation, Inc. --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
10 -- --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
11 -- GNAT is free software; you can redistribute it and/or modify it under --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
12 -- terms of the GNU General Public License as published by the Free Soft- --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
13 -- ware Foundation; either version 3, or (at your option) any later ver- --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
16 -- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
17 -- for more details. You should have received a copy of the GNU General --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
18 -- Public License distributed with GNAT; see file COPYING3. If not, go to --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
19 -- http://www.gnu.org/licenses for a complete copy of the license. --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
20 -- --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
21 -- GNAT was originally developed by the GNAT team at New York University. --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
22 -- Extensive contributions were provided by Ada Core Technologies Inc. --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
23 -- --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
24 ------------------------------------------------------------------------------
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
25
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
26 -- For full architecture, see unit Bindo.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
27
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
28 -- The following unit contains facilities to enhance the library graph, which
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
29 -- reflects source dependencies between units, with information obtained from
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
30 -- the invocation graph, which reflects all activations of tasks, calls, and
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
31 -- instantiations within units.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
32
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
33 with Bindo.Graphs;
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
34 use Bindo.Graphs;
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
35 use Bindo.Graphs.Invocation_Graphs;
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
36 use Bindo.Graphs.Library_Graphs;
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
37
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
38 package Bindo.Augmentors is
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
39
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
40 ------------------------------
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
41 -- Library_Graph_Augmentors --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
42 ------------------------------
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
43
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
44 package Library_Graph_Augmentors is
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
45 procedure Augment_Library_Graph
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
46 (Inv_Graph : Invocation_Graph;
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
47 Lib_Graph : Library_Graph);
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
48 -- Augment library graph Lib_Graph with information from invocation
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
49 -- graph Inv_Graph as follows:
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
50 --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
51 -- 1) Traverse the invocation graph starting from each elaboration
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
52 -- procedure of unit Root.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
53 --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
54 -- 2) Each time the traversal transitions from one unit into another
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
55 -- unit Curr, add an invocation edge between predecessor Curr and
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
56 -- successor Root in the library graph.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
57 --
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
58 -- 3) Do the above steps for all units with an elaboration procedure.
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
59
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
60 end Library_Graph_Augmentors;
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
61
1830386684a0 gcc-9.2.0
anatofuz
parents:
diff changeset
62 end Bindo.Augmentors;