git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@274142 13f79535-47bb-0310-9956-ffa450edef68master
@@ -145,7 +145,7 @@ how to generate a HTML report from the XML report.</p> | |||||
out="changelog.html" | out="changelog.html" | ||||
style="${ant.home}/etc/changelog.xsl"> | style="${ant.home}/etc/changelog.xsl"> | ||||
<param name="title" expression="Ant ChangeLog"/> | <param name="title" expression="Ant ChangeLog"/> | ||||
<param name="module" expression="jakarta-ant"/> | |||||
<param name="module" expression="ant"/> | |||||
<param name="cvsweb" expression="http://cvs.apache.org/viewcvs/"/> | <param name="cvsweb" expression="http://cvs.apache.org/viewcvs/"/> | ||||
</style> | </style> | ||||
</pre> | </pre> | ||||
@@ -169,7 +169,7 @@ This allows temp[lates to be stored inside jar]]></msg> | |||||
</changelog> | </changelog> | ||||
</pre> | </pre> | ||||
<hr><p align="center">Copyright © 2002 Apache Software Foundation. All rights | |||||
<hr><p align="center">Copyright © 2002-2003 Apache Software Foundation. All rights | |||||
Reserved.</p> | Reserved.</p> | ||||
</body> | </body> | ||||
@@ -113,10 +113,10 @@ preferred over the <i>checkout</i> command, because of speed.</p> | |||||
</table> | </table> | ||||
<h3>Examples</h3> | <h3>Examples</h3> | ||||
<pre> <cvs cvsRoot=":pserver:anoncvs@cvs.apache.org:/home/cvspublic" | <pre> <cvs cvsRoot=":pserver:anoncvs@cvs.apache.org:/home/cvspublic" | ||||
package="jakarta-ant" | |||||
package="ant" | |||||
dest="${ws.dir}" | dest="${ws.dir}" | ||||
/></pre> | /></pre> | ||||
<p>checks out the package/module "jakarta-ant" from the CVS | |||||
<p>checks out the package/module "ant" from the CVS | |||||
repository pointed to by the cvsRoot attribute, and stores the files in "${ws.dir}".</p> | repository pointed to by the cvsRoot attribute, and stores the files in "${ws.dir}".</p> | ||||
<pre> <cvs dest="${ws.dir}" command="update"/></pre> | <pre> <cvs dest="${ws.dir}" command="update"/></pre> | ||||
<p>updates the package/module that has previously been checked out into | <p>updates the package/module that has previously been checked out into | ||||
@@ -159,7 +159,7 @@ before the command, and any command options should appear after the command as i | |||||
above. See <a href="http://www.cvshome.org/docs/manual/index.html" target="_top">the cvs manual</a> for details, | above. See <a href="http://www.cvshome.org/docs/manual/index.html" target="_top">the cvs manual</a> for details, | ||||
specifically the <a href="http://www.cvshome.org/docs/manual/cvs_16.html" target="_top">Guide to CVS commands</a></p> | specifically the <a href="http://www.cvshome.org/docs/manual/cvs_16.html" target="_top">Guide to CVS commands</a></p> | ||||
<hr> | <hr> | ||||
<p align="center">Copyright © 2000-2002 Apache Software | |||||
<p align="center">Copyright © 2000-2003 Apache Software | |||||
Foundation. All rights Reserved.</p> | Foundation. All rights Reserved.</p> | ||||
</body> | </body> | ||||
@@ -102,40 +102,40 @@ | |||||
<h3>Examples</h3> | <h3>Examples</h3> | ||||
<pre> <cvstagdiff cvsRoot=":pserver:anoncvs@cvs.apache.org:/home/cvspublic" | <pre> <cvstagdiff cvsRoot=":pserver:anoncvs@cvs.apache.org:/home/cvspublic" | ||||
destfile="tagdiff.xml" | destfile="tagdiff.xml" | ||||
package="jakarta-ant" | |||||
package="ant" | |||||
startTag="ANT_14" | startTag="ANT_14" | ||||
endTag="ANT_141" | endTag="ANT_141" | ||||
/></pre> | /></pre> | ||||
<p>Generates a tagdiff report for all the changes that have been made | <p>Generates a tagdiff report for all the changes that have been made | ||||
in the <code>jakarta-ant</code> module between the tags <code>ANT_14</code> and <code>ANT_141</code>. | |||||
in the <code>ant</code> module between the tags <code>ANT_14</code> and <code>ANT_141</code>. | |||||
It writes these changes into the file <code>tagdiff.xml</code>.</p> | It writes these changes into the file <code>tagdiff.xml</code>.</p> | ||||
<pre> <cvstagdiff | <pre> <cvstagdiff | ||||
destfile="tagdiff.xml" | destfile="tagdiff.xml" | ||||
package="jakarta-ant" | |||||
package="ant" | |||||
startDate="2002-01-01" | startDate="2002-01-01" | ||||
endDate="2002-31-01" | endDate="2002-31-01" | ||||
/></pre> | /></pre> | ||||
<p>Generates a tagdiff report for all the changes that have been made | <p>Generates a tagdiff report for all the changes that have been made | ||||
in the <code>jakarta-ant</code> module in january 2002. In this example <code>cvsRoot</code> | |||||
in the <code>ant</code> module in january 2002. In this example <code>cvsRoot</code> | |||||
has not been set. The current <code>cvsRoot</code> will be used (assuming the build is started | has not been set. The current <code>cvsRoot</code> will be used (assuming the build is started | ||||
from a folder stored in <code>cvs</code>. | from a folder stored in <code>cvs</code>. | ||||
It writes these changes into the file <code>tagdiff.xml</code>.</p> | It writes these changes into the file <code>tagdiff.xml</code>.</p> | ||||
<pre> <cvstagdiff | <pre> <cvstagdiff | ||||
destfile="tagdiff.xml" | destfile="tagdiff.xml" | ||||
package="jakarta-ant" | |||||
rootdir="jakarta/ant" | |||||
package="ant" | |||||
rootdir="apache/ant" | |||||
startDate="2002-01-01" | startDate="2002-01-01" | ||||
endDate="2002-31-01" | endDate="2002-31-01" | ||||
/></pre> | /></pre> | ||||
<p>Generates a tagdiff report for all the changes that have been made | <p>Generates a tagdiff report for all the changes that have been made | ||||
in the <code>jakarta-ant</code> module in january 2002, with <code>rootdir</code> indicating that | |||||
the actual location of the <code>jakarta-ant</code> module in cvs is <code>jakarta/ant</code> | |||||
rather than <code>jakarta-ant</code>. In this example <code>cvsRoot</code> | |||||
in the <code>ant</code> module in january 2002, with <code>rootdir</code> indicating that | |||||
the actual location of the <code>ant</code> module in cvs is <code>apache/ant</code> | |||||
rather than <code>ant</code>. In this example <code>cvsRoot</code> | |||||
has not been set. The current <code>cvsRoot</code> will be used (assuming the build is started | has not been set. The current <code>cvsRoot</code> will be used (assuming the build is started | ||||
from a folder stored in <code>cvs</code>. | from a folder stored in <code>cvs</code>. | ||||
It writes these changes into the file <code>tagdiff.xml</code>.</p> | It writes these changes into the file <code>tagdiff.xml</code>.</p> | ||||
@@ -150,7 +150,7 @@ how to generate a HTML report from the XML report.</p> | |||||
out="tagdiff.html" | out="tagdiff.html" | ||||
style="${ant.home}/etc/tagdiff.xsl"> | style="${ant.home}/etc/tagdiff.xsl"> | ||||
<param name="title" expression="Ant Diff"/> | <param name="title" expression="Ant Diff"/> | ||||
<param name="module" expression="jakarta-ant"/> | |||||
<param name="module" expression="ant"/> | |||||
<param name="cvsweb" expression="http://cvs.apache.org/viewcvs/"/> | <param name="cvsweb" expression="http://cvs.apache.org/viewcvs/"/> | ||||
</style> | </style> | ||||
</pre> | </pre> | ||||
@@ -169,7 +169,7 @@ how to generate a HTML report from the XML report.</p> | |||||
</tagdiff> | </tagdiff> | ||||
</pre> | </pre> | ||||
<hr><p align="center">Copyright © 2002 Apache Software Foundation. All rights | |||||
<hr><p align="center">Copyright © 2002-2003 Apache Software Foundation. All rights | |||||
Reserved.</p> | Reserved.</p> | ||||
</body> | </body> | ||||
@@ -748,7 +748,7 @@ | |||||
<p>Here is an example of how to use the Selector Reference:</p> | <p>Here is an example of how to use the Selector Reference:</p> | ||||
<blockquote><pre> | <blockquote><pre> | ||||
<project default="all" basedir="./jakarta-ant"> | |||||
<project default="all" basedir="./ant"> | |||||
<selector id="completed"> | <selector id="completed"> | ||||
<none> | <none> | ||||
@@ -58,15 +58,15 @@ | |||||
<H2>Getting Involved</H2> | <H2>Getting Involved</H2> | ||||
<P>The source code for Antidote is located in a separate Module | <P>The source code for Antidote is located in a separate Module | ||||
(<a href="http://cvs.apache.org/viewcvs/jakarta-ant-antidote/">jakarta-ant-antidote</a>) in CVS. | |||||
(<a href="http://cvs.apache.org/viewcvs/ant-antidote/">ant-antidote</a>) in CVS. | |||||
All the existing documentation can | All the existing documentation can | ||||
be found there where new contributors should read:</p> | be found there where new contributors should read:</p> | ||||
<UL> | <UL> | ||||
<LI><A HREF="http://cvs.apache.org/viewcvs/~checkout~/jakarta-ant-antidote/docs/developer/design/design-overview.html">Design Overview</A></LI> | |||||
<LI><A HREF="http://cvs.apache.org/viewcvs/~checkout~/jakarta-ant-antidote/docs/developer/design/gui-requirements.html">Feature List</A></LI> | |||||
<LI><A HREF="http://cvs.apache.org/viewcvs/~checkout~/jakarta-ant-antidote/docs/developer/design/gui-ideas.txt">Idea Refinement</A></LI> | |||||
<LI><A HREF="http://cvs.apache.org/viewcvs/~checkout~/jakarta-ant-antidote/docs/developer/design/new-module-howto.html">New Module HOWTO</A></LI> | |||||
<LI><A HREF="http://cvs.apache.org/viewcvs/~checkout~/jakarta-ant-antidote/docs/developer/design/uml/index.html">Static Class Diagrams</A></LI> | |||||
<LI><A HREF="http://cvs.apache.org/viewcvs/~checkout~/ant-antidote/docs/developer/design/design-overview.html">Design Overview</A></LI> | |||||
<LI><A HREF="http://cvs.apache.org/viewcvs/~checkout~/ant-antidote/docs/developer/design/gui-requirements.html">Feature List</A></LI> | |||||
<LI><A HREF="http://cvs.apache.org/viewcvs/~checkout~/ant-antidote/docs/developer/design/gui-ideas.txt">Idea Refinement</A></LI> | |||||
<LI><A HREF="http://cvs.apache.org/viewcvs/~checkout~/ant-antidote/docs/developer/design/new-module-howto.html">New Module HOWTO</A></LI> | |||||
<LI><A HREF="http://cvs.apache.org/viewcvs/~checkout~/ant-antidote/docs/developer/design/uml/index.html">Static Class Diagrams</A></LI> | |||||
</UL> | </UL> | ||||
<P>Online discussions about Antidote occur on the <A | <P>Online discussions about Antidote occur on the <A | ||||
@@ -342,7 +342,7 @@ install directory. If You have installed it elsewhere, adapt the pathes below. | |||||
task). If You need this tasks either import these packages into VAJ, too, or | task). If You need this tasks either import these packages into VAJ, too, or | ||||
copy the .class files directly from the binary distribution. | copy the .class files directly from the binary distribution. | ||||
<li>copy <CODE>default.ini</CODE> (in <CODE> | <li>copy <CODE>default.ini</CODE> (in <CODE> | ||||
jakarta-ant\src\...\taskdefs\optional\ide</CODE>) to <CODE> | |||||
ant\src\...\taskdefs\optional\ide</CODE>) to <CODE> | |||||
C:\IBMVJava\ide\tools\org-apache-tools-ant\default.ini</CODE>. | C:\IBMVJava\ide\tools\org-apache-tools-ant\default.ini</CODE>. | ||||
<li>if you want to access this help from the Workbench, create the | <li>if you want to access this help from the Workbench, create the | ||||
@@ -14,7 +14,7 @@ builds.</p> | |||||
<p>If you want to see the API docs for the latest code, they are | <p>If you want to see the API docs for the latest code, they are | ||||
generated by <a href="http://jakarta.apache.org/gump/">Apache Gump</a> | generated by <a href="http://jakarta.apache.org/gump/">Apache Gump</a> | ||||
and linked from <a | and linked from <a | ||||
href="http://nagoya.apache.org/gump/javadoc/jakarta-ant/build/javadocs/index.html">http://nagoya.apache.org/gump/javadoc/jakarta-ant/build/javadocs/index.html</a>.</p> | |||||
href="http://nagoya.apache.org/gump/javadoc/ant/build/javadocs/index.html">http://nagoya.apache.org/gump/javadoc/ant/build/javadocs/index.html</a>.</p> | |||||
</body> | </body> | ||||
</html> | </html> | ||||
@@ -13,7 +13,7 @@ | |||||
href="http://ant.apache.org/">http://ant.apache.org/</a>. | href="http://ant.apache.org/">http://ant.apache.org/</a>. | ||||
If you like living on the edge, you can download the latest version from <a | If you like living on the edge, you can download the latest version from <a | ||||
href="http://cvs.apache.org/builds/jakarta-ant/nightly/">http://cvs.apache.org/builds/jakarta-ant/nightly/</a>.</p> | |||||
href="http://cvs.apache.org/builds/ant/nightly/">http://cvs.apache.org/builds/ant/nightly/</a>.</p> | |||||
<h3>Source Edition</h3> | <h3>Source Edition</h3> | ||||
<p>If you prefer the source edition, you can download the source for the latest Ant release from <a href="http://ant.apache.org/srcdownload.cgi">http://ant.apache.org/srcdownload.cgi</a>. | <p>If you prefer the source edition, you can download the source for the latest Ant release from <a href="http://ant.apache.org/srcdownload.cgi">http://ant.apache.org/srcdownload.cgi</a>. | ||||
@@ -21,39 +21,39 @@ href="http://cvs.apache.org/builds/jakarta-ant/nightly/">http://cvs.apache.org/b | |||||
Again, if you prefer the edge, you can access | Again, if you prefer the edge, you can access | ||||
the code as it is being developed via CVS. The Jakarta website has details on | the code as it is being developed via CVS. The Jakarta website has details on | ||||
<a href="http://jakarta.apache.org/site/cvsindex.html" target="_top">accessing CVS</a>. Please checkout the | <a href="http://jakarta.apache.org/site/cvsindex.html" target="_top">accessing CVS</a>. Please checkout the | ||||
jakarta-ant module. | |||||
ant module. | |||||
See the section <a href="#buildingant">Building Ant</a> on how to | See the section <a href="#buildingant">Building Ant</a> on how to | ||||
build Ant from the source code. | build Ant from the source code. | ||||
You can also access the | |||||
<a href="http://cvs.apache.org/viewcvs/jakarta-ant/" target="_top"> | |||||
You can also access the | |||||
<a href="http://cvs.apache.org/viewcvs/ant/" target="_top"> | |||||
Ant CVS repository</a> on-line. </p> | Ant CVS repository</a> on-line. </p> | ||||
<hr> | <hr> | ||||
<h2><a name="sysrequirements">System Requirements</a></h2> | <h2><a name="sysrequirements">System Requirements</a></h2> | ||||
Ant has been used successfully on many platforms, including Linux, | Ant has been used successfully on many platforms, including Linux, | ||||
commercial flavours of Unix such as Solaris and HP-UX, | commercial flavours of Unix such as Solaris and HP-UX, | ||||
Windows 9x and NT, Novell Netware 6 and MacOS X. | |||||
Windows 9x and NT, Novell Netware 6 and MacOS X. | |||||
<p> | <p> | ||||
To build and use Ant, you must have a JAXP-compliant XML parser installed and | |||||
To build and use Ant, you must have a JAXP-compliant XML parser installed and | |||||
available on your classpath.</p> | available on your classpath.</p> | ||||
<p> | <p> | ||||
The binary distribution of Ant includes the latest version of the | The binary distribution of Ant includes the latest version of the | ||||
<a href="http://xml.apache.org/xerces2-j/index.html">Apache Xerces2</a> XML parser. | |||||
Please see | |||||
<a href="http://java.sun.com/xml/" target="_top">http://java.sun.com/xml/</a> | |||||
for more information about JAXP. | |||||
<a href="http://xml.apache.org/xerces2-j/index.html">Apache Xerces2</a> XML parser. | |||||
Please see | |||||
<a href="http://java.sun.com/xml/" target="_top">http://java.sun.com/xml/</a> | |||||
for more information about JAXP. | |||||
If you wish to use a different JAXP-compliant parser, you should remove | If you wish to use a different JAXP-compliant parser, you should remove | ||||
<code>xercesImpl.jar</code> and <code>xml-apis.jar</code> | <code>xercesImpl.jar</code> and <code>xml-apis.jar</code> | ||||
from Ant's <code>lib</code> directory. | from Ant's <code>lib</code> directory. | ||||
You can then either put the jars from your preferred parser into Ant's | |||||
You can then either put the jars from your preferred parser into Ant's | |||||
<code>lib</code> directory or put the jars on the system classpath.</p> | <code>lib</code> directory or put the jars on the system classpath.</p> | ||||
<p> | <p> | ||||
For the current version of Ant, you will also need a JDK installed on | For the current version of Ant, you will also need a JDK installed on | ||||
your system, version 1.1 or later. Some tasks work better on post-1.1 systems; | your system, version 1.1 or later. Some tasks work better on post-1.1 systems; | ||||
some tasks only work on Java 1.2 and successors. | |||||
some tasks only work on Java 1.2 and successors. | |||||
A future version of Ant -Ant 2.0- will require JDK 1.2 or later, though | A future version of Ant -Ant 2.0- will require JDK 1.2 or later, though | ||||
Ant 1.x strives to retain 1.1 compatibility. | Ant 1.x strives to retain 1.1 compatibility. | ||||
</p><p> | </p><p> | ||||
@@ -62,7 +62,7 @@ compiler is supported. | |||||
</p> | </p> | ||||
<p> | <p> | ||||
<strong>Note #2: </strong>If a JDK is not present, only the JRE runtime, then many tasks will not work. | <strong>Note #2: </strong>If a JDK is not present, only the JRE runtime, then many tasks will not work. | ||||
</p> | |||||
</p> | |||||
<hr> | <hr> | ||||
<h2><a name="installing">Installing Ant</a></h2> | <h2><a name="installing">Installing Ant</a></h2> | ||||
<p>The binary distribution of Ant consists of the following directory layout: | <p>The binary distribution of Ant consists of the following directory layout: | ||||
@@ -85,11 +85,11 @@ compiler is supported. | |||||
// - ... and more ;-) | // - ... and more ;-) | ||||
</pre> | </pre> | ||||
Only the <code>bin</code> and <code>lib</code> directories are | |||||
required to run Ant. | |||||
Only the <code>bin</code> and <code>lib</code> directories are | |||||
required to run Ant. | |||||
To install Ant, choose a directory and copy the distribution | To install Ant, choose a directory and copy the distribution | ||||
file there. This directory will be known as ANT_HOME. | |||||
file there. This directory will be known as ANT_HOME. | |||||
</p> | </p> | ||||
<table width="80%"> | <table width="80%"> | ||||
@@ -124,7 +124,7 @@ installed in a <b>short</b>, 8.3 path, such as C:\Ant. </i> | |||||
<h3>Setup</h3> | <h3>Setup</h3> | ||||
<p> | <p> | ||||
Before you can run ant there is some additional set up you | |||||
Before you can run ant there is some additional set up you | |||||
will need to do:</p> | will need to do:</p> | ||||
<ul> | <ul> | ||||
<li>Add the <code>bin</code> directory to your path.</li> | <li>Add the <code>bin</code> directory to your path.</li> | ||||
@@ -137,19 +137,19 @@ Windows NT/2000) - but it is better to not rely on this behavior.</li> | |||||
This should be set to the directory where your JDK is installed.</li> | This should be set to the directory where your JDK is installed.</li> | ||||
</ul> | </ul> | ||||
<p><strong>Note:</strong> Do not install Ant's ant.jar file into the lib/ext | <p><strong>Note:</strong> Do not install Ant's ant.jar file into the lib/ext | ||||
directory of the JDK/JRE. Ant is an application, whilst the extension | |||||
directory is intended for JDK extensions. In particular there are security | |||||
directory of the JDK/JRE. Ant is an application, whilst the extension | |||||
directory is intended for JDK extensions. In particular there are security | |||||
restrictions on the classes which may be loaded by an extension.</p> | restrictions on the classes which may be loaded by an extension.</p> | ||||
<h3><a name="optionalTasks">Optional Tasks</a></h3> | <h3><a name="optionalTasks">Optional Tasks</a></h3> | ||||
<p>Ant supports a number of optional tasks. An optional task is a task which | <p>Ant supports a number of optional tasks. An optional task is a task which | ||||
typically requires an external library to function. The optional tasks are | |||||
typically requires an external library to function. The optional tasks are | |||||
packaged together with the core Ant tasks.</p> | packaged together with the core Ant tasks.</p> | ||||
<p>The external libraries required by each of the optional tasks is detailed | <p>The external libraries required by each of the optional tasks is detailed | ||||
in the <a href="#librarydependencies">Library Dependencies</a> section. These external | in the <a href="#librarydependencies">Library Dependencies</a> section. These external | ||||
libraries may either be placed in Ant's lib directory, where they will be picked up | libraries may either be placed in Ant's lib directory, where they will be picked up | ||||
automatically, or made available on the system CLASSPATH environment variable. | |||||
automatically, or made available on the system CLASSPATH environment variable. | |||||
</p> | </p> | ||||
<h3>Windows</h3> | <h3>Windows</h3> | ||||
@@ -177,19 +177,19 @@ set path=( $path $ANT_HOME/bin )</pre> | |||||
<p>There are lots of variants that can be used to run Ant. What you need is at | <p>There are lots of variants that can be used to run Ant. What you need is at | ||||
least the following:</p> | least the following:</p> | ||||
<ul> | <ul> | ||||
<li>The classpath for Ant must contain <code>ant.jar</code> and any jars/classes | |||||
<li>The classpath for Ant must contain <code>ant.jar</code> and any jars/classes | |||||
needed for your chosen JAXP-compliant XML parser.</li> | needed for your chosen JAXP-compliant XML parser.</li> | ||||
<li>When you need JDK functionality | <li>When you need JDK functionality | ||||
(such as for the <a href="CoreTasks/javac.html">javac</a> task or the | (such as for the <a href="CoreTasks/javac.html">javac</a> task or the | ||||
<a href="CoreTasks/rmic.html">rmic</a> task), then for JDK 1.1, the <code>classes.zip</code> | <a href="CoreTasks/rmic.html">rmic</a> task), then for JDK 1.1, the <code>classes.zip</code> | ||||
file of the JDK must be added to the classpath; for JDK 1.2 or JDK 1.3, <code>tools.jar</code> | file of the JDK must be added to the classpath; for JDK 1.2 or JDK 1.3, <code>tools.jar</code> | ||||
must be added. The scripts supplied with Ant, | must be added. The scripts supplied with Ant, | ||||
in the <code>bin</code> directory, will add | |||||
in the <code>bin</code> directory, will add | |||||
the required JDK classes automatically, if the <code>JAVA_HOME</code> | the required JDK classes automatically, if the <code>JAVA_HOME</code> | ||||
environment variable is set.</li> | environment variable is set.</li> | ||||
<li>When you are executing platform-specific applications, such as the | |||||
<a href="CoreTasks/exec.html">exec</a> task or the | |||||
<li>When you are executing platform-specific applications, such as the | |||||
<a href="CoreTasks/exec.html">exec</a> task or the | |||||
<a href="CoreTasks/cvs.html">cvs</a> task, the property <code>ant.home</code> | <a href="CoreTasks/cvs.html">cvs</a> task, the property <code>ant.home</code> | ||||
must be set to the directory containing where you installed Ant. Again | must be set to the directory containing where you installed Ant. Again | ||||
this is set by the Ant scripts to the value of the ANT_HOME environment | this is set by the Ant scripts to the value of the ANT_HOME environment | ||||
@@ -201,10 +201,10 @@ to ant. Some of the scripts also read in an extra script stored | |||||
in the users home directory, which can be used to set such options. Look | in the users home directory, which can be used to set such options. Look | ||||
at the source for your platform's invocation script for details. | at the source for your platform's invocation script for details. | ||||
<hr> | |||||
<hr> | |||||
<h2><a name="buildingant">Building Ant</a></h2> | <h2><a name="buildingant">Building Ant</a></h2> | ||||
<p>To build Ant from source, you can either install the Ant source distribution | <p>To build Ant from source, you can either install the Ant source distribution | ||||
or checkout the jakarta-ant module from CVS.</p> | |||||
or checkout the ant module from CVS.</p> | |||||
<p>Once you have installed the source, change into the installation | <p>Once you have installed the source, change into the installation | ||||
directory.</p> | directory.</p> | ||||
@@ -222,7 +222,7 @@ for a list of jar requirements for various features. | |||||
Note that this will make the auxiliary jars | Note that this will make the auxiliary jars | ||||
available for the building of Ant only. For running Ant you will | available for the building of Ant only. For running Ant you will | ||||
still need to | still need to | ||||
make the jars available as described under | |||||
make the jars available as described under | |||||
<a href="#installing">Installing Ant</a>.</p> | <a href="#installing">Installing Ant</a>.</p> | ||||
<p>Your are now ready to build Ant:</p> | <p>Your are now ready to build Ant:</p> | ||||
@@ -236,11 +236,11 @@ make the jars available as described under | |||||
<p>The above action does the following:</p> | <p>The above action does the following:</p> | ||||
<ul> | <ul> | ||||
<li>If necessary it will bootstrap the Ant code. Bootstrapping involves the manual | |||||
<li>If necessary it will bootstrap the Ant code. Bootstrapping involves the manual | |||||
compilation of enough Ant code to be able to run Ant. The bootstrapped Ant is | compilation of enough Ant code to be able to run Ant. The bootstrapped Ant is | ||||
used for the remainder of the build steps. </li> | used for the remainder of the build steps. </li> | ||||
<li>Invokes the bootstrapped Ant with the parameters passed to the build script. In | |||||
<li>Invokes the bootstrapped Ant with the parameters passed to the build script. In | |||||
this case, these parameters define an Ant property value and specify the "dist" target | this case, these parameters define an Ant property value and specify the "dist" target | ||||
in Ant's own <code>build.xml</code> file.</li> | in Ant's own <code>build.xml</code> file.</li> | ||||
</ul> | </ul> | ||||
@@ -263,9 +263,9 @@ You can avoid the lengthy Javadoc step, if desired, with: | |||||
<p><code>build install-lite</code> (<i>Windows</i>)</p> | <p><code>build install-lite</code> (<i>Windows</i>)</p> | ||||
<p><code>build.sh install-lite</code> (<i>Unix</i>)</p> | <p><code>build.sh install-lite</code> (<i>Unix</i>)</p> | ||||
</blockquote> | </blockquote> | ||||
This will only install the <code>bin</code> and <code>lib</code> directories. | |||||
<p>Both the <code>install</code> and | |||||
<code>install-lite</code> targets will overwrite | |||||
This will only install the <code>bin</code> and <code>lib</code> directories. | |||||
<p>Both the <code>install</code> and | |||||
<code>install-lite</code> targets will overwrite | |||||
the current Ant version in <code>ANT_HOME</code>.</p> | the current Ant version in <code>ANT_HOME</code>.</p> | ||||
<hr> | <hr> | ||||
@@ -288,7 +288,7 @@ Installing Ant / Optional Tasks</a> section above.</p> | |||||
<td>An XSL transformer like Xalan or XSL:P</td> | <td>An XSL transformer like Xalan or XSL:P</td> | ||||
<td>style task</td> | <td>style task</td> | ||||
<td><a href="http://xml.apache.org/xalan-j/index.html" | <td><a href="http://xml.apache.org/xalan-j/index.html" | ||||
target="_top">http://xml.apache.org/xalan-j/index.html</a> for Xalan.<br> | |||||
target="_top">http://xml.apache.org/xalan-j/index.html</a> for Xalan.<br> | |||||
XSL:P used to live at <a href="http://www.clc-marketing.com/xslp/" | XSL:P used to live at <a href="http://www.clc-marketing.com/xslp/" | ||||
target="_top">http://www.clc-marketing.com/xslp/</a>, but the link | target="_top">http://www.clc-marketing.com/xslp/</a>, but the link | ||||
doesn't work any longer and we are not aware of a replacement site.</td> | doesn't work any longer and we are not aware of a replacement site.</td> | ||||
@@ -384,7 +384,7 @@ Installing Ant / Optional Tasks</a> section above.</p> | |||||
</tr> | </tr> | ||||
<tr> | <tr> | ||||
<td>bcel.jar</td> | <td>bcel.jar</td> | ||||
<td>classfileset data type, | |||||
<td>classfileset data type, | |||||
JavaClassHelper used by the ClassConstants filter reader and | JavaClassHelper used by the ClassConstants filter reader and | ||||
optionally used by ejbjar for dependency determination | optionally used by ejbjar for dependency determination | ||||
</td> | </td> | ||||
@@ -54,20 +54,20 @@ it is treated like any other Unix. | |||||
<li><code>ANT_OPTS</code> - On NetWare, <code>ANT_OPTS</code> needs to include a parameter of the form, <nobr>"-envCWD=<code>ANT_HOME</code>"</nobr>, with <code>ANT_HOME</code> being the fully expanded location of Ant, <b>not</b> an environment variable. This is due to the fact that the NetWare System Console has no notion of a current working directory.</li> | <li><code>ANT_OPTS</code> - On NetWare, <code>ANT_OPTS</code> needs to include a parameter of the form, <nobr>"-envCWD=<code>ANT_HOME</code>"</nobr>, with <code>ANT_HOME</code> being the fully expanded location of Ant, <b>not</b> an environment variable. This is due to the fact that the NetWare System Console has no notion of a current working directory.</li> | ||||
</ul> | </ul> | ||||
<p>It is suggested that you create up an ant.ncf that sets up these parameters, and calls <code>perl ANT_HOME/dist/bin/runant.pl</code></p> | <p>It is suggested that you create up an ant.ncf that sets up these parameters, and calls <code>perl ANT_HOME/dist/bin/runant.pl</code></p> | ||||
<p>The following is an example of such an NCF file(assuming ant is installed in <nobr>'sys:/jakarta-ant/'):</nobr></p> | |||||
<p>The following is an example of such an NCF file(assuming ant is installed in <nobr>'sys:/apache-ant/'):</nobr></p> | |||||
<code> | <code> | ||||
envset CLASSPATH=SYS:/jakarta-ant/bootstrap/lib/ant.jar<br /> | |||||
envset CLASSPATH=$CLASSPATH;SYS:/jakarta-ant/lib/xercesImpl.jar <br /> | |||||
envset CLASSPATH=$CLASSPATH;SYS:/jakarta-ant/lib/xml-apis.jar <br /> | |||||
envset CLASSPATH=$CLASSPATH;SYS:/jakarta-ant/lib/optional/junit.jar <br /> | |||||
envset CLASSPATH=$CLASSPATH;SYS:/jakarta-ant/bootstrap/lib/optional.jar <br /> | |||||
envset CLASSPATH=SYS:/apache-ant/bootstrap/lib/ant.jar<br /> | |||||
envset CLASSPATH=$CLASSPATH;SYS:/apache-ant/lib/xercesImpl.jar <br /> | |||||
envset CLASSPATH=$CLASSPATH;SYS:/apache-ant/lib/xml-apis.jar <br /> | |||||
envset CLASSPATH=$CLASSPATH;SYS:/apache-ant/lib/optional/junit.jar <br /> | |||||
envset CLASSPATH=$CLASSPATH;SYS:/apache-ant/bootstrap/lib/optional.jar <br /> | |||||
<br /> | <br /> | ||||
setenv ANT_OPTS=-envCWD=sys:/jakarta-ant <br /> | |||||
envset ANT_OPTS=-envCWD=sys:/jakarta-ant <br /> | |||||
setenv ANT_HOME=sys:/jakarta-ant/dist/lib <br /> | |||||
envset ANT_HOME=sys:/jakarta-ant/dist/lib <br /> | |||||
setenv ANT_OPTS=-envCWD=sys:/apache-ant <br /> | |||||
envset ANT_OPTS=-envCWD=sys:/apache-ant <br /> | |||||
setenv ANT_HOME=sys:/apache-ant/dist/lib <br /> | |||||
envset ANT_HOME=sys:/apache-ant/dist/lib <br /> | |||||
<br /> | <br /> | ||||
perl sys:/jakarta-ant/dist/bin/runant.pl <br /> | |||||
perl sys:/apache-ant/dist/bin/runant.pl <br /> | |||||
</code> | </code> | ||||
<p>Ant works on JVM version 1.3 or higher. You may have some luck running it on JVM 1.2, but serious problems have been found running Ant on JVM 1.1.7B. These problems are caused by JVM bugs that will not be fixed.</p> | <p>Ant works on JVM version 1.3 or higher. You may have some luck running it on JVM 1.2, but serious problems have been found running Ant on JVM 1.1.7B. These problems are caused by JVM bugs that will not be fixed.</p> | ||||
@@ -26,7 +26,6 @@ | |||||
<p>The final version of Ant 1.5.1 is now available for | <p>The final version of Ant 1.5.1 is now available for | ||||
<a href="http://ant.apache.org/bindownload.cgi"> | <a href="http://ant.apache.org/bindownload.cgi"> | ||||
download</a>. If you have any feedback on this release, feel free to join the | download</a>. If you have any feedback on this release, feel free to join the | ||||
<!-- discussion on the dev and user mailing lists.--> | |||||
discussion on the ant-dev and ant-user mailing lists. | discussion on the ant-dev and ant-user mailing lists. | ||||
</p> | </p> | ||||
</section> | </section> | ||||