[thirdparty/e2fsprogs.git] / ABOUT-NLS

Notes on the Free Translation Project
*************************************

   Free software is going international!  The Free Translation Project
is a way to get maintainers of free software, translators, and users all
together, so that will gradually become able to speak many languages.
A few packages already provide translations for their messages.

   If you found this `ABOUT-NLS' file inside a distribution, you may
assume that the distributed package does use GNU `gettext' internally,
itself available at your nearest GNU archive site.  But you do _not_
need to install GNU `gettext' prior to configuring, installing or using
this package with messages translated.

   Installers will find here some useful hints.  These notes also
explain how users should proceed for getting the programs to use the
available translations.  They tell how people wanting to contribute and
work at translations should contact the appropriate team.

   When reporting bugs in the `intl/' directory or bugs which may be
related to internationalization, you should tell about the version of
`gettext' which is used.  The information can be found in the
`intl/VERSION' file, in internationalized packages.

Quick configuration advice
==========================

   If you want to exploit the full power of internationalization, you
should configure it using

     ./configure --with-included-gettext

to force usage of internationalizing routines provided within this
package, despite the existence of internationalizing capabilities in the
operating system where this package is being installed.  So far, only
the `gettext' implementation in the GNU C library version 2 provides as
many features (such as locale alias, message inheritance, automatic
charset conversion or plural form handling) as the implementation here.
It is also not possible to offer this additional functionality on top
of a `catgets' implementation.  Future versions of GNU `gettext' will
very likely convey even more functionality.  So it might be a good idea
to change to GNU `gettext' as soon as possible.

   So you need _not_ provide this option if you are using GNU libc 2 or
you have installed a recent copy of the GNU gettext package with the
included `libintl'.

INSTALL Matters
===============

   Some packages are "localizable" when properly installed; the
programs they contain can be made to speak your own native language.
Most such packages use GNU `gettext'.  Other packages have their own
ways to internationalization, predating GNU `gettext'.

   By default, this package will be installed to allow translation of
messages.  It will automatically detect whether the system already
provides the GNU `gettext' functions.  If not, the GNU `gettext' own
library will be used.  This library is wholly contained within this
package, usually in the `intl/' subdirectory, so prior installation of
the GNU `gettext' package is _not_ required.  Installers may use
special options at configuration time for changing the default
behaviour.  The commands:

     ./configure --with-included-gettext
     ./configure --disable-nls

will respectively bypass any pre-existing `gettext' to use the
internationalizing routines provided within this package, or else,
_totally_ disable translation of messages.

   When you already have GNU `gettext' installed on your system and run
configure without an option for your new package, `configure' will
probably detect the previously built and installed `libintl.a' file and
will decide to use this.  This might be not what is desirable.  You
should use the more recent version of the GNU `gettext' library.  I.e.
if the file `intl/VERSION' shows that the library which comes with this
package is more recent, you should use

     ./configure --with-included-gettext

to prevent auto-detection.

   The configuration process will not test for the `catgets' function
and therefore it will not be used.  The reason is that even an
emulation of `gettext' on top of `catgets' could not provide all the
extensions of the GNU `gettext' library.

   Internationalized packages have usually many `po/LL.po' files, where
LL gives an ISO 639 two-letter code identifying the language.  Unless
translations have been forbidden at `configure' time by using the
`--disable-nls' switch, all available translations are installed
together with the package.  However, the environment variable `LINGUAS'
may be set, prior to configuration, to limit the installed set.
`LINGUAS' should then contain a space separated list of two-letter
codes, stating which languages are allowed.

Using This Package
==================

   As a user, if your language has been installed for this package, you
