[jira] Closed: (DERBY-3846) The list of supported message libraries looks wrong

["Rick Hillegas (JIRA)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/DERBY-3846?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Rick Hillegas closed DERBY-3846.
--------------------------------


Confirmed that changes appear in trunk docs. Closing.

> The list of supported message libraries looks wrong
> ---------------------------------------------------
>
>                 Key: DERBY-3846
>                 URL: https://issues.apache.org/jira/browse/DERBY-3846
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 10.4.1.3
>            Reporter: Rick Hillegas
>            Assignee: Kim Haase
>             Fix For: 10.5.1.2
>
>         Attachments: cdevin38113.html, cdevin38113.html, DERBY-3846-2.diff, DERBY-3846.diff
>
>
> The "Messages libraries" section of the Derby Developer's Guide says that Derby "supports" a number of locales:
>     * derbyLocale_de_DE.jar German
>     * derbyLocale_es.jar - Spanish
>     * derbyLocale_fr.jar - French
>     * derbyLocale_it.jar - Italian
>     * derbyLocale_ja_JP.jar - Japanese
>     * derbyLocale_ko_KR.jar - Korean
>     * derbyLocale_pt_BR.jar - Brazilian Portuguese
>     * derbyLocale_zh_CN.jar - Simplified Chinese
>     * derbyLocale_zh_TW.jar - Traditional Chinese
> In fact, in addition to these locales, Derby provides localizations for some others (see http://wiki.apache.org/db-derby/LocalizingDerbyMessages):
>     * derbyLocale_cs.jar - Czech
>     * derbyLocale_hu.jar - Hungarian
>     * derbyLocale_pl.jar - Polish (except for sysinfo)
>     * derbyLocale_ru.jar - Russian
> The term "supports" may overdescribe the situation. Effort has been put into keeping some of these localizations up-to-date, although I don't think that any systematic effort has been put into verifying that any of our non-English locales are really current. Some locales have not been updated recently. Here's the list of locales which received fresh localizations in 10.4 (see http://issues.apache.org/jira/browse/DERBY-3804):
> German
> Spanish
> French
> Italian
> Japanese
> Korean
> Traditional and Simplified Chinese 
> This means that the Developer's Guide is claiming that Derby "supports" Portuguese, even though it's clear that those localizations are drifting out of sync with the English messages.
> We should correct the "Message libraries" section:
> 1) We should decide what we mean by "supports". This term could mean
>  
>   a) Derby provides SOME localized messages for the locale or
>   b) The localizations are being actively maintained
> 2) Based on what how we resolve (1), we should add or subtract locales from the list in "Message libraries"
> My gut feeling is that we should list all of the locales for which we provide localizations and this section should note that some locales are maintained better than others.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.