diff --git a/docs/manual/install.html b/docs/manual/install.html index 43950efb2..b060aa3d5 100644 --- a/docs/manual/install.html +++ b/docs/manual/install.html @@ -6,7 +6,6 @@ -

Installing Ant

Getting Ant

Binary edition

@@ -100,18 +99,27 @@ Windows NT/2000) - but it is better to not rely on this behavior.
  • Optionally, set the JAVA_HOME environment variable (see the Advanced section below). This should be set to the directory where your JDK is installed.
    • -
  • If you are using Ant's optional tasks then you may need to add additional -jars to your lib directory or to your CLASSPATH. -See Library Dependencies -for for a list of jar requirements for various optional tasks. -
    • -

    Note: 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 restrictions on the classes which may be loaded by an extension.

    +

    Optional Tasks

    +

    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 +packaged separately from the core Ant tasks. This package is available in +the same download directory as the core ant distribution. The current +jar containing optional tasks is named jakarta-ant-1.3-optional.jar. +This jar should be downloaded and placed in the lib directory of your Ant +installation.

    + +

    The external libraries required by each of the optional tasks is detailed +in the Library Dependencies section. These external +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. +

    +

    Windows

    Assume Ant is installed in c:\ant\. The following sets up the environment:

    @@ -223,7 +231,10 @@ the current Ant version in ANT_HOME.

    The following libraries are needed in your CLASSPATH or in the install directory's lib directory if you are using the indicated feature. Note that only one of the regexp libraries is -needed for use with the mappers.

    +needed for use with the mappers. You will also need to install the +Ant optional jar containing the task definitions to make these +tasks available. Please refer to the +Installing Ant section above.