~win-cross-dev/win-cross/gettext

« back to all changes in this revision

Viewing changes to gettext-tools/man/xgettext.1.html

  • Committer: Nathan Osman
  • Date: 2012-08-11 05:06:52 UTC
  • Revision ID: admin@quickmediasolutions.com-20120811050652-ochkxjtonbw6kkve
Initial commit.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!-- Creator     : groff version 1.18.1 -->
 
2
<html>
 
3
<head>
 
4
<meta name="generator" content="groff -Thtml, see www.gnu.org">
 
5
<meta name="Content-Style" content="text/css">
 
6
<title>XGETTEXT</title>
 
7
</head>
 
8
<body>
 
9
 
 
10
<h1 align=center>XGETTEXT</h1>
 
11
<a href="#NAME">NAME</a><br>
 
12
<a href="#SYNOPSIS">SYNOPSIS</a><br>
 
13
<a href="#DESCRIPTION">DESCRIPTION</a><br>
 
14
<a href="#AUTHOR">AUTHOR</a><br>
 
15
<a href="#REPORTING BUGS">REPORTING BUGS</a><br>
 
16
<a href="#COPYRIGHT">COPYRIGHT</a><br>
 
17
<a href="#SEE ALSO">SEE ALSO</a><br>
 
18
 
 
19
<hr>
 
20
<a name="NAME"></a>
 
21
<h2>NAME</h2>
 
22
<!-- INDENTATION -->
 
23
<table width="100%" border=0 rules="none" frame="void"
 
24
       cols="2" cellspacing="0" cellpadding="0">
 
25
<tr valign="top" align="left">
 
26
<td width="10%"></td>
 
27
<td width="89%">
 
28
<p>xgettext &minus; extract gettext strings from source</p>
 
29
</td>
 
30
</table>
 
31
<a name="SYNOPSIS"></a>
 
32
<h2>SYNOPSIS</h2>
 
33
<!-- INDENTATION -->
 
34
<table width="100%" border=0 rules="none" frame="void"
 
35
       cols="2" cellspacing="0" cellpadding="0">
 
36
<tr valign="top" align="left">
 
37
<td width="10%"></td>
 
38
<td width="89%">
 
39
<p><b>xgettext</b> [<i>OPTION</i>] [<i>INPUTFILE</i>]...</p>
 
40
</td>
 
41
</table>
 
42
<a name="DESCRIPTION"></a>
 
43
<h2>DESCRIPTION</h2>
 
44
<!-- INDENTATION -->
 
45
<table width="100%" border=0 rules="none" frame="void"
 
46
       cols="2" cellspacing="0" cellpadding="0">
 
47
<tr valign="top" align="left">
 
48
<td width="10%"></td>
 
49
<td width="89%">
 
50
<p>Extract translatable strings from given input files.</p>
 
51
<!-- INDENTATION -->
 
52
<p>Mandatory arguments to long options are mandatory for
 
53
short options too. Similarly for optional arguments.</p>
 
54
</td>
 
55
</table>
 
56
<!-- INDENTATION -->
 
57
<table width="100%" border=0 rules="none" frame="void"
 
58
       cols="2" cellspacing="0" cellpadding="0">
 
59
<tr valign="top" align="left">
 
60
<td width="4%"></td>
 
61
<td width="95%">
 
62
<p><b>Input file location:</b></p></td>
 
63
</table>
 
64
<!-- INDENTATION -->
 
65
<table width="100%" border=0 rules="none" frame="void"
 
66
       cols="2" cellspacing="0" cellpadding="0">
 
67
<tr valign="top" align="left">
 
68
<td width="10%"></td>
 
69
<td width="89%">
 
70
<p>INPUTFILE ...</p></td>
 
71
</table>
 
72
<!-- INDENTATION -->
 
73
<table width="100%" border=0 rules="none" frame="void"
 
74
       cols="2" cellspacing="0" cellpadding="0">
 
75
<tr valign="top" align="left">
 
76
<td width="21%"></td>
 
77
<td width="77%">
 
78
<p>input files</p>
 
79
</td>
 
80
</table>
 
81
<!-- INDENTATION -->
 
82
<table width="100%" border=0 rules="none" frame="void"
 
83
       cols="2" cellspacing="0" cellpadding="0">
 
84
<tr valign="top" align="left">
 
85
<td width="10%"></td>
 
86
<td width="89%">
 
87
<p><b>&minus;f</b>,
 
88
<b>&minus;&minus;files&minus;from</b>=<i>FILE</i></p></td>
 
89
</table>
 
90
<!-- INDENTATION -->
 
91
<table width="100%" border=0 rules="none" frame="void"
 
92
       cols="2" cellspacing="0" cellpadding="0">
 
93
<tr valign="top" align="left">
 
94
<td width="21%"></td>
 
95
<td width="77%">
 
96
<p>get list of input files from FILE</p>
 
97
</td>
 
98
</table>
 
99
<!-- INDENTATION -->
 
100
<table width="100%" border=0 rules="none" frame="void"
 
101
       cols="2" cellspacing="0" cellpadding="0">
 
102
<tr valign="top" align="left">
 
103
<td width="10%"></td>
 
104
<td width="89%">
 
105
<p><b>&minus;D</b>,
 
106
<b>&minus;&minus;directory</b>=<i>DIRECTORY</i></p></td>
 
107
</table>
 
108
<!-- INDENTATION -->
 
109
<table width="100%" border=0 rules="none" frame="void"
 
110
       cols="2" cellspacing="0" cellpadding="0">
 
111
<tr valign="top" align="left">
 
112
<td width="21%"></td>
 
113
<td width="77%">
 
114
<p>add DIRECTORY to list for input files search</p>
 
115
</td>
 
116
</table>
 
117
<!-- INDENTATION -->
 
118
<table width="100%" border=0 rules="none" frame="void"
 
119
       cols="2" cellspacing="0" cellpadding="0">
 
120
<tr valign="top" align="left">
 
121
<td width="10%"></td>
 
122
<td width="89%">
 
123
<p>If input file is -, standard input is read.</p>
 
124
</td>
 
125
</table>
 
126
<!-- INDENTATION -->
 
127
<table width="100%" border=0 rules="none" frame="void"
 
128
       cols="2" cellspacing="0" cellpadding="0">
 
129
<tr valign="top" align="left">
 
