Uploaded image for project: 'Derby'
  1. Derby
  2. DERBY-6916

Doc of derbyrun.jar should describe complete list of referenced jars

    Details

    • Type: Improvement
    • Status: Resolved
    • Priority: Minor
    • Resolution: Fixed
    • Affects Version/s: 10.14.1.0
    • Fix Version/s: 10.14.1.0
    • Component/s: Documentation
    • Labels:
      None

      Description

      As I read our build.xml file:

      <manifest file="$
      Unknown macro:

      Unknown macro: {derby.jar.dir}

      /lists/smfcmd.mf">
      <attribute name="Main-Class" value="org.apache.derby.iapi.tools.run"/>
      <attribute name="Class-Path" value="derby.jar derbyclient.jar derbytools.j
      ar derbynet.jar derbyoptionaltools.jar"/>
      </manifest>

      the derbyrun.jar filepulls both derbytools.jar and derbyoptionaltools.jar into my classpath.

      This means that both regular tools and optional tools can be run using only derbyrun.jar in the classpath.

      I think this indicates that this documentation is incorrect:

      https://builds.apache.org/job/Derby-docs/lastSuccessfulBuild/artifact/trunk/out/adminguide/tadminappschangingyourclasspath.html

      because it seemed to me to quite explicitly say that derbyrun.jar includes ONLY derby.jar, derbynet.jar, and derbyclient.jar.

      We should review that doc, and also any other doc that references derbyrun.jar, to make sure it is clear what it references and how to use it.

        Attachments

        1. adminguide.diff
          1 kB
          Bryan Pendleton
        2. docs.diff
          3 kB
          Bryan Pendleton
        3. rgsderbyrunjarsyntax.html
          8 kB
          Bryan Pendleton
        4. tadminappschangingyourclasspath.html
          10 kB
          Bryan Pendleton
        5. tadminappschangingyourclasspath.html
          9 kB
          Bryan Pendleton

          Activity

            People

            • Assignee:
              bryanpendleton Bryan Pendleton
              Reporter:
              bryanpendleton Bryan Pendleton
            • Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: