~mandel/ubuntuone-windows-installer/fix_null_pointer_start

« back to all changes in this revision

Viewing changes to tools/Nant/doc/help/tasks/csc.html

  • Committer: Manuel de la Pena
  • Date: 2010-07-08 13:22:59 UTC
  • Revision ID: mandel@themacaque.com-20100708132259-y1jgyuyqfe9stt8u
Updated build script to run tests and added all the required tools so far.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
 
2
<html xmlns="http://www.w3.org/1999/xhtml">
 
3
  <!-- Documenting T:NAnt.DotNet.Tasks.CscTask-->
 
4
  <head>
 
5
    <meta http-equiv="Content-Language" content="en-ca" />
 
6
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 
7
    <link rel="stylesheet" type="text/css" href="../style.css" />
 
8
    <title>&lt;csc&gt; Task</title>
 
9
  </head>
 
10
  <body>
 
11
    <table width="100%" border="0" cellspacing="0" cellpadding="2" class="NavBar">
 
12
      <tr>
 
13
        <td class="NavBar-Cell">
 
14
          <a href="http://nant.sourceforge.net">
 
15
            <b>NAnt</b>
 
16
          </a>
 
17
          <img alt="-&gt;" src="../images/arrow.gif" />
 
18
          <a href="../index.html">Help</a>
 
19
          <img alt="-&gt;" src="../images/arrow.gif" />
 
20
          <a href="../tasks/index.html">Task Reference</a>
 
21
          <img alt="-&gt;" src="../images/arrow.gif" /> &lt;csc&gt;</td>
 
22
        <td class="NavBar-Cell" align="right">
 
23
                        v0.90</td>
 
24
      </tr>
 
25
    </table>
 
26
    <h1>&lt;csc&gt;</h1>
 
27
    <p> Compiles C# programs. </p>
 
28
    <p class="i2">
 
29
      <b>Note:</b>  In order to have <a href="../tasks/csc.html">&lt;csc&gt;</a> task generate manifest resource names that match those generated by Microsoft Visual Studio.NET, the value of the <code>prefix</code> attribute of the &lt;<code>resources</code>&gt; element should match the "Default Namespace" of the C# project, and the value of the <code>dynamicprefix</code> attribute should be set to "<b>true</b>". </p>
 
30
    <h3>Parameters</h3>
 
31
    <div class="table">
 
32
      <table>
 
33
        <tr>
 
34
          <th>Attribute</th>
 
35
          <th style="text-align: center;">Type</th>
 
36
          <th>Description</th>
 
37
          <th style="text-align: center;">Required</th>
 
38
        </tr>
 
39
        <tr>
 
40
          <td valign="top">baseaddress</td>
 
41
          <td style="text-align: center;">string</td>
 
42
          <td> The preferred base address at which to load a DLL. The default base address for a DLL is set by the .NET Framework common language runtime. </td>
 
43
          <td style="text-align: center;">False</td>
 
44
        </tr>
 
45
        <tr>
 
46
          <td valign="top">checked</td>
 
47
          <td style="text-align: center;">bool</td>
 
48
          <td> Specifies whether an integer arithmetic statement that is not in the scope of the <code>checked</code> or <code>unchecked</code> keywords and that results in a value outside the range of the data type should cause a run-time exception. The default is <b>false</b>. </td>
 
49
          <td style="text-align: center;">False</td>
 
50
        </tr>
 
51
        <tr>
 
52
          <td valign="top">codepage</td>
 
53
          <td style="text-align: center;">string</td>
 
54
          <td> Specifies the code page to use for all source code files in the compilation. </td>
 
55
          <td style="text-align: center;">False</td>
 
56
        </tr>
 
57
        <tr>
 
58
          <td valign="top">debug</td>
 
59
          <td style="text-align: center;">
 
60
            <a href="../enums/NAnt.DotNet.Types.DebugOutput.html">DebugOutput</a>
 
61
          </td>
 
62
          <td> Specifies the type of debugging information generated by the compiler. The default is <code>None</code>. </td>
 
63
          <td style="text-align: center;">False</td>
 
64
        </tr>
 
