/usr/share/doc/gnat-gps/html/The-Build-Mode.html

<!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 Build Mode</title>

<meta name="description" content="Using the GNAT Programming Studio: The Build Mode">
<meta name="keywords" content="Using the GNAT Programming Studio: The Build Mode">
<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="Compilation_002fBuild.html#Compilation_002fBuild" rel="up" title="Compilation/Build">
<link href="Working-with-two-compilers.html#Working-with-two-compilers" rel="next" title="Working with two compilers">
<link href="The-Target-Configuration-Dialog.html#The-Target-Configuration-Dialog" rel="previous" title="The Target Configuration Dialog">
<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-Build-Mode"></a>
<div class="header">
<p>
Next: <a href="Working-with-two-compilers.html#Working-with-two-compilers" accesskey="n" rel="next">Working with two compilers</a>, Previous: <a href="The-Target-Configuration-Dialog.html#The-Target-Configuration-Dialog" accesskey="p" rel="previous">The Target Configuration Dialog</a>, Up: <a href="Compilation_002fBuild.html#Compilation_002fBuild" accesskey="u" rel="up">Compilation/Build</a> &nbsp; [<a href="Index-table.html#Index-table" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="The-Build-Mode-1"></a>
<h3 class="section">9.3 The Build Mode</h3>
<a name="index-Mode"></a>

<p>GPS provides an easy way to build your project with different options, through
the Mode selection, located in the main toolbar.
</p>
<p>When the Mode selection is set to <code>default</code>, the build is done using the
switches defined in the project. When the Mode selection is set to another
value, then specialized parameters are passed to the builder. For instance, the
<code>gcov</code> Mode adds all the compilation parameters needed to instrument the
produced objects and executables to work with the <code>gcov</code> tool.
</p>
<p>In addition to changing the build parameters, the Mode selection has the effect
of changing the output directory for objects and executables. For instance,
objects produced under the <code>debug</code> mode will be located in the
<code>debug</code> subdirectories of the object directories defined by the project.
This allows switching from one Mode to another without having to erase the
objects pertaining to a different Mode.
</p>
<p>It is possible to define new Modes using XML customization, see
<a href="Customizing-build-Targets-and-Models.html#Customizing-build-Targets-and-Models">Customizing build Targets and Models</a>.
</p>
<p>Note that the Build Mode affects only builds done using recent versions of
gnatmake and gprbuild. The Mode selection has no effect on builds done through
Targets that launch other builders.
</p>



</body>
</html>
gnat-gps-doc 5.0-16 / usr / share / doc / gnat-gps / html / The-Build-Mode.html
