Browse Source

<vbc> docs

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@273592 13f79535-47bb-0310-9956-ffa450edef68
master
Steve Loughran 22 years ago
parent
commit
851ecf269e
1 changed files with 194 additions and 0 deletions
  1. +194
    -0
      docs/manual/OptionalTasks/dotnet.html

+ 194
- 0
docs/manual/OptionalTasks/dotnet.html View File

@@ -221,6 +221,200 @@ Example
/&gt;
</pre>
<hr>
<h2>&lt;VBC&gt;</h2>

This task compiles VisualBasic.NET source into executables or modules.

This task compiles VisualBasic.NET source into executables or modules.
The task will only work on win2K/XP or other platforms with vbc.exe
or an equivalent. VBC must be on the execute path.

<p>
All parameters are optional: &lt;vbc/&gt; should suffice to produce a debug
build of all *.vb files. References to external files do require explicit
enumeration, so are one of the first attributes to consider adding. </p>

<p>

The task is a directory based task, so attributes like
<b>includes=&quot;**/*.vb&quot;</b> and
<b>excludes=&quot;broken.vb&quot;</b> can be used to control
the files pulled in. By default,
all *.vb files from the project folder down are included in the command.
When this happens the destFile -if not specified-
is taken as the first file in the list, which may be somewhat hard to control.
Specifying the output file with <b>'destfile'</b> seems prudent. </p>
<p>
Also, dependency checking only works if destfile is set.

<table border="1" cellpadding="2" cellspacing="0">
<tr>
<td valign="top"><b>Attribute</b></td>
<td valign="top"><b>Description</b></td>
<td align="center" valign="top"><b>Example Values</b></td>
</tr>

<tr>
<td valign="top">additionalModules</td>
<td valign="top">Semicolon separated list of modules to refer to</td>
</tr>
<tr>
<td valign="top">defaultexcludes</td>
<td valign="top">indicates whether default excludes should be used or not
</td>
<td valign="top">&quot;true&quot;(default) or &quot;false&quot;</td>
</tr>
<tr>
<td valign="top">definitions</td>
<td valign="top">defined constants</td>
<td valign="top"> &quot;RELEASE;BETA1&quot;</td>
</tr>
<tr>
<td valign="top">debug</td>
<td valign="top">include debug information</td>
<td valign="top">&quot;true&quot;(default)</td>
</tr>

<tr>
<td valign="top">destFile</td>
<td valign="top">name of exe/library to create</td>
<td valign="top">&quot;example.exe&quot;</td>
</tr>
<tr>
<td valign="top">excludes</td>
<td valign="top">comma- or space-separated list of patterns of files that must be
excluded. No files (except default excludes) are excluded when omitted.</td>
</tr>
<tr>
<td valign="top">excludesfile</td>
<td valign="top">the name of a file. Each line of this file is
taken to be an exclude pattern</td>
</tr>
<tr>
<td valign="top">extraOptions</td>
<td valign="top">Any extra options which aren't explicitly
supported by the VisualBasicCompile task </td>
<td>&quot;/warnaserror+ /baseaddress:0x12840000&quot;</td>
</tr>

<tr>
<td valign="top">failOnError</td>
<td valign="top">Should a failed compile halt the build?</td>
<td valign="top">&quot;true&quot;(default) or &quot;false&quot;</td>
</tr>
<tr>
<td valign="top">imports</td>
<td valign="top">comma-separated list of global imports for namespaces
in referenced metadata files.</td>
</tr>
<tr>
<td valign="top">includes</td>
<td valign="top">comma- or space-separated list of patterns of files that must be
included. All files are included when omitted.</td>
</tr>
<tr>
<td valign="top">includesfile</td>
<td valign="top">the name of a file. Each line of this file is
taken to be an include pattern</td>
</tr>
<tr>
<td valign="top">mainClass</td>
<td valign="top">name of main class for executables</td>
<td valign="top">&quot;com.example.project.entrypoint&quot;</td>
</tr>
<tr>
<td valign="top">optimize</td>
<td valign="top">optimisation flag</td>
<td valign="top">&quot;true&quot; or &quot;false&quot;(default)</td>
</tr>
<tr>
<td valign="top">optionCompare</td>
<td valign="top">Text or binary string comparisons.</td>
<td valign="top">&quot;text&quot; or &quot;binary&quot;(default)</td>
</tr>
<tr>
<td valign="top">optionExplicit</td>
<td valign="top">Require explicit declaration of variables?</td>
<td valign="top">&quot;true&quot; or &quot;false&quot;(default)</td>
</tr>
<tr>
<td valign="top">optionStrict</td>
<td valign="top">Enforce strict language semantics?</td>
<td valign="top">&quot;true&quot; or &quot;false&quot;(default)</td>
</tr>
<tr>
<td valign="top">references</td>
<td valign="top">Semicolon separated list of dlls to refer to</td>
<td valign="top">&quot;mylib.dll;nunit.dll&quot;</td>
</tr>
<tr>
<td valign="top">referenceFiles </td>
<td valign="top">Ant Path descriptioon of references to include.
Wildcards should work. </td>
<td valign="top"></td>
</tr>
<tr>
<td valign="top">removeIntChecks</td>
<td valign="top">Remove integer checks?</td>
<td valign="top">&quot;true&quot; or &quot;false&quot;(default)</td>
</tr>
<tr>
<td valign="top">rootNamespace</td>
<td valign="top">Root namespace for all type declarations.</td>
<td valign="top">com.example</td>
</tr>
<tr>
<td valign="top">srcDir</td>
<td valign="top">source directory (default = project directory)</td>
<td valign="top">&quot;.&quot;</td>
</tr>
<tr>
<td valign="top">targetType</td>
<td valign="top">Type of target</td>
<td valign="top">&quot;exe&quot;, &quot;module&quot;, &quot;winexe&quot; or &quot;library&quot;</td>
</tr>
<tr>
<td valign="top">utf8output</td>
<td valign="top">require all compiler output to be in utf-8 format</td>
<td valign="top">&quot;true&quot; or &quot;false&quot;(default)</td>
</tr>
<tr>
<td valign="top">warnLevel</td>
<td valign="top">level of warning currently between 1 and 4 with 4
being the strictest. </td>
<td valign="top">&quot;1&quot;-&quot;4&quot;</td>
</tr>
<tr>
<td valign="top">win32Icon</td>
<td valign="top">filename of icon to include</td>
<td valign="top">&quot;res/myicon.ico&quot;</td>
</tr>
<tr>
<td valign="top">win32res</td>
<td valign="top">filename of a win32 resource (.RES)file to include
This is not a .NET resource, but it what windows is used to.</td>
<td valign="top">&quot;res/myapp.res&quot;</td>
</tr>

</table>
<p>
Example
</p>
<pre>&lt;vbc
optimize=&quot;true&quot;
debug=&quot;false&quot;
warnLevel=&quot;4&quot;
targetType=&quot;exe&quot;
definitions=&quot;RELEASE&quot;
excludes=&quot;src/unicode_class.vb&quot;
mainClass = &quot;MainApp&quot;
destFile=&quot;NetApp.exe&quot;
optionExplicit=&quot;true&quot;
optionCompare=&quot;text&quot;
/&gt;
</pre>
<hr>
<h2>&lt;ilasm&gt;</h2>
<p>Task to assemble .net 'Intermediate Language' files.
The task will only work on windows until other platforms support csc.exe or


Loading…
Cancel
Save