65
        <tr>
 
66
          <td valign="top">doc</td>
 
67
          <td style="text-align: center;">file</td>
 
68
          <td> The name of the XML documentation file to generate. </td>
 
69
          <td style="text-align: center;">False</td>
 
70
        </tr>
 
71
        <tr>
 
72
          <td valign="top">filealign</td>
 
73
          <td style="text-align: center;">int</td>
 
74
          <td> Specifies the size of sections in the output file. Valid values are 512, 1024, 2048, 4096, and 8192. </td>
 
75
          <td style="text-align: center;">False</td>
 
76
        </tr>
 
77
        <tr>
 
78
          <td valign="top">langversion</td>
 
79
          <td style="text-align: center;">string</td>
 
80
          <td> Causes the compiler to only accept syntax that is included in a given specification. </td>
 
81
          <td style="text-align: center;">False</td>
 
82
        </tr>
 
83
        <tr>
 
84
          <td valign="top">noconfig</td>
 
85
          <td style="text-align: center;">bool</td>
 
86
          <td> Instructs the compiler not to use implicit references to assemblies. The default is <b>false</b>. </td>
 
87
          <td style="text-align: center;">False</td>
 
88
        </tr>
 
89
        <tr>
 
90
          <td valign="top">nostdlib</td>
 
91
          <td style="text-align: center;">bool</td>
 
92
          <td> Instructs the compiler not to import mscorlib.dll. The default is <b>false</b>. </td>
 
93
          <td style="text-align: center;">False</td>
 
94
        </tr>
 
95
        <tr>
 
96
          <td valign="top">optimize</td>
 
97
          <td style="text-align: center;">bool</td>
 
98
          <td> Specifies whether the compiler should perform optimizations to the make output files smaller, faster, and more effecient. The default is <b>false</b>. </td>
 
99
          <td style="text-align: center;">False</td>
 
100
        </tr>
 
101
        <tr>
 
102
          <td valign="top">platform</td>
 
103
          <td style="text-align: center;">string</td>
 
104
          <td> Specifies which platform version of common language runtime (CLR) can run the output file. </td>
 
105
          <td style="text-align: center;">False</td>
 
106
        </tr>
 
107
        <tr>
 
108
          <td valign="top">unsafe</td>
 
109
          <td style="text-align: center;">bool</td>
 
110
          <td> Instructs the compiler to allow code that uses the <code>unsafe</code> keyword. The default is <b>false</b>. </td>
 
111
          <td style="text-align: center;">False</td>
 
112
        </tr>
 
113
        <tr>
 
114
          <td valign="top">warninglevel</td>
 
115
          <td style="text-align: center;">string</td>
 
116
          <td> Specifies the warning level for the compiler to display. Valid values are <code>0</code>-<code>4</code>. The default is <code>4</code>. </td>
 
117
          <td style="text-align: center;">False</td>
 
118
        </tr>
 
119
        <tr>
 
120
          <td valign="top" class="required">output</td>
 
121
          <td style="text-align: center;">file</td>
 
122
          <td> The output file created by the compiler. </td>
 
123
          <td style="text-align: center;">True</td>
 
124
        </tr>
 
125
        <tr>
 
126
          <td valign="top" class="required">target</td>
 
127
          <td style="text-align: center;">string</td>
 
128
          <td> Output type. Possible values are <code>exe</code>, <code>winexe</code>, <code>library</code> or <code>module</code>. </td>
 
129
          <td style="text-align: center;">True</td>
 
130
        </tr>
 
131
        <tr>
 
132
          <td valign="top">define</td>
 
133
          <td style="text-align: center;">string</td>
 
134
          <td> Define conditional compilation symbol(s). </td>
 
135
          <td style="text-align: center;">False</td>
 
136
        </tr>
 
137
        <tr>
 
138
          <td valign="top">delaysign</td>
 
139
          <td style="text-align: center;">
 
140
            <a href="../enums/NAnt.DotNet.Types.DelaySign.html">DelaySign</a>
 
141
          </td>
 
142
          <td> Specifies whether to delay sign the assembly using only the public portion of the strong name key. The default is <code>NotSet</code>. </td>
 
