diff --git a/docs/manual/running.html b/docs/manual/running.html index 5737d1cfd..bc442e46b 100644 --- a/docs/manual/running.html +++ b/docs/manual/running.html @@ -132,7 +132,7 @@ containing third-party tasks to be used in the build. It also allows the main An Additional directories to be searched may be added by using the -lib option. The -lib option specifies a search path. Any jars or classes in the directories of the path will be added to Ant's classloader. The order in which jars are -added to the classpath is as follows:- +added to the classpath is as follows:
Some of Ant's core classes ant tasks can be configured via system properties.
+Some of Ant's core classes can be configured via system properties.
Here is the result of a search through the codebase. Because system properties are available via Project instance, I searched for them with a
@@ -442,26 +442,26 @@ org.apache.tools.ant.Executor implementation specified here. If new properties get added (it happens), expect them to appear under the "ant." and "org.apache.tools.ant" prefixes, unless the developers have a very good reason to use another prefix. Accordingly, please avoid using -properties that begin with these prefixes, to reduce the risk that future -Ant releases break your build file. +properties that begin with these prefixes. This protects you from future +Ant releases breaking your build file.Cygwin Users
The Unix launch script that come with Ant works correctly with Cygwin. You -should not have any problems launching Ant form the Cygwin shell. It is important -to note however, that once Ant is runing it is part of the JDK which operates as -a native Windows application. The JDK is not a Cygwin executable, and it therefore -has no knowledge of the Cygwin paths, etc. In particular when using the
<exec>-task, executable names such as "/bin/sh" will not work, even though these -work from the Cygwin shell from which Ant was launched. You can use an executable -name such as "sh" and rely on that command being available in the Windows -path. +should not have any problems launching Ant from the Cygwin shell. It is +important to note, however, that once Ant is running it is part of the JDK +which operates as a native Windows application. The JDK is not a Cygwin +executable, and it therefore has no knowledge of Cygwin paths, etc. In +particular when using the<exec>task, executable names such +as "/bin/sh" will not work, even though these work from the Cygwin +shell from which Ant was launched. You can use an executable name such as +"sh" and rely on that command being available in the Windows path.OS/2 Users
-The OS/2 launch script was developed so as it can perform complex tasks. It has two parts: -
ant.cmdwhich calls Ant andantenv.cmdwhich sets environment for Ant. +The OS/2 launch script was developed to perform complex tasks. It has two parts: +
@@ -470,13 +470,13 @@ requirements are:ant.cmdwhich calls Ant andantenv.cmdwhich sets the environment for Ant. Most often you will just callant.cmdusing the same command line options as described above. The behaviour can be modified by a number of ways explained below.
- Environment variable
JAVA_HOMEis set.- Environment variable
-ANT_HOMEis set.- environment variable
CLASSPATHis set and contains at least one element from +- Environment variable
CLASSPATHis set and contains at least one element fromJAVA_HOMEand at least one element fromANT_HOME.If any of these conditions is violated, script
-antenv.cmdis called. This script first invokes configuration scripts if there exist: the system-wide configuration -antconf.cmdfrom the%ETC%directory and then the user comfiguration +antconf.cmdfrom the%ETC%directory and then the user configurationantrc.cmdfrom the%HOME%directory. At this moment bothJAVA_HOMEandANT_HOMEmust be defined becauseantenv.cmdnow addsclasses.ziportools.jar(depending on version of JVM) and @@ -484,15 +484,15 @@ everything from%ANT_HOME%\libexceptant-*.jartoCLASSPATH. Finallyant.cmdcalls per-directory configurationantrc.cmd. All settings made byant.cmdare local and are undone when the script ends. The settings made byantenv.cmdare persistent during the lifetime of the -shell (of course unless called automaticaly fromant.cmd). It is thus possible to call +shell (of course unless called automatically fromant.cmd). It is thus possible to callantenv.cmdmanually and modify some settings before callingant.cmd.Scripts
envset.cmdandrunrc.cmdperform auxilliary tasks. All scripts +Scripts
envset.cmdandrunrc.cmdperform auxiliary tasks. All scripts have some documentation inside.Running Ant via Java
If you have installed Ant in the do-it-yourself way, Ant can be started -with two entry points:
+from one of two entry points:java -Dant.home=c:\ant org.apache.tools.ant.Main [options] [target]