|
|
@@ -97,7 +97,7 @@ build Ant from the source code.</p> |
|
|
|
<hr> |
|
|
|
<h2><a name="sysrequirements">System Requirements</a></h2> |
|
|
|
<p> |
|
|
|
To build and use ant you must have a JAXP compilant XML parser installed and available on your classpath. |
|
|
|
To build and use ant you must have a JAXP compliant XML parser installed and available on your classpath. |
|
|
|
<p> |
|
|
|
If you do not have a JAXP compliant XML parse installed, you may use the reference implementation |
|
|
|
available from Sun. It is available from <a href="http://java.sun.com/xml">http://java.sun.com/xml</a>. |
|
|
@@ -257,7 +257,7 @@ to be unique.</p> |
|
|
|
<td valign="top">basedir</td> |
|
|
|
<td valign="top">the base directory from which all path calculations are |
|
|
|
done. This attribute might be overridden by setting the "basedir" |
|
|
|
property on forehand. When this is done, it might be ommitted in the |
|
|
|
property on forehand. When this is done, it might be omitted in the |
|
|
|
project tag.</td> |
|
|
|
<td align="center" valign="top">Yes</td> |
|
|
|
</tr> |
|
|
@@ -299,7 +299,7 @@ should react to, for example</p> |
|
|
|
always be executed.</p> |
|
|
|
<p>It is a good practice to place your <a |
|
|
|
href="#tstamp">tstamp</a> tasks in a so called initialization target, on which |
|
|
|
all other targets depend. Make sure that that target is always the first one in |
|
|
|
all other targets depend. Make sure that target is always the first one in |
|
|
|
the depends list of the other targets. In this manual, most initialization targets |
|
|
|
have the name "init".</p> |
|
|
|
<p>A target has the following attributes:</p> |
|
|
@@ -882,7 +882,7 @@ allows you to parameterize your subprojects.</p> |
|
|
|
<hr> |
|
|
|
<h2><a name="antstructure">AntStructure</a></h2> |
|
|
|
<h3><b>Description:</b></h3> |
|
|
|
<p>Generates a DTD for Ant build files which contains informations |
|
|
|
<p>Generates a DTD for Ant build files which contains information |
|
|
|
about all tasks currently known to Ant.</p> |
|
|
|
<p>Note that the DTD generated by this task is incomplete, you can |
|
|
|
always add XML entities using <a |
|
|
@@ -950,7 +950,7 @@ if the <i>org.whatever.Myclass</i> is found in Ant's classpath.</p> |
|
|
|
<hr> |
|
|
|
<h2><a name="chmod">Chmod</a></h2> |
|
|
|
<h3>Description</h3> |
|
|
|
<p>Changes the permissions of a file or all files inside specified directories. Right now it has efect only under Unix. |
|
|
|
<p>Changes the permissions of a file or all files inside specified directories. Right now it has effect only under Unix. |
|
|
|
The permissions are also UNIX style, like the argument for the chmod command.</p> |
|
|
|
<p>See the section on <a href="#directorybasedtasks">directory based |
|
|
|
tasks</a>, on how the inclusion/exclusion of files works, and how to |
|
|
@@ -1243,7 +1243,7 @@ preferred over the <i>checkout</i> command, because of speed.</p> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">quiet</td> |
|
|
|
<td valign="top">supress informational messages.</td> |
|
|
|
<td valign="top">suppress informational messages.</td> |
|
|
|
<td align="center" valign="top">No, default "false"</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
@@ -1707,7 +1707,7 @@ elements.</p> |
|
|
|
(including Windows), the default is add. |
|
|
|
<p> |
|
|
|
Note: Unless this property is specified as "asis", extra CR characters |
|
|
|
which do not preceed a LF will be removed. |
|
|
|
which do not precede a LF will be removed. |
|
|
|
</td> |
|
|
|
<td valign="top" align="center">No</td> |
|
|
|
</tr> |
|
|
@@ -1927,7 +1927,7 @@ NB: This timestamp facility only works on downloads using the HTTP protocol. |
|
|
|
<p> |
|
|
|
Gets the nightly ant build from the tomcat distribution, if the local copy |
|
|
|
is missing or out of date. Uses the verbose option |
|
|
|
for progess information. |
|
|
|
for progress information. |
|
|
|
</p> |
|
|
|
|
|
|
|
<hr> |
|
|
@@ -1937,7 +1937,7 @@ for progess information. |
|
|
|
|
|
|
|
<p>If <i>dest</i> is a directory the name of the destination file is |
|
|
|
the same as <i>src</i> (with the ".gz" extension removed if |
|
|
|
present). If <i>dest</i> is ommited, the parent dir of <i>src</i> is |
|
|
|
present). If <i>dest</i> is omitted, the parent dir of <i>src</i> is |
|
|
|
taken. The file is only expanded if the source file is newer than the |
|
|
|
destination file, or when the destination file does not exist.</p> |
|
|
|
|
|
|
@@ -2615,7 +2615,7 @@ instead.</p> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">Windowtitle</td> |
|
|
|
<td valign="top">Browser window title for the documenation (text)</td> |
|
|
|
<td valign="top">Browser window title for the documentation (text)</td> |
|
|
|
<td align="center" valign="top">1.2</td> |
|
|
|
<td align="center" valign="top">No</td> |
|
|
|
</tr> |
|
|
@@ -3031,7 +3031,7 @@ implementations may use other values for the home directory on Windows. |
|
|
|
<pre> <rename src="foo.jar" dest="${name}-${version}.jar" /></pre> |
|
|
|
<p>Renames the file <code>foo.jar</code> to <code>${name}-${version}.jar</code> (assuming <code>name</code> |
|
|
|
and <code>version</code> being predefined properties). If a file named <code>${name}-${version}.jar</code> |
|
|
|
already exists, it will be removed prior to renameing <code>foo.jar</code>.</p> |
|
|
|
already exists, it will be removed prior to renaming <code>foo.jar</code>.</p> |
|
|
|
<hr> |
|
|
|
<h2><a name="replace">Replace</a></h2> |
|
|
|
<h3>Description</h3> |
|
|
@@ -3475,7 +3475,7 @@ of now works, all other cases will emit a warning.</p> |
|
|
|
<td valign="top" align="center">No</td> |
|
|
|
</tr> |
|
|
|
</table> |
|
|
|
<p>If both <code>millis</code> and <code>datetime</code> are ommited |
|
|
|
<p>If both <code>millis</code> and <code>datetime</code> are omitted |
|
|
|
the current time is assumed.</p> |
|
|
|
<h3>Examples</h3> |
|
|
|
<pre> <touch file="myfile" /></pre> |
|
|
@@ -3544,7 +3544,7 @@ elements.</p> |
|
|
|
<td align="center" valign="top">Yes</td> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">extention</td> |
|
|
|
<td valign="top">extension</td> |
|
|
|
<td valign="top">desired file extension to be used for the targets. |
|
|
|
If not specified, the default is "html".</td> |
|
|
|
<td align="center" valign="top">No</td> |
|
|
@@ -3556,7 +3556,7 @@ elements.</p> |
|
|
|
</tr> |
|
|
|
<tr> |
|
|
|
<td valign="top">processor</td> |
|
|
|
<td valign="top">name of the XSLT processor to use. Permissable |
|
|
|
<td valign="top">name of the XSLT processor to use. Permissible |
|
|
|
values are "xslp" for the XSL:P processor, "xalan" for the Apache XML Xalan |
|
|
|
processor, or the name of an arbitrary XSLTLiaison class. |
|
|
|
Defaults to xslp or xalan (in that order), if one is found in your |
|
|
@@ -4661,7 +4661,7 @@ If you wish to attach a listener from the command line you may use the -listener |
|
|
|
<blockquote> |
|
|
|
<pre>ant -listener org.apache.tools.ant.XmlLogger</pre> |
|
|
|
</blockquote> |
|
|
|
will run ant with a listener which generates an XML representaion of the build progress. This |
|
|
|
will run ant with a listener which generates an XML representation of the build progress. This |
|
|
|
listener is included with ant as is the default listener which generates the logging to standard |
|
|
|
output. |
|
|
|
|
|
|
|