<vbc> docs

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@273592 13f79535-47bb-0310-9956-ffa450edef68

docs/manual/OptionalTasks/dotnet.html

@@ -221,6 +221,200 @@ Example
         />   
 </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