db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bpendle...@apache.org
Subject svn commit: r937630 - /db/derby/docs/trunk/src/tools/ttoolsij11815.dita
Date Sat, 24 Apr 2010 14:47:38 GMT
Author: bpendleton
Date: Sat Apr 24 14:47:38 2010
New Revision: 937630

URL: http://svn.apache.org/viewvc?rev=937630&view=rev
DERBY-4618: Clarify that -jar derbyrun.jar cannot be used with -cp

This patch enhances the documentation in the Tools 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.

Patch provided by C.S. Nirmal J. Fernando (nirmal070125 at gmail dot com)


Modified: db/derby/docs/trunk/src/tools/ttoolsij11815.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/tools/ttoolsij11815.dita?rev=937630&r1=937629&r2=937630&view=diff
--- db/derby/docs/trunk/src/tools/ttoolsij11815.dita (original)
+++ db/derby/docs/trunk/src/tools/ttoolsij11815.dita Sat Apr 24 14:47:38 2010
@@ -46,9 +46,17 @@ environment variable, then use one of th
     [-p <varname>propertyFile</varname>] [<varname>inputFile</varname>]</userinput></b></codeblock>
 <codeblock><b><userinput>java [<varname>options</varname>]
     [-p <varname>propertyFile</varname>] [<varname>inputFile</varname>]</userinput></b></codeblock>
-<p>If you use the last form of the command, be sure that derbyrun.jar is in your
-classpath (for pre-10.2 distributions derbytools.jar and usually derby.jar
+<p>If you use the last form of the command, be sure that <codeph>derbyrun.jar</codeph>
is in your
+classpath (for pre-10.2 distributions <codeph>derbytools.jar</codeph> and usually
 were required in the classpath).</p>
+<p>If you need to use other classes in addition to <codeph>derbyrun.jar</codeph>,

+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>The command line items are:</p>    <ul>
 <li id="rtoolsij42358"><b><userinput>java</userinput></b> 
 <p>Start the JVM. </p></li>
 <li id="rtoolsij26546"><b><userinput><varname>options</varname></userinput></b>
  <p>The options that the JVM uses. You can

View raw message