From b38b7eee8e01e6314bf7836a0b26329fb32b0261 Mon Sep 17 00:00:00 2001 From: Conor MacNeill Date: Thu, 19 Jul 2001 14:37:22 +0000 Subject: [PATCH] Document the requirement for optional jar and how to install it git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@269366 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/install.html | 27 +++++++++++++++++++-------- 1 file changed, 19 insertions(+), 8 deletions(-) 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.