db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bpendle...@apache.org
Subject svn commit: r937122 - /db/derby/docs/trunk/src/getstart/rgsderbyrunjarsyntax.dita
Date Fri, 23 Apr 2010 01:06:55 GMT
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>



Mime
View raw message