ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Jan.Mate...@rzf.fin-nrw.de
Subject RE: cvs commit: ant/docs/manual running.html runninglist.html
Date Fri, 28 Nov 2003 13:38:59 GMT
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: Jan.Materne@rzf.fin-nrw.de [mailto:Jan.Materne@rzf.fin-nrw.de]
> Sent: Friday, November 28, 2003 1:02 PM
> To: dev@ant.apache.org
> Subject: RE: cvs commit: ant/docs/manual running.html runninglist.html
> 
> 
> Are there more? 
> Please add :-)
> 
> 
> Jan
> 
> 
> > -----Original Message-----
> > From: Stefan Bodewig [mailto:bodewig@apache.org]
> > Sent: Friday, November 28, 2003 1:01 PM
> > To: dev@ant.apache.org
> > Subject: Re: cvs commit: ant/docs/manual running.html 
> runninglist.html
> > 
> > 
> > On 28 Nov 2003, <jhm@apache.org> wrote:
> > 
> > >   Document org.apache.tools.ant.ProjectHelper System property.
> > 
> > Thanks!
> > 
> > Stefan
> > 
> > 
> ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
> > For additional commands, e-mail: dev-help@ant.apache.org
> > 
> 

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message