Mailing-List: contact derby-dev-help@db.apache.org; run by ezmlm
Precedence: bulk
Message-ID: <1949600952.1129541027051.JavaMail.jira@ajax.apache.org>
Date: Mon, 17 Oct 2005 11:23:47 +0200 (CEST)
From: "John H. Embretsen (JIRA)" <derby-dev@db.apache.org>
To: derby-dev@db.apache.org
Subject: [jira] Updated: (DERBY-620) BUILDING.txt section 3.2(1): Instructions
 for finding user home directory are not reliable
In-Reply-To: <942397329.1129153867722.JavaMail.jira@ajax.apache.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit

     [ http://issues.apache.org/jira/browse/DERBY-620?page=all ]

John H. Embretsen updated DERBY-620:
------------------------------------

    Attachment: DERBY-620.diff

I've attached a patch for this issue. The wording in the patch is roughly the same as presented in my previous comment. The patch is ready for review and (if accepted) commit.

> 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
>     Assignee: John H. Embretsen
>     Priority: Minor
>  Attachments: DERBY-620.diff
>
> 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