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] Updated: (DERBY-3847) Tuning Guide lacks information on turning off Derby property settings
Date Wed, 03 Sep 2008 16:47:44 GMT

     [ https://issues.apache.org/jira/browse/DERBY-3847?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]

Kim Haase updated DERBY-3847:
-----------------------------

    Attachment: DERBY-3847.zip
                DERBY-3847.stat
                DERBY-3847-3.diff

Thanks, Dag.

Actually, the intricacies are explained in one place, more or less -- in the "Working with
Derby properties" section of the tuning guide. I think it may make sense to put the information
on what happens when you turn off a property in the "Persistence of properties" topic, as
well as in the "Derby properties" topic, which will be moving to the Reference Manual. There
can be a bit less detail in "Persistence of properties" because there is more context.

I still don't have a lot of confidence in ctunproper22250.dita, so please let me know if further
fixes are needed or if what's in the "Working with Derby properties" section will cover us.

I also found a typo at the end of "Derby properties" (a book title with an extra word).

I'm attaching DERBY-3847-3.diff, DERBY-3847.stat, and DERBY-3847.zip.

> Tuning Guide lacks information on turning off Derby property settings
> ---------------------------------------------------------------------
>
>                 Key: DERBY-3847
>                 URL: https://issues.apache.org/jira/browse/DERBY-3847
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 10.4.1.3
>            Reporter: Kim Haase
>            Assignee: Kim Haase
>            Priority: Minor
>         Attachments: ctunproper22250.html, ctunproper22250.html, DERBY-3847-2.diff, DERBY-3847-3.diff,
DERBY-3847.diff, DERBY-3847.stat, DERBY-3847.zip
>
>
> The documentation of how to turn off Derby properties is spotty. Dag Wanvik reports that
"I checked the code, and when you set a database property to a null value, that property is
removed from the list of database properties; i.e. the situation is back to where you were
before it was first set, so the built-in defaults apply again (or system properties if there
are any)."
> The behavior for turning off user settings is slightly different and is documented in
several places; it's the general case that seems to be missing. This information needs to
be added to the description of Derby properties in the Tuning Guide, probably in the general
topic "Derby properties" (http://db.apache.org/derby/docs/dev/tuning/ctunproper22250.html).

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


Mime
View raw message