143
          <td style="text-align: center;">False</td>
 
144
        </tr>
 
145
        <tr>
 
146
          <td valign="top">failonerror</td>
 
147
          <td style="text-align: center;">bool</td>
 
148
          <td> Determines if task failure stops the build, or is just reported. The default is <b>true</b>. </td>
 
149
          <td style="text-align: center;">False</td>
 
150
        </tr>
 
151
        <tr>
 
152
          <td valign="top">if</td>
 
153
          <td style="text-align: center;">bool</td>
 
154
          <td> If <b>true</b> then the task will be executed; otherwise, skipped. The default is <b>true</b>. </td>
 
155
          <td style="text-align: center;">False</td>
 
156
        </tr>
 
157
        <tr>
 
158
          <td valign="top">keycontainer</td>
 
159
          <td style="text-align: center;">string</td>
 
160
          <td> Specifies the key pair container used to strongname the assembly. </td>
 
161
          <td style="text-align: center;">False</td>
 
162
        </tr>
 
163
        <tr>
 
164
          <td valign="top">keyfile</td>
 
165
          <td style="text-align: center;">file</td>
 
166
          <td> Specifies a strong name key file. </td>
 
167
          <td style="text-align: center;">False</td>
 
168
        </tr>
 
169
        <tr>
 
170
          <td valign="top">main</td>
 
171
          <td style="text-align: center;">string</td>
 
172
          <td> Specifies which type contains the Main method that you want to use as the entry point into the program. </td>
 
173
          <td style="text-align: center;">False</td>
 
174
        </tr>
 
175
        <tr>
 
176
          <td valign="top">nowarn</td>
 
177
          <td style="text-align: center;">string</td>
 
178
          <td>
 
179
            <i>Deprecated.</i>  Specifies a comma-separated list of warnings that should be suppressed by the compiler. </td>
 
180
          <td style="text-align: center;">False</td>
 
181
        </tr>
 
182
        <tr>
 
183
          <td valign="top">rebuild</td>
 
184
          <td style="text-align: center;">bool</td>
 
185
          <td> Instructs NAnt to recompile the output file regardless of the file timestamps. </td>
 
186
          <td style="text-align: center;">False</td>
 
187
        </tr>
 
188
        <tr>
 
189
          <td valign="top">timeout</td>
 
190
          <td style="text-align: center;">int</td>
 
191
          <td> The maximum amount of time the application is allowed to execute, expressed in milliseconds. Defaults to no time-out. </td>
 
192
          <td style="text-align: center;">False</td>
 
193
        </tr>
 
194
        <tr>
 
195
          <td valign="top">unless</td>
 
196
          <td style="text-align: center;">bool</td>
 
197
          <td> Opposite of <code>if</code>. If <b>false</b> then the task will be executed; otherwise, skipped. The default is <b>false</b>. </td>
 
198
          <td style="text-align: center;">False</td>
 
199
        </tr>
 
200
        <tr>
 
201
          <td valign="top">verbose</td>
 
202
          <td style="text-align: center;">bool</td>
 
203
          <td> Determines whether the task should report detailed build log messages. The default is <b>false</b>. </td>
 
204
          <td style="text-align: center;">False</td>
 
205
        </tr>
 
206
        <tr>
 
207
          <td valign="top">warnaserror</td>
 
208
          <td style="text-align: center;">bool</td>
 
209
          <td> Instructs the compiler to treat all warnings as errors. The default is <b>false</b>. </td>
 
210
          <td style="text-align: center;">False</td>
 
211
        </tr>
 
212
        <tr>
 
213
          <td valign="top">win32icon</td>
 
214
          <td style="text-align: center;">file</td>
 
215
          <td> Icon to associate with the application. </td>
 
216
          <td style="text-align: center;">False</td>
 
217
        </tr>
 
218
        <tr>
 
219
          <td valign="top">win32res</td>
 
220
          <td style="text-align: center;">file</td>
 
221
          <td> Specifies a Win32 resource file (.res). </td>
 
222
          <td style="text-align: center;">False</td>
 
223
        </tr>
 
224
      </table>
 
