/usr/share/doc/gnat-gps/html/Project-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 201 | <!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: Project View</title>
<meta name="description" content="Using the GNAT Programming Studio: Project View">
<meta name="keywords" content="Using the GNAT Programming Studio: Project 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="Project-Handling.html#Project-Handling" rel="up" title="Project Handling">
<link href="Disabling-Project-Edition-Features.html#Disabling-Project-Edition-Features" rel="next" title="Disabling Project Edition Features">
<link href="Extending-Projects.html#Extending-Projects" rel="previous" title="Extending Projects">
<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="Project-View"></a>
<div class="header">
<p>
Next: <a href="Disabling-Project-Edition-Features.html#Disabling-Project-Edition-Features" accesskey="n" rel="next">Disabling Project Edition Features</a>, Previous: <a href="Extending-Projects.html#Extending-Projects" accesskey="p" rel="previous">Extending Projects</a>, Up: <a href="Project-Handling.html#Project-Handling" accesskey="u" rel="up">Project Handling</a> [<a href="Index-table.html#Index-table" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="The-Project-View-2"></a>
<h3 class="section">7.5 The Project View</h3>
<a name="index-project-view-5"></a>
<p>The project view, as mentioned in the general description of the
GPS window, is one of the views found by default on the left
of the window. It shows in a tree structure the project hierarchy,
along with all the source files belonging to the project, and the
entities declared in the source files.
</p>
<p>It is worth noting that the project view provides a tree representation of
the project hierarchy. If a project is imported by multiple other
projects in the hierarchy, then this project will appear multiple times
in the project view.
</p>
<a name="index-limited-with"></a>
<p>Likewise, if you have edited the project manually and have used the
<code>limited with</code> construct to have cycles in the project
dependencies, the cycle will expand infinitely. For instance, if
project <samp>a</samp> imports project <samp>b</samp>, which in turns imports
project <samp>a</samp> through a <code>limited with</code> clause, then expanding
the node for <samp>a</samp> will show <samp>b</samp>. In turn, expanding the node
for <samp>b</samp> will show a node for <samp>a</samp>, and so on.
</p>
<p>The contextual menu in this project view provides a number of items to
modify the project hierarchy (what each project imports), as well as
to visualize and modify the attributes for each projects (compilation
switches, naming scheme, …)
</p>
<p>The following entries are available in the contextual menu:
</p>
<dl compact="compact">
<dt><code>Show Projects Imported by...</code></dt>
<dd><p>This item will open a new window in GPS, the project browser, which
displays graphically the relationships between each project in the
hierarchy.
</p>
</dd>
<dt><code>Save The Project...</code></dt>
<dd><a name="index-saving-projects"></a>
<p>This item can be selected to save a single project in the hierarchy
after it was modified. Modified but unsaved projects in the hierarchy
have a special icon (a pen mark is drawn on top of the
standard icon). If you would rather save all the modified projects in
a single step, use the menu bar item <code>Project->Save All</code>.
</p>
</dd>
<dt><code>Project/Properties</code></dt>
<dd><p>This item will open a new dialog, and give access to all the
attributes of the project: tool switches, naming schemes, source
directories, … See <a href="The-Project-Properties-Editor.html#The-Project-Properties-Editor">The Project Properties Editor</a>.
</p>
</dd>
<dt><code>Project/Edit source file</code></dt>
<dd><a name="index-edit-project-source-file"></a>
<p>This menu will load the project file into an editor, so that you can
manually edit it. This should be used if you need to access some
features of the project files that are not accessible graphically
(renames statements, variables, …)
</p>
</dd>
<dt><code>Project/Dependencies...</code></dt>
<dd><a name="index-project-dependency"></a>
<p>This opens the dependencies editor (see <a href="The-Project-Dependencies-Editor.html#The-Project-Dependencies-Editor">The Project Dependencies Editor</a>).
</p>
</dd>
<dt><code>Add Configuration Variable</code></dt>
<dd><a name="index-add-configuration-variable"></a>
<p>This menu item should be used to add new configuration variables, as
described in <a href="Scenarios-and-Configuration-Variables.html#Scenarios-and-Configuration-Variables">Scenarios and Configuration Variables</a>.
</p>
</dd>
<dt><code>Build</code></dt>
<dd><p>This menu offers the submenu "Clean" which remove all object files and other
compilation artifacts associated to the current project.
</p>
</dd>
</dl>
<a name="index-saving-projects-1"></a>
<p>Any time one or several projects are modified, the contents of the
project view is automatically refreshed. No project is automatically
saved. This provides a simple way to temporarily test new values for
the project attributes.
Unsaved modified projects are shown with a special icon in the project
view, displaying a pen mark on top of the standard
icon:
</p>
<a name="index-screen-shot-19"></a>
<img src="project-modified.jpg" alt="project-modified">
<p>Note that in all tree views in GPS, you can use the <tt class="key">+</tt> and <tt class="key">-</tt> keys
to expand and collapse nodes (e.g. projects and directories).
</p>
<hr>
<div class="header">
<p>
Next: <a href="Disabling-Project-Edition-Features.html#Disabling-Project-Edition-Features" accesskey="n" rel="next">Disabling Project Edition Features</a>, Previous: <a href="Extending-Projects.html#Extending-Projects" accesskey="p" rel="previous">Extending Projects</a>, Up: <a href="Project-Handling.html#Project-Handling" accesskey="u" rel="up">Project Handling</a> [<a href="Index-table.html#Index-table" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|