@@ -436,7 +436,7 @@
</td></tr> </td></tr>
</table> </table>
<p> <p>
<a name="latest-version">
<a name="latest-version"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -447,12 +447,9 @@
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>The latest version can always be found at Ant's homepage <p>The latest version can always be found at Ant's homepage
<a href="http://jakarta.apache.org/ant/faq.html">http://jakarta.apache.org/ant/faq.html</a>.</p> <a href="http://jakarta.apache.org/ant/faq.html">http://jakarta.apache.org/ant/faq.html</a>.</p>
</p>
</a>
<a name="adding-faqs">
<a name="adding-faqs"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -462,7 +459,6 @@
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>The page you are looking it is generated from <p>The page you are looking it is generated from
<a href="http://cvs.apache.org/viewcvs.cgi/~checkout~/jakarta-ant/xdocs/faq.xml">this</a> <a href="http://cvs.apache.org/viewcvs.cgi/~checkout~/jakarta-ant/xdocs/faq.xml">this</a>
document. If you want to add a new question, please submit document. If you want to add a new question, please submit
@@ -471,9 +467,7 @@
<p>If you don't know how to create a patch, see the patches <p>If you don't know how to create a patch, see the patches
section of <a href="http://jakarta.apache.org/site/source.html">this section of <a href="http://jakarta.apache.org/site/source.html">this
page</a>.</p> page</a>.</p>
</p>
</a>
<a name="creating-faq">
<a name="creating-faq"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -484,7 +478,6 @@
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>We use <p>We use
<a href="http://jakarta.apache.org/velocity/anakia.html">Anakia</a> <a href="http://jakarta.apache.org/velocity/anakia.html">Anakia</a>
to render the HTML version from the original XML file.</p> to render the HTML version from the original XML file.</p>
@@ -496,9 +489,7 @@
well, but if you follow the instruction from Anakia's well, but if you follow the instruction from Anakia's
homepage, you should get it to work without that. Just make homepage, you should get it to work without that. Just make
sure all required jars are in the task's classpath.</p> sure all required jars are in the task's classpath.</p>
</p>
</a>
<a name="what-is-ant">
<a name="what-is-ant"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -508,13 +499,10 @@
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p> Ant is a Java-based build tool. In theory, it is kind of <p> Ant is a Java-based build tool. In theory, it is kind of
like Make, without Make's wrinkles and with the full like Make, without Make's wrinkles and with the full
portability of pure Java code.</p> portability of pure Java code.</p>
</p>
</a>
<a name="ant-name">
<a name="ant-name"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -524,7 +512,6 @@
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>According to Ant's original author, James Duncan <p>According to Ant's original author, James Duncan
Davidson, the name is an acronym for "Another Neat Davidson, the name is an acronym for "Another Neat
Tool".</p> Tool".</p>
@@ -533,9 +520,7 @@
"ants are very small and can carry a weight dozens of times "ants are very small and can carry a weight dozens of times
their own" - describing what Ant is intended to their own" - describing what Ant is intended to
be.</p> be.</p>
</p>
</a>
<a name="history">
<a name="history"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -545,7 +530,6 @@
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>Initially, Ant was part of the Tomcat code base, when it was <p>Initially, Ant was part of the Tomcat code base, when it was
donated to the Apache Software Foundation. It was donated to the Apache Software Foundation. It was
created by James Duncan Davidson, who is also the original created by James Duncan Davidson, who is also the original
@@ -648,9 +632,7 @@
</td> </td>
</tr> </tr>
</table> </table>
</p>
</a>
<a name="no-gnu-tar">
<a name="no-gnu-tar"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -661,7 +643,6 @@
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>Ant's distribution contains file names that are longer <p>Ant's distribution contains file names that are longer
than 100 characters, which is not supported by the standard than 100 characters, which is not supported by the standard
tar file format. Several different implementations of tar use tar file format. Several different implementations of tar use
@@ -676,9 +657,7 @@
found <a href="http://www.gnu.org/software/tar/tar.html">here</a>, found <a href="http://www.gnu.org/software/tar/tar.html">here</a>,
or use the zip archive instead (you can extract it using or use the zip archive instead (you can extract it using
<code>jar xf</code>).</p> <code>jar xf</code>).</p>
</p>
</a>
<a name="adding-external-tasks">
<a name="adding-external-tasks"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -689,7 +668,6 @@
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>Join and post a message to the ant-dev or ant-user mailing <p>Join and post a message to the ant-dev or ant-user mailing
list (one list is enough), including the following list (one list is enough), including the following
information:</p> information:</p>
@@ -710,9 +688,7 @@
</ul> </ul>
<p>The preferred format for this information is a patch to <a href="http://cvs.apache.org/viewcvs.cgi/~checkout~/jakarta-ant/xdocs/external.xml">this</a> <p>The preferred format for this information is a patch to <a href="http://cvs.apache.org/viewcvs.cgi/~checkout~/jakarta-ant/xdocs/external.xml">this</a>
document.</p> document.</p>
</p>
</a>
<a name="passing-cli-args">
<a name="passing-cli-args"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -723,16 +699,13 @@
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>Use properties. Using <code>ant <p>Use properties. Using <code>ant
-D<em>name</em>=<em>value</em></code> lets you define values for -D<em>name</em>=<em>value</em></code> lets you define values for
properties on the Ant command line. These properties can then be properties on the Ant command line. These properties can then be
used within your build file as used within your build file as
any normal property: <code>${<em>name</em>}</code> will put in any normal property: <code>${<em>name</em>}</code> will put in
<code><em>value</em></code>.</p> <code><em>value</em></code>.</p>
</p>
</a>
<a name="jikes-switches">
<a name="jikes-switches"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -743,7 +716,6 @@
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>A couple of switches are supported via "magic" <p>A couple of switches are supported via "magic"
properties:</p> properties:</p>
<table class="ForrestTable" cellspacing="1" cellpadding="4"> <table class="ForrestTable" cellspacing="1" cellpadding="4">
@@ -824,9 +796,7 @@
<p>With Ant >= 1.5, you can also use nested <p>With Ant >= 1.5, you can also use nested
<code><compilerarg></code> elements with the <code><compilerarg></code> elements with the
<code><javac></code> task.</p> <code><javac></code> task.</p>
</p>
</a>
<a name="shell-redirect-1">
<a name="shell-redirect-1"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -836,14 +806,11 @@
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>The short answer is "Use: <code>&lt;</code>".</p> <p>The short answer is "Use: <code>&lt;</code>".</p>
<p>The long answer is that this probably won't do what you <p>The long answer is that this probably won't do what you
want anyway (see <a href="#shell-redirect-2">the next want anyway (see <a href="#shell-redirect-2">the next
section</a>).</p> section</a>).</p>
</p>
</a>
<a name="shell-redirect-2">
<a name="shell-redirect-2"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -854,7 +821,6 @@
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>Say you want to redirect the standard input stream of the <p>Say you want to redirect the standard input stream of the
<code>cat</code> command to read from a file, something <code>cat</code> command to read from a file, something
like:</p> like:</p>
@@ -887,9 +853,7 @@ shell-prompt> cat < foo
</exec> </exec>
</pre> </pre>
<p>Note the double-quotes nested inside the single-quotes.</p> <p>Note the double-quotes nested inside the single-quotes.</p>
</p>
</a>
<a name="batch-shell-execute">
<a name="batch-shell-execute"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -899,7 +863,6 @@ shell-prompt> cat < foo
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>On native Unix systems, you should be able to run shell scripts <p>On native Unix systems, you should be able to run shell scripts
directly. On systems running a Unix-type shell (for example, Cygwin directly. On systems running a Unix-type shell (for example, Cygwin
on Windows) execute the (command) shell instead - <code>cmd</code> on Windows) execute the (command) shell instead - <code>cmd</code>
@@ -915,9 +878,7 @@ shell-prompt> cat < foo
<arg line="/c test.bat"/> <arg line="/c test.bat"/>
</exec> </exec>
</pre> </pre>
</p>
</a>
<a name="multi-conditions">
<a name="multi-conditions"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -928,7 +889,6 @@ shell-prompt> cat < foo
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>There are actually several answers to this question.</p> <p>There are actually several answers to this question.</p>
<p>If you have only one set and one unset property to test, <p>If you have only one set and one unset property to test,
you can specify both an <code>if</code> and an <code>unless</code> you can specify both an <code>if</code> and an <code>unless</code>
@@ -1029,9 +989,7 @@ shell-prompt> cat < foo
<a href="manual/OptionalTasks/script.html"> <a href="manual/OptionalTasks/script.html">
<code><script></code> task documentation</a> for more <code><script></code> task documentation</a> for more
details.</p> details.</p>
</p>
</a>
<a name="encoding">
<a name="encoding"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -1042,7 +1000,6 @@ shell-prompt> cat < foo
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>You need to tell the XML parser which character encoding <p>You need to tell the XML parser which character encoding
your build file uses, this is done inside the <a href="http://www.w3.org/TR/2000/REC-xml-20001006#sec-prolog-dtd">XML your build file uses, this is done inside the <a href="http://www.w3.org/TR/2000/REC-xml-20001006#sec-prolog-dtd">XML
declaration</a>.</p> declaration</a>.</p>
@@ -1054,9 +1011,7 @@ shell-prompt> cat < foo
<pre class="code"> <pre class="code">
<?xml version="1.0" encoding="ISO-8859-1" ?> <?xml version="1.0" encoding="ISO-8859-1" ?>
</pre> </pre>
</p>
</a>
<a name="always-recompiles">
<a name="always-recompiles"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -1066,7 +1021,6 @@ shell-prompt> cat < foo
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>In order to find out which files should be compiled, Ant <p>In order to find out which files should be compiled, Ant
compares the timestamps of the source files to those of the compares the timestamps of the source files to those of the
resulting <code>.class</code> files. Opening all source files resulting <code>.class</code> files. Opening all source files
@@ -1091,9 +1045,7 @@ shell-prompt> cat < foo
the actual directory the source the actual directory the source
files live in and the directory the class files should go into, files live in and the directory the class files should go into,
respectively.</p> respectively.</p>
</p>
</a>
<a name="defaultexcludes">
<a name="defaultexcludes"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -1106,7 +1058,6 @@ shell-prompt> cat < foo
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>This is probably happening because, by default, Ant excludes <p>This is probably happening because, by default, Ant excludes
SourceSafe control files (<code>vssver.scc</code>) and certain other SourceSafe control files (<code>vssver.scc</code>) and certain other
files from FileSets.</p> files from FileSets.</p>
@@ -1127,9 +1078,7 @@ shell-prompt> cat < foo
<p>For a complete listing of the patterns that are excluded <p>For a complete listing of the patterns that are excluded
by default, see <a href="manual/dirtasks.html#defaultexcludes">the user by default, see <a href="manual/dirtasks.html#defaultexcludes">the user
manual</a>.</p> manual</a>.</p>
</p>
</a>
<a name="stop-dependency">
<a name="stop-dependency"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -1142,7 +1091,6 @@ shell-prompt> cat < foo
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>The list of dependencies is generated by Ant before any of the <p>The list of dependencies is generated by Ant before any of the
targets are run. This allows dependent targets, such as an targets are run. This allows dependent targets, such as an
<code>init</code> target, to set properties that can control the <code>init</code> target, to set properties that can control the
@@ -1160,9 +1108,7 @@ shell-prompt> cat < foo
instead of specifying them inside the <code>depends</code> instead of specifying them inside the <code>depends</code>
attribute.</li> attribute.</li>
</ol> </ol>
</p>
</a>
<a name="include-order">
<a name="include-order"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -1176,7 +1122,6 @@ shell-prompt> cat < foo
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>The order of the <code><include></code> and <p>The order of the <code><include></code> and
<code><exclude></code> tags within a <code><fileset></code> <code><exclude></code> tags within a <code><fileset></code>
is ignored when the FileSet is created. Instead, all of the is ignored when the FileSet is created. Instead, all of the
@@ -1190,9 +1135,7 @@ shell-prompt> cat < foo
to get them. If you find you need to trim the list that the to get them. If you find you need to trim the list that the
<code><include></code> elements produce, then use <code><include></code> elements produce, then use
<code><exclude></code> elements.</p> <code><exclude></code> elements.</p>
</p>
</a>
<a name="properties-not-trimmed">
<a name="properties-not-trimmed"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -1205,7 +1148,6 @@ shell-prompt> cat < foo
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>When <code>ant</code> loads properties from an external <p>When <code>ant</code> loads properties from an external
file it dosn't touch the value of properties, trailing blanks file it dosn't touch the value of properties, trailing blanks
will not be trimmed for example.</p> will not be trimmed for example.</p>
@@ -1213,9 +1155,7 @@ shell-prompt> cat < foo
compile, the task which requires the value, javac for example compile, the task which requires the value, javac for example
would fail to compile since it can't find the file due to would fail to compile since it can't find the file due to
trailing spaces.</p> trailing spaces.</p>
</p>
</a>
<a name="winzip-lies">
<a name="winzip-lies"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -1227,7 +1167,6 @@ shell-prompt> cat < foo
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>No it doesn't.</p> <p>No it doesn't.</p>
<p>You may have seen these lower-case directory names in <p>You may have seen these lower-case directory names in
WinZIP, but WinZIP is trying to be helpful (and fails). If WinZIP, but WinZIP is trying to be helpful (and fails). If
@@ -1236,9 +1175,7 @@ shell-prompt> cat < foo
all lower-case for you.</p> all lower-case for you.</p>
<p>If you extract (or just check) the archive with jar, you <p>If you extract (or just check) the archive with jar, you
will see that the names have the correct case.</p> will see that the names have the correct case.</p>
</p>
</a>
<a name="integration">
<a name="integration"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -1248,12 +1185,9 @@ shell-prompt> cat < foo
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>See the <a href="external.html#IDE and Editor Integration">section <p>See the <a href="external.html#IDE and Editor Integration">section
on IDE integration</a> on our External Tools and Tasks page.</p> on IDE integration</a> on our External Tools and Tasks page.</p>
</p>
</a>
<a name="emacs-mode">
<a name="emacs-mode"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -1264,7 +1198,6 @@ shell-prompt> cat < foo
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>Ant adds a "banner" with the name of the current <p>Ant adds a "banner" with the name of the current
task in front of all logging messages - and there are no built-in task in front of all logging messages - and there are no built-in
regular expressions in your editor that would account for regular expressions in your editor that would account for
@@ -1317,9 +1250,7 @@ while(<STDIN>) {
print; print;
}; };
</pre> </pre>
</p>
</a>
<a name="dtd">
<a name="dtd"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -1330,7 +1261,6 @@ while(<STDIN>) {
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>An incomplete DTD can be created by the <p>An incomplete DTD can be created by the
<code><antstructure></code> task - but this one <code><antstructure></code> task - but this one
has a few problems:</p> has a few problems:</p>
@@ -1355,9 +1285,7 @@ while(<STDIN>) {
lists. This problem cannot be solved; DTDs don't give a lists. This problem cannot be solved; DTDs don't give a
syntax rich enough to support this.</li> syntax rich enough to support this.</li>
</ul> </ul>
</p>
</a>
<a name="xml-entity-include">
<a name="xml-entity-include"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -1367,7 +1295,6 @@ while(<STDIN>) {
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>You can use XML's way of including external files and let <p>You can use XML's way of including external files and let
the parser do the job for Ant:</p> the parser do the job for Ant:</p>
<pre class="code"> <pre class="code">
@@ -1397,9 +1324,7 @@ while(<STDIN>) {
<!ENTITY include SYSTEM "file:./header.xml"> <!ENTITY include SYSTEM "file:./header.xml">
]> ]>
</pre> </pre>
</p>
</a>
<a name="mail-logger">
<a name="mail-logger"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -1410,7 +1335,6 @@ while(<STDIN>) {
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>If you are using a nightly build of Ant 1.5 after <p>If you are using a nightly build of Ant 1.5 after
2001-12-14, you can use the built-in MailLogger:</p> 2001-12-14, you can use the built-in MailLogger:</p>
<pre class="code"> <pre class="code">
@@ -1564,9 +1488,7 @@ ant -listener BuildMonitor -logfile build.log
<code>activation.jar</code> from the <code>activation.jar</code> from the
<a href="http://java.sun.com/products/javabeans/glasgow/jaf.html">Java <a href="http://java.sun.com/products/javabeans/glasgow/jaf.html">Java
Beans Activation Framework</a> are in your <code>CLASSPATH</code>.</p> Beans Activation Framework</a> are in your <code>CLASSPATH</code>.</p>
</p>
</a>
<a name="listener-properties">
<a name="listener-properties"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -1577,7 +1499,6 @@ ant -listener BuildMonitor -logfile build.log
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>You can get at a hashtable with all the properties that Ant <p>You can get at a hashtable with all the properties that Ant
has been using through the BuildEvent parameter. For has been using through the BuildEvent parameter. For
example:</p> example:</p>
@@ -1591,9 +1512,7 @@ public void buildFinished(BuildEvent e) {
<p>This is more accurate than just reading the same property <p>This is more accurate than just reading the same property
files that your project does, since it will give the correct files that your project does, since it will give the correct
results for properties that were specified on the Ant command line.</p> results for properties that were specified on the Ant command line.</p>
</p>
</a>
<a name="remove-cr">
<a name="remove-cr"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -1604,7 +1523,6 @@ public void buildFinished(BuildEvent e) {
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>The <code>antRun</code> script in <code>ANT_HOME/bin</code> <p>The <code>antRun</code> script in <code>ANT_HOME/bin</code>
has DOS instead of Unix line endings; you must remove the has DOS instead of Unix line endings; you must remove the
carriage-return characters from this file. This can be done by carriage-return characters from this file. This can be done by
@@ -1614,9 +1532,7 @@ public void buildFinished(BuildEvent e) {
tr -d '\r' < $ANT_HOME/bin/antRun > /tmp/foo tr -d '\r' < $ANT_HOME/bin/antRun > /tmp/foo
mv /tmp/foo $ANT_HOME/bin/antRun mv /tmp/foo $ANT_HOME/bin/antRun
</pre> </pre>
</p>
</a>
<a name="javadoc-cannot-execute">
<a name="javadoc-cannot-execute"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -1626,14 +1542,11 @@ mv /tmp/foo $ANT_HOME/bin/antRun
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>There is a bug in the Solaris reference implementation of <p>There is a bug in the Solaris reference implementation of
the JDK (see <a href="http://developer.java.sun.com/developer/bugParade/bugs/4230399.html">http://developer.java.sun.com/developer/bugParade/bugs/4230399.html</a>). the JDK (see <a href="http://developer.java.sun.com/developer/bugParade/bugs/4230399.html">http://developer.java.sun.com/developer/bugParade/bugs/4230399.html</a>).
This also appears to be true under Linux. Moving the JDK to This also appears to be true under Linux. Moving the JDK to
the front of the PATH fixes the problem.</p> the front of the PATH fixes the problem.</p>
</p>
</a>
<a name="delegating-classloader">
<a name="delegating-classloader"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -1644,7 +1557,6 @@ mv /tmp/foo $ANT_HOME/bin/antRun
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>These tasks don't ignore your classpath setting, you <p>These tasks don't ignore your classpath setting, you
are facing a common problem with delegating classloaders.</p> are facing a common problem with delegating classloaders.</p>
<p>First of all let's state that Ant adds all <p>First of all let's state that Ant adds all
@@ -1736,9 +1648,7 @@ mv /tmp/foo $ANT_HOME/bin/antRun
for <code><junit></code>, you still have to use a for <code><junit></code>, you still have to use a
<code><taskdef></code> with a nested <code><taskdef></code> with a nested
<code><classpath></code> to define the junit task.</p> <code><classpath></code> to define the junit task.</p>
</p>
</a>
<a name="winxp-jdk14-ant14">
<a name="winxp-jdk14-ant14"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -1751,7 +1661,6 @@ mv /tmp/foo $ANT_HOME/bin/antRun
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>Ant < 1.5 doesn't recognize Windows XP as a flavor <p>Ant < 1.5 doesn't recognize Windows XP as a flavor
of Windows that runs <code>CMD.EXE</code> instead of of Windows that runs <code>CMD.EXE</code> instead of
<code>COMMAND.COM</code>. JDK 1.3 will tell Ant that Windows <code>COMMAND.COM</code>. JDK 1.3 will tell Ant that Windows
@@ -1761,9 +1670,7 @@ mv /tmp/foo $ANT_HOME/bin/antRun
environment variable <code>ANT_OPTS</code> to environment variable <code>ANT_OPTS</code> to
<code>-Dos.name=Windows_NT</code> prior to invoking Ant has <code>-Dos.name=Windows_NT</code> prior to invoking Ant has
been confirmed as a workaround.</p> been confirmed as a workaround.</p>
</p>
</a>
<a name="1.5-cygwin-sh">
<a name="1.5-cygwin-sh"></a>
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#4C6C8F"> <tr><td bgcolor="#4C6C8F">
<font color="#ffffff" face="arial,helvetica,sanserif"> <font color="#ffffff" face="arial,helvetica,sanserif">
@@ -1775,15 +1682,12 @@ mv /tmp/foo $ANT_HOME/bin/antRun
</font> </font>
</td></tr> </td></tr>
</table> </table>
<p>
<p>This problem has been reported only hours after Ant 1.5 has <p>This problem has been reported only hours after Ant 1.5 has
been released, see <a href="http://nagoya.apache.org/bugzilla/show_bug.cgi?id=10664">Bug been released, see <a href="http://nagoya.apache.org/bugzilla/show_bug.cgi?id=10664">Bug
10664</a> and all it's duplicates.</p> 10664</a> and all it's duplicates.</p>
<p>A fixed version of the wrapper script can be found <a href="http://jakarta.apache.org/builds/jakarta-ant/release/v1.5/errata/">here</a>. <p>A fixed version of the wrapper script can be found <a href="http://jakarta.apache.org/builds/jakarta-ant/release/v1.5/errata/">here</a>.
Simply replace your script with this version.</p> Simply replace your script with this version.</p>
</p>
</a>
</p>
</p>
</div> </div>
</td><td width="10"><img width="10" height="1" alt="" src="images/spacer.gif"></td> </td><td width="10"><img width="10" height="1" alt="" src="images/spacer.gif"></td>
Conor MacNeill
22 years ago