225
    </div>
 
226
    <h3>Framework-configurable parameters</h3>
 
227
    <div class="table">
 
228
      <table>
 
229
        <tr>
 
230
          <th>Attribute</th>
 
231
          <th style="text-align: center;">Type</th>
 
232
          <th>Description</th>
 
233
          <th style="text-align: center;">Required</th>
 
234
        </tr>
 
235
        <tr>
 
236
          <td valign="top">exename</td>
 
237
          <td style="text-align: center;">string</td>
 
238
          <td> The name of the executable that should be used to launch the external program. </td>
 
239
          <td style="text-align: center;">False</td>
 
240
        </tr>
 
241
        <tr>
 
242
          <td valign="top">managed</td>
 
243
          <td style="text-align: center;">
 
244
            <a href="../enums/NAnt.Core.Types.ManagedExecution.html">ManagedExecution</a>
 
245
          </td>
 
246
          <td> Specifies whether the external program should be treated as a managed application, possibly forcing it to be executed under the currently targeted version of the CLR. </td>
 
247
          <td style="text-align: center;">False</td>
 
248
        </tr>
 
249
        <tr>
 
250
          <td valign="top">noconfig</td>
 
251
          <td style="text-align: center;">bool</td>
 
252
          <td> Instructs the compiler not to use implicit references to assemblies. The default is <b>false</b>. </td>
 
253
          <td style="text-align: center;">False</td>
 
254
        </tr>
 
255
        <tr>
 
256
          <td valign="top">nostdlib</td>
 
257
          <td style="text-align: center;">bool</td>
 
258
          <td> Instructs the compiler not to import mscorlib.dll. The default is <b>false</b>. </td>
 
259
          <td style="text-align: center;">False</td>
 
260
        </tr>
 
261
        <tr>
 
262
          <td valign="top">supportsdelaysign</td>
 
263
          <td style="text-align: center;">bool</td>
 
264
          <td> Indicates whether the compiler for a given target framework supports the "delaysign" option. The default is <b>false</b>. </td>
 
265
          <td style="text-align: center;">False</td>
 
266
        </tr>
 
267
        <tr>
 
268
          <td valign="top">supportsdocgeneration</td>
 
269
          <td style="text-align: center;">bool</td>
 
270
          <td> Specifies whether the compiler for the active target framework supports generation of XML Documentation file. The default is <b>true</b>. </td>
 
271
          <td style="text-align: center;">False</td>
 
272
        </tr>
 
273
        <tr>
 
274
          <td valign="top">supportskeycontainer</td>
 
275
          <td style="text-align: center;">bool</td>
 
276
          <td> Indicates whether the compiler for a given target framework supports the "keycontainer" option. The default is <b>false</b>. </td>
 
277
          <td style="text-align: center;">False</td>
 
278
        </tr>
 
279
        <tr>
 
280
          <td valign="top">supportskeyfile</td>
 
281
          <td style="text-align: center;">bool</td>
 
282
          <td> Indicates whether the compiler for a given target framework supports the "keyfile" option. The default is <b>false</b>. </td>
 
283
          <td style="text-align: center;">False</td>
 
284
        </tr>
 
285
        <tr>
 
286
          <td valign="top">supportslangversion</td>
 
287
          <td style="text-align: center;">bool</td>
 
288
          <td> Specifies whether the compiler for the active target framework supports accepting only a specific language syntax. The default is <b>false</b>. </td>
 
289
          <td style="text-align: center;">False</td>
 
290
        </tr>
 
291
        <tr>
 
292
          <td valign="top">supportsnowarnlist</td>
 
293
          <td style="text-align: center;">bool</td>
 
294
          <td> Indicates whether the compiler for a given target framework supports a command line option that allows a list of warnings to be suppressed. The default is <b>false</b>. </td>
 
295
          <td style="text-align: center;">False</td>
 
296
        </tr>
 
297
        <tr>
 
298
          <td valign="top">supportspackagereferences</td>
 
299
          <td style="text-align: center;">bool</td>
 
300
          <td> Indicates whether package references are supported by compiler for a given target framework. The default is <b>false</b>. </td>
 
