1 --- gettext-0.21/gettext-tools/doc/gettext.texi.orig 2020-07-26 21:47:14.000000000 +0200
2 +++ gettext-0.21/gettext-tools/doc/gettext.texi 2020-10-11 19:22:15.147471076 +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 * Colorizing:: Highlighting parts of PO files
102 * Other tools:: Other tools for manipulating PO files
103 * libgettextpo:: Writing your own programs that process PO files
106 Producing Binary MO Files
108 -* msgfmt Invocation:: Invoking the @code{msgfmt} Program
109 -* msgunfmt Invocation:: Invoking the @code{msgunfmt} Program
110 +* msgfmt:: Invoking the @code{msgfmt} Program
111 +* msgunfmt:: Invoking the @code{msgunfmt} Program
112 * MO Files:: The Format of GNU MO Files
114 The Programmer's View
117 * Flat and Non-Flat:: Flat or Non-Flat Directory Structures
118 * Prerequisites:: Prerequisite Works
119 -* gettextize Invocation:: Invoking the @code{gettextize} Program
120 +* gettextize:: Invoking the @code{gettextize} Program
121 * Adjusting Files:: Files You Must Create or Alter
122 * autoconf macros:: Autoconf macros for use in @file{configure.ac}
123 * Version Control Issues::
125 * Distributed Development:: Avoiding version mismatch in distributed development
126 * Files under Version Control:: Files to put under version control
127 * Translations under Version Control:: Put PO Files under Version Control
128 -* autopoint Invocation:: Invoking the @code{autopoint} Program
129 +* autopoint:: Invoking the @code{autopoint} Program
131 Other Programming Languages
133 @@ -449,12 +449,12 @@
134 * Preparing Shell Scripts:: Preparing Shell Scripts for Internationalization
135 * gettext.sh:: Contents of @code{gettext.sh}
136 * gettext Invocation:: Invoking the @code{gettext} program
137 -* ngettext Invocation:: Invoking the @code{ngettext} program
138 -* envsubst Invocation:: Invoking the @code{envsubst} program
139 -* eval_gettext Invocation:: Invoking the @code{eval_gettext} function
140 -* eval_ngettext Invocation:: Invoking the @code{eval_ngettext} function
141 -* eval_pgettext Invocation:: Invoking the @code{eval_pgettext} function
142 -* eval_npgettext Invocation:: Invoking the @code{eval_npgettext} function
143 +* ngettext:: Invoking the @code{ngettext} program
144 +* envsubst:: Invoking the @code{envsubst} program
145 +* eval_gettext:: Invoking the @code{eval_gettext} function
146 +* eval_ngettext:: Invoking the @code{eval_ngettext} function
147 +* eval_pgettext:: Invoking the @code{eval_pgettext} function
148 +* eval_npgettext:: Invoking the @code{eval_npgettext} function
152 @@ -1030,7 +1030,7 @@
153 exactly where in C sources each string is used. All translations
154 are set to empty. The letter @code{t} in @file{.pot} marks this as
155 a Template PO file, not yet oriented towards any particular language.
156 -@xref{xgettext Invocation}, for more details about how one calls the
157 +@xref{xgettext}, for more details about how one calls the
158 @code{xgettext} program. If you are @emph{really} lazy, you might
159 be interested at working a lot more right away, and preparing the
160 whole distribution setup (@pxref{Maintainers}). By doing so, you
161 @@ -1105,7 +1105,7 @@
162 which are no longer used in the program sources (@pxref{Obsolete
163 Entries}). It finally discovers new strings and inserts them in
164 the resulting PO file as untranslated entries (@pxref{Untranslated
165 -Entries}). @xref{msgmerge Invocation}, for more information about what
166 +Entries}). @xref{msgmerge}, for more information about what
167 @code{msgmerge} really does.
169 Whatever route or means taken, the goal is to obtain an updated
170 @@ -1129,8 +1129,8 @@
171 Once the PO file is complete and dependable, the @code{msgfmt} program
172 is used for turning the PO file into a machine-oriented format, which
173 may yield efficient retrieval of translations by the programs of the
174 -package, whenever needed at runtime (@pxref{MO Files}). @xref{msgfmt
175 -Invocation}, for more information about all modes of execution
176 +package, whenever needed at runtime (@pxref{MO Files}). @xref{msgfmt},
177 +for more information about all modes of execution
178 for the @code{msgfmt} program.
180 Finally, the modified and marked C sources are compiled and linked
181 @@ -1558,7 +1558,7 @@
183 When the @code{c-format} flag is given for a string the @code{msgfmt}
184 program does some more tests to check the validity of the translation.
185 -@xref{msgfmt Invocation}, @ref{c-format Flag} and @ref{c-format}.
186 +@xref{msgfmt}, @ref{c-format Flag} and @ref{c-format}.
189 @kwindex objc-format@r{ flag}
190 @@ -2656,7 +2656,7 @@
192 If a string is marked with @code{c-format} and this is not correct the
193 user can find out who is responsible for the decision. See
194 -@ref{xgettext Invocation} to see how the @code{--debug} option can be
195 +@ref{xgettext} to see how the @code{--debug} option can be
196 used for solving this problem.
199 @@ -2688,7 +2688,7 @@
200 While it is no problem to mark the string @code{"a default message"} it
201 is not possible to mark the string initializers for @code{messages}.
202 What is to be done? We have to fulfill two tasks. First we have to mark the
203 -strings so that the @code{xgettext} program (@pxref{xgettext Invocation})
204 +strings so that the @code{xgettext} program (@pxref{xgettext})
205 can find them, and second we have to translate the string at runtime
206 before printing them.
208 @@ -2718,8 +2718,7 @@
210 Please convince yourself that the string which is written by
211 @code{fputs} is translated in any case. How to get @code{xgettext} know
212 -the additional keyword @code{gettext_noop} is explained in @ref{xgettext
214 +the additional keyword @code{gettext_noop} is explained in @ref{xgettext}.
216 The above is of course not the only solution. You could also come along
217 with the following one:
218 @@ -3015,10 +3014,10 @@
222 -* xgettext Invocation:: Invoking the @code{xgettext} Program
223 +* xgettext:: Invoking the @code{xgettext} Program
226 -@node xgettext Invocation
228 @section Invoking the @code{xgettext} Program
230 @include xgettext.texi
231 @@ -3047,11 +3046,11 @@
232 the header entry of this file.
235 -* msginit Invocation:: Invoking the @code{msginit} Program
236 +* msginit:: Invoking the @code{msginit} Program
237 * Header Entry:: Filling in the Header Entry
240 -@node msginit Invocation
242 @section Invoking the @code{msginit} Program
244 @include msginit.texi
245 @@ -3283,10 +3282,10 @@
246 @chapter Updating Existing PO Files
249 -* msgmerge Invocation:: Invoking the @code{msgmerge} Program
250 +* msgmerge:: Invoking the @code{msgmerge} Program
253 -@node msgmerge Invocation
255 @section Invoking the @code{msgmerge} Program
257 @include msgmerge.texi
258 @@ -4826,67 +4825,67 @@
259 write other specialized programs that process PO files.
262 -* msgcat Invocation:: Invoking the @code{msgcat} Program
263 -* msgconv Invocation:: Invoking the @code{msgconv} Program
264 -* msggrep Invocation:: Invoking the @code{msggrep} Program
265 -* msgfilter Invocation:: Invoking the @code{msgfilter} Program
266 -* msguniq Invocation:: Invoking the @code{msguniq} Program
267 -* msgcomm Invocation:: Invoking the @code{msgcomm} Program
268 -* msgcmp Invocation:: Invoking the @code{msgcmp} Program
269 -* msgattrib Invocation:: Invoking the @code{msgattrib} Program
270 -* msgen Invocation:: Invoking the @code{msgen} Program
271 -* msgexec Invocation:: Invoking the @code{msgexec} Program
272 +* msgcat:: Invoking the @code{msgcat} Program
273 +* msgconv:: Invoking the @code{msgconv} Program
274 +* msggrep:: Invoking the @code{msggrep} Program
275 +* msgfilter:: Invoking the @code{msgfilter} Program
276 +* msguniq:: Invoking the @code{msguniq} Program
277 +* msgcomm:: Invoking the @code{msgcomm} Program
278 +* msgcmp:: Invoking the @code{msgcmp} Program
279 +* msgattrib:: Invoking the @code{msgattrib} Program
280 +* msgen:: Invoking the @code{msgen} Program
281 +* msgexec:: Invoking the @code{msgexec} Program
282 * Colorizing:: Highlighting parts of PO files
283 * Other tools:: Other tools for manipulating PO files
284 * libgettextpo:: Writing your own programs that process PO files
287 -@node msgcat Invocation
289 @section Invoking the @code{msgcat} Program
293 -@node msgconv Invocation
295 @section Invoking the @code{msgconv} Program
297 @include msgconv.texi
299 -@node msggrep Invocation
301 @section Invoking the @code{msggrep} Program
303 @include msggrep.texi
305 -@node msgfilter Invocation
307 @section Invoking the @code{msgfilter} Program
309 @include msgfilter.texi
311 -@node msguniq Invocation
313 @section Invoking the @code{msguniq} Program
315 @include msguniq.texi
317 -@node msgcomm Invocation
319 @section Invoking the @code{msgcomm} Program
321 @include msgcomm.texi
323 -@node msgcmp Invocation
325 @section Invoking the @code{msgcmp} Program
329 -@node msgattrib Invocation
331 @section Invoking the @code{msgattrib} Program
333 @include msgattrib.texi
335 -@node msgen Invocation
337 @section Invoking the @code{msgen} Program
341 -@node msgexec Invocation
343 @section Invoking the @code{msgexec} Program
345 @include msgexec.texi
346 @@ -5806,17 +5805,17 @@
350 -* msgfmt Invocation:: Invoking the @code{msgfmt} Program
351 -* msgunfmt Invocation:: Invoking the @code{msgunfmt} Program
352 +* msgfmt:: Invoking the @code{msgfmt} Program
353 +* msgunfmt:: Invoking the @code{msgunfmt} Program
354 * MO Files:: The Format of GNU MO Files
357 -@node msgfmt Invocation
359 @section Invoking the @code{msgfmt} Program
363 -@node msgunfmt Invocation
365 @section Invoking the @code{msgunfmt} Program
367 @include msgunfmt.texi
368 @@ -6744,7 +6743,7 @@
369 The Unicode CLDR Project (@uref{http://cldr.unicode.org}) provides a
370 comprehensive set of plural forms in a different format. The
371 @code{msginit} program has preliminary support for the format so you can
372 -use it as a baseline (@pxref{msginit Invocation}).}
373 +use it as a baseline (@pxref{msginit}).}
377 @@ -8098,7 +8097,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.ac}
385 * Version Control Issues::
386 @@ -8215,7 +8214,7 @@
387 a maintainer, ever think there is a real problem with a team, please
388 never try to @emph{solve} a team's problem on your own.
390 -@node gettextize Invocation
392 @section Invoking the @code{gettextize} Program
394 @include gettextize.texi
395 @@ -8381,7 +8380,7 @@
396 Similarly, you can create rules for building message catalogs for the
397 @file{sr@@latin} locale -- Serbian written with the Latin alphabet --
398 from those for the @file{sr} locale -- Serbian written with Cyrillic
399 -letters. See @ref{msgfilter Invocation}.
400 +letters. See @ref{msgfilter}.
403 @subsection @file{configure.ac} at top level
404 @@ -8997,7 +8996,7 @@
405 to instruct @code{xgettext} to mark all translatable strings in @samp{gettext}
406 invocations that occur as fifth argument to this function as @samp{c-format}.
408 -See @ref{xgettext Invocation} for the list of options that @code{xgettext}
409 +See @ref{xgettext} for the list of options that @code{xgettext}
412 The use of this macro is an alternative to the use of the
413 @@ -9067,7 +9066,7 @@
414 * Distributed Development:: Avoiding version mismatch in distributed development
415 * Files under Version Control:: Files to put under version control
416 * Translations under Version Control:: Put PO Files under Version Control
417 -* autopoint Invocation:: Invoking the @code{autopoint} Program
418 +* autopoint:: Invoking the @code{autopoint} Program
421 @node Distributed Development
422 @@ -9238,7 +9237,7 @@
426 -@node autopoint Invocation
428 @subsection Invoking the @code{autopoint} Program
430 @include autopoint.texi
431 @@ -10258,7 +10257,7 @@
432 Special Characters} data category can be used.
434 To merge the translations, the @samp{msgfmt} program can be used with
435 -the option @code{--xml}. @xref{msgfmt Invocation}, for more details
436 +the option @code{--xml}. @xref{msgfmt}, for more details
437 about how one calls the @samp{msgfmt} program. @samp{msgfmt}'s
438 @code{--xml} option doesn't perform character escaping, so translated
439 strings can have arbitrary XML constructs, such as elements for markup.
440 @@ -10482,7 +10481,7 @@
441 @subsection XML files
443 See the section @ref{Preparing ITS Rules} and
444 -@ref{msgfmt Invocation}, subsection ``XML mode operations''.
445 +@ref{msgfmt}, subsection ``XML mode operations''.
448 @chapter Concluding Remarks
449 --- gettext-0.12.1/gettext-tools/doc/gettextize.texi.orig 2003-05-05 11:09:21.000000000 +0200
450 +++ gettext-0.12.1/gettext-tools/doc/gettextize.texi 2003-06-07 20:10:53.000000000 +0200
452 of the GNU build system, in the sense that it should not be invoked
453 automatically, and not be invoked by someone who doesn't assume the
454 responsibilities of a package maintainer. For the latter purpose, a
455 -separate tool is provided, see @ref{autopoint Invocation}.
456 +separate tool is provided, see @ref{autopoint}.
457 --- gettext-0.21/gettext-tools/doc/lang-sh.texi.orig 2020-06-06 16:03:32.000000000 +0200
458 +++ gettext-0.21/gettext-tools/doc/lang-sh.texi 2020-10-11 19:27:53.682303742 +0200
460 * Preparing Shell Scripts:: Preparing Shell Scripts for Internationalization
461 * gettext.sh:: Contents of @code{gettext.sh}
462 * gettext Invocation:: Invoking the @code{gettext} program
463 -* ngettext Invocation:: Invoking the @code{ngettext} program
464 -* envsubst Invocation:: Invoking the @code{envsubst} program
465 -* eval_gettext Invocation:: Invoking the @code{eval_gettext} function
466 -* eval_ngettext Invocation:: Invoking the @code{eval_ngettext} function
467 -* eval_pgettext Invocation:: Invoking the @code{eval_pgettext} function
468 -* eval_npgettext Invocation:: Invoking the @code{eval_npgettext} function
469 +* ngettext:: Invoking the @code{ngettext} program
470 +* envsubst:: Invoking the @code{envsubst} program
471 +* eval_gettext:: Invoking the @code{eval_gettext} function
472 +* eval_ngettext:: Invoking the @code{eval_ngettext} function
473 +* eval_pgettext:: Invoking the @code{eval_pgettext} function
474 +* eval_npgettext:: Invoking the @code{eval_npgettext} function
477 @node Preparing Shell Scripts
480 near the top of the script. @code{gettext.sh} is a shell function library
481 that provides the functions
482 -@code{eval_gettext} (see @ref{eval_gettext Invocation}),
483 -@code{eval_ngettext} (see @ref{eval_ngettext Invocation}),
484 -@code{eval_pgettext} (see @ref{eval_pgettext Invocation}), and
485 -@code{eval_npgettext} (see @ref{eval_npgettext Invocation}).
486 +@code{eval_gettext} (see @ref{eval_gettext}),
487 +@code{eval_ngettext} (see @ref{eval_ngettext}),
488 +@code{eval_pgettext} (see @ref{eval_pgettext}), and
489 +@code{eval_npgettext} (see @ref{eval_npgettext}).
490 You have to ensure that @code{gettext.sh} can be found in the @code{PATH}.
493 @@ -204,16 +204,16 @@
494 and a newline, without interpreting backslashes in the argument string.
497 -See @ref{eval_gettext Invocation}.
498 +See @ref{eval_gettext}.
501 -See @ref{eval_ngettext Invocation}.
502 +See @ref{eval_ngettext}.
505 -See @ref{eval_pgettext Invocation}.
506 +See @ref{eval_pgettext}.
509 -See @ref{eval_npgettext Invocation}.
510 +See @ref{eval_npgettext}.
513 @node gettext Invocation
515 @code{gettext} invocation, where no options are present and the
516 @var{textdomain} is implicit, from the environment.
518 -@node ngettext Invocation
520 @subsubsection Invoking the @code{ngettext} program
522 @include rt-ngettext.texi
523 @@ -234,12 +234,12 @@
524 @code{ngettext} invocation, where no options are present and the
525 @var{textdomain} is implicit, from the environment.
527 -@node envsubst Invocation
529 @subsubsection Invoking the @code{envsubst} program
531 @include rt-envsubst.texi
533 -@node eval_gettext Invocation
535 @subsubsection Invoking the @code{eval_gettext} function
537 @cindex @code{eval_gettext} function, usage
539 performing dollar-substitution on the result. Note that only shell variables
540 mentioned in @var{msgid} will be dollar-substituted in the result.
542 -@node eval_ngettext Invocation
544 @subsubsection Invoking the @code{eval_ngettext} function
546 @cindex @code{eval_ngettext} function, usage
548 on the result. Note that only shell variables mentioned in @var{msgid} or
549 @var{msgid-plural} will be dollar-substituted in the result.
551 -@node eval_pgettext Invocation
553 @subsubsection Invoking the @code{eval_pgettext} function
555 @cindex @code{eval_pgettext} function, usage
557 dollar-substitution on the result. Note that only shell variables mentioned
558 in @var{msgid} will be dollar-substituted in the result.
560 -@node eval_npgettext Invocation
561 +@node eval_npgettext
562 @subsubsection Invoking the @code{eval_npgettext} function
564 @cindex @code{eval_npgettext} function, usage
565 --- gettext-0.17/gettext-runtime/libasprintf/autosprintf.texi.orig 2007-09-01 11:15:56.000000000 +0200
566 +++ gettext-0.17/gettext-runtime/libasprintf/autosprintf.texi 2007-11-07 22:19:42.123759307 +0100
571 -@dircategory C++ libraries
572 +@dircategory Libraries:
574 -* autosprintf: (autosprintf). Support for printf format strings in C++.
575 +* autosprintf: (autosprintf). Support for printf format strings in C++
579 --- gettext-0.20.1/libtextstyle/doc/libtextstyle.texi.orig 2019-05-05 18:38:05.000000000 +0200
580 +++ gettext-0.20.1/libtextstyle/doc/libtextstyle.texi 2019-06-19 07:51:38.487255700 +0200
582 @include version.texi
585 -@dircategory Software development
586 +@dircategory Programming tools:
588 -* GNU libtextstyle: (libtextstyle). Output of styled text.
589 +* GNU libtextstyle: (libtextstyle). Output of styled text