ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From j..@apache.org
Subject cvs commit: ant/docs/manual running.html
Date Wed, 03 Dec 2003 11:25:04 GMT
jhm         2003/12/03 03:25:04

  Modified:    docs/manual running.html
  Log:
  Add more system properties
  
  Revision  Changes    Path
  1.25      +180 -7    ant/docs/manual/running.html
  
  Index: running.html
  ===================================================================
  RCS file: /home/cvs/ant/docs/manual/running.html,v
  retrieving revision 1.24
  retrieving revision 1.25
  diff -u -r1.24 -r1.25
  --- running.html	28 Nov 2003 11:56:29 -0000	1.24
  +++ running.html	3 Dec 2003 11:25:04 -0000	1.25
  @@ -213,12 +213,185 @@
   </ul>
   
   <h3><a name="sysprops">Java System Properties</a></h3>
  -<p>Some of Ants core classes can be configured via system properties:</p>
  -<ul>
  -  <li><code>org.apache.tools.ant.ProjectHelper</code> - specifies the
  -  classname to use as ProjectHelper. The class must extend org.apache.tools.ant.ProjectHelper.
  -  If not set org.apache.tools.ant.ProjectHelper is used as ProjectHelper.</li>
  -</ul>
  +<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
  +available via Project instance, I searched for them with a
  +<pre>
  +    grep -r -n "getPropert" * > ..\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,
  +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">
  +<tr>
  +  <th>property name</th>
  +  <th>valid values /default value</th>
  +  <th>description</th>
  +</tr>
  +<tr>
  +  <td><code>ant.input.properties</code></td>
  +  <td>filename (required)</td>
  +  <td>Name of the file holding the values for the
  +      <a href="inputhandler.html">PropertyFileInputHandler</a>.
  +  </td>
  +</tr>
  +<tr>
  +  <td><code>ant.logger.defaults</code></td>
  +  <!-- add the blank after the slash, so the browser can do a line break -->
  +  <td>filename (optional, default '/org/ apache/ tools/ ant/ listener/ defaults.properties')</td>
  +  <td>Name of the file holding the color mappings for the
  +      <a href="listeners.html#AnsiColorLogger">AnsiColorLogger</a>.
  +  </td>
  +</tr>
  +<tr>
  +  <td><code>ant.netrexxc.*</code></td>
  +  <td>several formats</td>
  +  <td>Use specified values as defaults for <a href="OptionalTasks/netrexxc.html">netrexxc</a>.
  +  </td>
  +</tr>
  +<tr>
  +  <td><code>ant.PropertyHelper</code></td>
  +  <td>ant-reference-name (optional)</td>
  +  <td>Specify the PropertyHelper to use. The object must be of the type
  +      org.apache.tools.ant.PropertyHelper. If not defined an object of
  +      org.apache.tools.ant.PropertyHelper will be used as PropertyHelper.
  +  </td>
  +</tr>
  +<tr>
  +  <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...);
  +      <a href="CoreTypes/mapper.html#regexp-mapper">RegExp-Mapper</a>
  +      "Choice of regular expression implementation"
  +  </td>
  +</tr>
  +<tr>
  +  <td><code>ant.reuse.loader</code></td>
  +  <td>boolean</td>
  +  <td>allow to reuse classloaders
  +      used in org.apache.tools.ant.util.ClasspathUtil
  +  </td>
  +</tr>
  +<tr>
  +  <td><code>ant.XmlLogger.stylesheet.uri</code></td>
  +  <td>filename (default 'log.xsl')</td>
  +  <td>Name for the stylesheet to include in the logfile by
  +      <a href="listeners.html#XmlLogger">XmlLogger</a>.
  +  </td>
  +</tr>
  +<tr>
  +  <td><code>build.compiler</code></td>
  +  <td>name</td>
  +  <td>Specify the default compiler to use.
  +      see <a href="CoreTasks/javac.html">javac</a>,
  +      <a href="OptionalTasks/ejb.html#ejbjar_weblogic">EJB Tasks</a>
  +      (compiler attribute),
  +      <a href="OptionalTasks/icontract.html">IContract</a>,
  +      <a href="OptionalTasks/javah.html">javah</a>
  +  </td>
  +</tr>
  +<tr>
  +  <td><code>build.compiler.emacs</code></td>
  +  <td>boolean (default false)</td>
  +  <td>Enable emacs-compatible error messages.
  +      see <a href="CoreTasks/javac.html">javac</a> "Jikes Notes"
  +  </td>
  +</tr>
  +<tr>
  +  <td><code>build.compiler.fulldepend</code></td>
  +  <td>boolean (default false)</td>
  +  <td>Enable full dependency checking
  +      see <a href="CoreTasks/javac.html">javac</a> "Jikes Notes"
  +  </td>
  +</tr>
  +<tr>
  +  <td><code>build.compiler.jvc.extensions</code></td>
  +  <td>boolean (default true)</td>
  +  <td>enable Microsoft extensions of their java compiler
  +      see <a href="CoreTasks/javac.html">javac</a> "Jvc Notes"
  +  </td>
  +</tr>
  +<tr>
  +  <td><code>build.compiler.pedantic</code></td>
  +  <td>boolean (default false)</td>
  +  <td>Enable pedantic warnings.
  +      see <a href="CoreTasks/javac.html">javac</a> "Jikes Notes"
  +  </td>
  +</tr>
  +<tr>
  +  <td><code>build.compiler.warnings</code></td>
  +  <td>Deprecated flag</td>
  +  <td> see <a href="CoreTasks/javac.html">javac</a> "Jikes Notes" </td>
  +</tr>
  +<tr>
  +  <td><code>build.rmic</code></td>
  +  <td>name</td>
  +  <td>control the <a href="CoreTasks/rmic.html">rmic</a> compiler </td>
  +</tr>
  +<tr>
  +  <td><code>build.sysclasspath</code></td>
  +  <td>"only", something else</td>
  +  <td>only: current threads get the actual class loader
  +      (AntClassLoader.setThreadContextLoader()).
  +      else: use core loader as default (ComponentHelper.initTasks()). Disable
  +      changing the classloader (oata.taskdefs.Classloader.execute() experimental
  +      task).
  +      <!-- somewhere documented in the manual?? -->
  +  </td>
  +</tr>
  +<tr>
  +  <td><code>file.encoding</code></td>
  +  <td>name of a supported character set (e.g. UTF-8, ISO-8859-1, US-ASCII)</td>
  +  <td>use as default character set of email messages; use as default for source-,