301
          <td style="text-align: center;">False</td>
 
302
        </tr>
 
303
        <tr>
 
304
          <td valign="top">supportsplatform</td>
 
305
          <td style="text-align: center;">bool</td>
 
306
          <td> Specifies whether the compiler for the active target framework supports limiting the platform on which the compiled code can run. The default is <b>false</b>. </td>
 
307
          <td style="text-align: center;">False</td>
 
308
        </tr>
 
309
        <tr>
 
310
          <td valign="top">supportswarnaserrorlist</td>
 
311
          <td style="text-align: center;">bool</td>
 
312
          <td> Indicates whether the compiler for a given target framework supports the "warnaserror" option that takes a list of warnings. The default is <b>false</b>. </td>
 
313
          <td style="text-align: center;">False</td>
 
314
        </tr>
 
315
        <tr>
 
316
          <td valign="top">useruntimeengine</td>
 
317
          <td style="text-align: center;">bool</td>
 
318
          <td>
 
319
            <i>Deprecated.</i>  Specifies whether the external program is a managed application which should be executed using a runtime engine, if configured. The default is <b>false</b>. </td>
 
320
          <td style="text-align: center;">False</td>
 
321
        </tr>
 
322
      </table>
 
323
    </div>
 
324
    <h3>Nested Elements:</h3>
 
325
    <!--Element-->
 
326
    <h4>
 
327
      <a id="warnaserror">
 
328
      </a>
 
329
                    &lt;<a href="../types/warnaserror.html">warnaserror</a>&gt;
 
330
                </h4>
 
331
    <div class="nested-element"> Controls which warnings should be reported as errors. <p /></div>
 
332
    <h4>
 
333
      <a id="warnaserror">
 
334
      </a>
 
335
                    &lt;/<a href="../types/warnaserror.html">warnaserror</a>&gt;
 
336
                </h4>
 
337
    <!--Collection-->
 
338
    <h4>
 
339
      <a id="nowarn">
 
340
      </a>
 
341
            &lt;nowarn&gt;
 
342
        </h4>
 
343
    <div class="nested-element"> Specifies a list of warnings that you want the compiler to suppress. <h5>&lt;warning&gt;</h5><div class="nested-element"><p> Represents a compiler warning. </p><h3>Parameters</h3><div class="table"><table><tr><th>Attribute</th><th style="text-align: center;">Type</th><th>Description</th><th style="text-align: center;">Required</th></tr><tr><td valign="top" class="required">number</td><td style="text-align: center;">string</td><td> A warning number, or comma-separated list of warnings, that you want the compiler to suppress or report. </td><td style="text-align: center;">True</td></tr><tr><td valign="top">if</td><td style="text-align: center;">bool</td><td> If <b>true</b> then the element will be processed; otherwise, skipped. The default is <b>true</b>. </td><td style="text-align: center;">False</td></tr><tr><td valign="top">unless</td><td style="text-align: center;">bool</td><td> If <b>true</b> then the element will be skipped; otherwise, processed. The default is <b>false</b>. </td><td style="text-align: center;">False</td></tr></table></div></div><h5>&lt;/warning&gt;</h5></div>
 
344
    <h4>&lt;/nowarn&gt;</h4>
 
345
    <!--Element-->
 
346
    <h4>
 
347
      <a id="lib">
 
348
      </a>
 
349
                    &lt;<a href="../types/fileset.html">lib</a>&gt;
 
350
                </h4>
 
351
    <div class="nested-element">
 
352
      <i>Deprecated.</i>  Additional directories to search in for assembly references. <p /></div>
 
353
    <h4>
 
354
      <a id="lib">
 
355
      </a>
 
356
                    &lt;/<a href="../types/fileset.html">lib</a>&gt;
 
357
                </h4>
 
358
    <!--Element-->
 
359
    <h4>
 
360
      <a id="references">
 
361
      </a>
 
362
                    &lt;<a href="../types/assemblyfileset.html">references</a>&gt;
 
363
                </h4>
 
364
    <div class="nested-element"> Reference metadata from the specified assembly files. <p /></div>
 
365
    <h4>
 
