]>
Commit | Line | Data |
---|---|---|
58cffd6f JB |
1 | --- gettext-0.17/gettext-tools/doc/gettext.texi.orig 2007-10-31 13:34:45.000000000 +0100 |
2 | +++ gettext-0.17/gettext-tools/doc/gettext.texi 2007-11-07 22:18:00.237953165 +0100 | |
3 | @@ -47,30 +47,30 @@ | |
695d0251 | 4 | @include version.texi |
5 | ||
2821a860 | 6 | @ifinfo |
695d0251 | 7 | -@dircategory GNU Gettext Utilities |
a60ed400 | 8 | +@dircategory Programming tools: |
695d0251 | 9 | @direntry |
5610ebc0 JB |
10 | -* gettext: (gettext). GNU gettext utilities. |
11 | -* autopoint: (gettext)autopoint Invocation. Copy gettext infrastructure. | |
463b2d6c | 12 | -* envsubst: (gettext)envsubst Invocation. Expand environment variables. |
5610ebc0 JB |
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. | |
463b2d6c | 28 | -* ngettext: (gettext)ngettext Invocation. Translate a message with plural. |
5610ebc0 JB |
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 | |
463b2d6c | 34 | +* envsubst: (gettext)envsubst. Expand environment variables |
5610ebc0 JB |
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 | |
463b2d6c | 50 | +* ngettext: (gettext)ngettext. Translate a message with plural |
5610ebc0 JB |
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 | |
695d0251 | 54 | @end direntry |
2821a860 | 55 | @end ifinfo |
695d0251 | 56 | |
58cffd6f | 57 | @@ -216,16 +216,16 @@ |
695d0251 | 58 | |
a60ed400 | 59 | Making the PO Template File |
695d0251 | 60 | |
61 | -* xgettext Invocation:: Invoking the @code{xgettext} Program | |
1c3db853 MM |
62 | +* xgettext:: Invoking the @code{xgettext} Program |
63 | ||
64 | Creating a New PO File | |
65 | ||
66 | -* msginit Invocation:: Invoking the @code{msginit} Program | |
67 | +* msginit:: Invoking the @code{msginit} Program | |
68 | * Header Entry:: Filling in the Header Entry | |
695d0251 | 69 | |
70 | Updating Existing PO Files | |
71 | ||
72 | -* msgmerge Invocation:: Invoking the @code{msgmerge} Program | |
1c3db853 | 73 | +* msgmerge:: Invoking the @code{msgmerge} Program |
2821a860 JB |
74 | |
75 | Editing PO Files | |
76 | ||
58cffd6f | 77 | @@ -257,16 +257,16 @@ |
1c3db853 MM |
78 | |
79 | Manipulating PO Files | |
80 | ||
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 | |
58cffd6f | 101 | * Colorizing:: Highlighting parts of PO files |
5610ebc0 | 102 | * libgettextpo:: Writing your own programs that process PO files |
695d0251 | 103 | |
58cffd6f JB |
104 | @@ -280,8 +280,8 @@ |
105 | ||
695d0251 | 106 | Producing Binary MO Files |
107 | ||
108 | -* msgfmt Invocation:: Invoking the @code{msgfmt} Program | |
1c3db853 MM |
109 | -* msgunfmt Invocation:: Invoking the @code{msgunfmt} Program |
110 | +* msgfmt:: Invoking the @code{msgfmt} Program | |
111 | +* msgunfmt:: Invoking the @code{msgunfmt} Program | |
695d0251 | 112 | * MO Files:: The Format of GNU MO Files |
113 | ||
2821a860 | 114 | The Programmer's View |
58cffd6f | 115 | @@ -339,7 +339,7 @@ |
695d0251 | 116 | |
117 | * Flat and Non-Flat:: Flat or Non-Flat Directory Structures | |
118 | * Prerequisites:: Prerequisite Works | |
119 | -* gettextize Invocation:: Invoking the @code{gettextize} Program | |
1c3db853 | 120 | +* gettextize:: Invoking the @code{gettextize} Program |
695d0251 | 121 | * Adjusting Files:: Files You Must Create or Alter |
58cffd6f | 122 | * autoconf macros:: Autoconf macros for use in @file{configure.ac} |
5610ebc0 | 123 | * CVS Issues:: Integrating with CVS |
58cffd6f | 124 | @@ -374,7 +374,7 @@ |
695d0251 | 125 | |
5610ebc0 JB |
126 | * Distributed CVS:: Avoiding version mismatch in distributed development |
127 | * Files under CVS:: Files to put under CVS version control | |
128 | -* autopoint Invocation:: Invoking the @code{autopoint} Program | |
129 | +* autopoint:: Invoking the @code{autopoint} Program | |
130 | ||
131 | Other Programming Languages | |
132 | ||
58cffd6f | 133 | @@ -438,10 +438,10 @@ |
463b2d6c JB |
134 | * Preparing Shell Scripts:: Preparing Shell Scripts for Internationalization |
135 | * gettext.sh:: Contents of @code{gettext.sh} | |
2821a860 | 136 | * gettext Invocation:: Invoking the @code{gettext} program |
463b2d6c JB |
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 | |
463b2d6c JB |
141 | +* ngettext:: Invoking the @code{ngettext} program |
142 | +* envsubst:: Invoking the @code{envsubst} program | |
143 | +* eval_gettext:: Invoking the @code{eval_gettext} function | |
144 | +* eval_ngettext:: Invoking the @code{eval_ngettext} function | |
145 | ||
146 | Perl | |
147 | ||
58cffd6f | 148 | @@ -987,7 +987,7 @@ |
695d0251 | 149 | exactly where in C sources each string is used. All translations |
5610ebc0 | 150 | are set to empty. The letter @code{t} in @file{.pot} marks this as |
695d0251 | 151 | a Template PO file, not yet oriented towards any particular language. |
152 | -@xref{xgettext Invocation}, for more details about how one calls the | |
153 | +@xref{xgettext}, for more details about how one calls the | |
154 | @code{xgettext} program. If you are @emph{really} lazy, you might | |
155 | be interested at working a lot more right away, and preparing the | |
156 | whole distribution setup (@pxref{Maintainers}). By doing so, you | |
58cffd6f | 157 | @@ -1062,7 +1062,7 @@ |
695d0251 | 158 | which are no longer used in the program sources (@pxref{Obsolete |
159 | Entries}). It finally discovers new strings and inserts them in | |
160 | the resulting PO file as untranslated entries (@pxref{Untranslated | |
161 | -Entries}). @xref{msgmerge Invocation}, for more information about what | |
162 | +Entries}). @xref{msgmerge}, for more information about what | |
163 | @code{msgmerge} really does. | |
164 | ||
165 | Whatever route or means taken, the goal is to obtain an updated | |
58cffd6f | 166 | @@ -1086,8 +1086,8 @@ |
695d0251 | 167 | Once the PO file is complete and dependable, the @code{msgfmt} program |
168 | is used for turning the PO file into a machine-oriented format, which | |
169 | may yield efficient retrieval of translations by the programs of the | |
170 | -package, whenever needed at runtime (@pxref{MO Files}). @xref{msgfmt | |
1c3db853 | 171 | -Invocation}, for more information about all modes of execution |
695d0251 | 172 | +package, whenever needed at runtime (@pxref{MO Files}). @xref{msgfmt}, |
1c3db853 MM |
173 | +for more information about all modes of execution |
174 | for the @code{msgfmt} program. | |
695d0251 | 175 | |
176 | Finally, the modified and marked C sources are compiled and linked | |
58cffd6f | 177 | @@ -1482,7 +1482,7 @@ |
695d0251 | 178 | |
5610ebc0 | 179 | In case the @code{c-format} flag is given for a string the @code{msgfmt} |
695d0251 | 180 | does some more tests to check to validity of the translation. |
5610ebc0 JB |
181 | -@xref{msgfmt Invocation}, @ref{c-format Flag} and @ref{c-format}. |
182 | +@xref{msgfmt}, @ref{c-format Flag} and @ref{c-format}. | |
695d0251 | 183 | |
463b2d6c JB |
184 | @item objc-format |
185 | @kwindex objc-format@r{ flag} | |
58cffd6f | 186 | @@ -2474,7 +2474,7 @@ |
695d0251 | 187 | |
5610ebc0 | 188 | If a string is marked with @code{c-format} and this is not correct the |
a60ed400 | 189 | user can find out who is responsible for the decision. See |
5610ebc0 JB |
190 | -@ref{xgettext Invocation} to see how the @code{--debug} option can be |
191 | +@ref{xgettext} to see how the @code{--debug} option can be | |
a60ed400 | 192 | used for solving this problem. |
695d0251 | 193 | |
58cffd6f JB |
194 | @node Special cases, Bug Report Address, c-format Flag, Sources |
195 | @@ -2506,7 +2506,7 @@ | |
695d0251 | 196 | While it is no problem to mark the string @code{"a default message"} it |
197 | is not possible to mark the string initializers for @code{messages}. | |
198 | What is to be done? We have to fulfill two tasks. First we have to mark the | |
199 | -strings so that the @code{xgettext} program (@pxref{xgettext Invocation}) | |
200 | +strings so that the @code{xgettext} program (@pxref{xgettext}) | |
201 | can find them, and second we have to translate the string at runtime | |
202 | before printing them. | |
203 | ||
58cffd6f | 204 | @@ -2536,8 +2536,7 @@ |
695d0251 | 205 | |
206 | Please convince yourself that the string which is written by | |
207 | @code{fputs} is translated in any case. How to get @code{xgettext} know | |
208 | -the additional keyword @code{gettext_noop} is explained in @ref{xgettext | |
209 | -Invocation}. | |
210 | +the additional keyword @code{gettext_noop} is explained in @ref{xgettext}. | |
211 | ||
212 | The above is of course not the only solution. You could also come along | |
213 | with the following one: | |
58cffd6f | 214 | @@ -2813,10 +2812,10 @@ |
695d0251 | 215 | @c FIXME: Rewrite. |
216 | ||
217 | @menu | |
218 | -* xgettext Invocation:: Invoking the @code{xgettext} Program | |
1c3db853 | 219 | +* xgettext:: Invoking the @code{xgettext} Program |
695d0251 | 220 | @end menu |
221 | ||
a60ed400 | 222 | -@node xgettext Invocation, , Template, Template |
223 | +@node xgettext, , Template, Template | |
695d0251 | 224 | @section Invoking the @code{xgettext} Program |
225 | ||
1c3db853 | 226 | @include xgettext.texi |
58cffd6f | 227 | @@ -2845,16 +2844,16 @@ |
1c3db853 MM |
228 | the header entry of this file. |
229 | ||
230 | @menu | |
231 | -* msginit Invocation:: Invoking the @code{msginit} Program | |
232 | +* msginit:: Invoking the @code{msginit} Program | |
233 | * Header Entry:: Filling in the Header Entry | |
234 | @end menu | |
235 | ||
236 | -@node msginit Invocation, Header Entry, Creating, Creating | |
237 | +@node msginit, Header Entry, Creating, Creating | |
238 | @section Invoking the @code{msginit} Program | |
239 | ||
240 | @include msginit.texi | |
241 | ||
242 | -@node Header Entry, , msginit Invocation, Creating | |
243 | +@node Header Entry, , msginit, Creating | |
244 | @section Filling in the Header Entry | |
245 | @cindex header entry of a PO file | |
246 | ||
58cffd6f | 247 | @@ -3028,10 +3027,10 @@ |
2821a860 | 248 | @chapter Updating Existing PO Files |
695d0251 | 249 | |
250 | @menu | |
251 | -* msgmerge Invocation:: Invoking the @code{msgmerge} Program | |
1c3db853 | 252 | +* msgmerge:: Invoking the @code{msgmerge} Program |
695d0251 | 253 | @end menu |
254 | ||
2821a860 JB |
255 | -@node msgmerge Invocation, , Updating, Updating |
256 | +@node msgmerge, , Updating, Updating | |
695d0251 | 257 | @section Invoking the @code{msgmerge} Program |
258 | ||
1c3db853 | 259 | @include msgmerge.texi |
58cffd6f | 260 | @@ -4571,71 +4570,71 @@ |
5610ebc0 | 261 | write other specialized programs that process PO files. |
1c3db853 MM |
262 | |
263 | @menu | |
264 | -* msgcat Invocation:: Invoking the @code{msgcat} Program | |
265 | -* msgconv Invocation:: Invoking the @code{msgconv} Program | |
266 | -* msggrep Invocation:: Invoking the @code{msggrep} Program | |
267 | -* msgfilter Invocation:: Invoking the @code{msgfilter} Program | |
268 | -* msguniq Invocation:: Invoking the @code{msguniq} Program | |
269 | -* msgcomm Invocation:: Invoking the @code{msgcomm} Program | |
270 | -* msgcmp Invocation:: Invoking the @code{msgcmp} Program | |
271 | -* msgattrib Invocation:: Invoking the @code{msgattrib} Program | |
272 | -* msgen Invocation:: Invoking the @code{msgen} Program | |
273 | -* msgexec Invocation:: Invoking the @code{msgexec} Program | |
274 | +* msgcat:: Invoking the @code{msgcat} Program | |
275 | +* msgconv:: Invoking the @code{msgconv} Program | |
276 | +* msggrep:: Invoking the @code{msggrep} Program | |
277 | +* msgfilter:: Invoking the @code{msgfilter} Program | |
278 | +* msguniq:: Invoking the @code{msguniq} Program | |
279 | +* msgcomm:: Invoking the @code{msgcomm} Program | |
280 | +* msgcmp:: Invoking the @code{msgcmp} Program | |
281 | +* msgattrib:: Invoking the @code{msgattrib} Program | |
282 | +* msgen:: Invoking the @code{msgen} Program | |
283 | +* msgexec:: Invoking the @code{msgexec} Program | |
58cffd6f | 284 | * Colorizing:: Highlighting parts of PO files |
5610ebc0 | 285 | * libgettextpo:: Writing your own programs that process PO files |
1c3db853 MM |
286 | @end menu |
287 | ||
288 | -@node msgcat Invocation, msgconv Invocation, Manipulating, Manipulating | |
289 | +@node msgcat, msgconv, Manipulating, Manipulating | |
290 | @section Invoking the @code{msgcat} Program | |
291 | ||
292 | @include msgcat.texi | |
293 | ||
294 | -@node msgconv Invocation, msggrep Invocation, msgcat Invocation, Manipulating | |
295 | +@node msgconv, msggrep, msgcat, Manipulating | |
296 | @section Invoking the @code{msgconv} Program | |
297 | ||
298 | @include msgconv.texi | |
299 | ||
300 | -@node msggrep Invocation, msgfilter Invocation, msgconv Invocation, Manipulating | |
301 | +@node msggrep, msgfilter, msgconv, Manipulating | |
302 | @section Invoking the @code{msggrep} Program | |
a60ed400 | 303 | |
1c3db853 MM |
304 | @include msggrep.texi |
305 | ||
306 | -@node msgfilter Invocation, msguniq Invocation, msggrep Invocation, Manipulating | |
307 | +@node msgfilter, msguniq, msggrep, Manipulating | |
308 | @section Invoking the @code{msgfilter} Program | |
309 | ||
310 | @include msgfilter.texi | |
311 | ||
312 | -@node msguniq Invocation, msgcomm Invocation, msgfilter Invocation, Manipulating | |
313 | +@node msguniq, msgcomm, msgfilter, Manipulating | |
314 | @section Invoking the @code{msguniq} Program | |
315 | ||
316 | @include msguniq.texi | |
317 | ||
318 | -@node msgcomm Invocation, msgcmp Invocation, msguniq Invocation, Manipulating | |
319 | +@node msgcomm, msgcmp, msguniq, Manipulating | |
320 | @section Invoking the @code{msgcomm} Program | |
321 | ||
322 | @include msgcomm.texi | |
323 | ||
324 | -@node msgcmp Invocation, msgattrib Invocation, msgcomm Invocation, Manipulating | |
325 | +@node msgcmp, msgattrib, msgcomm, Manipulating | |
326 | @section Invoking the @code{msgcmp} Program | |
327 | ||
328 | @include msgcmp.texi | |
329 | ||
330 | -@node msgattrib Invocation, msgen Invocation, msgcmp Invocation, Manipulating | |
331 | +@node msgattrib, msgen, msgcmp, Manipulating | |
332 | @section Invoking the @code{msgattrib} Program | |
333 | ||
334 | @include msgattrib.texi | |
335 | ||
336 | -@node msgen Invocation, msgexec Invocation, msgattrib Invocation, Manipulating | |
337 | +@node msgen, msgexec, msgattrib, Manipulating | |
338 | @section Invoking the @code{msgen} Program | |
339 | ||
340 | @include msgen.texi | |
341 | ||
58cffd6f JB |
342 | -@node msgexec Invocation, Colorizing, msgen Invocation, Manipulating |
343 | +@node msgexec, Colorizing, msgen, Manipulating | |
1c3db853 MM |
344 | @section Invoking the @code{msgexec} Program |
345 | ||
346 | @include msgexec.texi | |
5610ebc0 | 347 | |
58cffd6f JB |
348 | -@node Colorizing, libgettextpo, msgexec Invocation, Manipulating |
349 | +@node Colorizing, libgettextpo, msgexec, Manipulating | |
350 | @section Highlighting parts of PO files | |
5610ebc0 | 351 | |
58cffd6f JB |
352 | Translators are usually only interested in seeing the untranslated and |
353 | @@ -5165,22 +5164,22 @@ | |
695d0251 | 354 | @c FIXME: Rewrite. |
355 | ||
356 | @menu | |
357 | -* msgfmt Invocation:: Invoking the @code{msgfmt} Program | |
1c3db853 MM |
358 | -* msgunfmt Invocation:: Invoking the @code{msgunfmt} Program |
359 | +* msgfmt:: Invoking the @code{msgfmt} Program | |
360 | +* msgunfmt:: Invoking the @code{msgunfmt} Program | |
695d0251 | 361 | * MO Files:: The Format of GNU MO Files |
362 | @end menu | |
363 | ||
1c3db853 MM |
364 | -@node msgfmt Invocation, msgunfmt Invocation, Binaries, Binaries |
365 | +@node msgfmt, msgunfmt, Binaries, Binaries | |
695d0251 | 366 | @section Invoking the @code{msgfmt} Program |
367 | ||
1c3db853 | 368 | @include msgfmt.texi |
695d0251 | 369 | |
1c3db853 MM |
370 | -@node msgunfmt Invocation, MO Files, msgfmt Invocation, Binaries |
371 | +@node msgunfmt, MO Files, msgfmt, Binaries | |
372 | @section Invoking the @code{msgunfmt} Program | |
373 | ||
374 | @include msgunfmt.texi | |
695d0251 | 375 | |
1c3db853 MM |
376 | -@node MO Files, , msgunfmt Invocation, Binaries |
377 | +@node MO Files, , msgunfmt, Binaries | |
378 | @section The Format of GNU MO Files | |
379 | @cindex MO file's format | |
380 | @cindex file format, @file{.mo} | |
58cffd6f | 381 | @@ -7250,7 +7249,7 @@ |
695d0251 | 382 | @menu |
383 | * Flat and Non-Flat:: Flat or Non-Flat Directory Structures | |
384 | * Prerequisites:: Prerequisite Works | |
385 | -* gettextize Invocation:: Invoking the @code{gettextize} Program | |
1c3db853 | 386 | +* gettextize:: Invoking the @code{gettextize} Program |
695d0251 | 387 | * Adjusting Files:: Files You Must Create or Alter |
58cffd6f | 388 | * autoconf macros:: Autoconf macros for use in @file{configure.ac} |
5610ebc0 | 389 | * CVS Issues:: Integrating with CVS |
58cffd6f | 390 | @@ -7283,7 +7282,7 @@ |
a60ed400 | 391 | described in the remaining of this chapter. Some maintainers might |
392 | use this as an opportunity to unflatten their package structure. | |
695d0251 | 393 | |
394 | -@node Prerequisites, gettextize Invocation, Flat and Non-Flat, Maintainers | |
395 | +@node Prerequisites, gettextize, Flat and Non-Flat, Maintainers | |
396 | @section Prerequisite Works | |
1c3db853 MM |
397 | @cindex converting a package to use @code{gettext} |
398 | @cindex migration from earlier versions of @code{gettext} | |
58cffd6f | 399 | @@ -7368,12 +7367,12 @@ |
695d0251 | 400 | a maintainer, ever think there is a real problem with a team, please |
401 | never try to @emph{solve} a team's problem on your own. | |
402 | ||
403 | -@node gettextize Invocation, Adjusting Files, Prerequisites, Maintainers | |
404 | +@node gettextize, Adjusting Files, Prerequisites, Maintainers | |
405 | @section Invoking the @code{gettextize} Program | |
406 | ||
5610ebc0 | 407 | @include gettextize.texi |
695d0251 | 408 | |
1c3db853 MM |
409 | -@node Adjusting Files, autoconf macros, gettextize Invocation, Maintainers |
410 | +@node Adjusting Files, autoconf macros, gettextize, Maintainers | |
695d0251 | 411 | @section Files You Must Create or Alter |
1c3db853 | 412 | @cindex @code{gettext} files |
695d0251 | 413 | |
58cffd6f | 414 | @@ -7536,7 +7535,7 @@ |
2821a860 JB |
415 | Similarly, you can create rules for building message catalogs for the |
416 | @file{sr@@latin} locale -- Serbian written with the Latin alphabet -- | |
417 | from those for the @file{sr} locale -- Serbian written with Cyrillic | |
418 | -letters. See @ref{msgfilter Invocation}. | |
419 | +letters. See @ref{msgfilter}. | |
420 | ||
58cffd6f JB |
421 | @node configure.ac, config.guess, po/Rules-*, Adjusting Files |
422 | @subsection @file{configure.ac} at top level | |
423 | @@ -8258,7 +8257,7 @@ | |
424 | to instruct @code{xgettext} to mark all translatable strings in @samp{gettext} | |
425 | invocations that occur as fifth argument to this function as @samp{c-format}. | |
426 | ||
427 | -See @ref{xgettext Invocation} for the list of options that @code{xgettext} | |
428 | +See @ref{xgettext} for the list of options that @code{xgettext} | |
429 | accepts. | |
430 | ||
431 | The use of this macro is an alternative to the use of the | |
432 | @@ -8326,7 +8325,7 @@ | |
5610ebc0 JB |
433 | @menu |
434 | * Distributed CVS:: Avoiding version mismatch in distributed development | |
435 | * Files under CVS:: Files to put under CVS version control | |
436 | -* autopoint Invocation:: Invoking the @code{autopoint} Program | |
437 | +* autopoint:: Invoking the @code{autopoint} Program | |
438 | @end menu | |
439 | ||
440 | @node Distributed CVS, Files under CVS, CVS Issues, CVS Issues | |
58cffd6f | 441 | @@ -8368,7 +8367,7 @@ |
5610ebc0 JB |
442 | undiscovered due to this constellation. |
443 | @end itemize | |
444 | ||
445 | -@node Files under CVS, autopoint Invocation, Distributed CVS, CVS Issues | |
446 | +@node Files under CVS, autopoint, Distributed CVS, CVS Issues | |
447 | @subsection Files to put under CVS version control | |
448 | ||
449 | There are basically three ways to deal with generated files in the | |
58cffd6f | 450 | @@ -8447,7 +8446,7 @@ |
2821a860 JB |
451 | use the CVS will henceforth need to have GNU @code{gettext} 0.12.1 or newer |
452 | installed. | |
5610ebc0 JB |
453 | |
454 | -@node autopoint Invocation, , Files under CVS, CVS Issues | |
455 | +@node autopoint, , Files under CVS, CVS Issues | |
456 | @subsection Invoking the @code{autopoint} Program | |
457 | ||
458 | @include autopoint.texi | |
58cffd6f | 459 | @@ -9122,10 +9121,10 @@ |
463b2d6c JB |
460 | * Preparing Shell Scripts:: Preparing Shell Scripts for Internationalization |
461 | * gettext.sh:: Contents of @code{gettext.sh} | |
2821a860 | 462 | * gettext Invocation:: Invoking the @code{gettext} program |
463b2d6c JB |
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 | |
463b2d6c JB |
467 | +* ngettext:: Invoking the @code{ngettext} program |
468 | +* envsubst:: Invoking the @code{envsubst} program | |
469 | +* eval_gettext:: Invoking the @code{eval_gettext} function | |
470 | +* eval_ngettext:: Invoking the @code{eval_ngettext} function | |
471 | @end menu | |
472 | ||
473 | @node Preparing Shell Scripts, gettext.sh, sh, sh | |
58cffd6f | 474 | @@ -9146,8 +9145,8 @@ |
463b2d6c JB |
475 | |
476 | near the top of the script. @code{gettext.sh} is a shell function library | |
477 | that provides the functions | |
478 | -@code{eval_gettext} (see @ref{eval_gettext Invocation}) and | |
479 | -@code{eval_ngettext} (see @ref{eval_ngettext Invocation}). | |
480 | +@code{eval_gettext} (see @ref{eval_gettext}) and | |
481 | +@code{eval_ngettext} (see @ref{eval_ngettext}). | |
482 | You have to ensure that @code{gettext.sh} can be found in the @code{PATH}. | |
483 | ||
484 | @item | |
58cffd6f | 485 | @@ -9257,28 +9256,28 @@ |
463b2d6c JB |
486 | and a newline, without interpreting backslashes in the argument string. |
487 | ||
488 | @item eval_gettext | |
489 | -See @ref{eval_gettext Invocation}. | |
490 | +See @ref{eval_gettext}. | |
491 | ||
492 | @item eval_ngettext | |
493 | -See @ref{eval_ngettext Invocation}. | |
494 | +See @ref{eval_ngettext}. | |
495 | @end itemize | |
496 | ||
497 | -@node gettext Invocation, ngettext Invocation, gettext.sh, sh | |
498 | +@node gettext Invocation, ngettext, gettext.sh, sh | |
499 | @subsubsection Invoking the @code{gettext} program | |
500 | ||
501 | @include rt-gettext.texi | |
502 | ||
503 | -@node ngettext Invocation, envsubst Invocation, gettext Invocation, sh | |
504 | +@node ngettext, envsubst, gettext Invocation, sh | |
505 | @subsubsection Invoking the @code{ngettext} program | |
506 | ||
507 | @include rt-ngettext.texi | |
508 | ||
509 | -@node envsubst Invocation, eval_gettext Invocation, ngettext Invocation, sh | |
510 | +@node envsubst, eval_gettext, ngettext, sh | |
511 | @subsubsection Invoking the @code{envsubst} program | |
512 | ||
513 | @include rt-envsubst.texi | |
514 | ||
515 | -@node eval_gettext Invocation, eval_ngettext Invocation, envsubst Invocation, sh | |
516 | +@node eval_gettext, eval_ngettext, envsubst, sh | |
517 | @subsubsection Invoking the @code{eval_gettext} function | |
518 | ||
519 | @cindex @code{eval_gettext} function, usage | |
58cffd6f | 520 | @@ -9291,7 +9290,7 @@ |
463b2d6c JB |
521 | performing dollar-substitution on the result. Note that only shell variables |
522 | mentioned in @var{msgid} will be dollar-substituted in the result. | |
523 | ||
524 | -@node eval_ngettext Invocation, , eval_gettext Invocation, sh | |
525 | +@node eval_ngettext, , eval_gettext, sh | |
526 | @subsubsection Invoking the @code{eval_ngettext} function | |
527 | ||
528 | @cindex @code{eval_ngettext} function, usage | |
5610ebc0 JB |
529 | --- gettext-0.12.1/gettext-tools/doc/gettextize.texi.orig 2003-05-05 11:09:21.000000000 +0200 |
530 | +++ gettext-0.12.1/gettext-tools/doc/gettextize.texi 2003-06-07 20:10:53.000000000 +0200 | |
531 | @@ -177,4 +177,4 @@ | |
532 | of the GNU build system, in the sense that it should not be invoked | |
533 | automatically, and not be invoked by someone who doesn't assume the | |
534 | responsibilities of a package maintainer. For the latter purpose, a | |
535 | -separate tool is provided, see @ref{autopoint Invocation}. | |
536 | +separate tool is provided, see @ref{autopoint}. | |
58cffd6f JB |
537 | --- gettext-0.17/gettext-runtime/libasprintf/autosprintf.texi.orig 2007-09-01 11:15:56.000000000 +0200 |
538 | +++ gettext-0.17/gettext-runtime/libasprintf/autosprintf.texi 2007-11-07 22:19:42.123759307 +0100 | |
539 | @@ -23,9 +23,9 @@ | |
5610ebc0 JB |
540 | @set VERSION 1.0 |
541 | ||
58cffd6f | 542 | @ifinfo |
dcb2f557 | 543 | -@dircategory C++ libraries |
5610ebc0 JB |
544 | +@dircategory Libraries: |
545 | @direntry | |
dcb2f557 JB |
546 | -* autosprintf: (autosprintf). Support for printf format strings in C++. |
547 | +* autosprintf: (autosprintf). Support for printf format strings in C++ | |
5610ebc0 | 548 | @end direntry |
58cffd6f | 549 | @end ifinfo |
5610ebc0 | 550 |