130
<td width="4%"></td>
 
131
<td width="95%">
 
132
<p><b>Output file location:</b></p></td>
 
133
</table>
 
134
<!-- INDENTATION -->
 
135
<table width="100%" border=0 rules="none" frame="void"
 
136
       cols="2" cellspacing="0" cellpadding="0">
 
137
<tr valign="top" align="left">
 
138
<td width="10%"></td>
 
139
<td width="89%">
 
140
<p><b>&minus;d</b>,
 
141
<b>&minus;&minus;default&minus;domain</b>=<i>NAME</i></p></td>
 
142
</table>
 
143
<!-- INDENTATION -->
 
144
<table width="100%" border=0 rules="none" frame="void"
 
145
       cols="2" cellspacing="0" cellpadding="0">
 
146
<tr valign="top" align="left">
 
147
<td width="21%"></td>
 
148
<td width="77%">
 
149
<p>use NAME.po for output (instead of messages.po)</p>
 
150
</td>
 
151
</table>
 
152
<!-- INDENTATION -->
 
153
<table width="100%" border=0 rules="none" frame="void"
 
154
       cols="2" cellspacing="0" cellpadding="0">
 
155
<tr valign="top" align="left">
 
156
<td width="10%"></td>
 
157
<td width="89%">
 
158
<p><b>&minus;o</b>,
 
159
<b>&minus;&minus;output</b>=<i>FILE</i></p></td>
 
160
</table>
 
161
<!-- INDENTATION -->
 
162
<table width="100%" border=0 rules="none" frame="void"
 
163
       cols="2" cellspacing="0" cellpadding="0">
 
164
<tr valign="top" align="left">
 
165
<td width="21%"></td>
 
166
<td width="77%">
 
167
<p>write output to specified file</p>
 
168
</td>
 
169
</table>
 
170
<!-- INDENTATION -->
 
171
<table width="100%" border=0 rules="none" frame="void"
 
172
       cols="2" cellspacing="0" cellpadding="0">
 
173
<tr valign="top" align="left">
 
174
<td width="10%"></td>
 
175
<td width="89%">
 
176
<p><b>&minus;p</b>,
 
177
<b>&minus;&minus;output&minus;dir</b>=<i>DIR</i></p></td>
 
178
</table>
 
179
<!-- INDENTATION -->
 
180
<table width="100%" border=0 rules="none" frame="void"
 
181
       cols="2" cellspacing="0" cellpadding="0">
 
182
<tr valign="top" align="left">
 
183
<td width="21%"></td>
 
184
<td width="77%">
 
185
<p>output files will be placed in directory DIR</p>
 
186
</td>
 
187
</table>
 
188
<!-- INDENTATION -->
 
189
<table width="100%" border=0 rules="none" frame="void"
 
190
       cols="2" cellspacing="0" cellpadding="0">
 
191
<tr valign="top" align="left">
 
192
<td width="10%"></td>
 
193
<td width="89%">
 
194
<p>If output file is -, output is written to standard
 
195
output.</p>
 
196
</td>
 
197
</table>
 
198
<!-- INDENTATION -->
 
199
<table width="100%" border=0 rules="none" frame="void"
 
200
       cols="2" cellspacing="0" cellpadding="0">
 
201
<tr valign="top" align="left">
 
202
<td width="4%"></td>
 
203
<td width="95%">
 
204
<p><b>Choice of input file language:</b></p></td>
 
205
</table>
 
206
<!-- INDENTATION -->
 
207
<table width="100%" border=0 rules="none" frame="void"
 
208
       cols="2" cellspacing="0" cellpadding="0">
 
209
<tr valign="top" align="left">
 
210
<td width="10%"></td>
 
211
<td width="89%">
 
212
<p><b>&minus;L</b>,
 
213
<b>&minus;&minus;language</b>=<i>NAME</i></p></td>
 
214
</table>
 
215
<!-- INDENTATION -->
 
216
<table width="100%" border=0 rules="none" frame="void"
 
217
       cols="2" cellspacing="0" cellpadding="0">
 
218
<tr valign="top" align="left">
 
219
<td width="21%"></td>
 
220
<td width="77%">
 
221
<p>recognise the specified language (C, C++, ObjectiveC, PO,
 
222
Shell, Python, Lisp, EmacsLisp, librep, Scheme, Smalltalk,
 
223
Java, JavaProperties, C#, awk, YCP, Tcl, Perl, PHP,
 
224
GCC-source, NXStringTable, RST, Glade)</p>
 
225
</td>
 
226
</table>
 
227
<!-- INDENTATION -->
 
228
<table width="100%" border=0 rules="none" frame="void"
 
229
       cols="2" cellspacing="0" cellpadding="0">
 
230
<tr valign="top" align="left">
 
231
<td width="10%"></td>
 
232
<td width="89%">
 
233
<p><b>&minus;C</b>, <b>&minus;&minus;c</b>++</p></td>
 
234
</table>
 
235
<!-- INDENTATION -->
 
236
<table width="100%" border=0 rules="none" frame="void"
 
237
       cols="2" cellspacing="0" cellpadding="0">
 
238
<tr valign="top" align="left">
 
239
<td width="21%"></td>
 
240
<td width="77%">
 
241
<p>shorthand for
 
242
<b>&minus;&minus;language</b>=<i>C</i>++</p>
 
243
</td>
 
244
</table>
 
245
<!-- INDENTATION -->
 
246
<table width="100%" border=0 rules="none" frame="void"
 
247
       cols="2" cellspacing="0" cellpadding="0">
 
248
<tr valign="top" align="left">
 
249
<td width="10%"></td>
 
250
<td width="89%">
 
251
<p>By default the language is guessed depending on the input
 
252
file name extension.</p>
 
253
</td>
 
254
</table>
 
255
<!-- INDENTATION -->
 
256
<table width="100%" border=0 rules="none" frame="void"
 
257
       cols="2" cellspacing="0" cellpadding="0">
 
258
<tr valign="top" align="left">
 
259
<td width="4%"></td>
 
260
<td width="95%">
 
261
<p><b>Input file interpretation:</b></p></td>
 
262
</table>
 
263
<!-- INDENTATION -->
 
264
<table width="100%" border=0 rules="none" frame="void"
 
265
       cols="2" cellspacing="0" cellpadding="0">
 
266
<tr valign="top" align="left">
 