366
      <a id="references">
 
367
      </a>
 
368
                    &lt;/<a href="../types/assemblyfileset.html">references</a>&gt;
 
369
                </h4>
 
370
    <!--Collection-->
 
371
    <h4>
 
372
      <a id="pkg-references">
 
373
      </a>
 
374
            &lt;pkg-references&gt;
 
375
        </h4>
 
376
    <div class="nested-element"> Specifies list of packages to reference. <h5>&lt;package&gt;</h5><div class="nested-element"><p> Represents a package. </p><h3>Parameters</h3><div class="table"><table><tr><th>Attribute</th><th style="text-align: center;">Type</th><th>Description</th><th style="text-align: center;">Required</th></tr><tr><td valign="top" class="required">name</td><td style="text-align: center;">string</td><td> Name of the package to reference. Multiple package can be specified with a single element as a semi-colon separated list of package names. </td><td style="text-align: center;">True</td></tr><tr><td valign="top">if</td><td style="text-align: center;">bool</td><td> Indicates if the package should be passed to the task. If <b>true</b> then the package will be passed; otherwise, skipped. The default is <b>true</b>. </td><td style="text-align: center;">False</td></tr><tr><td valign="top">unless</td><td style="text-align: center;">bool</td><td> Indicates if the package should not be passed to the task. If <b>false</b> then the package will be passed; otherwise, skipped. The default is <b>false</b>. </td><td style="text-align: center;">False</td></tr></table></div></div><h5>&lt;/package&gt;</h5></div>
 
377
    <h4>&lt;/pkg-references&gt;</h4>
 
378
    <!--Array-->
 
379
    <!--NestedElementArray=T:NAnt.DotNet.Types.ResourceFileSet-->
 
380
    <h4>
 
381
      <a id="resources">
 
382
      </a>
 
383
                    &lt;<a href="../types/resourcefileset.html">resources</a>&gt;
 
384
                </h4>
 
385
    <div class="nested-element"> Resources to embed. </div>
 
386
    <h4>
 
387
      <a id="resources">
 
388
      </a>
 
389
                    &lt;/<a href="../types/resourcefileset.html">resources</a>&gt;
 
390
                </h4>
 
391
    <!--Element-->
 
392
    <h4>
 
393
      <a id="modules">
 
394
      </a>
 
395
                    &lt;<a href="../types/assemblyfileset.html">modules</a>&gt;
 
396
                </h4>
 
397
    <div class="nested-element"> Link the specified modules into this assembly. <p /></div>
 
398
    <h4>
 
399
      <a id="modules">
 
400
      </a>
 
401
                    &lt;/<a href="../types/assemblyfileset.html">modules</a>&gt;
 
402
                </h4>
 
403
    <!--Element-->
 
404
    <h4>
 
405
      <a id="sources">
 
406
      </a>
 
407
                    &lt;<a href="../types/fileset.html">sources</a>&gt;
 
408
                </h4>
 
409
    <div class="nested-element"> The set of source files for compilation. <p /></div>
 
410
    <h4>
 
411
      <a id="sources">
 
412
      </a>
 
413
                    &lt;/<a href="../types/fileset.html">sources</a>&gt;
 
414
                </h4>
 
415
    <!--Array-->
 
416
    <!--NestedElementArray=T:NAnt.Core.Types.Argument-->
 
417
    <h4>
 
418
      <a id="arg">
 
419
      </a>
 
420
                    &lt;arg&gt;
 
421
                </h4>
 
