ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ste...@apache.org
Subject cvs commit: jakarta-ant/docs/manual/OptionalTasks dotnet.html
Date Sun, 01 Dec 2002 01:31:05 GMT
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 @@
           /&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 
  
  
  

--
To unsubscribe, e-mail:   <mailto:ant-dev-unsubscribe@jakarta.apache.org>
For additional commands, e-mail: <mailto:ant-dev-help@jakarta.apache.org>


Mime
View raw message