Add an appendix listing the country codes.
+2001-04-19 Bruno Haible <haible@clisp.cons.org>
+
+ * ISO_3166: New file.
+ * iso-3166.sed: New file.
+ * iso-639.sed: Renamed from iso-apdx.sed.
+ * Makefile.am (gettext_TEXINFOS): Remove iso-apdx.sed, add iso-639.sed
+ and iso-3166.sed.
+ (EXTRA_DIST): Likewise. Add ISO_3166.
+ (iso-639.texi): Renamed rule from iso-apdx.texi.
+ (iso-3166.texi): New rule.
+ * nls.texi (Using This Package): Recommend to set LANG to 'll_CC'.
+ glibc doesn't have locales named 'll'.
+ * gettext.texi (End Users): Likewise.
+ (Country Codes): New node.
+
2001-04-19 Bruno Haible <haible@clisp.cons.org>
* gettext.texi: Many tweaks by Philipp Thomas <pthomas@suse.de>.
--- /dev/null
+# ISO 3166 2-letter country codes
+#
+# @(#)iso3166.tab 1.8
+#
+# From Paul Eggert <eggert@twinsun.com> (1999-10-13):
+#
+# This file contains a table with the following columns:
+# 1. ISO 3166-1:1999 2-character country code. See:
+# <a href="http://www.din.de/gremien/nas/nabd/iso3166ma/codlstp1.html">
+# ISO 3166-1: The Code List
+# </a>.
+# 2. The usual English name for the country,
+# chosen so that alphabetic sorting of subsets produces helpful lists.
+# This is not the same as the English name in the ISO 3166 tables.
+#
+# Columns are separated by a single tab.
+# The table is sorted by country code.
+#
+# Lines beginning with `#' are comments.
+#
+#country-
+#code country name
+AD Andorra
+AE United Arab Emirates
+AF Afghanistan
+AG Antigua & Barbuda
+AI Anguilla
+AL Albania
+AM Armenia
+AN Netherlands Antilles
+AO Angola
+AQ Antarctica
+AR Argentina
+AS Samoa (American)
+AT Austria
+AU Australia
+AW Aruba
+AZ Azerbaijan
+BA Bosnia & Herzegovina
+BB Barbados
+BD Bangladesh
+BE Belgium
+BF Burkina Faso
+BG Bulgaria
+BH Bahrain
+BI Burundi
+BJ Benin
+BM Bermuda
+BN Brunei
+BO Bolivia
+BR Brazil
+BS Bahamas
+BT Bhutan
+BV Bouvet Island
+BW Botswana
+BY Belarus
+BZ Belize
+CA Canada
+CC Cocos (Keeling) Islands
+CD Congo (Dem. Rep.)
+CF Central African Rep.
+CG Congo (Rep.)
+CH Switzerland
+CI Cote d'Ivoire
+CK Cook Islands
+CL Chile
+CM Cameroon
+CN China
+CO Colombia
+CR Costa Rica
+CU Cuba
+CV Cape Verde
+CX Christmas Island
+CY Cyprus
+CZ Czech Republic
+DE Germany
+DJ Djibouti
+DK Denmark
+DM Dominica
+DO Dominican Republic
+DZ Algeria
+EC Ecuador
+EE Estonia
+EG Egypt
+EH Western Sahara
+ER Eritrea
+ES Spain
+ET Ethiopia
+FI Finland
+FJ Fiji
+FK Falkland Islands
+FM Micronesia
+FO Faeroe Islands
+FR France
+GA Gabon
+GB Britain (UK)
+GD Grenada
+GE Georgia
+GF French Guiana
+GH Ghana
+GI Gibraltar
+GL Greenland
+GM Gambia
+GN Guinea
+GP Guadeloupe
+GQ Equatorial Guinea
+GR Greece
+GS South Georgia & the South Sandwich Islands
+GT Guatemala
+GU Guam
+GW Guinea-Bissau
+GY Guyana
+HK Hong Kong
+HM Heard Island & McDonald Islands
+HN Honduras
+HR Croatia
+HT Haiti
+HU Hungary
+ID Indonesia
+IE Ireland
+IL Israel
+IN India
+IO British Indian Ocean Territory
+IQ Iraq
+IR Iran
+IS Iceland
+IT Italy
+JM Jamaica
+JO Jordan
+JP Japan
+KE Kenya
+KG Kyrgyzstan
+KH Cambodia
+KI Kiribati
+KM Comoros
+KN St Kitts & Nevis
+KP Korea (North)
+KR Korea (South)
+KW Kuwait
+KY Cayman Islands
+KZ Kazakhstan
+LA Laos
+LB Lebanon
+LC St Lucia
+LI Liechtenstein
+LK Sri Lanka
+LR Liberia
+LS Lesotho
+LT Lithuania
+LU Luxembourg
+LV Latvia
+LY Libya
+MA Morocco
+MC Monaco
+MD Moldova
+MG Madagascar
+MH Marshall Islands
+MK Macedonia
+ML Mali
+MM Myanmar (Burma)
+MN Mongolia
+MO Macao
+MP Northern Mariana Islands
+MQ Martinique
+MR Mauritania
+MS Montserrat
+MT Malta
+MU Mauritius
+MV Maldives
+MW Malawi
+MX Mexico
+MY Malaysia
+MZ Mozambique
+NA Namibia
+NC New Caledonia
+NE Niger
+NF Norfolk Island
+NG Nigeria
+NI Nicaragua
+NL Netherlands
+NO Norway
+NP Nepal
+NR Nauru
+NU Niue
+NZ New Zealand
+OM Oman
+PA Panama
+PE Peru
+PF French Polynesia
+PG Papua New Guinea
+PH Philippines
+PK Pakistan
+PL Poland
+PM St Pierre & Miquelon
+PN Pitcairn
+PR Puerto Rico
+PS Palestine
+PT Portugal
+PW Palau
+PY Paraguay
+QA Qatar
+RE Reunion
+RO Romania
+RU Russia
+RW Rwanda
+SA Saudi Arabia
+SB Solomon Islands
+SC Seychelles
+SD Sudan
+SE Sweden
+SG Singapore
+SH St Helena
+SI Slovenia
+SJ Svalbard & Jan Mayen
+SK Slovakia
+SL Sierra Leone
+SM San Marino
+SN Senegal
+SO Somalia
+SR Suriname
+ST Sao Tome & Principe
+SV El Salvador
+SY Syria
+SZ Swaziland
+TC Turks & Caicos Is
+TD Chad
+TF French Southern & Antarctic Lands
+TG Togo
+TH Thailand
+TJ Tajikistan
+TK Tokelau
+TM Turkmenistan
+TN Tunisia
+TO Tonga
+TP East Timor
+TR Turkey
+TT Trinidad & Tobago
+TV Tuvalu
+TW Taiwan
+TZ Tanzania
+UA Ukraine
+UG Uganda
+UM US minor outlying islands
+US United States
+UY Uruguay
+UZ Uzbekistan
+VA Vatican City
+VC St Vincent
+VE Venezuela
+VG Virgin Islands (UK)
+VI Virgin Islands (US)
+VN Vietnam
+VU Vanuatu
+WF Wallis & Futuna
+WS Samoa (Western)
+YE Yemen
+YT Mayotte
+YU Yugoslavia
+ZA South Africa
+ZM Zambia
+ZW Zimbabwe
MAKEINFO = env LANG= LANGUAGE= @MAKEINFO@
info_TEXINFOS = gettext.texi
-gettext_TEXINFOS = iso-apdx.texi
+gettext_TEXINFOS = iso-639.texi iso-3166.texi
-EXTRA_DIST = iso-apdx.sed ISO_639 nls.texi matrix.texi $(EXTRA_DIST_html)
+EXTRA_DIST = iso-639.sed iso-3166.sed ISO_639 ISO_3166 nls.texi matrix.texi $(EXTRA_DIST_html)
-iso-apdx.texi: ISO_639 iso-apdx.sed
- $(SED) -f $(srcdir)/iso-apdx.sed $(srcdir)/ISO_639 > iso-apdx.tmp
- rm -f $(srcdir)/iso-apdx.texi
- mv iso-apdx.tmp $(srcdir)/iso-apdx.texi
+iso-639.texi: ISO_639 iso-639.sed
+ $(SED) -f $(srcdir)/iso-639.sed $(srcdir)/ISO_639 > iso-639.tmp
+ rm -f $(srcdir)/iso-639.texi
+ mv iso-639.tmp $(srcdir)/iso-639.texi
+
+iso-3166.texi: ISO_3166 iso-3166.sed
+ $(SED) -f $(srcdir)/iso-3166.sed $(srcdir)/ISO_3166 > iso-3166.tmp
+ rm -f $(srcdir)/iso-3166.texi
+ mv iso-3166.tmp $(srcdir)/iso-3166.texi
# We distribute only the split HTML documentation.
* Conclusion:: Concluding Remarks
* Language Codes:: ISO 639 language codes
+* Country Codes:: ISO 3166 country codes
@detailmenu
--- The Detailed Node Listing ---
We consider here those packages using GNU @code{gettext} internally,
and for which the installers did not disable translation at
@emph{configure} time. Then, users only have to set the @code{LANG}
-environment variable to the appropriate @samp{@var{ll}} prior to
-using the programs in the package. @xref{Matrix}. For example,
-let's presume a German site. At the shell prompt, users merely have to
-execute @w{@samp{setenv LANG de}} (in @code{csh}) or @w{@samp{export
-LANG; LANG=de}} (in @code{sh}). They could even do this from their
-@file{.login} or @file{.profile} file.
+environment variable to the appropriate @samp{@var{ll}_@var{CC}}
+combination prior to using the programs in the package. @xref{Matrix}.
+For example, let's presume a German site. At the shell prompt, users
+merely have to execute @w{@samp{setenv LANG de_DE}} (in @code{csh}) or
+@w{@samp{export LANG; LANG=de_DE}} (in @code{sh}). They could even do
+this from their @file{.login} or @file{.profile} file.
@node Programmers, Translators, Users, Top
@chapter The Programmer's View
@noindent
together with French translations of many Linux-related documents.
-@node Language Codes, , Conclusion, Top
+@node Language Codes, Country Codes, Conclusion, Top
@appendix Language Codes
The @w{ISO 639} standard defines two character codes for many languages.
come from this standard.
@table @samp
-@include iso-apdx.texi
+@include iso-639.texi
+@end table
+
+@node Country Codes, , Language Codes, Top
+@appendix Country Codes
+
+The @w{ISO 3166} standard defines two character codes for many countries
+and territories. All abbreviations for countries used in the Translation
+Project should come from this standard.
+
+@table @samp
+@include iso-3166.texi
@end table
@contents
--- /dev/null
+#! /usr/bin/sed -f
+#
+# each line of the form ^..<tab>.* contains the code for a country.
+#
+/^.. / {
+ h
+ s/^.. \(.*\)/\1./
+ s/\&/and/g
+ x
+ s/^\(..\).*/@item \1/
+ G
+ p
+}
+#
+# delete the rest
+#
+d
# delete the rest
#
d
-
-
-
@section Using This Package
@c --
-@c FIXME: rewrite to document the long names and aliases.
+@c FIXME: rewrite to document the aliases.
@c --
As a user, if your language has been installed for this package, you
only have to set the @code{LANG} environment variable to the appropriate
-@w{ISO 639} @samp{@var{ll}} two-letter code prior to using the programs
-in the package. For example, let's suppose that you speak German. At
-the shell prompt, merely execute @w{@samp{setenv LANG de}} (in
-@code{csh}), @w{@samp{export LANG; LANG=de}} (in @code{sh}) or
-@w{@samp{export LANG=de}} (in @code{bash}). This can be done from your
+@samp{@var{ll}_@var{CC}} combination. Here @samp{@var{ll}} is an
+@w{ISO 639} two-letter language code, and @samp{@var{CC}} is an
+@w{ISO 3166} two-letter country code. For example, let's suppose that you
+speak German and live in Germany. At the shell prompt, merely execute
+@w{@samp{setenv LANG de_DE}} (in @code{csh}),
+@w{@samp{export LANG; LANG=de_DE}} (in @code{sh}) or
+@w{@samp{export LANG=de_DE}} (in @code{bash}). This can be done from your
@file{.login} or @file{.profile} file, once and for all.
-@c Packages which are not internationalized will merely ignore the
-@c setting of this variable.
-@c FIXME: This last sentence is not true!! --drepper
-Some languages have dialects in different countries. To specify such a
-dialect, the notation @samp{@var{ll}_@var{CC}} can be used, which
-combines an @w{ISO 639} language code @samp{@var{ll}} and an
-@w{ISO 3166} two-letter country code @samp{@var{CC}}. For example,
-@samp{de_AT} is used for Austria, and @samp{pt_BR} for Brazil.
+You might think that the country code specification is redundant. But in
+fact, some languages have dialects in different countries. For example,
+@samp{de_AT} is used for Austria, and @samp{pt_BR} for Brazil. The country
+code serves to distinguish the dialects.
Not all programs have translations for all languages. By default, an
English message is shown in place of a nonexistent translation. If you
by other parts of the system libraries.
For example, some Swedish users who would rather read translations in
German than English for when Swedish is not available, set @code{LANGUAGE}
-to @samp{sv:de} while leaving @code{LANG} to @samp{sv}.
+to @samp{sv:de} while leaving @code{LANG} to @samp{sv_SE}.
+
+In the @code{LANGUAGE} environment variable, but not in the @code{LANG}
+environment variable, @samp{@var{ll}_@var{CC}} combinations can be
+abbreviated as @samp{@var{ll}} to denote the language's main dialect.
+For example, @samp{de} is equivalent to @samp{de_DE} (German as spoken in
+Germany), and @samp{pt} to @samp{pt_PT} (Portuguese as spoken in Portugal)
+in this context.
@c An operating system might already offer message localization for many of
@c its programs, while other programs have been
projects / thirdparty / gettext.git / commitdiff