267
<td width="10%"></td>
 
268
<td width="89%">
 
269
 
 
270
<p><b>&minus;&minus;from&minus;code</b>=<i>NAME</i></p></td>
 
271
</table>
 
272
<!-- INDENTATION -->
 
273
<table width="100%" border=0 rules="none" frame="void"
 
274
       cols="2" cellspacing="0" cellpadding="0">
 
275
<tr valign="top" align="left">
 
276
<td width="21%"></td>
 
277
<td width="77%">
 
278
<p>encoding of input files (except for Python, Tcl,
 
279
Glade)</p>
 
280
</td>
 
281
</table>
 
282
<!-- INDENTATION -->
 
283
<table width="100%" border=0 rules="none" frame="void"
 
284
       cols="2" cellspacing="0" cellpadding="0">
 
285
<tr valign="top" align="left">
 
286
<td width="10%"></td>
 
287
<td width="89%">
 
288
<p>By default the input files are assumed to be in
 
289
ASCII.</p>
 
290
</td>
 
291
</table>
 
292
<!-- INDENTATION -->
 
293
<table width="100%" border=0 rules="none" frame="void"
 
294
       cols="2" cellspacing="0" cellpadding="0">
 
295
<tr valign="top" align="left">
 
296
<td width="4%"></td>
 
297
<td width="95%">
 
298
<p><b>Operation mode:</b></p></td>
 
299
</table>
 
300
<!-- INDENTATION -->
 
301
<table width="100%" border=0 rules="none" frame="void"
 
302
       cols="2" cellspacing="0" cellpadding="0">
 
303
<tr valign="top" align="left">
 
304
<td width="10%"></td>
 
305
<td width="89%">
 
306
<p><b>&minus;j</b>,
 
307
<b>&minus;&minus;join&minus;existing</b></p></td>
 
308
</table>
 
309
<!-- INDENTATION -->
 
310
<table width="100%" border=0 rules="none" frame="void"
 
311
       cols="2" cellspacing="0" cellpadding="0">
 
312
<tr valign="top" align="left">
 
313
<td width="21%"></td>
 
314
<td width="77%">
 
315
<p>join messages with existing file</p>
 
316
</td>
 
317
</table>
 
318
<!-- INDENTATION -->
 
319
<table width="100%" border=0 rules="none" frame="void"
 
320
       cols="2" cellspacing="0" cellpadding="0">
 
321
<tr valign="top" align="left">
 
322
<td width="10%"></td>
 
323
<td width="89%">
 
324
<p><b>&minus;x</b>,
 
325
<b>&minus;&minus;exclude&minus;file</b>=<i>FILE</i>.po</p></td>
 
326
</table>
 
327
<!-- INDENTATION -->
 
328
<table width="100%" border=0 rules="none" frame="void"
 
329
       cols="2" cellspacing="0" cellpadding="0">
 
330
<tr valign="top" align="left">
 
331
<td width="21%"></td>
 
332
<td width="77%">
 
333
<p>entries from FILE.po are not extracted</p>
 
334
</td>
 
335
</table>
 
336
<!-- INDENTATION -->
 
337
<table width="100%" border=0 rules="none" frame="void"
 
338
       cols="2" cellspacing="0" cellpadding="0">
 
339
<tr valign="top" align="left">
 
340
<td width="10%"></td>
 
341
<td width="89%">
 
342
<p><b>&minus;cTAG</b>,
 
343
<b>&minus;&minus;add&minus;comments</b>=<i>TAG</i></p></td>
 
344
</table>
 
345
<!-- INDENTATION -->
 
346
<table width="100%" border=0 rules="none" frame="void"
 
347
       cols="2" cellspacing="0" cellpadding="0">
 
348
<tr valign="top" align="left">
 
349
<td width="21%"></td>
 
350
<td width="77%">
 
351
<p>place comment blocks starting with TAG and preceding
 
352
keyword lines in output file</p>
 
353
</td>
 
354
</table>
 
355
<!-- INDENTATION -->
 
356
<table width="100%" border=0 rules="none" frame="void"
 
357
       cols="2" cellspacing="0" cellpadding="0">
 
358
<tr valign="top" align="left">
 
359
<td width="10%"></td>
 
360
<td width="89%">
 
361
<p><b>&minus;c</b>,
 
362
<b>&minus;&minus;add&minus;comments</b></p></td>
 
363
</table>
 
364
<!-- INDENTATION -->
 
365
<table width="100%" border=0 rules="none" frame="void"
 
366
       cols="2" cellspacing="0" cellpadding="0">
 
367
<tr valign="top" align="left">
 
368
<td width="21%"></td>
 
369
<td width="77%">
 
370
<p>place all comment blocks preceding keyword lines in
 
371
output file</p>
 
372
</td>
 
373
</table>
 
374
<!-- INDENTATION -->
 
375
<table width="100%" border=0 rules="none" frame="void"
 
376
       cols="2" cellspacing="0" cellpadding="0">
 
377
<tr valign="top" align="left">
 
378
<td width="4%"></td>
 
379
<td width="95%">
 
380
<p><b>Language specific options:</b></p></td>
 
381
</table>
 
382
<!-- INDENTATION -->
 
383
<table width="100%" border=0 rules="none" frame="void"
 
384
       cols="2" cellspacing="0" cellpadding="0">
 
385
<tr valign="top" align="left">
 
386
<td width="10%"></td>
 
387
<td width="89%">
 
388
<p><b>&minus;a</b>,
 
389
<b>&minus;&minus;extract&minus;all</b></p></td>
 
390
</table>
 
391
<!-- INDENTATION -->
 
392
<table width="100%" border=0 rules="none" frame="void"
 
393
       cols="2" cellspacing="0" cellpadding="0">
 
394
<tr valign="top" align="left">
 
395
<td width="21%"></td>
 
396
<td width="77%">
 
397
<p>extract all strings (only languages C, C++, ObjectiveC,
 
398
Shell, Python, Lisp, EmacsLisp, librep, Scheme, Java, C#,
 
399
awk, Tcl, Perl, PHP, GCC-source, Glade)</p>
 
400
</td>
 
401
</table>
 
402
<!-- INDENTATION -->
 
403
<table width="100%" border=0 rules="none" frame="void"
 
404
       cols="2" cellspacing="0" cellpadding="0">
 
405
<tr valign="top" align="left">
 
