1 --- gettext-0.15/gettext-tools/doc/gettext.texi.orig 2006-06-30 16:25:39.000000000 +0200
2 +++ gettext-0.15/gettext-tools/doc/gettext.texi 2006-07-27 19:02:53.450167750 +0200
7 -@dircategory GNU Gettext Utilities
8 +@dircategory Programming tools:
10 -* gettext: (gettext). GNU gettext utilities.
11 -* autopoint: (gettext)autopoint Invocation. Copy gettext infrastructure.
12 -* envsubst: (gettext)envsubst Invocation. Expand environment variables.
13 -* gettextize: (gettext)gettextize Invocation. Prepare a package for gettext.
14 -* msgattrib: (gettext)msgattrib Invocation. Select part of a PO file.
15 -* msgcat: (gettext)msgcat Invocation. Combine several PO files.
16 -* msgcmp: (gettext)msgcmp Invocation. Compare a PO file and template.
17 -* msgcomm: (gettext)msgcomm Invocation. Match two PO files.
18 -* msgconv: (gettext)msgconv Invocation. Convert PO file to encoding.
19 -* msgen: (gettext)msgen Invocation. Create an English PO file.
20 -* msgexec: (gettext)msgexec Invocation. Process a PO file.
21 -* msgfilter: (gettext)msgfilter Invocation. Pipe a PO file through a filter.
22 -* msgfmt: (gettext)msgfmt Invocation. Make MO files out of PO files.
23 -* msggrep: (gettext)msggrep Invocation. Select part of a PO file.
24 -* msginit: (gettext)msginit Invocation. Create a fresh PO file.
25 -* msgmerge: (gettext)msgmerge Invocation. Update a PO file from template.
26 -* msgunfmt: (gettext)msgunfmt Invocation. Uncompile MO file into PO file.
27 -* msguniq: (gettext)msguniq Invocation. Unify duplicates for PO file.
28 -* ngettext: (gettext)ngettext Invocation. Translate a message with plural.
29 -* xgettext: (gettext)xgettext Invocation. Extract strings into a PO file.
30 -* ISO639: (gettext)Language Codes. ISO 639 language codes.
31 -* ISO3166: (gettext)Country Codes. ISO 3166 country codes.
32 +* gettext: (gettext). GNU gettext utilities
33 +* autopoint: (gettext)autopoint. Copy gettext infrastructure
34 +* envsubst: (gettext)envsubst. Expand environment variables
35 +* gettextize: (gettext)gettextize. Prepare a package for gettext
36 +* msgattrib: (gettext)msgattrib. Select part of a PO file
37 +* msgcat: (gettext)msgcat. Combine several PO files
38 +* msgcmp: (gettext)msgcmp. Compare a PO file and template
39 +* msgcomm: (gettext)msgcomm. Match two PO files
40 +* msgconv: (gettext)msgconv. Convert PO file to encoding
41 +* msgen: (gettext)msgen. Create an English PO file
42 +* msgexec: (gettext)msgexec. Process a PO file
43 +* msgfilter: (gettext)msgfilter. Pipe a PO file through a filter
44 +* msgfmt: (gettext)msgfmt. Make MO files out of PO files
45 +* msggrep: (gettext)msggrep. Select part of a PO file
46 +* msginit: (gettext)msginit. Create a fresh PO file
47 +* msgmerge: (gettext)msgmerge. Update a PO file from template
48 +* msgunfmt: (gettext)msgunfmt. Uncompile MO file into PO file
49 +* msguniq: (gettext)msguniq. Unify duplicates for PO file
50 +* ngettext: (gettext)ngettext. Translate a message with plural
51 +* xgettext: (gettext)xgettext. Extract strings into a PO file
52 +* ISO639: (gettext)Language Codes. ISO 639 language codes
53 +* ISO3166: (gettext)Country Codes. ISO 3166 country codes
59 Making the PO Template File
61 -* xgettext Invocation:: Invoking the @code{xgettext} Program
62 +* xgettext:: Invoking the @code{xgettext} Program
64 Creating a New PO File
66 -* msginit Invocation:: Invoking the @code{msginit} Program
67 +* msginit:: Invoking the @code{msginit} Program
68 * Header Entry:: Filling in the Header Entry
70 Updating Existing PO Files
72 -* msgmerge Invocation:: Invoking the @code{msgmerge} Program
73 +* msgmerge:: Invoking the @code{msgmerge} Program
81 -* msgcat Invocation:: Invoking the @code{msgcat} Program
82 -* msgconv Invocation:: Invoking the @code{msgconv} Program
83 -* msggrep Invocation:: Invoking the @code{msggrep} Program
84 -* msgfilter Invocation:: Invoking the @code{msgfilter} Program
85 -* msguniq Invocation:: Invoking the @code{msguniq} Program
86 -* msgcomm Invocation:: Invoking the @code{msgcomm} Program
87 -* msgcmp Invocation:: Invoking the @code{msgcmp} Program
88 -* msgattrib Invocation:: Invoking the @code{msgattrib} Program
89 -* msgen Invocation:: Invoking the @code{msgen} Program
90 -* msgexec Invocation:: Invoking the @code{msgexec} Program
91 +* msgcat:: Invoking the @code{msgcat} Program
92 +* msgconv:: Invoking the @code{msgconv} Program
93 +* msggrep:: Invoking the @code{msggrep} Program
94 +* msgfilter:: Invoking the @code{msgfilter} Program
95 +* msguniq:: Invoking the @code{msguniq} Program
96 +* msgcomm:: Invoking the @code{msgcomm} Program
97 +* msgcmp:: Invoking the @code{msgcmp} Program
98 +* msgattrib:: Invoking the @code{msgattrib} Program
99 +* msgen:: Invoking the @code{msgen} Program
100 +* msgexec:: Invoking the @code{msgexec} Program
101 * libgettextpo:: Writing your own programs that process PO files
103 Producing Binary MO Files
105 -* msgfmt Invocation:: Invoking the @code{msgfmt} Program
106 -* msgunfmt Invocation:: Invoking the @code{msgunfmt} Program
107 +* msgfmt:: Invoking the @code{msgfmt} Program
108 +* msgunfmt:: Invoking the @code{msgunfmt} Program
109 * MO Files:: The Format of GNU MO Files
111 The Programmer's View
114 * Flat and Non-Flat:: Flat or Non-Flat Directory Structures
115 * Prerequisites:: Prerequisite Works
116 -* gettextize Invocation:: Invoking the @code{gettextize} Program
117 +* gettextize:: Invoking the @code{gettextize} Program
118 * Adjusting Files:: Files You Must Create or Alter
119 * autoconf macros:: Autoconf macros for use in @file{configure.in}
120 * CVS Issues:: Integrating with CVS
123 * Distributed CVS:: Avoiding version mismatch in distributed development
124 * Files under CVS:: Files to put under CVS version control
125 -* autopoint Invocation:: Invoking the @code{autopoint} Program
126 +* autopoint:: Invoking the @code{autopoint} Program
128 Other Programming Languages
130 @@ -406,10 +406,10 @@
131 * Preparing Shell Scripts:: Preparing Shell Scripts for Internationalization
132 * gettext.sh:: Contents of @code{gettext.sh}
133 * gettext Invocation:: Invoking the @code{gettext} program
134 -* ngettext Invocation:: Invoking the @code{ngettext} program
135 -* envsubst Invocation:: Invoking the @code{envsubst} program
136 -* eval_gettext Invocation:: Invoking the @code{eval_gettext} function
137 -* eval_ngettext Invocation:: Invoking the @code{eval_ngettext} function
138 +* ngettext:: Invoking the @code{ngettext} program
139 +* envsubst:: Invoking the @code{envsubst} program
140 +* eval_gettext:: Invoking the @code{eval_gettext} function
141 +* eval_ngettext:: Invoking the @code{eval_ngettext} function
146 exactly where in C sources each string is used. All translations
147 are set to empty. The letter @code{t} in @file{.pot} marks this as
148 a Template PO file, not yet oriented towards any particular language.
149 -@xref{xgettext Invocation}, for more details about how one calls the
150 +@xref{xgettext}, for more details about how one calls the
151 @code{xgettext} program. If you are @emph{really} lazy, you might
152 be interested at working a lot more right away, and preparing the
153 whole distribution setup (@pxref{Maintainers}). By doing so, you
154 @@ -1011,7 +1011,7 @@
155 which are no longer used in the program sources (@pxref{Obsolete
156 Entries}). It finally discovers new strings and inserts them in
157 the resulting PO file as untranslated entries (@pxref{Untranslated
158 -Entries}). @xref{msgmerge Invocation}, for more information about what
159 +Entries}). @xref{msgmerge}, for more information about what
160 @code{msgmerge} really does.
162 Whatever route or means taken, the goal is to obtain an updated
163 @@ -1035,8 +1035,8 @@
164 Once the PO file is complete and dependable, the @code{msgfmt} program
165 is used for turning the PO file into a machine-oriented format, which
166 may yield efficient retrieval of translations by the programs of the
167 -package, whenever needed at runtime (@pxref{MO Files}). @xref{msgfmt
168 -Invocation}, for more information about all modes of execution
169 +package, whenever needed at runtime (@pxref{MO Files}). @xref{msgfmt},
170 +for more information about all modes of execution
171 for the @code{msgfmt} program.
173 Finally, the modified and marked C sources are compiled and linked
174 @@ -1235,7 +1235,7 @@
176 In case the @code{c-format} flag is given for a string the @code{msgfmt}
177 does some more tests to check to validity of the translation.
178 -@xref{msgfmt Invocation}, @ref{c-format Flag} and @ref{c-format}.
179 +@xref{msgfmt}, @ref{c-format Flag} and @ref{c-format}.
182 @kwindex objc-format@r{ flag}
183 @@ -2164,7 +2164,7 @@
185 If a string is marked with @code{c-format} and this is not correct the
186 user can find out who is responsible for the decision. See
187 -@ref{xgettext Invocation} to see how the @code{--debug} option can be
188 +@ref{xgettext} to see how the @code{--debug} option can be
189 used for solving this problem.
191 @node Special cases, Names, c-format Flag, Sources
192 @@ -2196,7 +2196,7 @@
193 While it is no problem to mark the string @code{"a default message"} it
194 is not possible to mark the string initializers for @code{messages}.
195 What is to be done? We have to fulfill two tasks. First we have to mark the
196 -strings so that the @code{xgettext} program (@pxref{xgettext Invocation})
197 +strings so that the @code{xgettext} program (@pxref{xgettext})
198 can find them, and second we have to translate the string at runtime
199 before printing them.
201 @@ -2226,8 +2226,7 @@
203 Please convince yourself that the string which is written by
204 @code{fputs} is translated in any case. How to get @code{xgettext} know
205 -the additional keyword @code{gettext_noop} is explained in @ref{xgettext
207 +the additional keyword @code{gettext_noop} is explained in @ref{xgettext}.
209 The above is of course not the only solution. You could also come along
210 with the following one:
211 @@ -2449,10 +2448,10 @@
215 -* xgettext Invocation:: Invoking the @code{xgettext} Program
216 +* xgettext:: Invoking the @code{xgettext} Program
219 -@node xgettext Invocation, , Template, Template
220 +@node xgettext, , Template, Template
221 @section Invoking the @code{xgettext} Program
223 @include xgettext.texi
224 @@ -2481,16 +2480,16 @@
225 the header entry of this file.
228 -* msginit Invocation:: Invoking the @code{msginit} Program
229 +* msginit:: Invoking the @code{msginit} Program
230 * Header Entry:: Filling in the Header Entry
233 -@node msginit Invocation, Header Entry, Creating, Creating
234 +@node msginit, Header Entry, Creating, Creating
235 @section Invoking the @code{msginit} Program
237 @include msginit.texi
239 -@node Header Entry, , msginit Invocation, Creating
240 +@node Header Entry, , msginit, Creating
241 @section Filling in the Header Entry
242 @cindex header entry of a PO file
244 @@ -2663,10 +2662,10 @@
245 @chapter Updating Existing PO Files
248 -* msgmerge Invocation:: Invoking the @code{msgmerge} Program
249 +* msgmerge:: Invoking the @code{msgmerge} Program
252 -@node msgmerge Invocation, , Updating, Updating
253 +@node msgmerge, , Updating, Updating
254 @section Invoking the @code{msgmerge} Program
256 @include msgmerge.texi
257 @@ -4206,70 +4205,70 @@
258 write other specialized programs that process PO files.
261 -* msgcat Invocation:: Invoking the @code{msgcat} Program
262 -* msgconv Invocation:: Invoking the @code{msgconv} Program
263 -* msggrep Invocation:: Invoking the @code{msggrep} Program
264 -* msgfilter Invocation:: Invoking the @code{msgfilter} Program
265 -* msguniq Invocation:: Invoking the @code{msguniq} Program
266 -* msgcomm Invocation:: Invoking the @code{msgcomm} Program
267 -* msgcmp Invocation:: Invoking the @code{msgcmp} Program
268 -* msgattrib Invocation:: Invoking the @code{msgattrib} Program
269 -* msgen Invocation:: Invoking the @code{msgen} Program
270 -* msgexec Invocation:: Invoking the @code{msgexec} Program
271 +* msgcat:: Invoking the @code{msgcat} Program
272 +* msgconv:: Invoking the @code{msgconv} Program
273 +* msggrep:: Invoking the @code{msggrep} Program
274 +* msgfilter:: Invoking the @code{msgfilter} Program
275 +* msguniq:: Invoking the @code{msguniq} Program
276 +* msgcomm:: Invoking the @code{msgcomm} Program
277 +* msgcmp:: Invoking the @code{msgcmp} Program
278 +* msgattrib:: Invoking the @code{msgattrib} Program
279 +* msgen:: Invoking the @code{msgen} Program
280 +* msgexec:: Invoking the @code{msgexec} Program
281 * libgettextpo:: Writing your own programs that process PO files
284 -@node msgcat Invocation, msgconv Invocation, Manipulating, Manipulating
285 +@node msgcat, msgconv, Manipulating, Manipulating
286 @section Invoking the @code{msgcat} Program
290 -@node msgconv Invocation, msggrep Invocation, msgcat Invocation, Manipulating
291 +@node msgconv, msggrep, msgcat, Manipulating
292 @section Invoking the @code{msgconv} Program
294 @include msgconv.texi
296 -@node msggrep Invocation, msgfilter Invocation, msgconv Invocation, Manipulating
297 +@node msggrep, msgfilter, msgconv, Manipulating
298 @section Invoking the @code{msggrep} Program
300 @include msggrep.texi
302 -@node msgfilter Invocation, msguniq Invocation, msggrep Invocation, Manipulating
303 +@node msgfilter, msguniq, msggrep, Manipulating
304 @section Invoking the @code{msgfilter} Program
306 @include msgfilter.texi
308 -@node msguniq Invocation, msgcomm Invocation, msgfilter Invocation, Manipulating
309 +@node msguniq, msgcomm, msgfilter, Manipulating
310 @section Invoking the @code{msguniq} Program
312 @include msguniq.texi
314 -@node msgcomm Invocation, msgcmp Invocation, msguniq Invocation, Manipulating
315 +@node msgcomm, msgcmp, msguniq, Manipulating
316 @section Invoking the @code{msgcomm} Program
318 @include msgcomm.texi
320 -@node msgcmp Invocation, msgattrib Invocation, msgcomm Invocation, Manipulating
321 +@node msgcmp, msgattrib, msgcomm, Manipulating
322 @section Invoking the @code{msgcmp} Program
326 -@node msgattrib Invocation, msgen Invocation, msgcmp Invocation, Manipulating
327 +@node msgattrib, msgen, msgcmp, Manipulating
328 @section Invoking the @code{msgattrib} Program
330 @include msgattrib.texi
332 -@node msgen Invocation, msgexec Invocation, msgattrib Invocation, Manipulating
333 +@node msgen, msgexec, msgattrib, Manipulating
334 @section Invoking the @code{msgen} Program
338 -@node msgexec Invocation, libgettextpo, msgen Invocation, Manipulating
339 +@node msgexec, libgettextpo, msgen, Manipulating
340 @section Invoking the @code{msgexec} Program
342 @include msgexec.texi
344 -@node libgettextpo, , msgexec Invocation, Manipulating
345 +@node libgettextpo, , msgexec, Manipulating
346 @section Writing your own programs that process PO files
348 For the tasks for which a combination of @samp{msgattrib}, @samp{msgcat} etc.
349 @@ -4403,22 +4402,22 @@
353 -* msgfmt Invocation:: Invoking the @code{msgfmt} Program
354 -* msgunfmt Invocation:: Invoking the @code{msgunfmt} Program
355 +* msgfmt:: Invoking the @code{msgfmt} Program
356 +* msgunfmt:: Invoking the @code{msgunfmt} Program
357 * MO Files:: The Format of GNU MO Files
360 -@node msgfmt Invocation, msgunfmt Invocation, Binaries, Binaries
361 +@node msgfmt, msgunfmt, Binaries, Binaries
362 @section Invoking the @code{msgfmt} Program
366 -@node msgunfmt Invocation, MO Files, msgfmt Invocation, Binaries
367 +@node msgunfmt, MO Files, msgfmt, Binaries
368 @section Invoking the @code{msgunfmt} Program
370 @include msgunfmt.texi
372 -@node MO Files, , msgunfmt Invocation, Binaries
373 +@node MO Files, , msgunfmt, Binaries
374 @section The Format of GNU MO Files
375 @cindex MO file's format
376 @cindex file format, @file{.mo}
377 @@ -6407,7 +6406,7 @@
379 * Flat and Non-Flat:: Flat or Non-Flat Directory Structures
380 * Prerequisites:: Prerequisite Works
381 -* gettextize Invocation:: Invoking the @code{gettextize} Program
382 +* gettextize:: Invoking the @code{gettextize} Program
383 * Adjusting Files:: Files You Must Create or Alter
384 * autoconf macros:: Autoconf macros for use in @file{configure.in}
385 * CVS Issues:: Integrating with CVS
386 @@ -6440,7 +6439,7 @@
387 described in the remaining of this chapter. Some maintainers might
388 use this as an opportunity to unflatten their package structure.
390 -@node Prerequisites, gettextize Invocation, Flat and Non-Flat, Maintainers
391 +@node Prerequisites, gettextize, Flat and Non-Flat, Maintainers
392 @section Prerequisite Works
393 @cindex converting a package to use @code{gettext}
394 @cindex migration from earlier versions of @code{gettext}
395 @@ -6525,12 +6524,12 @@
396 a maintainer, ever think there is a real problem with a team, please
397 never try to @emph{solve} a team's problem on your own.
399 -@node gettextize Invocation, Adjusting Files, Prerequisites, Maintainers
400 +@node gettextize, Adjusting Files, Prerequisites, Maintainers
401 @section Invoking the @code{gettextize} Program
403 @include gettextize.texi
405 -@node Adjusting Files, autoconf macros, gettextize Invocation, Maintainers
406 +@node Adjusting Files, autoconf macros, gettextize, Maintainers
407 @section Files You Must Create or Alter
408 @cindex @code{gettext} files
410 @@ -6689,7 +6688,7 @@
411 Similarly, you can create rules for building message catalogs for the
412 @file{sr@@latin} locale -- Serbian written with the Latin alphabet --
413 from those for the @file{sr} locale -- Serbian written with Cyrillic
414 -letters. See @ref{msgfilter Invocation}.
415 +letters. See @ref{msgfilter}.
417 @node configure.in, config.guess, po/Rules-*, Adjusting Files
418 @subsection @file{configure.in} at top level
419 @@ -7406,7 +7405,7 @@
421 * Distributed CVS:: Avoiding version mismatch in distributed development
422 * Files under CVS:: Files to put under CVS version control
423 -* autopoint Invocation:: Invoking the @code{autopoint} Program
424 +* autopoint:: Invoking the @code{autopoint} Program
427 @node Distributed CVS, Files under CVS, CVS Issues, CVS Issues
428 @@ -7448,7 +7447,7 @@
429 undiscovered due to this constellation.
432 -@node Files under CVS, autopoint Invocation, Distributed CVS, CVS Issues
433 +@node Files under CVS, autopoint, Distributed CVS, CVS Issues
434 @subsection Files to put under CVS version control
436 There are basically three ways to deal with generated files in the
437 @@ -7527,7 +7526,7 @@
438 use the CVS will henceforth need to have GNU @code{gettext} 0.12.1 or newer
441 -@node autopoint Invocation, , Files under CVS, CVS Issues
442 +@node autopoint, , Files under CVS, CVS Issues
443 @subsection Invoking the @code{autopoint} Program
445 @include autopoint.texi
446 @@ -8193,10 +8192,10 @@
447 * Preparing Shell Scripts:: Preparing Shell Scripts for Internationalization
448 * gettext.sh:: Contents of @code{gettext.sh}
449 * gettext Invocation:: Invoking the @code{gettext} program
450 -* ngettext Invocation:: Invoking the @code{ngettext} program
451 -* envsubst Invocation:: Invoking the @code{envsubst} program
452 -* eval_gettext Invocation:: Invoking the @code{eval_gettext} function
453 -* eval_ngettext Invocation:: Invoking the @code{eval_ngettext} function
454 +* ngettext:: Invoking the @code{ngettext} program
455 +* envsubst:: Invoking the @code{envsubst} program
456 +* eval_gettext:: Invoking the @code{eval_gettext} function
457 +* eval_ngettext:: Invoking the @code{eval_ngettext} function
460 @node Preparing Shell Scripts, gettext.sh, sh, sh
461 @@ -8217,8 +8216,8 @@
463 near the top of the script. @code{gettext.sh} is a shell function library
464 that provides the functions
465 -@code{eval_gettext} (see @ref{eval_gettext Invocation}) and
466 -@code{eval_ngettext} (see @ref{eval_ngettext Invocation}).
467 +@code{eval_gettext} (see @ref{eval_gettext}) and
468 +@code{eval_ngettext} (see @ref{eval_ngettext}).
469 You have to ensure that @code{gettext.sh} can be found in the @code{PATH}.
472 @@ -8328,28 +8327,28 @@
473 and a newline, without interpreting backslashes in the argument string.
476 -See @ref{eval_gettext Invocation}.
477 +See @ref{eval_gettext}.
480 -See @ref{eval_ngettext Invocation}.
481 +See @ref{eval_ngettext}.
484 -@node gettext Invocation, ngettext Invocation, gettext.sh, sh
485 +@node gettext Invocation, ngettext, gettext.sh, sh
486 @subsubsection Invoking the @code{gettext} program
488 @include rt-gettext.texi
490 -@node ngettext Invocation, envsubst Invocation, gettext Invocation, sh
491 +@node ngettext, envsubst, gettext Invocation, sh
492 @subsubsection Invoking the @code{ngettext} program
494 @include rt-ngettext.texi
496 -@node envsubst Invocation, eval_gettext Invocation, ngettext Invocation, sh
497 +@node envsubst, eval_gettext, ngettext, sh
498 @subsubsection Invoking the @code{envsubst} program
500 @include rt-envsubst.texi
502 -@node eval_gettext Invocation, eval_ngettext Invocation, envsubst Invocation, sh
503 +@node eval_gettext, eval_ngettext, envsubst, sh
504 @subsubsection Invoking the @code{eval_gettext} function
506 @cindex @code{eval_gettext} function, usage
507 @@ -8362,7 +8361,7 @@
508 performing dollar-substitution on the result. Note that only shell variables
509 mentioned in @var{msgid} will be dollar-substituted in the result.
511 -@node eval_ngettext Invocation, , eval_gettext Invocation, sh
512 +@node eval_ngettext, , eval_gettext, sh
513 @subsubsection Invoking the @code{eval_ngettext} function
515 @cindex @code{eval_ngettext} function, usage
516 --- gettext-0.12.1/gettext-tools/doc/gettextize.texi.orig 2003-05-05 11:09:21.000000000 +0200
517 +++ gettext-0.12.1/gettext-tools/doc/gettextize.texi 2003-06-07 20:10:53.000000000 +0200
519 of the GNU build system, in the sense that it should not be invoked
520 automatically, and not be invoked by someone who doesn't assume the
521 responsibilities of a package maintainer. For the latter purpose, a
522 -separate tool is provided, see @ref{autopoint Invocation}.
523 +separate tool is provided, see @ref{autopoint}.
524 --- gettext-0.13/gettext-runtime/libasprintf/autosprintf.texi.orig Fri May 30 16:30:21 2003
525 +++ gettext-0.13/gettext-runtime/libasprintf/autosprintf.texi Mon Dec 1 15:52:12 2003
530 -@dircategory C++ libraries
531 +@dircategory Libraries:
533 -* autosprintf: (autosprintf). Support for printf format strings in C++.
534 +* autosprintf: (autosprintf). Support for printf format strings in C++