[ 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

        

Reply via email to