[jira] Commented: (DERBY-4501) CLASSPATH scripts do not work as defined in Getting Started in Derby Guide

["Dag H. Wanvik (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/DERBY-4501?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12805075#action_12805075 ] 

Dag H. Wanvik commented on DERBY-4501:
--------------------------------------

Thanks for tackling this, Bryan! Looks like a clear improvement to me.
Instead of "dot", you might consider "dot" or "source"; bash allows both use of the dot-syntax and the source keyword.
As for the example, do you presume that the user has done a cd to the directory containing the scripts or added it to the PATH environement variable? Would it perhaps be even more helpful to write something like this:

UNIX Bourne shell:

> DERBY_HOME=/derby/db-derby-10.5.3.0-bin
> . $DERBY_HOME/bin/setEmbeddedCP

or with Bash:

> DERBY_HOME=/derby/db-derby-10.5.3.0-bin
> source $DERBY_HOME/bin/setEmbeddedCP 



> CLASSPATH scripts do not work as defined in Getting Started in Derby Guide
> --------------------------------------------------------------------------
>
>                 Key: DERBY-4501
>                 URL: https://issues.apache.org/jira/browse/DERBY-4501
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 10.5.3.0
>         Environment: Unix platforms
>            Reporter: John Storta Jr.
>            Assignee: Bryan Pendleton
>            Priority: Minor
>         Attachments: docs.diff, tgs26250.html
>
>
> On pages 13 and 14 of the 'Getting Started in Derby Guide', there are 3
> scripts referenced that can be used to set the CLASSPATH environment
> variable.  setEmbeddedCP, setNetworkServerCP, & setNetworkClientCP.  The
> documentation indicates that the appropriate script should be run
> depending on your needs.
> Running the scripts like any other script does not work.
> When a script is run, it launches a new shell for that script.  The
> CLASSPATH is set within that shell.  Once the script is complete, that
> shell exits and you are returned to your shell.  The CLASSPATH is only
> changed for the shell that the script was running in.  The CLASSPATH in
> your shell is unchanged.
> $ ${DERBY_HOME}/bin/setNetworkClientCP
> Will result in your CLASSPATH being unchanged.
> In order for CLASSPATH in your shell to be updated, you have to run the
> script from within your shell (not launch a new shell).  This is done by
> 'sourcing' the script.
> $ . ${DERBY_HOME}/bin/setNetworkClientCP
> Will run the script within your shell resulting in your CLASSPATH being
> updated.
> The documentation is not clear on this.
> Bug DERBY-4500 has been opened to address a related issue that will arise if/when the documentation is updated to reflect that the scripts should be sourced rather than run.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.