From b2bbaffc4d9c12cccfcc70bfea940a6f6be1f886 Mon Sep 17 00:00:00 2001 From: Peter Reilly Date: Fri, 29 Sep 2006 22:49:08 +0000 Subject: [PATCH] add a comment about /etc/ant.conf and about quotes and / in ANT_HOME,CLASSPATH and JAVA_HOME git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@451487 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/install.html | 44 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) diff --git a/docs/manual/install.html b/docs/manual/install.html index 3f8b476dc..a2cb6db3d 100644 --- a/docs/manual/install.html +++ b/docs/manual/install.html @@ -211,6 +211,50 @@ 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.

+ + + + + + + + +
+ Windows Note: +
  + The ant.bat script makes use of three environment variables - + ANT_HOME, CLASSPATH and JAVA_HOME. Ensure that if + these variables are set, they do not have quotes (either + ' or ") and they do not end with \ or with /. +
+ + + + + + + + +
+ Linux Note: +
  + A jpackage rpm version of ant may be installed on your machine, + say as part of install of Fedora Core 3. If another version + of ant is installed, the rpm version will take + priority. This is due to the fact that ant bash script file + dot includes the /etc/ant.conf file from the jpackage distribution. + The current version of this file (sept 2006) overwrites the + ANT_HOME environment variable. If this happens, ant will + issue a warning. To fix this, modify the line in /etc/ant.conf +
+ ANT_HOME=/usr/share/ant +
+ to be +
+ ANT_HOME=${ANT_HOME:-/usr/share/ant}. +
+ +

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