db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "John H. Embretsen (JIRA)" <derby-...@db.apache.org>
Subject [jira] Created: (DERBY-620) BUILDING.txt section 3.2(1): Instructions for finding user home directory are not reliable
Date Wed, 12 Oct 2005 21:51:07 GMT
BUILDING.txt section 3.2(1): Instructions for finding user home directory are not reliable

         Key: DERBY-620
         URL: http://issues.apache.org/jira/browse/DERBY-620
     Project: Derby
        Type: Bug
  Components: Documentation  
 Environment: Windows/Unix/Linux, JDKs 1.3-1.5
    Reporter: John H. Embretsen
    Priority: Minor

BUILDING.txt, section 3.2 states:


3.2   Create property file

You will need to create a property file to specify
your environment and some of your options. Do the following
to specify your environment and options:

(1) Find out user home directory on your system. You can find  
    user home directory by doing echo on variable %HOME% 
    on windows and $home or $HOME on unix.


In some cases, %HOME% (on WIndows) or $HOME  ($home) (on Unix) does not correspond to the
directory where ant looks for "ant.properties". 

I recently tried to build Derby on Windows XP, and accidentally put ant.properties in the
wrong directory, causing ant to say that java.lang could not be found. On Windows XP and 2000
(and most likely all older Windows platforms as well) "out-of-the-box", there is no environment
variable called %HOME%. Creating this environment variable manually does not make any difference.

On Unix systems, the $HOME environment variable does not necessarily always correspond to
ant's (i.e. Java's) interpretation of  "user.home". For example, if a user changes this variable
manually from "/home/username" to "/home/username/myHome", $HOME refers to the latter, but
ant will continue to look for ant.properties in the "/home/username" directory.

This message is automatically generated by JIRA.
If you think it was sent incorrectly contact one of the administrators:
For more information on JIRA, see:

View raw message