From 2a426f599fb6e67d13f24abff7457fd9f9b87fd9 Mon Sep 17 00:00:00 2001 From: Jan Materne Date: Wed, 3 Dec 2003 11:25:04 +0000 Subject: [PATCH] Add more system properties git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@275729 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/running.html | 187 +++++++++++++++++++++++++++++++++++++-- 1 file changed, 180 insertions(+), 7 deletions(-) diff --git a/docs/manual/running.html b/docs/manual/running.html index 96796f1bf..21bdd407a 100644 --- a/docs/manual/running.html +++ b/docs/manual/running.html @@ -213,12 +213,185 @@ set):

Java System Properties

-

Some of Ants core classes can be configured via system properties:

- +

Some of Ants core classes ant tasks can be configured via system properties.

+

So here the result of a search through the codebase. Because system properties are +available via Project instance, I searched for them with a +

+    grep -r -n "getPropert" * > ..\grep.txt
+
+command. After that I filtered out the often-used but not-so-important values (most of them +read-only values): path.separator, ant.home, basedir, user.dir, os.name, ant.file, +line.separator, java.home, java.version, java.version, user.home, java.class.path
+And I filtered out the getPropertyHelper access.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
property namevalid values /default valuedescription
ant.input.propertiesfilename (required)Name of the file holding the values for the + PropertyFileInputHandler. +
ant.logger.defaultsfilename (optional, default '/org/ apache/ tools/ ant/ listener/ defaults.properties')Name of the file holding the color mappings for the + AnsiColorLogger. +
ant.netrexxc.*several formatsUse specified values as defaults for netrexxc. +
ant.PropertyHelperant-reference-name (optional)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. +
ant.regexp.regexpimplclassnameclassname for a RegExp implementation; if not set Ant tries to + find another (Jdk14, Oro...); + RegExp-Mapper + "Choice of regular expression implementation" +
ant.reuse.loaderbooleanallow to reuse classloaders + used in org.apache.tools.ant.util.ClasspathUtil +
ant.XmlLogger.stylesheet.urifilename (default 'log.xsl')Name for the stylesheet to include in the logfile by + XmlLogger. +
build.compilernameSpecify the default compiler to use. + see javac, + EJB Tasks + (compiler attribute), + IContract, + javah +
build.compiler.emacsboolean (default false)Enable emacs-compatible error messages. + see javac "Jikes Notes" +
build.compiler.fulldependboolean (default false)Enable full dependency checking + see javac "Jikes Notes" +
build.compiler.jvc.extensionsboolean (default true)enable Microsoft extensions of their java compiler + see javac "Jvc Notes" +
build.compiler.pedanticboolean (default false)Enable pedantic warnings. + see javac "Jikes Notes" +
build.compiler.warningsDeprecated flag see javac "Jikes Notes"
build.rmicnamecontrol the rmic compiler
build.sysclasspath"only", something elseonly: 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). + +
file.encodingname of a supported character set (e.g. UTF-8, ISO-8859-1, US-ASCII)use as default character set of email messages; use as default for source-, dest- and bundleencoding + in translate
+ see JavaDoc of java.nio.charset.Charset + for more information about character sets (not used in Ant, but has nice docs). +
jikes.class.pathpathThe specified path is added to the classpath if jikes is used as compiler.
MailLogger.properties.file, MailLogger.*filename (optional, defaults derived from Project instance)Name of the file holding properties for sending emails by the + MailLogger. Override properties set + inside the buildfile or via command line. +
org.apache.tools.ant.ProjectHelperclassname (optional, default 'org. apache. tools. ant. ProjectHelper')specifies the classname to use as ProjectHelper. The class must extend + org.apache.tools.ant.ProjectHelper. +
p4.port, p4.client, p4.userseveral formatsSpecify defaults for port-, client- and user-setting of the + perforce tasks. +
websphere.home + pathPoints to home directory of websphere. + see EJB Tasks +
XmlLogger.file + filename (default 'log.xml')Name for the logfile for MailLogger. +

Cygwin Users

The Unix launch script that come with Ant works correctly with Cygwin. You @@ -300,4 +473,4 @@ classpath possible, generally just the ant-launcher.jar. Reserved.

- + \ No newline at end of file