406
<td width="10%"></td>
 
407
<td width="89%">
 
408
<p><b>&minus;kWORD</b>,
 
409
<b>&minus;&minus;keyword</b>=<i>WORD</i></p></td>
 
410
</table>
 
411
<!-- INDENTATION -->
 
412
<table width="100%" border=0 rules="none" frame="void"
 
413
       cols="2" cellspacing="0" cellpadding="0">
 
414
<tr valign="top" align="left">
 
415
<td width="21%"></td>
 
416
<td width="77%">
 
417
<p>look for WORD as an additional keyword</p>
 
418
</td>
 
419
</table>
 
420
<!-- INDENTATION -->
 
421
<table width="100%" border=0 rules="none" frame="void"
 
422
       cols="2" cellspacing="0" cellpadding="0">
 
423
<tr valign="top" align="left">
 
424
<td width="10%"></td>
 
425
<td width="89%">
 
426
<p><b>&minus;k</b>, <b>&minus;&minus;keyword</b></p></td>
 
427
</table>
 
428
<!-- INDENTATION -->
 
429
<table width="100%" border=0 rules="none" frame="void"
 
430
       cols="2" cellspacing="0" cellpadding="0">
 
431
<tr valign="top" align="left">
 
432
<td width="21%"></td>
 
433
<td width="77%">
 