422
    <div class="nested-element"> The command-line arguments for the external program. <p> Represents a command-line argument. </p><p> When passed to an external application, the argument will be quoted when appropriate. This does not apply to the <code>line</code> parameter, which is always passed as is. </p><h3>Parameters</h3><div class="table"><table><tr><th>Attribute</th><th style="text-align: center;">Type</th><th>Description</th><th style="text-align: center;">Required</th></tr><tr><td valign="top">dir</td><td style="text-align: center;">directory</td><td> The value for a directory-based command-line argument; will be replaced with the absolute path of the directory. </td><td style="text-align: center;">False</td></tr><tr><td valign="top">file</td><td style="text-align: center;">file</td><td> The name of a file as a single command-line argument; will be replaced with the absolute filename of the file. </td><td style="text-align: center;">False</td></tr><tr><td valign="top">if</td><td style="text-align: center;">bool</td><td> Indicates if the argument should be passed to the external program. If <b>true</b> then the argument will be passed; otherwise, skipped. The default is <b>true</b>. </td><td style="text-align: center;">False</td></tr><tr><td valign="top">line</td><td style="text-align: center;">string</td><td> List of command-line arguments; will be passed to the executable as is. </td><td style="text-align: center;">False</td></tr><tr><td valign="top">path</td><td style="text-align: center;">&lt;path&gt;</td><td> The value for a PATH-like command-line argument; you can use <code>:</code> or <code>;</code> as path separators and NAnt will convert it to the platform's local conventions, while resolving references to environment variables. </td><td style="text-align: center;">False</td></tr><tr><td valign="top">unless</td><td style="text-align: center;">bool</td><td> Indicates if the argument should not be passed to the external program. If <b>false</b> then the argument will be passed; otherwise, skipped. The default is <b>false</b>. </td><td style="text-align: center;">False</td></tr><tr><td valign="top">value</td><td style="text-align: center;">string</td><td> A single command-line argument; can contain space characters. </td><td style="text-align: center;">False</td></tr></table></div><h3>Nested Elements:</h3><!--Element--><h4><a id="path"></a>
 
423
                    &lt;<a href="../types/path.html">path</a>&gt;
 
424
                </h4><div class="nested-element"> Sets a single command-line argument and treats it like a PATH - ensures the right separator for the local platform is used. <p /></div><h4><a id="path"></a>
 
425
                    &lt;/<a href="../types/path.html">path</a>&gt;
 
426
                </h4><h3>Examples</h3><ul class="examples"><li><p> A single command-line argument containing a space character. </p><pre class="code">
 
427
&lt;arg value="-l -a" /&gt;
 
428
    </pre></li><li><p> Two separate command-line arguments. </p><pre class="code">
 
429
&lt;arg line="-l -a" /&gt;
 
430
    </pre></li><li><p> A single command-line argument with the value <code>\dir;\dir2;\dir3</code> on DOS-based systems and <code>/dir:/dir2:/dir3</code> on Unix-like systems. </p><pre class="code">
 
431
&lt;arg path="/dir;/dir2:\dir3" /&gt;
 
432
    </pre></li></ul></div>
 
433
    <h4>
 
434
      <a id="arg">
 
435
      </a>
 
436
                    &lt;/arg&gt;
 
437
                </h4>
 
438
    <h3>Examples</h3>
 
439
    <ul class="examples">
 
440
      <li>
 
441
        <p>Compile a "HelloWorld" application, including embedded resources.</p>
 
442
        <pre class="code">
 
443
&lt;csc target="exe" output="HelloWorld.exe" debug="true"&gt;
 
444
    &lt;nowarn&gt;
 
445
        &lt;!-- do not report warnings for missing XML comments --&gt;
 
446
        &lt;warning number="0519" /&gt;
 
447
    &lt;/nowarn&gt;
 
448
    &lt;sources&gt;
 
449
        &lt;include name="**/*.cs" /&gt;
 
450
    &lt;/sources&gt;
 
451
    &lt;resources dynamicprefix="true" prefix="HelloWorld"&gt;
 
452
        &lt;include name="**/*.resx" /&gt;
 
453
    &lt;/resources&gt;
 
454
    &lt;references&gt;
 
455
        &lt;include name="System.dll" /&gt;
 
456
        &lt;include name="System.Data.dll" /&gt;
 
457
    &lt;/references&gt;
 
458
&lt;/csc&gt;
 
459
    </pre>
 
460
      </li>
 
461
    </ul>
 
462
    <h3>Requirements</h3>
 
463
    <div style="margin-left: 20px;">
 
464
      <b>Assembly:</b> NAnt.DotNetTasks (0.90.3780.0)
 
465
            </div>
 
466
  </body>
 
467
</html>
 
 
b'\\ No newline at end of file'