Author: bpendleton
Date: Fri Apr 23 01:06:55 2010
New Revision: 937122
URL: http://svn.apache.org/viewvc?rev=937122&view=rev
Log:
DERBY-4618: Clarify that -jar derbyrun.jar cannot be used with -cp
This patch enhances the documentation in the Getting Started guide
so that the description of how to use the '-jar derbyrun.jar' feature
clearly explains that this feature cannot be used in conjunction
with the '-cp' or CLASSPATH arguments. When the Java command uses
the '-jar' argument, it ignores any provided classpath information,
so a user who needs to specify a custom classpath for the Derby tools
cannot use the '-jar' argument to run derbyrun.jar as a jar file.
Path provided by C.S. Nirmal J. Fernando (nirmal070125 at gmail dot com)
Modified:
db/derby/docs/trunk/src/getstart/rgsderbyrunjarsyntax.dita
Modified: db/derby/docs/trunk/src/getstart/rgsderbyrunjarsyntax.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/getstart/rgsderbyrunjarsyntax.dita?rev=937122&r1=937121&r2=937122&view=diff
==============================================================================
--- db/derby/docs/trunk/src/getstart/rgsderbyrunjarsyntax.dita (original)
+++ db/derby/docs/trunk/src/getstart/rgsderbyrunjarsyntax.dita Fri Apr 23 01:06:55 2010
@@ -59,8 +59,27 @@ java -jar %DERBY_HOME%\lib\derbyrun.jar
</strow>
</simpletable><p>To see this syntax reminder, run the command <codeph>java
-jar derbyrun.jar</codeph> with no arguments.</p></section>
-<section><title>Additional information</title><p>The <codeph>server</codeph>
argument
-is a shortcut for running the <codeph>NetworkServerControl</codeph> tool.
+<section><title>Additional information</title>
+
+<p>You cannot use the <codeph>-cp</codeph> argument or the CLASSPATH
+environment variable to set CLASSPATH variables when you are using the
+<codeph>-jar</codeph> argument to start the <codeph>ij</codeph> tool.
+If you want to run the <codeph>ij</codeph> tool with a custom classpath,
+you cannot use the <codeph>-jar</codeph> argument. Instead, you have to
+use the full class name to start the <codeph>ij</codeph> tool
+(<codeph>java org.apache.derby.tools.ij</codeph>). </p>
+
+<p>See <xref href="tgs26250.dita#tgs26250"/> for more information
+about setting up the classpath and running the <codeph>ij</codeph> tool.</p>
+
+<p>There is no such limitation when you run the <codeph>sysinfo</codeph>
tool.
+See <xref href="tgsrunningsysinfo.dita#tgsrunningsysinfo"/>
+for more information on running the <codeph>sysinfo</codeph> tool. </p>
+
+<p>The <codeph>server</codeph>
+argument is a shortcut for running the
+<codeph>NetworkServerControl</codeph>
+tool.
For details on using this tool, see the <cite><ph conref="../conrefs.dita#pub/citadmin"></ph></cite>.
</p><p>For
more information on using <codeph>derbyrun.jar</codeph> to run the <codeph>ij</codeph>,
<codeph>sysinfo</codeph>,
and <codeph>dblook</codeph> tools, see the <cite><ph conref="../conrefs.dita#pub/citutilities"></ph></cite>.</p></section>
|