434
<p>do not to use default keywords (only languages C, C++,
 
435
ObjectiveC, Shell, Python, Lisp, EmacsLisp, librep, Scheme,
 
436
Java, C#, awk, Tcl, Perl, PHP, GCC-source, Glade)</p>
 
437
</td>
 
438
</table>
 
439
<!-- INDENTATION -->
 
440
<table width="100%" border=0 rules="none" frame="void"
 
441
       cols="2" cellspacing="0" cellpadding="0">
 
442
<tr valign="top" align="left">
 
443
<td width="10%"></td>
 
444
<td width="89%">
 
445
<p><b>&minus;&minus;flag</b>=<i>WORD</i>:ARG:FLAG</p></td>
 
446
</table>
 
447
<!-- INDENTATION -->
 
448
<table width="100%" border=0 rules="none" frame="void"
 
449
       cols="2" cellspacing="0" cellpadding="0">
 
450
<tr valign="top" align="left">
 
451
<td width="21%"></td>
 
452
<td width="77%">
 
453
<p>additional flag for strings inside the argument number
 
454
ARG of keyword WORD</p>
 
455
</td>
 
456
</table>
 
457
<!-- INDENTATION -->
 
458
<table width="100%" border=0 rules="none" frame="void"
 
459
       cols="2" cellspacing="0" cellpadding="0">
 
460
<tr valign="top" align="left">
 
461
<td width="20%"></td>
 
462
<td width="79%">
 
463
<p>(only languages C, C++, ObjectiveC, Shell, Python, Lisp,
 
464
EmacsLisp, librep, Scheme, Java, C#, awk, YCP, Tcl, Perl,
 
465
PHP, GCC-source)</p>
 
466
</td>
 
467
</table>
 
468
<!-- INDENTATION -->
 
469
<table width="100%" border=0 rules="none" frame="void"
 
470
       cols="2" cellspacing="0" cellpadding="0">
 
471
<tr valign="top" align="left">
 
472
<td width="10%"></td>
 
473
<td width="89%">
 
474
<p><b>&minus;T</b>, <b>&minus;&minus;trigraphs</b></p></td>
 
475
</table>
 
476
<!-- INDENTATION -->
 
477
<table width="100%" border=0 rules="none" frame="void"
 
478
       cols="2" cellspacing="0" cellpadding="0">
 
479
<tr valign="top" align="left">
 
480
<td width="21%"></td>
 
481
<td width="77%">
 
482
<p>understand ANSI C trigraphs for input (only languages C,
 
483
C++, ObjectiveC)</p>
 
484
</td>
 
485
</table>
 
486
<!-- TABS -->
 
487
<table width="100%" border=0 rules="none" frame="void"
 
488
       cols="4" cellspacing="0" cellpadding="0">
 
489
<tr valign="top" align="left">
 
490
<td width="11%"></td>
 
491
<td width="7%">
 
492
 
 
493
<p><b>&minus;&minus;qt</b></p>
 
494
</td>
 
495
<td width="11%"></td>
 
496
<td width="69%">
 
497
 
 
498
<p>recognize Qt format strings (only language C++)</p>
 
499
</td>
 
500
<tr valign="top" align="left">
 
501
<td width="11%"></td>
 
502
<td width="7%">
 
503
 
 
504
<p><b>&minus;&minus;kde</b></p>
 
505
</td>
 
506
<td width="11%"></td>
 
507
<td width="69%">
 
508
 
 
509
<p>recognize KDE 4 format strings (only language C++)</p>
 
510
</td>
 
511
</table>
 
512
<!-- INDENTATION -->
 
513
<table width="100%" border=0 rules="none" frame="void"
 
514
       cols="2" cellspacing="0" cellpadding="0">
 
515
<tr valign="top" align="left">
 
516
<td width="10%"></td>
 
517
<td width="89%">
 
518
<p><b>&minus;&minus;boost</b></p></td>
 
519
</table>
 
520
<!-- INDENTATION -->
 
521
<table width="100%" border=0 rules="none" frame="void"
 
522
       cols="2" cellspacing="0" cellpadding="0">
 
523
<tr valign="top" align="left">
 
524
<td width="21%"></td>
 
525
<td width="77%">
 
526
<p>recognize Boost format strings (only language C++)</p>
 
527
</td>
 
528
</table>
 
529
<!-- INDENTATION -->
 
530
<table width="100%" border=0 rules="none" frame="void"
 
531
       cols="2" cellspacing="0" cellpadding="0">
 
532
<tr valign="top" align="left">
 
533
<td width="10%"></td>
 
534
<td width="89%">
 
535
<p><b>&minus;&minus;debug</b></p></td>
 
536
</table>
 
537
<!-- INDENTATION -->
 
538
<table width="100%" border=0 rules="none" frame="void"
 
539
       cols="2" cellspacing="0" cellpadding="0">
 
540
<tr valign="top" align="left">
 
541
<td width="21%"></td>
 
542
<td width="77%">
 
543
<p>more detailed formatstring recognition result</p>
 
544
</td>
 
545
</table>
 
546
<!-- INDENTATION -->
 
547
<table width="100%" border=0 rules="none" frame="void"
 
548
       cols="2" cellspacing="0" cellpadding="0">
 
549
<tr valign="top" align="left">
 
550
<td width="4%"></td>
 
551
<td width="95%">
 
552
<p><b>Output details:</b></p></td>
 
553
</table>
 
554
<!-- INDENTATION -->
 
555
<table width="100%" border=0 rules="none" frame="void"
 
556
       cols="2" cellspacing="0" cellpadding="0">
 
557
<tr valign="top" align="left">
 
558
<td width="10%"></td>
 
559
<td width="89%">
 
560
<p><b>&minus;&minus;color</b></p></td>
 
561
</table>
 
562
<!-- INDENTATION -->
 
563
<table width="100%" border=0 rules="none" frame="void"
 
564
       cols="2" cellspacing="0" cellpadding="0">
 
565
<tr valign="top" align="left">
 
566
<td width="21%"></td>
 
567
<td width="77%">
 
568
<p>use colors and other text attributes always</p>
 
569
</td>
 
570
</table>
 
571
<!-- INDENTATION -->
 
572
<table width="100%" border=0 rules="none" frame="void"
 
573
       cols="2" cellspacing="0" cellpadding="0">
 
574
<tr valign="top" align="left">
 
575
<td width="10%"></td>
 
576
<td width="89%">
 
577
<p><b>&minus;&minus;color</b>=<i>WHEN</i></p></td>
 
578
</table>
 
579
<!-- INDENTATION -->
 
580
<table width="100%" border=0 rules="none" frame="void"
 
581
       cols="2" cellspacing="0" cellpadding="0">
 
582
<tr valign="top" align="left">
 
583
<td width="21%"></td>
 
584
<td width="77%">
 
585
<p>use colors and other text attributes if WHEN. WHEN may be
 
586
&rsquo;always&rsquo;, &rsquo;never&rsquo;,
 
587
&rsquo;auto&rsquo;, or &rsquo;html&rsquo;.</p>
 
588
</td>
 
589
</table>
 
590
<!-- INDENTATION -->
 
591
<table width="100%" border=0 rules="none" frame="void"
 
592
       cols="2" cellspacing="0" cellpadding="0">
 
593
<tr valign="top" align="left">
 
594
<td width="10%"></td>
 
595
<td width="89%">
 
596
<p><b>&minus;&minus;style</b>=<i>STYLEFILE</i></p></td>
 
597
</table>
 
598
<!-- INDENTATION -->
 
599
<table width="100%" border=0 rules="none" frame="void"
 
600
       cols="2" cellspacing="0" cellpadding="0">
 
601
<tr valign="top" align="left">
 
602
<td width="21%"></td>
 
603
<td width="77%">
 
604
<p>specify CSS style rule file for
 
605
<b>&minus;&minus;color</b></p>
 
606
</td>
 
607
</table>
 
608
<!-- INDENTATION -->
 
609
<table width="100%" border=0 rules="none" frame="void"
 
610
       cols="2" cellspacing="0" cellpadding="0">
 
611
<tr valign="top" align="left">
 
612
<td width="10%"></td>
 
613
<td width="89%">
 
614
<p><b>&minus;e</b>,
 
615
<b>&minus;&minus;no&minus;escape</b></p></td>
 
616
</table>
 
617
<!-- INDENTATION -->
 
618
<table width="100%" border=0 rules="none" frame="void"
 
619
       cols="2" cellspacing="0" cellpadding="0">
 
620
<tr valign="top" align="left">
 
621
<td width="21%"></td>
 
622
<td width="77%">
 
623
<p>do not use C escapes in output (default)</p>
 
624
</td>
 
625
</table>
 
626
<!-- INDENTATION -->
 
627
<table width="100%" border=0 rules="none" frame="void"
 
628
       cols="2" cellspacing="0" cellpadding="0">
 
629
<tr valign="top" align="left">
 
630
<td width="10%"></td>
 
631
<td width="89%">
 
632
<p><b>&minus;E</b>, <b>&minus;&minus;escape</b></p></td>
 
633
</table>
 
634
<!-- INDENTATION -->
 
635
<table width="100%" border=0 rules="none" frame="void"
 
636
       cols="2" cellspacing="0" cellpadding="0">
 
637
<tr valign="top" align="left">
 
638
<td width="21%"></td>
 
639
<td width="77%">
 
640
<p>use C escapes in output, no extended chars</p>
 
641
</td>
 
642
</table>
 
643
<!-- INDENTATION -->
 
644
<table width="100%" border=0 rules="none" frame="void"
 
645
       cols="2" cellspacing="0" cellpadding="0">
 
646
<tr valign="top" align="left">
 
647
<td width="10%"></td>
 
648
<td width="89%">
 
649
<p><b>&minus;&minus;force&minus;po</b></p></td>
 
650
</table>
 
651
<!-- INDENTATION -->
 
652
<table width="100%" border=0 rules="none" frame="void"
 
653
       cols="2" cellspacing="0" cellpadding="0">
 
654
<tr valign="top" align="left">
 
655
<td width="21%"></td>
 
656
<td width="77%">
 
657
<p>write PO file even if empty</p>
 
658
</td>
 
659
</table>
 
660
<!-- INDENTATION -->
 
661
<table width="100%" border=0 rules="none" frame="void"
 
662
       cols="2" cellspacing="0" cellpadding="0">
 
663
<tr valign="top" align="left">
 
664
<td width="10%"></td>
 
665
<td width="89%">
 
666
<p><b>&minus;i</b>, <b>&minus;&minus;indent</b></p></td>
 
667
</table>
 
668
<!-- INDENTATION -->
 
669
<table width="100%" border=0 rules="none" frame="void"
 
670
       cols="2" cellspacing="0" cellpadding="0">
 
671
<tr valign="top" align="left">
 
672
<td width="21%"></td>
 
673
<td width="77%">
 
674
<p>write the .po file using indented style</p>
 
675
</td>
 
676
</table>
 
677
<!-- INDENTATION -->
 
678
<table width="100%" border=0 rules="none" frame="void"
 
679
       cols="2" cellspacing="0" cellpadding="0">
 
680
<tr valign="top" align="left">
 
681
<td width="10%"></td>
 
682
<td width="89%">
 
683
<p><b>&minus;&minus;no&minus;location</b></p></td>
 
684
</table>
 
685
<!-- INDENTATION -->
 
686
<table width="100%" border=0 rules="none" frame="void"
 
687
       cols="2" cellspacing="0" cellpadding="0">
 
688
<tr valign="top" align="left">
 
689
<td width="21%"></td>
 
690
<td width="77%">
 
691
<p>do not write &rsquo;#: filename:line&rsquo; lines</p>
 
692
</td>
 
693
</table>
 
694
<!-- INDENTATION -->
 
695
<table width="100%" border=0 rules="none" frame="void"
 
696
       cols="2" cellspacing="0" cellpadding="0">
 
697
<tr valign="top" align="left">
 
698
<td width="10%"></td>
 
699
<td width="89%">
 
700
<p><b>&minus;n</b>,
 
701
<b>&minus;&minus;add&minus;location</b></p></td>
 
702
</table>
 
703
<!-- INDENTATION -->
 
704
<table width="100%" border=0 rules="none" frame="void"
 
705
       cols="2" cellspacing="0" cellpadding="0">
 
706
<tr valign="top" align="left">
 
707
<td width="21%"></td>
 
708
<td width="77%">
 
709
<p>generate &rsquo;#: filename:line&rsquo; lines
 
710
(default)</p>
 
711
</td>
 
712
</table>
 
713
<!-- INDENTATION -->
 
714
<table width="100%" border=0 rules="none" frame="void"
 
715
       cols="2" cellspacing="0" cellpadding="0">
 
716
<tr valign="top" align="left">
 
717
<td width="10%"></td>
 
718
<td width="89%">
 
719
<p><b>&minus;&minus;strict</b></p></td>
 
720
</table>
 
721
<!-- INDENTATION -->
 
722
<table width="100%" border=0 rules="none" frame="void"
 
723
       cols="2" cellspacing="0" cellpadding="0">
 
724
<tr valign="top" align="left">
 
725
<td width="21%"></td>
 
726
<td width="77%">
 
727
<p>write out strict Uniforum conforming .po file</p>
 
728
</td>
 
729
</table>
 
730
<!-- INDENTATION -->
 
731
<table width="100%" border=0 rules="none" frame="void"
 
732
       cols="2" cellspacing="0" cellpadding="0">
 
733
<tr valign="top" align="left">
 
734
<td width="10%"></td>
 
735
<td width="89%">
 
736
<p><b>&minus;&minus;properties&minus;output</b></p></td>
 
737
</table>
 
738
<!-- INDENTATION -->
 
739
<table width="100%" border=0 rules="none" frame="void"
 
740
       cols="2" cellspacing="0" cellpadding="0">
 
741
<tr valign="top" align="left">
 
742
<td width="21%"></td>
 
743
<td width="77%">
 
744
<p>write out a Java .properties file</p>
 
745
</td>
 
746
</table>
 
747
<!-- INDENTATION -->
 
748
<table width="100%" border=0 rules="none" frame="void"
 
749
       cols="2" cellspacing="0" cellpadding="0">
 
750
<tr valign="top" align="left">
 
751
<td width="10%"></td>
 
752
<td width="89%">
 
753
<p><b>&minus;&minus;stringtable&minus;output</b></p></td>
 
754
</table>
 
755
<!-- INDENTATION -->
 
756
<table width="100%" border=0 rules="none" frame="void"
 
757
       cols="2" cellspacing="0" cellpadding="0">
 
758
<tr valign="top" align="left">
 
759
<td width="21%"></td>
 
760
<td width="77%">
 
761
<p>write out a NeXTstep/GNUstep .strings file</p>
 
762
</td>
 
763
</table>
 
764
<!-- INDENTATION -->
 
765
<table width="100%" border=0 rules="none" frame="void"
 
766
       cols="2" cellspacing="0" cellpadding="0">
 
767
<tr valign="top" align="left">
 
768
<td width="10%"></td>
 
769
<td width="89%">
 
770
<p><b>&minus;w</b>,
 
771
<b>&minus;&minus;width</b>=<i>NUMBER</i></p></td>
 
772
</table>
 
773
<!-- INDENTATION -->
 
774
<table width="100%" border=0 rules="none" frame="void"
 
775
       cols="2" cellspacing="0" cellpadding="0">
 
776
<tr valign="top" align="left">
 
777
<td width="21%"></td>
 
778
<td width="77%">
 
779
<p>set output page width</p>
 
780
</td>
 
781
</table>
 
782
<!-- INDENTATION -->
 
783
<table width="100%" border=0 rules="none" frame="void"
 
784
       cols="2" cellspacing="0" cellpadding="0">
 
785
<tr valign="top" align="left">
 
786
<td width="10%"></td>
 
787
<td width="89%">
 
788
<p><b>&minus;&minus;no&minus;wrap</b></p></td>
 
789
</table>
 
790
<!-- INDENTATION -->
 
791
<table width="100%" border=0 rules="none" frame="void"
 
792
       cols="2" cellspacing="0" cellpadding="0">
 
793
<tr valign="top" align="left">
 
794
<td width="21%"></td>
 
795
<td width="77%">
 
796
<p>do not break long message lines, longer than the output
 
797
page width, into several lines</p>
 
798
</td>
 
799
</table>
 
800
<!-- INDENTATION -->
 
801
<table width="100%" border=0 rules="none" frame="void"
 
802
       cols="2" cellspacing="0" cellpadding="0">
 
803
<tr valign="top" align="left">
 
804
<td width="10%"></td>
 
805
<td width="89%">
 
806
<p><b>&minus;s</b>,
 
807
<b>&minus;&minus;sort&minus;output</b></p></td>
 
808
</table>
 
809
<!-- INDENTATION -->
 
810
<table width="100%" border=0 rules="none" frame="void"
 
811
       cols="2" cellspacing="0" cellpadding="0">
 
812
<tr valign="top" align="left">
 
813
<td width="21%"></td>
 
814
<td width="77%">
 
815
<p>generate sorted output</p>
 
816
</td>
 
817
</table>
 
818
<!-- INDENTATION -->
 
819
<table width="100%" border=0 rules="none" frame="void"
 
820
       cols="2" cellspacing="0" cellpadding="0">
 
821
<tr valign="top" align="left">
 
822
<td width="10%"></td>
 
823
<td width="89%">
 
824
<p><b>&minus;F</b>,
 
825
<b>&minus;&minus;sort&minus;by&minus;file</b></p></td>
 
826
</table>
 
827
<!-- INDENTATION -->
 
828
<table width="100%" border=0 rules="none" frame="void"
 
829
       cols="2" cellspacing="0" cellpadding="0">
 
830
<tr valign="top" align="left">
 
831
<td width="21%"></td>
 
832
<td width="77%">
 
833
<p>sort output by file location</p>
 
834
</td>
 
835
</table>
 
836
<!-- INDENTATION -->
 
837
<table width="100%" border=0 rules="none" frame="void"
 
838
       cols="2" cellspacing="0" cellpadding="0">
 
839
<tr valign="top" align="left">
 
840
<td width="10%"></td>
 
841
<td width="89%">
 
842
<p><b>&minus;&minus;omit&minus;header</b></p></td>
 
843
</table>
 
844
<!-- INDENTATION -->
 
845
<table width="100%" border=0 rules="none" frame="void"
 
846
       cols="2" cellspacing="0" cellpadding="0">
 
847
<tr valign="top" align="left">
 
848
<td width="21%"></td>
 
849
<td width="77%">
 
850
<p>don&rsquo;t write header with &lsquo;msgid
 
851
&quot;&quot;&rsquo; entry</p>
 
852
</td>
 
853
</table>
 
854
<!-- INDENTATION -->
 
855
<table width="100%" border=0 rules="none" frame="void"
 
856
       cols="2" cellspacing="0" cellpadding="0">
 
857
<tr valign="top" align="left">
 
858
<td width="10%"></td>
 
859
<td width="89%">
 
860
 
 
861
<p><b>&minus;&minus;copyright&minus;holder</b>=<i>STRING</i></p></td>
 
862
</table>
 
863
<!-- INDENTATION -->
 
864
<table width="100%" border=0 rules="none" frame="void"
 
865
       cols="2" cellspacing="0" cellpadding="0">
 
866
<tr valign="top" align="left">
 
867
<td width="21%"></td>
 
868
<td width="77%">
 
869
<p>set copyright holder in output</p>
 
870
</td>
 
871
</table>
 
872
<!-- INDENTATION -->
 
873
<table width="100%" border=0 rules="none" frame="void"
 
874
       cols="2" cellspacing="0" cellpadding="0">
 
875
<tr valign="top" align="left">
 
876
<td width="10%"></td>
 
877
<td width="89%">
 
878
<p><b>&minus;&minus;foreign&minus;user</b></p></td>
 
879
</table>
 
880
<!-- INDENTATION -->
 
881
<table width="100%" border=0 rules="none" frame="void"
 
882
       cols="2" cellspacing="0" cellpadding="0">
 
883
<tr valign="top" align="left">
 
884
<td width="21%"></td>
 
885
<td width="77%">
 
886
<p>omit FSF copyright in output for foreign user</p>
 
887
</td>
 
888
</table>
 
889
<!-- INDENTATION -->
 
890
<table width="100%" border=0 rules="none" frame="void"
 
891
       cols="2" cellspacing="0" cellpadding="0">
 
892
<tr valign="top" align="left">
 
893
<td width="10%"></td>
 
894
<td width="89%">
 
895
 
 
896
<p><b>&minus;&minus;package&minus;name</b>=<i>PACKAGE</i></p></td>
 
897
</table>
 
898
<!-- INDENTATION -->
 
899
<table width="100%" border=0 rules="none" frame="void"
 
900
       cols="2" cellspacing="0" cellpadding="0">
 
901
<tr valign="top" align="left">
 
902
<td width="21%"></td>
 
903
<td width="77%">
 
904
<p>set package name in output</p>
 
905
</td>
 
906
</table>
 
907
<!-- INDENTATION -->
 
908
<table width="100%" border=0 rules="none" frame="void"
 
909
       cols="2" cellspacing="0" cellpadding="0">
 
910
<tr valign="top" align="left">
 
911
<td width="10%"></td>
 
912
<td width="89%">
 
913
 
 
914
<p><b>&minus;&minus;package&minus;version</b>=<i>VERSION</i></p></td>
 
915
</table>
 
916
<!-- INDENTATION -->
 
917
<table width="100%" border=0 rules="none" frame="void"
 
918
       cols="2" cellspacing="0" cellpadding="0">
 
919
<tr valign="top" align="left">
 
920
<td width="21%"></td>
 
921
<td width="77%">
 
922
<p>set package version in output</p>
 
923
</td>
 
924
</table>
 
925
<!-- INDENTATION -->
 
926
<table width="100%" border=0 rules="none" frame="void"
 
927
       cols="2" cellspacing="0" cellpadding="0">
 
928
<tr valign="top" align="left">
 
929
<td width="10%"></td>
 
930
<td width="89%">
 
931
 
 
932
<p><b>&minus;&minus;msgid&minus;bugs&minus;address</b>=<i>EMAIL</i>@ADDRESS</p></td>
 
933
</table>
 
934
<!-- INDENTATION -->
 
935
<table width="100%" border=0 rules="none" frame="void"
 
936
       cols="2" cellspacing="0" cellpadding="0">
 
937
<tr valign="top" align="left">
 
938
<td width="21%"></td>
 
939
<td width="77%">
 
940
<p>set report address for msgid bugs</p>
 
941
</td>
 
942
</table>
 
943
<!-- INDENTATION -->
 
944
<table width="100%" border=0 rules="none" frame="void"
 
945
       cols="2" cellspacing="0" cellpadding="0">
 
946
<tr valign="top" align="left">
 
947
<td width="10%"></td>
 
948
<td width="89%">
 
949
<p><b>&minus;m[STRING]</b>,
 
950
<b>&minus;&minus;msgstr&minus;prefix</b>[=<i>STRING</i>]</p></td>
 
951
</table>
 
952
<!-- INDENTATION -->
 
953
<table width="100%" border=0 rules="none" frame="void"
 
954
       cols="2" cellspacing="0" cellpadding="0">
 
955
<tr valign="top" align="left">
 
956
<td width="21%"></td>
 
957
<td width="77%">
 
958
<p>use STRING or &quot;&quot; as prefix for msgstr
 
959
values</p>
 
960
</td>
 
961
</table>
 
962
<!-- INDENTATION -->
 
963
<table width="100%" border=0 rules="none" frame="void"
 
964
       cols="2" cellspacing="0" cellpadding="0">
 
965
<tr valign="top" align="left">
 
966
<td width="10%"></td>
 
967
<td width="89%">
 
968
<p><b>&minus;M[STRING]</b>,
 
969
<b>&minus;&minus;msgstr&minus;suffix</b>[=<i>STRING</i>]</p></td>
 
970
</table>
 
971
<!-- INDENTATION -->
 
972
<table width="100%" border=0 rules="none" frame="void"
 
973
       cols="2" cellspacing="0" cellpadding="0">
 
974
<tr valign="top" align="left">
 
975
<td width="21%"></td>
 
976
<td width="77%">
 
977
<p>use STRING or &quot;&quot; as suffix for msgstr
 
978
values</p>
 
979
</td>
 
980
</table>
 
981
<!-- INDENTATION -->
 
982
<table width="100%" border=0 rules="none" frame="void"
 
983
       cols="2" cellspacing="0" cellpadding="0">
 
984
<tr valign="top" align="left">
 
985
<td width="4%"></td>
 
986
<td width="95%">
 
987
<p><b>Informative output:</b></p></td>
 
988
</table>
 
989
<!-- INDENTATION -->
 
990
<table width="100%" border=0 rules="none" frame="void"
 
991
       cols="2" cellspacing="0" cellpadding="0">
 
992
<tr valign="top" align="left">
 
993
<td width="10%"></td>
 
994
<td width="89%">
 
995
<p><b>&minus;h</b>, <b>&minus;&minus;help</b></p></td>
 
996
</table>
 
997
<!-- INDENTATION -->
 
998
<table width="100%" border=0 rules="none" frame="void"
 
999
       cols="2" cellspacing="0" cellpadding="0">
 
1000
<tr valign="top" align="left">
 
1001
<td width="21%"></td>
 
1002
<td width="77%">
 
1003
<p>display this help and exit</p>
 
1004
</td>
 
1005
</table>
 
1006
<!-- INDENTATION -->
 
1007
<table width="100%" border=0 rules="none" frame="void"
 
1008
       cols="2" cellspacing="0" cellpadding="0">
 
1009
<tr valign="top" align="left">
 
1010
<td width="10%"></td>
 
1011
<td width="89%">
 
1012
<p><b>&minus;V</b>, <b>&minus;&minus;version</b></p></td>
 
1013
</table>
 
1014
<!-- INDENTATION -->
 
1015
<table width="100%" border=0 rules="none" frame="void"
 
1016
       cols="2" cellspacing="0" cellpadding="0">
 
1017
<tr valign="top" align="left">
 
1018
<td width="21%"></td>
 
1019
<td width="77%">
 
1020
<p>output version information and exit</p>
 
1021
</td>
 
1022
</table>
 
1023
<a name="AUTHOR"></a>
 
1024
<h2>AUTHOR</h2>
 
1025
<!-- INDENTATION -->
 
1026
<table width="100%" border=0 rules="none" frame="void"
 
1027
       cols="2" cellspacing="0" cellpadding="0">
 
1028
<tr valign="top" align="left">
 
1029
<td width="10%"></td>
 
1030
<td width="89%">
 
1031
<p>Written by Ulrich Drepper.</p>
 
1032
</td>
 
1033
</table>
 
1034
<a name="REPORTING BUGS"></a>
 
1035
<h2>REPORTING BUGS</h2>
 
1036
<!-- INDENTATION -->
 
1037
<table width="100%" border=0 rules="none" frame="void"
 
1038
       cols="2" cellspacing="0" cellpadding="0">
 
1039
<tr valign="top" align="left">
 
1040
<td width="10%"></td>
 
1041
<td width="89%">
 
1042
<p>Report bugs to &lt;bug-gnu-gettext@gnu.org&gt;.</p>
 
1043
</td>
 
1044
</table>
 
1045
<a name="COPYRIGHT"></a>
 
1046
<h2>COPYRIGHT</h2>
 
1047
<!-- INDENTATION -->
 
1048
<table width="100%" border=0 rules="none" frame="void"
 
1049
       cols="2" cellspacing="0" cellpadding="0">
 
1050
<tr valign="top" align="left">
 
1051
<td width="10%"></td>
 
1052
<td width="89%">
 
1053
<p>Copyright &copy; 1995-1998, 2000-2010 Free Software
 
1054
Foundation, Inc. License GPLv3+: GNU GPL version 3 or later
 
1055
&lt;http://gnu.org/licenses/gpl.html&gt;<br>
 
1056
This is free software: you are free to change and
 
1057
redistribute it. There is NO WARRANTY, to the extent
 
1058
permitted by law.</p>
 
1059
</td>
 
1060
</table>
 
1061
<a name="SEE ALSO"></a>
 
1062
<h2>SEE ALSO</h2>
 
1063
<!-- INDENTATION -->
 
1064
<table width="100%" border=0 rules="none" frame="void"
 
1065
       cols="2" cellspacing="0" cellpadding="0">
 
1066
<tr valign="top" align="left">
 
1067
<td width="10%"></td>
 
1068
<td width="89%">
 
1069
<p>The full documentation for <b>xgettext</b> is maintained
 
1070
as a Texinfo manual. If the <b>info</b> and <b>xgettext</b>
 
1071
programs are properly installed at your site, the
 
1072
command</p>
 
1073
</td>
 
1074
</table>
 
1075
<!-- INDENTATION -->
 
1076
<table width="100%" border=0 rules="none" frame="void"
 
1077
       cols="2" cellspacing="0" cellpadding="0">
 
1078
<tr valign="top" align="left">
 
1079
<td width="20%"></td>
 
1080
<td width="79%">
 
1081
<p><b>info xgettext</b></p>
 
1082
</td>
 
1083
</table>
 
1084
<!-- INDENTATION -->
 
1085
<table width="100%" border=0 rules="none" frame="void"
 
1086
       cols="2" cellspacing="0" cellpadding="0">
 
1087
<tr valign="top" align="left">
 
1088
<td width="10%"></td>
 
1089
<td width="89%">
 
1090
<p>should give you access to the complete manual.</p>
 
1091
</td>
 
1092
</table>
 
1093
<hr>
 
1094
</body>
 
1095
</html>