Issue Details (XML | Word | Printable)

Key: DERBY-620
Type: Bug Bug
Status: Closed Closed
Resolution: Fixed
Priority: Minor Minor
Assignee: John H. Embretsen
Reporter: John H. Embretsen
Votes: 0
Watchers: 0
Operations

If you were logged in you would be able to see more operations.
Derby

BUILDING.txt section 3.2(1): Instructions for finding user home directory are not reliable

Created: 13/Oct/05 06:50 AM   Updated: 22/Oct/05 05:00 AM
Return to search
Component/s: Documentation
Affects Version/s: 10.1.2.1, 10.2.1.6
Fix Version/s: 10.1.2.1, 10.2.1.6

Time Tracking:
Not Specified

File Attachments:
  Size
File Licensed for inclusion in ASF works DERBY-620.diff 2005-10-17 06:23 PM John H. Embretsen 2 kB
Environment: Windows/Unix/Linux, JDKs 1.3-1.5

Resolution Date: 22/Oct/05 04:16 AM


 Description  « Hide
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.


 All   Comments   Work Log   Change History   Subversion Commits      Sort Order: Ascending order - Click to sort in descending order
Repository Revision Date User Message
ASF #327242 Fri Oct 21 19:11:46 UTC 2005 fuzzylogic DERBY-620: Provide a clearer explanation for where to put your ant.properties
into BUILDING.txt

Committed for John Embretsen <John.Embretsen@sun.com>
Files Changed
MODIFY /db/derby/code/trunk/BUILDING.txt