[ 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
