/usr/share/doc/gnat-gps/html/The-Welcome-Dialog.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 202 203 204 | <!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 Welcome Dialog</title>
<meta name="description" content="Using the GNAT Programming Studio: The Welcome Dialog">
<meta name="keywords" content="Using the GNAT Programming Studio: The Welcome Dialog">
<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-Tip-of-the-Day.html#The-Tip-of-the-Day" rel="next" title="The Tip of the Day">
<link href="Description-of-the-Main-Windows.html#Description-of-the-Main-Windows" rel="previous" title="Description of the Main 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-Welcome-Dialog"></a>
<div class="header">
<p>
Next: <a href="The-Tip-of-the-Day.html#The-Tip-of-the-Day" accesskey="n" rel="next">The Tip of the Day</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-Welcome-Dialog-1"></a>
<h3 class="section">2.1 The Welcome Dialog</h3>
<a name="index-welcome-dialog"></a>
<a name="index-screen-shot"></a>
<img src="welcome.jpg" alt="welcome">
<p>When starting GPS, a welcome dialog is displayed by default, giving the
following choices:
</p>
<dl compact="compact">
<dt><b>Create new project from template</b></dt>
<dd><p>If you select this option and then click the <code>OK</code> button, GPS will
launch an assistant to create a project using one of the predefined project
templates.
</p>
</dd>
<dt><b>Start with default project in directory</b></dt>
<dd><a name="index-project"></a>
<p>If you select this option and click on the <code>OK</code> button, GPS will
first look for a project called <samp>default.gpr</samp> in the current directory
and load it if found. Otherwise, it will copy in
the current directory the default project found under
<samp><prefix>/share/gps/default.gpr</samp> and load it.
GPS will remove this copy when exiting or loading another project, if the
copy has not been modified during the session.
</p>
<p>If the current directory is not writable, GPS will instead load directly
<code><prefix>/share/gps/readonly.gpr</code>. In this case, GPS will work in a
degraded mode, where some capabilities will not work (such as building and
source navigation).
</p>
</dd>
<dt><b>Create new project with wizard</b></dt>
<dd><a name="index-project-1"></a>
<p>Selecting this option and clicking on the <code>OK</code> button will start a
wizard allowing you to specify most of the properties for a new project. Once
the project is created, GPS will save it and load it automatically.
See <a href="The-Project-Wizard.html#The-Project-Wizard">The Project Wizard</a> for more details on the project wizard.
</p>
<p>Several kinds of wizard are available. Depending on the kind of project,
you will get asked different type of information. In the end, GPS will create
one or more project files, and automatically load them.
</p>
<p>One of the wizard, "From existing Ada sources", will try and import a set of
sources and object files, and attempt to create one or more project files so
that building your application through these project files will put the objects
in the same directory they are currently in. If you have not compiled your
application when launching this wizard, GPS will create a single project file
and all object files will be put in the same object directory. This is the
prefered method when importing sources with duplicate file names, since the
latter is only authorized in a single project file, not across various project
files.
</p>
</dd>
<dt><b>Open existing project</b></dt>
<dd><a name="index-project-2"></a>
<p>You can select an existing project by clicking on the <code>Browse</code> button,
or by using a previously loaded project listed in the combo box. When a
project is selected, clicking on the <code>OK</code> button will load this
project and open the main window.
</p>
</dd>
<dt><b>Always show this dialog when GPS starts</b></dt>
<dd><p>If unset, the welcome dialog won’t be shown in future sessions.
In this case, GPS will behave as follows: it will first look for a
<code>-P</code> switch on the command line, and load the corresponding project if
present.
Then, it will look for a project file in the current directory and will
load the first project file found.
</p>
<p>If no project file can be found in the current directory, GPS will start
with the default project.
</p>
<p>To reset this property, go to the menu <code>Edit->Preferences</code>.
<a name="index-preferences"></a>
See <a href="The-Preferences-Dialog.html#The-Preferences-Dialog">The Preferences Dialog</a>.
</p>
</dd>
<dt><b>Quit</b></dt>
<dd><p>If you click on this button, GPS will terminate immediately.
</p></dd>
</dl>
<a name="index-command-line"></a>
<p>When you specify a -P switch on the command line, or if there is only one
project file in the current directory, GPS will start immediately with
the project file specified, instead of displaying the welcome dialog.
</p>
<p>In addition, if you specify source files on the command line, GPS will also
start immediately, using the default project if no project is specified.
</p>
<p>By default, files specified on the command line are taken as is and can
be absolute or relative pathnames. In addition, if you prepend a filename
with the <code>=</code> character, then GPS will look for the file in the source
search path of the project.
</p>
<hr>
<div class="header">
<p>
Next: <a href="The-Tip-of-the-Day.html#The-Tip-of-the-Day" accesskey="n" rel="next">The Tip of the Day</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>
|