Install gettext-0.18.1.1.tar.gz
[msysgit.git] / mingw / share / doc / gettext / msgen.1.html
blobc1bf1da824e15c380d16ceadbd6d3610d46a5ef8
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>MSGEN</title>
7 </head>
8 <body>
10 <h1 align=center>MSGEN</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>
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>msgen &minus; create English message catalog</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>msgen</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>Creates an English translation catalog. The input file is
51 the last created English PO file, or a PO Template file
52 (generally created by xgettext). Untranslated entries are
53 assigned a translation that is identical to the msgid.</p>
54 <!-- INDENTATION -->
55 <p>Mandatory arguments to long options are mandatory for
56 short options too.</p>
57 </td>
58 </table>
59 <!-- INDENTATION -->
60 <table width="100%" border=0 rules="none" frame="void"
61 cols="2" cellspacing="0" cellpadding="0">
62 <tr valign="top" align="left">
63 <td width="4%"></td>
64 <td width="95%">
65 <p><b>Input file location:</b></p></td>
66 </table>
67 <!-- INDENTATION -->
68 <table width="100%" border=0 rules="none" frame="void"
69 cols="2" cellspacing="0" cellpadding="0">
70 <tr valign="top" align="left">
71 <td width="10%"></td>
72 <td width="89%">
73 <p>INPUTFILE</p></td>
74 </table>
75 <!-- INDENTATION -->
76 <table width="100%" border=0 rules="none" frame="void"
77 cols="2" cellspacing="0" cellpadding="0">
78 <tr valign="top" align="left">
79 <td width="21%"></td>
80 <td width="77%">
81 <p>input PO or POT file</p>
82 </td>
83 </table>
84 <!-- INDENTATION -->
85 <table width="100%" border=0 rules="none" frame="void"
86 cols="2" cellspacing="0" cellpadding="0">
87 <tr valign="top" align="left">
88 <td width="10%"></td>
89 <td width="89%">
90 <p><b>&minus;D</b>,
91 <b>&minus;&minus;directory</b>=<i>DIRECTORY</i></p></td>
92 </table>
93 <!-- INDENTATION -->
94 <table width="100%" border=0 rules="none" frame="void"
95 cols="2" cellspacing="0" cellpadding="0">
96 <tr valign="top" align="left">
97 <td width="21%"></td>
98 <td width="77%">
99 <p>add DIRECTORY to list for input files search</p>
100 </td>
101 </table>
102 <!-- INDENTATION -->
103 <table width="100%" border=0 rules="none" frame="void"
104 cols="2" cellspacing="0" cellpadding="0">
105 <tr valign="top" align="left">
106 <td width="10%"></td>
107 <td width="89%">
108 <p>If input file is -, standard input is read.</p>
109 </td>
110 </table>
111 <!-- INDENTATION -->
112 <table width="100%" border=0 rules="none" frame="void"
113 cols="2" cellspacing="0" cellpadding="0">
114 <tr valign="top" align="left">
115 <td width="4%"></td>
116 <td width="95%">
117 <p><b>Output file location:</b></p></td>
118 </table>
119 <!-- INDENTATION -->
120 <table width="100%" border=0 rules="none" frame="void"
121 cols="2" cellspacing="0" cellpadding="0">
122 <tr valign="top" align="left">
123 <td width="10%"></td>
124 <td width="89%">
125 <p><b>&minus;o</b>,
126 <b>&minus;&minus;output&minus;file</b>=<i>FILE</i></p></td>
127 </table>
128 <!-- INDENTATION -->
129 <table width="100%" border=0 rules="none" frame="void"
130 cols="2" cellspacing="0" cellpadding="0">
131 <tr valign="top" align="left">
132 <td width="21%"></td>
133 <td width="77%">
134 <p>write output to specified file</p>
135 </td>
136 </table>
137 <!-- INDENTATION -->
138 <table width="100%" border=0 rules="none" frame="void"
139 cols="2" cellspacing="0" cellpadding="0">
140 <tr valign="top" align="left">
141 <td width="10%"></td>
142 <td width="89%">
143 <p>The results are written to standard output if no output
144 file is specified or if it is -.</p>
145 </td>
146 </table>
147 <!-- INDENTATION -->
148 <table width="100%" border=0 rules="none" frame="void"
149 cols="2" cellspacing="0" cellpadding="0">
150 <tr valign="top" align="left">
151 <td width="4%"></td>
152 <td width="95%">
153 <p><b>Input file syntax:</b></p></td>
154 </table>
155 <!-- INDENTATION -->
156 <table width="100%" border=0 rules="none" frame="void"
157 cols="2" cellspacing="0" cellpadding="0">
158 <tr valign="top" align="left">
159 <td width="10%"></td>
160 <td width="89%">
161 <p><b>&minus;P</b>,
162 <b>&minus;&minus;properties&minus;input</b></p></td>
163 </table>
164 <!-- INDENTATION -->
165 <table width="100%" border=0 rules="none" frame="void"
166 cols="2" cellspacing="0" cellpadding="0">
167 <tr valign="top" align="left">
168 <td width="21%"></td>
169 <td width="77%">
170 <p>input file is in Java .properties syntax</p>
171 </td>
172 </table>
173 <!-- INDENTATION -->
174 <table width="100%" border=0 rules="none" frame="void"
175 cols="2" cellspacing="0" cellpadding="0">
176 <tr valign="top" align="left">
177 <td width="10%"></td>
178 <td width="89%">
179 <p><b>&minus;&minus;stringtable&minus;input</b></p></td>
180 </table>
181 <!-- INDENTATION -->
182 <table width="100%" border=0 rules="none" frame="void"
183 cols="2" cellspacing="0" cellpadding="0">
184 <tr valign="top" align="left">
185 <td width="21%"></td>
186 <td width="77%">
187 <p>input file is in NeXTstep/GNUstep .strings syntax</p>
188 </td>
189 </table>
190 <!-- INDENTATION -->
191 <table width="100%" border=0 rules="none" frame="void"
192 cols="2" cellspacing="0" cellpadding="0">
193 <tr valign="top" align="left">
194 <td width="4%"></td>
195 <td width="95%">
196 <p><b>Output details:</b></p></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="10%"></td>
203 <td width="89%">
204 <p><b>&minus;&minus;lang</b>=<i>CATALOGNAME</i></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="21%"></td>
211 <td width="77%">
212 <p>set &rsquo;Language&rsquo; field in the header entry</p>
213 </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="10%"></td>
220 <td width="89%">
221 <p><b>&minus;&minus;color</b></p></td>
222 </table>
223 <!-- INDENTATION -->
224 <table width="100%" border=0 rules="none" frame="void"
225 cols="2" cellspacing="0" cellpadding="0">
226 <tr valign="top" align="left">
227 <td width="21%"></td>
228 <td width="77%">
229 <p>use colors and other text attributes always</p>
230 </td>
231 </table>
232 <!-- INDENTATION -->
233 <table width="100%" border=0 rules="none" frame="void"
234 cols="2" cellspacing="0" cellpadding="0">
235 <tr valign="top" align="left">
236 <td width="10%"></td>
237 <td width="89%">
238 <p><b>&minus;&minus;color</b>=<i>WHEN</i></p></td>
239 </table>
240 <!-- INDENTATION -->
241 <table width="100%" border=0 rules="none" frame="void"
242 cols="2" cellspacing="0" cellpadding="0">
243 <tr valign="top" align="left">
244 <td width="21%"></td>
245 <td width="77%">
246 <p>use colors and other text attributes if WHEN. WHEN may be
247 &rsquo;always&rsquo;, &rsquo;never&rsquo;,
248 &rsquo;auto&rsquo;, or &rsquo;html&rsquo;.</p>
249 </td>
250 </table>
251 <!-- INDENTATION -->
252 <table width="100%" border=0 rules="none" frame="void"
253 cols="2" cellspacing="0" cellpadding="0">
254 <tr valign="top" align="left">
255 <td width="10%"></td>
256 <td width="89%">
257 <p><b>&minus;&minus;style</b>=<i>STYLEFILE</i></p></td>
258 </table>
259 <!-- INDENTATION -->
260 <table width="100%" border=0 rules="none" frame="void"
261 cols="2" cellspacing="0" cellpadding="0">
262 <tr valign="top" align="left">
263 <td width="21%"></td>
264 <td width="77%">
265 <p>specify CSS style rule file for
266 <b>&minus;&minus;color</b></p>
267 </td>
268 </table>
269 <!-- INDENTATION -->
270 <table width="100%" border=0 rules="none" frame="void"
271 cols="2" cellspacing="0" cellpadding="0">
272 <tr valign="top" align="left">
273 <td width="10%"></td>
274 <td width="89%">
275 <p><b>&minus;e</b>,
276 <b>&minus;&minus;no&minus;escape</b></p></td>
277 </table>
278 <!-- INDENTATION -->
279 <table width="100%" border=0 rules="none" frame="void"
280 cols="2" cellspacing="0" cellpadding="0">
281 <tr valign="top" align="left">
282 <td width="21%"></td>
283 <td width="77%">
284 <p>do not use C escapes in output (default)</p>
285 </td>
286 </table>
287 <!-- INDENTATION -->
288 <table width="100%" border=0 rules="none" frame="void"
289 cols="2" cellspacing="0" cellpadding="0">
290 <tr valign="top" align="left">
291 <td width="10%"></td>
292 <td width="89%">
293 <p><b>&minus;E</b>, <b>&minus;&minus;escape</b></p></td>
294 </table>
295 <!-- INDENTATION -->
296 <table width="100%" border=0 rules="none" frame="void"
297 cols="2" cellspacing="0" cellpadding="0">
298 <tr valign="top" align="left">
299 <td width="21%"></td>
300 <td width="77%">
301 <p>use C escapes in output, no extended chars</p>
302 </td>
303 </table>
304 <!-- INDENTATION -->
305 <table width="100%" border=0 rules="none" frame="void"
306 cols="2" cellspacing="0" cellpadding="0">
307 <tr valign="top" align="left">
308 <td width="10%"></td>
309 <td width="89%">
310 <p><b>&minus;&minus;force&minus;po</b></p></td>
311 </table>
312 <!-- INDENTATION -->
313 <table width="100%" border=0 rules="none" frame="void"
314 cols="2" cellspacing="0" cellpadding="0">
315 <tr valign="top" align="left">
316 <td width="21%"></td>
317 <td width="77%">
318 <p>write PO file even if empty</p>
319 </td>
320 </table>
321 <!-- INDENTATION -->
322 <table width="100%" border=0 rules="none" frame="void"
323 cols="2" cellspacing="0" cellpadding="0">
324 <tr valign="top" align="left">
325 <td width="10%"></td>
326 <td width="89%">
327 <p><b>&minus;i</b>, <b>&minus;&minus;indent</b></p></td>
328 </table>
329 <!-- INDENTATION -->
330 <table width="100%" border=0 rules="none" frame="void"
331 cols="2" cellspacing="0" cellpadding="0">
332 <tr valign="top" align="left">
333 <td width="21%"></td>
334 <td width="77%">
335 <p>indented output style</p>
336 </td>
337 </table>
338 <!-- INDENTATION -->
339 <table width="100%" border=0 rules="none" frame="void"
340 cols="2" cellspacing="0" cellpadding="0">
341 <tr valign="top" align="left">
342 <td width="10%"></td>
343 <td width="89%">
344 <p><b>&minus;&minus;no&minus;location</b></p></td>
345 </table>
346 <!-- INDENTATION -->
347 <table width="100%" border=0 rules="none" frame="void"
348 cols="2" cellspacing="0" cellpadding="0">
349 <tr valign="top" align="left">
350 <td width="21%"></td>
351 <td width="77%">
352 <p>suppress &rsquo;#: filename:line&rsquo; lines</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;&minus;add&minus;location</b></p></td>
362 </table>
363 <!-- INDENTATION -->
364 <table width="100%" border=0 rules="none" frame="void"
365 cols="2" cellspacing="0" cellpadding="0">
366 <tr valign="top" align="left">
367 <td width="21%"></td>
368 <td width="77%">
369 <p>preserve &rsquo;#: filename:line&rsquo; lines
370 (default)</p>
371 </td>
372 </table>
373 <!-- INDENTATION -->
374 <table width="100%" border=0 rules="none" frame="void"
375 cols="2" cellspacing="0" cellpadding="0">
376 <tr valign="top" align="left">
377 <td width="10%"></td>
378 <td width="89%">
379 <p><b>&minus;&minus;strict</b></p></td>
380 </table>
381 <!-- INDENTATION -->
382 <table width="100%" border=0 rules="none" frame="void"
383 cols="2" cellspacing="0" cellpadding="0">
384 <tr valign="top" align="left">
385 <td width="21%"></td>
386 <td width="77%">
387 <p>strict Uniforum output style</p>
388 </td>
389 </table>
390 <!-- INDENTATION -->
391 <table width="100%" border=0 rules="none" frame="void"
392 cols="2" cellspacing="0" cellpadding="0">
393 <tr valign="top" align="left">
394 <td width="10%"></td>
395 <td width="89%">
396 <p><b>&minus;p</b>,
397 <b>&minus;&minus;properties&minus;output</b></p></td>
398 </table>
399 <!-- INDENTATION -->
400 <table width="100%" border=0 rules="none" frame="void"
401 cols="2" cellspacing="0" cellpadding="0">
402 <tr valign="top" align="left">
403 <td width="21%"></td>
404 <td width="77%">
405 <p>write out a Java .properties file</p>
406 </td>
407 </table>
408 <!-- INDENTATION -->
409 <table width="100%" border=0 rules="none" frame="void"
410 cols="2" cellspacing="0" cellpadding="0">
411 <tr valign="top" align="left">
412 <td width="10%"></td>
413 <td width="89%">
414 <p><b>&minus;&minus;stringtable&minus;output</b></p></td>
415 </table>
416 <!-- INDENTATION -->
417 <table width="100%" border=0 rules="none" frame="void"
418 cols="2" cellspacing="0" cellpadding="0">
419 <tr valign="top" align="left">
420 <td width="21%"></td>
421 <td width="77%">
422 <p>write out a NeXTstep/GNUstep .strings file</p>
423 </td>
424 </table>
425 <!-- INDENTATION -->
426 <table width="100%" border=0 rules="none" frame="void"
427 cols="2" cellspacing="0" cellpadding="0">
428 <tr valign="top" align="left">
429 <td width="10%"></td>
430 <td width="89%">
431 <p><b>&minus;w</b>,
432 <b>&minus;&minus;width</b>=<i>NUMBER</i></p></td>
433 </table>
434 <!-- INDENTATION -->
435 <table width="100%" border=0 rules="none" frame="void"
436 cols="2" cellspacing="0" cellpadding="0">
437 <tr valign="top" align="left">
438 <td width="21%"></td>
439 <td width="77%">
440 <p>set output page width</p>
441 </td>
442 </table>
443 <!-- INDENTATION -->
444 <table width="100%" border=0 rules="none" frame="void"
445 cols="2" cellspacing="0" cellpadding="0">
446 <tr valign="top" align="left">
447 <td width="10%"></td>
448 <td width="89%">
449 <p><b>&minus;&minus;no&minus;wrap</b></p></td>
450 </table>
451 <!-- INDENTATION -->
452 <table width="100%" border=0 rules="none" frame="void"
453 cols="2" cellspacing="0" cellpadding="0">
454 <tr valign="top" align="left">
455 <td width="21%"></td>
456 <td width="77%">
457 <p>do not break long message lines, longer than the output
458 page width, into several lines</p>
459 </td>
460 </table>
461 <!-- INDENTATION -->
462 <table width="100%" border=0 rules="none" frame="void"
463 cols="2" cellspacing="0" cellpadding="0">
464 <tr valign="top" align="left">
465 <td width="10%"></td>
466 <td width="89%">
467 <p><b>&minus;s</b>,
468 <b>&minus;&minus;sort&minus;output</b></p></td>
469 </table>
470 <!-- INDENTATION -->
471 <table width="100%" border=0 rules="none" frame="void"
472 cols="2" cellspacing="0" cellpadding="0">
473 <tr valign="top" align="left">
474 <td width="21%"></td>
475 <td width="77%">
476 <p>generate sorted output</p>
477 </td>
478 </table>
479 <!-- INDENTATION -->
480 <table width="100%" border=0 rules="none" frame="void"
481 cols="2" cellspacing="0" cellpadding="0">
482 <tr valign="top" align="left">
483 <td width="10%"></td>
484 <td width="89%">
485 <p><b>&minus;F</b>,
486 <b>&minus;&minus;sort&minus;by&minus;file</b></p></td>
487 </table>
488 <!-- INDENTATION -->
489 <table width="100%" border=0 rules="none" frame="void"
490 cols="2" cellspacing="0" cellpadding="0">
491 <tr valign="top" align="left">
492 <td width="21%"></td>
493 <td width="77%">
494 <p>sort output by file location</p>
495 </td>
496 </table>
497 <!-- INDENTATION -->
498 <table width="100%" border=0 rules="none" frame="void"
499 cols="2" cellspacing="0" cellpadding="0">
500 <tr valign="top" align="left">
501 <td width="4%"></td>
502 <td width="95%">
503 <p><b>Informative output:</b></p></td>
504 </table>
505 <!-- INDENTATION -->
506 <table width="100%" border=0 rules="none" frame="void"
507 cols="2" cellspacing="0" cellpadding="0">
508 <tr valign="top" align="left">
509 <td width="10%"></td>
510 <td width="89%">
511 <p><b>&minus;h</b>, <b>&minus;&minus;help</b></p></td>
512 </table>
513 <!-- INDENTATION -->
514 <table width="100%" border=0 rules="none" frame="void"
515 cols="2" cellspacing="0" cellpadding="0">
516 <tr valign="top" align="left">
517 <td width="21%"></td>
518 <td width="77%">
519 <p>display this help and exit</p>
520 </td>
521 </table>
522 <!-- INDENTATION -->
523 <table width="100%" border=0 rules="none" frame="void"
524 cols="2" cellspacing="0" cellpadding="0">
525 <tr valign="top" align="left">
526 <td width="10%"></td>
527 <td width="89%">
528 <p><b>&minus;V</b>, <b>&minus;&minus;version</b></p></td>
529 </table>
530 <!-- INDENTATION -->
531 <table width="100%" border=0 rules="none" frame="void"
532 cols="2" cellspacing="0" cellpadding="0">
533 <tr valign="top" align="left">
534 <td width="21%"></td>
535 <td width="77%">
536 <p>output version information and exit</p>
537 </td>
538 </table>
539 <a name="AUTHOR"></a>
540 <h2>AUTHOR</h2>
541 <!-- INDENTATION -->
542 <table width="100%" border=0 rules="none" frame="void"
543 cols="2" cellspacing="0" cellpadding="0">
544 <tr valign="top" align="left">
545 <td width="10%"></td>
546 <td width="89%">
547 <p>Written by Bruno Haible.</p>
548 </td>
549 </table>
550 <a name="REPORTING BUGS"></a>
551 <h2>REPORTING BUGS</h2>
552 <!-- INDENTATION -->
553 <table width="100%" border=0 rules="none" frame="void"
554 cols="2" cellspacing="0" cellpadding="0">
555 <tr valign="top" align="left">
556 <td width="10%"></td>
557 <td width="89%">
558 <p>Report bugs to &lt;bug-gnu-gettext@gnu.org&gt;.</p>
559 </td>
560 </table>
561 <a name="COPYRIGHT"></a>
562 <h2>COPYRIGHT</h2>
563 <!-- INDENTATION -->
564 <table width="100%" border=0 rules="none" frame="void"
565 cols="2" cellspacing="0" cellpadding="0">
566 <tr valign="top" align="left">
567 <td width="10%"></td>
568 <td width="89%">
569 <p>Copyright &copy; 2001-2010 Free Software Foundation, Inc.
570 License GPLv3+: GNU GPL version 3 or later
571 &lt;http://gnu.org/licenses/gpl.html&gt;<br>
572 This is free software: you are free to change and
573 redistribute it. There is NO WARRANTY, to the extent
574 permitted by law.</p>
575 </td>
576 </table>
577 <a name="SEE ALSO"></a>
578 <h2>SEE ALSO</h2>
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="10%"></td>
584 <td width="89%">
585 <p>The full documentation for <b>msgen</b> is maintained as
586 a Texinfo manual. If the <b>info</b> and <b>msgen</b>
587 programs are properly installed at your site, the
588 command</p>
589 </td>
590 </table>
591 <!-- INDENTATION -->
592 <table width="100%" border=0 rules="none" frame="void"
593 cols="2" cellspacing="0" cellpadding="0">
594 <tr valign="top" align="left">
595 <td width="20%"></td>
596 <td width="79%">
597 <p><b>info msgen</b></p>
598 </td>
599 </table>
600 <!-- INDENTATION -->
601 <table width="100%" border=0 rules="none" frame="void"
602 cols="2" cellspacing="0" cellpadding="0">
603 <tr valign="top" align="left">
604 <td width="10%"></td>
605 <td width="89%">
606 <p>should give you access to the complete manual.</p>
607 </td>
608 </table>
609 <hr>
610 </body>
611 </html>