]>
Commit | Line | Data |
---|---|---|
7b41bcc0 JB |
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 | |
3 | @@ -36,30 +36,30 @@ | |
70ba7319 | 4 | @include version.texi |
5 | ||
7b41bcc0 | 6 | @ifinfo |
70ba7319 | 7 | -@dircategory GNU Gettext Utilities |
a33824de | 8 | +@dircategory Programming tools: |
70ba7319 | 9 | @direntry |
b3cd56fc JB |
10 | -* gettext: (gettext). GNU gettext utilities. |
11 | -* autopoint: (gettext)autopoint Invocation. Copy gettext infrastructure. | |
1adfdb54 | 12 | -* envsubst: (gettext)envsubst Invocation. Expand environment variables. |
b3cd56fc 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. | |
1adfdb54 | 28 | -* ngettext: (gettext)ngettext Invocation. Translate a message with plural. |
b3cd56fc 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 | |
1adfdb54 | 34 | +* envsubst: (gettext)envsubst. Expand environment variables |
b3cd56fc 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 | |
1adfdb54 | 50 | +* ngettext: (gettext)ngettext. Translate a message with plural |
b3cd56fc 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 | |
70ba7319 | 54 | @end direntry |
7b41bcc0 | 55 | @end ifinfo |
70ba7319 | 56 | |
7b41bcc0 | 57 | @@ -196,16 +196,16 @@ |
70ba7319 | 58 | |
a33824de | 59 | Making the PO Template File |
70ba7319 | 60 | |
61 | -* xgettext Invocation:: Invoking the @code{xgettext} Program | |
0e3f7173 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 | |
70ba7319 | 69 | |
70 | Updating Existing PO Files | |
71 | ||
72 | -* msgmerge Invocation:: Invoking the @code{msgmerge} Program | |
0e3f7173 | 73 | +* msgmerge:: Invoking the @code{msgmerge} Program |
7b41bcc0 JB |
74 | |
75 | Editing PO Files | |
76 | ||
77 | @@ -237,22 +237,22 @@ | |
0e3f7173 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 | |
b3cd56fc | 101 | * libgettextpo:: Writing your own programs that process PO files |
70ba7319 | 102 | |
103 | Producing Binary MO Files | |
104 | ||
105 | -* msgfmt Invocation:: Invoking the @code{msgfmt} Program | |
0e3f7173 MM |
106 | -* msgunfmt Invocation:: Invoking the @code{msgunfmt} Program |
107 | +* msgfmt:: Invoking the @code{msgfmt} Program | |
108 | +* msgunfmt:: Invoking the @code{msgunfmt} Program | |
70ba7319 | 109 | * MO Files:: The Format of GNU MO Files |
110 | ||
7b41bcc0 JB |
111 | The Programmer's View |
112 | @@ -310,7 +310,7 @@ | |
70ba7319 | 113 | |
114 | * Flat and Non-Flat:: Flat or Non-Flat Directory Structures | |
115 | * Prerequisites:: Prerequisite Works | |
116 | -* gettextize Invocation:: Invoking the @code{gettextize} Program | |
0e3f7173 | 117 | +* gettextize:: Invoking the @code{gettextize} Program |
70ba7319 | 118 | * Adjusting Files:: Files You Must Create or Alter |
0e3f7173 | 119 | * autoconf macros:: Autoconf macros for use in @file{configure.in} |
b3cd56fc | 120 | * CVS Issues:: Integrating with CVS |
7b41bcc0 | 121 | @@ -343,7 +343,7 @@ |
70ba7319 | 122 | |
b3cd56fc JB |
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 | |
127 | ||
128 | Other Programming Languages | |
129 | ||
7b41bcc0 | 130 | @@ -406,10 +406,10 @@ |
1adfdb54 JB |
131 | * Preparing Shell Scripts:: Preparing Shell Scripts for Internationalization |
132 | * gettext.sh:: Contents of @code{gettext.sh} | |
7b41bcc0 | 133 | * gettext Invocation:: Invoking the @code{gettext} program |
1adfdb54 JB |
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 | |
1adfdb54 JB |
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 | |
142 | ||
143 | Perl | |
144 | ||
7b41bcc0 | 145 | @@ -936,7 +936,7 @@ |
70ba7319 | 146 | exactly where in C sources each string is used. All translations |
b3cd56fc | 147 | are set to empty. The letter @code{t} in @file{.pot} marks this as |
70ba7319 | 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 | |
7b41bcc0 | 154 | @@ -1011,7 +1011,7 @@ |
70ba7319 | 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. | |
161 | ||
162 | Whatever route or means taken, the goal is to obtain an updated | |
7b41bcc0 | 163 | @@ -1035,8 +1035,8 @@ |
70ba7319 | 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 | |
0e3f7173 | 168 | -Invocation}, for more information about all modes of execution |
70ba7319 | 169 | +package, whenever needed at runtime (@pxref{MO Files}). @xref{msgfmt}, |
0e3f7173 MM |
170 | +for more information about all modes of execution |
171 | for the @code{msgfmt} program. | |
70ba7319 | 172 | |
173 | Finally, the modified and marked C sources are compiled and linked | |
7b41bcc0 | 174 | @@ -1235,7 +1235,7 @@ |
70ba7319 | 175 | |
b3cd56fc | 176 | In case the @code{c-format} flag is given for a string the @code{msgfmt} |
70ba7319 | 177 | does some more tests to check to validity of the translation. |
b3cd56fc JB |
178 | -@xref{msgfmt Invocation}, @ref{c-format Flag} and @ref{c-format}. |
179 | +@xref{msgfmt}, @ref{c-format Flag} and @ref{c-format}. | |
70ba7319 | 180 | |
1adfdb54 JB |
181 | @item objc-format |
182 | @kwindex objc-format@r{ flag} | |
7b41bcc0 | 183 | @@ -2164,7 +2164,7 @@ |
70ba7319 | 184 | |
b3cd56fc | 185 | If a string is marked with @code{c-format} and this is not correct the |
a33824de | 186 | user can find out who is responsible for the decision. See |
b3cd56fc JB |
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 | |
a33824de | 189 | used for solving this problem. |
70ba7319 | 190 | |
b3cd56fc | 191 | @node Special cases, Names, c-format Flag, Sources |
7b41bcc0 | 192 | @@ -2196,7 +2196,7 @@ |
70ba7319 | 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. | |
200 | ||
7b41bcc0 | 201 | @@ -2226,8 +2226,7 @@ |
70ba7319 | 202 | |
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 | |
206 | -Invocation}. | |
207 | +the additional keyword @code{gettext_noop} is explained in @ref{xgettext}. | |
208 | ||
209 | The above is of course not the only solution. You could also come along | |
210 | with the following one: | |
7b41bcc0 | 211 | @@ -2449,10 +2448,10 @@ |
70ba7319 | 212 | @c FIXME: Rewrite. |
213 | ||
214 | @menu | |
215 | -* xgettext Invocation:: Invoking the @code{xgettext} Program | |
0e3f7173 | 216 | +* xgettext:: Invoking the @code{xgettext} Program |
70ba7319 | 217 | @end menu |
218 | ||
a33824de | 219 | -@node xgettext Invocation, , Template, Template |
220 | +@node xgettext, , Template, Template | |
70ba7319 | 221 | @section Invoking the @code{xgettext} Program |
222 | ||
0e3f7173 | 223 | @include xgettext.texi |
7b41bcc0 | 224 | @@ -2481,16 +2480,16 @@ |
0e3f7173 MM |
225 | the header entry of this file. |
226 | ||
227 | @menu | |
228 | -* msginit Invocation:: Invoking the @code{msginit} Program | |
229 | +* msginit:: Invoking the @code{msginit} Program | |
230 | * Header Entry:: Filling in the Header Entry | |
231 | @end menu | |
232 | ||
233 | -@node msginit Invocation, Header Entry, Creating, Creating | |
234 | +@node msginit, Header Entry, Creating, Creating | |
235 | @section Invoking the @code{msginit} Program | |
236 | ||
237 | @include msginit.texi | |
238 | ||
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 | |
243 | ||
7b41bcc0 JB |
244 | @@ -2663,10 +2662,10 @@ |
245 | @chapter Updating Existing PO Files | |
70ba7319 | 246 | |
247 | @menu | |
248 | -* msgmerge Invocation:: Invoking the @code{msgmerge} Program | |
0e3f7173 | 249 | +* msgmerge:: Invoking the @code{msgmerge} Program |
70ba7319 | 250 | @end menu |
251 | ||
7b41bcc0 JB |
252 | -@node msgmerge Invocation, , Updating, Updating |
253 | +@node msgmerge, , Updating, Updating | |
70ba7319 | 254 | @section Invoking the @code{msgmerge} Program |
255 | ||
0e3f7173 | 256 | @include msgmerge.texi |
7b41bcc0 | 257 | @@ -4206,70 +4205,70 @@ |
b3cd56fc | 258 | write other specialized programs that process PO files. |
0e3f7173 MM |
259 | |
260 | @menu | |
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 | |
b3cd56fc | 281 | * libgettextpo:: Writing your own programs that process PO files |
0e3f7173 MM |
282 | @end menu |
283 | ||
284 | -@node msgcat Invocation, msgconv Invocation, Manipulating, Manipulating | |
285 | +@node msgcat, msgconv, Manipulating, Manipulating | |
286 | @section Invoking the @code{msgcat} Program | |
287 | ||
288 | @include msgcat.texi | |
289 | ||
290 | -@node msgconv Invocation, msggrep Invocation, msgcat Invocation, Manipulating | |
291 | +@node msgconv, msggrep, msgcat, Manipulating | |
292 | @section Invoking the @code{msgconv} Program | |
293 | ||
294 | @include msgconv.texi | |
295 | ||
296 | -@node msggrep Invocation, msgfilter Invocation, msgconv Invocation, Manipulating | |
297 | +@node msggrep, msgfilter, msgconv, Manipulating | |
298 | @section Invoking the @code{msggrep} Program | |
a33824de | 299 | |
0e3f7173 MM |
300 | @include msggrep.texi |
301 | ||
302 | -@node msgfilter Invocation, msguniq Invocation, msggrep Invocation, Manipulating | |
303 | +@node msgfilter, msguniq, msggrep, Manipulating | |
304 | @section Invoking the @code{msgfilter} Program | |
305 | ||
306 | @include msgfilter.texi | |
307 | ||
308 | -@node msguniq Invocation, msgcomm Invocation, msgfilter Invocation, Manipulating | |
309 | +@node msguniq, msgcomm, msgfilter, Manipulating | |
310 | @section Invoking the @code{msguniq} Program | |
311 | ||
312 | @include msguniq.texi | |
313 | ||
314 | -@node msgcomm Invocation, msgcmp Invocation, msguniq Invocation, Manipulating | |
315 | +@node msgcomm, msgcmp, msguniq, Manipulating | |
316 | @section Invoking the @code{msgcomm} Program | |
317 | ||
318 | @include msgcomm.texi | |
319 | ||
320 | -@node msgcmp Invocation, msgattrib Invocation, msgcomm Invocation, Manipulating | |
321 | +@node msgcmp, msgattrib, msgcomm, Manipulating | |
322 | @section Invoking the @code{msgcmp} Program | |
323 | ||
324 | @include msgcmp.texi | |
325 | ||
326 | -@node msgattrib Invocation, msgen Invocation, msgcmp Invocation, Manipulating | |
327 | +@node msgattrib, msgen, msgcmp, Manipulating | |
328 | @section Invoking the @code{msgattrib} Program | |
329 | ||
330 | @include msgattrib.texi | |
331 | ||
332 | -@node msgen Invocation, msgexec Invocation, msgattrib Invocation, Manipulating | |
333 | +@node msgen, msgexec, msgattrib, Manipulating | |
334 | @section Invoking the @code{msgen} Program | |
335 | ||
336 | @include msgen.texi | |
337 | ||
b3cd56fc JB |
338 | -@node msgexec Invocation, libgettextpo, msgen Invocation, Manipulating |
339 | +@node msgexec, libgettextpo, msgen, Manipulating | |
0e3f7173 MM |
340 | @section Invoking the @code{msgexec} Program |
341 | ||
342 | @include msgexec.texi | |
b3cd56fc JB |
343 | |
344 | -@node libgettextpo, , msgexec Invocation, Manipulating | |
345 | +@node libgettextpo, , msgexec, Manipulating | |
346 | @section Writing your own programs that process PO files | |
347 | ||
348 | For the tasks for which a combination of @samp{msgattrib}, @samp{msgcat} etc. | |
7b41bcc0 | 349 | @@ -4403,22 +4402,22 @@ |
70ba7319 | 350 | @c FIXME: Rewrite. |
351 | ||
352 | @menu | |
353 | -* msgfmt Invocation:: Invoking the @code{msgfmt} Program | |
0e3f7173 MM |
354 | -* msgunfmt Invocation:: Invoking the @code{msgunfmt} Program |
355 | +* msgfmt:: Invoking the @code{msgfmt} Program | |
356 | +* msgunfmt:: Invoking the @code{msgunfmt} Program | |
70ba7319 | 357 | * MO Files:: The Format of GNU MO Files |
358 | @end menu | |
359 | ||
0e3f7173 MM |
360 | -@node msgfmt Invocation, msgunfmt Invocation, Binaries, Binaries |
361 | +@node msgfmt, msgunfmt, Binaries, Binaries | |
70ba7319 | 362 | @section Invoking the @code{msgfmt} Program |
363 | ||
0e3f7173 | 364 | @include msgfmt.texi |
70ba7319 | 365 | |
0e3f7173 MM |
366 | -@node msgunfmt Invocation, MO Files, msgfmt Invocation, Binaries |
367 | +@node msgunfmt, MO Files, msgfmt, Binaries | |
368 | @section Invoking the @code{msgunfmt} Program | |
369 | ||
370 | @include msgunfmt.texi | |
70ba7319 | 371 | |
0e3f7173 MM |
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} | |
7b41bcc0 | 377 | @@ -6407,7 +6406,7 @@ |
70ba7319 | 378 | @menu |
379 | * Flat and Non-Flat:: Flat or Non-Flat Directory Structures | |
380 | * Prerequisites:: Prerequisite Works | |
381 | -* gettextize Invocation:: Invoking the @code{gettextize} Program | |
0e3f7173 | 382 | +* gettextize:: Invoking the @code{gettextize} Program |
70ba7319 | 383 | * Adjusting Files:: Files You Must Create or Alter |
0e3f7173 | 384 | * autoconf macros:: Autoconf macros for use in @file{configure.in} |
b3cd56fc | 385 | * CVS Issues:: Integrating with CVS |
7b41bcc0 | 386 | @@ -6440,7 +6439,7 @@ |
a33824de | 387 | described in the remaining of this chapter. Some maintainers might |
388 | use this as an opportunity to unflatten their package structure. | |
70ba7319 | 389 | |
390 | -@node Prerequisites, gettextize Invocation, Flat and Non-Flat, Maintainers | |
391 | +@node Prerequisites, gettextize, Flat and Non-Flat, Maintainers | |
392 | @section Prerequisite Works | |
0e3f7173 MM |
393 | @cindex converting a package to use @code{gettext} |
394 | @cindex migration from earlier versions of @code{gettext} | |
7b41bcc0 | 395 | @@ -6525,12 +6524,12 @@ |
70ba7319 | 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. | |
398 | ||
399 | -@node gettextize Invocation, Adjusting Files, Prerequisites, Maintainers | |
400 | +@node gettextize, Adjusting Files, Prerequisites, Maintainers | |
401 | @section Invoking the @code{gettextize} Program | |
402 | ||
b3cd56fc | 403 | @include gettextize.texi |
70ba7319 | 404 | |
0e3f7173 MM |
405 | -@node Adjusting Files, autoconf macros, gettextize Invocation, Maintainers |
406 | +@node Adjusting Files, autoconf macros, gettextize, Maintainers | |
70ba7319 | 407 | @section Files You Must Create or Alter |
0e3f7173 | 408 | @cindex @code{gettext} files |
70ba7319 | 409 | |
7b41bcc0 JB |
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}. | |
416 | ||
417 | @node configure.in, config.guess, po/Rules-*, Adjusting Files | |
418 | @subsection @file{configure.in} at top level | |
419 | @@ -7406,7 +7405,7 @@ | |
b3cd56fc JB |
420 | @menu |
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 | |
425 | @end menu | |
426 | ||
427 | @node Distributed CVS, Files under CVS, CVS Issues, CVS Issues | |
7b41bcc0 | 428 | @@ -7448,7 +7447,7 @@ |
b3cd56fc JB |
429 | undiscovered due to this constellation. |
430 | @end itemize | |
431 | ||
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 | |
435 | ||
436 | There are basically three ways to deal with generated files in the | |
7b41bcc0 JB |
437 | @@ -7527,7 +7526,7 @@ |
438 | use the CVS will henceforth need to have GNU @code{gettext} 0.12.1 or newer | |
439 | installed. | |
b3cd56fc JB |
440 | |
441 | -@node autopoint Invocation, , Files under CVS, CVS Issues | |
442 | +@node autopoint, , Files under CVS, CVS Issues | |
443 | @subsection Invoking the @code{autopoint} Program | |
444 | ||
445 | @include autopoint.texi | |
7b41bcc0 | 446 | @@ -8193,10 +8192,10 @@ |
1adfdb54 JB |
447 | * Preparing Shell Scripts:: Preparing Shell Scripts for Internationalization |
448 | * gettext.sh:: Contents of @code{gettext.sh} | |
7b41bcc0 | 449 | * gettext Invocation:: Invoking the @code{gettext} program |
1adfdb54 JB |
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 | |
1adfdb54 JB |
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 | |
458 | @end menu | |
459 | ||
460 | @node Preparing Shell Scripts, gettext.sh, sh, sh | |
7b41bcc0 | 461 | @@ -8217,8 +8216,8 @@ |
1adfdb54 JB |
462 | |
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}. | |
470 | ||
471 | @item | |
7b41bcc0 | 472 | @@ -8328,28 +8327,28 @@ |
1adfdb54 JB |
473 | and a newline, without interpreting backslashes in the argument string. |
474 | ||
475 | @item eval_gettext | |
476 | -See @ref{eval_gettext Invocation}. | |
477 | +See @ref{eval_gettext}. | |
478 | ||
479 | @item eval_ngettext | |
480 | -See @ref{eval_ngettext Invocation}. | |
481 | +See @ref{eval_ngettext}. | |
482 | @end itemize | |
483 | ||
484 | -@node gettext Invocation, ngettext Invocation, gettext.sh, sh | |
485 | +@node gettext Invocation, ngettext, gettext.sh, sh | |
486 | @subsubsection Invoking the @code{gettext} program | |
487 | ||
488 | @include rt-gettext.texi | |
489 | ||
490 | -@node ngettext Invocation, envsubst Invocation, gettext Invocation, sh | |
491 | +@node ngettext, envsubst, gettext Invocation, sh | |
492 | @subsubsection Invoking the @code{ngettext} program | |
493 | ||
494 | @include rt-ngettext.texi | |
495 | ||
496 | -@node envsubst Invocation, eval_gettext Invocation, ngettext Invocation, sh | |
497 | +@node envsubst, eval_gettext, ngettext, sh | |
498 | @subsubsection Invoking the @code{envsubst} program | |
499 | ||
500 | @include rt-envsubst.texi | |
501 | ||
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 | |
505 | ||
506 | @cindex @code{eval_gettext} function, usage | |
7b41bcc0 | 507 | @@ -8362,7 +8361,7 @@ |
1adfdb54 JB |
508 | performing dollar-substitution on the result. Note that only shell variables |
509 | mentioned in @var{msgid} will be dollar-substituted in the result. | |
510 | ||
511 | -@node eval_ngettext Invocation, , eval_gettext Invocation, sh | |
512 | +@node eval_ngettext, , eval_gettext, sh | |
513 | @subsubsection Invoking the @code{eval_ngettext} function | |
514 | ||
515 | @cindex @code{eval_ngettext} function, usage | |
b3cd56fc JB |
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 | |
518 | @@ -177,4 +177,4 @@ | |
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}. | |
111ce9f0 JB |
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 | |
b3cd56fc JB |
526 | @@ -15,9 +15,9 @@ |
527 | @c %**end of header | |
528 | @set VERSION 1.0 | |
529 | ||
111ce9f0 | 530 | -@dircategory C++ libraries |
b3cd56fc JB |
531 | +@dircategory Libraries: |
532 | @direntry | |
111ce9f0 JB |
533 | -* autosprintf: (autosprintf). Support for printf format strings in C++. |
534 | +* autosprintf: (autosprintf). Support for printf format strings in C++ | |
b3cd56fc JB |
535 | @end direntry |
536 | ||
537 | @ifinfo |