Mercurial > repos > rliterman > csp2
comparison CSP2/CSP2_env/env-d9b9114564458d9d-741b3de822f2aaca6c6caa4325c4afce/share/doc/gettext/xgettext.1.html @ 68:5028fdace37b
planemo upload commit 2e9511a184a1ca667c7be0c6321a36dc4e3d116d
author | jpayne |
---|---|
date | Tue, 18 Mar 2025 16:23:26 -0400 |
parents | |
children |
comparison
equal
deleted
inserted
replaced
67:0e9998148a16 | 68:5028fdace37b |
---|---|
1 <!-- Creator : groff version 1.22.3 --> | |
2 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" | |
3 "http://www.w3.org/TR/html4/loose.dtd"> | |
4 <html> | |
5 <head> | |
6 <meta name="generator" content="groff -Thtml, see www.gnu.org"> | |
7 <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"> | |
8 <meta name="Content-Style" content="text/css"> | |
9 <style type="text/css"> | |
10 p { margin-top: 0; margin-bottom: 0; vertical-align: top } | |
11 pre { margin-top: 0; margin-bottom: 0; vertical-align: top } | |
12 table { margin-top: 0; margin-bottom: 0; vertical-align: top } | |
13 h1 { text-align: center } | |
14 </style> | |
15 <title>XGETTEXT</title> | |
16 | |
17 </head> | |
18 <body> | |
19 | |
20 <h1 align="center">XGETTEXT</h1> | |
21 | |
22 <a href="#NAME">NAME</a><br> | |
23 <a href="#SYNOPSIS">SYNOPSIS</a><br> | |
24 <a href="#DESCRIPTION">DESCRIPTION</a><br> | |
25 <a href="#AUTHOR">AUTHOR</a><br> | |
26 <a href="#REPORTING BUGS">REPORTING BUGS</a><br> | |
27 <a href="#COPYRIGHT">COPYRIGHT</a><br> | |
28 <a href="#SEE ALSO">SEE ALSO</a><br> | |
29 | |
30 <hr> | |
31 | |
32 | |
33 <h2>NAME | |
34 <a name="NAME"></a> | |
35 </h2> | |
36 | |
37 | |
38 <p style="margin-left:11%; margin-top: 1em">xgettext | |
39 - extract gettext strings from source</p> | |
40 | |
41 <h2>SYNOPSIS | |
42 <a name="SYNOPSIS"></a> | |
43 </h2> | |
44 | |
45 | |
46 | |
47 <p style="margin-left:11%; margin-top: 1em"><b>xgettext</b> | |
48 [<i>OPTION</i>] [<i>INPUTFILE</i>]...</p> | |
49 | |
50 <h2>DESCRIPTION | |
51 <a name="DESCRIPTION"></a> | |
52 </h2> | |
53 | |
54 | |
55 <p style="margin-left:11%; margin-top: 1em">Extract | |
56 translatable strings from given input files.</p> | |
57 | |
58 <p style="margin-left:11%; margin-top: 1em">Mandatory | |
59 arguments to long options are mandatory for short options | |
60 too. Similarly for optional arguments.</p> | |
61 | |
62 <p style="margin-left:11%; margin-top: 1em"><b>Input file | |
63 location:</b> <br> | |
64 INPUTFILE ...</p> | |
65 | |
66 <p style="margin-left:22%;">input files</p> | |
67 | |
68 <p style="margin-left:11%;"><b>-f</b>, | |
69 <b>--files-from</b>=<i>FILE</i></p> | |
70 | |
71 <p style="margin-left:22%;">get list of input files from | |
72 FILE</p> | |
73 | |
74 <p style="margin-left:11%;"><b>-D</b>, | |
75 <b>--directory</b>=<i>DIRECTORY</i></p> | |
76 | |
77 <p style="margin-left:22%;">add DIRECTORY to list for input | |
78 files search</p> | |
79 | |
80 <p style="margin-left:11%; margin-top: 1em">If input file | |
81 is -, standard input is read.</p> | |
82 | |
83 <p style="margin-left:11%; margin-top: 1em"><b>Output file | |
84 location: <br> | |
85 -d</b>, | |
86 <b>--default-domain</b>=<i>NAME</i></p> | |
87 | |
88 <p style="margin-left:22%;">use NAME.po for output (instead | |
89 of messages.po)</p> | |
90 | |
91 <p style="margin-left:11%;"><b>-o</b>, | |
92 <b>--output</b>=<i>FILE</i></p> | |
93 | |
94 <p style="margin-left:22%;">write output to specified | |
95 file</p> | |
96 | |
97 <p style="margin-left:11%;"><b>-p</b>, | |
98 <b>--output-dir</b>=<i>DIR</i></p> | |
99 | |
100 <p style="margin-left:22%;">output files will be placed in | |
101 directory DIR</p> | |
102 | |
103 <p style="margin-left:11%; margin-top: 1em">If output file | |
104 is -, output is written to standard output.</p> | |
105 | |
106 <p style="margin-left:11%; margin-top: 1em"><b>Choice of | |
107 input file language: <br> | |
108 -L</b>, <b>--language</b>=<i>NAME</i></p> | |
109 | |
110 <p style="margin-left:22%;">recognise the specified | |
111 language (C, C++, ObjectiveC, PO, Shell, Python, Lisp, | |
112 EmacsLisp, librep, Scheme, Smalltalk, Java, JavaProperties, | |
113 C#, awk, YCP, Tcl, Perl, PHP, Ruby, GCC-source, | |
114 NXStringTable, RST, RSJ, Glade, Lua, JavaScript, Vala, | |
115 Desktop)</p> | |
116 | |
117 <p style="margin-left:11%;"><b>-C</b>, | |
118 <b>--c</b>++</p> | |
119 | |
120 <p style="margin-left:22%;">shorthand for | |
121 <b>--language</b>=<i>C</i>++</p> | |
122 | |
123 <p style="margin-left:11%; margin-top: 1em">By default the | |
124 language is guessed depending on the input file name | |
125 extension.</p> | |
126 | |
127 <p style="margin-left:11%; margin-top: 1em"><b>Input file | |
128 interpretation: <br> | |
129 --from-code</b>=<i>NAME</i></p> | |
130 | |
131 <p style="margin-left:22%;">encoding of input files (except | |
132 for Python, Tcl, Glade)</p> | |
133 | |
134 <p style="margin-left:11%; margin-top: 1em">By default the | |
135 input files are assumed to be in ASCII.</p> | |
136 | |
137 <p style="margin-left:11%; margin-top: 1em"><b>Operation | |
138 mode: <br> | |
139 -j</b>, <b>--join-existing</b></p> | |
140 | |
141 <p style="margin-left:22%;">join messages with existing | |
142 file</p> | |
143 | |
144 <p style="margin-left:11%;"><b>-x</b>, | |
145 <b>--exclude-file</b>=<i>FILE</i>.po</p> | |
146 | |
147 <p style="margin-left:22%;">entries from FILE.po are not | |
148 extracted</p> | |
149 | |
150 <p style="margin-left:11%;"><b>-cTAG</b>, | |
151 <b>--add-comments</b>=<i>TAG</i></p> | |
152 | |
153 <p style="margin-left:22%;">place comment blocks starting | |
154 with TAG and preceding keyword lines in output file</p> | |
155 | |
156 <p style="margin-left:11%;"><b>-c</b>, | |
157 <b>--add-comments</b></p> | |
158 | |
159 <p style="margin-left:22%;">place all comment blocks | |
160 preceding keyword lines in output file</p> | |
161 | |
162 | |
163 <p style="margin-left:11%;"><b>--check</b>=<i>NAME</i></p> | |
164 | |
165 <p style="margin-left:22%;">perform syntax check on | |
166 messages (ellipsis-unicode, space-ellipsis,</p> | |
167 | |
168 | |
169 <p style="margin-left:22%; margin-top: 1em">quote-unicode, | |
170 bullet-unicode)</p> | |
171 | |
172 | |
173 <p style="margin-left:11%;"><b>--sentence-end</b>=<i>TYPE</i></p> | |
174 | |
175 <p style="margin-left:22%;">type describing the end of | |
176 sentence (single-space, which is the default,</p> | |
177 | |
178 <p style="margin-left:22%; margin-top: 1em">or | |
179 double-space)</p> | |
180 | |
181 <p style="margin-left:11%; margin-top: 1em"><b>Language | |
182 specific options: <br> | |
183 -a</b>, <b>--extract-all</b></p> | |
184 | |
185 <p style="margin-left:22%;">extract all strings (only | |
186 languages C, C++, ObjectiveC, Shell, Python, Lisp, | |
187 EmacsLisp, librep, Scheme, Java, C#, awk, Tcl, Perl, PHP, | |
188 GCC-source, Glade, Lua, JavaScript, Vala)</p> | |
189 | |
190 <p style="margin-left:11%;"><b>-kWORD</b>, | |
191 <b>--keyword</b>=<i>WORD</i></p> | |
192 | |
193 <p style="margin-left:22%;">look for WORD as an additional | |
194 keyword</p> | |
195 | |
196 <p style="margin-left:11%;"><b>-k</b>, | |
197 <b>--keyword</b></p> | |
198 | |
199 <p style="margin-left:22%;">do not to use default keywords | |
200 (only languages C, C++, ObjectiveC, Shell, Python, Lisp, | |
201 EmacsLisp, librep, Scheme, Java, C#, awk, Tcl, Perl, PHP, | |
202 GCC-source, Glade, Lua, JavaScript, Vala, Desktop)</p> | |
203 | |
204 | |
205 <p style="margin-left:11%;"><b>--flag</b>=<i>WORD</i>:ARG:FLAG</p> | |
206 | |
207 <p style="margin-left:22%;">additional flag for strings | |
208 inside the argument number ARG of keyword WORD</p> | |
209 | |
210 <p style="margin-left:11%;">(only languages C, C++, | |
211 ObjectiveC, Shell,</p> | |
212 | |
213 <p style="margin-left:22%;">Python, Lisp, EmacsLisp, | |
214 librep, Scheme, Java, C#, awk, YCP, Tcl, Perl, PHP, | |
215 GCC-source, Lua, JavaScript, Vala)</p> | |
216 | |
217 <p style="margin-left:11%;"><b>-T</b>, | |
218 <b>--trigraphs</b></p> | |
219 | |
220 <p style="margin-left:22%;">understand ANSI C trigraphs for | |
221 input (only languages C, C++, ObjectiveC)</p> | |
222 | |
223 | |
224 <p style="margin-left:11%;"><b>--its</b>=<i>FILE</i></p> | |
225 | |
226 <p style="margin-left:22%;">apply ITS rules from FILE (only | |
227 XML based languages)</p> | |
228 | |
229 <table width="100%" border="0" rules="none" frame="void" | |
230 cellspacing="0" cellpadding="0"> | |
231 <tr valign="top" align="left"> | |
232 <td width="11%"></td> | |
233 <td width="7%"> | |
234 | |
235 | |
236 <p><b>--qt</b></p></td> | |
237 <td width="4%"></td> | |
238 <td width="76%"> | |
239 | |
240 | |
241 <p>recognize Qt format strings (only language C++)</p></td> | |
242 <td width="2%"> | |
243 </td></tr> | |
244 <tr valign="top" align="left"> | |
245 <td width="11%"></td> | |
246 <td width="7%"> | |
247 | |
248 | |
249 <p><b>--kde</b></p></td> | |
250 <td width="4%"></td> | |
251 <td width="76%"> | |
252 | |
253 | |
254 <p>recognize KDE 4 format strings (only language C++)</p></td> | |
255 <td width="2%"> | |
256 </td></tr> | |
257 </table> | |
258 | |
259 <p style="margin-left:11%;"><b>--boost</b></p> | |
260 | |
261 <p style="margin-left:22%;">recognize Boost format strings | |
262 (only language C++)</p> | |
263 | |
264 <p style="margin-left:11%;"><b>--debug</b></p> | |
265 | |
266 <p style="margin-left:22%;">more detailed formatstring | |
267 recognition result</p> | |
268 | |
269 <p style="margin-left:11%; margin-top: 1em"><b>Output | |
270 details: <br> | |
271 --color</b></p> | |
272 | |
273 <p style="margin-left:22%;">use colors and other text | |
274 attributes always</p> | |
275 | |
276 | |
277 <p style="margin-left:11%;"><b>--color</b>=<i>WHEN</i></p> | |
278 | |
279 <p style="margin-left:22%;">use colors and other text | |
280 attributes if WHEN. WHEN may be ’always’, | |
281 ’never’, ’auto’, or | |
282 ’html’.</p> | |
283 | |
284 | |
285 <p style="margin-left:11%;"><b>--style</b>=<i>STYLEFILE</i></p> | |
286 | |
287 <p style="margin-left:22%;">specify CSS style rule file for | |
288 <b>--color</b></p> | |
289 | |
290 <p style="margin-left:11%;"><b>-e</b>, | |
291 <b>--no-escape</b></p> | |
292 | |
293 <p style="margin-left:22%;">do not use C escapes in output | |
294 (default)</p> | |
295 | |
296 <p style="margin-left:11%;"><b>-E</b>, | |
297 <b>--escape</b></p> | |
298 | |
299 <p style="margin-left:22%;">use C escapes in output, no | |
300 extended chars</p> | |
301 | |
302 | |
303 <p style="margin-left:11%;"><b>--force-po</b></p> | |
304 | |
305 <p style="margin-left:22%;">write PO file even if empty</p> | |
306 | |
307 <p style="margin-left:11%;"><b>-i</b>, | |
308 <b>--indent</b></p> | |
309 | |
310 <p style="margin-left:22%;">write the .po file using | |
311 indented style</p> | |
312 | |
313 | |
314 <p style="margin-left:11%;"><b>--no-location</b></p> | |
315 | |
316 <p style="margin-left:22%;">do not write ’#: | |
317 filename:line’ lines</p> | |
318 | |
319 <p style="margin-left:11%;"><b>-n</b>, | |
320 <b>--add-location</b></p> | |
321 | |
322 <p style="margin-left:22%;">generate ’#: | |
323 filename:line’ lines (default)</p> | |
324 | |
325 | |
326 <p style="margin-left:11%;"><b>--strict</b></p> | |
327 | |
328 <p style="margin-left:22%;">write out strict Uniforum | |
329 conforming .po file</p> | |
330 | |
331 | |
332 <p style="margin-left:11%;"><b>--properties-output</b></p> | |
333 | |
334 <p style="margin-left:22%;">write out a Java .properties | |
335 file</p> | |
336 | |
337 | |
338 <p style="margin-left:11%;"><b>--stringtable-output</b></p> | |
339 | |
340 <p style="margin-left:22%;">write out a NeXTstep/GNUstep | |
341 .strings file</p> | |
342 | |
343 | |
344 <p style="margin-left:11%;"><b>--itstool</b></p> | |
345 | |
346 <p style="margin-left:22%;">write out itstool comments</p> | |
347 | |
348 <p style="margin-left:11%;"><b>-w</b>, | |
349 <b>--width</b>=<i>NUMBER</i></p> | |
350 | |
351 <p style="margin-left:22%;">set output page width</p> | |
352 | |
353 | |
354 <p style="margin-left:11%;"><b>--no-wrap</b></p> | |
355 | |
356 <p style="margin-left:22%;">do not break long message | |
357 lines, longer than the output page width, into several | |
358 lines</p> | |
359 | |
360 <p style="margin-left:11%;"><b>-s</b>, | |
361 <b>--sort-output</b></p> | |
362 | |
363 <p style="margin-left:22%;">generate sorted output | |
364 (deprecated)</p> | |
365 | |
366 <p style="margin-left:11%;"><b>-F</b>, | |
367 <b>--sort-by-file</b></p> | |
368 | |
369 <p style="margin-left:22%;">sort output by file | |
370 location</p> | |
371 | |
372 | |
373 <p style="margin-left:11%;"><b>--omit-header</b></p> | |
374 | |
375 <p style="margin-left:22%;">don’t write header with | |
376 ’msgid ""’ entry</p> | |
377 | |
378 | |
379 <p style="margin-left:11%;"><b>--copyright-holder</b>=<i>STRING</i></p> | |
380 | |
381 <p style="margin-left:22%;">set copyright holder in | |
382 output</p> | |
383 | |
384 | |
385 <p style="margin-left:11%;"><b>--foreign-user</b></p> | |
386 | |
387 <p style="margin-left:22%;">omit FSF copyright in output | |
388 for foreign user</p> | |
389 | |
390 | |
391 <p style="margin-left:11%;"><b>--package-name</b>=<i>PACKAGE</i></p> | |
392 | |
393 <p style="margin-left:22%;">set package name in output</p> | |
394 | |
395 | |
396 <p style="margin-left:11%;"><b>--package-version</b>=<i>VERSION</i></p> | |
397 | |
398 <p style="margin-left:22%;">set package version in | |
399 output</p> | |
400 | |
401 | |
402 <p style="margin-left:11%;"><b>--msgid-bugs-address</b>=<i>EMAIL</i>@ADDRESS</p> | |
403 | |
404 <p style="margin-left:22%;">set report address for msgid | |
405 bugs</p> | |
406 | |
407 <p style="margin-left:11%;"><b>-m[STRING]</b>, | |
408 <b>--msgstr-prefix</b>[=<i>STRING</i>]</p> | |
409 | |
410 <p style="margin-left:22%;">use STRING or "" as | |
411 prefix for msgstr values</p> | |
412 | |
413 <p style="margin-left:11%;"><b>-M[STRING]</b>, | |
414 <b>--msgstr-suffix</b>[=<i>STRING</i>]</p> | |
415 | |
416 <p style="margin-left:22%;">use STRING or "" as | |
417 suffix for msgstr values</p> | |
418 | |
419 <p style="margin-left:11%; margin-top: 1em"><b>Informative | |
420 output: <br> | |
421 -h</b>, <b>--help</b></p> | |
422 | |
423 <p style="margin-left:22%;">display this help and exit</p> | |
424 | |
425 <p style="margin-left:11%;"><b>-V</b>, | |
426 <b>--version</b></p> | |
427 | |
428 <p style="margin-left:22%;">output version information and | |
429 exit</p> | |
430 | |
431 <p style="margin-left:11%;"><b>-v</b>, | |
432 <b>--verbose</b></p> | |
433 | |
434 <p style="margin-left:22%;">increase verbosity level</p> | |
435 | |
436 <h2>AUTHOR | |
437 <a name="AUTHOR"></a> | |
438 </h2> | |
439 | |
440 | |
441 <p style="margin-left:11%; margin-top: 1em">Written by | |
442 Ulrich Drepper.</p> | |
443 | |
444 <h2>REPORTING BUGS | |
445 <a name="REPORTING BUGS"></a> | |
446 </h2> | |
447 | |
448 | |
449 <p style="margin-left:11%; margin-top: 1em">Report bugs in | |
450 the bug tracker at | |
451 <https://savannah.gnu.org/projects/gettext> or by | |
452 email to <bug-gettext@gnu.org>.</p> | |
453 | |
454 <h2>COPYRIGHT | |
455 <a name="COPYRIGHT"></a> | |
456 </h2> | |
457 | |
458 | |
459 <p style="margin-left:11%; margin-top: 1em">Copyright | |
460 © 1995-2023 Free Software Foundation, Inc. | |
461 License GPLv3+: GNU GPL version 3 or later | |
462 <https://gnu.org/licenses/gpl.html> <br> | |
463 This is free software: you are free to change and | |
464 redistribute it. There is NO WARRANTY, to the extent | |
465 permitted by law.</p> | |
466 | |
467 <h2>SEE ALSO | |
468 <a name="SEE ALSO"></a> | |
469 </h2> | |
470 | |
471 | |
472 <p style="margin-left:11%; margin-top: 1em">The full | |
473 documentation for <b>xgettext</b> is maintained as a Texinfo | |
474 manual. If the <b>info</b> and <b>xgettext</b> programs are | |
475 properly installed at your site, the command</p> | |
476 | |
477 <p style="margin-left:22%; margin-top: 1em"><b>info | |
478 xgettext</b></p> | |
479 | |
480 <p style="margin-left:11%; margin-top: 1em">should give you | |
481 access to the complete manual.</p> | |
482 <hr> | |
483 </body> | |
484 </html> |