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 13:45:47 +0000 (UTC)
From: "Kim Haase (JIRA)" <jira@apache.org>
To: derby-dev@db.apache.org
Message-ID: 
 <294567389.3000.1305121547367.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=13031697#comment-13031697 ] 

Kim Haase commented on DERBY-484:
---------------------------------

Thanks for these very helpful comments, Knut. They actually lead in several directions.

1) The bullet-list split needs to be made in the Dev Guide topic too. I'll do that.

2) A pointer to the exact topic(s) on SQLJ.INSTALL_JAR are a good idea. This procedure is shown briefly in the Dev Guide (http://db.apache.org/derby/docs/dev/devguide/rdevdeploy856845.html) and described a bit more fully in the Tools Guide, in a badly formatted topic (http://db.apache.org/derby/docs/dev/tools/ttoolsjarload1002986.html).

I wonder where the documentation of these procedures actually belongs. (SQLJ.REMOVE_JAR and SQLJ.REPLACE_JAR are the others.) What kind of procedures are they? The only system procedures and functions we document in the Reference Manual are the SYSCS_UTIL ones. Should the basic reference info on the SQLJ ones be moved to the Reference Manual?

3) I just realized that I ignored one of the original problems reported in the issue, that the statement "The first time you set the property, you must reboot to load the classes" is not true. If this is in fact the case, the property is truly dynamic, and I should change 
http://db.apache.org/derby/docs/devguide/cdevdeploy21645.html ("Enable database class loading with a property" too.


> 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