Browse Source

Document two launch options.

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@464498 13f79535-47bb-0310-9956-ffa450edef68
master
Jan Materne 18 years ago
parent
commit
31e8fc7aa7
1 changed files with 19 additions and 8 deletions
  1. +19
    -8
      docs/manual/running.html

+ 19
- 8
docs/manual/running.html View File

@@ -127,12 +127,23 @@ Options:
1 (lowest) to 10 (highest); 5 is the default 1 (lowest) to 10 (highest); 5 is the default
-nouserlib Run ant without using the jar files from ${user.home}/.ant/lib -nouserlib Run ant without using the jar files from ${user.home}/.ant/lib
-noclasspath Run ant without using CLASSPATH -noclasspath Run ant without using CLASSPATH
-noproxy Java 1.5 only: do not use the OS proxies
-main <class> override Ant's normal entry point
</pre> </pre>
<p>For more information about <code>-logger</code> and <p>For more information about <code>-logger</code> and
<code>-listener</code> see <code>-listener</code> see
<a href="listeners.html">Loggers &amp; Listeners</a>. <a href="listeners.html">Loggers &amp; Listeners</a>.
<p>For more information about <code>-inputhandler</code> see <p>For more information about <code>-inputhandler</code> see
<a href="inputhandler.html">InputHandler</a>. <a href="inputhandler.html">InputHandler</a>.
<p>Easiest way of changing the exit-behaviour is subclassing the original main class:
<pre>
public class CustomExitCode extends org.apache.tools.ant.Main {
protected void exit(int exitCode) {
// implement your own behaviour, e.g. NOT exiting the JVM
}
}
</pre> and starting Ant with access (<tt>-lib path-to-class</tt>) to this class.
</p>


<h3><a name="libs">Library Directories</a></h3> <h3><a name="libs">Library Directories</a></h3>
<p> <p>
@@ -161,7 +172,7 @@ added to the classpath is as follows:


<p> <p>
Note that the CLASSPATH environment variable is passed to Ant using a -lib Note that the CLASSPATH environment variable is passed to Ant using a -lib
option. Ant itself is started with a very minimalistic classpath.
option. Ant itself is started with a very minimalistic classpath.
Ant should work perfectly well with an empty CLASSPATH environment variable, Ant should work perfectly well with an empty CLASSPATH environment variable,
something the the -noclasspath option actually enforces. We get many more support calls related to classpath problems (especially quoting problems) than something the the -noclasspath option actually enforces. We get many more support calls related to classpath problems (especially quoting problems) than
we like. we like.
@@ -244,7 +255,7 @@ available via Project instance, I searched for them with a
grep -r -n "getPropert" * &gt; ..\grep.txt grep -r -n "getPropert" * &gt; ..\grep.txt
</pre> </pre>
command. After that I filtered out the often-used but not-so-important values (most of them command. After that I filtered out the often-used but not-so-important values (most of them
read-only values): <i>path.separator, ant.home, basedir, user.dir, os.name,
read-only values): <i>path.separator, ant.home, basedir, user.dir, os.name,
line.separator, java.home, java.version, java.version, user.home, java.class.path</i><br> line.separator, java.home, java.version, java.version, user.home, java.class.path</i><br>
And I filtered out the <i>getPropertyHelper</i> access.</p> And I filtered out the <i>getPropertyHelper</i> access.</p>
<table border="1"> <table border="1">
@@ -284,9 +295,9 @@ org.apache.tools.ant.Executor implementation specified here.
<td><code>ant.file.*</code></td> <td><code>ant.file.*</code></td>
<td>read only: full filename of the build file of Ant projects <td>read only: full filename of the build file of Ant projects
</td> </td>
<td>This is set to the name of a file by project;
<td>This is set to the name of a file by project;
this lets you determine the location of <a href="CoreTasks/import.html"> this lets you determine the location of <a href="CoreTasks/import.html">
&lt;import&gt;-ed</a> files,
&lt;import&gt;-ed</a> files,
</td> </td>
</tr> </tr>


@@ -455,8 +466,8 @@ org.apache.tools.ant.Executor implementation specified here.


<p> <p>
If new properties get added (it happens), expect them to appear under the 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
"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. This protects you from future properties that begin with these prefixes. This protects you from future
Ant releases breaking your build file. Ant releases breaking your build file.
</p> </p>
@@ -538,7 +549,7 @@ include:
</ul> </ul>


<p> <p>
The latter method supports the -lib, -nouserlib, -noclasspath options and will
The latter method supports the -lib, -nouserlib, -noclasspath options and will
load jars from the specified ANT_HOME. You should start the latter with the most minimal load jars from the specified ANT_HOME. You should start the latter with the most minimal
classpath possible, generally just the ant-launcher.jar. classpath possible, generally just the ant-launcher.jar.
</p> </p>
@@ -572,4 +583,4 @@ Here is an example:




</body> </body>
</html>
</html>

Loading…
Cancel
Save