[jira] Updated: (DERBY-4482) Property to set IJ session locale not documented (assume this is derby.ui.locale)
[ https://issues.apache.org/jira/browse/DERBY-4482?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ] Bryan Pendleton updated DERBY-4482: --- Attachment: rtoolsijlocale.html ctools1004764.html docs.diff Thanks Knut, those suggestions definitely improve the material. Attached is a revised patch diff, and revised HTML versions of the two pages. > 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 > Attachments: ctools1004764.html, ctools1004764.html, docs.diff, > docs.diff, rtoolsijlocale.html, rtoolsijlocale.html > > > 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.
[jira] Updated: (DERBY-4482) Property to set IJ session locale not documented (assume this is derby.ui.locale)
[ https://issues.apache.org/jira/browse/DERBY-4482?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ] Bryan Pendleton updated DERBY-4482: --- Attachment: rtoolsijlocale.html ctools1004764.html docs.diff Attached is a patch proposal which makes two changes to the Tools guide: 1) Adds a new page describing the derby.ij.locale property. The description on this page was mostly taken from the description of the "territory" attribute for the database connection URL, since I think it mostly applies to derby.ij.locale as well. 2) Adds a sentence to the "About Locales" page in the tools guide giving a cross-reference to the new page to help users find this page more easily. HTML versions of the two modifies pages are also attached. Please let me know what you think of this idea, and whether it would resolve the issues raised by this JIRA entry. > 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 > Attachments: ctools1004764.html, docs.diff, rtoolsijlocale.html > > > 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.
[jira] Updated: (DERBY-4482) Property to set IJ session locale not documented (assume this is derby.ui.locale)
[ 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.
[jira] Updated: (DERBY-4482) Property to set IJ session locale not documented (assume this is derby.ui.locale)
[ https://issues.apache.org/jira/browse/DERBY-4482?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ] Stan Bradbury updated DERBY-4482: - Description: 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'. was: 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 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'. > 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 > > 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.
[jira] Updated: (DERBY-4482) Property to set IJ session locale not documented (assume this is derby.ui.locale)
[ https://issues.apache.org/jira/browse/DERBY-4482?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ] Stan Bradbury updated DERBY-4482: - Summary: Property to set IJ session locale not documented (assume this is derby.ui.locale) (was: Property to set IJ session locale not documented (assume this is derby.ui.locacle)) > 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 > > 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 > 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.
