stevel 2002/11/30 17:31:05
Modified: docs/manual/OptionalTasks dotnet.html
Log:
<vbc> docs
Revision Changes Path
1.10 +194 -0 jakarta-ant/docs/manual/OptionalTasks/dotnet.html
Index: dotnet.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/manual/OptionalTasks/dotnet.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- dotnet.html 22 Jun 2002 23:38:28 -0000 1.9
+++ dotnet.html 1 Dec 2002 01:31:05 -0000 1.10
@@ -221,6 +221,200 @@
/>
</pre>
<hr>
+<h2><VBC></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: <vbc/> 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="**/*.vb"</b> and
+<b>excludes="broken.vb"</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">"true"(default) or "false"</td>
+ </tr>
+<tr>
+ <td valign="top">definitions</td>
+ <td valign="top">defined constants</td>
+ <td valign="top"> "RELEASE;BETA1"</td>
+ </tr>
+<tr>
+ <td valign="top">debug</td>
+ <td valign="top">include debug information</td>
+ <td valign="top">"true"(default)</td>
+ </tr>
+
+<tr>
+ <td valign="top">destFile</td>
+ <td valign="top">name of exe/library to create</td>
+ <td valign="top">"example.exe"</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>"/warnaserror+ /baseaddress:0x12840000"</td>
+ </tr>
+
+ <tr>
+ <td valign="top">failOnError</td>
+ <td valign="top">Should a failed compile halt the build?</td>
+ <td valign="top">"true"(default) or "false"</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">"com.example.project.entrypoint"</td>
+ </tr>
+<tr>
+ <td valign="top">optimize</td>
+ <td valign="top">optimisation flag</td>
+ <td valign="top">"true" or "false"(default)</td>
+ </tr>
+<tr>
+ <td valign="top">optionCompare</td>
+ <td valign="top">Text or binary string comparisons.</td>
+ <td valign="top">"text" or "binary"(default)</td>
+ </tr>
+<tr>
+ <td valign="top">optionExplicit</td>
+ <td valign="top">Require explicit declaration of variables?</td>
+ <td valign="top">"true" or "false"(default)</td>
+ </tr>
+<tr>
+ <td valign="top">optionStrict</td>
+ <td valign="top">Enforce strict language semantics?</td>
+ <td valign="top">"true" or "false"(default)</td>
+ </tr>
+<tr>
+ <td valign="top">references</td>
+ <td valign="top">Semicolon separated list of dlls to refer to</td>
+ <td valign="top">"mylib.dll;nunit.dll"</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">"true" or "false"(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">"."</td>
+ </tr>
+<tr>
+ <td valign="top">targetType</td>
+ <td valign="top">Type of target</td>
+ <td valign="top">"exe", "module", "winexe"
or "library"</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">"true" or "false"(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">"1"-"4"</td>
+ </tr>
+<tr>
+ <td valign="top">win32Icon</td>
+ <td valign="top">filename of icon to include</td>
+ <td valign="top">"res/myicon.ico"</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">"res/myapp.res"</td>
+ </tr>
+
+</table>
+<p>
+Example
+</p>
+<pre><vbc
+ optimize="true"
+ debug="false"
+ warnLevel="4"
+ targetType="exe"
+ definitions="RELEASE"
+ excludes="src/unicode_class.vb"
+ mainClass = "MainApp"
+ destFile="NetApp.exe"
+ optionExplicit="true"
+ optionCompare="text"
+ />
+</pre>
+<hr>
<h2><ilasm></h2>
<p>Task to assemble .net 'Intermediate Language' files.
The task will only work on windows until other platforms support csc.exe or
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
