Uploaded image for project: 'Derby'
  1. Derby
  2. DERBY-3846

The list of supported message libraries looks wrong

    XMLWordPrintableJSON

    Details

    • Type: Bug
    • Status: Closed
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: 10.4.1.3
    • Fix Version/s: 10.5.2.0
    • Component/s: Documentation
    • Labels:
      None

      Description

      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.

        Attachments

        1. DERBY-3846.diff
          2 kB
          Camilla Haase
        2. cdevin38113.html
          5 kB
          Camilla Haase
        3. cdevin38113.html
          5 kB
          Camilla Haase
        4. DERBY-3846-2.diff
          2 kB
          Camilla Haase

          Activity

            People

            • Assignee:
              chaase3 Camilla Haase
              Reporter:
              rhillegas Richard N. Hillegas
            • Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: