<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
<html lang="en">
<head>
<meta http-equiv="Content-Language" content="en-us">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>C/C++ Project Properties, Managed, Build</title>
<link rel="stylesheet" type="text/css" href="../help.css">
<style>
<!--
table.MsoNormalTable
{mso-style-parent:"";
font-size:10.0pt;
font-family:"Times New Roman";
}
-->
</style>
</head>
<body>
<h1>C/C++ Project Properties, Managed, C/C++ Build, Build Macros</h1>
Customizes the build macros used in your build configuration.
<p><img img="" src="../images/mprop_macros.png"
alt="C/C++ Project Properties, Managed, C/C++ Build, Macros"></p>
<p></p>
<dl>
<dt>Project Type:</dt>
<dd>Displays the type of project that is built by the selected build
configuration.</dd>
<dt>Configuration:</dt>
<dd>Specifies the selected build configuration from the list provided.</dd>
<dt>Manage...</dt>
<dd>Adds, removes, renames and converts configurations.</dd>
<dt>Configuration Settings</dt>
<dd>Adds, removes, edits and manages build macros for a project or
configuration. <br>
Each tab contains two tables - one for user-defined build macros and
one for non user-defined build macros. <br>
Each table contains three columns<b>:</b></dd>
</dl>
<dl style="margin-left: 40px;">
<dd>
<p><b>Name</b> of the build macro</p>
<p><b>Type </b>of value contained in the build macro (see below)</p>
<p><b>Value </b>of the build macro. </p>
</dd>
</dl>
<dl>
<dd>
<p>You can view all build macros that are not user-defined in the <b>System
Macros</b> table.<span
style="font-family: "Times New Roman"; font-style: normal; font-variant: normal; font-weight: normal; font-size: 7pt; line-height: normal; font-stretch: normal; font-size-adjust: none;"> </span><span
style="font-style: normal; font-variant: normal; font-weight: normal;">You</span>
can choose to also display all macros defined for lower-precedence
contexts in the <b>System Macros</b> table by checking the <b>Show
parent context macros</b> checkbox. System macros are read-only.</p>
<p class="MsoNormal">You can view all user-defined macros in the <b>User
Macros</b> table.<span
style="font-family: "Times New Roman"; font-style: normal; font-variant: normal; font-weight: normal; font-size: 7pt; line-height: normal; font-stretch: normal; font-size-adjust: none;">
</span>A user-defined macro overrides a non user-defined macro of
the same name for the given context. Overridden macros are
displayed in bold in the <b>System Macros</b> table. </p>
</dd>
</dl>
<dl>
<dt>Restore Defaults</dt>
<dd>Returns any changes back to their default setting.</dd>
<dt>Apply</dt>
<dd>Applies any changes.</dd>
</dl>
<h2>Detailed Specification</h2>
<p>Build Macros can be used in all C/C++ Build configuration properties
that accept text. Build Macros are referenced in strings by enclosing
them in braces, preceded by a dollar sign.
There are no special restrictions on a macro name, though it is
encouraged that a macro name begin with a letter and contain only
letters, digits and underscore signs. Build macro names are case
sensitive.
<br>
If the actual value of text property contains $<i>{text</i><some_expression>},
it must be pre-pended with a backslash in order to distinguish it from
a build macro. The Managed Build System (MBS) pre-defines many useful
macros (see below) and allows tool integrators and users to define
additional macros.</some_expression></p>
<p>Build Macros can hold several types of values:
</p>
<ol>
<li>Text value: can be any text string</li>
<li>Text-List value: an array of Text values</li>
<li>Path-file value: can hold a file path</li>
<li>Path-dir value: can hold a directory path </li>
<li>Path-any value: can hold both a file and directory path </li>
<li>Path-file-List value: an array of Path-file values </li>
<li>Path-dir-List value: an array of Path-dir values</li>
<li>Path-any-List value: an array of Path-any values </li>
</ol>
<p class="MsoNormal">Build Macros are context-sensitive, that is the
macro of a given name could have different values depending on where it
is used. Several contexts are defined:</p>
<ol>
<li>
<p class="MsoNormal">The currently selected file. </p>
</li>
<li>
<p class="MsoNormal"
style="text-indent: -0.25in; margin-left: 0.25in;">The currently
selected option </p>
</li>
<li>
<p class="MsoNormal"
style="text-indent: -0.25in; margin-left: 0.25in;">The currently
selected configuration (which includes a tool-chain). </p>
</li>
<li>
<p class="MsoNormal"
style="text-indent: -0.25in; margin-left: 0.25in;">The currently
selected project. </p>
</li>
<li>
<p class="MsoNormal"
style="text-indent: -0.25in; margin-left: 0.25in;">The current
workspace. </p>
</li>
<li>
<p class="MsoNormal"
style="text-indent: -0.25in; margin-left: 0.25in;">The CDT and Eclipse
installations. </p>
</li>
<li>
<p class="MsoNormal"
style="text-indent: -0.25in; margin-left: 0.25in;">The process
environment variables defined in the environment passed to Eclipse. </p>
</li>
</ol>
<p class="MsoNormal">Users can define and delete macros for any given
project configuration, for the entire project or for the entire
workspace.</p>
<p class="MsoNormal">The value of a build macro will be searched for in
the order specified above. If macro is not found for the currently
selected file context, the currently selected option context will be
used, if not found, the currently selected configuration context will
be used, etc. It is possible, but not recommended, for a
user-defined macro to override the definition of an MBS pre-defined
macro. Overriding MBS pre-defined macros can have unanticipated
consequences.</p>
<p class="MsoNormal">To define a new macro the "New" button should be
pressed. A dialog will appear representing the macro definition.</p>
<p class="MsoNormal"><img border="0"
src="../images/mprop_macros_new_file.PNG" width="426" height="321"></p>
<p>The "Name" field contains the list of macros that are already
defined. A user can choose any variable from the list or enter a new
variable name. When a macro from the list is chosen or the name typed
by the user matches an already existing macro name, the other fields of
the dialog get filled with the value, and value type of that macro.</p>
<p>When any of the "String," "File," "Directory" or "File or Directory"
value types is selected, the macro value may be specified with the
"Value" edit-box. For the "File" and "Directory" types, a "Browse"
button is also displayed that allows selecting file or directory using
the "Browse" dialog.</p>
<p>When either of the "List of Strings," "List of Files," "List of
Directories" or "List Files or Directories" value types is selected,
the macro value may be specified with the "Macro Value" multi-line text
box and button bar.</p>
<p class="MsoNormal">
<img border="0" src="../images/mprop_macros_new_list_file.PNG"
width="426" height="321"></p>
<p class="MsoNormal"> </p>
<p class="MsoNormal">Macro resolution takes place when the build file
is being generated.</p>
All macros, except the build process environment macros, always get
resolved in the makefile. See the <a
href="cdt_u_mprop_build_settings.htm">“Expand Build Environment
Macros" checkbox in the “Build Settings" tab of the “C/C++ Build" page</a>.
<p class="MsoNormal">The Managed Build System pre-defines many useful
macros described in the following tables:</p>
<h3>File-specific macros</h3>
<p class="MsoNormal">The set of file-context macros is predefined by
the Managed Build System (MBS). Neither a tool-integrator nor a user
can define new file-context macros.</p>
<table class="MsoNormalTable" border="1" cellspacing="0" cellpadding="0"
style="border: medium none ; border-collapse: collapse;" id="table1"
width="695">
<tbody>
<tr style="height: 8.3pt;">
<td valign="top"
style="border: 1pt solid windowtext; padding: 0in 5.4pt; width: 217px; height: 8.3pt;">
<p class="MsoNormal" align="center" style="text-align: center;"><b>Macro</b></p>
</td>
<td valign="top"
style="border-style: solid solid solid none; border-width: 1pt 1pt 1pt medium; border-top: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 103px; height: 8.3pt;">
<p class="MsoNormal" align="center" style="text-align: center;"><b>Value
Type</b></p>
</td>
<td valign="top"
style="border-style: solid solid solid none; border-width: 1pt 1pt 1pt medium; border-top: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 329px; height: 8.3pt;">
<p class="MsoNormal" align="center" style="text-align: center;"><b>Description</b></p>
</td>
</tr>
<tr style="height: 3.5pt;">
<td valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 217px; height: 3.5pt;">
<p class="MsoNormal">${InputFileName}</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 103px; height: 3.5pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Text</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 329px; height: 3.5pt;">
<p class="MsoNormal" style="text-align: justify;">Represents the
input file name. The input file has the following meaning:</p>
<p class="MsoNormal"
style="text-align: justify; text-indent: -0.25in; margin-left: 0.25in;">1.<span
style="font-family: "Times New Roman"; font-style: normal; font-variant: normal; font-weight: normal; font-size: 7pt; line-height: normal; font-stretch: normal; font-size-adjust: none;">
</span>If a tool does not accept building multiple files of the
primary input type with one tool invocation, the input file is the file
of the primary input type being built.</p>
<p class="MsoNormal"
style="text-align: justify; text-indent: -0.25in; margin-left: 0.25in;">2.<span
style="font-family: "Times New Roman"; font-style: normal; font-variant: normal; font-weight: normal; font-size: 7pt; line-height: normal; font-stretch: normal; font-size-adjust: none;">
</span>If a tool accepts building multiple files of the primary
input type with one tool invocation the input file is undefined and the
macros representing the input file contain information about one of the
inputs of the primary input type being built.</p>
</td>
</tr>
<tr style="height: 6.95pt;">
<td valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 217px; height: 6.95pt;">
<p class="MsoNormal">${InputFileExt}</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 103px; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Text</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 329px; height: 6.95pt;">
<p class="MsoNormal" style="text-align: justify;">Represents the
extension of the input file.</p>
</td>
</tr>
<tr style="height: 6.95pt;">
<td valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 217px; height: 6.95pt;">
<p class="MsoNormal">${InputFileBaseName}</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 103px; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Text</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 329px; height: 6.95pt;">
<p class="MsoNormal" style="text-align: justify;">Represents the
base name of the input file. That is the file name with an extension
stripped.</p>
</td>
</tr>
<tr style="height: 6.95pt;">
<td valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 217px; height: 6.95pt;">
<p class="MsoNormal">${InputFileRelPath}</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 103px; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Path(File)</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 329px; height: 6.95pt;">
<p class="MsoNormal" style="text-align: justify;">Represents the
input file path relative to the builder current directory.</p>
</td>
</tr>
<tr style="height: 6.95pt;">
<td valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 217px; height: 6.95pt;">
<p class="MsoNormal">${InputDirRelPath}</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 103px; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Path(Dir)</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 329px; height: 6.95pt;">
<p class="MsoNormal" style="text-align: justify;">Represents the
input file directory path relative to the builder current directory.</p>
</td>
</tr>
<tr style="height: 3.5pt;">
<td valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 217px; height: 3.5pt;">
<p class="MsoNormal">${OutputFileName}</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 103px; height: 3.5pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Text</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 329px; height: 3.5pt;">
<p class="MsoNormal" style="text-align: justify;">Represents the
output file name. The output file has the following meaning:</p>
<p class="MsoNormal"
style="text-align: justify; text-indent: -0.25in; margin-left: 0.25in;">1.<span
style="font-family: "Times New Roman"; font-style: normal; font-variant: normal; font-weight: normal; font-size: 7pt; line-height: normal; font-stretch: normal; font-size-adjust: none;">
</span>If a tool is not capable of producing multiple files of
the primary output type with one tool invocation the output file is the
file of the primary output type that is built with a given tool
invocation.</p>
<p class="MsoNormal"
style="text-align: justify; text-indent: -0.25in; margin-left: 0.25in;">2.<span
style="font-family: "Times New Roman"; font-style: normal; font-variant: normal; font-weight: normal; font-size: 7pt; line-height: normal; font-stretch: normal; font-size-adjust: none;">
</span>If a tool is capable of producing multiple files of the
primary output type with one tool invocation the output file is
undefined and the macros representing the output file contain
information about one of the files of the primary output type that are
built with a given tool invocation.</p>
</td>
</tr>
<tr style="height: 6.95pt;">
<td valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 217px; height: 6.95pt;">
<p class="MsoNormal">${OutputFileExt}</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 103px; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Text</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 329px; height: 6.95pt;">
<p class="MsoNormal" style="text-align: justify;">Represents the
output file extension.</p>
</td>
</tr>
<tr style="height: 6.95pt;">
<td valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 217px; height: 6.95pt;">
<p class="MsoNormal">${OutputFileBaseName}</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 103px; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Text</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 329px; height: 6.95pt;">
<p class="MsoNormal" style="text-align: justify;">Represents the
output file base name. That is the output file name with an extension
stripped.</p>
</td>
</tr>
<tr style="height: 6.95pt;">
<td valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 217px; height: 6.95pt;">
<p class="MsoNormal">${OutputFileRelPath}</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 103px; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Path(File)</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 329px; height: 6.95pt;">
<p class="MsoNormal" style="text-align: justify;">Represents the
output file path relative to the current builder directory.</p>
</td>
</tr>
<tr style="height: 6.95pt;">
<td valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 217px; height: 6.95pt;">
<p class="MsoNormal">${OutputDirRelPath}</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 103px; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Path(Dir)</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 329px; height: 6.95pt;">
<p class="MsoNormal" style="text-align: justify;">Represents the
output file directory path relative to the current builder directory.</p>
</td>
</tr>
</tbody>
</table>
<h3 style="text-indent: 0in; margin-left: 0in;"> Configuration-specific
macros</h3>
<table class="MsoNormalTable" border="1" cellspacing="0" cellpadding="0"
width="695"
style="border: medium none ; width: 521.4pt; border-collapse: collapse;"
id="table3">
<tbody>
<tr style="height: 8.3pt;">
<td valign="top"
style="border: 1pt solid windowtext; padding: 0in 5.4pt; width: 215px; height: 8.3pt;">
<p class="MsoNormal" align="center" style="text-align: center;"><b>Macro</b></p>
</td>
<td valign="top"
style="border-style: solid solid solid none; border-width: 1pt 1pt 1pt medium; border-top: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 104px; height: 8.3pt;">
<p class="MsoNormal" align="center" style="text-align: center;"><b>Value
Type</b></p>
</td>
<td valign="top"
style="border-style: solid solid solid none; border-width: 1pt 1pt 1pt medium; border-top: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 331px; height: 8.3pt;">
<p class="MsoNormal" align="center" style="text-align: center;"><b>Description</b></p>
</td>
</tr>
<tr style="height: 3.5pt;">
<td valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 215px; height: 3.5pt;">
<p class="MsoNormal">${ConfigName}</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 104px; height: 3.5pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Text</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 331px; height: 3.5pt;">
<p class="MsoNormal" style="text-align: justify;">Represents the
name of a given configuration.</p>
</td>
</tr>
<tr style="height: 6.95pt;">
<td valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 215px; height: 6.95pt;">
<p class="MsoNormal">${ConfigDescription}</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 104px; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Text</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 331px; height: 6.95pt;">
<p class="MsoNormal">Represents the description of a given
configuration.</p>
</td>
</tr>
<tr style="height: 6.95pt;">
<td valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 215px; height: 6.95pt;">
<p class="MsoNormal">${BuildArtifactFileName}</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 104px; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Text</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 331px; height: 6.95pt;">
<p class="MsoNormal">Represents the name of the build artifact.</p>
</td>
</tr>
<tr style="height: 6.95pt;">
<td valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 215px; height: 6.95pt;">
<p class="MsoNormal">${BuildArtifactFileExt}</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 104px; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Text</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 331px; height: 6.95pt;">
<p class="MsoNormal">Represents the extension of the build
artifact.</p>
</td>
</tr>
<tr style="height: 6.95pt;">
<td valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 215px; height: 6.95pt;">
<p class="MsoNormal">${BuildArtifactFileBaseName}</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 104px; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Text</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 331px; height: 6.95pt;">
<p class="MsoNormal">Represents the base name of the build
artifact.</p>
</td>
</tr>
<tr style="height: 6.95pt;">
<td valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 215px; height: 6.95pt;">
<p class="MsoNormal">${BuildArtifactFilePrefix}</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 104px; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Text</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 331px; height: 6.95pt;">
<p class="MsoNormal">Represents the prefix of the build artifact.</p>
</td>
</tr>
<tr style="height: 6.95pt;">
<td valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 215px; height: 6.95pt;">
<p class="MsoNormal">${TargetOsList}</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 104px; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Text-List</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 331px; height: 6.95pt;">
<p class="MsoNormal">Represents the list of the target OS names.</p>
</td>
</tr>
<tr style="height: 6.95pt;">
<td valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 215px; height: 6.95pt;">
<p class="MsoNormal">${TargetArchList}</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 104px; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Text-List</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 331px; height: 6.95pt;">
<p class="MsoNormal">Represents the list of the target Arch names.</p>
</td>
</tr>
</tbody>
</table>
<h3 style="text-indent: 0in; margin-left: 0in;">Project-specific macros</h3>
<table class="MsoNormalTable" border="1" cellspacing="0" cellpadding="0"
width="695"
style="border: medium none ; width: 521.4pt; border-collapse: collapse;"
id="table4">
<tbody>
<tr style="height: 3.5pt;">
<td valign="top"
style="border: 1pt solid windowtext; padding: 0in 5.4pt; width: 219px; height: 3.5pt;">
<p class="MsoNormal">${ProjName}</p>
</td>
<td valign="top"
style="border-style: solid solid solid none; border-width: 1pt 1pt 1pt medium; border-top: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 105px; height: 3.5pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Text</p>
</td>
<td valign="top"
style="border-style: solid solid solid none; border-width: 1pt 1pt 1pt medium; border-top: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 328px; height: 3.5pt;">
<p class="MsoNormal" style="text-align: justify;">Represents the
name of a given project.</p>
</td>
</tr>
<tr style="height: 6.95pt;">
<td valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 219px; height: 6.95pt;">
<p class="MsoNormal">${ProjDirPath}</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 105px; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Path(Dir)</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 328px; height: 6.95pt;">
<p class="MsoNormal">Represents the absolute path of a given
project. </p>
</td>
</tr>
</tbody>
</table>
<h3 style="text-indent: 0in; margin-left: 0in;">Workspace-specific
macros</h3>
<table class="MsoNormalTable" border="1" cellspacing="0" cellpadding="0"
width="695"
style="border: medium none ; width: 521.4pt; border-collapse: collapse;"
id="table5">
<tbody>
<tr style="height: 6.95pt;">
<td valign="top"
style="border: 1pt solid windowtext; padding: 0in 5.4pt; width: 217px; height: 6.95pt;">
<p class="MsoNormal">${WorkspaceDirPath}</p>
</td>
<td valign="top"
style="border-style: solid solid solid none; border-width: 1pt 1pt 1pt medium; border-top: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 106px; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Path(Dir)</p>
</td>
<td valign="top"
style="border-style: solid solid solid none; border-width: 1pt 1pt 1pt medium; border-top: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 328px; height: 6.95pt;">
<p class="MsoNormal">Represents the workspace absolute path.</p>
</td>
</tr>
<tr style="height: 6.95pt;">
<td valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 217px; height: 6.95pt;">
<p class="MsoNormal">${DirectoryDelimiter}</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 106px; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Text</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 328px; height: 6.95pt;">
<p class="MsoNormal">Represents the directory delimiter used on
the system. That is the “\? for Win32 systems and the “/? for Unix-like
systems</p>
<p class="MsoNormal">This could be useful, e.g. in the case a
user needs the absolute path of an input file. The absolute path would
be represented in the following way:
${CWD}${DirectoryDelimiter}${InputFileRelPath}</p>
</td>
</tr>
<tr style="height: 6.95pt;">
<td valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 217px; height: 6.95pt;">
<p class="MsoNormal">${PathDelimiter}</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 106px; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Text</p>
</td>
<td valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 328px; height: 6.95pt;">
<p class="MsoNormal">Represents the default path delimiter used
on the system to separate paths in the path environment variables. That
is the “;? for Win32 systems and the “:? for Unix-like systems</p>
<p class="MsoNormal">This might be used in the environment
variable definitions</p>
</td>
</tr>
</tbody>
</table>
<h3>CDT/Eclipse installation-specific macros</h3>
<table class="MsoNormalTable" border="1" cellspacing="0" cellpadding="0"
width="695"
style="border: medium none ; width: 521.4pt; border-collapse: collapse;"
id="table6">
<tbody>
<tr style="height: 6.95pt;">
<td width="228" valign="top"
style="border: 1pt solid windowtext; padding: 0in 5.4pt; width: 171pt; height: 6.95pt;">
<p class="MsoNormal">${EclipseVersion}</p>
</td>
<td width="108" valign="top"
style="border-style: solid solid solid none; border-width: 1pt 1pt 1pt medium; border-top: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 80.85pt; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Text</p>
</td>
<td width="359" valign="top"
style="border-style: solid solid solid none; border-width: 1pt 1pt 1pt medium; border-top: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 269.55pt; height: 6.95pt;">
<p class="MsoNormal">Represents the current Eclipse version.</p>
</td>
</tr>
<tr style="height: 6.95pt;">
<td width="228" valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 171pt; height: 6.95pt;">
<p class="MsoNormal">${CDTVersion}</p>
</td>
<td width="108" valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 80.85pt; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Text</p>
</td>
<td width="359" valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 269.55pt; height: 6.95pt;">
<p class="MsoNormal">Represents the current CDT version.</p>
</td>
</tr>
<tr style="height: 6.95pt;">
<td width="228" valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 171pt; height: 6.95pt;">
<p class="MsoNormal">${MBSVersion}</p>
</td>
<td width="108" valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 80.85pt; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Text</p>
</td>
<td width="359" valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 269.55pt; height: 6.95pt;">
<p class="MsoNormal">Represents the current MBS version.</p>
</td>
</tr>
<tr style="height: 6.95pt;">
<td width="228" valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 171pt; height: 6.95pt;">
<p class="MsoNormal">${HostOsName}</p>
</td>
<td width="108" valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 80.85pt; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Text</p>
</td>
<td width="359" valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 269.55pt; height: 6.95pt;">
<p class="MsoNormal">Represents the operating system name on
which eclipse is running.</p>
</td>
</tr>
<tr style="height: 6.95pt;">
<td width="228" valign="top"
style="border-style: none solid solid; border-width: medium 1pt 1pt; border-left: 1pt solid windowtext; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 171pt; height: 6.95pt;">
<p class="MsoNormal">${HostArchName}</p>
</td>
<td width="108" valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 80.85pt; height: 6.95pt;">
<p class="MsoNormal" align="center" style="text-align: center;">Text</p>
</td>
<td width="359" valign="top"
style="border-style: none solid solid none; border-width: medium 1pt 1pt medium; border-right: 1pt solid windowtext; border-bottom: 1pt solid windowtext; padding: 0in 5.4pt; width: 269.55pt; height: 6.95pt;">
<p class="MsoNormal">Represents the architecture name on which
eclipse is running.</p>
</td>
</tr>
</tbody>
</table>
<p style="margin-top: 0pt; margin-bottom: 0pt;"><img border="0"
src="../images/ngref.gif" alt="Related reference" width="143"
height="21"><br>
<a href="cdt_u_sprop_info.htm">C++ Project Properties, Standard, Info</a><br>
<a href="cdt_u_sprop_builders.htm">C++ Project Properties, Standard,
Builders</a><br>
<a href="cdt_u_sprop_file_types.htm">C++ Project Properties, Standard,
File Types</a><br>
<a href="cdt_u_sprop_includes.htm">C++ Project Properties, Standard,
Include Paths and Symbols</a><br>
<a href="cdt_u_sprop_indexer.htm">C++ Project Properties, Standard,
Indexer</a><br>
<a href="cdt_u_sprop_mbuild.htm">C++ Project Properties, Standard, Make
Builder</a><br>
<a href="cdt_u_sprop_merror.htm">C++ Project Properties, Standard,
Error Parser</a><br>
<a href="cdt_u_sprop_mbinary.htm">C++ Project Properties, Standard,
Binary Parser</a><br>
<a href="cdt_u_sprop_mdiscovery.htm">C++ Project Properties, Standard,
Discovery Options</a><br>
<a href="cdt_u_sprop_psource.htm">C++ Project Properties, Standard,
Source</a><br>
<a href="cdt_u_sprop_poutput.htm">C++ Project Properties, Standard,
Output</a><br>
<a href="cdt_u_sprop_pproj.htm">C++ Project Properties, Standard,
Projects</a><br>
<a href="cdt_u_sprop_plib.htm">C++ Project Properties, Standard,
Libraries</a><br>
<a href="cdt_u_sprop_pcontainers.htm">C++ Project Properties, Standard,
Path Containers</a><br>
<a href="cdt_u_sprop_ref.htm">C++ Project Properties, Standard, Project
References</a><br>
<a href="cdt_u_mprop_info.htm">C++ Project Properties, Managed, Info</a><br>
<a href="cdt_u_mprop_builders.htm">C++ Project Properties, Managed,
Builders</a><br>
<a href="cdt_u_mprop_build.htm">C++ Project Properties, Managed, C/C++
Build</a><br>
<a href="cdt_u_mprop_manage.htm">C++ Project Properties, Managed, Manage Configuration Dialog</a><br>
<a href="cdt_u_mprop_tool_settings.htm">C++ Project Properties,
Managed, C/C++ Build, Tool Settings</a><br>
<a href="cdt_u_mprop_build_settings.htm">C++ Project Properties,
Managed, C/C++ Build, Build Settings</a><br>
<a href="cdt_u_mprop_dcbs.htm">C++ Project Properties, Managed, C/C++
Build, Build Steps</a><br>
<a href="cdt_u_mprop_merror.htm">C++ Project Properties, Managed, C/C++
Build, Error Parsers</a><br>
<a href="cdt_u_mprop_mbinary.htm">C++ Project Properties, Managed,
C/C++ Build, Binary Parser</a><br>
<a href="cdt_u_mprop_env.htm">C++ Project Properties, Managed, C/C++
Build, Environment</a><br>
<a href="cdt_u_mprop_documentation.htm">C++ Project Properties,
Managed, C/C++ Documentation</a><br>
<a href="cdt_u_mprop_file_types.htm">C++ Project Properties, Managed,
C/C++ File Types</a><br>
<a href="cdt_u_mprop_indexer.htm">C++ Project Properties, Managed,
C/C++ Indexer</a><br>
<a href="cdt_u_mprop_ref.htm">C++ Project Properties, Managed, Project
References</a><br>
<a href="cdt_u_mprop_refactoring_history.htm">C++ Project Properties, Managed, Refactoring History</a></p>
<p style="margin-top: 0pt; margin-bottom: 0pt;"><a
href="cdt_o_mproj_pref.htm">Managed Build Project preferences</a></p>
<p style="margin-top: 0pt; margin-bottom: 0pt;"><a
href="cdt_o_mproj_pref_env.htm">Managed Build Project preferences,
Environment</a></p>
<p style="margin-top: 0pt; margin-bottom: 0pt;"><a
href="cdt_o_mproj_pref_macro.htm">Managed Build Project preferences,
Macros</a></p>
<p><img src="../images/intl_05.gif" ALT="Intel Copyright Statement" ></p>
</body>
</html>