only have to set the `LANG' environment variable to the appropriate
`LL_CC' combination.  Here `LL' is an ISO 639 two-letter language code,
and `CC' is an 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 `setenv LANG de_DE' (in `csh'),
`export LANG; LANG=de_DE' (in `sh') or `export LANG=de_DE' (in `bash').
This can be done from your `.login' or `.profile' file, once and for
all.

   You might think that the country code specification is redundant.
But in fact, some languages have dialects in different countries.  For
example, `de_AT' is used for Austria, and `pt_BR' for Brazil.  The
country code serves to distinguish the dialects.

   The locale naming convention of `LL_CC', with `LL' denoting the
language and `CC' denoting the country, is the one use on systems based
on GNU libc.  On other systems, some variations of this scheme are
used, such as `LL' or `LL_CC.ENCODING'.  You can get the list of
locales supported by your system for your country by running the command
`locale -a | grep '^LL''.

   Not all programs have translations for all languages.  By default, an
English message is shown in place of a nonexistent translation.  If you
understand other languages, you can set up a priority list of languages.
This is done through a different environment variable, called
`LANGUAGE'.  GNU `gettext' gives preference to `LANGUAGE' over `LANG'
for the purpose of message handling, but you still need to have `LANG'
set to the primary language; this is required 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 `LANGUAGE' to `sv:de' while leaving `LANG' to `sv_SE'.

   In the `LANGUAGE' environment variable, but not in the `LANG'
environment variable, `LL_CC' combinations can be abbreviated as `LL'
to denote the language's main dialect.  For example, `de' is equivalent
to `de_DE' (German as spoken in Germany), and `pt' to `pt_PT'
(Portuguese as spoken in Portugal) in this context.

Translating Teams
=================

   For the Free Translation Project to be a success, we need interested
people who like their own language and write it well, and who are also
able to synergize with other translators speaking the same language.
Each translation team has its own mailing list.  The up-to-date list of
teams can be found at the Free Translation Project's homepage,
`http://www.iro.umontreal.ca/contrib/po/HTML/', in the "National teams"
area.

   If you'd like to volunteer to _work_ at translating messages, you
should become a member of the translating team for your own language.
The subscribing address is _not_ the same as the list itself, it has
`-request' appended.  For example, speakers of Swedish can send a
message to `sv-request@li.org', having this message body:

     subscribe

   Keep in mind that team members are expected to participate
_actively_ in translations, or at solving translational difficulties,
rather than merely lurking around.  If your team does not exist yet and
you want to start one, or if you are unsure about what to do or how to
get started, please write to `translation@iro.umontreal.ca' to reach the
coordinator for all translator teams.

   The English team is special.  It works at improving and uniformizing
the terminology in use.  Proven linguistic skill are praised more than
programming skill, here.

Available Packages
==================

   Languages are not equally supported in all packages.  The following
matrix shows the current state of internationalization, as of August
2002.  The matrix shows, in regard of each package, for which languages
PO files have been submitted to translation coordination, with a
translation percentage of at least 50%.

     Ready PO files    be bg ca cs da de el en eo es et fi fr
                     +----------------------------------------+
     a2ps            |             [] []             []    [] |
     ap-utils        |                                        |
     bash            |                []       [] []       [] |
     bfd             |                            []       [] |
     binutils        |                            []       [] |
     bison           |                []          [] []    [] |
     clisp           |                                        |
     clisp           |                []    []    []       [] |
     clisplow        |                                        |
     cpio            |             [] []          []       [] |
     darkstat        |             ()                         |
     diffutils       |          [] [] []       [] []       [] |
     enscript        |                []                   [] |
     error           |                []          []       [] |
     fetchmail       |       [] () [] []          []       () |
     fileutils       |             [] []          [] []    [] |
     findutils       |             [] []       [] [] []    [] |
     flex            |       []    [] []          []       [] |
     gas             |                            []       [] |
     gawk            |                []          []       [] |
     gcal            |       []                            [] |
     gcc             |                            []       [] |
     gettext         |       []    [] []          []       [] |
     gnupg           |       []       [] []    [] [] []    [] |
     gprof           |                            []       [] |
     gpsdrive        |             () ()    ()    ()       () |
     grep            |    [] []       [] []       [] [] [] [] |
     gretl           |                            []          |
     gthumb          |                ()          ()       () |
     hello           |       []    [] [] []    [] [] [] [] [] |
     id-utils        |             [] []                   [] |
     indent          |       []       []       []    []    [] |
     jpilot          |          () [] []                   [] |
     jwhois          |                            []       [] |
     kbd             |                []          []       [] |
     ld              |                            []       [] |
     libc            |       [] [] [] [] []       []    [] [] |
     libiconv        |       []       []       [] []          |
     lifelines       |                ()                   () |
     lilypond        |             []                      [] |
     lingoteach      |                         []          [] |
     lingoteach_lessons|                ()          ()          |
     lynx            |       [] [] [] []             []       |
     m4              |          [] [] [] []                [] |
     make            |             [] []          []       [] |
     man-db          |       [] () () []          ()       () |
     mysecretdiary   |                []          []       [] |
     nano            |       [] () [] []          []       [] |
     nano_1_0        |       [] () [] []          []       [] |
     opcodes         |             []             []       [] |
     parted          |       []    [] []          []       [] |
     ptx             |             [] []       [] [] [] [] [] |
     python          |                                        |
     recode          |             [] [] []    [] []       [] |
     sed             |       [] [] [] [] []    [] [] [] [] [] |
     sh-utils        |                []          [] []    [] |
     sharutils       |          [] [] [] []       [] []    [] |
     sketch          |                ()          []       () |
     soundtracker    |                []          []       [] |
     sp              |                []                      |
     tar             |          [] [] []          [] []    [] |
     texinfo         |          [] [] []       []          [] |
     textutils       |       []    [] []          []       [] |
     util-linux      |          [] [] []          [] []    [] |
     vorbis-tools    |                                     [] |
     wastesedge      |                                        |
     wdiff           |       []    [] []          [] []    [] |
     wget            |    [] [] [] [] [] []       [] [] [] [] |
                     +----------------------------------------+
                       be bg ca cs da de el en eo es et fi fr
                        0  2 19 10 30 44  9  1 12 44 17  6 53
     
                       gl he hr hu id it ja ko lv nb nl nn
                     +-------------------------------------+
     a2ps            |                ()    ()       []    |
     ap-utils        |                                     |
     bash            |          []                         |
     bfd             |                   []                |
     binutils        |                   []                |
     bison           |       []       [] []          []    |
     clisp           |                                     |
     clisp           |                               []    |
     clisplow        |                                     |
     cpio            | []       []          []       []    |
     darkstat        |                                     |
     diffutils       | [] []    [] []    []                |
     enscript        |       []                      []    |
     error           |          []                         |
     fetchmail       |                   []                |
     fileutils       |          []    [] []                |
     findutils       | []    [] [] [] [] [] []       []    |
     flex            |                      []             |
     gas             |                                     |
     gawk            |    []                               |
     gcal            |                                     |
     gcc             |                   []                |
     gettext         |                   [] []             |
     gnupg           | []          [] [] []                |
     gprof           |             []                      |
     gpsdrive        |          []    ()             ()    |
     grep            | [] [] [] [] [] [] []                |
     gretl           |                                     |
     gthumb          |                () ()                |
     hello           | [] [] [] [] [] [] [] [] [] [] [] [] |
     id-utils        |          []                   []    |
     indent          | []       []       []          []    |
     jpilot          |                   ()          ()    |
     jwhois          |          [] []                      |
     kbd             |                                     |
     ld              |                                     |
     libc            | []                [] []    []       |
     libiconv        | []    [] []                         |
     lifelines       |                                     |
     lilypond        |                               []    |
     lingoteach      |          []                         |
     lingoteach_lessons|                                     |
     lynx            |          []    [] []          []    |
     m4              | []          []    []          []    |
     make            | [] [] []          [] []       []    |
     man-db          |                () ()                |
     mysecretdiary   |             []                      |
     nano            | []          [] []             []    |
     nano_1_0        | []          [] []          []    [] |
     opcodes         |             []                []    |
     parted          | []                []             [] |
     ptx             | []       [] []             [] []    |
     python          |                                     |
     recode          | [] []          []                   |
     sed             | [] [] []    [] [] [] []       []    |
     sh-utils        |                [] []       []       |
     sharutils       | []                []          []    |
     sketch          |                ()                   |
     soundtracker    | []    []                            |
     sp              |                                     |
     tar             | []    []    [] [] []       []       |
     texinfo         |    [] []          []                |
     textutils       | []                [] []    []       |
     util-linux      |                () []                |
     vorbis-tools    |          []                         |
     wastesedge      |                                     |
     wdiff           | []       [] []                      |
     wget            | [] [] [] []       []          []    |
                     +-------------------------------------+
                       gl he hr hu id it ja ko lv nb nl nn
                       23  9 12 19 16 13 26  9  1  7 19  3
     
                       no pl pt pt_BR ru sk sl sv tr uk zh_CN zh_TW
                     +----------------------------------------------+
     a2ps            | () () ()  []   []    [] [] []                | 10
     ap-utils        |                               ()             |  0
     bash            |           []                                 |  6
     bfd             |                         [] []                |  5
     binutils        |                         [] []                |  5
     bison           |           []   []       [] []                | 12
     clisp           |                                              |  0
     clisp           |                                              |  5
     clisplow        |                                              |  0
     cpio            |    []     []   []       []                   | 12
     darkstat        |           []            []        ()    ()   |  2
     diffutils       |    []     []   []       [] []           []   | 17
     enscript        |           []   []       [] []                |  8
     error           |                   []       []           []   |  7
     fetchmail       |    ()     ()               []                |  6
     fileutils       |                []    [] [] []     []    []   | 14
     findutils       |    []     []   [] [] [] [] []                | 21
     flex            |                []       [] []                |  9
     gas             |                            []                |  3
     gawk            |                         [] []                |  6
     gcal            |                         [] []                |  4
     gcc             |                            []                |  4
     gettext         |                [] [] [] [] []           []   | 13
     gnupg           |    []                   [] []                | 14
     gprof           |                         [] []                |  5
     gpsdrive        |                   []    []                   |  3
     grep            |    []     []   []    []    []                | 20
     gretl           |                                              |  1
     gthumb          |           ()   ()       []                   |  1
     hello           | [] []          [] []    [] [] []             | 28
     id-utils        |           []   []       [] []                |  9
     indent          |           []   [] []    [] []                | 14
     jpilot          | ()                      () []           []   |  5
     jwhois          |           []   ()       () []           []   |  7
     kbd             |                         [] []                |  5
     ld              |                         [] []                |  4
     libc            | [] []     []      []    [] []                | 18
     libiconv        |           []   [] []    [] []                | 12
     lifelines       |                         []                   |  1
     lilypond        |                         []                   |  4
     lingoteach      |           []            []                   |  5
     lingoteach_lessons|                                   ()         |  0
     lynx            |           []   []       [] []                | 13
     m4              |    []     []   []       []                   | 13
     make            |    []     []   []       [] []                | 15
     man-db          |                                              |  3
     mysecretdiary   |           []            [] []                |  7
     nano            |    []          []       []    []             | 13
     nano_1_0        |    []          []       []    []             | 14
     opcodes         |           []            [] []                |  8
     parted          |       []  []            [] []                | 12
     ptx             | [] [] []  []   []       [] []                | 19
     python          |                                              |  0
     recode          |    []     []   []    [] [] []                | 15
     sed             |           []   [] [] [] [] []                | 24
     sh-utils        |                []          []                |  9
     sharutils       |                []       [] []           []   | 14
     sketch          |           []   ()       []                   |  4
     soundtracker    |                         []                   |  6
     sp              |                                              |  1
     tar             | [] []     []      [] [] [] []                | 19
     texinfo         |                []       []                   | 10
     textutils       |                []    [] [] []           []   | 14
     util-linux      |           []            [] []                | 10
     vorbis-tools    |                         []                   |  3
     wastesedge      |                                              |  0
     wdiff           |           []   [] []    [] []                | 14
     wget            |    []          [] [] [] [] [] []        []   | 24
                     +----------------------------------------------+
       37 teams        no pl pt pt_BR ru sk sl sv tr uk zh_CN zh_TW
       68 domains       4 15  2  28   28 12 10 49 43  4   1     9    609

   Some counters in the preceding matrix are higher than the number of
visible blocks let us expect.  This is because a few extra PO files are
used for implementing regional variants of languages, or language
dialects.

   For a PO file in the matrix above to be effective, the package to
which it applies should also have been internationalized and
distributed as such by its maintainer.  There might be an observable
lag between the mere existence a PO file and its wide availability in a
distribution.

   If August 2002 seems to be old, you may fetch a more recent copy of
this `ABOUT-NLS' file on most GNU archive sites.  The most up-to-date
matrix with full percentage details can be found at
`http://www.iro.umontreal.ca/contrib/po/HTML/matrix.html'.

Using `gettext' in new packages
===============================

   If you are writing a freely available program and want to
internationalize it you are welcome to use GNU `gettext' in your
package.  Of course you have to respect the GNU Library General Public
License which covers the use of the GNU `gettext' library.  This means
in particular that even non-free programs can use `libintl' as a shared
library, whereas only free software can use `libintl' as a static
library or use modified versions of `libintl'.

   Once the sources are changed appropriately and the setup can handle
to use of `gettext' the only thing missing are the translations.  The
Free Translation Project is also available for packages which are not
developed inside the GNU project.  Therefore the information given above
applies also for every other Free Software Project.  Contact
`translation@iro.umontreal.ca' to make the `.pot' files available to
the translation teams.
Commit	Line	Data
e435507f TT	1	Notes on the Free Translation Project
	2	*************************************
	3
	4	Free software is going international! The Free Translation Project
	5	is a way to get maintainers of free software, translators, and users all
	6	together, so that will gradually become able to speak many languages.
	7	A few packages already provide translations for their messages.
	8
	9	If you found this `ABOUT-NLS' file inside a distribution, you may
	10	assume that the distributed package does use GNU `gettext' internally,
a04eba3f	11	itself available at your nearest GNU archive site. But you do _not_
e435507f TT	12	need to install GNU `gettext' prior to configuring, installing or using
	13	this package with messages translated.
	14
	15	Installers will find here some useful hints. These notes also
	16	explain how users should proceed for getting the programs to use the
	17	available translations. They tell how people wanting to contribute and
	18	work at translations should contact the appropriate team.
	19
	20	When reporting bugs in the `intl/' directory or bugs which may be
	21	related to internationalization, you should tell about the version of
	22	`gettext' which is used. The information can be found in the
	23	`intl/VERSION' file, in internationalized packages.
	24
a04eba3f TT	25	Quick configuration advice
a04eba3f TT	26	==========================
e435507f TT	27
	28	If you want to exploit the full power of internationalization, you
	29	should configure it using
	30
	31	./configure --with-included-gettext
	32
	33	to force usage of internationalizing routines provided within this
	34	package, despite the existence of internationalizing capabilities in the
	35	operating system where this package is being installed. So far, only
	36	the `gettext' implementation in the GNU C library version 2 provides as
a04eba3f TT	37	many features (such as locale alias, message inheritance, automatic
	38	charset conversion or plural form handling) as the implementation here.
	39	It is also not possible to offer this additional functionality on top
	40	of a `catgets' implementation. Future versions of GNU `gettext' will
	41	very likely convey even more functionality. So it might be a good idea
	42	to change to GNU `gettext' as soon as possible.
	43
	44	So you need _not_ provide this option if you are using GNU libc 2 or
e435507f TT	45	you have installed a recent copy of the GNU gettext package with the
	46	included `libintl'.
	47
	48	INSTALL Matters
	49	===============
	50
	51	Some packages are "localizable" when properly installed; the
	52	programs they contain can be made to speak your own native language.
	53	Most such packages use GNU `gettext'. Other packages have their own
	54	ways to internationalization, predating GNU `gettext'.
	55
	56	By default, this package will be installed to allow translation of
a04eba3f TT	57	messages. It will automatically detect whether the system already
a04eba3f TT	58	provides the GNU `gettext' functions. If not, the GNU `gettext' own
e435507f TT	59	library will be used. This library is wholly contained within this
e435507f TT	60	package, usually in the `intl/' subdirectory, so prior installation of
a04eba3f	61	the GNU `gettext' package is _not_ required. Installers may use
e435507f TT	62	special options at configuration time for changing the default
	63	behaviour. The commands:
	64
	65	./configure --with-included-gettext
e435507f TT	66	./configure --disable-nls
e435507f TT	67
a04eba3f TT	68	will respectively bypass any pre-existing `gettext' to use the
	69	internationalizing routines provided within this package, or else,
	70	_totally_ disable translation of messages.
e435507f TT	71
	72	When you already have GNU `gettext' installed on your system and run
	73	configure without an option for your new package, `configure' will
	74	probably detect the previously built and installed `libintl.a' file and
	75	will decide to use this. This might be not what is desirable. You
	76	should use the more recent version of the GNU `gettext' library. I.e.
	77	if the file `intl/VERSION' shows that the library which comes with this
	78	package is more recent, you should use
	79
	80	./configure --with-included-gettext
	81
	82	to prevent auto-detection.
	83
a04eba3f TT	84	The configuration process will not test for the `catgets' function
	85	and therefore it will not be used. The reason is that even an
	86	emulation of `gettext' on top of `catgets' could not provide all the
	87	extensions of the GNU `gettext' library.
e435507f TT	88
	89	Internationalized packages have usually many `po/LL.po' files, where
	90	LL gives an ISO 639 two-letter code identifying the language. Unless
	91	translations have been forbidden at `configure' time by using the
	92	`--disable-nls' switch, all available translations are installed
	93	together with the package. However, the environment variable `LINGUAS'
	94	may be set, prior to configuration, to limit the installed set.
	95	`LINGUAS' should then contain a space separated list of two-letter
	96	codes, stating which languages are allowed.
	97
	98	Using This Package
	99	==================
	100
	101	As a user, if your language has been installed for this package, you
	102	only have to set the `LANG' environment variable to the appropriate
a04eba3f TT	103	`LL_CC' combination. Here `LL' is an ISO 639 two-letter language code,
	104	and `CC' is an ISO 3166 two-letter country code. For example, let's
	105	suppose that you speak German and live in Germany. At the shell
	106	prompt, merely execute `setenv LANG de_DE' (in `csh'),
	107	`export LANG; LANG=de_DE' (in `sh') or `export LANG=de_DE' (in `bash').
	108	This can be done from your `.login' or `.profile' file, once and for
	109	all.
	110
	111	You might think that the country code specification is redundant.
	112	But in fact, some languages have dialects in different countries. For
	113	example, `de_AT' is used for Austria, and `pt_BR' for Brazil. The
	114	country code serves to distinguish the dialects.
	115
	116	The locale naming convention of `LL_CC', with `LL' denoting the
	117	language and `CC' denoting the country, is the one use on systems based
	118	on GNU libc. On other systems, some variations of this scheme are
	119	used, such as `LL' or `LL_CC.ENCODING'. You can get the list of
	120	locales supported by your system for your country by running the command
	121	`locale -a \| grep '^LL''.
	122
	123	Not all programs have translations for all languages. By default, an
	124	English message is shown in place of a nonexistent translation. If you
	125	understand other languages, you can set up a priority list of languages.
	126	This is done through a different environment variable, called
	127	`LANGUAGE'. GNU `gettext' gives preference to `LANGUAGE' over `LANG'
	128	for the purpose of message handling, but you still need to have `LANG'
	129	set to the primary language; this is required by other parts of the
	130	system libraries. For example, some Swedish users who would rather
	131	read translations in German than English for when Swedish is not
	132	available, set `LANGUAGE' to `sv:de' while leaving `LANG' to `sv_SE'.
	133
	134	In the `LANGUAGE' environment variable, but not in the `LANG'
	135	environment variable, `LL_CC' combinations can be abbreviated as `LL'
	136	to denote the language's main dialect. For example, `de' is equivalent
	137	to `de_DE' (German as spoken in Germany), and `pt' to `pt_PT'
	138	(Portuguese as spoken in Portugal) in this context.
e435507f TT	139
	140	Translating Teams
	141	=================
	142
	143	For the Free Translation Project to be a success, we need interested
	144	people who like their own language and write it well, and who are also
	145	able to synergize with other translators speaking the same language.
a04eba3f TT	146	Each translation team has its own mailing list. The up-to-date list of
	147	teams can be found at the Free Translation Project's homepage,
	148	`http://www.iro.umontreal.ca/contrib/po/HTML/', in the "National teams"
	149	area.
	150
	151	If you'd like to volunteer to _work_ at translating messages, you
e435507f	152	should become a member of the translating team for your own language.
a04eba3f	153	The subscribing address is _not_ the same as the list itself, it has
e435507f TT	154	`-request' appended. For example, speakers of Swedish can send a
	155	message to `sv-request@li.org', having this message body:
	156
	157	subscribe
	158
	159	Keep in mind that team members are expected to participate
a04eba3f	160	_actively_ in translations, or at solving translational difficulties,
e435507f TT	161	rather than merely lurking around. If your team does not exist yet and
	162	you want to start one, or if you are unsure about what to do or how to
	163	get started, please write to `translation@iro.umontreal.ca' to reach the
	164	coordinator for all translator teams.
	165
	166	The English team is special. It works at improving and uniformizing
	167	the terminology in use. Proven linguistic skill are praised more than
	168	programming skill, here.
	169
	170	Available Packages
	171	==================
	172
	173	Languages are not equally supported in all packages. The following
	174	matrix shows the current state of internationalization, as of August
a04eba3f TT	175	2002. The matrix shows, in regard of each package, for which languages
	176	PO files have been submitted to translation coordination, with a
	177	translation percentage of at least 50%.
	178
	179	Ready PO files be bg ca cs da de el en eo es et fi fr
	180	+----------------------------------------+
	181	a2ps \| [] [] [] [] \|
	182	ap-utils \| \|
	183	bash \| [] [] [] [] \|
	184	bfd \| [] [] \|
	185	binutils \| [] [] \|
	186	bison \| [] [] [] [] \|
	187	clisp \| \|
	188	clisp \| [] [] [] [] \|
	189	clisplow \| \|
	190	cpio \| [] [] [] [] \|
	191	darkstat \| () \|
	192	diffutils \| [] [] [] [] [] [] \|
	193	enscript \| [] [] \|
	194	error \| [] [] [] \|
	195	fetchmail \| [] () [] [] [] () \|
	196	fileutils \| [] [] [] [] [] \|
	197	findutils \| [] [] [] [] [] [] \|
	198	flex \| [] [] [] [] [] \|
	199	gas \| [] [] \|
	200	gawk \| [] [] [] \|
	201	gcal \| [] [] \|
	202	gcc \| [] [] \|
	203	gettext \| [] [] [] [] [] \|
	204	gnupg \| [] [] [] [] [] [] [] \|
	205	gprof \| [] [] \|
	206	gpsdrive \| () () () () () \|
	207	grep \| [] [] [] [] [] [] [] [] \|
	208	gretl \| [] \|
	209	gthumb \| () () () \|
	210	hello \| [] [] [] [] [] [] [] [] [] \|
	211	id-utils \| [] [] [] \|
	212	indent \| [] [] [] [] [] \|
	213	jpilot \| () [] [] [] \|
	214	jwhois \| [] [] \|
	215	kbd \| [] [] [] \|
	216	ld \| [] [] \|
	217	libc \| [] [] [] [] [] [] [] [] \|
	218	libiconv \| [] [] [] [] \|
	219	lifelines \| () () \|
	220	lilypond \| [] [] \|
	221	lingoteach \| [] [] \|
	222	lingoteach_lessons\| () () \|
	223	lynx \| [] [] [] [] [] \|
	224	m4 \| [] [] [] [] [] \|
	225	make \| [] [] [] [] \|
	226	man-db \| [] () () [] () () \|
	227	mysecretdiary \| [] [] [] \|
	228	nano \| [] () [] [] [] [] \|
	229	nano_1_0 \| [] () [] [] [] [] \|
	230	opcodes \| [] [] [] \|
	231	parted \| [] [] [] [] [] \|
	232	ptx \| [] [] [] [] [] [] [] \|
	233	python \| \|
	234	recode \| [] [] [] [] [] [] \|
	235	sed \| [] [] [] [] [] [] [] [] [] [] \|
	236	sh-utils \| [] [] [] [] \|
	237	sharutils \| [] [] [] [] [] [] [] \|
	238	sketch \| () [] () \|
239	soundtracker \| [] [] [] \|
240	sp \| [] \|
241	tar \| [] [] [] [] [] [] \|
242	texinfo \| [] [] [] [] [] \|
243	textutils \| [] [] [] [] [] \|
244	util-linux \| [] [] [] [] [] [] \|
245	vorbis-tools \| [] \|
246	wastesedge \| \|
247	wdiff \| [] [] [] [] [] [] \|
248	wget \| [] [] [] [] [] [] [] [] [] [] \|
249	+----------------------------------------+
250	be bg ca cs da de el en eo es et fi fr
251	0 2 19 10 30 44 9 1 12 44 17 6 53
252
253	gl he hr hu id it ja ko lv nb nl nn
254	+-------------------------------------+
255	a2ps \| () () [] \|
256	ap-utils \| \|
257	bash \| [] \|
258	bfd \| [] \|
259	binutils \| [] \|
260	bison \| [] [] [] [] \|
261	clisp \| \|
262	clisp \| [] \|
263	clisplow \| \|
264	cpio \| [] [] [] [] \|
265	darkstat \| \|
266	diffutils \| [] [] [] [] [] \|
267	enscript \| [] [] \|
268	error \| [] \|
269	fetchmail \| [] \|
270	fileutils \| [] [] [] \|
271	findutils \| [] [] [] [] [] [] [] [] \|
272	flex \| [] \|
273	gas \| \|
274	gawk \| [] \|
275	gcal \| \|
276	gcc \| [] \|
277	gettext \| [] [] \|
278	gnupg \| [] [] [] [] \|
279	gprof \| [] \|
280	gpsdrive \| [] () () \|
281	grep \| [] [] [] [] [] [] [] \|
282	gretl \| \|
283	gthumb \| () () \|
284	hello \| [] [] [] [] [] [] [] [] [] [] [] [] \|
285	id-utils \| [] [] \|
286	indent \| [] [] [] [] \|
287	jpilot \| () () \|
288	jwhois \| [] [] \|
289	kbd \| \|
290	ld \| \|
291	libc \| [] [] [] [] \|
292	libiconv \| [] [] [] \|
293	lifelines \| \|
294	lilypond \| [] \|
295	lingoteach \| [] \|
296	lingoteach_lessons\| \|
297	lynx \| [] [] [] [] \|
298	m4 \| [] [] [] [] \|
299	make \| [] [] [] [] [] [] \|
300	man-db \| () () \|
301	mysecretdiary \| [] \|
302	nano \| [] [] [] [] \|
303	nano_1_0 \| [] [] [] [] [] \|
304	opcodes \| [] [] \|
305	parted \| [] [] [] \|
306	ptx \| [] [] [] [] [] \|
307	python \| \|
308	recode \| [] [] [] \|
309	sed \| [] [] [] [] [] [] [] [] \|
310	sh-utils \| [] [] [] \|
311	sharutils \| [] [] [] \|
312	sketch \| () \|
313	soundtracker \| [] [] \|
314	sp \| \|
315	tar \| [] [] [] [] [] [] \|
316	texinfo \| [] [] [] \|
317	textutils \| [] [] [] [] \|
318	util-linux \| () [] \|
319	vorbis-tools \| [] \|
320	wastesedge \| \|
321	wdiff \| [] [] [] \|
322	wget \| [] [] [] [] [] [] \|
323	+-------------------------------------+
324	gl he hr hu id it ja ko lv nb nl nn
325	23 9 12 19 16 13 26 9 1 7 19 3
e435507f	326
a04eba3f TT	327	no pl pt pt_BR ru sk sl sv tr uk zh_CN zh_TW
	328	+----------------------------------------------+
	329	a2ps \| () () () [] [] [] [] [] \| 10
	330	ap-utils \| () \| 0
	331	bash \| [] \| 6
	332	bfd \| [] [] \| 5
	333	binutils \| [] [] \| 5
	334	bison \| [] [] [] [] \| 12
	335	clisp \| \| 0
	336	clisp \| \| 5
	337	clisplow \| \| 0
	338	cpio \| [] [] [] [] \| 12
	339	darkstat \| [] [] () () \| 2
	340	diffutils \| [] [] [] [] [] [] \| 17
	341	enscript \| [] [] [] [] \| 8
	342	error \| [] [] [] \| 7
	343	fetchmail \| () () [] \| 6
	344	fileutils \| [] [] [] [] [] [] \| 14
	345	findutils \| [] [] [] [] [] [] [] \| 21
	346	flex \| [] [] [] \| 9
	347	gas \| [] \| 3
	348	gawk \| [] [] \| 6
	349	gcal \| [] [] \| 4
	350	gcc \| [] \| 4
	351	gettext \| [] [] [] [] [] [] \| 13
	352	gnupg \| [] [] [] \| 14
	353	gprof \| [] [] \| 5
	354	gpsdrive \| [] [] \| 3
	355	grep \| [] [] [] [] [] \| 20
	356	gretl \| \| 1
	357	gthumb \| () () [] \| 1
	358	hello \| [] [] [] [] [] [] [] \| 28
	359	id-utils \| [] [] [] [] \| 9
	360	indent \| [] [] [] [] [] \| 14
	361	jpilot \| () () [] [] \| 5
	362	jwhois \| [] () () [] [] \| 7
	363	kbd \| [] [] \| 5
	364	ld \| [] [] \| 4
	365	libc \| [] [] [] [] [] [] \| 18
	366	libiconv \| [] [] [] [] [] \| 12
	367	lifelines \| [] \| 1
	368	lilypond \| [] \| 4
	369	lingoteach \| [] [] \| 5
	370	lingoteach_lessons\| () \| 0
	371	lynx \| [] [] [] [] \| 13
	372	m4 \| [] [] [] [] \| 13
	373	make \| [] [] [] [] [] \| 15
	374	man-db \| \| 3
	375	mysecretdiary \| [] [] [] \| 7
	376	nano \| [] [] [] [] \| 13
	377	nano_1_0 \| [] [] [] [] \| 14
	378	opcodes \| [] [] [] \| 8
	379	parted \| [] [] [] [] \| 12
	380	ptx \| [] [] [] [] [] [] [] \| 19
	381	python \| \| 0
	382	recode \| [] [] [] [] [] [] \| 15
	383	sed \| [] [] [] [] [] [] \| 24
	384	sh-utils \| [] [] \| 9
	385	sharutils \| [] [] [] [] \| 14
	386	sketch \| [] () [] \| 4
	387	soundtracker \| [] \| 6
	388	sp \| \| 1
	389	tar \| [] [] [] [] [] [] [] \| 19
	390	texinfo \| [] [] \| 10
391	textutils \| [] [] [] [] [] \| 14
392	util-linux \| [] [] [] \| 10
393	vorbis-tools \| [] \| 3
394	wastesedge \| \| 0
395	wdiff \| [] [] [] [] [] \| 14
396	wget \| [] [] [] [] [] [] [] [] \| 24
397	+----------------------------------------------+
398	37 teams no pl pt pt_BR ru sk sl sv tr uk zh_CN zh_TW
399	68 domains 4 15 2 28 28 12 10 49 43 4 1 9 609
e435507f TT	400
	401	Some counters in the preceding matrix are higher than the number of
	402	visible blocks let us expect. This is because a few extra PO files are
	403	used for implementing regional variants of languages, or language
	404	dialects.
	405
	406	For a PO file in the matrix above to be effective, the package to
	407	which it applies should also have been internationalized and
	408	distributed as such by its maintainer. There might be an observable
	409	lag between the mere existence a PO file and its wide availability in a
	410	distribution.
	411
a04eba3f TT	412	If August 2002 seems to be old, you may fetch a more recent copy of
	413	this `ABOUT-NLS' file on most GNU archive sites. The most up-to-date
	414	matrix with full percentage details can be found at
	415	`http://www.iro.umontreal.ca/contrib/po/HTML/matrix.html'.
e435507f TT	416
	417	Using `gettext' in new packages
	418	===============================
	419
	420	If you are writing a freely available program and want to
	421	internationalize it you are welcome to use GNU `gettext' in your
a04eba3f TT	422	package. Of course you have to respect the GNU Library General Public
	423	License which covers the use of the GNU `gettext' library. This means
	424	in particular that even non-free programs can use `libintl' as a shared
	425	library, whereas only free software can use `libintl' as a static
	426	library or use modified versions of `libintl'.
	427
	428	Once the sources are changed appropriately and the setup can handle
	429	to use of `gettext' the only thing missing are the translations. The
	430	Free Translation Project is also available for packages which are not
e435507f TT	431	developed inside the GNU project. Therefore the information given above
	432	applies also for every other Free Software Project. Contact
	433	`translation@iro.umontreal.ca' to make the `.pot' files available to
	434	the translation teams.
	435