| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> |
| |
| <!-- Content Stylesheet for Site --> |
| |
| |
| <!-- start the processing --> |
| <html> |
| <head> |
| <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/> |
| |
| <meta name="author" value="Adam Murdoch"> |
| <meta name="email" value="adammurdoch@apache.org"> |
| |
| <title>Apache Myrmidon - User Guide</title> |
| </head> |
| |
| <body bgcolor="#ffffff" text="#000000" link="#525D76"> |
| <table border="0" width="100%" cellspacing="0"> |
| <!-- TOP IMAGE --> |
| <tr> |
| <td> <td colspan="2"> |
| <a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left" border="0"/></a> |
| </td> |
| </td> |
| <td valign="bottom"><div align="right"><b><font size="+3" color="#525D76">Apache Myrmidon</font></b></div></td> |
| </tr> |
| </table> |
| <table border="0" width="100%" cellspacing="4"> |
| <tr><td colspan="2"> |
| <hr noshade="" size="1"/> |
| </td></tr> |
| |
| <tr> |
| <!-- LEFT SIDE NAVIGATION --> |
| <td valign="top" nowrap="true"> |
| <p><strong>Myrmidon</strong></p> |
| <ul> |
| <li> <a href="./index.html">Introduction</a> |
| </li> |
| <li> <a href="./getinvolved.html">Get Involved</a> |
| </li> |
| <li> <a href="./user.html">Building Myrmidon</a> |
| </li> |
| <li> <a href="./todo.html">Todo List</a> |
| </li> |
| </ul> |
| <p><strong>User Guide</strong></p> |
| <ul> |
| <li> <a href="./buildfile.html">Build file</a> |
| </li> |
| <li> <a href="./vfs.html">Virtual File System</a> |
| </li> |
| </ul> |
| <p><strong>Extending Ant</strong></p> |
| <ul> |
| <li> <a href="./task.html">Task Writers HOWTO</a> |
| </li> |
| <li> <a href="./classloader.html">ClassLoader HOWTO</a> |
| </li> |
| <li> <a href="./librarys.html">Library HOWTO</a> |
| </li> |
| </ul> |
| <p><strong>Container Design</strong></p> |
| <ul> |
| </ul> |
| </td> |
| <td align="left" valign="top"> |
| <table border="0" cellspacing="0" cellpadding="2" width="100%"> |
| <tr><td bgcolor="#525D76"> |
| <font color="#ffffff" face="arial,helvetica,sanserif"> |
| <a name="Project File"><strong>Project File</strong></a> |
| </font> |
| </td></tr> |
| <tr><td> |
| <blockquote> |
| <p> |
| The project file format is very similar to that of Ant 1. The root element of |
| the project file must be a <code><project></code> element. It can |
| take the following attributes: |
| </p> |
| <table> |
| <tr> |
| <td bgcolor="#039acc" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| Attribute |
| </font> |
| </td> |
| <td bgcolor="#039acc" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| Description |
| </font> |
| </td> |
| <td bgcolor="#039acc" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| Default Value |
| </font> |
| </td> |
| </tr> |
| <tr> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| name |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| The project name. |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| The base-name of the project file, with the extension removed. |
| </font> |
| </td> |
| </tr> |
| <tr> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| basedir |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| The base directory for the project. The base directory is used |
| to resolve all relative file names used in the project file. |
| |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| The directory containing the project file. |
| </font> |
| </td> |
| </tr> |
| <tr> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| default |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| The name of the default target. |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| <code>main</code> |
| </font> |
| </td> |
| </tr> |
| <tr> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| version |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| The project file version that the project is written for. |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| None, must be <code>2.0</code> |
| </font> |
| </td> |
| </tr> |
| </table> |
| <p> |
| A <code><project></code> element can contain the following elements, |
| in the order given below: |
| </p> |
| <ul> |
| <li><a href="#Project References"><code><projectref></code></a></li> |
| <li><a href="#Library Imports"><code><import></code></a></li> |
| <li><a href="#Implicit Tasks">Implicit tasks</a></li> |
| <li><a href="#Targets"><code><target></code></a></li> |
| </ul> |
| <table border="0" cellspacing="0" cellpadding="2" width="100%"> |
| <tr><td bgcolor="#828DA6"> |
| <font color="#ffffff" face="arial,helvetica,sanserif"> |
| <a name="Project References"><strong>Project References</strong></a> |
| </font> |
| </td></tr> |
| <tr><td> |
| <blockquote> |
| <p>Project references allow the project to import, or reference, other projects. |
| A <code><projectref></code> element takes the following attributes:</p> |
| <table> |
| <tr> |
| <td bgcolor="#039acc" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| Attribute |
| </font> |
| </td> |
| <td bgcolor="#039acc" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| Description |
| </font> |
| </td> |
| <td bgcolor="#039acc" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| Default Value |
| </font> |
| </td> |
| </tr> |
| <tr> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| name |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| The name to use to identify the referenced project. |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| Required |
| </font> |
| </td> |
| </tr> |
| <tr> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| location |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| The path to the project file to reference. |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| Required |
| </font> |
| </td> |
| </tr> |
| </table> |
| <p> |
| The targets of a referenced project can be used in the <code>depends</code> list |
| of a target in the referencing project, using the following syntax: |
| <code><i>project-name</i>-><i>target-name</i></code>. Here is a simple example:</p> |
| <div align="left"> |
| <table cellspacing="4" cellpadding="0" border="0"> |
| <tr> |
| <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| </tr> |
| <tr> |
| <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| <td bgcolor="#ffffff"><pre> |
| |
| <project version="2.0"> |
| <!-- Reference another project --> |
| <projectref name="subproject" location="subproject/build.xml"/> |
| |
| <!-- Use the "compile" target from the referenced project --> |
| <target name="main" depends="subproject->compile"> |
| .. do some stuff .. |
| </target> |
| </project> |
| </pre></td> |
| <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| </tr> |
| <tr> |
| <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| </tr> |
| </table> |
| </div> |
| </blockquote> |
| </td></tr> |
| </table> |
| <table border="0" cellspacing="0" cellpadding="2" width="100%"> |
| <tr><td bgcolor="#828DA6"> |
| <font color="#ffffff" face="arial,helvetica,sanserif"> |
| <a name="Library Imports"><strong>Library Imports</strong></a> |
| </font> |
| </td></tr> |
| <tr><td> |
| <blockquote> |
| <p>Library imports allow the project to import the tasks and data-types from an |
| antlib. An <code><import></code> element takes the following attributes:</p> |
| <table> |
| <tr> |
| <td bgcolor="#039acc" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| Attribute |
| </font> |
| </td> |
| <td bgcolor="#039acc" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| Description |
| </font> |
| </td> |
| <td bgcolor="#039acc" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| Default Value |
| </font> |
| </td> |
| </tr> |
| <tr> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| library |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| The name of the library to import. The <code>ext</code> directory |
| of the Myrmidon distribution is searched for a library file with |
| the given name, and an <code>atl</code> extension. |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| Required |
| </font> |
| </td> |
| </tr> |
| <tr> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| type |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| The type of definition to import. Values include <code>task</code>, |
| and <code>data-type</code>. |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| None |
| </font> |
| </td> |
| </tr> |
| <tr> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| name |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| The name of the type to import. |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| None |
| </font> |
| </td> |
| </tr> |
| </table> |
| <p> |
| If the <code>type</code> and <code>name</code> attributes are not provided, |
| the entire contents of the antlib are imported. |
| </p> |
| <p>The following example import the <code><my-task></code> task from |
| the <code>my-tasks</code> antlib.</p> |
| <div align="left"> |
| <table cellspacing="4" cellpadding="0" border="0"> |
| <tr> |
| <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| </tr> |
| <tr> |
| <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| <td bgcolor="#ffffff"><pre> |
| |
| <project version="2.0"> |
| <!-- Import task <my-task> from the 'my-tasks' antlib. --> |
| <import library="my-tasks" type="task" name="my-task"/> |
| |
| <target name="main"> |
| <my-task some-prop=".."/> |
| </target> |
| </project> |
| </pre></td> |
| <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| </tr> |
| <tr> |
| <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| </tr> |
| </table> |
| </div> |
| </blockquote> |
| </td></tr> |
| </table> |
| <table border="0" cellspacing="0" cellpadding="2" width="100%"> |
| <tr><td bgcolor="#828DA6"> |
| <font color="#ffffff" face="arial,helvetica,sanserif"> |
| <a name="Implicit Tasks"><strong>Implicit Tasks</strong></a> |
| </font> |
| </td></tr> |
| <tr><td> |
| <blockquote> |
| <p>Implicit tasks are run before any of the project's targets are run. Any task |
| can be used, including <code><property></code> and data-type instances. |
| Implicit tasks can be used to initialise the project. For example:</p> |
| <div align="left"> |
| <table cellspacing="4" cellpadding="0" border="0"> |
| <tr> |
| <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| </tr> |
| <tr> |
| <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| <td bgcolor="#ffffff"><pre> |
| |
| <project version="2.0"> |
| |
| <property name="some-property" value="some value"/> |
| <path id="classpath"> |
| <fileset dir="lib"/> |
| </path> |
| <log>Set classpath to ${classpath}</log> |
| |
| <target name="main"> |
| .. do some stuff .. |
| </target> |
| |
| </project> |
| </pre></td> |
| <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| </tr> |
| <tr> |
| <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td> |
| </tr> |
| </table> |
| </div> |
| </blockquote> |
| </td></tr> |
| </table> |
| <table border="0" cellspacing="0" cellpadding="2" width="100%"> |
| <tr><td bgcolor="#828DA6"> |
| <font color="#ffffff" face="arial,helvetica,sanserif"> |
| <a name="Targets"><strong>Targets</strong></a> |
| </font> |
| </td></tr> |
| <tr><td> |
| <blockquote> |
| <p>Targets have the same format as in Ant 1.x, though some of the behaviour |
| is different. A <code><target></code> element takes the following |
| attributes:</p> |
| <table> |
| <tr> |
| <td bgcolor="#039acc" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| Attribute |
| </font> |
| </td> |
| <td bgcolor="#039acc" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| Description |
| </font> |
| </td> |
| <td bgcolor="#039acc" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| Default Value |
| </font> |
| </td> |
| </tr> |
| <tr> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| name |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| The name of the target. |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| Required |
| </font> |
| </td> |
| </tr> |
| <tr> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| depends |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| A comma-separated list of targets that this target depends on. |
| This list can contain targets from referenced projects. |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| None |
| </font> |
| </td> |
| </tr> |
| <tr> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| if |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| Only execute this target if the specified property is set, and not |
| equal to <code>false</code>. |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| None |
| </font> |
| </td> |
| </tr> |
| <tr> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| unless |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| Do not execute this target if the specified property is set, and not |
| equal to <code>false</code>. |
| </font> |
| </td> |
| <td bgcolor="#a0ddf0" colspan="" rowspan="" |
| valign="top" align="left"> |
| <font color="#000000" size="-1" face="arial,helvetica,sanserif"> |
| None |
| </font> |
| </td> |
| </tr> |
| </table> |
| </blockquote> |
| </td></tr> |
| </table> |
| </blockquote> |
| </td></tr> |
| </table> |
| <table border="0" cellspacing="0" cellpadding="2" width="100%"> |
| <tr><td bgcolor="#525D76"> |
| <font color="#ffffff" face="arial,helvetica,sanserif"> |
| <a name="Tasks"><strong>Tasks</strong></a> |
| </font> |
| </td></tr> |
| <tr><td> |
| <blockquote> |
| <p> |
| Listed below are some of the current set of tasks. You can find example |
| usages of these tasks in the sample project file <code>src/make/sample.ant</code>. |
| </p> |
| <h3><code><condition></code></h3> |
| <p>Sets a property if a particular condition is true. See |
| <a href="#Conditions">Conditions</a> for a list of available conditions.</p> |
| <h3><code><fail></code></h3> |
| <p>Causes the build to fail.</p> |
| <h3><code><if></code></h3> |
| <p>Conditionally executes a set of tasks.</p> |
| <h3><code><load-properties></code></h3> |
| <p>Loads a set of properties from a file.</p> |
| <h3><code><log></code></h3> |
| <p>Writes a log message.</p> |
| <h3><code><property></code></h3> |
| <p>Sets a property.</p> |
| <h3><code><try-catch></code></h3> |
| <p>Runs a set of tasks, with a provided error and clean-up handler.</p> |
| <h3><code><converter-def></code></h3> |
| <p>Register a type converter. These are used when configuring a task |
| or data-type from attributes.</p> |
| <h3><code><type-def></code></h3> |
| <p>Register a task or data-type.</p> |
| <h3><code><import></code></h3> |
| <p>Register the contents of an antlib.</p> |
| </blockquote> |
| </td></tr> |
| </table> |
| <table border="0" cellspacing="0" cellpadding="2" width="100%"> |
| <tr><td bgcolor="#525D76"> |
| <font color="#ffffff" face="arial,helvetica,sanserif"> |
| <a name="Conditions"><strong>Conditions</strong></a> |
| </font> |
| </td></tr> |
| <tr><td> |
| <blockquote> |
| <p>The following conditions are available </p> |
| <h3><code><and></code></h3> |
| <p>Evaluates a set of nested conditions, and AND them together. Evaluation is |
| lazy. An empty <code><and></code> condition evaluates to true.</p> |
| <h3><code><available></code></h3> |
| <p>Tests if a particular class or resource is available.</p> |
| <h3><code><file-test></code></h3> |
| <p>Tests a file against a set of <a href="vfs.html#File Selectors">file selectors</a>.</p> |
| <h3><code><is-set></code></h3> |
| <p>Tests whether a proeprty is set, and not set to 'false'.</p> |
| <h3><code><or></code></h3> |
| <p>Evaluates a set of nested conditions, and OR them together. Evaluation is |
| lazy. An empty <code><or></code> evaluates to true.</p> |
| <h3><code><os></code></h3> |
| <p>Tests which operating system the build is running on.</p> |
| <h3><code><not></code></h3> |
| <p>Negates a nested condition.</p> |
| </blockquote> |
| </td></tr> |
| </table> |
| <table border="0" cellspacing="0" cellpadding="2" width="100%"> |
| <tr><td bgcolor="#525D76"> |
| <font color="#ffffff" face="arial,helvetica,sanserif"> |
| <a name="File Name Mappers"><strong>File Name Mappers</strong></a> |
| </font> |
| </td></tr> |
| <tr><td> |
| <blockquote> |
| <p>The following file name mappers are available:</p> |
| <h3><code><chain></code></h3> |
| <p>Applies a set of nested file name mappers to file names.</p> |
| <h3><code><flatten></code></h3> |
| <p>Maps all file names to a single directory.</p> |
| <h3><code><prefix></code></h3> |
| <p>Adds a prefix to the front of each file name.</p> |
| <h3><code><map-extension></code></h3> |
| <p>Changes the extension of file names.</p> |
| </blockquote> |
| </td></tr> |
| </table> |
| </td> |
| </tr> |
| |
| <!-- FOOTER --> |
| <tr><td colspan="2"> |
| <hr noshade="" size="1"/> |
| </td></tr> |
| <tr><td colspan="2"> |
| <div align="center"><font color="#525D76" size="-1"><em> |
| Copyright © 2000-2002, Apache Software Foundation |
| </em></font></div> |
| </td></tr> |
| </table> |
| </body> |
| </html> |
| <!-- end the processing --> |
| |
| |
| |
| |