This file is indexed.

/usr/share/doc/gnat-gps/html/Defining-new-Targets.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
<html lang="en">
<head>
<title>Defining new Targets - 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="Customizing-build-Targets-and-Models.html#Customizing-build-Targets-and-Models" title="Customizing build Targets and Models">
<link rel="prev" href="Defining-new-Target-Models.html#Defining-new-Target-Models" title="Defining new Target Models">
<link rel="next" href="Defining-new-Modes.html#Defining-new-Modes" title="Defining new Modes">
<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="Defining-new-Targets"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="Defining-new-Modes.html#Defining-new-Modes">Defining new Modes</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="Defining-new-Target-Models.html#Defining-new-Target-Models">Defining new Target Models</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Customizing-build-Targets-and-Models.html#Customizing-build-Targets-and-Models">Customizing build Targets and Models</a>
<hr>
</div>

<h5 class="subsubsection">16.5.20.2 Defining new Targets</h5>

<p><a name="index-Target-854"></a>
Targets are defined in a <code>target</code> node which has three attributes:

     <dl>
<dt><code>name</code><dd>   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. 
<br><dt><code>category</code><dd>   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. 
<br><dt><code>model</code><dd>   The name of the Model of which this Target inherits initially. 
</dl>

     <dl>
<dt><code>&lt;icon&gt;</code><dd>   The stock name of the icon to associate by default with the Target. 
<br><dt><code>&lt;in-toolbar&gt;</code><dd>   Optional, defaulting to <code>False</code>. A boolean indicating whether the
   Target should have an associated icon in the Toolbar. 
<br><dt><code>&lt;in-menu&gt;</code><dd>   Optional, defaulting to <code>True</code>. A boolean indicating whether the
   Target should have an associated entry in the Build menu. 
<br><dt><code>&lt;in-contextual-menus-for-projects&gt;</code><dd>   Optional, defaulting to <code>False</code>. A boolean indicating whether the
   Target should have an associated entry in the contextual menu for projects. 
<br><dt><code>&lt;in-contextual-menus-for-files&gt;</code><dd>   Optional, defaulting to <code>False</code>. A boolean indicating whether the
   Target should have an associated entry in the contextual menu for files. 
<br><dt><code>&lt;read-only&gt;</code><dd>   Optional, defaulting to <code>False</code>. A boolean indicating whether the
   Target can be removed by the user. 
<br><dt><code>&lt;target-type&gt;</code><dd>   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. 
<br><dt><code>&lt;launch-mode&gt;</code><dd>   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>. 
<br><dt><code>&lt;server&gt;</code><dd>   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>. 
<br><dt><code>&lt;command-line&gt;</code><dd>   Contains a number of <code>&lt;arg&gt;</code> nodes, each containing an argument of the
   default command line for this Target, starting with the executable. 
</dl>

<pre class="smallexample">     &lt;?xml version="1.0" ?&gt;
     &lt;my_target&gt;
        &lt;target model="gprclean" category="C_lean" name="Clean _All"&gt;
            &lt;in-toolbar&gt;TRUE&lt;/in-toolbar&gt;
            &lt;icon&gt;gps-clean&lt;/icon&gt;
            &lt;launch-mode&gt;MANUALLY_WITH_DIALOG&lt;/launch-mode&gt;
            &lt;read-only&gt;TRUE&lt;/read-only&gt;
            &lt;command-line&gt;
               &lt;arg&gt;%gprclean&lt;/arg&gt;
               &lt;arg&gt;-r&lt;/arg&gt;
               &lt;arg&gt;%eL&lt;/arg&gt;
               &lt;arg&gt;-P%PP&lt;/arg&gt;
               &lt;arg&gt;%X&lt;/arg&gt;
            &lt;/command-line&gt;
       &lt;/target&gt;
     &lt;/my_target&gt;
</pre>
   </body></html>