I did a search with
grep -n -H -r "System.getPropert" *
from src/main/
Some properties are basically and I ignore them for this analyse.
Ignoring:
- line.separator
- ant.home
- user.home
- java.*
- os.*
- file.separator
Most of the system properties I found are documented. Maybe some additional
can be done for
- AbstractCvsTask --> <cvs>: what is "~"
- Jikes --> <javac>: jikes.class.path
Do you know more properties which are not documented? I couldnīt find the
properties accessed
via Project instance (too many hits).
Jan
Hits:
main/org/apache/tools/ant/input/PropertyFileInputHandler.java:110:
String propsFile = System.getProperty(FILE_NAME_KEY);
- access key is "ant.input.properties" (final string, hardcoded)
- use that file for reading property file and providing them as input
- no default, causes a meaningful BuildException
==> described in /manual/inputhandler.html for PropertyFileInputHandler
main/org/apache/tools/ant/listener/AnsiColorLogger.java:186:
String userColorFile = System.getProperty("ant.logger.defaults");
- use that as filename for reading the color specifcations
- no default for that value, but default color mapping
==> described in manual/listeners.html#AnsiColorLogger
main/org/apache/tools/ant/Project.java:860:
Properties systemP = System.getProperties();
- copies all System properties to Ant properties
- who knows where they are used ...
==> described in manual/using.html#built-in-props
main/org/apache/tools/ant/ProjectHelper.java:205:
String helperClass = System.getProperty(HELPER_PROPERTY);
- access key is "org.apache.tools.ant.ProjectHelper" (final string,
hardcoded)
- specify the classname for the PH-implementation to use
==> described in manual/running.html#sysprops (since a few minutes :-)
main/org/apache/tools/ant/taskdefs/AbstractCvsTask.java:320:
System.getProperty("cygwin.user.home",
- try do get a default passfile, if none is specified
"cygwin.user.home" + "user.home" + /.cvspass
==> described in manual/CoreTasks/cvs.html
"passfile - Required: No, default file ~/.cvspass."
==> But description could be better; what is "~"? Not known by windows
users like me :-)
main/org/apache/tools/ant/taskdefs/compilers/Jikes.java:121:
String jikesPath = System.getProperty("jikes.class.path");
- Comment sais: if the user has set JIKESPATH we should add the contents as
well
==> NOT described in manual/CoreTasks/javac.html (Jikes Notes) while others
are...
BTW access to the other properties is done via project.getProperty() ...
main/org/apache/tools/ant/taskdefs/CVSPass.java:111:
System.getProperty("cygwin.user.home",
- like in AbstractCvsTask used for setting the default passfile
- described in <cvspass> manual
main/org/apache/tools/ant/taskdefs/email/MimeMailer.java:99:
= System.getProperty("file.encoding");
- use as default character set of the message
==> NOT described in <mail> manual, but not important I think
main/org/apache/tools/ant/taskdefs/optional/ejb/IPlanetEjbc.java:319:
Properties props = System.getProperties();
- only access "java.class.path"
==> nothing to do
main/org/apache/tools/ant/taskdefs/optional/ejb/IPlanetEjbc.java:328:
Properties props = System.getProperties();
- only access "user.dir"
==> nothing to do
main/org/apache/tools/ant/taskdefs/optional/i18n/Translate.java:362:
srcEncoding = System.getProperty("file.encoding");
main/org/apache/tools/ant/taskdefs/optional/i18n/Translate.java:429:
bundleEncoding = System.getProperty("file.encoding");
- use as default for source-, dest- and bundleencoding
==> described in <translate> manual
main/org/apache/tools/ant/taskdefs/optional/junit/JUnitTestRunner.java:549:
Hashtable p = System.getProperties();
- source code comment: Add/overlay system properties on the properties from
the Ant project
==> nothing found in <junit> manual
main/org/apache/tools/ant/taskdefs/optional/net/SetProxy.java:214,...:
Properties sysprops = System.getProperties();
- store the values of the task in the appropriate system properties
==> thats the job of <setproxy> :-)
main/org/apache/tools/ant/taskdefs/optional/NetRexxC.java:773,883:
Properties currentProperties = System.getProperties();
- only access to "java.class.path"
- source code comment: need to set java.class.path property and restore it
later since the
NetRexx compiler has no option for the classpath
==> nothing to do
main/org/apache/tools/ant/taskdefs/optional/splash/SplashTask.java:161:
System.getProperties().put("http.proxySet", "true");
main/org/apache/tools/ant/taskdefs/optional/splash/SplashTask.java:162:
System.getProperties().put("http.proxyHost", proxy);
main/org/apache/tools/ant/taskdefs/optional/splash/SplashTask.java:163:
System.getProperties().put("http.proxyPort", port);
main/org/apache/tools/ant/taskdefs/optional/splash/SplashTask.java:176:
System.getProperties().put("http.proxySet", "false");
main/org/apache/tools/ant/taskdefs/optional/splash/SplashTask.java:177:
System.getProperties().put("http.proxyHost", "");
main/org/apache/tools/ant/taskdefs/optional/splash/SplashTask.java:178:
System.getProperties().put("http.proxyPort", "");- access to proxy
settings as default values
==> described in <splash> manual (as deprecated attributes)
main/org/apache/tools/ant/types/CommandlineJava.java:168:
sys = System.getProperties();
- source code comment: cache the system properties and set the system
properties to the new values
==> nothing to do
main/org/apache/tools/ant/types/PropertySet.java:272:
e2 = System.getProperties().keys();
- use all properties if "buildin" is chosen
==> described in <propertyset> manual
main/org/apache/tools/ant/types/resolver/ApacheCatalogResolver.java:122:
System.getProperties().put("xml.catalog.className",
- source code comment: Make sure CatalogResolver instantiates ApacheCatalog,
rather than a plain Catalog
==> sets this sys-prop (and overwrites existing), therefore no need for doc
main/org/apache/tools/ant/util/regexp/RegexpFactory.java:86:
systemDefault = System.getProperty("ant.regexp.regexpimpl");
- classname for a RegExp implementation; if not set try some other (Jdk14,
Oro...);
classname can be set as Ant- or System property
==> described in <replaceregexp> manual "Choice of regular expression
implementation"
an in manual/CoreTypes/mapper.html#regexp-mapper
main/org/apache/tools/ant/util/regexp/RegexpMatcherFactory.java:92:
systemDefault = System.getProperty("ant.regexp.regexpimpl");
- same as in RegexpFactory
==> nothing to do
> -----Original Message-----
> From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]
> Sent: Friday, November 28, 2003 1:02 PM
> To: [EMAIL PROTECTED]
> Subject: RE: cvs commit: ant/docs/manual running.html runninglist.html
>
>
> Are there more?
> Please add :-)
>
>
> Jan
>
>
> > -----Original Message-----
> > From: Stefan Bodewig [mailto:[EMAIL PROTECTED]
> > Sent: Friday, November 28, 2003 1:01 PM
> > To: [EMAIL PROTECTED]
> > Subject: Re: cvs commit: ant/docs/manual running.html
> runninglist.html
> >
> >
> > On 28 Nov 2003, <[EMAIL PROTECTED]> wrote:
> >
> > > Document org.apache.tools.ant.ProjectHelper System property.
> >
> > Thanks!
> >
> > Stefan
> >
> >
> ---------------------------------------------------------------------
> > To unsubscribe, e-mail: [EMAIL PROTECTED]
> > For additional commands, e-mail: [EMAIL PROTECTED]
> >
>
