linux/glibc/index.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
   2         "http://www.w3.org/TR/html4/loose.dtd">
   3 <html lang="en">
   4   <head>
   5     <title>GNU libc (glibc) locale patch page</title>
   6     <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
   7     <meta http-equiv="Content-Language" content="en">
   8     <link rel="stylesheet" type="text/css" href="http://i18n.skolelinux.no/stilsett.css" id="nn1">
   9     <link rel="stylesheet" type="text/css" href="http://i18n.skolelinux.no/utskrift.css" media="print" id="nn2">
  10   </head>
  11
  12   <body>
  13     <div class="topp">
  14     <h1>GNU libc (glibc) locale patch page</h1>
  15     </div>
  16
  17     <div class="meny">
  18       <h2>Related pages</h2>
  19       <ul>
  20         <li><a href="http://www.gnu.org/software/libc/">GNU libc homepage</a></li>
  21
  22         <li><a href="http://sources.redhat.com/glibc/">GNU libc jumpstation</a></li>
  23
  24         <li><a href="http://sources.redhat.com/bugzilla/">GNU libc bugzilla</a></li>
  25
  26         <li><a href="http://sources.redhat.com/bugzilla/buglist.cgi?product=glibc&component=localedata&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=SUSPENDED&bug_status=WAITING&bug_status=REOPENED">GNU libc locale bugs</a></li>
  27
  28         <li><a href="http://sources.redhat.com/cgi-bin/cvsweb.cgi/libc/?cvsroot=glibc">GNU libc CVSweb</a></li>
  29
  30         <li><a href="http://www.openi18n.org/specs/ldml/">OpenI18n The
  31             Locale Data Markup Language Specification</a></li>
  32
  33         <li><a href="http://www.unicode.org/reports/tr24/">Unicode
  34             Standard Annex #24 Script Names</a></li>
  35
  36       </ul>
  37       <hr>
  38
  39       <p><a href="MAINTAINERS.txt">Current locales and their
  40           maintainers</a></p>
  41
  42       <p><a href="howto.html">Locale writing howto</a></p>
  43
  44     </div>
  45
  46     <div class="hovuddel">
  47
  48     <p>This page contain information about the GNU libc locale
  49       collection, including patches, suggested formates, list of known
  50       problems and who to contact regarding the different locales.  It
  51       is a work in progress.  The page maintainer, Petter
  52       Reinholdtsen, is working with the GNU libc maintainers to get
  53       all the fixes included in the official releases of the
  54       source.</p>
  55
  56       <h2>Mailing list for discussing locales</h2>
  57
  58       <p>A mailing list for discussing the GNU libc locales have been
  59         created.  It is
  60         <a href="http://sources.redhat.com/ml/libc-locales/">archived on
  61           the web</a>.  Send an email to
  62         <tt>libc-locales-subscribe&#064;sources.redhat.com</tt> to subscribe.</p>
  63
  64     <h2>References to documentation and standards</h2>
  65
  66     <p>It is currently an open question where the format og locales in
  67       glibc is documented.  This list of references is at least
  68       pointing to related docuemnts documenting the format of locales,
  69       even if the glibc maintainers might not accept them as
  70       authoritative.</p>
  71
  72     <ul>
  73
  74       <li>ISO/IEC 9945-2:1993 (not freely available)</li>
  75
  76       <li><a href="http://www.unix-systems.org/version3/">ISO/IEC
  77           9945:2002</a></li>
  78
  79       <li><a href="http://www.opengroup.org/onlinepubs/007904975/basedefs/xbd_chap07.html">The
  80           Open Group Base Specifications Issue 6, IEEE Std 1003.1, 2003
  81           Edition</a></li>
  82
  83       <li><a href="http://www.dkuug.dk/JTC1/SC22/open/n2638/">ISO/IEC
  84           FCD 14652</a></li>
  85
  86       <li><a href="http://yacob.org/ISO-14652.pdf">ISO/IEC FPDTR
  87           14652:1999(E)</a></li>
  88
  89       <li><a href="http://www.dkuug.dk/JTC1/SC22/WG20/docs/n972-14652ft.pdf">ISO/IEC
  90           TR 14652:2003</a></li>
  91
  92     </ul>
  93
  94       <h2>Changing a locale</h2>
  95
  96       <p>Getting locale fixes past the glibc maintainers is still a
  97         kind of black art to me.  This is my first try to document
  98         what I believe is needed to get the glibc maintainers to
  99         accept a change.</p>
 100
 101       <p>Register the change request in bugzilla, to make sure the
 102         request is not forgotten, and that all relevant info is
 103         collected in one place.</p>
 104
 105       <p>It is always good to involve the original locale author when
 106         submitting a change request.  Getting the original author to
 107         agree to the change increases the chance that the glibc
 108         maintainers will accept it.  It is also an idea to involve the
 109         contributors to the locale.  This is why I maintain a list of
 110         authors and contributors for each locale.  The people listed
 111         there should be emailed as well, and asked for comments.  If
 112         the contributors agree as well, the change is less likely to
 113         be controversial, and more likely to be accepted by the glibc
 114         maintainers.</p>
 115
 116       <p>Give references to official standards and specifications
 117         documenting the correct locale behavoiur.  URLs are fine.  If
 118         such references are impossible to find, official-looking pages
 119         might have the same effect.  Another idea is to show
 120         locale-specific use of dates and other formatting on
 121         country-official web pages and other publications.</p>
 122
 123       <p>If all of these are present, the change is likely to be
 124         accepted by the glibc maintainer.  If some of them are missing
 125         (like the author is unavailable, no standard and
 126         specifications exist, and it is hard to document the correct
 127         format, I do not know how to get the change past the glibc
 128         maintainers.</p>
 129
 130     <h2>Locale related problem reports</h2>
 131
 132     <h3>From <a href="http://bugs.gnu.org/">GNU libc gnats database</a></h3>
 133
 134       <p>The GNATS database is dead at the moment (2003-10-31), and
 135         has been dead since this summer.</p>
 136
 137     <ul>
 138
 139       <li>libc/2254: Insufficient info from the locale tool.
 140         <br>(patch sent to libc-alpha, partly fixed in CVS 2003-05-21)
 141
 142       <li>libc/2931: Missing nb_NO locale
 143         <br>(patch sent to libc-alpha 2003-06-15)
 144
 145       <li>libc/2954: Should add postal telephone and vehicle codes to locales
 146         <br>(HTML error in gnats?)
 147
 148       <li>libc/3606: Update documentation regarding LC_ALL and LANG
 149
 150       <li>libc/4197: Incorrect hr_HR - currency sumbol position
 151         <br>(sent email to submitter [bad address] and author)
 152
 153      <li>libc/4348: Converting charset "eucjp->sjis->iso2022jp" and
 154         "eucjp->iso2022jp" give different result.
 155
 156       <li>libc/4658: 'locale -a' do not list locales in archive
 157
 158       <li>libc/4938: Segfaults when using locale info before it is initialized
 159
 160       <li><strike>libc/5013: Incorrect fi_FI - gramatic</strike>
 161         <br>(sent email to submitter and author, patch sent 2003-05-09,
 162         patch commited 2003-06-16)
 163
 164       <li>libc/5018, libc/5019, libc/5028: Incorret uk_UA.
 165         <br>(sent email to submitter and author)
 166
 167       <li>libc/5023: Missing locales li_NL, nds_NL and nds_DE
 168         <br>(sent email to submitter)
 169
 170       <li>libc/5059: Wrong date format for locale sl_SI
 171         <br>(sent email to submitter and locale author, approved by author,
 172         patch sent to libc-alpha 2003-07-06)
 173
 174     </ul>
 175
 176     <h3>From <a href="http://bugs.debian.org/">Debian GNU/Linux BTS</a></h3>
 177
 178     <ul>
 179
 180       <li><a href="http://bugs.debian.org/111268">#111268: Incorrect
 181           sv_SE - 13:59 instead of 13.59 for clock time</a>
 182         <br>(patch sent 2003-05-18)
 183
 184       <li><a href="http://bugs.debian.org/119528">#119528: Incorrect
 185           ro_RO - rewritten locale</a>
 186         <br>(sent email to submitter)
 187
 188       <li><strike><a href="http://bugs.debian.org/178513">#178513:
 189             Incorrect is_IS - Use lower case letters in month and week
 190             day names</a></strike>
 191           <br>(sent email to submitter and author, confirmed by Keld,
 192           patch sent to libc-alpha 2003-06-15, patch commited
 193           2003-06-16)
 194
 195       <li><strike><a href="http://bugs.debian.org/194289">#194289: New
 196             locale ag_ES for Aragonese</a></strike>
 197           <br>(sent email to submitter, patch commited 2003-06-16 as
 198           an_ES)
 199
 200       <li><a href="http://bugs.debian.org/193904">#193904:
 201           locales.alias even lines are not considered (debian
 202           only?)</a>
 203
 204       <li><strike><a href="http://bugs.debian.org/206474">#206474: locales:
 205           nb_NO should be a real locale, not an alias</a></strike>
 206         <br>Same as libc/2931
 207
 208       <li><strike><a href="http://bugs.debian.org/208238">#208238: locales:
 209           wrong charset for et_EE</a></strike>
 210
 211       <li><strike><a href="http://bugs.debian.org/211607">#211607: Bad catalan
 212           locale currency format</a></strike>
 213
 214       <li><a href="http://bugs.debian.org/214107">#214107: locales:
 215           en_US.UTF-8 treats [ as a space char</a>
 216
 217       <li><a href="http://bugs.debian.org/214414">#214414: Incorrect
 218           date format in en_NZ</a>
 219
 220       <li><strike><a href="http://bugs.debian.org/215466">#215466: fi_FI
 221           locale doesn't contain first_weekday</a></strike>
 222
 223     </ul>
 224
 225     <h3>From <a href="https://bugzilla.redhat.com/">RedHat Bugzilla</a></h3>
 226
 227     <ul>
 228
 229       <li><strike><a href="https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=75139">#75139:
 230           Incorrect week start day for sv_SE (should start on
 231           monday)</a></strike>
 232         <br>(Corrected in CVS 2003-01-14)
 233
 234       <li><a href="https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=83276">#83276:
 235           Norwegian locale in distro</a>
 236         <br>Same as libc/2931
 237
 238     </ul>
 239
 240     <h2>Patches submitted to the glibc maintainers</h2>
 241
 242     <p>If you know of some patches that should be listed here, please
 243     send me an email.  I want to track all relevant patches, not just
 244     the ones submitted by me.</p>
 245
 246     <h3>Pending/rejected</h3>
 247
 248     <ul>
 249
 250       <li><a href="http://sources.redhat.com/ml/libc-alpha/2003-04/msg00173.html">2003-04-15
 251           Add sorting test for no_NO</a>
 252
 253
 254       <li><a href="http://sources.redhat.com/ml/libc-alpha/2003-05/msg00151.html">2003-05-18
 255           Correct sorting for nn_NO to match no_NO</a>
 256
 257       <li><a href="http://sources.redhat.com/ml/libc-alpha/2003-05/msg00154.html">2003-05-18
 258           Norwegian week start on monday, fix no_NO and nn_NO</a>
 259
 260       <li><a href="http://sources.redhat.com/ml/libc-alpha/2003-05/msg00155.html">2003-05-18
 261           Change sv_SE to use ':' in clock format (BTS #111268)</a>
 262
 263       <li><strike><a href="http://sources.redhat.com/ml/libc-alpha/2003-05/msg00158.html">2003-05-18
 264             Include examples in 'locale --help' (PR libc/2254,
 265             rejected)</a></strike>
 266
 267       <li><strike><a href="http://sources.redhat.com/ml/libc-alpha/2003-05/msg00265.html">2003-05-29
 268             Generate locales on 'make check' (rejected)</a></strike>
 269
 270       <li><a href="http://sources.redhat.com/ml/libc-alpha/2003-05/msg00267.html">2003-05-29
 271           Indent the error output from sort-test.sh</a>
 272
 273       <li><strike><a href="http://sources.redhat.com/ml/libc-alpha/2003-06/msg00133.html">2003-06-15
 274           Add nb_NO locale (PR libc/2931)</a></strike>
 275
 276       <li><a href="http://sources.redhat.com/ml/libc-alpha/2003-07/msg00021.html">2003-07-06
 277             Correct wrong date format for locale sl_SI (PR libc/5059)</a>
 278
 279       <li><a href="http://sources.redhat.com/ml/libc-alpha/2003-08/msg00082.html">2003-08-13
 280             Updated/new locales for sr_CS (Serbia and Montenegro)</a></li>
 281
 282       <li><a href="http://sources.redhat.com/ml/libc-alpha/2003-06/msg00257.html">2003-06-21
 283           Add test for international currency formatting.</a> and
 284           <a href="http://sources.redhat.com/ml/libc-alpha/2003-11/msg00135.html">2003-11-23
 285             Add test for international currency formatting (updated)</a></li>
 286
 287       <li><strike><a href="http://sources.redhat.com/ml/libc-alpha/2004-01/msg00016.html">2004-01-01
 288             Change et_EE charset to ISO-8859-15</a> (rejected)</strike></li>
 289
 290     </ul>
 291
 292     <h3>Accepted/included</h3>
 293
 294     <ul>
 295
 296       <li><strong><a href="http://sources.redhat.com/ml/libc-alpha/2003-05/msg00310.html">2003-05-31
 297             Correct email of Denis V. Dmitrienko in uk_UA
 298             (commited)</a></strong></li>
 299
 300       <li><strong><a href="http://sources.redhat.com/ml/libc-alpha/2003-05/msg00311.html">2003-05-31
 301             Correct thousand separator for fi_FI (commited)</a></strong></li>
 302
 303       <li><strong><a href="http://sources.redhat.com/ml/libc-alpha/2003-06/msg00129.html">2003-06-15
 304             Correct fi_FI date gramar (PR libc/5013) (commited)</a></strong></li>
 305
 306       <li><strong><a href="http://sources.redhat.com/ml/libc-alpha/2003-06/msg00141.html">2003-06-15
 307             Clean up locale test code (commited)</a></strong></li>
 308
 309       <li><strong><a href="http://sources.redhat.com/ml/libc-alpha/2003-06/msg00155.html">2003-06-15
 310             Use lower case letters in month and week day names in is_IS
 311             (commited)</a></strong></li>
 312
 313       <li><strong><a href="http://sources.redhat.com/ml/libc-alpha/2003-06/msg00255.html">2003-06-21
 314             Add missing ETH to LC_COLLATE in no_NO
 315             (commited)</a></strong></li>
 316
 317       <li><strong><a href="http://sources.redhat.com/ml/libc-alpha/2003-06/msg00317.html">2003-06-25
 318             Correct an_ES charset and add an_ES.ISO-8859-15 to
 319             SUPPORTED (commited)</a></strong></li>
 320
 321       <li><strong><a href="http://sources.redhat.com/ml/libc-alpha/2003-07/msg00017.html">2003-07-05
 322             Updating/adding locale for Ethiopia and Eritrea</a></strong></li>
 323
 324       <li><strong><a href="http://sources.redhat.com/ml/libc-alpha/2003-07/msg00020.html">2003-07-13
 325             Make sort-test handle more then 100 lines, and avoid
 326             segfault (commited)</a></strong></li>
 327
 328       <li><strong><a href="http://sources.redhat.com/ml/libc-alpha/2003-09/msg00003.html">2003-09-01
 329           Document why there are two locales for Hebrew</a></strong></li>
 330
 331       <li><strong><a href="http://sources.redhat.com/ml/libc-alpha/2003-09/msg00091.html">2003-09-11
 332           Locales for Uzbekistan (uz_UZ and uz_UZ@Cyrl)</a></strong></li>
 333
 334       <li><strong><a href="http://sources.redhat.com/ml/libc-alpha/2003-11/msg00126.html">2003-11-23
 335           Only check the currency name against 4217, exclude the space</a></strong></li>
 336
 337       <li><strong><a href="http://sources.redhat.com/ml/libc-alpha/2003-11/msg00128.html">2003-11-23
 338           Monday is first work and week day in Finland</a></strong></li>
 339
 340       <li><strong><a href="http://sources.redhat.com/ml/libc-alpha/2003-11/msg00129.html">2003-11-23
 341             Remove unused file localedata/locales/translit_et</a></strong></li>
 342
 343       <li><strong><a href="http://sources.redhat.com/ml/libc-alpha/2004-01/msg00004.html">2004-01-01
 344             Make strfmon() more POSIX-compliant</a></strong></li>
 345
 346       <li><strong><a href="http://sources.redhat.com/ml/libc-alpha/2004-01/msg00007.html">2004-01-01
 347             Report which of the sorting methods that fail</a></strong></li>
 348
 349       <li><strong><a href="http://sources.redhat.com/ml/libc-alpha/2003-11/msg00127.html">2003-11-23
 350           Correct formatting of internatinal currency</a></strong></li>
 351
 352       <li><strong><a href="http://sources.redhat.com/ml/libc-alpha/2003-11/msg00133.html">2003-11-23
 353             Allow quotes in tst-fmon.data, and make output easier to read</a></strong></li>
 354
 355       <li><strong><a href="http://sources.redhat.com/ml/libc-alpha/2003-07/msg00022.html">2003-07-06
 356           Some small locale fixes</a></strong></li>
 357
 358     </ul>
 359
 360       <h2>Missing locales?</h2>
 361
 362       <p>Bruno Haible told me about a
 363         <a href="http://msdn.microsoft.com/workshop/author/dhtml/reference/language_codes.asp">list
 364           of language codes</a> available from Microsoft, and
 365           discovered that some of these are missing as locales in
 366           current GNU libc.</p>
 367
 368       <table>
 369           <tr>
 370             <th>Locale code</th>
 371             <th>Language</th>
 372             <th>Region/Country</th>
 373           </tr>
 374
 375           <tr>
 376             <td>bnt_TZ
 377             <td>Sutu
 378             <td>Tanzania
 379             <td>(MS calls this one "sx" - not ISO 639)
 380               <br>(see also <a href="http://www.ethnologue.com/show_language.asp?code=NGU">http://www.ethnologue.com/show_language.asp?code=NGU</a>)
 381               <br>Correct code st_LS / nso_ZA ?
 382           </tr>
 383
 384           <tr>
 385             <td>de_LI
 386             <td>German
 387             <td>Liechtenstein
 388           </tr>
 389
 390           <tr>
 391             <td>en_JM
 392             <td>English
 393             <td>Jamaica
 394           </tr>
 395
 396           <tr>
 397             <td>en_GD
 398             <td>English
 399             <td>Caribbean
 400           </tr>
 401
 402           <tr>
 403             <td>en_BZ
 404             <td>English
 405             <td>Belize
 406           </tr>
 407
 408           <tr>
 409             <td>en_TT
 410             <td>English
 411             <td>Trinidad
 412           </tr>
 413
 414           <tr>
 415             <td>gd_IE
 416             <td>Gaelic
 417             <td>Ireland
 418           </tr>
 419
 420           <tr>
 421             <td>rm_CH
 422             <td>Rhaeto-Romanic
 423             <td>Switzerland
 424           </tr>
 425
 426           <tr>
 427             <td>ro_MD
 428             <td>Romanian
 429             <td>Moldavia
 430             <td>(MS calls this one "MO" - not ISO 3166)
 431           </tr>
 432
 433           <tr>
 434             <td>ru_MD
 435             <td>Russian
 436             <td>Moldavia
 437             <td>(MS calls this one "MO" - not ISO 3166)
 438           </tr>
 439
 440           <tr>
 441             <td>ts_ZA
 442             <td>Tsonga
 443             <td>South Africa
 444             <td>(see also <a href="http://www.ethnologue.com/show_language.asp?code=TSO">http://www.ethnologue.com/show_language.asp?code=TSO</a>)
 445           </tr>
 446
 447           <tr>
 448             <td>tn_BW
 449             <td>Tswana
 450             <td>Botswana
 451             <td>(see also <a href="http://www.ethnologue.com/show_language.asp?code=TSW">http://www.ethnologue.com/show_language.asp?code=TSW</a>)
 452           </tr>
 453
 454           <tr>
 455             <td>ven_ZA
 456             <td>Venda
 457             <td>South Africa
 458             <td>(not sure about ISO 639 code: "ve" or "ven")
 459               <br>(see also <a href="http://www.ethnologue.com/show_language.asp?code=VEN">http://www.ethnologue.com/show_language.asp?code=VEN</a>)
 460           </tr>
 461
 462           <tr>
 463             <td>wen_DE
 464             <td>Sorbian
 465             <td>Germany
 466               <td>(MS calls this one "sb" - not ISO 639)
 467               <br>(see also <a href="http://www.ethnologue.com/show_language.asp?code=WEN">http://www.ethnologue.com/show_language.asp?code=WEN</a>)
 468           </tr>
 469
 470       </table>
 471
 472       <h2>Related web pages</h2>
 473
 474       <ul>
 475
 476         <li>AIX locale documentation,
 477           <a href="http://nscp.upenn.edu/aix4.3html/files/aixfiles/Locale_Definition.htm">definition</a>,
 478           <a href="http://nscp.upenn.edu/aix4.3html/files/aixfiles/LC_COLLATE.htm">LC_COLLATE</a>,
 479           <a href="http://nscp.upenn.edu/aix4.3html/files/aixfiles/LC_CTYPE.htm">LC_CTYPE</a>,
 480           <a href="http://nscp.upenn.edu/aix4.3html/files/aixfiles/LC_MESSAGES.htm">LC_MESSAGES</a>,
 481           <a href="http://nscp.upenn.edu/aix4.3html/files/aixfiles/LC_MONETARY.htm">LC_MONETARY</a>,
 482           <a href="http://nscp.upenn.edu/aix4.3html/files/aixfiles/LC_NUMERIC.htm">LC_NUMERIC</a> and
 483           <a href="http://nscp.upenn.edu/aix4.3html/files/aixfiles/LC_TIME.htm">LC_TIME</a>.</li>
 484
 485       </ul>
 486
 487     </div>
 488     <hr>
 489     <address><a href="mailto:pere&#064;hungry.com">Petter Reinholdtsen</a></address>
 490 <!-- Created: Tue Sep  2 00:10:31 CEST 2003 -->
 491 <!-- hhmts start -->
 492 Last modified: Sun Jul 18 10:07:40 CEST 2004
 493 <!-- hhmts end -->
 494   </body>
 495 </html>