dest- and bundleencoding
  +      in <a href="OptionalTasks/translate.html">translate</a> <br>
  +      see JavaDoc of <a target="_blank" href="http://java.sun.com/j2se/1.4.2/docs/api/java/nio/charset/Charset.html">java.nio.charset.Charset</a>
  +      for more information about character sets (not used in Ant, but has nice docs).
  +  </td>
  +</tr>
  +<tr>
  +  <td><code>jikes.class.path</code></td>
  +  <td>path</td>
  +  <td>The specified path is added to the classpath if jikes is used as compiler.</td>
  +</tr>
  +<tr>
  +  <td><code>MailLogger.properties.file, MailLogger.*</code></td>
  +  <td>filename (optional, defaults derived from Project instance)</td>
  +  <td>Name of the file holding properties for sending emails by the
  +      <a href="listeners.html#MailLogger">MailLogger</a>. Override properties
set
  +      inside the buildfile or via command line.
  +  </td>
  +</tr>
  +<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>specifies the classname to use as ProjectHelper. The class must extend
  +      org.apache.tools.ant.ProjectHelper.
  +  </td>
  +</tr>
  +<tr>
  +  <td><code>p4.port, p4.client, p4.user</code></td>
  +  <td>several formats</td>
  +  <td>Specify defaults for port-, client- and user-setting of the
  +      <a href="OptionalTasks/perforce.html">perforce</a> tasks.
  +  </td>
  +</tr>
  +<tr>
  +  <td><code>websphere.home
  +  <td>path</td>
  +  <td>Points to home directory of websphere.
  +      see <a href="OptionalTasks/ejb.html#ejbjar_websphere">EJB Tasks</a>
  +  </td>
  +</tr>
  +<tr>
  +  <td><code>XmlLogger.file
  +  <td>filename (default 'log.xml')</td>
  +  <td>Name for the logfile for <a href="listeners.html#MailLogger">MailLogger</a>.
  +  </td>
  +</tr>
  +</table>
   
   <h2><a name="cygwin">Cygwin Users</a></h2>
   <p>The Unix launch script that come with Ant works correctly with Cygwin. You
  @@ -300,4 +473,4 @@
   Reserved.</p>
   
   </body>
  -</html>
  +</html>
  \ No newline at end of file
  
  
  

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


Mime
View raw message