gnat-gps-doc 5.0-6 / usr / share / doc / gnat-gps / html / General-Issues.html

This file is indexed.

/usr/share/doc/gnat-gps/html/General-Issues.html is in gnat-gps-doc 5.0-6.

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
<html lang="en">
<head>
<title>General Issues - Using the GNAT Programming Studio</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Using the GNAT Programming Studio">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Source-Browsing.html#Source-Browsing" title="Source Browsing">
<link rel="next" href="Call-Graph.html#Call-Graph" title="Call Graph">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
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 3 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/'.-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
  pre.display { font-family:inherit }
  pre.format  { font-family:inherit }
  pre.smalldisplay { font-family:inherit; font-size:smaller }
  pre.smallformat  { font-family:inherit; font-size:smaller }
  pre.smallexample { font-size:smaller }
  pre.smalllisp    { font-size:smaller }
  span.sc    { font-variant:small-caps }
  span.roman { font-family:serif; font-weight:normal; } 
  span.sansserif { font-family:sans-serif; font-weight:normal; } 
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>
<div class="node">
<a name="General-Issues"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="Call-Graph.html#Call-Graph">Call Graph</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Source-Browsing.html#Source-Browsing">Source Browsing</a>
<hr>
</div>

<h3 class="section">10.1 General Issues</h3>

<!--  -->
<p class="noindent">GPS contains several kinds of browsers, that have a common set of
basic functionalities. There are currently four such browsers: the
project browser (see <a href="The-Project-Browser.html#The-Project-Browser">The Project Browser</a>), the call graph
(see <a href="Call-Graph.html#Call-Graph">Call Graph</a>), the dependency browser (see <a href="Dependency-Browser.html#Dependency-Browser">Dependency Browser</a>) and the entity browser (see <a href="Entity-Browser.html#Entity-Browser">Entity Browser</a>).

   <p>All these browsers are interactive viewers. They contain a number of
items, whose visual representation depends on the type of information
displayed in the browser (they can be projects, files, entities, <small class="dots">...</small>).

   <p>In addition, the following capabilities are provided in all browsers:

     <dl>
<dt><b>Scrolling</b><dd>When a lot of items are displayed in the canvas, the currently visible
area might be too small to display all of them. In this case,
scrollbars will be added on the sides, so that you can make other
items visible. Scrolling can also be done with the arrow keys.

     <br><dt><b>Layout</b><dd>A basic layout algorithm is used to organize the items. This algorithm
is layer oriented: items with no parents are put in the first layer,
then their direct children are put in the second layer, and so
on. Depending on the type of browser, these layers are organized
either vertically or horizontally. This algorithm tries to preserve as
much as possible the positions of the items that were moved
interactively.

     <p>The <code>Refresh layout</code> menu item in the background contextual menu
can be used to recompute the layout of items at any time, even for
items that were previously moved interactively.

     <br><dt><b>Interactive moving of items</b><dd>Items can be moved interactively with the mouse. Click and drag the
item by clicking on its title bar. The links will still be displayed
during the move, so that you can check whether it overlaps any other
item. If you are trying to move the item outside of the visible part
of the browser, the latter will be scrolled.

     <br><dt><b>Links</b><dd>Items can be linked together, and will remain connected when items are
moved. Different types of links exist, see the description of the
various browsers.

     <p>By default, links are displayed as straight lines. You can choose to
use orthogonal links instead, which are displayed only with vertical
or horizontal lines. Select the entry <code>orthogonal links</code> in the
background contextual menu.

     <br><dt><b>Exporting</b><dd><a name="index-export-434"></a><a name="index-image-435"></a><a name="index-png-436"></a><a name="index-svg-437"></a>The entire contents of a browser can be exported as a <code>PNG</code> image
using the entry <code>Export to PNG...</code> in the background contextual menu. 
It can also be exported in <code>SVG</code> format using the <code>Export to SVG...</code>
entry.

     <br><dt><b>Zooming</b><dd>Several different zoom levels are available. The contextual menu in
the background of the browser contains three entries: <code>zoom in</code>,
<code>zoom out</code> and <code>zoom</code>. The latter is used to select directly
the zoom level you want.

     <p>This zooming capability is generally useful when lots of items are
displayed in the browser, to get a more general view of the layout and
the relationships between the items.

     <br><dt><b>Selecting items</b><dd>Items can be selected by clicking inside them. Multiple items can be
selected by holding the &lt;control&gt; key while clicking in the
item. Alternatively, you can click and drag the mouse inside the
background of the browser. All the items found in the selection
rectangle when the mouse is released will be selected.

     <p>Selected items are drawn with a different title bar color. All items
linked to them also use a different title bar color, as well as the
links. This is the most convenient way to understand the relationships
between items when lots of them are present in the browser.

     <br><dt><b>Hyper-links</b><dd>Some of the items will contain hyper links, displayed in blue by
default, and underlined. Clicking on these will generally display new
items.

   </dl>

   <p>Two types of contextual menus are available in the browsers: the
background contextual menu is available by right-clicking in the
background area (i.e. outside of any item). As described above, it
contains entries for the zooming, selecting of orthogonal links, and
refresh; the second kind of contextual menu is available by
right-clicking in items.

   <p>The latter menu contains various entries. Most of the entries are
added by various modules in GPS (VCS module, source
editor, <small class="dots">...</small>). In addition, each kind of browser also has some specific
entries, which is described in the corresponding browser's section.

   <p>There are two common items in all item contextual menus:

     <dl>
<dt><samp><span class="command">Hide Links</span></samp><dd>Browsers can become confusing if there are many items and many
links. You can lighten them by selecting this menu entry. As
a result, the item will remain in the canvas, but none of the links to
or from it will be visible. Selecting the item will still
highlight linked items, so that this information remains available.

     <br><dt><samp><span class="command">Remove unselected items</span></samp><dd>Selecting this menu will remove all the items that are not currently
selected. This is a convenient method to clean up the contents of the
browser.

     <br><dt><samp><span class="command">Remove selected items</span></samp><dd>Selecting this menu will remove all the items that are currently selected.

   </dl>

<!--  -->
   </body></html>

APT Browse - Built by Thomas Orozco.