[jira] Updated: (DERBY-1223) Update Getting Started to include instructions on setting JAVA_HOME variable.

["Laura Stewart (JIRA)" <de...@db.apache.org>]

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

Laura Stewart updated DERBY-1223:
---------------------------------

    Attachment: derby1223_2.diff
                derby1223_html2.zip

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.  

Questions:

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, the 
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 describing 
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: 10.2.1.0
>            Reporter: Andrew McIntyre
>         Assigned To: Laura Stewart
>            Priority: Minor
>             Fix For: 10.2.1.0
>
>         Attachments: derby1223.diff, derby1223_2.diff, Derby1223_html.zip, derby1223_html2.zip, Derby1223_ProposedChanges.txt
>
>
> 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