[
https://issues.apache.org/jira/browse/DERBY-4482?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Bryan Pendleton updated DERBY-4482:
-----------------------------------
Assignee: Bryan Pendleton
Hi Stan,
I think that
http://db.apache.org/derby/docs/10.5/tools/rtoolsijpropref97949.html
is the page which has the example that you're referring to, but it looks like
Laura
fixed this as part of DERBY-2188 -- am I overlooking a place in this page, or
looking at the wrong page?
I think there are 2 or 3 additional things that would be useful to do to improve
the documentation regarding derby.ui.locale:
1) I think we should add a sentence to the third bullet item in
http://db.apache.org/derby/docs/10.5/tools/ctools1004764.html
specifying that derby.ui.locale can be used to control the ij or dblook session
locale.
2) I think we should add a page to the "ij properties" section of the Tools
guide
http://db.apache.org/derby/docs/10.5/tools/rtoolsijpropref29864.html
to document the derby.ui.locale property, similar to the page that we have in
that section for the derby.ui.codeset property.
3) Possibly, we should have some information about derby.ui.locale and
derby.ui.codeset
in the Reference guide, in the section "Derby properties"
http://db.apache.org/derby/docs/10.5/ref/crefproper22250.html
I'm a little confused about this one, because it seems like maybe this section
is
*only* supposed to describe system and database properties, not tools
properties?
Perhaps the thing to do here is to add a brief note to this section, indicating
that
there are some Derby properties that only affect the behavior of the Derby
tools, and
that those properties are documented in the Tools guide?
If you can give me your thoughts about what sort of documentation improvements
would be most useful here, that would be great!
> Property to set IJ session locale not documented (assume this is
> derby.ui.locale)
> ---------------------------------------------------------------------------------
>
> Key: DERBY-4482
> URL: https://issues.apache.org/jira/browse/DERBY-4482
> Project: Derby
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 10.0.2.0, 10.0.2.1, 10.1.1.0, 10.1.2.1, 10.1.3.1,
> 10.2.1.6, 10.2.2.0, 10.3.1.4, 10.3.2.1, 10.3.3.0, 10.4.1.3, 10.4.2.0,
> 10.5.1.1, 10.5.2.0, 10.5.3.0
> Reporter: Stan Bradbury
> Assignee: Bryan Pendleton
>
> The property derby.ui.locale is used in an example in the Tools guide but not
> documented anywhere. Serveral places mention the Session locale but nothing
> is said about how to specify the Session locale. Presumably derby.ui.locale
> is the missing link?
> See DERBY-2188 for a discussion that identifies a couple of issues including
> that the property needs to be documented.
> Knut wrote (comment - 20/Oct/07 04:23 PM ):
> > Knut mentions the Tools and Utilities guide example under
> > 'derby.ui.codeset' which uses a property called
> > 'derby.ui.territory'.
> I believe this is a typo in the example. It should have said
> 'derby.ui.locale'. To my knowledge, there is no property called
> 'derby.ui.territory'.
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
