db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "ASF subversion and git services (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (DERBY-4628) The Derby docs would be clearer if we replaced our jargon term "territory" with the term "locale" which is used commonly across the Java ecosystem.
Date Thu, 15 Aug 2013 17:20:01 GMT

    [ https://issues.apache.org/jira/browse/DERBY-4628?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13741211#comment-13741211

ASF subversion and git services commented on DERBY-4628:

Commit 1514387 from [~rhillegas] in branch 'code/trunk'
[ https://svn.apache.org/r1514387 ]

DERBY-4628: Replace the Derby jargon term territory with the more familiar term locale in
some Derby messages; commits derby-4628-01-ab-useLocaleInMessagesRatherThanTerritory.diff.
> The Derby docs would be clearer if we replaced our jargon term "territory" with the term
"locale" which is used commonly across the Java ecosystem.
> ---------------------------------------------------------------------------------------------------------------------------------------------------
>                 Key: DERBY-4628
>                 URL: https://issues.apache.org/jira/browse/DERBY-4628
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions:,,,,,
>            Reporter: Rick Hillegas
>            Assignee: Kim Haase
>         Attachments: derby-4628-01-aa-useLocaleInMessagesRatherThanTerritory.diff, derby-4628-01-ab-useLocaleInMessagesRatherThanTerritory.diff,
DERBY-4628.diff, DERBY-4628.stat, DERBY-4628.zip
> When talking about locales, the Derby user guides employ a piece of jargon which Java
programmers do not commonly use. The user guides speak about "territories" instead of "locales".
Here, for instance, is a puzzling sentence from the section on the territory attribute in
the Derby Reference Guide:
> "When creating or upgrading a database, use this attribute to associate a non-default
territory with the database."
> What, a Java developer might ask, is a territory? Reading more material from that page,
it may become apparent that a territory is nothing more or less than what the JDK's javadoc
calls a locale. The possible values for the territory attribute are nothing more or less than
the names of locales supported by the VM. Our discussion of language-sensitive issues would
be clearer if we used the common term rather than our private jargon.
> This jargon is used across the user guides. Correcting it would be a systemic change.

This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

View raw message