ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mben...@apache.org
Subject cvs commit: ant/docs/manual running.html
Date Mon, 09 May 2005 15:15:44 GMT
mbenson     2005/05/09 08:15:44

  Modified:    docs/manual Tag: ANT_16_BRANCH running.html
  Log:
  Bring manpage up to date with current code.
  
  Revision  Changes    Path
  No                   revision
  No                   revision
  1.21.2.9  +55 -13    ant/docs/manual/running.html
  
  Index: running.html
  ===================================================================
  RCS file: /home/cvs/ant/docs/manual/running.html,v
  retrieving revision 1.21.2.8
  retrieving revision 1.21.2.9
  diff -u -r1.21.2.8 -r1.21.2.9
  --- running.html	19 Nov 2004 09:10:00 -0000	1.21.2.8
  +++ running.html	9 May 2005 15:15:44 -0000	1.21.2.9
  @@ -105,6 +105,10 @@
     -inputhandler <class>  the class which will handle input requests
     -find <file>           (s)earch for buildfile towards the root of
       -s  <file>           the filesystem and use it
  +  -nice  number          A niceness value for the main thread:
  +                         1 (lowest) to 10 (highest); 5 is the default
  +  -nouserlib             Run ant without using the jar files from ${user.home}/.ant/lib
  +  -noclasspath           Run ant without using CLASSPATH
   </pre>
   <p>For more information about <code>-logger</code> and
   <code>-listener</code> see
  @@ -121,26 +125,29 @@
   ${user.home}/.ant/lib. This arrangement allows the Ant installation to be
   shared by many users while still allowing each user to deploy additional jars.
   Such additional jars could be support jars for Ant's optional tasks or jars
  -containing third-party tasks to be used in the build. It also allows the main Ant
  -installation to be locked down which will please system adminstrators.
  +containing third-party tasks to be used in the build. It also allows the main Ant installation
to be locked down which will please system adminstrators.
   </p>
   
   <p>
   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:-
   </p>
   
   <ul>
     <li>-lib jars in the order specified by the -lib elements on the command line</li>
  -  <li>jars from ${user.home}/.ant/lib</li>
  +  <li>jars from ${user.home}/.ant/lib (unless -nouserlib is set)</li>
     <li>jars from ANT_HOME/lib</li>
   </ul>
   
   <p>
   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,
  +something the the -noclasspath option actually enforces. We get many more support calls
related to classpath problems (especially quoting problems), than
  +we like.
  +
   </p>
   
   <p>
  @@ -212,14 +219,14 @@
   </ul>
   
   <h3><a name="sysprops">Java System Properties</a></h3>
  -<p>Some of Ants core classes ant tasks can be configured via system properties.</p>
  -<p>So here the result of a search through the codebase. Because system properties
are
  +<p>Some of Ant's core classes ant tasks can be configured via system properties.</p>
  +<p>Here is the result of a search through the codebase. Because system properties
are
   available via Project instance, I searched for them with a
   <pre>
       grep -r -n "getPropert" * &gt; ..\grep.txt
   </pre>
   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, ant.file,
  +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>
   And I filtered out the <i>getPropertyHelper</i> access.</p>
   <table border="1">
  @@ -229,6 +236,33 @@
     <th>description</th>
   </tr>
   <tr>
  +  <td><code>ant.executor.class</code></td>
  +  <td>classname; default is org. apache. tools. ant. helper. DefaultExecutor</td>
  +  <td><b>Since Ant 1.6.3</b> Ant will delegate Target invocation to the
  +org.apache.tools.ant.Executor implementation specified here.
  +  </td>
  +</tr>
  +
  +<tr>
  +  <td><code>ant.file</code></td>
  +  <td>read only: full filename of the build file</td>
  +  <td>This is set to the name of the build file. In
  +  <a href="CoreTasks/import.html">
  +  &lt;import&gt;-ed</a> files, this is set to the containing build file.
  +  </td>
  +</tr>
  +
  +<tr>
  +  <td><code>ant.file.*</code></td>
  +  <td>read only: full filename of the build file of Ant projects
  +  </td>
  +  <td>This is set to the name of a file by project;  
  +  this lets you determine the location of <a href="CoreTasks/import.html">
  +  &lt;import&gt;-ed</a> files,  
  +  </td>
  +</tr>
  +
  +<tr>
     <td><code>ant.input.properties</code></td>
     <td>filename (required)</td>
     <td>Name of the file holding the values for the
  @@ -261,7 +295,7 @@
     <td><code>ant.regexp.regexpimpl</code></td>
     <td>classname</td>
     <td>classname for a RegExp implementation; if not set Ant tries to
  -      find another (Jdk14, Oro...);
  +      find another (JDK14+, Apache Oro...);
         <a href="CoreTypes/mapper.html#regexp-mapper">RegExp-Mapper</a>
         "Choice of regular expression implementation"
     </td>
  @@ -365,7 +399,7 @@
   <tr>
     <td><code>org.apache.tools.ant.ProjectHelper</code></td>
     <!-- add the blank after the slash, so the browser can do a line break -->
  -  <td>classname (optional, default 'org. apache. tools. ant. ProjectHelper')</td>
  +  <td>classname (optional, default 'org.apache.tools.ant.ProjectHelper')</td>
     <td>specifies the classname to use as ProjectHelper. The class must extend
         org.apache.tools.ant.ProjectHelper.
     </td>
  @@ -392,6 +426,14 @@
   </tr>
   </table>
   
  +<p>
  +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.
  +</p>
  +
   <h2><a name="cygwin">Cygwin Users</a></h2>
   <p>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
  @@ -405,7 +447,7 @@
   </p>
   
   <h2><a name="os2">OS/2 Users</a></h2>
  -<p>The OS/2 lanuch script was developed so as it can perform complex task. It has
two parts:
  +<p>The OS/2 launch script was developed so as it can perform complex tasks. It has
two parts:
   <code>ant.cmd</code> which calls Ant and <code>antenv.cmd</code>
which sets environment for Ant.
   Most often you will just call <code>ant.cmd</code> using the same command line
options as described
   above. The behaviour can be modified by a number of ways explained below.</p>
  @@ -468,8 +510,8 @@
   
   <br>
   <hr>
  -<p align="center">Copyright &copy; 2000-2004 The Apache Software Foundation.
All rights
  +<p align="center">Copyright &copy; 2000-2005 The Apache Software Foundation.
All rights
   Reserved.</p>
   
   </body>
  -</html>
  \ No newline at end of file
  +</html>
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org


Mime
View raw message