root/lyx-devel/trunk/ABOUT-NLS

Revision 25208, 77.7 kB (checked in by lasgouttes, 7 months ago)

put the 0.16.1 code from gettext back

Line 
1 1 Notes on the Free Translation Project
2 ***************************************
3
4 Free software is going international!  The Free Translation Project is
5 a way to get maintainers of free software, translators, and users all
6 together, so that free software will gradually become able to speak many
7 languages.  A few packages already provide translations for their
8 messages.
9
10    If you found this `ABOUT-NLS' file inside a distribution, you may
11 assume that the distributed package does use GNU `gettext' internally,
12 itself available at your nearest GNU archive site.  But you do _not_
13 need to install GNU `gettext' prior to configuring, installing or using
14 this package with messages translated.
15
16    Installers will find here some useful hints.  These notes also
17 explain how users should proceed for getting the programs to use the
18 available translations.  They tell how people wanting to contribute and
19 work on translations can contact the appropriate team.
20
21    When reporting bugs in the `intl/' directory or bugs which may be
22 related to internationalization, you should tell about the version of
23 `gettext' which is used.  The information can be found in the
24 `intl/VERSION' file, in internationalized packages.
25
26 1.1 Quick configuration advice
27 ==============================
28
29 If you want to exploit the full power of internationalization, you
30 should configure it using
31
32      ./configure --with-included-gettext
33
34 to force usage of internationalizing routines provided within this
35 package, despite the existence of internationalizing capabilities in the
36 operating system where this package is being installed.  So far, only
37 the `gettext' implementation in the GNU C library version 2 provides as
38 many features (such as locale alias, message inheritance, automatic
39 charset conversion or plural form handling) as the implementation here.
40 It is also not possible to offer this additional functionality on top
41 of a `catgets' implementation.  Future versions of GNU `gettext' will
42 very likely convey even more functionality.  So it might be a good idea
43 to change to GNU `gettext' as soon as possible.
44
45    So you need _not_ provide this option if you are using GNU libc 2 or
46 you have installed a recent copy of the GNU gettext package with the
47 included `libintl'.
48
49 1.2 INSTALL Matters
50 ===================
51
52 Some packages are "localizable" when properly installed; the programs
53 they contain can be made to speak your own native language.  Most such
54 packages use GNU `gettext'.  Other packages have their own ways to
55 internationalization, predating GNU `gettext'.
56
57    By default, this package will be installed to allow translation of
58 messages.  It will automatically detect whether the system already
59 provides the GNU `gettext' functions.  If not, the included GNU
60 `gettext' library will be used.  This library is wholly contained
61 within this package, usually in the `intl/' subdirectory, so prior
62 installation of the GNU `gettext' package is _not_ required.
63 Installers may use special options at configuration time for changing
64 the default behaviour.  The commands:
65
66      ./configure --with-included-gettext
67      ./configure --disable-nls
68
69 will, respectively, bypass any pre-existing `gettext' to use the
70 internationalizing routines provided within this package, or else,
71 _totally_ disable translation of messages.
72
73    When you already have GNU `gettext' installed on your system and run
74 configure without an option for your new package, `configure' will
75 probably detect the previously built and installed `libintl.a' file and
76 will decide to use this.  This might not be desirable.  You should use
77 the more recent version of the GNU `gettext' library.  I.e. if the file
78 `intl/VERSION' shows that the library which comes with this package is
79 more recent, you should use
80
81      ./configure --with-included-gettext
82
83 to prevent auto-detection.
84
85    The configuration process will not test for the `catgets' function
86 and therefore it will not be used.  The reason is that even an
87 emulation of `gettext' on top of `catgets' could not provide all the
88 extensions of the GNU `gettext' library.
89
90    Internationalized packages usually have many `po/LL.po' files, where
91 LL gives an ISO 639 two-letter code identifying the language.  Unless
92 translations have been forbidden at `configure' time by using the
93 `--disable-nls' switch, all available translations are installed
94 together with the package.  However, the environment variable `LINGUAS'
95 may be set, prior to configuration, to limit the installed set.
96 `LINGUAS' should then contain a space separated list of two-letter
97 codes, stating which languages are allowed.
98
99 1.3 Using This Package
100 ======================
101
102 As a user, if your language has been installed for this package, you
103 only have to set the `LANG' environment variable to the appropriate
104 `LL_CC' combination.  Here `LL' is an ISO 639 two-letter language code,
105 and `CC' is an ISO 3166 two-letter country code.  For example, let's
106 suppose that you speak German and live in Germany.  At the shell
107 prompt, merely execute `setenv LANG de_DE' (in `csh'),
108 `export LANG; LANG=de_DE' (in `sh') or `export LANG=de_DE' (in `bash').
109 This can be done from your `.login' or `.profile' file, once and for
110 all.
111
112    You might think that the country code specification is redundant.
113 But in fact, some languages have dialects in different countries.  For
114 example, `de_AT' is used for Austria, and `pt_BR' for Brazil.  The
115 country code serves to distinguish the dialects.
116
117    The locale naming convention of `LL_CC', with `LL' denoting the
118 language and `CC' denoting the country, is the one use on systems based
119 on GNU libc.  On other systems, some variations of this scheme are
120 used, such as `LL' or `LL_CC.ENCODING'.  You can get the list of
121 locales supported by your system for your language by running the
122 command `locale -a | grep '^LL''.
123
124    Not all programs have translations for all languages.  By default, an
125 English message is shown in place of a nonexistent translation.  If you
126 understand other languages, you can set up a priority list of languages.
127 This is done through a different environment variable, called
128 `LANGUAGE'.  GNU `gettext' gives preference to `LANGUAGE' over `LANG'
129 for the purpose of message handling, but you still need to have `LANG'
130 set to the primary language; this is required by other parts of the
131 system libraries.  For example, some Swedish users who would rather
132 read translations in German than English for when Swedish is not
133 available, set `LANGUAGE' to `sv:de' while leaving `LANG' to `sv_SE'.
134
135    Special advice for Norwegian users: The language code for Norwegian
136 bokma*l changed from `no' to `nb' recently (in 2003).  During the
137 transition period, while some message catalogs for this language are
138 installed under `nb' and some older ones under `no', it's recommended
139 for Norwegian users to set `LANGUAGE' to `nb:no' so that both newer and
140 older translations are used.
141
142    In the `LANGUAGE' environment variable, but not in the `LANG'
143 environment variable, `LL_CC' combinations can be abbreviated as `LL'
144 to denote the language's main dialect.  For example, `de' is equivalent
145 to `de_DE' (German as spoken in Germany), and `pt' to `pt_PT'
146 (Portuguese as spoken in Portugal) in this context.
147
148 1.4 Translating Teams
149 =====================
150
151 For the Free Translation Project to be a success, we need interested
152 people who like their own language and write it well, and who are also
153 able to synergize with other translators speaking the same language.
154 Each translation team has its own mailing list.  The up-to-date list of
155 teams can be found at the Free Translation Project's homepage,
156 `http://www.iro.umontreal.ca/contrib/po/HTML/', in the "National teams"
157 area.
158
159    If you'd like to volunteer to _work_ at translating messages, you
160 should become a member of the translating team for your own language.
161 The subscribing address is _not_ the same as the list itself, it has
162 `-request' appended.  For example, speakers of Swedish can send a
163 message to `sv-request@li.org', having this message body:
164
165      subscribe
166
167    Keep in mind that team members are expected to participate
168 _actively_ in translations, or at solving translational difficulties,
169 rather than merely lurking around.  If your team does not exist yet and
170 you want to start one, or if you are unsure about what to do or how to
171 get started, please write to `translation@iro.umontreal.ca' to reach the
172 coordinator for all translator teams.
173
174    The English team is special.  It works at improving and uniformizing
175 the terminology in use.  Proven linguistic skills are praised more than
176 programming skills, here.
177
178 1.5 Available Packages
179 ======================
180
181 Languages are not equally supported in all packages.  The following
182 matrix shows the current state of internationalization, as of October
183 2006.  The matrix shows, in regard of each package, for which languages
184 PO files have been submitted to translation coordination, with a
185 translation percentage of at least 50%.
186
187      Ready PO files       af am ar az be bg bs ca cs cy da de el en en_GB eo
188                         +----------------------------------------------------+
189      GNUnet             |                                  []                |
190      a2ps               |             []                [] [] []     []      |
191      aegis              |                                  ()                |
192      ant-phone          |                                  ()                |
193      anubis             |                                  []                |
194      ap-utils           |                                                    |
195      aspell             |                      [] []    [] []        []      |
196      bash               |                      []          []             [] |
197      batchelor          |                                  []                |
198      bfd                |                                                    |
199      bibshelf           |                                  []                |
200      binutils           |                               []                   |
201      bison              |                               [] []                |
202      bison-runtime      |                                                    |
203      bluez-pin          | []                      []       [] []          [] |
204      cflow              |                               []                   |
205      clisp              |                                  []    []          |
206      console-tools      |                         []       []                |
207      coreutils          |                []    []          []                |
208      cpio               |                                                    |
209      cpplib             |                      []       [] []                |
210      cryptonit          |                                  []                |
211      darkstat           |                []             () []                |
212      dialog             |                      [] [] [] [] [] []             |
213      diffutils          |                      [] []    [] [] []          [] |
214      doodle             |                                  []                |
215      e2fsprogs          |                         []       []                |
216      enscript           |                      []       [] []        []      |
217      error              |                      []       [] []        []      |
218      fetchmail          |                      []       [] () []             |
219      fileutils          |                               [] []                |
220      findutils          |                []    []       []                   |
221      flex               |                      []       [] []                |
222      fslint             |                                  []                |
223      gas                |                                                    |
224      gawk               |                      []       [] []                |
225      gbiff              |                                  []                |
226      gcal               |                      []                            |
227      gcc                |                                  []                |
228      gettext-examples   | []                   []          [] []          [] |
229      gettext-runtime    |             []       []       [] []             [] |
230      gettext-tools      |                      []          []                |
231      gimp-print         |                         []    [] []        []      |
232      gip                |                []                                  |
233      gliv               |                                  []                |
234      glunarclock        |                []                                  |
235      gmult              | []                               []                |
236      gnubiff            |                                  ()                |
237      gnucash            |                                  () ()     []      |
238      gnucash-glossary   |                               [] ()                |
239      gnuedu             |                                                    |
240      gnulib             | []          [] []    []       [] []                |
241      gnunet-gtk         |                                                    |
242      gnutls             |                                                    |
243      gpe-aerial         |                         []       []                |
244      gpe-beam           |                         []       []                |
245      gpe-calendar       |                                                    |
246      gpe-clock          |                         []       []                |
247      gpe-conf           |                         []       []                |
248      gpe-contacts       |                                                    |
249      gpe-edit           |                         []                         |
250      gpe-filemanager    |                                                    |
251      gpe-go             |                         []                         |
252      gpe-login          |                         []       []                |
253      gpe-ownerinfo      |                         []       []                |
254      gpe-package        |                                                    |
255      gpe-sketchbook     |                         []       []                |
256      gpe-su             |                         []       []                |
257      gpe-taskmanager    |                         []       []                |
258      gpe-timesheet      |                         []                         |
259      gpe-today          |                         []       []                |
260      gpe-todo           |                                                    |
261      gphoto2            |                         []    [] []        []      |
262      gprof              |                               [] []                |
263      gpsdrive           |                                  ()    ()          |
264      gramadoir          | []                               []                |
265      grep               | []          [] []    []          [] []             |
266      gretl              |                                                    |
267      gsasl              |                                                    |
268      gss                |                                                    |
269      gst-plugins        | []                   [] []    []                   |
270      gst-plugins-base   |                []    []       []                   |
271      gst-plugins-good   | []       []    []    [] []    []           []      |
272      gstreamer          | []             []    [] []    [] []        []      |
273      gtick              |                                  ()                |
274      gtkam              |                         []    [] []                |
275      gtkorphan          |                []                []                |
276      gtkspell           |             []                   [] []          [] |
277      gutenprint         |                               []                   |
278      hello              |                []    []       [] []             [] |
279      id-utils           |                               [] []                |
280      impost             |                                                    |
281      indent             |                      []          []             [] |
282      iso_3166           |                                  []             [] |
283      iso_3166_2         |                                                    |
284      iso_4217           |                                  []                |
285      iso_639            |                                  []             [] |
286      jpilot             |                         []                         |
287      jtag               |                                                    |
288      jwhois             |                                                    |
289      kbd                |                         []    [] [] []             |
290      keytouch           |                                                    |
291      keytouch-editor    |                                                    |
292      keytouch-keyboa... |                                                    |
293      latrine            |                                  ()                |
294      ld                 |                               []                   |
295      leafpad            |                []    [] []       [] []             |
296      libc               |                      [] []    [] [] []             |
297      libexif            |                                  []                |
298      libextractor       |                                  []                |
299      libgpewidget       |                         []    [] []                |
300      libgpg-error       |                                  []                |
301      libgphoto2         |                               [] []                |
302      libgphoto2_port    |                               [] []                |
303      libgsasl           |                                                    |
304      libiconv           |                                  []             [] |
305      libidn             |                               []                [] |
306      lifelines          |                               [] ()                |
307      lilypond           |                                  []                |
308      lingoteach         |                                                    |
309      lynx               |                      [] []    [] []                |
310      m4                 |                         []    [] [] []             |
311      mailutils          |                      []                            |
312      make               |                               [] []                |
313      man-db             |                      [] ()    [] []                |
314      minicom            |                         []    [] []                |
315      mysecretdiary      |                               [] []                |
316      nano               |                []    []          []                |
317      nano_1_0           |                      [] ()    [] []                |
318      opcodes            |                                  []                |
319      parted             |                                                    |
320      pilot-qof          |                                            []      |
321      psmisc             |                []                                  |
322      pwdutils           |                                                    |
323      python             |                                                    |
324      qof                |                                                    |
325      radius             |                      []                            |
326      recode             |             []       []       [] [] []          [] |
327      rpm                |                         []    []                   |
328      screem             |                                                    |
329      scrollkeeper       |          [] []       [] [] [] [] []        []      |
330      sed                |                      []          []             [] |
331      sh-utils           |                               [] []                |
332      shared-mime-info   |                []       []                 []   [] |
333      sharutils          |                []    [] []    [] [] []             |
334      shishi             |                                                    |
335      silky              |                                                    |
336      skencil            |                               [] ()                |
337      sketch             |                               [] ()                |
338      solfege            |                                                    |
339      soundtracker       |                               [] []                |
340      sp                 |                                  []                |
341      stardict           |                         []                         |
342      system-tools-ba... |       []       [] [] [] []    [] [] []     []      |
343      tar                |                []                                  |
344      texinfo            |                               [] []             [] |
345      textutils          |                      []       [] []                |
346      tin                |                                  ()        ()      |
347      tp-robot           |                                  []                |
348      tuxpaint           | []             []             [] []        []      |
349      unicode-han-tra... |                                                    |
350      unicode-transla... |                                                    |
351      util-linux         |                      [] []    [] []                |
352      vorbis-tools       |             []          []    []           []      |
353      wastesedge         |                                  ()                |
354      wdiff              |                      []       [] []        []      |
355      wget               |                      []          []                |
356      xchat              |             [] []    []          [] []     []      |
357      xkeyboard-config   |                                                    |
358      xpad               |                []             []                   |
359                         +----------------------------------------------------+
360                           af am ar az be bg bs ca cs cy da de el en en_GB eo
361                           10  0  1  2  9 22  1 42 41  2 60 95 16  1  17   16
362
363                           es et eu fa fi fr  ga gl gu he hi hr hu id is it
364                         +--------------------------------------------------+
365      GNUnet             |                                                  |
366      a2ps               |    []       [] []                             () |
367      aegis              |                                                  |
368      ant-phone          |                []                                |
369      anubis             |                []                                |
370      ap-utils           |             [] []                                |
371      aspell             |                []  []                         [] |
372      bash               | []             []                    []          |
373      batchelor          |                []  []                            |
374      bfd                | []                                               |
375      bibshelf           | []                 []                         [] |
376      binutils           | []          [] []                                |
377      bison              | [] []          []  []                   []    [] |
378      bison-runtime      |    []          []  []                   []    [] |
379      bluez-pin          |             [] []  []                [] []       |
380      cflow              |                    []                            |
381      clisp              | []             []                                |
382      console-tools      |                                                  |
383      coreutils          | [] []       [] []  []                []          |
384      cpio               | []             []  []                            |
385      cpplib             | []             []                                |
386      cryptonit          |                []                                |
387      darkstat           | []             ()  []                [] []       |
388      dialog             | [] [] []    [] []  []                []       [] |
389      diffutils          | []          [] []  [] []    []       [] []    [] |
390      doodle             |                    []                         [] |
391      e2fsprogs          | []             []                             [] |
392      enscript           |                []  []             []             |
393      error              | []          [] []  []                []          |
394      fetchmail          | []                                               |
395      fileutils          | [] []          []  []                []       [] |
396      findutils          |    []          []  []                []          |
397      flex               | []             []  []                            |
398      fslint             |                []                                |
399      gas                | []             []                                |
400      gawk               | []             []  []       []                   |
401      gbiff              |                []                                |
402      gcal               | []             []                                |
403      gcc                | []                                               |
404      gettext-examples   | []             []  []                [] []    [] |
405      gettext-runtime    | []          [] []  []                   []    [] |
406      gettext-tools      | []             []                             [] |
407      gimp-print         | []             []                                |
408      gip                | []    []       []                                |
409      gliv               |                ()                                |
410      glunarclock        |             []     []                []          |
411      gmult              |       []       []                             [] |
412      gnubiff            |                ()                             () |
413      gnucash            | ()             ()                    ()          |
414      gnucash-glossary   | []                                            [] |
415      gnuedu             | []                                               |
416      gnulib             | [] [] []    [] []  [] []             []          |
417      gnunet-gtk         |                                                  |
418      gnutls             |                                                  |
419      gpe-aerial         | []             []                                |
420      gpe-beam           | []             []                                |
421      gpe-calendar       |                                                  |
422      gpe-clock          | []          [] []                    []          |
423      gpe-conf           |                []                                |
424      gpe-contacts       | []             []                                |
425      gpe-edit           | []             []                    [] []       |
426      gpe-filemanager    | []                                               |
427      gpe-go             | []             []                    []          |
428      gpe-login          | []             []                    []          |
429      gpe-ownerinfo      | []          [] []                    [] []       |
430      gpe-package        | []                                               |
431      gpe-sketchbook     | []             []                                |
432      gpe-su             | []          [] []                    []          |
433      gpe-taskmanager    | []          [] []                                |
434      gpe-timesheet      | []             []  []                   []       |
435      gpe-today          | []          [] []  []                            |
436      gpe-todo           | []                                               |
437      gphoto2            | []          [] []                    []       [] |
438      gprof              | []             []  []                   []       |
439      gpsdrive           | ()             ()                    []       () |
440      gramadoir          |                []  []                            |
441      grep               | [] [] []    [] []  [] []    []    [] [] []    [] |
442      gretl              | []             []                             [] |
443      gsasl              |                    []                   []       |
444      gss                |                []                                |
445      gst-plugins        |                []                    []       [] |
446      gst-plugins-base   |                                      []       [] |
447      gst-plugins-good   |       []                             []       [] |
448      gstreamer          |             []                       []       [] |
449      gtick              |                    []                            |
450      gtkam              | []             []                    []       [] |
451      gtkorphan          |                []                             [] |
452      gtkspell           | []    []    [] []  []                         [] |
453      gutenprint         |                                      []          |
454      hello              | [] [] [] [] [] []  [] []    []    [] [] []    [] |
455      id-utils           |                []  []                [] []    [] |
456      impost             |                []  []                            |
457      indent             | [] [] []    [] []  [] []             [] []    [] |
458      iso_3166           |             [] []                    []          |
459      iso_3166_2         |                []                                |
460      iso_4217           |    []       []        []             []          |
461      iso_639            |          [] [] []  []                []          |
462      jpilot             | []             []                                |
463      jtag               |                []                                |
464      jwhois             | []             []                    [] []    [] |
465      kbd                | []             []                                |
466      keytouch           |                    []                            |
467      keytouch-editor    |                    []                            |
468      keytouch-keyboa... |                    []                            |
469      latrine            |                []  []                         [] |
470      ld                 | []             []                                |
471      leafpad            | []             []  []       []       []       [] |
472      libc               | []          [] []     []             []          |
473      libexif            | []                                               |
474      libextractor       |                    []                            |
475      libgpewidget       | []             []  []                [] []       |
476      libgpg-error       |                                                  |
477      libgphoto2         | []             []                             [] |
478      libgphoto2_port    |                []                             [] |
479      libgsasl           |                []  []                            |
480      libiconv           |    []              []                            |
481      libidn             |                []                             [] |
482      lifelines          |                ()                                |
483      lilypond           |                []                                |
484      lingoteach         |                []                       []    [] |
485      lynx               |    []                                []       [] |
486      m4                 |                []  [] []                []       |
487      mailutils          | []             []                                |
488      make               | []          [] []  [] []    []    []    []       |
489      man-db             | ()                                               |
490      minicom            | []          [] []                    []          |
491      mysecretdiary      | []             []                       []       |
492      nano               | []    []       []  []                []       [] |
493      nano_1_0           | []             []     []                []    [] |
494      opcodes            | []          [] []  []                            |
495      parted             | []             []                       []    [] |
496      pilot-qof          |                                                  |
497      psmisc             |       []                             []       [] |
498      pwdutils           |                                                  |
499      python             |                                                  |
500      qof                |                                         []       |
501      radius             | []             []                                |
502      recode             | []             []  [] []    []       [] []    [] |
503      rpm                |                []                       []       |
504      screem             |                                                  |
505      scrollkeeper       | []          []                       []          |
506      sed                | [] []          []  []                []          |
507      sh-utils           | [] []       [] []  []                []       [] |
508      shared-mime-info   | []    []    [] []                    []       [] |
509      sharutils          | [] []       [] []  [] []             []       [] |
510      shishi             |                                                  |
511      silky              |                []                                |
512      skencil            | []             []                                |
513      sketch             | []             []                                |
514      solfege            |                                               [] |
515      soundtracker       | []             []                             [] |
516      sp                 |                []                                |
517      stardict           |                                      []          |
518      system-tools-ba... | []    []    [] []                 [] [] []    [] |
519      tar                | [] []       [] []  []                []       [] |
520      texinfo            |                []           []                   |
521      textutils          | []             []  [] []             []          |
522      tin                |    []          ()                                |
523      tp-robot           |             [] []  []                []          |
524      tuxpaint           |                    []                []          |
525      unicode-han-tra... |                                                  |
526      unicode-transla... |                []  []                            |
527      util-linux         | [] []       [] []                    [] []    [] |
528      vorbis-tools       | []             []                                |
529      wastesedge         |                ()                                |
530      wdiff              | [] []          []  [] []             [] []    [] |
531      wget               |    []       [] []  []             [] [] []    [] |
532      xchat              | []    []    [] []        []    []    []       [] |
533      xkeyboard-config   |             [] []                    []       [] |
534      xpad               | []                 []                []          |
535                         +--------------------------------------------------+
536                           es et eu fa fi fr  ga gl gu he hi hr hu id is it
537                           88 22 14  2 40 115 61 14  1  8  1  6 59 31  0 52
538
539                           ja ko ku ky lg lt lv mk mn ms mt nb ne nl nn no
540                         +-------------------------------------------------+
541      GNUnet             |                                                 |
542      a2ps               |    ()                      []          []    () |
543      aegis              |                                        ()       |
544      ant-phone          |                                        []       |
545      anubis             |                            []    []    []       |
546      ap-utils           |                            []                   |
547      aspell             |                         []             []       |
548      bash               |                                        []       |
549      batchelor          |                            []          []       |
550      bfd                |                                                 |