/usr/share/doc/gnat-gps/html/Call-Graph.html is in gnat-gps-doc 5.0-16.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (C) 2002-2010 AdaCore.
This document is free; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This document is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, see http://www.gnu.org/licenses/.
A copy of the license is included in the section entitled
"GNU General Public License". -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>Using the GNAT Programming Studio: Call Graph</title>
<meta name="description" content="Using the GNAT Programming Studio: Call Graph">
<meta name="keywords" content="Using the GNAT Programming Studio: Call Graph">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Index-table.html#Index-table" rel="index" title="Index table">
<link href="Source-Browsing.html#Source-Browsing" rel="up" title="Source Browsing">
<link href="Dependency-Browser.html#Dependency-Browser" rel="next" title="Dependency Browser">
<link href="General-Issues.html#General-Issues" rel="previous" title="General Issues">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
pre.smallexample {background-color:rgb(240,240,240);
font-family: courier new,courier,fixed;
font-size: 14px;
margin: 0px 40px 0px 40px;
border-width: 1px 2px 2px 1px;
border-top-style: dotted;
border-left-style: dotted;
border-right-style: solid;
border-bottom-style: solid;
border-color: black;}
code {color:black;
font-family: courier new,courier,fixed;
font-size: 14px;}
body {font-family: arial,helvetica,sans-serif;
font-size: 16px;
max-width: 800px;
text-align: justify}
samp {font-family: courier new,courier,fixed;
font-size: 14px}
-->
</style>
</head>
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Call-Graph"></a>
<div class="header">
<p>
Next: <a href="Dependency-Browser.html#Dependency-Browser" accesskey="n" rel="next">Dependency Browser</a>, Previous: <a href="General-Issues.html#General-Issues" accesskey="p" rel="previous">General Issues</a>, Up: <a href="Source-Browsing.html#Source-Browsing" accesskey="u" rel="up">Source Browsing</a> [<a href="Index-table.html#Index-table" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Call-Graph-1"></a>
<h3 class="section">10.2 Call Graph</h3>
<a name="index-call-graph-4"></a>
<p>The call graph shows graphically the relationship between subprogram
callers and callees. A link between two items indicate that one of
them is calling the other.
</p>
<a name="index-renaming-entities"></a>
<p>A special handling is provided for renaming entities (in Ada): if a
subprogram is a renaming of another one, both items will be displayed
in the browser, with a special hashed link between the two. Since the
renaming subprogram doesn’t have a proper body, you will then need to
ask for the subprograms called by the renamed to get the list.
</p>
<a name="index-screen-shot-31"></a>
<img src="call-graph.jpg" alt="call-graph">
<p>In this browser, clicking on the right arrow in the title bar will
display all the entities that are called by the selected item.
</p>
<p>Clicking on the left arrow will display all the entities that call the
selected item (i.e. its callers).
</p>
<p>This browser is accessible through the contextual menu in the project
view and source editor, by selecting one of the items:
</p>
<p>All boxes in this browser list several information: the location of their
declaration, and the list of all their references in the other entities
currently displayed in the browser. If you close the box for an entity that
calls them, the matching references are also hidden, to keep the contents
of the browser simpler.
</p>
<dl compact="compact">
<dt><code>Browsers-><i>Entity</i> calls</code></dt>
<dd><p>Display all the entities called by the selected entity. This has the
same effect as clicking on the right title bar arrow if the item is
already present in the call graph.
</p>
</dd>
<dt><code>Browsers-><i>Entity</i> is called by</code></dt>
<dd><p>Display all the entities called by the selected entity. This has the
same effect as clicking on the left title bar arrow if the item is
already present in the call graph.
</p></dd>
</dl>
<p>The contextual menu available by right-clicking on the entities in the
browser has the following new entries, in addition to the ones added by
other modules of GPS.
</p>
<dl compact="compact">
<dt><code><i>Entity</i> calls</code></dt>
<dd><p>Same as described above.
</p>
</dd>
<dt><code><i>Entity</i> is called by</code></dt>
<dd><p>Same as described above.
</p>
</dd>
<dt><code>Go To Spec</code></dt>
<dd><p>Selecting this item will open a source editor that displays the
declaration of the entity.
</p>
</dd>
<dt><code>Go To Body</code></dt>
<dd><p>Selecting this item will open a source editor that displays the
body of the entity.
</p>
</dd>
<dt><code>Locate in Project View</code></dt>
<dd><p>Selecting this menu entry will move the focus to the project view,
and select the first node representing the file in which the entity is
declared. This makes it easier to see which other entities are
declared in the same file.
</p></dd>
</dl>
<hr>
<div class="header">
<p>
Next: <a href="Dependency-Browser.html#Dependency-Browser" accesskey="n" rel="next">Dependency Browser</a>, Previous: <a href="General-Issues.html#General-Issues" accesskey="p" rel="previous">General Issues</a>, Up: <a href="Source-Browsing.html#Source-Browsing" accesskey="u" rel="up">Source Browsing</a> [<a href="Index-table.html#Index-table" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|