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:17:50 GMT

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

ASF subversion and git services commented on DERBY-4628:
--------------------------------------------------------

Commit 1514383 from [~chaase3] in branch 'docs/trunk'
[ https://svn.apache.org/r1514383 ]

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.  

Modified 5 Reference Manual topics (and map), 3 Developer's Guide topics (and map), 5 Tools
Guide topics (and map), and 1 Tuning Derby topic.

Patch: DERBY-4628.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: 10.6.1.0, 10.6.2.1, 10.7.1.1, 10.8.3.0, 10.9.1.0, 10.10.1.1
>            Reporter: Rick Hillegas
>            Assignee: Kim Haase
>         Attachments: derby-4628-01-aa-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

Mime
View raw message