mirror of
https://github.com/eclipse-cdt/cdt
synced 2025-07-24 09:25:31 +02:00
Update for MBS user documentation - primarily build environment and macro descriptions
This commit is contained in:
Leo Treggiari
parent
ad2b990865
commit
3aa6c3c301
15 changed files with 280 additions and 38 deletions
BIN
doc/org.eclipse.cdt.doc.user/images/mpref.png
Normal file
BIN
doc/org.eclipse.cdt.doc.user/images/mpref.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 21 KiB |
BIN
doc/org.eclipse.cdt.doc.user/images/mpref_env.png
Normal file
BIN
doc/org.eclipse.cdt.doc.user/images/mpref_env.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 21 KiB |
BIN
doc/org.eclipse.cdt.doc.user/images/mpref_macro.PNG
Normal file
BIN
doc/org.eclipse.cdt.doc.user/images/mpref_macro.PNG
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 21 KiB |
BIN
doc/org.eclipse.cdt.doc.user/images/mprop_env_new_prep.png
Normal file
BIN
doc/org.eclipse.cdt.doc.user/images/mprop_env_new_prep.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 6.9 KiB |
BIN
doc/org.eclipse.cdt.doc.user/images/mprop_env_new_repl.PNG
Normal file
BIN
doc/org.eclipse.cdt.doc.user/images/mprop_env_new_repl.PNG
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 6.6 KiB |
BIN
doc/org.eclipse.cdt.doc.user/images/mprop_macros_new_file.PNG
Normal file
BIN
doc/org.eclipse.cdt.doc.user/images/mprop_macros_new_file.PNG
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 6.7 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 8.2 KiB |
|
|
@ -11,7 +11,19 @@
|
|||
<body>
|
||||
|
||||
<h1>Managed Make Project preferences</h1>
|
||||
|
||||
<p style="margin-top: 0">Customizes the managed make project settings for the
|
||||
entire workspace.</p>
|
||||
<p style="margin-top: 0">
|
||||
<img border="0" src="../images/mpref.png" width="580" height="525"></p>
|
||||
<p style="margin-top: 0">The following settings may be customized:</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p style="margin-top: 0"><a href="cdt_o_mproj_pref_env.htm">Build
|
||||
Environment Settings</a></li>
|
||||
<li>
|
||||
<p style="margin-top: 0"><a href="cdt_o_mproj_pref_macro.htm">Build Macros
|
||||
Settings</a></li>
|
||||
</ul>
|
||||
<p><img src="../images/ng00_04a.gif" ALT="IBM Copyright Statement" ></p>
|
||||
</body>
|
||||
</html>
|
||||
|
|
|
|||
|
|
@ -0,0 +1,43 @@
|
|||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//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>Project properties</title>
|
||||
<link rel="stylesheet" type="text/css" href="../help.css">
|
||||
</head>
|
||||
|
||||
<body>
|
||||
|
||||
<h1>Managed Make Project preferences, Environment</h1>
|
||||
<p style="margin-top: 0">Customizes the build environment for all managed make projects in the workspace.</p>
|
||||
<p style="margin-top: 0">
|
||||
<img border="0" src="../images/mpref_env.png" width="580" height="525"></p>
|
||||
<p>You can add, remove and edit build process environment variables to be used for all managed make
|
||||
projects in the workspace. Two tables are displayed - one for user-defined environment variables
|
||||
and one for non user-defined environment
|
||||
variables. Each
|
||||
table contains two columns<b>:</b></p>
|
||||
<p><b>Name</b> of the environment variable</p>
|
||||
<p><b>Value </b>of the environment variable. </p>
|
||||
<p>You can view all environment variables that are not user-defined in the <b>System
|
||||
Variables</b> table.<span style="font:7.0pt "Times New Roman""> </span></p>
|
||||
<p class="MsoNormal">You can view all user-defined variables in the <b>User
|
||||
Variables</b> table.<span style="font:7.0pt "Times New Roman"">
|
||||
</span>A user-defined variable overrides a non user-defined variable of the same
|
||||
name. Overridden variables are displayed in bold in
|
||||
the <b>System Variables</b> table.</p>
|
||||
<p class="MsoNormal">For more detailed information about the managed make Environment
|
||||
settings, see the description in the <a href="cdt_u_mprop_env.htm">Build Environment Property Pages</a>.</p>
|
||||
<p class="MsoNormal" style="margin-top: 0; margin-bottom: 0"><img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21"></p>
|
||||
<p style="margin-top: 0; margin-bottom:0"><a href="cdt_u_mprop_env.htm">C/C++
|
||||
Project Properties, Managed, C/C++ Build, Environment</a></p>
|
||||
<p style="margin-top: 0; margin-bottom:0"><a href="cdt_u_mprop_macros.htm">C/C++
|
||||
Project Properties, Managed, C/C++ Build, Build Macros</a></p>
|
||||
<p style="margin-top: 0; margin-bottom:0"><a href="cdt_o_mproj_pref_macro.htm">
|
||||
Managed Build Project preferences, Macros</a></p>
|
||||
|
||||
<p><img src="../images/ng00_04a.gif" ALT="IBM Copyright Statement" ></p>
|
||||
</body>
|
||||
</html>
|
||||
|
|
@ -0,0 +1,42 @@
|
|||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//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>Project properties</title>
|
||||
<link rel="stylesheet" type="text/css" href="../help.css">
|
||||
</head>
|
||||
|
||||
<body>
|
||||
|
||||
<h1>Managed Make Project preferences, Build Macros</h1>
|
||||
<p style="margin-top: 0">Customizes the build macros for all managed make projects in the workspace.</p>
|
||||
<p style="margin-top: 0">
|
||||
<img border="0" src="../images/mpref_macro.PNG" width="580" height="525"></p>
|
||||
<p>You can add, remove and edit build macros that apply to all managed make projects in the workspace.
|
||||
Two tables are displayed - one for user-defined build macros and one for non user-defined build macros.
|
||||
Each table contains three columns<b>:</b></p>
|
||||
<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>
|
||||
<p>You can view all build macros that are not user-defined in the <b>System
|
||||
Macros</b> table.<span style="font:7.0pt "Times New Roman""> </span></p>
|
||||
<p class="MsoNormal">You can view all user-defined macros in the <b>User
|
||||
Macros</b> table.<span style="font:7.0pt "Times New Roman"">
|
||||
</span>A user-defined macro overrides a non user-defined macro of the same
|
||||
name. Overridden macros are displayed in bold in
|
||||
the <b>System Macros</b> table.</p>
|
||||
<p class="MsoNormal">For more detailed information about managed make project build macros
|
||||
settings, see the description in the <a href="cdt_u_mprop_macros.htm">Build Macros Property Pages</a>.</p>
|
||||
<p class="MsoNormal" style="margin-top: 0; margin-bottom: 0"><img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21"></p>
|
||||
<p style="margin-top: 0; margin-bottom:0"><a href="cdt_u_mprop_env.htm">C/C++
|
||||
Project Properties, Managed, C/C++ Build, Environment</a></p>
|
||||
<p style="margin-top: 0; margin-bottom:0"><a href="cdt_u_mprop_macros.htm">C/C++
|
||||
Project Properties, Managed, C/C++ Build, Macros</a></p>
|
||||
<p style="margin-top: 0; margin-bottom:0"><a href="cdt_o_mproj_pref_env.htm">
|
||||
Managed Build Project preferences, Environment</a></p>
|
||||
|
||||
<p><img src="../images/ng00_04a.gif" ALT="IBM Copyright Statement" ></p>
|
||||
</body>
|
||||
</html>
|
||||
|
|
@ -6,6 +6,16 @@
|
|||
<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>
|
||||
<!--
|
||||
li.MsoNormal
|
||||
{mso-style-parent:"";
|
||||
margin-bottom:.0001pt;
|
||||
font-size:12.0pt;
|
||||
font-family:"Times New Roman";
|
||||
margin-left:0in; margin-right:0in; margin-top:0in}
|
||||
-->
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
|
|
@ -18,13 +28,131 @@ Customizes the environment variables to be used in building your build configura
|
|||
selected build configuration.</dd>
|
||||
<dt>Configuration:</dt><dd>Select the build configuration from the list provided.</dd>
|
||||
<dt>Manage...</dt><dd>You can add, remove and rename configurations.</dd>
|
||||
<dt>Configuration Settings</dt><dd>To Be Added.</dd>
|
||||
<dt>Configuration Settings</dt><dd>You can add, remove and edit
|
||||
environment variables for a
|
||||
project or configuration. Each tab contains two tables - one for user-defined
|
||||
environment variables and one for non user-defined environment
|
||||
variables. Each
|
||||
table contains two columns<b>:</b><p><b>Name</b> of the environment variable</p>
|
||||
<p><b>Value </b>of the environment variable. </p>
|
||||
<p>You can view all environment variables that are not user-defined in the <b>System
|
||||
Variables</b> table.<span style="font:7.0pt "Times New Roman""> </span><span style="font-style: normal; font-variant: normal; font-weight: normal">You</span>
|
||||
can choose to also display all variables defined for lower-precedence contexts
|
||||
in the <b>System Variables</b> table by checking the <b>Show parent level
|
||||
variables</b> checkbox. System variables are read-only.</p>
|
||||
<p class="MsoNormal">You can view all user-defined variables in the <b>User
|
||||
Variables</b> table.<span style="font:7.0pt "Times New Roman"">
|
||||
</span>A user-defined variable overrides a non user-defined variable of the same
|
||||
name for the given level. Overridden variables are displayed in bold in
|
||||
the <b>System Variables</b> table.</dd>
|
||||
<dt>Restore Defaults</dt><dd>Returns any changes back to their default setting.</dd>
|
||||
<dt>Apply</dt><dd>Applies any changes.</dd>
|
||||
</dl></p>
|
||||
</dl>
|
||||
|
||||
<h2>Detailed Specification</h2>
|
||||
<p style="margin-top: 15px; margin-bottom: 0">Users and tool-chain integrators
|
||||
can define the set of environment variables to be used while the build process
|
||||
is executing. </p>
|
||||
<p class="MsoNormal" style="margin-top: 0; margin-bottom: 0">Since the
|
||||
environment variable names are case sensitive on Unix-like systems and case
|
||||
insensitive on Windows systems, the Managed Build System (MBS) will treat the variable names in the same manner as the host system.</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p class="MsoNormal" style="margin-top: 10px; margin-bottom: 0">MBS will
|
||||
allow tool-integrators and users to specify multiple variables whose names
|
||||
differ only in case on systems that support case sensitive variable names
|
||||
and will not allow them to do that on Windows systems. </li>
|
||||
<li>
|
||||
<p class="MsoNormal" style="margin-top: 10px; margin-bottom: 0">MBS will
|
||||
also treat variable names as case sensitive (on Unix-like systems) or case
|
||||
insensitive (on Windows systems) in its own operations (overriding a
|
||||
lower-level variable, etc.)</li>
|
||||
</ul>
|
||||
<p class="MsoNormal"><span lang="EN-US">Build Environment variables can be
|
||||
specified at several levels:</span></p>
|
||||
<blockquote>
|
||||
<p class="MsoNormal" style="margin-top: 0; margin-bottom: 0">
|
||||
<span lang="EN-US">1.<span style="font:7.0pt "Times New Roman"">
|
||||
</span>Configuration level – variables specific to the selected configuration</span></p>
|
||||
<p class="MsoNormal" style="text-indent: -.25in; margin-left: .25in; margin-top: 0; margin-bottom: 0">
|
||||
<span lang="EN-US">2.<span style="font:7.0pt "Times New Roman"">
|
||||
</span>Project level – variables specific to the selected project and common
|
||||
for all project configurations</span></p>
|
||||
<p class="MsoNormal" style="text-indent: -.25in; margin-left: .25in; margin-top: 0; margin-bottom: 0">
|
||||
<span lang="EN-US">3.<span style="font:7.0pt "Times New Roman"">
|
||||
</span>Workspace level – variables specific to the current workspace</span></p>
|
||||
<p class="MsoNormal" style="text-indent: -.25in; margin-left: .25in; margin-top: 0; margin-bottom: 0">
|
||||
<span lang="EN-US">4.<span style="font:7.0pt "Times New Roman"">
|
||||
</span>System environment passed to eclipse</span></p>
|
||||
</blockquote>
|
||||
<p class="MsoNormal"><span lang="EN-US">When running the build utility for the
|
||||
selected configuration, the process' total environment variables set will be
|
||||
generated, including variables from all specified levels. Levels have
|
||||
precedence over each other as specified in the above list, so for example if
|
||||
configuration level and workspace level have a variable of the same name, the
|
||||
configuration variable will take precedence, etc.</span></p>
|
||||
<p style="margin-bottom: 0">Users can create and delete environment variables
|
||||
for any given project configuration, for the entire project or for the entire
|
||||
workspace.</p>
|
||||
<p style="margin-bottom: 0">To create a new variable the "New" button should be
|
||||
pressed. The dialog will appear representing the variable definition.</p>
|
||||
<p style="margin-bottom: 0">
|
||||
<img border="0" src="../images/mprop_env_new_repl.PNG" width="433" height="223"></p>
|
||||
<p style="margin-bottom: 0"> </p>
|
||||
<p style="margin-top: 0">A variable definition contains the name, the value, the
|
||||
delimiter and the "operation" <span lang="EN-US">to perform on the
|
||||
variable of the same name defined at the lower-precedence level. The following
|
||||
"operations" are defined: </span></p>
|
||||
<p class="MsoNormal" style="text-indent: -.25in; margin-left: 53.25pt; margin-top: 0">
|
||||
<span lang="EN-US" style="font-family: Symbol">·<span style="font:7.0pt "Times New Roman"">
|
||||
"</span></span><span lang="EN-US">append": If the variable already exists,
|
||||
add the user-specified value to the end of any existing value that the
|
||||
environment variable has. If the variable does not yet exist, create the
|
||||
variable and set it to the user-specified value.</span></p>
|
||||
<p class="MsoNormal" style="text-indent: -.25in; margin-left: 53.25pt; margin-top: 0">
|
||||
<span lang="EN-US" style="font-family: Symbol">·<span style="font:7.0pt "Times New Roman"">
|
||||
</span></span><span lang="EN-US">"prepend": If the variable already
|
||||
exists, add the user-specified value to beginning of any existing value that the
|
||||
environment variable has. If the variable does not yet exist, create the
|
||||
variable and set it to the user-specified value.</span></p>
|
||||
<p class="MsoNormal" style="text-indent: -.25in; margin-left: 53.25pt; margin-top: 0">
|
||||
<span lang="EN-US" style="font-family: Symbol">·<span style="font:7.0pt "Times New Roman"">
|
||||
"</span></span><span lang="EN-US">replace": If the variable already
|
||||
exists, set the value to the user-specified value. If the variable does not yet
|
||||
exist, create the variable and set it to the user-specified value.</span></p>
|
||||
<p class="MsoNormal" style="text-indent: -.25in; margin-left: 53.25pt; margin-top: 0">
|
||||
<span lang="EN-US" style="font-family: Symbol">·<span style="font:7.0pt "Times New Roman"">
|
||||
</span></span><span lang="EN-US">"delete": If the variable already exists,
|
||||
remove the variable.</span></p>
|
||||
<p>The resulting value of the variable used for the build process will be
|
||||
calculated by querying all levels from bottom to top and performing the
|
||||
operations for the variables defined at those levels.</p>
|
||||
<p>The "Name" field contains the list of variables that are already defined. A user can
|
||||
choose any variable from the list or enter a new variable name. When the
|
||||
variable from the list is chosen or the name typed by the user matches already
|
||||
defined variable name, the other fields of the dialog get filled with the
|
||||
current value, delimiter and operation of that variable.</p>
|
||||
<p>When the "replace" operation is selected, the "Value" field is used to
|
||||
specify the variable value.</p>
|
||||
<p>When either the "prepend" or "append" operation is selected, the "Value"
|
||||
field becomes grayed and the "Prepended/Appended value" field becomes visible
|
||||
that allows user to specify the value to be prepended/appended. The resulting
|
||||
variable value will be automatically calculated and displayed in the "Value"
|
||||
field. The delimiter to be used with append/prepend operations may be
|
||||
specified in the "Delimiter" field.</p>
|
||||
<p>
|
||||
<img border="0" src="../images/mprop_env_new_prep.png" width="433" height="223"></p>
|
||||
<p>When the "delete" operation is selected, the "Value", "Delimiter" and "Prepended/Appended
|
||||
value" field becomes inaccessible.</p>
|
||||
<p>When performing the variable value calculation the variable name case
|
||||
sensitivity will be taken in account. That is on Windows systems the variables of
|
||||
the different levels or provided by different suppliers whose names differ only
|
||||
in case will be treated as the same variable, while on Unix-like systems where
|
||||
case sensitive variable names are supported variables whose names will differ
|
||||
only in case will be treated as different variables. </p></p>
|
||||
|
||||
|
||||
<p><img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21"><br>
|
||||
<p style="margin-top: 0; margin-bottom: 0"><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>
|
||||
|
|
@ -53,6 +181,9 @@ Customizes the environment variables to be used in building your build configura
|
|||
<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></p>
|
||||
<p style="margin-top: 0; margin-bottom: 0"><a href="cdt_o_mproj_pref.htm">Managed Build Project preferences</a></p>
|
||||
<p style="margin-top: 0; margin-bottom: 0"><a href="cdt_o_mproj_pref_env.htm">Managed Build Project preferences, Environment</a></p>
|
||||
<p style="margin-top: 0; margin-bottom: 0"><a href="cdt_o_mproj_pref_macro.htm">Managed Build Project preferences, Macros</a></p>
|
||||
|
||||
<p>
|
||||
<img src="../images/ng00_04a.gif" ALT="IBM Copyright Statement" >
|
||||
|
|
|
|||
|
|
@ -18,7 +18,7 @@
|
|||
</head>
|
||||
<body>
|
||||
|
||||
<h1>C/C++ Project Properties, Managed, C/C++ Build, Macros</h1>
|
||||
<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>
|
||||
|
||||
|
|
@ -27,9 +27,9 @@ Customizes the build macros used in your build configuration.<p>
|
|||
selected build configuration.</dd>
|
||||
<dt>Configuration:</dt><dd>Select the build configuration from the list provided.</dd>
|
||||
<dt>Manage...</dt><dd>You can add, remove and rename configurations.</dd>
|
||||
<dt>Configuration Settings</dt><dd>You can add and remove build macros for a
|
||||
project or configuration. Each tab contains two tables - one for User
|
||||
defined build macros and one for non user-defined build macros. Each
|
||||
<dt>Configuration Settings</dt><dd>You can add, remove and edit build macros for a
|
||||
project or configuration. Each tab contains two tables - one for user-defined
|
||||
build macros and one for non user-defined build macros. Each
|
||||
table contains three columns<b>:</b><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>
|
||||
|
|
@ -37,7 +37,7 @@ Customizes the build macros used in your build configuration.<p>
|
|||
Macros</b> table.<span style="font:7.0pt "Times New Roman""> </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.</p>
|
||||
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:7.0pt "Times New Roman"">
|
||||
</span>A user-defined macro overrides a non user-defined macro of the same
|
||||
|
|
@ -56,8 +56,8 @@ There are no special restrictions on a macro name, though it is encouraged that
|
|||
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 the backslash in order to distinguish it from a build macro. The Managed
|
||||
Build System pre-defines many useful macros (see below) and allows tool
|
||||
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.</p>
|
||||
<p>Build Macros can hold several types of values:
|
||||
</p>
|
||||
|
|
@ -99,37 +99,43 @@ Several contexts are defined:</p>
|
|||
<p class="MsoNormal" style="text-indent: -.25in; margin-left: .25in">The
|
||||
process environment variables defined in the environment passed to Eclipse.</li>
|
||||
</ol>
|
||||
<p class="MsoNormal">Users can define new macros for any project or
|
||||
configuration of a project. The value of a build macro will be searched
|
||||
<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. </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 already existing
|
||||
macro name, the other fields of the dialog get filled with the value, and value
|
||||
type of that macro.</p>
|
||||
<p>When either 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>
|
||||
<span style="font-size: 12.0pt; font-family: Times New Roman">All macros except
|
||||
All macros except
|
||||
the build process environment macros always get resolved in the makefile.
|
||||
See the ??“expand build environment macros� checkbox in the “Build Settings� tab
|
||||
of the “C/C++ Build�. </span>
|
||||
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 MBS-predefined, neither a
|
||||
tool-integrator nor a user can define new file-context macros, but a
|
||||
tool-integrator can specify the values for the file-context macros using
|
||||
attributes of a builder element. The macro values specified in those attributes
|
||||
should not contain the explicit e.g. file name, but instead should provide the
|
||||
filename definition in terms of the builder automatic variables and text
|
||||
functions. This is needed to allow the makefile generator to generate pattern
|
||||
rules, e.g. in the case of Gnu make, the macro that represents the output file
|
||||
name will contain the “$(notdir $@)? value. The builder definition of the gnu
|
||||
tool-chain will contain attribute specifying the value for that macro. If a
|
||||
tool-integrator does not provide the values for the file-specific macros, MBS
|
||||
will automatically expand them to their actual value when generating the
|
||||
buildfile, e.g. for the foo.c file the macro that represents the input file name
|
||||
will contain “foo.c? in this case. In this case the makefile generator will not
|
||||
be able to use pattern rules for building files with options containing
|
||||
file-specific macros. (see the “Supplying the file-context macros values?
|
||||
section for more detail)</p>
|
||||
<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-collapse: collapse; border: medium none" id="table1" width="695">
|
||||
<tr style="height: 8.3pt">
|
||||
<td valign="top" style="width: 217px; height: 8.3pt; border: 1.0pt solid windowtext; padding-left: 5.4pt; padding-right: 5.4pt; padding-top: 0in; padding-bottom: 0in">
|
||||
|
|
@ -436,7 +442,7 @@ section for more detail)</p>
|
|||
</tr>
|
||||
</table>
|
||||
|
||||
<p><img border="0" src="../images/ngref.gif" ALT="Related reference" width="143" height="21"><br>
|
||||
<p style="margin-top: 0; margin-bottom: 0"><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>
|
||||
|
|
@ -465,6 +471,9 @@ section for more detail)</p>
|
|||
<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></p>
|
||||
<p style="margin-top: 0; margin-bottom: 0"><a href="cdt_o_mproj_pref.htm">Managed Build Project preferences</a></p>
|
||||
<p style="margin-top: 0; margin-bottom: 0"><a href="cdt_o_mproj_pref_env.htm">Managed Build Project preferences, Environment</a></p>
|
||||
<p style="margin-top: 0; margin-bottom: 0"><a href="cdt_o_mproj_pref_macro.htm">Managed Build Project preferences, Macros</a></p>
|
||||
|
||||
<p>
|
||||
<img src="../images/ng00_04a.gif" ALT="IBM Copyright Statement" >
|
||||
|
|
|
|||
|
|
@ -13,11 +13,12 @@
|
|||
<p>This sections explains how to build your project and manage compile errors.</p>
|
||||
<img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_t_proj_rename.htm">Renaming a project</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_t_proj_ref.htm">Selecting referenced projects</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_t_proj_build_set.htm">Defining build settings</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_t_proj_build_set.htm">Defining Standard Make build settings</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_t_mproj_build_set.htm">Defining Managed Make build settings</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_t_proj_error_parser.htm">Filtering errors</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_t_proj_parser.htm">Selecting a binary parser</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_t_proj_paths.htm">Adding Include paths and symbols</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_t_proj_platf.htm">Selecting a deployment platform</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_t_proj_platf.htm">Selecting a project type</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_t_setbuildorder.htm">Setting build order</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_t_manualbuild.htm">Building Manually</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_t_autobuild.htm">Removing Build Automatically</a><br>
|
||||
|
|
|
|||
|
|
@ -21,6 +21,7 @@
|
|||
<img src="../images/trans.gif" border="0" width="50" height="1" alt=""><a style="text-decoration:none" href="cdt_t_new_make.htm">Creating a makefile</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="50" height="1" alt=""><a style="text-decoration:none" href="cdt_t_prvw_hide_files.htm">Hiding files by type in the C/C++ Projects view</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="50" height="1" alt=""><a style="text-decoration:none" href="cdt_t_convert_cdt_proj.htm">Converting CDT 1.x Projects</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="50" height="1" alt=""><a style="text-decoration:none" href="cdt_t_convert_mbs20_proj.htm">Converting CDT 2.x Managed Make Projects</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="50" height="1" alt=""><a style="text-decoration:none" href="cdt_t_add_custom_persp.htm">Adding Convert to a C/C++ Make Project to the New menu</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="50" height="1" alt=""><a style="text-decoration:none" href="cdt_t_discovery.htm">Set Discovery Options</a><br>
|
||||
<img src="../images/trans.gif" border="0" width="25" height="1" alt=""><a style="text-decoration:none" href="cdt_o_write_code.htm">Writing code</a><br>
|
||||
|
|
|
|||
|
|
@ -60,7 +60,10 @@
|
|||
<topic label="Binary Parser" href="reference/cdt_u_newproj_parser_binary.htm"/>
|
||||
<topic label="Discovery Options" href="reference/cdt_u_discovery_preferences.htm"/>
|
||||
</topic>
|
||||
<topic label="Managed Make Project preferences" href="reference/cdt_o_mproj_pref.htm"/>
|
||||
<topic label="Managed Make Project preferences" href="reference/cdt_o_mproj_pref.htm">
|
||||
<topic label="Environment" href="reference/cdt_o_mproj_pref_env.htm"/>
|
||||
<topic label="Build Macros" href="reference/cdt_o_mproj_pref_macro.htm"/>
|
||||
</topic>
|
||||
<topic label="Search preferences" href="reference/cdt_u_search_pref.htm"/>
|
||||
</topic>
|
||||
<topic label="C/C++ Project Properties" href="reference/cdt_u_properties.htm">
|
||||
|
|
@ -74,7 +77,7 @@
|
|||
<topic label="Error Parser" href="reference/cdt_u_mprop_merror.htm"/>
|
||||
<topic label="Binary Parser" href="reference/cdt_u_mprop_mbinary.htm"/>
|
||||
<topic label="Environment" href="reference/cdt_u_mprop_env.htm"/>
|
||||
<topic label="Macros" href="reference/cdt_u_mprop_macros.htm"/>
|
||||
<topic label="Build Macros" href="reference/cdt_u_mprop_macros.htm"/>
|
||||
</topic>
|
||||
<topic label="C/C++ Documentation" href="reference/cdt_u_mprop_documentation.htm"/>
|
||||
<topic label="C/C++ File Types" href="reference/cdt_u_mprop_file_types.htm"/>
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue