Mailing-List: contact derby-dev-help@db.apache.org; run by ezmlm
Precedence: bulk
Reply-To: <derby-dev@db.apache.org>
Date: Wed, 11 May 2011 08:55:47 +0000 (UTC)
From: "Knut Anders Hatlen (JIRA)" <jira@apache.org>
To: derby-dev@db.apache.org
Message-ID: 
 <1754267477.2499.1305104147448.JavaMail.tomcat@hel.zones.apache.org>
Subject: [jira] [Commented] (DERBY-484) Documentation for
 derby.database.classpath in developers guide is misleading
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit


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

Knut Anders Hatlen commented on DERBY-484:
------------------------------------------

The new topic looks good to me. Some possible improvements:

- It's a bit opaque where the jar files come from. Perhaps change "This property must be set to enable Derby to load classes from the jar files" to "This property must be set to enable Derby to load classes from jar files installed with the SQLJ.INSTALL_JAR system procedure"? Unfortunately, there's no topic describing INSTALL_JAR in the reference manual, so we cannot create a link to it.

- Should the last bullet in the bullet list be split into two separate bullets?

- "Use two-part names for the jar files" -> "Use fully qualified identifiers for the jar files"?

> Documentation for derby.database.classpath in developers guide is misleading
> ----------------------------------------------------------------------------
>
>                 Key: DERBY-484
>                 URL: https://issues.apache.org/jira/browse/DERBY-484
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 10.1.2.1
>            Reporter: Daniel John Debrunner
>            Assignee: Kim Haase
>            Priority: Minor
>         Attachments: DERBY-484.diff, DERBY-484.stat, DERBY-484.zip, cdevdeploy21645.html, derby484.diff
>
>
> 10.1 alpha docs (from site)
> http://db.apache.org/derby/docs/devguide/cdevdeploy21645.html
> 1) Remove sentence 'The first time you set the property, you must reboot to load the classes.' 
>      This is not true and is tested with lang/dcl.sql
> 2)  This implies there is more infomation in the tuning guide, but I don't see any.
> 'See "derby.database.classpath" in Tuning Derby for more information about the property.'
> Searching the tuning guide I find no mention of derby.database.classpath
> http://db.apache.org/derby/docs/tuning/tuningderby.pdf

--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira