youys
/
ant
Not watched
1
0
Fork 1
Code
Releases 0 Wiki Activity
Issues 0 Pull Requests 0 Datasets Model Cloudbrain
You can not select more than 25 topics Topics must start with a chinese character,a letter or number, can include dashes ('-') and can be up to 35 characters long.
Tree: c9f7dca90e
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'c9f7dca90e'
${ noResults }
ant/proposal/myrmidon/docs/user.html

1304 lines
51 KiB
Raw Blame History 

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

  2. 

  3. <!-- Content Stylesheet for Site -->

  4. 

  5.     

  6. <!-- start the processing -->

  7.     <html>

  8.     <head>

  9.       <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>

  10.   

  11.                       <meta name="author" value="Adam Murdoch">

  12.   <meta name="email" value="adammurdoch@apache.org">

  13.         

  14.       <title>Apache Myrmidon - User Guide</title>

  15.     </head>

  16.   

  17.     <body bgcolor="#ffffff" text="#000000" link="#525D76">    

  18.       <table border="0" width="100%" cellspacing="0">

  19.         <!-- TOP IMAGE -->

  20.         <tr>

  21.                 <td colspan="2">

  22.     <a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left" border="0"/></a>

  23.     </td>

  24.           </tr>

  25.       </table>

  26.       <table border="0" width="100%" cellspacing="4">

  27.         <tr><td colspan="2">

  28.           <hr noshade="" size="1"/>

  29.         </td></tr>

  30.         

  31.         <tr>

  32.           <!-- LEFT SIDE NAVIGATION -->

  33.           <td valign="top" nowrap="true">

  34.                 <p><strong>Myrmidon</strong></p>

  35.     <ul>

  36.           <li>      <a href="./index.html">Introduction</a>

  37.   </li>

  38.           <li>      <a href="./user.html">User Guide</a>

  39.   </li>

  40.           <li>      <a href="./todo.html">Get Involved</a>

  41.   </li>

  42.           <li>      <a href="./todo.html#Todo List">Todo List</a>

  43.   </li>

  44.         </ul>

  45.             </td>

  46.           <td align="left" valign="top">

  47.         <table border="0" cellspacing="0" cellpadding="2" width="100%">

  48.     <tr><td bgcolor="#525D76">

  49.       <font color="#ffffff" face="arial,helvetica,sanserif">

  50.         <a name="Building Myrmidon"><strong>Building Myrmidon</strong></a>

  51.       </font>

  52.     </td></tr>

  53.     <tr><td>

  54.       <blockquote>

  55.                         <p>

  56. First, you will need to fetch the Myrmidon source from CVS.  The source

  57. can be source in the <code>proposal/myrmidon</code> directory of the

  58. Ant source tree.  You should check out the <code>jakarta-ant</code> CVS

  59. module, as described

  60. <a href="http://jakarta.apache.org/site/cvsindex.html">here</a>.

  61. </p>

  62.                                 <p>

  63. To build Myrmidon, use the <code>build.xml</code> build script.  You will need

  64. to use Ant 1.4.1 or later.  The default target builds the Myrmidon distribution

  65. into the <code>dist</code> directory.  The distribution is a ready-to-run

  66. installation of Myrmidon.

  67. </p>

  68.                                 <p>There are a number features that are not built unless the appropriate optional Jar

  69. files are found in the <code>lib</code> directory:</p>

  70.                                   <table>

  71.               <tr>

  72.                   <td bgcolor="#039acc" colspan="" rowspan="" 

  73.       valign="top" align="left">

  74.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  75.           Feature

  76.         </font>

  77.   </td>

  78.                       <td bgcolor="#039acc" colspan="" rowspan="" 

  79.       valign="top" align="left">

  80.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  81.           Jar File

  82.         </font>

  83.   </td>

  84.                       <td bgcolor="#039acc" colspan="" rowspan="" 

  85.       valign="top" align="left">

  86.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  87.           Download From

  88.         </font>

  89.   </td>

  90.       </tr>

  91.                   <tr>

  92.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  93.       valign="top" align="left">

  94.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  95.           SMB VFS support (Samba, Windows shares)

  96.         </font>

  97.   </td>

  98.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  99.       valign="top" align="left">

  100.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  101.           jcifs.jar

  102.         </font>

  103.   </td>

  104.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  105.       valign="top" align="left">

  106.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  107.           <a href="http://jcifs.samba.org">jcifs.samba.org</a>

  108.         </font>

  109.   </td>

  110.       </tr>

  111.                   <tr>

  112.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  113.       valign="top" align="left">

  114.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  115.           FTP VFS support

  116.         </font>

  117.   </td>

  118.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  119.       valign="top" align="left">

  120.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  121.           netcomponents.jar

  122.         </font>

  123.   </td>

  124.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  125.       valign="top" align="left">

  126.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  127.           <a href="http://www.savarese.org/oro/software/NetComponents.html">www.savarese.org</a>

  128.         </font>

  129.   </td>

  130.       </tr>

  131.         </table>

  132.                     </blockquote>

  133.     </td></tr>

  134.   </table>

  135.         <table border="0" cellspacing="0" cellpadding="2" width="100%">

  136.     <tr><td bgcolor="#525D76">

  137.       <font color="#ffffff" face="arial,helvetica,sanserif">

  138.         <a name="Running Myrmidon"><strong>Running Myrmidon</strong></a>

  139.       </font>

  140.     </td></tr>

  141.     <tr><td>

  142.       <blockquote>

  143.                         <p>

  144. To run Myrmidon, use one of the following methods:

  145. </p>

  146.                                   <table border="0" cellspacing="0" cellpadding="2" width="100%">

  147.     <tr><td bgcolor="#828DA6">

  148.       <font color="#ffffff" face="arial,helvetica,sanserif">

  149.         <a name="Launcher Script"><strong>Launcher Script</strong></a>

  150.       </font>

  151.     </td></tr>

  152.     <tr><td>

  153.       <blockquote>

  154.                         <p>

  155. On Windows and Unix platforms, you can use the <code>ant</code> script

  156. in the distribution's <code>bin</code> directory.  The following environment

  157. variables can be used, but are not required (except on Windows 9x - see below).

  158. </p>

  159.                                 <p>

  160. 

  161. </p>

  162.                                   <table>

  163.               <tr>

  164.                   <td bgcolor="#039acc" colspan="" rowspan="" 

  165.       valign="top" align="left">

  166.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  167.           Variable

  168.         </font>

  169.   </td>

  170.                       <td bgcolor="#039acc" colspan="" rowspan="" 

  171.       valign="top" align="left">

  172.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  173.           Description

  174.         </font>

  175.   </td>

  176.       </tr>

  177.                   <tr>

  178.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  179.       valign="top" align="left">

  180.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  181.           JAVA_HOME

  182.         </font>

  183.   </td>

  184.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  185.       valign="top" align="left">

  186.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  187.           The directory that the JDK is installed in.

  188.         </font>

  189.   </td>

  190.       </tr>

  191.                   <tr>

  192.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  193.       valign="top" align="left">

  194.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  195.           JAVACMD

  196.         </font>

  197.   </td>

  198.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  199.       valign="top" align="left">

  200.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  201.           The command to use to start the JVM.  Defaults to <code>java</code>.

  202.         </font>

  203.   </td>

  204.       </tr>

  205.                   <tr>

  206.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  207.       valign="top" align="left">

  208.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  209.           ANT_HOME

  210.         </font>

  211.   </td>

  212.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  213.       valign="top" align="left">

  214.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  215.           

  216.             The directory containing the Myrmidon distribution.  This must be

  217.             set when running on Windows 95, 98 or Me.

  218.         

  219.         </font>

  220.   </td>

  221.       </tr>

  222.         </table>

  223.                     </blockquote>

  224.     </td></tr>

  225.   </table>

  226.                                   <table border="0" cellspacing="0" cellpadding="2" width="100%">

  227.     <tr><td bgcolor="#828DA6">

  228.       <font color="#ffffff" face="arial,helvetica,sanserif">

  229.         <a name="Executable Jar File"><strong>Executable Jar File</strong></a>

  230.       </font>

  231.     </td></tr>

  232.     <tr><td>

  233.       <blockquote>

  234.                         <p>

  235. The Myrmidon distribution includes an executable Jar file, which can be used

  236. to run Myrmidon.  Use the following command:

  237. </p>

  238.                                 <pre>

  239. prompt&gt; <i>java</i> -jar <i>ant-home</i>/bin/myrmidon-launcher.jar <i>options</i>

  240. </pre>

  241.                     </blockquote>

  242.     </td></tr>

  243.   </table>

  244.                                 <p>When started, Myrmidon looks for a project file called <code>build.ant</code>

  245. in the current directory.  A different project file can be specified using the

  246. <code>-f</code> command-line option.  Myrmidon executes the targets given on

  247. the command-line, or the default target if none is given.  For example, the

  248. following executes the targets <code>clean</code> and <code>build</code> from

  249. the project file <code>my-project.xml</code>:</p>

  250.                                 <pre>

  251. prompt&gt; ant -f my-project.xml clean build

  252. </pre>

  253.                                 <p>

  254. Run Myrmidon with the <code>-h</code> command-line option for a list of

  255. the command-line options that are available.

  256. </p>

  257.                     </blockquote>

  258.     </td></tr>

  259.   </table>

  260.         <table border="0" cellspacing="0" cellpadding="2" width="100%">

  261.     <tr><td bgcolor="#525D76">

  262.       <font color="#ffffff" face="arial,helvetica,sanserif">

  263.         <a name="Project File"><strong>Project File</strong></a>

  264.       </font>

  265.     </td></tr>

  266.     <tr><td>

  267.       <blockquote>

  268.                         <p>

  269. The project file format is very similar to that of Ant 1.  The root element of

  270. the project file must be a <code>&lt;project&gt;</code> element.  It can

  271. take the following attributes:

  272. </p>

  273.                                   <table>

  274.               <tr>

  275.                   <td bgcolor="#039acc" colspan="" rowspan="" 

  276.       valign="top" align="left">

  277.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  278.           Attribute

  279.         </font>

  280.   </td>

  281.                       <td bgcolor="#039acc" colspan="" rowspan="" 

  282.       valign="top" align="left">

  283.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  284.           Description

  285.         </font>

  286.   </td>

  287.                       <td bgcolor="#039acc" colspan="" rowspan="" 

  288.       valign="top" align="left">

  289.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  290.           Default Value

  291.         </font>

  292.   </td>

  293.       </tr>

  294.                   <tr>

  295.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  296.       valign="top" align="left">

  297.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  298.           name

  299.         </font>

  300.   </td>

  301.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  302.       valign="top" align="left">

  303.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  304.           The project name.

  305.         </font>

  306.   </td>

  307.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  308.       valign="top" align="left">

  309.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  310.           The base-name of the project file, with the extension removed.

  311.         </font>

  312.   </td>

  313.       </tr>

  314.                   <tr>

  315.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  316.       valign="top" align="left">

  317.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  318.           basedir

  319.         </font>

  320.   </td>

  321.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  322.       valign="top" align="left">

  323.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  324.           The base directory for the project.  The base directory is used

  325.         to resolve all relative file names used in the project file.

  326.         

  327.         </font>

  328.   </td>

  329.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  330.       valign="top" align="left">

  331.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  332.           The directory containing the project file.

  333.         </font>

  334.   </td>

  335.       </tr>

  336.                   <tr>

  337.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  338.       valign="top" align="left">

  339.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  340.           default

  341.         </font>

  342.   </td>

  343.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  344.       valign="top" align="left">

  345.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  346.           The name of the default target.

  347.         </font>

  348.   </td>

  349.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  350.       valign="top" align="left">

  351.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  352.           <code>main</code>

  353.         </font>

  354.   </td>

  355.       </tr>

  356.                   <tr>

  357.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  358.       valign="top" align="left">

  359.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  360.           version

  361.         </font>

  362.   </td>

  363.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  364.       valign="top" align="left">

  365.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  366.           The project file version that the project is written for.

  367.         </font>

  368.   </td>

  369.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  370.       valign="top" align="left">

  371.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  372.           None, must be <code>2.0</code>

  373.         </font>

  374.   </td>

  375.       </tr>

  376.         </table>

  377.                                 <p>

  378. A <code>&lt;project&gt;</code> element can contain the following elements,

  379. in the order given below:

  380. </p>

  381.                                 <ul>

  382. <li><a href="#Project References"><code>&lt;projectref&gt;</code></a></li>

  383. <li><a href="#Library Imports"><code>&lt;import&gt;</code></a></li>

  384. <li><a href="#Implicit Tasks">Implicit tasks</a></li>

  385. <li><a href="#Targets"><code>&lt;target&gt;</code></a></li>

  386. </ul>

  387.                                   <table border="0" cellspacing="0" cellpadding="2" width="100%">

  388.     <tr><td bgcolor="#828DA6">

  389.       <font color="#ffffff" face="arial,helvetica,sanserif">

  390.         <a name="Project References"><strong>Project References</strong></a>

  391.       </font>

  392.     </td></tr>

  393.     <tr><td>

  394.       <blockquote>

  395.                         <p>Project references allow the project to import, or reference, other projects.

  396. A <code>&lt;projectref&gt;</code> element takes the following attributes:</p>

  397.                                   <table>

  398.               <tr>

  399.                   <td bgcolor="#039acc" colspan="" rowspan="" 

  400.       valign="top" align="left">

  401.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  402.           Attribute

  403.         </font>

  404.   </td>

  405.                       <td bgcolor="#039acc" colspan="" rowspan="" 

  406.       valign="top" align="left">

  407.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  408.           Description

  409.         </font>

  410.   </td>

  411.                       <td bgcolor="#039acc" colspan="" rowspan="" 

  412.       valign="top" align="left">

  413.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  414.           Default Value

  415.         </font>

  416.   </td>

  417.       </tr>

  418.                   <tr>

  419.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  420.       valign="top" align="left">

  421.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  422.           name

  423.         </font>

  424.   </td>

  425.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  426.       valign="top" align="left">

  427.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  428.           The name to use to identify the referenced project.

  429.         </font>

  430.   </td>

  431.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  432.       valign="top" align="left">

  433.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  434.           Required

  435.         </font>

  436.   </td>

  437.       </tr>

  438.                   <tr>

  439.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  440.       valign="top" align="left">

  441.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  442.           location

  443.         </font>

  444.   </td>

  445.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  446.       valign="top" align="left">

  447.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  448.           The path to the project file to reference.

  449.         </font>

  450.   </td>

  451.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  452.       valign="top" align="left">

  453.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  454.           Required

  455.         </font>

  456.   </td>

  457.       </tr>

  458.         </table>

  459.                                 <p>

  460. The targets of a referenced project can be used in the <code>depends</code> list

  461. of a target in the referencing project, using the following syntax:

  462. <code><i>project-name</i>-&gt;<i>target-name</i></code>.  Here is a simple example:</p>

  463.                                   <div align="left">

  464.     <table cellspacing="4" cellpadding="0" border="0">

  465.       <tr>

  466.         <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  467.         <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  468.         <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  469.       </tr>

  470.       <tr>

  471.         <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  472.         <td bgcolor="#ffffff"><pre>

  473. 

  474. &lt;project version=&quot;2.0&quot;&gt;

  475.     &lt;!-- Reference another project --&gt;

  476.     &lt;projectref name=&quot;subproject&quot; location=&quot;subproject/build.xml&quot;/&gt;

  477. 

  478.     &lt;!-- Use the &quot;compile&quot; target from the referenced project --&gt;

  479.     &lt;target name=&quot;main&quot; depends=&quot;subproject-&gt;compile&quot;&gt;

  480.         .. do some stuff ..

  481.     &lt;/target&gt;

  482. &lt;/project&gt;

  483. </pre></td>

  484.         <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  485.       </tr>

  486.       <tr>

  487.         <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  488.         <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  489.         <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  490.       </tr>

  491.     </table>

  492.   </div>

  493.                     </blockquote>

  494.     </td></tr>

  495.   </table>

  496.                                   <table border="0" cellspacing="0" cellpadding="2" width="100%">

  497.     <tr><td bgcolor="#828DA6">

  498.       <font color="#ffffff" face="arial,helvetica,sanserif">

  499.         <a name="Library Imports"><strong>Library Imports</strong></a>

  500.       </font>

  501.     </td></tr>

  502.     <tr><td>

  503.       <blockquote>

  504.                         <p>Library imports allow the project to import the tasks and data-types from an

  505. antlib.  An <code>&lt;import&gt;</code> element takes the following attributes:</p>

  506.                                   <table>

  507.               <tr>

  508.                   <td bgcolor="#039acc" colspan="" rowspan="" 

  509.       valign="top" align="left">

  510.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  511.           Attribute

  512.         </font>

  513.   </td>

  514.                       <td bgcolor="#039acc" colspan="" rowspan="" 

  515.       valign="top" align="left">

  516.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  517.           Description

  518.         </font>

  519.   </td>

  520.                       <td bgcolor="#039acc" colspan="" rowspan="" 

  521.       valign="top" align="left">

  522.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  523.           Default Value

  524.         </font>

  525.   </td>

  526.       </tr>

  527.                   <tr>

  528.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  529.       valign="top" align="left">

  530.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  531.           library

  532.         </font>

  533.   </td>

  534.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  535.       valign="top" align="left">

  536.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  537.           The name of the library to import.  The <code>ext</code> directory

  538.         of the Myrmidon distribution is searched for a library file with

  539.         the given name, and an <code>atl</code> extension.

  540.         </font>

  541.   </td>

  542.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  543.       valign="top" align="left">

  544.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  545.           Required

  546.         </font>

  547.   </td>

  548.       </tr>

  549.                   <tr>

  550.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  551.       valign="top" align="left">

  552.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  553.           type

  554.         </font>

  555.   </td>

  556.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  557.       valign="top" align="left">

  558.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  559.           The type of definition to import.  Values include <code>task</code>,

  560.         and <code>data-type</code>.

  561.         </font>

  562.   </td>

  563.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  564.       valign="top" align="left">

  565.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  566.           None

  567.         </font>

  568.   </td>

  569.       </tr>

  570.                   <tr>

  571.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  572.       valign="top" align="left">

  573.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  574.           name

  575.         </font>

  576.   </td>

  577.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  578.       valign="top" align="left">

  579.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  580.           The name of the type to import.

  581.         </font>

  582.   </td>

  583.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  584.       valign="top" align="left">

  585.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  586.           None

  587.         </font>

  588.   </td>

  589.       </tr>

  590.         </table>

  591.                                 <p>

  592. If the <code>type</code> and <code>name</code> attributes are not provided,

  593. the entire contents of the antlib are imported.

  594. </p>

  595.                                 <p>The following example import the <code>&lt;my-task&gt;</code> task from

  596. the <code>my-tasks</code> antlib.</p>

  597.                                   <div align="left">

  598.     <table cellspacing="4" cellpadding="0" border="0">

  599.       <tr>

  600.         <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  601.         <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  602.         <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  603.       </tr>

  604.       <tr>

  605.         <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  606.         <td bgcolor="#ffffff"><pre>

  607. 

  608. &lt;project version=&quot;2.0&quot;&gt;

  609.   &lt;!-- Import task &lt;my-task&gt; from the 'my-tasks' antlib. --&gt;

  610.   &lt;import library=&quot;my-tasks&quot; type=&quot;task&quot; name=&quot;my-task&quot;/&gt;

  611. 

  612.   &lt;target name=&quot;main&quot;&gt;

  613.      &lt;my-task some-prop=&quot;..&quot;/&gt;

  614.   &lt;/target&gt;

  615. &lt;/project&gt;

  616. </pre></td>

  617.         <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  618.       </tr>

  619.       <tr>

  620.         <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  621.         <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  622.         <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  623.       </tr>

  624.     </table>

  625.   </div>

  626.                     </blockquote>

  627.     </td></tr>

  628.   </table>

  629.                                   <table border="0" cellspacing="0" cellpadding="2" width="100%">

  630.     <tr><td bgcolor="#828DA6">

  631.       <font color="#ffffff" face="arial,helvetica,sanserif">

  632.         <a name="Implicit Tasks"><strong>Implicit Tasks</strong></a>

  633.       </font>

  634.     </td></tr>

  635.     <tr><td>

  636.       <blockquote>

  637.                         <p>Implicit tasks are run before any of the project's targets are run.  Any task

  638. can be used, including <code>&lt;property&gt;</code> and data-type instances.

  639. Implicit tasks can be used to initialise the project.  For example:</p>

  640.                                   <div align="left">

  641.     <table cellspacing="4" cellpadding="0" border="0">

  642.       <tr>

  643.         <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  644.         <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  645.         <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  646.       </tr>

  647.       <tr>

  648.         <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  649.         <td bgcolor="#ffffff"><pre>

  650. 

  651. &lt;project version=&quot;2.0&quot;&gt;

  652. 

  653.   &lt;property name=&quot;some-property&quot; value=&quot;some value&quot;/&gt;

  654.   &lt;path id=&quot;classpath&quot;&gt;

  655.     &lt;fileset dir=&quot;lib&quot;/&gt;

  656.   &lt;/path&gt;

  657.   &lt;log&gt;Set classpath to ${classpath}&lt;/log&gt;

  658. 

  659.   &lt;target name=&quot;main&quot;&gt;

  660.     .. do some stuff ..

  661.   &lt;/target&gt;

  662. 

  663. &lt;/project&gt;

  664. </pre></td>

  665.         <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  666.       </tr>

  667.       <tr>

  668.         <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  669.         <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  670.         <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  671.       </tr>

  672.     </table>

  673.   </div>

  674.                     </blockquote>

  675.     </td></tr>

  676.   </table>

  677.                                   <table border="0" cellspacing="0" cellpadding="2" width="100%">

  678.     <tr><td bgcolor="#828DA6">

  679.       <font color="#ffffff" face="arial,helvetica,sanserif">

  680.         <a name="Targets"><strong>Targets</strong></a>

  681.       </font>

  682.     </td></tr>

  683.     <tr><td>

  684.       <blockquote>

  685.                         <p>Targets have the same format as in Ant 1.x, though some of the behaviour

  686. is different.  A <code>&lt;target&gt;</code> element takes the following

  687. attributes:</p>

  688.                                   <table>

  689.               <tr>

  690.                   <td bgcolor="#039acc" colspan="" rowspan="" 

  691.       valign="top" align="left">

  692.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  693.           Attribute

  694.         </font>

  695.   </td>

  696.                       <td bgcolor="#039acc" colspan="" rowspan="" 

  697.       valign="top" align="left">

  698.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  699.           Description

  700.         </font>

  701.   </td>

  702.                       <td bgcolor="#039acc" colspan="" rowspan="" 

  703.       valign="top" align="left">

  704.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  705.           Default Value

  706.         </font>

  707.   </td>

  708.       </tr>

  709.                   <tr>

  710.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  711.       valign="top" align="left">

  712.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  713.           name

  714.         </font>

  715.   </td>

  716.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  717.       valign="top" align="left">

  718.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  719.           The name of the target.

  720.         </font>

  721.   </td>

  722.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  723.       valign="top" align="left">

  724.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  725.           Required

  726.         </font>

  727.   </td>

  728.       </tr>

  729.                   <tr>

  730.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  731.       valign="top" align="left">

  732.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  733.           depends

  734.         </font>

  735.   </td>

  736.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  737.       valign="top" align="left">

  738.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  739.           A comma-separated list of targets that this target depends on.

  740.         This list can contain targets from referenced projects.

  741.         </font>

  742.   </td>

  743.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  744.       valign="top" align="left">

  745.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  746.           None

  747.         </font>

  748.   </td>

  749.       </tr>

  750.                   <tr>

  751.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  752.       valign="top" align="left">

  753.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  754.           if

  755.         </font>

  756.   </td>

  757.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  758.       valign="top" align="left">

  759.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  760.           Only execute this target if the specified property is set, and not

  761.         equal to <code>false</code>.

  762.         </font>

  763.   </td>

  764.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  765.       valign="top" align="left">

  766.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  767.           None

  768.         </font>

  769.   </td>

  770.       </tr>

  771.                   <tr>

  772.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  773.       valign="top" align="left">

  774.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  775.           unless

  776.         </font>

  777.   </td>

  778.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  779.       valign="top" align="left">

  780.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  781.           Do not execute this target if the specified property is set, and not

  782.         equal to <code>false</code>.

  783.         </font>

  784.   </td>

  785.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  786.       valign="top" align="left">

  787.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  788.           None

  789.         </font>

  790.   </td>

  791.       </tr>

  792.         </table>

  793.                     </blockquote>

  794.     </td></tr>

  795.   </table>

  796.                     </blockquote>

  797.     </td></tr>

  798.   </table>

  799.         <table border="0" cellspacing="0" cellpadding="2" width="100%">

  800.     <tr><td bgcolor="#525D76">

  801.       <font color="#ffffff" face="arial,helvetica,sanserif">

  802.         <a name="Handling Files"><strong>Handling Files</strong></a>

  803.       </font>

  804.     </td></tr>

  805.     <tr><td>

  806.       <blockquote>

  807.                         <p>Myrmidon includes a Virtual File System (VFS), which allows files from

  808. different sources to be treated identically.  The VFS currently supports

  809. the following file types:</p>

  810.                                   <table>

  811.               <tr>

  812.                   <td bgcolor="#039acc" colspan="" rowspan="" 

  813.       valign="top" align="left">

  814.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  815.           File System

  816.         </font>

  817.   </td>

  818.                       <td bgcolor="#039acc" colspan="" rowspan="" 

  819.       valign="top" align="left">

  820.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  821.           Description

  822.         </font>

  823.   </td>

  824.                       <td bgcolor="#039acc" colspan="" rowspan="" 

  825.       valign="top" align="left">

  826.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  827.           URL Format

  828.         </font>

  829.   </td>

  830.       </tr>

  831.                   <tr>

  832.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  833.       valign="top" align="left">

  834.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  835.           Local Files

  836.         </font>

  837.   </td>

  838.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  839.       valign="top" align="left">

  840.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  841.           Files on the local file system.

  842.         </font>

  843.   </td>

  844.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  845.       valign="top" align="left">

  846.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  847.           Three different formats are currently supported for local file names:

  848.             <ul>

  849.                 <li><code>file://</code> <i>absolute-file-name</i></li>

  850.                 <li>Absolute file names</li>

  851.                 <li>Relative file names.  These are resolved relative to the

  852.                 project's base directory.

  853.                 </li>

  854.             </ul>

  855.         

  856.         </font>

  857.   </td>

  858.       </tr>

  859.                   <tr>

  860.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  861.       valign="top" align="left">

  862.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  863.           Zip Files

  864.         </font>

  865.   </td>

  866.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  867.       valign="top" align="left">

  868.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  869.           The contents of Zip files (and Jar, War, and Ear files).

  870.         Currently, the VFS supports read-only access to Zip file contents,

  871.         and only for local Zip files.

  872.         </font>

  873.   </td>

  874.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  875.       valign="top" align="left">

  876.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  877.           <code>zip://</code> <i>zip-file-path</i> [<code>!</code><i>absolute-path</i>]

  878.         </font>

  879.   </td>

  880.       </tr>

  881.                   <tr>

  882.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  883.       valign="top" align="left">

  884.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  885.           FTP

  886.         </font>

  887.   </td>

  888.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  889.       valign="top" align="left">

  890.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  891.           Files on an FTP server.

  892.         </font>

  893.   </td>

  894.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  895.       valign="top" align="left">

  896.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  897.           <code>ftp://</code> [[<i>password</i><code>:</code>] <i>username</i><code>@</code>] <i>hostname</i> [<code>:</code><i>port</i>] [<i>absolute-path</i>]

  898.         </font>

  899.   </td>

  900.       </tr>

  901.                   <tr>

  902.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  903.       valign="top" align="left">

  904.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  905.           SMB

  906.         </font>

  907.   </td>

  908.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  909.       valign="top" align="left">

  910.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  911.           Files on a CFIS server, such as Samba or Windows shares.

  912.         </font>

  913.   </td>

  914.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  915.       valign="top" align="left">

  916.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  917.           <code>smb://</code> [[<i>password</i><code>:</code>] <i>username</i><code>@</code>] <i>hostname</i> [<code>:</code><i>port</i>] [<i>absolute-path</i>]

  918.         </font>

  919.   </td>

  920.       </tr>

  921.         </table>

  922.                                 <p>Here are some example URLs:</p>

  923.                                 <ul>

  924.     <li><code>build/classes</code></li>

  925.     <li><code>c:\program files\ant\bin</code></li>

  926.     <li><code>file://C:/program files/ant</code></li>

  927.     <li><code>zip://build/lib/ant.jar!/org/apache/tools</code></li>

  928.     <li><code>ftp://adam@somehost/pub/downloads</code></li>

  929.     <li><code>smb://password:adam@somehost/home/adam</code></li>

  930. </ul>

  931.                                 <p>Currently, there are only a handful of VFS aware tasks.  This will grow

  932. as more tasks are ported to the new API, and data types.</p>

  933.                                   <table border="0" cellspacing="0" cellpadding="2" width="100%">

  934.     <tr><td bgcolor="#828DA6">

  935.       <font color="#ffffff" face="arial,helvetica,sanserif">

  936.         <a name="File Sets"><strong>File Sets</strong></a>

  937.       </font>

  938.     </td></tr>

  939.     <tr><td>

  940.       <blockquote>

  941.                         <p>A file set in Myrmidon is more general than Ant 1's concept of a file set.

  942. Firstly, there is more than one type of file set.  Secondly, they are VFS enabled.

  943. File sets are automatically converted to a <a href="#Paths">path</a>, and so

  944. can be used anywhere that a path can.</p>

  945.                                 <h3><code>&lt;v-fileset&gt;</code></h3>

  946.                                 <p>This is the equivalent of Ant 1's <code>&lt;fileset&gt;</code> (The name

  947. is temporary, it will be changed to <code>&lt;fileset&gt;</code> once more

  948. porting work as been completed).</p>

  949.                                 <p>Rather than use a set of include and exclude patterns to choose the files

  950. that make up the file set, <code>&lt;v-fileset&gt;</code> takes zero or more

  951. <a href="#File Selectors">file selectors</a>.  File selectors can be used to

  952. select files based on any attribute of the file, rather than just the name.

  953. You can use <code>&lt;name&gt;</code> selectors to achieve the same result

  954. as using includes or excludes.</p>

  955.                                 <p>A <code>&lt;v-fileset&gt;</code> element takes the following attributes:</p>

  956.                                   <table>

  957.               <tr>

  958.                   <td bgcolor="#039acc" colspan="" rowspan="" 

  959.       valign="top" align="left">

  960.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  961.           Attribute

  962.         </font>

  963.   </td>

  964.                       <td bgcolor="#039acc" colspan="" rowspan="" 

  965.       valign="top" align="left">

  966.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  967.           Description

  968.         </font>

  969.   </td>

  970.                       <td bgcolor="#039acc" colspan="" rowspan="" 

  971.       valign="top" align="left">

  972.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  973.           Default Value

  974.         </font>

  975.   </td>

  976.       </tr>

  977.                   <tr>

  978.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  979.       valign="top" align="left">

  980.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  981.           dir

  982.         </font>

  983.   </td>

  984.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  985.       valign="top" align="left">

  986.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  987.           The base directory for the file set.  This can be any URL that the

  988.         VFS supports.

  989.         </font>

  990.   </td>

  991.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  992.       valign="top" align="left">

  993.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  994.           Required

  995.         </font>

  996.   </td>

  997.       </tr>

  998.         </table>

  999.                                 <p>A <code>&lt;v-fileset&gt;</code> element takes any number of nested

  1000. <a href="#File Selectors">file selector</a> elements.  To be included in the

  1001. file set, a file must be selected by all the file selectors.  That is, the

  1002. file selectors are implicitly AND-ed together.  If no file selector is provided,

  1003. all the files and directories are included in the set.</p>

  1004.                                 <p>An example:</p>

  1005.                                   <div align="left">

  1006.     <table cellspacing="4" cellpadding="0" border="0">

  1007.       <tr>

  1008.         <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  1009.         <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  1010.         <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  1011.       </tr>

  1012.       <tr>

  1013.         <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  1014.         <td bgcolor="#ffffff"><pre>

  1015. 

  1016. &lt;v-fileset dir=&quot;src&quot;&gt;

  1017.     &lt;name pattern=&quot;org/apache/tools/ant/**&quot;/&gt;

  1018.     &lt;is-file/&gt;

  1019. &lt;/v-fileset&gt;

  1020. </pre></td>

  1021.         <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  1022.       </tr>

  1023.       <tr>

  1024.         <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  1025.         <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  1026.         <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  1027.       </tr>

  1028.     </table>

  1029.   </div>

  1030.                                 <h3><code>&lt;flat-fileset&gt;</code></h3>

  1031.                                 <p>This file set takes a set of nested file sets and paths, and flattens them

  1032. into a single directory.  It can be used as a way of converting a path into a

  1033. file set.  It can also be used as a replacement for the <code>flatten</code>

  1034. attribute for the copy and move tasks.</p>

  1035.                                 <p>A <code>&lt;flat-fileset&gt;</code> element takes no attributes, and a set

  1036. of nested paths or file sets.</p>

  1037.                                 <p>An example:</p>

  1038.                                   <div align="left">

  1039.     <table cellspacing="4" cellpadding="0" border="0">

  1040.       <tr>

  1041.         <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  1042.         <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  1043.         <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  1044.       </tr>

  1045.       <tr>

  1046.         <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  1047.         <td bgcolor="#ffffff"><pre>

  1048. 

  1049. &lt;v-copy todir=&quot;dist/lib&quot;&gt;

  1050.   &lt;flat-fileset&gt;

  1051.     &lt;v-fileset dir=&quot;build/lib&quot;&gt;

  1052.         &lt;basename pattern=&quot;*.jar&quot;/&gt;

  1053.     &lt;v-fileset&gt;

  1054.     &lt;v-path path=&quot;${classpath}&quot;/&gt;

  1055.   &lt;/flat-fileset&gt;

  1056. &lt;/v-copy&gt;

  1057. </pre></td>

  1058.         <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  1059.       </tr>

  1060.       <tr>

  1061.         <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  1062.         <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  1063.         <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>

  1064.       </tr>

  1065.     </table>

  1066.   </div>

  1067.                     </blockquote>

  1068.     </td></tr>

  1069.   </table>

  1070.                                   <table border="0" cellspacing="0" cellpadding="2" width="100%">

  1071.     <tr><td bgcolor="#828DA6">

  1072.       <font color="#ffffff" face="arial,helvetica,sanserif">

  1073.         <a name="Paths"><strong>Paths</strong></a>

  1074.       </font>

  1075.     </td></tr>

  1076.     <tr><td>

  1077.       <blockquote>

  1078.                         <p>Paths are an ordered list of files.</p>

  1079.                                 <h3><code>&lt;v-path&gt;</code></h3>

  1080.                                 <p>This is the equivalent of Ant 1's <code>&lt;path&gt;</code>.</p>

  1081.                                 <h3><code>&lt;filtered-path&gt;</code></h3>

  1082.                                 <p>A path that applies file selectors to a set of nested file sets and paths.</p>

  1083.                     </blockquote>

  1084.     </td></tr>

  1085.   </table>

  1086.                                   <table border="0" cellspacing="0" cellpadding="2" width="100%">

  1087.     <tr><td bgcolor="#828DA6">

  1088.       <font color="#ffffff" face="arial,helvetica,sanserif">

  1089.         <a name="File Selectors"><strong>File Selectors</strong></a>

  1090.       </font>

  1091.     </td></tr>

  1092.     <tr><td>

  1093.       <blockquote>

  1094.                         <p>File selectors are used to select files from file sets and paths.</p>

  1095.                                 <h3><code>&lt;and&gt;</code></h3>

  1096.                                 <p>Combines zero or more file selectors, using AND. An empty <code>&lt;and&gt;</code>

  1097. selector accepts all files.</p>

  1098.                                 <h3><code>&lt;basename&gt;</code></h3>

  1099.                                 <p>Selects files whose base name matches an Ant 1 style pattern, or a regular

  1100. expression.</p>

  1101.                                 <h3><code>&lt;exists&gt;</code></h3>

  1102.                                 <p>Selects files that exist.</p>

  1103.                                 <h3><code>&lt;is-empty&gt;</code></h3>

  1104.                                 <p>Selects empty folders, that is, folders that have no children.</p>

  1105.                                 <h3><code>&lt;is-folder&gt;</code></h3>

  1106.                                 <p>Selects folders, does not select regular files.</p>

  1107.                                 <h3><code>&lt;is-file&gt;</code></h3>

  1108.                                 <p>Selects regular files, does not select folders.</p>

  1109.                                 <h3><code>&lt;name&gt;</code></h3>

  1110.                                 <p>Selects files whose path in a file set matches an Ant 1 style pattern, or

  1111. a regular expression.</p>

  1112.                                 <h3><code>&lt;not&gt;</code></h3>

  1113.                                 <p>Selects files that are not selected by a nested file selector.</p>

  1114.                                 <h3><code>&lt;or&gt;</code></h3>

  1115.                                 <p>Combines zero or more file selectors, using OR. An empty <code>&lt;or&gt;</code>

  1116. selector accepts all files.</p>

  1117.                                 <h3><code>&lt;url&gt;</code></h3>

  1118.                                 <p>Selects files whose URL matches an Ant 1 style pattern, or a regular expression.</p>

  1119.                     </blockquote>

  1120.     </td></tr>

  1121.   </table>

  1122.                     </blockquote>

  1123.     </td></tr>

  1124.   </table>

  1125.         <table border="0" cellspacing="0" cellpadding="2" width="100%">

  1126.     <tr><td bgcolor="#525D76">

  1127.       <font color="#ffffff" face="arial,helvetica,sanserif">

  1128.         <a name="Tasks"><strong>Tasks</strong></a>

  1129.       </font>

  1130.     </td></tr>

  1131.     <tr><td>

  1132.       <blockquote>

  1133.                         <p>

  1134. The following table lists some of the current set of tasks.  You can find

  1135. example usages of these tasks in the sample project file

  1136. <code>src/make/sample.ant</code>.

  1137. </p>

  1138.                                   <table>

  1139.               <tr>

  1140.                   <td bgcolor="#039acc" colspan="" rowspan="" 

  1141.       valign="top" align="left">

  1142.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  1143.           Task

  1144.         </font>

  1145.   </td>

  1146.                       <td bgcolor="#039acc" colspan="" rowspan="" 

  1147.       valign="top" align="left">

  1148.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  1149.           Description

  1150.         </font>

  1151.   </td>

  1152.       </tr>

  1153.                   <tr>

  1154.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  1155.       valign="top" align="left">

  1156.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  1157.           fail

  1158.         </font>

  1159.   </td>

  1160.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  1161.       valign="top" align="left">

  1162.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  1163.           Causes the build to fail.

  1164.         </font>

  1165.   </td>

  1166.       </tr>

  1167.                   <tr>

  1168.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  1169.       valign="top" align="left">

  1170.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  1171.           if

  1172.         </font>

  1173.   </td>

  1174.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  1175.       valign="top" align="left">

  1176.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  1177.           Conditionally executes a set of tasks.

  1178.         </font>

  1179.   </td>

  1180.       </tr>

  1181.                   <tr>

  1182.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  1183.       valign="top" align="left">

  1184.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  1185.           load-properties

  1186.         </font>

  1187.   </td>

  1188.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  1189.       valign="top" align="left">

  1190.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  1191.           Loads a set of properties from a file.

  1192.         </font>

  1193.   </td>

  1194.       </tr>

  1195.                   <tr>

  1196.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  1197.       valign="top" align="left">

  1198.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  1199.           log

  1200.         </font>

  1201.   </td>

  1202.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  1203.       valign="top" align="left">

  1204.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  1205.           Writes a log message.

  1206.         </font>

  1207.   </td>

  1208.       </tr>

  1209.                   <tr>

  1210.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  1211.       valign="top" align="left">

  1212.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  1213.           property

  1214.         </font>

  1215.   </td>

  1216.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  1217.       valign="top" align="left">

  1218.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  1219.           Sets a property.

  1220.         </font>

  1221.   </td>

  1222.       </tr>

  1223.                   <tr>

  1224.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  1225.       valign="top" align="left">

  1226.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  1227.           try-catch

  1228.         </font>

  1229.   </td>

  1230.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  1231.       valign="top" align="left">

  1232.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  1233.           Runs a set of tasks, with a provided error and clean-up handler.

  1234.         </font>

  1235.   </td>

  1236.       </tr>

  1237.                   <tr>

  1238.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  1239.       valign="top" align="left">

  1240.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  1241.           converter-def

  1242.         </font>

  1243.   </td>

  1244.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  1245.       valign="top" align="left">

  1246.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  1247.           Register a type converter.  These are used when configuring a task

  1248.         or data-type from attributes.

  1249.         </font>

  1250.   </td>

  1251.       </tr>

  1252.                   <tr>

  1253.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  1254.       valign="top" align="left">

  1255.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  1256.           type-def

  1257.         </font>

  1258.   </td>

  1259.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  1260.       valign="top" align="left">

  1261.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  1262.           Register a task or data-type.

  1263.         </font>

  1264.   </td>

  1265.       </tr>

  1266.                   <tr>

  1267.                   <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  1268.       valign="top" align="left">

  1269.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  1270.           import

  1271.         </font>

  1272.   </td>

  1273.                       <td bgcolor="#a0ddf0" colspan="" rowspan="" 

  1274.       valign="top" align="left">

  1275.     <font color="#000000" size="-1" face="arial,helvetica,sanserif">

  1276.           Register the contents of an antlib.

  1277.         </font>

  1278.   </td>

  1279.       </tr>

  1280.         </table>

  1281.                     </blockquote>

  1282.     </td></tr>

  1283.   </table>

  1284.               </td>

  1285.         </tr>

  1286. 

  1287.         <!-- FOOTER -->

  1288.         <tr><td colspan="2">

  1289.           <hr noshade="" size="1"/>

  1290.         </td></tr>

  1291.         <tr><td colspan="2">

  1292.           <div align="center"><font color="#525D76" size="-1"><em>

  1293.           Copyright &#169; 2000-2002, Apache Software Foundation

  1294.           </em></font></div>

  1295.         </td></tr>

  1296.       </table>

  1297.     </body>

  1298.   </html>

  1299. <!-- end the processing -->

  1300. 

  1301. 

  1302.
Please read the following content carefully:

Dear OpenI User

Thank you for your continuous support to the Openl Qizhi Community AI Collaboration Platform. In order to protect your usage rights and ensure network security, we updated the Openl Qizhi Community AI Collaboration Platform Usage Agreement in January 2024. The updated agreement specifies that users are prohibited from using intranet penetration tools. After you click "Agree and continue", you can continue to use our services. Thank you for your cooperation and understanding.

For more agreement content, please refer to the《Openl Qizhi Community AI Collaboration Platform Usage Agreement》

Agree and continue
Disagree, exit