db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Kim Haase (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (DERBY-484) Documentation for derby.database.classpath in developers guide is misleading
Date Wed, 11 May 2011 13:45:47 GMT

    [ 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

Mime
View raw message