db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Bryan Pendleton (JIRA)" <j...@apache.org>
Subject [jira] Updated: (DERBY-4482) Property to set IJ session locale not documented (assume this is derby.ui.locale)
Date Sun, 20 Dec 2009 19:54:18 GMT

     [ 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.


Mime
View raw message