/usr/share/doc/gnat-gps/html/Defining-new-Targets.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 | <!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: Defining new Targets</title>
<meta name="description" content="Using the GNAT Programming Studio: Defining new Targets">
<meta name="keywords" content="Using the GNAT Programming Studio: Defining new Targets">
<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="Customizing-build-Targets-and-Models.html#Customizing-build-Targets-and-Models" rel="up" title="Customizing build Targets and Models">
<link href="Defining-new-Modes.html#Defining-new-Modes" rel="next" title="Defining new Modes">
<link href="Defining-new-Target-Models.html#Defining-new-Target-Models" rel="previous" title="Defining new Target Models">
<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="Defining-new-Targets"></a>
<div class="header">
<p>
Next: <a href="Defining-new-Modes.html#Defining-new-Modes" accesskey="n" rel="next">Defining new Modes</a>, Previous: <a href="Defining-new-Target-Models.html#Defining-new-Target-Models" accesskey="p" rel="previous">Defining new Target Models</a>, Up: <a href="Customizing-build-Targets-and-Models.html#Customizing-build-Targets-and-Models" accesskey="u" rel="up">Customizing build Targets and Models</a> [<a href="Index-table.html#Index-table" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Defining-new-Targets-1"></a>
<h4 class="subsubsection">16.5.20.2 Defining new Targets</h4>
<a name="index-Target"></a>
<p>Targets are defined in a <code>target</code> node which has three attributes:
</p>
<dl compact="compact">
<dt><code>name</code></dt>
<dd><p>Contains the name of the Target. It must be a unique name.
Underscores are interpreted as menu mnemonics. To represent an actual
underscore, use a double underscore.
</p></dd>
<dt><code>category</code></dt>
<dd><p>The category which contains the Target, for purposes of ordering the
tree in the Target Configuration Dialog, and for ordering in the Build
menu.Underscores are interpreted as menu mnemonics. To represent an actual
underscore, use a double underscore.
If <code>category</code> begins and ends with an underscore, the menu for the
Target is placed in the toplevel Build menu.
</p></dd>
<dt><code>model</code></dt>
<dd><p>The name of the Model of which this Target inherits initially.
</p></dd>
</dl>
<dl compact="compact">
<dt><code><icon></code></dt>
<dd><p>The stock name of the icon to associate by default with the Target.
</p></dd>
<dt><code><in-toolbar></code></dt>
<dd><p>Optional, defaulting to <code>False</code>. A boolean indicating whether the
Target should have an associated icon in the Toolbar.
</p></dd>
<dt><code><in-menu></code></dt>
<dd><p>Optional, defaulting to <code>True</code>. A boolean indicating whether the
Target should have an associated entry in the Build menu.
</p></dd>
<dt><code><in-contextual-menus-for-projects></code></dt>
<dd><p>Optional, defaulting to <code>False</code>. A boolean indicating whether the
Target should have an associated entry in the contextual menu for projects.
</p></dd>
<dt><code><in-contextual-menus-for-files></code></dt>
<dd><p>Optional, defaulting to <code>False</code>. A boolean indicating whether the
Target should have an associated entry in the contextual menu for files.
</p></dd>
<dt><code><read-only></code></dt>
<dd><p>Optional, defaulting to <code>False</code>. A boolean indicating whether the
Target can be removed by the user.
</p></dd>
<dt><code><target-type></code></dt>
<dd><p>Optional, defaulting to an empty string. A string indicating whether the
Target represents a simple target (if empty), or a
family of Targets. The name represents a parameter passed to the
<code>compute_build_targets</code> hook. If set to <code>main</code>, a new subtarget
will be create for each Main source defined in the project.
</p></dd>
<dt><code><launch-mode></code></dt>
<dd><p>Optional, defaulting to <code>MANUALLY</code>. Indicates how the Target should be
launched. Possible values are <code>MANUALLY</code>, <code>MANUALLY_WITH_DIALOG</code>,
<code>MANUALLY_WITH_NO_DIALOG</code>, and <code>ON_FILE_SAVE</code>.
</p></dd>
<dt><code><server></code></dt>
<dd><p>Optional, defaulting to <code>Build_Server</code>. Indicates the server used for
launching Target. See <a href="Remote-operations.html#Remote-operations">Remote operations</a>.
</p></dd>
<dt><code><command-line></code></dt>
<dd><p>Contains a number of <code><arg></code> nodes, each containing an argument of the
default command line for this Target, starting with the executable.
</p></dd>
</dl>
<div class="smallexample">
<pre class="smallexample"><?xml version="1.0" ?>
<my_target>
<target model="gprclean" category="C_lean" name="Clean _All">
<in-toolbar>TRUE</in-toolbar>
<icon>gps-clean</icon>
<launch-mode>MANUALLY_WITH_DIALOG</launch-mode>
<read-only>TRUE</read-only>
<command-line>
<arg>%gprclean</arg>
<arg>-r</arg>
<arg>%eL</arg>
<arg>-P%PP</arg>
<arg>%X</arg>
</command-line>
</target>
</my_target>
</pre></div>
<hr>
<div class="header">
<p>
Next: <a href="Defining-new-Modes.html#Defining-new-Modes" accesskey="n" rel="next">Defining new Modes</a>, Previous: <a href="Defining-new-Target-Models.html#Defining-new-Target-Models" accesskey="p" rel="previous">Defining new Target Models</a>, Up: <a href="Customizing-build-Targets-and-Models.html#Customizing-build-Targets-and-Models" accesskey="u" rel="up">Customizing build Targets and Models</a> [<a href="Index-table.html#Index-table" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|