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
Versions: 10.2.0.0, 10.1.2.0
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:
http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
http://www.atlassian.com/software/jira
