/usr/share/doc/gnat-gps/html/The-Target-Configuration-Dialog.html

<html lang="en">
<head>
<title>The Target Configuration Dialog - 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="Compilation_002fBuild.html#Compilation_002fBuild" title="Compilation/Build">
<link rel="prev" href="The-Build-Menu.html#The-Build-Menu" title="The Build Menu">
<link rel="next" href="The-Build-Mode.html#The-Build-Mode" title="The Build Mode">
<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-Target-Configuration-Dialog"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="The-Build-Mode.html#The-Build-Mode">The Build Mode</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="The-Build-Menu.html#The-Build-Menu">The Build Menu</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Compilation_002fBuild.html#Compilation_002fBuild">Compilation/Build</a>
<hr>
</div>

<h3 class="section">9.2 The Target Configuration Dialog</h3>

<p><a name="index-Targets-428"></a>
GPS provides an interface for launching operations like building projects,
compiling individual files, performing syntax or semantic checks, and so on. 
All these operations have in common that they involve launching an external
command, and parsing the output for error messages. In GPS, these operations
are called "Targets", and can be configured either through the Target
Configuration dialog, or through XML configuration. 
See <a href="Customizing-build-Targets-and-Models.html#Customizing-build-Targets-and-Models">Customizing build Targets and Models</a>.

   <p><a name="index-screen-shot-429"></a><img src="target-configuration-dialog.jpg" alt="target-configuration-dialog.jpg">

   <p>This dialog is divided in two areas: on the left, a tree listing Targets, and,
in the main area, a panel for configuring the Target which is currently
selected in the tree.

<h4 class="subsection">9.2.1 The Targets tree</h4>

<p>The Tree contains a list of targets, organized by categories.

   <p>On top of the tree are three buttons:

     <ul>
<li>The Add button creates a new target. 
<li>The Remove button removes the currently selected target. Note that only
 user-defined targets can be removed, the default targets created by GPS cannot
 be removed. 
<li>The Clone button creates a new user-defined target which is identical
 to the currently selected target. 
</ul>

<h4 class="subsection">9.2.2 The configuration panel</h4>

<p>On top of the configuration panel, one can select the Target model. 
The Model determines the graphical options available in the
"Command line" frame.

   <p>The "Revert" button resets all target settings to their original value.

   <p>The "Options" frame contains a number of options that are available for all
Targets.

     <ul>
<li>The Launch mode indicates the way the target is launched:
          <ul>
  <li>Manually:
    the target is launched when clicking on the corresponding icon
    in the toolbar, or when activating the corresponding menu item. 
    In the latter case, a dialog is displayed, allowing last-minute
    modifications of the command line.

          <li>Manually with dialog:
    same as Manually, but the dialog is always displayed, even when
    clicking on the toolbar icon.

          <li>Manually with no dialog:
    same as Manually, but the dialog is never displayed, even when
    activating the menu item.

          <li>On file save:
    the Target is launched automatically by GPS when a file is saved. 
    The dialog is never displayed.

          <li>In background:
    the Target is launched automatically in the background after each
    modification in the source editor. See <code>Background compilations</code>
    below.

     </ul>

     <li>Target type: type of target described. If empty, or set to
  <code>Normal</code>, represents a simple target. If set to another value,
  represents multiple subtargets. 
  For example, if set to <code>main</code>, each subtarget corresponds
  to a Main source as defined in the currently loaded project. 
  Other custom values may be defined, and then handled via the
  <code>compute_build_targets</code> hook.

   </ul>

   <p>The "Display" frame indicates where the launcher for this target should be
 visible.

     <ul>
<li>in the toolbar: when active, a button is displayed in
  the main toolbar, allowing to quickly launch a Target.

     <li>in the main menu: whether to display a menu item corresponding
  to the Target in the main GPS menu. By default, Targets in the "File"
  category are listed directly in the Build menu, and Targets in other
  categories are listed in a submenu corresponding to the name of the category.

     <li>in contextual menus for projects: whether to display an item in the
  contextual menu for projects in the Project View

     <li>in contextual menus for files: whether to display an item in the
  contextual menus for files, for instance in file items in the Project View
  or directly on source file editors.

   </ul>

   <p>The "Command line" contains a graphical interface for some configurable
 elements of the Target, which are specific to the Model of this Target.

   <p>The full command line is displayed at the bottom. Note that it may contain
Macro Arguments. For instance if the command line contains the string "%PP",
GPS will expand this to the full path to the current project. For a full
list of available Macros, see <a href="Macro-arguments.html#Macro-arguments">Macro arguments</a>.

<h4 class="subsection">9.2.3 Background compilations</h4>

<p>GPS is capable of launching compilation targets in the background. This means
that GPS will launch the compiler on the current state of the file in the
editor.

   <p>Error messages resulting from background compilations are not listed in the
Locations view or the Messages window. The full messages are listed in the
Background Build console, accessible from the menu <code>Tools-&gt;Console</code>. 
Error messages which contain a source location indication are shown as icons
on the side of lines in editors, and the exact location is highlighted directly
in the editor. On both of these places, tooltips show the contents of the error
messages.

   <p>Messages from background compilations are removed automatically either when a
new background compilation has finished, or when a non-background compilation
is launched.

   <p>GPS will launch background compilations for all targets that have a
<code>Launch mode</code> set to <code>In background</code>, after modifications occur in
a source editor. Background compilation is useful mostly for targets such as
<code>Compile File</code> or <code>Check Syntax</code>. For targets that work on Mains,
the last main that was used in a non-background is considered, defaulting to
the first main defined in the project hierarchy.

   <p>Background compilations are not launched while GPS is already listing results
from non-background compilations, ie as long as there are entries in the
Locations View showing entries in the <code>Builder results</code> category.

   </body></html>
gnat-gps-doc 5.0-6 / usr / share / doc / gnat-gps / html / The-Target-Configuration-Dialog.html
