gnat-gps-doc 5.0-6 / usr / share / doc / gnat-gps / html / The-Locations-View.html

This file is indexed.

/usr/share/doc/gnat-gps/html/The-Locations-View.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
<html lang="en">
<head>
<title>The Locations View - 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="Description-of-the-Main-Windows.html#Description-of-the-Main-Windows" title="Description of the Main Windows">
<link rel="prev" href="The-Shell-and-Python-Windows.html#The-Shell-and-Python-Windows" title="The Shell and Python Windows">
<link rel="next" href="The-Execution-Window.html#The-Execution-Window" title="The Execution Window">
<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="The-Locations-View"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="The-Execution-Window.html#The-Execution-Window">The Execution Window</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="The-Shell-and-Python-Windows.html#The-Shell-and-Python-Windows">The Shell and Python Windows</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Description-of-the-Main-Windows.html#Description-of-the-Main-Windows">Description of the Main Windows</a>
<hr>
</div>

<h3 class="section">2.16 The Locations View</h3>

<p><a name="index-location-77"></a><a name="index-locations-view-78"></a><!--  -->

   <p><a name="index-search-79"></a><a name="index-compilation-80"></a><a name="index-build-81"></a>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-82"></a><img src="locations-view.jpg" alt="locations-view.jpg">

   <p><a name="index-category-83"></a><a name="index-file-84"></a>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>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>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-85"></a><a name="index-menu-86"></a>To navigate through the next and previous location (also called <code>Tag</code>),
you can use the menu items <code>Navigate-&gt;Previous Tag</code> and
<code>Navigate-&gt;Next Tag</code>, or the corresponding key bindings.

   <p>Left-clicking on a line in the Location Tree brings up a contextual
menu with the following entries:

     <dl>
<dt><b>Filter panel</b><dd>Controls availability of the filter panel at the bottom of the window.

     <br><dt><b>Sort by subcategory</b><dd>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.

     <br><dt><b>Expand category</b><dd>Expand all the files in the current categories.

     <br><dt><b>Collapse all</b><dd>Collapse all the categories in the Locations View

     <br><dt><b>Remove category/file/message</b><dd>Remove the selected category, file or message from the Locations View. 
Selected message can be removed using <code>Locations view-&gt;Remove message</code>
key binding also.

     <br><dt><b>Jump to location</b><dd>Open the location contained in the message, if any.

     <br><dt><b>Clear Locations View</b><dd>Remove all entries from the Locations View.

   </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>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.

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

APT Browse - Built by Thomas Orozco.