/usr/share/doc/gnat-gps/html/The-Callgraph-View.html

<!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: The Callgraph View</title>

<meta name="description" content="Using the GNAT Programming Studio: The Callgraph View">
<meta name="keywords" content="Using the GNAT Programming Studio: The Callgraph View">
<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="Description-of-the-Main-Windows.html#Description-of-the-Main-Windows" rel="up" title="Description of the Main Windows">
<link href="Bookmarks.html#Bookmarks" rel="next" title="Bookmarks">
<link href="The-Clipboard-View.html#The-Clipboard-View" rel="previous" title="The Clipboard View">
<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="The-Callgraph-View"></a>
<div class="header">
<p>
Next: <a href="Bookmarks.html#Bookmarks" accesskey="n" rel="next">Bookmarks</a>, Previous: <a href="The-Clipboard-View.html#The-Clipboard-View" accesskey="p" rel="previous">The Clipboard View</a>, Up: <a href="Description-of-the-Main-Windows.html#Description-of-the-Main-Windows" accesskey="u" rel="up">Description of the Main Windows</a> &nbsp; [<a href="Index-table.html#Index-table" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="The-Callgraph-View-1"></a>
<h3 class="section">2.12 The Callgraph View</h3>
<a name="index-callgraph"></a>

<p>The callgraph view plays a role similar the callgraph browser. They display
the same information about entities, but in two different ways: the callgraph
view displays the information in a tree, easily navigable and perhaps easier
to manipulate when lots of entities are involved; the callgraph browser
displays the information as graphical boxes that can be manipulated on the
screen, and is best suited to generate a diagram that can be later exported
to your own documents.
</p>
<p>This callgraph view is used to display the information about what subprograms
are called by a given entity, and, opposite, what entities are calling a
given entity.
</p>
<p>Some references might be reported with an additional &quot; (dispatching)&quot; text.
In such a case, this indicates that the call to the entity is not explicit
in the sources, but could occur through dynamic dispatching. This of course
depends on what arguments are passed to the caller at run time, and it is
possible that the subprogram is in fact never dispatched to.
</p>
<p>This view is automatically displayed when you select one of the contextual
menus <code>... calls</code> and <code>... is called by</code>. Every time you
select one of these menus, a new view is opened to display that entity.
</p>
<p>Whenever you expand a node from the tree by clicking on the small expander
arrow on the left of the line, further callgraph information is computed for
the selected entity, which makes it very easy to get information for a full
callgraph tree.
</p>
<p>Closing and expanding a node again will recompute the callgraph for the
entity.
</p>
<p>On the right side of the main tree, a list displays the locations of calls for
the selected entity. Clicking on entries in this list opens editors showing
the corresponding location.
</p>
<p>The Callgraph View supports keyboard navigation: <code>Up</code> and <code>Down</code>
keys navigate between listed locations, <code>Left</code> collapses the current
level, <code>Right</code> expands the current level, and <code>Return</code> jumps to the
currently selected location.
</p>
<p>The callgraph view is automatically saved in the desktop, and restored
the next time you restart GPS. However, the information displayed in these
might no longer be accurate at this stage, since it shows the status of the
callgraph during the last GPS session.
</p>
<p>Left-clicking on a line in the Call Tree brings up a contextual
menu with the following entries:
</p>
<dl compact="compact">
<dt><b>Collapse all</b></dt>
<dd><p>Collapse all the entities in the Callgraph View.
</p>
</dd>
<dt><b>Remove entity</b></dt>
<dd><p>Remove the selected entity from the Callgraph View.
</p>
</dd>
<dt><b>Clear Call Trees</b></dt>
<dd><p>Remove all entries from the Callgraph View.
</p>
</dd>
</dl>

<hr>
<div class="header">
<p>
Next: <a href="Bookmarks.html#Bookmarks" accesskey="n" rel="next">Bookmarks</a>, Previous: <a href="The-Clipboard-View.html#The-Clipboard-View" accesskey="p" rel="previous">The Clipboard View</a>, Up: <a href="Description-of-the-Main-Windows.html#Description-of-the-Main-Windows" accesskey="u" rel="up">Description of the Main Windows</a> &nbsp; [<a href="Index-table.html#Index-table" title="Index" rel="index">Index</a>]</p>
</div>



</body>
</html>
gnat-gps-doc 5.0-16 / usr / share / doc / gnat-gps / html / The-Callgraph-View.html
