conor 01/02/10 00:51:14
Modified: docs/manual Tag: ANT_13_BRANCH install.html
Log:
Add information about how to handle optional task dependencies.
I converted David's submission into plain vanilla HTML
Submitted by: David Rees <d.rees.l@usa.net>
Revision Changes Path
No revision
No revision
1.1.2.3 +92 -6 jakarta-ant/docs/manual/Attic/install.html
Index: install.html
===================================================================
RCS file: /home/cvs/jakarta-ant/docs/manual/Attic/install.html,v
retrieving revision 1.1.2.2
retrieving revision 1.1.2.3
diff -u -r1.1.2.2 -r1.1.2.3
--- install.html 2001/02/08 14:48:43 1.1.2.2
+++ install.html 2001/02/10 08:51:14 1.1.2.3
@@ -84,9 +84,15 @@
<li>Add the <code>bin</code> directory to your path.</li>
<li>Set the <code>ANT_HOME</code> environment variable to
the directory where you installed Ant.</li>
-<li>Optionally, set the <code>JAVA_HOME</code> environment variable.
-(See the <a href="#advanced">Advanced</a> section below.)
+<li>Optionally, set the <code>JAVA_HOME</code> environment variable
+(see the <a href="#advanced">Advanced</a> section below).
This should be set to the directory where your JDK is installed.</li>
+<li>If you are using Ant's optional tasks then you may need to add additional
+jars to your <code>lib</code> directory or to your CLASSPATH.
+See <a href="#librarydependencies">Library Dependencies</a>
+for for a list of jar requirements for various optional tasks.
+</li>
+
</ul>
<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
@@ -145,11 +151,17 @@
See <a href="#installing">Installing Ant</a>
for examples on how to do this for your operating system. </p>
-<p>Make sure you have downloaded any auxilliary jars required to
+<p>Make sure you have downloaded any auxiliary jars required to
build tasks you are interested in. These should either be available
-on the classpath or added to <code>lib/optional</code>
-directory. The list of auxilliary tasks and requirements is in
-<code>lib/README</code>.</p>
+on the CLASSPATH or added to the <code>lib/optional</code>
+directory.
+See <a href="#librarydependencies">Library Dependencies</a>
+for for a list of jar requirements for various features.
+Note that this will make the auxiliary jars
+available for the building of Ant only. For running Ant you will
+still need to
+make the jars available as described under
+<a href="#installing">Installing Ant</a>.</p>
<p>Your are now ready to build Ant:</p>
<blockquote>
@@ -293,6 +305,80 @@
<li>jars/classes for your XML parser
<li>the JDK's required jar/zip files
</ul>
+<hr>
+<h2><a name="librarydependencies">Library Dependencies</a></h2>
+<p>The following libraries are needed in your CLASSPATH or in the
+install directory's <code>lib</code> directory if you are using the
+indicated feature. Note that only one of the regexp libraries is
+needed for use with the mappers.</p>
+<p/>
+
+<table border="1" cellpadding="2" cellspacing="0">
+ <tr>
+ <td><b>Jar Name</b></td>
+ <td><b>Needed For</b></td>
+ <td><b>Available At</b></td>
+ </tr>
+ <tr>
+ <td>jakarta-regexp-1.2.jar</td>
+ <td>regexp type with mappers</td>
+ <td><a href="http://jakarta.apache.org/regexp/" target="_top">jakarta.apache.org/regexp/</a></td>
+ </tr>
+ <tr>
+ <td>jakarta-oro-2.0.1.jar</td>
+ <td>regexp type with mappers and the perforce tasks</td>
+ <td><a href="http://jakarta.apache.org/oro/" target="_top">jakarta.apache.org/oro/</a></td>
+ </tr>
+ <tr>
+ <td>junit.jar</td>
+ <td>junit tasks</td>
+ <td><a href="http://www.junit.org/" target="_top">www.junit.org</a></td>
+ </tr>
+ <tr>
+ <td>stylebook.jar</td>
+ <td>stylebook task</td>
+ <td>CVS repository of <a href="http://xml.apache.org" target="_top">xml.apache.org</a></td>
+ </tr>
+ <tr>
+ <td>testlet.jar</td>
+ <td>test task</td>
+ <td><a href="http://java.apache.org/framework" target="_top">java.apache.org/framework</a></td>
+ </tr>
+ <tr>
+ <td>antlr.jar</td>
+ <td>antlr task</td>
+ <td><a href="http://www.antlr.org/" target="_top">www.antlr.org</a></td>
+ </tr>
+ <tr>
+ <td >bsf.jar</td>
+ <td>script task</td>
+ <td><a href="http://oss.software.ibm.com/developerworks/projects/bsf" target="_top">
+ oss.software.ibm.com/developerworks/projects/bsf</a></td>
+ </tr>
+ <tr>
+ <td>netrexx.jar</td>
+ <td>netrexx task</td>
+ <td><a href="http://www2.hursley.ibm.com/netrexx" target="_top">
+ www2.hursley.ibm.com/netrexx</a></td>
+ </tr>
+ <tr>
+ <td>rhino.jar</td>
+ <td>javascript with script task</td>
+ <td><a href="http://www.mozilla.org/" target="_top">www.mozilla.org</a></td>
+ </tr>
+ <tr>
+ <td>jpython.jar</td>
+ <td>python with script task</td>
+ <td><a href="http://www.jpython.org/" target="_top">www.jpython.org</a></td>
+ </tr>
+ <tr>
+ <td>netcomponents.jar</td>
+ <td>ftp and telnet tasks</td>
+ <td><a href="http://www.savarese.org/oro/downloads/index.html#NetComponents"
+ target="_top">www.savarese.org/oro/downloads</a></td>
+ </tr>
+</table>
+<br>
<hr>
<p align="center">Copyright © 2000,2001 Apache Software Foundation. All
rights
Reserved.</p>
|