db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "John H. Embretsen (JIRA)" <derby-...@db.apache.org>
Subject [jira] Commented: (DERBY-1815) In admin guide examples to start network server on windows with .bat scripts, $DERYBY_INSTALL Is used , I think it should be %DERBY_INSTALL%
Date Wed, 06 Sep 2006 09:13:22 GMT
    [ http://issues.apache.org/jira/browse/DERBY-1815?page=comments#action_12432793 ] 
            
John H. Embretsen commented on DERBY-1815:
------------------------------------------

I think the problem is that the admin guide is not clear enough about whether $DERBY_INSTALL
should be an environment variable or not, and that this may create the situation Suresh describes
with copy/paste. The text does *not* say that $DERBY_INSTALL is an environment variable, but
it says:

"(...) $DERBY_INSTALL is the directory where you installed Derby."

Thus, based on the admin guide alone, $DERBY_INSTALL should (in my opinion) not be interpreted
as an environment variable, meaning that all users (both Windows and Unix) must replace occurrences
of $DERBY_INSTALL with the path to the directory in which they installed Derby. Of course,
all users are free to create such an environment variable, and since $DERBY_INSTALL looks
exactly like a Unix environment variable, I understand that this may cause some confusion.

In other words, I think simply changing $DERBY_INSTALL to %DERBY_INSTALL% in the example provided
is not a good solution. If it is changed, some additional wording is needed to explain that
it must be an environment variable if copied/pasted directly.


> In admin guide examples to start network server on windows with .bat scripts,   $DERYBY_INSTALL
Is used ,  I think  it  should be %DERBY_INSTALL%
> -------------------------------------------------------------------------------------------------------------------------------------------------
>
>                 Key: DERBY-1815
>                 URL: http://issues.apache.org/jira/browse/DERBY-1815
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>         Environment: Windows ...
>            Reporter: Suresh Thalamati
>            Priority: Trivial
>
> In the Admin Guide . Starting the Network Server (
> http://db.apache.org/derby/docs/dev/adminguide/tadmincbdjhhfd.html ) .   I think following
is not right. 
> $DERBY_INSTALL\frameworks\NetworkServer\bin\startNetworkserver.bat 
> it should be :
> %DERBY_INSTALL%\frameworks\NetworkServer\bin\startNetworkserver.bat
> ---  Although it is clear from the descripton from what  $DERBY_INSATLL  means there.
 Some of the users will copy/paste commands and will not be very happy , if it does not work
off-hand. 
>  

-- 
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

        

Mime
View raw message