/usr/share/doc/gnat-gps/html/The-Locations-View.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 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 | <!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 Locations View</title>
<meta name="description" content="Using the GNAT Programming Studio: The Locations View">
<meta name="keywords" content="Using the GNAT Programming Studio: The Locations 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="The-Execution-Window.html#The-Execution-Window" rel="next" title="The Execution Window">
<link href="The-Shell-and-Python-Windows.html#The-Shell-and-Python-Windows" rel="previous" title="The Shell and Python Windows">
<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-Locations-View"></a>
<div class="header">
<p>
Next: <a href="The-Execution-Window.html#The-Execution-Window" accesskey="n" rel="next">The Execution Window</a>, Previous: <a href="The-Shell-and-Python-Windows.html#The-Shell-and-Python-Windows" accesskey="p" rel="previous">The Shell and Python Windows</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> [<a href="Index-table.html#Index-table" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="The-Locations-View-1"></a>
<h3 class="section">2.16 The Locations View</h3>
<a name="index-location"></a>
<a name="index-locations-view"></a>
<a name="index-search-1"></a>
<a name="index-compilation"></a>
<a name="index-build-2"></a>
<p>The Location Tree is filled whenever GPS needs to display a list of
locations in the source files (typically, when performing a global
search, compilation results, and so on).
</p>
<a name="index-screen-shot-9"></a>
<img src="locations-view.jpg" alt="locations-view">
<a name="index-category"></a>
<a name="index-file-1"></a>
<p>The Locations View shows a hierarchy of categories, which contain
files, which contain locations. Clicking on a location item will bring
up a file editor at the requested place. Right-clicking on file or
category items brings up a contextual menu allowing you to remove the
corresponding node from the view. Placing the mouse over an item
automatically pop up a tooltip window with full text of the item if this
text can’t be completely shown in the window.
</p>
<p>Every time a new category is created, as a result of a compilation or a
search operation for example, the first entry of that category is
automatically selected, and the corresponding editor opened. This behavior
can be controlled through a preference <code>Jump To First Location</code>.
</p>
<p>Closing the Locations view will remove from the editors locations that
are also visible in the Locations view.
If the Locations View is present when exiting GPS and the desktop is saved,
the locations will be saved as part of the desktop for the current project,
and will be loaded the next time GPS is started on the same project.
</p>
<a name="index-key-1"></a>
<a name="index-menu"></a>
<p>To navigate through the next and previous location (also called <code>Tag</code>),
you can use the menu items <code>Navigate->Previous Tag</code> and
<code>Navigate->Next Tag</code>, or the corresponding key bindings.
</p>
<p>Left-clicking on a line in the Location Tree brings up a contextual
menu with the following entries:
</p>
<dl compact="compact">
<dt><b>Filter panel</b></dt>
<dd><p>Controls availability of the filter panel at the bottom of the window.
</p>
</dd>
<dt><b>Sort by subcategory</b></dt>
<dd><p>Toggle the sorting of the entries by sub-categories. This is useful,
for example, for separating the warnings from the errors in the build
results.
</p>
</dd>
<dt><b>Expand category</b></dt>
<dd><p>Expand all the files in the current categories.
</p>
</dd>
<dt><b>Collapse all</b></dt>
<dd><p>Collapse all the categories in the Locations View
</p>
</dd>
<dt><b>Remove category/file/message</b></dt>
<dd><p>Remove the selected category, file or message from the Locations View.
Selected message can be removed using <code>Locations view->Remove message</code>
key binding also.
</p>
</dd>
<dt><b>Jump to location</b></dt>
<dd><p>Open the location contained in the message, if any.
</p>
</dd>
<dt><b>Clear Locations View</b></dt>
<dd><p>Remove all entries from the Locations View.
</p>
</dd>
</dl>
<p>In some cases, a wrench icon will be associated on the left of a compilation
message. See <a href="Code-Fixing.html#Code-Fixing">Code Fixing</a> for more information on how to make advantage
of this icon.
</p>
<p>The filter panel can be used to filter messages which match (or do not
match) a text pattern or regular expression. As soon as you type in the text
entry, the filter is enabled. If you clear the text, the filter is disabled.
The <code>Close</code> button on the filter panel hides it and cancels the filter.
The <code>Regexp</code> check button specifies how to use the filter text entry:
as plain text or regular expression.
The <code>Hide matched</code> check button reverts the filter,
e.g. switch between matching and non-matching items.
</p>
<hr>
<div class="header">
<p>
Next: <a href="The-Execution-Window.html#The-Execution-Window" accesskey="n" rel="next">The Execution Window</a>, Previous: <a href="The-Shell-and-Python-Windows.html#The-Shell-and-Python-Windows" accesskey="p" rel="previous">The Shell and Python Windows</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> [<a href="Index-table.html#Index-table" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|