diff --git a/docs/manual/install.html b/docs/manual/install.html index f4940bce4..71c8014c5 100644 --- a/docs/manual/install.html +++ b/docs/manual/install.html @@ -122,7 +122,8 @@ installed in a short, 8.3 path, such as C:\Ant.
Before you can run ant there is some additional set up you -will need to do:
+will need to do unless you are installing the RPM +version from jpackage.org:bin
directory to your path.ANT_HOME
environment variable to the
@@ -168,6 +169,42 @@ export PATH=${PATH}:${ANT_HOME}/bin
setenv JAVA_HOME /usr/local/jdk-1.2.2
set path=( $path $ANT_HOME/bin )
+
+
+The JPackage project distributes an RPM version of Ant.
+With this version, it is not necessary to set JAVA_HOME
or
+ ANT_HOME
environment variables and the RPM installer will correctly
+place the Ant executable on your path. The ANT_HOME
environment variable will
+be ignored, if set, when running the JPackage version of Ant.
+
+Optional jars for the JPackage version are handled in two ways. The easiest, and
+best way is to get these external libraries from JPackage if JPackage has them
+available. (Note: for each such library, you will have to get both the external
+package itself (e.g. oro-2.0.8-2jpp.noarch.rpm
) and the small library that links
+ant and the external package (e.g. ant-apache-oro-1.6.2-3jpp.noarch.rpm
).
+
+However, JPackage does not package proprietary software, and since some of the +optional packages depend on proprietary jars, they must be handled as follows. +This may violate the spirit of JPackage, but it is necessary if you need these proprietary packages. +For example, suppose you want to install support for starteam, which jpackage does not +support: +
$ANT_HOME/lib
,
+which, for JPackage is usually /usr/share/ant/lib
. Another, less messy option
+is to create an .ant/lib
subdirectory of your home directory and place your
+non-jpackage ant jars there, thereby avoiding mixing jpackage
+libraries with non-jpacakge stuff in the same folder. More information on where Ant finds its libraries is available
+hereant-starteam.jar
, into the library directory you
+chose in step 1 above.--noconfig
command-line switch to avoid JPackage's classpath mechanism.