You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-dev@db.apache.org by "John H. Embretsen (JIRA)" <de...@db.apache.org> on 2006/09/06 11:13:22 UTC
[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%
[ 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