1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
|
<!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;
}
-->
</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-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.
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>},
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.</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.
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.
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.
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.
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>
|
