db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Laura Stewart (JIRA)" <derby-...@db.apache.org>
Subject [jira] Updated: (DERBY-1223) Update Getting Started to include instructions on setting JAVA_HOME variable.
Date Thu, 07 Sep 2006 21:03:25 GMT
     [ http://issues.apache.org/jira/browse/DERBY-1223?page=all ]

Laura Stewart updated DERBY-1223:

    Attachment: derby1223_2.diff

The diff and html files added here are updated based on the comments posted so far, 
but these files are NOT ready to be committed. 

I need answers to the questions that I added in an earlier post and to the questions that
I have below.  


File = tgssetupjavaenvir

I am not sure that I have all of the steps documented correctly. Please review them carefully.

I used choice tables to more clearly distinguish between UNIX and Windows commands. Unfortnately,
spacing before and after the choice tables is nonexistant. Is this something that we can change
in the 
DITA toolkit?

File = cgsusingtoolsutils

The title refers to tools AND startup utilites.  Are there really 2 sets of things we are
here? If not we should change the title.

File = tgs26250 

The comments to update this file are not very clear. And I have had a difficult time with
this topic. It seems very disjointed to me. I think part of that stems from using several
terms for the same thing (tools, utilities, programs).  I realize that there are scripts that
are run to launch a program and that these scripts have the same name as the program (ij for
example). But we need to be consistent in the terms that we use - not only in this file, but
in all of the files. 

In the first patch there was a series of bullets that were options for the user to choose
from.  The first option was to include DERBY_HOME in the CLASSPATH by using the "SET CLASSPATH"
command.  The comments leave me with no place to put this info.  Do you really mean that the
command should not be included?  

One of the comments asked that the text about setting the JAVA_HOME environment variable in
the PATH be added to this file. I am not sure that it belongs here.  And it did not seem to
fit in with the steps for setting the classpath manually (I am assuming that CLASSPATH and
PATH are 2 separate environment variables). Looking at the structure of the Getting Started
Guide http://db.apache.org/derby/docs/dev/getstart/ 
we might want to create a new topic in the following section that describes setting the JAVA_HOME
environment variable... unless I have missed some connection here.  Please advise.

Manually setting environment variables and paths 
     Set the DERBY_INSTALL environment variable 
     Set the classpath  

> Update Getting Started to include instructions on setting JAVA_HOME variable.
> -----------------------------------------------------------------------------
>                 Key: DERBY-1223
>                 URL: http://issues.apache.org/jira/browse/DERBY-1223
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions:
>            Reporter: Andrew McIntyre
>         Assigned To: Laura Stewart
>            Priority: Minor
>             Fix For:
>         Attachments: derby1223.diff, derby1223_2.diff, Derby1223_html.zip, derby1223_html2.zip,
> As of the fix for DERBY-1082, the scripts were made consistent to require setting DERBY_HOME
(or DERBY_INSTALL) and JAVA_HOME. The documentation on setting up your environment in the
Getting Started guide should be updated to reflect that these variables should be set. 

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


View raw message