1 --- gettext-0.12.1/gettext-tools/doc/gettext.texi.orig 2003-05-05 11:09:21.000000000 +0200
2 +++ gettext-0.12.1/gettext-tools/doc/gettext.texi 2003-06-07 20:17:27.000000000 +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 -* gettextize: (gettext)gettextize Invocation. Prepare a package for gettext.
13 -* msgattrib: (gettext)msgattrib Invocation. Select part of a PO file.
14 -* msgcat: (gettext)msgcat Invocation. Combine several PO files.
15 -* msgcmp: (gettext)msgcmp Invocation. Compare a PO file and template.
16 -* msgcomm: (gettext)msgcomm Invocation. Match two PO files.
17 -* msgconv: (gettext)msgconv Invocation. Convert PO file to encoding.
18 -* msgen: (gettext)msgen Invocation. Create an English PO file.
19 -* msgexec: (gettext)msgexec Invocation. Process a PO file.
20 -* msgfilter: (gettext)msgfilter Invocation. Pipe a PO file through a filter.
21 -* msgfmt: (gettext)msgfmt Invocation. Make MO files out of PO files.
22 -* msggrep: (gettext)msggrep Invocation. Select part of a PO file.
23 -* msginit: (gettext)msginit Invocation. Create a fresh PO file.
24 -* msgmerge: (gettext)msgmerge Invocation. Update a PO file from template.
25 -* msgunfmt: (gettext)msgunfmt Invocation. Uncompile MO file into PO file.
26 -* msguniq: (gettext)msguniq Invocation. Unify duplicates for PO file.
27 -* xgettext: (gettext)xgettext Invocation. Extract strings into a PO file.
28 -* ISO639: (gettext)Language Codes. ISO 639 language codes.
29 -* ISO3166: (gettext)Country Codes. ISO 3166 country codes.
30 +* gettext: (gettext). GNU gettext utilities
31 +* autopoint: (gettext)autopoint. Copy gettext infrastructure
32 +* gettextize: (gettext)gettextize. Prepare a package for gettext
33 +* msgattrib: (gettext)msgattrib. Select part of a PO file
34 +* msgcat: (gettext)msgcat. Combine several PO files
35 +* msgcmp: (gettext)msgcmp. Compare a PO file and template
36 +* msgcomm: (gettext)msgcomm. Match two PO files
37 +* msgconv: (gettext)msgconv. Convert PO file to encoding
38 +* msgen: (gettext)msgen. Create an English PO file
39 +* msgexec: (gettext)msgexec. Process a PO file
40 +* msgfilter: (gettext)msgfilter. Pipe a PO file through a filter
41 +* msgfmt: (gettext)msgfmt. Make MO files out of PO files
42 +* msggrep: (gettext)msggrep. Select part of a PO file
43 +* msginit: (gettext)msginit. Create a fresh PO file
44 +* msgmerge: (gettext)msgmerge. Update a PO file from template
45 +* msgunfmt: (gettext)msgunfmt. Uncompile MO file into PO file
46 +* msguniq: (gettext)msguniq. Unify duplicates for PO file
47 +* xgettext: (gettext)xgettext. Extract strings into a PO file
48 +* ISO639: (gettext)Language Codes. ISO 639 language codes
49 +* ISO3166: (gettext)Country Codes. ISO 3166 country codes
55 Making the PO Template File
57 -* xgettext Invocation:: Invoking the @code{xgettext} Program
58 +* xgettext:: Invoking the @code{xgettext} Program
60 Creating a New PO File
62 -* msginit Invocation:: Invoking the @code{msginit} Program
63 +* msginit:: Invoking the @code{msginit} Program
64 * Header Entry:: Filling in the Header Entry
66 Updating Existing PO Files
68 -* msgmerge Invocation:: Invoking the @code{msgmerge} Program
69 +* msgmerge:: Invoking the @code{msgmerge} Program
70 * Translated Entries:: Translated Entries
71 * Fuzzy Entries:: Fuzzy Entries
72 * Untranslated Entries:: Untranslated Entries
77 -* msgcat Invocation:: Invoking the @code{msgcat} Program
78 -* msgconv Invocation:: Invoking the @code{msgconv} Program
79 -* msggrep Invocation:: Invoking the @code{msggrep} Program
80 -* msgfilter Invocation:: Invoking the @code{msgfilter} Program
81 -* msguniq Invocation:: Invoking the @code{msguniq} Program
82 -* msgcomm Invocation:: Invoking the @code{msgcomm} Program
83 -* msgcmp Invocation:: Invoking the @code{msgcmp} Program
84 -* msgattrib Invocation:: Invoking the @code{msgattrib} Program
85 -* msgen Invocation:: Invoking the @code{msgen} Program
86 -* msgexec Invocation:: Invoking the @code{msgexec} Program
87 +* msgcat:: Invoking the @code{msgcat} Program
88 +* msgconv:: Invoking the @code{msgconv} Program
89 +* msggrep:: Invoking the @code{msggrep} Program
90 +* msgfilter:: Invoking the @code{msgfilter} Program
91 +* msguniq:: Invoking the @code{msguniq} Program
92 +* msgcomm:: Invoking the @code{msgcomm} Program
93 +* msgcmp:: Invoking the @code{msgcmp} Program
94 +* msgattrib:: Invoking the @code{msgattrib} Program
95 +* msgen:: Invoking the @code{msgen} Program
96 +* msgexec:: Invoking the @code{msgexec} Program
97 * libgettextpo:: Writing your own programs that process PO files
99 Producing Binary MO Files
101 -* msgfmt Invocation:: Invoking the @code{msgfmt} Program
102 -* msgunfmt Invocation:: Invoking the @code{msgunfmt} Program
103 +* msgfmt:: Invoking the @code{msgfmt} Program
104 +* msgunfmt:: Invoking the @code{msgunfmt} Program
105 * MO Files:: The Format of GNU MO Files
110 * Flat and Non-Flat:: Flat or Non-Flat Directory Structures
111 * Prerequisites:: Prerequisite Works
112 -* gettextize Invocation:: Invoking the @code{gettextize} Program
113 +* gettextize:: Invoking the @code{gettextize} Program
114 * Adjusting Files:: Files You Must Create or Alter
115 * autoconf macros:: Autoconf macros for use in @file{configure.in}
116 * CVS Issues:: Integrating with CVS
119 * Distributed CVS:: Avoiding version mismatch in distributed development
120 * Files under CVS:: Files to put under CVS version control
121 -* autopoint Invocation:: Invoking the @code{autopoint} Program
122 +* autopoint:: Invoking the @code{autopoint} Program
124 Other Programming Languages
127 exactly where in C sources each string is used. All translations
128 are set to empty. The letter @code{t} in @file{.pot} marks this as
129 a Template PO file, not yet oriented towards any particular language.
130 -@xref{xgettext Invocation}, for more details about how one calls the
131 +@xref{xgettext}, for more details about how one calls the
132 @code{xgettext} program. If you are @emph{really} lazy, you might
133 be interested at working a lot more right away, and preparing the
134 whole distribution setup (@pxref{Maintainers}). By doing so, you
136 which are no longer used in the program sources (@pxref{Obsolete
137 Entries}). It finally discovers new strings and inserts them in
138 the resulting PO file as untranslated entries (@pxref{Untranslated
139 -Entries}). @xref{msgmerge Invocation}, for more information about what
140 +Entries}). @xref{msgmerge}, for more information about what
141 @code{msgmerge} really does.
143 Whatever route or means taken, the goal is to obtain an updated
145 Once the PO file is complete and dependable, the @code{msgfmt} program
146 is used for turning the PO file into a machine-oriented format, which
147 may yield efficient retrieval of translations by the programs of the
148 -package, whenever needed at runtime (@pxref{MO Files}). @xref{msgfmt
149 -Invocation}, for more information about all modes of execution
150 +package, whenever needed at runtime (@pxref{MO Files}). @xref{msgfmt},
151 +for more information about all modes of execution
152 for the @code{msgfmt} program.
154 Finally, the modified and marked C sources are compiled and linked
155 @@ -1138,7 +1138,7 @@
157 In case the @code{c-format} flag is given for a string the @code{msgfmt}
158 does some more tests to check to validity of the translation.
159 -@xref{msgfmt Invocation}, @ref{c-format Flag} and @ref{c-format}.
160 +@xref{msgfmt}, @ref{c-format Flag} and @ref{c-format}.
163 @kwindex python-format@r{ flag}
164 @@ -2344,7 +2344,7 @@
166 If a string is marked with @code{c-format} and this is not correct the
167 user can find out who is responsible for the decision. See
168 -@ref{xgettext Invocation} to see how the @code{--debug} option can be
169 +@ref{xgettext} to see how the @code{--debug} option can be
170 used for solving this problem.
172 @node Special cases, Names, c-format Flag, Sources
173 @@ -2376,7 +2376,7 @@
174 While it is no problem to mark the string @code{"a default message"} it
175 is not possible to mark the string initializers for @code{messages}.
176 What is to be done? We have to fulfill two tasks. First we have to mark the
177 -strings so that the @code{xgettext} program (@pxref{xgettext Invocation})
178 +strings so that the @code{xgettext} program (@pxref{xgettext})
179 can find them, and second we have to translate the string at runtime
180 before printing them.
182 @@ -2406,8 +2406,7 @@
184 Please convince yourself that the string which is written by
185 @code{fputs} is translated in any case. How to get @code{xgettext} know
186 -the additional keyword @code{gettext_noop} is explained in @ref{xgettext
188 +the additional keyword @code{gettext_noop} is explained in @ref{xgettext}.
190 The above is of course not the only solution. You could also come along
191 with the following one:
192 @@ -2529,10 +2528,10 @@
196 -* xgettext Invocation:: Invoking the @code{xgettext} Program
197 +* xgettext:: Invoking the @code{xgettext} Program
200 -@node xgettext Invocation, , Template, Template
201 +@node xgettext, , Template, Template
202 @section Invoking the @code{xgettext} Program
204 @include xgettext.texi
205 @@ -2561,16 +2560,16 @@
206 the header entry of this file.
209 -* msginit Invocation:: Invoking the @code{msginit} Program
210 +* msginit:: Invoking the @code{msginit} Program
211 * Header Entry:: Filling in the Header Entry
214 -@node msginit Invocation, Header Entry, Creating, Creating
215 +@node msginit, Header Entry, Creating, Creating
216 @section Invoking the @code{msginit} Program
218 @include msginit.texi
220 -@node Header Entry, , msginit Invocation, Creating
221 +@node Header Entry, , msginit, Creating
222 @section Filling in the Header Entry
223 @cindex header entry of a PO file
225 @@ -2745,7 +2744,7 @@
229 -* msgmerge Invocation:: Invoking the @code{msgmerge} Program
230 +* msgmerge:: Invoking the @code{msgmerge} Program
231 * Translated Entries:: Translated Entries
232 * Fuzzy Entries:: Fuzzy Entries
233 * Untranslated Entries:: Untranslated Entries
234 @@ -2758,12 +2757,12 @@
235 * Compendium:: Using Translation Compendia
238 -@node msgmerge Invocation, Translated Entries, Updating, Updating
239 +@node msgmerge, Translated Entries, Updating, Updating
240 @section Invoking the @code{msgmerge} Program
242 @include msgmerge.texi
244 -@node Translated Entries, Fuzzy Entries, msgmerge Invocation, Updating
245 +@node Translated Entries, Fuzzy Entries, msgmerge, Updating
246 @section Translated Entries
247 @cindex translated entries
249 @@ -3805,70 +3804,70 @@
250 write other specialized programs that process PO files.
253 -* msgcat Invocation:: Invoking the @code{msgcat} Program
254 -* msgconv Invocation:: Invoking the @code{msgconv} Program
255 -* msggrep Invocation:: Invoking the @code{msggrep} Program
256 -* msgfilter Invocation:: Invoking the @code{msgfilter} Program
257 -* msguniq Invocation:: Invoking the @code{msguniq} Program
258 -* msgcomm Invocation:: Invoking the @code{msgcomm} Program
259 -* msgcmp Invocation:: Invoking the @code{msgcmp} Program
260 -* msgattrib Invocation:: Invoking the @code{msgattrib} Program
261 -* msgen Invocation:: Invoking the @code{msgen} Program
262 -* msgexec Invocation:: Invoking the @code{msgexec} Program
263 +* msgcat:: Invoking the @code{msgcat} Program
264 +* msgconv:: Invoking the @code{msgconv} Program
265 +* msggrep:: Invoking the @code{msggrep} Program
266 +* msgfilter:: Invoking the @code{msgfilter} Program
267 +* msguniq:: Invoking the @code{msguniq} Program
268 +* msgcomm:: Invoking the @code{msgcomm} Program
269 +* msgcmp:: Invoking the @code{msgcmp} Program
270 +* msgattrib:: Invoking the @code{msgattrib} Program
271 +* msgen:: Invoking the @code{msgen} Program
272 +* msgexec:: Invoking the @code{msgexec} Program
273 * libgettextpo:: Writing your own programs that process PO files
276 -@node msgcat Invocation, msgconv Invocation, Manipulating, Manipulating
277 +@node msgcat, msgconv, Manipulating, Manipulating
278 @section Invoking the @code{msgcat} Program
282 -@node msgconv Invocation, msggrep Invocation, msgcat Invocation, Manipulating
283 +@node msgconv, msggrep, msgcat, Manipulating
284 @section Invoking the @code{msgconv} Program
286 @include msgconv.texi
288 -@node msggrep Invocation, msgfilter Invocation, msgconv Invocation, Manipulating
289 +@node msggrep, msgfilter, msgconv, Manipulating
290 @section Invoking the @code{msggrep} Program
292 @include msggrep.texi
294 -@node msgfilter Invocation, msguniq Invocation, msggrep Invocation, Manipulating
295 +@node msgfilter, msguniq, msggrep, Manipulating
296 @section Invoking the @code{msgfilter} Program
298 @include msgfilter.texi
300 -@node msguniq Invocation, msgcomm Invocation, msgfilter Invocation, Manipulating
301 +@node msguniq, msgcomm, msgfilter, Manipulating
302 @section Invoking the @code{msguniq} Program
304 @include msguniq.texi
306 -@node msgcomm Invocation, msgcmp Invocation, msguniq Invocation, Manipulating
307 +@node msgcomm, msgcmp, msguniq, Manipulating
308 @section Invoking the @code{msgcomm} Program
310 @include msgcomm.texi
312 -@node msgcmp Invocation, msgattrib Invocation, msgcomm Invocation, Manipulating
313 +@node msgcmp, msgattrib, msgcomm, Manipulating
314 @section Invoking the @code{msgcmp} Program
318 -@node msgattrib Invocation, msgen Invocation, msgcmp Invocation, Manipulating
319 +@node msgattrib, msgen, msgcmp, Manipulating
320 @section Invoking the @code{msgattrib} Program
322 @include msgattrib.texi
324 -@node msgen Invocation, msgexec Invocation, msgattrib Invocation, Manipulating
325 +@node msgen, msgexec, msgattrib, Manipulating
326 @section Invoking the @code{msgen} Program
330 -@node msgexec Invocation, libgettextpo, msgen Invocation, Manipulating
331 +@node msgexec, libgettextpo, msgen, Manipulating
332 @section Invoking the @code{msgexec} Program
334 @include msgexec.texi
336 -@node libgettextpo, , msgexec Invocation, Manipulating
337 +@node libgettextpo, , msgexec, Manipulating
338 @section Writing your own programs that process PO files
340 For the tasks for which a combination of @samp{msgattrib}, @samp{msgcat} etc.
341 @@ -4002,22 +4001,22 @@
345 -* msgfmt Invocation:: Invoking the @code{msgfmt} Program
346 -* msgunfmt Invocation:: Invoking the @code{msgunfmt} Program
347 +* msgfmt:: Invoking the @code{msgfmt} Program
348 +* msgunfmt:: Invoking the @code{msgunfmt} Program
349 * MO Files:: The Format of GNU MO Files
352 -@node msgfmt Invocation, msgunfmt Invocation, Binaries, Binaries
353 +@node msgfmt, msgunfmt, Binaries, Binaries
354 @section Invoking the @code{msgfmt} Program
358 -@node msgunfmt Invocation, MO Files, msgfmt Invocation, Binaries
359 +@node msgunfmt, MO Files, msgfmt, Binaries
360 @section Invoking the @code{msgunfmt} Program
362 @include msgunfmt.texi
364 -@node MO Files, , msgunfmt Invocation, Binaries
365 +@node MO Files, , msgunfmt, Binaries
366 @section The Format of GNU MO Files
367 @cindex MO file's format
368 @cindex file format, @file{.mo}
369 @@ -6014,7 +6013,7 @@
371 * Flat and Non-Flat:: Flat or Non-Flat Directory Structures
372 * Prerequisites:: Prerequisite Works
373 -* gettextize Invocation:: Invoking the @code{gettextize} Program
374 +* gettextize:: Invoking the @code{gettextize} Program
375 * Adjusting Files:: Files You Must Create or Alter
376 * autoconf macros:: Autoconf macros for use in @file{configure.in}
377 * CVS Issues:: Integrating with CVS
378 @@ -6046,7 +6045,7 @@
379 described in the remaining of this chapter. Some maintainers might
380 use this as an opportunity to unflatten their package structure.
382 -@node Prerequisites, gettextize Invocation, Flat and Non-Flat, Maintainers
383 +@node Prerequisites, gettextize, Flat and Non-Flat, Maintainers
384 @section Prerequisite Works
385 @cindex converting a package to use @code{gettext}
386 @cindex migration from earlier versions of @code{gettext}
387 @@ -6131,12 +6130,12 @@
388 a maintainer, ever think there is a real problem with a team, please
389 never try to @emph{solve} a team's problem on your own.
391 -@node gettextize Invocation, Adjusting Files, Prerequisites, Maintainers
392 +@node gettextize, Adjusting Files, Prerequisites, Maintainers
393 @section Invoking the @code{gettextize} Program
395 @include gettextize.texi
397 -@node Adjusting Files, autoconf macros, gettextize Invocation, Maintainers
398 +@node Adjusting Files, autoconf macros, gettextize, Maintainers
399 @section Files You Must Create or Alter
400 @cindex @code{gettext} files
402 @@ -6911,7 +6910,7 @@
404 * Distributed CVS:: Avoiding version mismatch in distributed development
405 * Files under CVS:: Files to put under CVS version control
406 -* autopoint Invocation:: Invoking the @code{autopoint} Program
407 +* autopoint:: Invoking the @code{autopoint} Program
410 @node Distributed CVS, Files under CVS, CVS Issues, CVS Issues
411 @@ -6953,7 +6952,7 @@
412 undiscovered due to this constellation.
415 -@node Files under CVS, autopoint Invocation, Distributed CVS, CVS Issues
416 +@node Files under CVS, autopoint, Distributed CVS, CVS Issues
417 @subsection Files to put under CVS version control
419 There are basically three ways to deal with generated files in the
420 @@ -7020,7 +7019,7 @@
421 @code{autopoint} invocation will copy into the right place the
422 @code{gettext} infrastructure files that have been omitted from the CVS.
424 -@node autopoint Invocation, , Files under CVS, CVS Issues
425 +@node autopoint, , Files under CVS, CVS Issues
426 @subsection Invoking the @code{autopoint} Program
428 @include autopoint.texi
429 --- gettext-0.12.1/gettext-tools/doc/gettextize.texi.orig 2003-05-05 11:09:21.000000000 +0200
430 +++ gettext-0.12.1/gettext-tools/doc/gettextize.texi 2003-06-07 20:10:53.000000000 +0200
432 of the GNU build system, in the sense that it should not be invoked
433 automatically, and not be invoked by someone who doesn't assume the
434 responsibilities of a package maintainer. For the latter purpose, a
435 -separate tool is provided, see @ref{autopoint Invocation}.
436 +separate tool is provided, see @ref{autopoint}.
437 --- gettext-0.13/gettext-runtime/libasprintf/autosprintf.texi.orig Fri May 30 16:30:21 2003
438 +++ gettext-0.13/gettext-runtime/libasprintf/autosprintf.texi Mon Dec 1 15:52:12 2003
443 -@dircategory C++ libraries
444 +@dircategory Libraries:
446 -* autosprintf: (autosprintf). Support for printf format strings in C++.
447 +* autosprintf: (autosprintf). Support for printf format strings in C++