Document the most important ISO-639 three-letter language codes.

3 files changed, 48 insertions, 3 deletions

diff --git a/gettext-tools/doc/ChangeLog b/gettext-tools/doc/ChangeLog
index 0badacf..00285c2 100644
--- a/gettext-tools/doc/ChangeLog
+++ b/gettext-tools/doc/ChangeLog
@@ -1,3 +1,13 @@
+2006-10-17  Bruno Haible  <bruno@clisp.org>
+
+	* ISO_639-2: New file.
+	* iso-639-2.sed: New file.
+	* Makefile.am (gettext_TEXINFOS): Add iso-639-2.texi.
+	(EXTRA_DIST): Add iso-639-2.sed, ISO_639-2.
+	(iso-639-2.texi): New rule.
+	* gettext.texi (Language codes): Split into two nodes "Usual Language
+	Codes" and "Rare Language Codes". Include iso-639-2.texi.
+
 2006-10-08  Bruno Haible  <bruno@clisp.org>
 
 	* gettextize.texi: Document the --symlink option instead of the --copy
diff --git a/gettext-tools/doc/Makefile.am b/gettext-tools/doc/Makefile.am
index b513082..a60c8fa 100644
--- a/gettext-tools/doc/Makefile.am
+++ b/gettext-tools/doc/Makefile.am
@@ -34,7 +34,7 @@ gettext_TEXINFOS = \
   xgettext.texi msginit.texi msgmerge.texi msgcat.texi msgconv.texi \
   msggrep.texi msgfilter.texi msguniq.texi msgcomm.texi msgcmp.texi \
   msgattrib.texi msgen.texi msgexec.texi msgfmt.texi msgunfmt.texi \
-  gettextize.texi autopoint.texi iso-639.texi iso-3166.texi \
+  gettextize.texi autopoint.texi iso-639.texi iso-639-2.texi iso-3166.texi \
   gpl.texi lgpl.texi fdl.texi \
   $(top_srcdir)/../gettext-runtime/doc/rt-gettext.texi \
   $(top_srcdir)/../gettext-runtime/doc/rt-ngettext.texi \
@@ -46,7 +46,9 @@ doc_DATA = FAQ.html tutorial.html
 EXTRA_DIST += $(doc_DATA)
 
 EXTRA_DIST += \
-  iso-639.sed iso-3166.sed ISO_639 ISO_3166 ISO_3166_de texi2html \
+  iso-639.sed iso-639-2.sed iso-3166.sed \
+  ISO_639 ISO_639-2 ISO_3166 ISO_3166_de \
+  texi2html \
   ChangeLog.0
 
 iso-639.texi: ISO_639 iso-639.sed
@@ -54,6 +56,11 @@ iso-639.texi: ISO_639 iso-639.sed
 	rm -f $(srcdir)/iso-639.texi
 	mv iso-639.tmp $(srcdir)/iso-639.texi
 
+iso-639-2.texi: ISO_639-2 iso-639-2.sed
+	$(SED) -f $(srcdir)/iso-639-2.sed $(srcdir)/ISO_639-2 > iso-639-2.tmp
+	rm -f $(srcdir)/iso-639-2.texi
+	mv iso-639-2.tmp $(srcdir)/iso-639-2.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
diff --git a/gettext-tools/doc/gettext.texi b/gettext-tools/doc/gettext.texi
index feeecb5..8936946 100644
--- a/gettext-tools/doc/gettext.texi
+++ b/gettext-tools/doc/gettext.texi
@@ -436,6 +436,11 @@ Concluding Remarks
 * History::                     History of GNU @code{gettext}
 * References::                  Related Readings
 
+Language Codes
+
+* Usual Language Codes::        Two-letter ISO 639 language codes
+* Rare Language Codes::         Three-letter ISO 639 language codes
+
 Licenses
 
 * GNU GPL::                     GNU General Public License
@@ -10852,14 +10857,37 @@ together with French translations of many Linux-related documents.
 @cindex language codes
 @cindex ISO 639
 
-The @w{ISO 639} standard defines two character codes for many languages.
+The @w{ISO 639} standard defines two-letter codes for many languages, and
+three-letter codes for more rarely used languages.
 All abbreviations for languages used in the Translation Project should
 come from this standard.
 
+@menu
+* Usual Language Codes::        Two-letter ISO 639 language codes
+* Rare Language Codes::         Three-letter ISO 639 language codes
+@end menu
+
+@node Usual Language Codes, Rare Language Codes, Language Codes, Language Codes
+@appendixsec Usual Language Codes
+
+For the commonly used languages, the @w{ISO 639-1} standard defines two-letter
+codes.
+
 @table @samp
 @include iso-639.texi
 @end table
 
+@node Rare Language Codes,  , Usual Language Codes, Language Codes
+@appendixsec Rare Language Codes
+
+For rarely used languages, the @w{ISO 639-2} standard defines three-letter
+codes.  Here is the current list, reduced to only living languages with at least
+one million of speakers.
+
+@table @samp
+@include iso-639-2.texi
+@end table
+
 @node Country Codes, Licenses, Language Codes, Top
 @appendix Country Codes
 @cindex country codes