Mark msysGit as obsolete
[msysgit.git] / mingw / share / doc / gettext / msgconv.1.html
blob326bf783dc67718f40d7123f5a96623bc7564bcb
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>MSGCONV</title>
7 </head>
8 <body>
10 <h1 align=center>MSGCONV</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>msgconv &minus; character set conversion for message
29 catalog</p>
30 </td>
31 </table>
32 <a name="SYNOPSIS"></a>
33 <h2>SYNOPSIS</h2>
34 <!-- INDENTATION -->
35 <table width="100%" border=0 rules="none" frame="void"
36 cols="2" cellspacing="0" cellpadding="0">
37 <tr valign="top" align="left">
38 <td width="10%"></td>
39 <td width="89%">
40 <p><b>msgconv</b> [<i>OPTION</i>] [<i>INPUTFILE</i>]</p>
41 </td>
42 </table>
43 <a name="DESCRIPTION"></a>
44 <h2>DESCRIPTION</h2>
45 <!-- INDENTATION -->
46 <table width="100%" border=0 rules="none" frame="void"
47 cols="2" cellspacing="0" cellpadding="0">
48 <tr valign="top" align="left">
49 <td width="10%"></td>
50 <td width="89%">
51 <p>Converts a translation catalog to a different character
52 encoding.</p>
53 <!-- INDENTATION -->
54 <p>Mandatory arguments to long options are mandatory for
55 short options too.</p>
56 </td>
57 </table>
58 <!-- INDENTATION -->
59 <table width="100%" border=0 rules="none" frame="void"
60 cols="2" cellspacing="0" cellpadding="0">
61 <tr valign="top" align="left">
62 <td width="4%"></td>
63 <td width="95%">
64 <p><b>Input file location:</b></p></td>
65 </table>
66 <!-- INDENTATION -->
67 <table width="100%" border=0 rules="none" frame="void"
68 cols="2" cellspacing="0" cellpadding="0">
69 <tr valign="top" align="left">
70 <td width="10%"></td>
71 <td width="89%">
72 <p>INPUTFILE</p></td>
73 </table>
74 <!-- INDENTATION -->
75 <table width="100%" border=0 rules="none" frame="void"
76 cols="2" cellspacing="0" cellpadding="0">
77 <tr valign="top" align="left">
78 <td width="21%"></td>
79 <td width="77%">
80 <p>input PO file</p>
81 </td>
82 </table>
83 <!-- INDENTATION -->
84 <table width="100%" border=0 rules="none" frame="void"
85 cols="2" cellspacing="0" cellpadding="0">
86 <tr valign="top" align="left">
87 <td width="10%"></td>
88 <td width="89%">
89 <p><b>&minus;D</b>,
90 <b>&minus;&minus;directory</b>=<i>DIRECTORY</i></p></td>
91 </table>
92 <!-- INDENTATION -->
93 <table width="100%" border=0 rules="none" frame="void"
94 cols="2" cellspacing="0" cellpadding="0">
95 <tr valign="top" align="left">
96 <td width="21%"></td>
97 <td width="77%">
98 <p>add DIRECTORY to list for input files search</p>
99 </td>
100 </table>
101 <!-- INDENTATION -->
102 <table width="100%" border=0 rules="none" frame="void"
103 cols="2" cellspacing="0" cellpadding="0">
104 <tr valign="top" align="left">
105 <td width="10%"></td>
106 <td width="89%">
107 <p>If no input file is given or if it is -, standard input
108 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>Conversion target:</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;t</b>,
162 <b>&minus;&minus;to&minus;code</b>=<i>NAME</i></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>encoding for output</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>The default encoding is the current locale&rsquo;s
180 encoding.</p>
181 </td>
182 </table>
183 <!-- INDENTATION -->
184 <table width="100%" border=0 rules="none" frame="void"
185 cols="2" cellspacing="0" cellpadding="0">
186 <tr valign="top" align="left">
187 <td width="4%"></td>
188 <td width="95%">
189 <p><b>Input file syntax:</b></p></td>
190 </table>
191 <!-- INDENTATION -->
192 <table width="100%" border=0 rules="none" frame="void"
193 cols="2" cellspacing="0" cellpadding="0">
194 <tr valign="top" align="left">
195 <td width="10%"></td>
196 <td width="89%">
197 <p><b>&minus;P</b>,
198 <b>&minus;&minus;properties&minus;input</b></p></td>
199 </table>
200 <!-- INDENTATION -->
201 <table width="100%" border=0 rules="none" frame="void"
202 cols="2" cellspacing="0" cellpadding="0">
203 <tr valign="top" align="left">
204 <td width="21%"></td>
205 <td width="77%">
206 <p>input file is in Java .properties syntax</p>
207 </td>
208 </table>
209 <!-- INDENTATION -->
210 <table width="100%" border=0 rules="none" frame="void"
211 cols="2" cellspacing="0" cellpadding="0">
212 <tr valign="top" align="left">
213 <td width="10%"></td>
214 <td width="89%">
215 <p><b>&minus;&minus;stringtable&minus;input</b></p></td>
216 </table>
217 <!-- INDENTATION -->
218 <table width="100%" border=0 rules="none" frame="void"
219 cols="2" cellspacing="0" cellpadding="0">
220 <tr valign="top" align="left">
221 <td width="21%"></td>
222 <td width="77%">
223 <p>input file is in NeXTstep/GNUstep .strings syntax</p>
224 </td>
225 </table>
226 <!-- INDENTATION -->
227 <table width="100%" border=0 rules="none" frame="void"
228 cols="2" cellspacing="0" cellpadding="0">
229 <tr valign="top" align="left">
230 <td width="4%"></td>
231 <td width="95%">
232 <p><b>Output details:</b></p></td>
233 </table>
234 <!-- INDENTATION -->
235 <table width="100%" border=0 rules="none" frame="void"
236 cols="2" cellspacing="0" cellpadding="0">
237 <tr valign="top" align="left">
238 <td width="10%"></td>
239 <td width="89%">
240 <p><b>&minus;&minus;color</b></p></td>
241 </table>
242 <!-- INDENTATION -->
243 <table width="100%" border=0 rules="none" frame="void"
244 cols="2" cellspacing="0" cellpadding="0">
245 <tr valign="top" align="left">
246 <td width="21%"></td>
247 <td width="77%">
248 <p>use colors and other text attributes always</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;color</b>=<i>WHEN</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>use colors and other text attributes if WHEN. WHEN may be
266 &rsquo;always&rsquo;, &rsquo;never&rsquo;,
267 &rsquo;auto&rsquo;, or &rsquo;html&rsquo;.</p>
268 </td>
269 </table>
270 <!-- INDENTATION -->
271 <table width="100%" border=0 rules="none" frame="void"
272 cols="2" cellspacing="0" cellpadding="0">
273 <tr valign="top" align="left">
274 <td width="10%"></td>
275 <td width="89%">
276 <p><b>&minus;&minus;style</b>=<i>STYLEFILE</i></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>specify CSS style rule file for
285 <b>&minus;&minus;color</b></p>
286 </td>
287 </table>
288 <!-- INDENTATION -->
289 <table width="100%" border=0 rules="none" frame="void"
290 cols="2" cellspacing="0" cellpadding="0">
291 <tr valign="top" align="left">
292 <td width="10%"></td>
293 <td width="89%">
294 <p><b>&minus;e</b>,
295 <b>&minus;&minus;no&minus;escape</b></p></td>
296 </table>
297 <!-- INDENTATION -->
298 <table width="100%" border=0 rules="none" frame="void"
299 cols="2" cellspacing="0" cellpadding="0">
300 <tr valign="top" align="left">
301 <td width="21%"></td>
302 <td width="77%">
303 <p>do not use C escapes in output (default)</p>
304 </td>
305 </table>
306 <!-- INDENTATION -->
307 <table width="100%" border=0 rules="none" frame="void"
308 cols="2" cellspacing="0" cellpadding="0">
309 <tr valign="top" align="left">
310 <td width="10%"></td>
311 <td width="89%">
312 <p><b>&minus;E</b>, <b>&minus;&minus;escape</b></p></td>
313 </table>
314 <!-- INDENTATION -->
315 <table width="100%" border=0 rules="none" frame="void"
316 cols="2" cellspacing="0" cellpadding="0">
317 <tr valign="top" align="left">
318 <td width="21%"></td>
319 <td width="77%">
320 <p>use C escapes in output, no extended chars</p>
321 </td>
322 </table>
323 <!-- INDENTATION -->
324 <table width="100%" border=0 rules="none" frame="void"
325 cols="2" cellspacing="0" cellpadding="0">
326 <tr valign="top" align="left">
327 <td width="10%"></td>
328 <td width="89%">
329 <p><b>&minus;&minus;force&minus;po</b></p></td>
330 </table>
331 <!-- INDENTATION -->
332 <table width="100%" border=0 rules="none" frame="void"
333 cols="2" cellspacing="0" cellpadding="0">
334 <tr valign="top" align="left">
335 <td width="21%"></td>
336 <td width="77%">
337 <p>write PO file even if empty</p>
338 </td>
339 </table>
340 <!-- INDENTATION -->
341 <table width="100%" border=0 rules="none" frame="void"
342 cols="2" cellspacing="0" cellpadding="0">
343 <tr valign="top" align="left">
344 <td width="10%"></td>
345 <td width="89%">
346 <p><b>&minus;i</b>, <b>&minus;&minus;indent</b></p></td>
347 </table>
348 <!-- INDENTATION -->
349 <table width="100%" border=0 rules="none" frame="void"
350 cols="2" cellspacing="0" cellpadding="0">
351 <tr valign="top" align="left">
352 <td width="21%"></td>
353 <td width="77%">
354 <p>indented output style</p>
355 </td>
356 </table>
357 <!-- INDENTATION -->
358 <table width="100%" border=0 rules="none" frame="void"
359 cols="2" cellspacing="0" cellpadding="0">
360 <tr valign="top" align="left">
361 <td width="10%"></td>
362 <td width="89%">
363 <p><b>&minus;&minus;no&minus;location</b></p></td>
364 </table>
365 <!-- INDENTATION -->
366 <table width="100%" border=0 rules="none" frame="void"
367 cols="2" cellspacing="0" cellpadding="0">
368 <tr valign="top" align="left">
369 <td width="21%"></td>
370 <td width="77%">
371 <p>suppress &rsquo;#: filename:line&rsquo; lines</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="10%"></td>
379 <td width="89%">
380 <p><b>&minus;&minus;add&minus;location</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="21%"></td>
387 <td width="77%">
388 <p>preserve &rsquo;#: filename:line&rsquo; lines
389 (default)</p>
390 </td>
391 </table>
392 <!-- INDENTATION -->
393 <table width="100%" border=0 rules="none" frame="void"
394 cols="2" cellspacing="0" cellpadding="0">
395 <tr valign="top" align="left">
396 <td width="10%"></td>
397 <td width="89%">
398 <p><b>&minus;&minus;strict</b></p></td>
399 </table>
400 <!-- INDENTATION -->
401 <table width="100%" border=0 rules="none" frame="void"
402 cols="2" cellspacing="0" cellpadding="0">
403 <tr valign="top" align="left">
404 <td width="21%"></td>
405 <td width="77%">
406 <p>strict Uniforum output style</p>
407 </td>
408 </table>
409 <!-- INDENTATION -->
410 <table width="100%" border=0 rules="none" frame="void"
411 cols="2" cellspacing="0" cellpadding="0">
412 <tr valign="top" align="left">
413 <td width="10%"></td>
414 <td width="89%">
415 <p><b>&minus;p</b>,
416 <b>&minus;&minus;properties&minus;output</b></p></td>
417 </table>
418 <!-- INDENTATION -->
419 <table width="100%" border=0 rules="none" frame="void"
420 cols="2" cellspacing="0" cellpadding="0">
421 <tr valign="top" align="left">
422 <td width="21%"></td>
423 <td width="77%">
424 <p>write out a Java .properties file</p>
425 </td>
426 </table>
427 <!-- INDENTATION -->
428 <table width="100%" border=0 rules="none" frame="void"
429 cols="2" cellspacing="0" cellpadding="0">
430 <tr valign="top" align="left">
431 <td width="10%"></td>
432 <td width="89%">
433 <p><b>&minus;&minus;stringtable&minus;output</b></p></td>
434 </table>
435 <!-- INDENTATION -->
436 <table width="100%" border=0 rules="none" frame="void"
437 cols="2" cellspacing="0" cellpadding="0">
438 <tr valign="top" align="left">
439 <td width="21%"></td>
440 <td width="77%">
441 <p>write out a NeXTstep/GNUstep .strings file</p>
442 </td>
443 </table>
444 <!-- INDENTATION -->
445 <table width="100%" border=0 rules="none" frame="void"
446 cols="2" cellspacing="0" cellpadding="0">
447 <tr valign="top" align="left">
448 <td width="10%"></td>
449 <td width="89%">
450 <p><b>&minus;w</b>,
451 <b>&minus;&minus;width</b>=<i>NUMBER</i></p></td>
452 </table>
453 <!-- INDENTATION -->
454 <table width="100%" border=0 rules="none" frame="void"
455 cols="2" cellspacing="0" cellpadding="0">
456 <tr valign="top" align="left">
457 <td width="21%"></td>
458 <td width="77%">
459 <p>set output page width</p>
460 </td>
461 </table>
462 <!-- INDENTATION -->
463 <table width="100%" border=0 rules="none" frame="void"
464 cols="2" cellspacing="0" cellpadding="0">
465 <tr valign="top" align="left">
466 <td width="10%"></td>
467 <td width="89%">
468 <p><b>&minus;&minus;no&minus;wrap</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>do not break long message lines, longer than the output
477 page width, into several lines</p>
478 </td>
479 </table>
480 <!-- INDENTATION -->
481 <table width="100%" border=0 rules="none" frame="void"
482 cols="2" cellspacing="0" cellpadding="0">
483 <tr valign="top" align="left">
484 <td width="10%"></td>
485 <td width="89%">
486 <p><b>&minus;s</b>,
487 <b>&minus;&minus;sort&minus;output</b></p></td>
488 </table>
489 <!-- INDENTATION -->
490 <table width="100%" border=0 rules="none" frame="void"
491 cols="2" cellspacing="0" cellpadding="0">
492 <tr valign="top" align="left">
493 <td width="21%"></td>
494 <td width="77%">
495 <p>generate sorted output</p>
496 </td>
497 </table>
498 <!-- INDENTATION -->
499 <table width="100%" border=0 rules="none" frame="void"
500 cols="2" cellspacing="0" cellpadding="0">
501 <tr valign="top" align="left">
502 <td width="10%"></td>
503 <td width="89%">
504 <p><b>&minus;F</b>,
505 <b>&minus;&minus;sort&minus;by&minus;file</b></p></td>
506 </table>
507 <!-- INDENTATION -->
508 <table width="100%" border=0 rules="none" frame="void"
509 cols="2" cellspacing="0" cellpadding="0">
510 <tr valign="top" align="left">
511 <td width="21%"></td>
512 <td width="77%">
513 <p>sort output by file location</p>
514 </td>
515 </table>
516 <!-- INDENTATION -->
517 <table width="100%" border=0 rules="none" frame="void"
518 cols="2" cellspacing="0" cellpadding="0">
519 <tr valign="top" align="left">
520 <td width="4%"></td>
521 <td width="95%">
522 <p><b>Informative output:</b></p></td>
523 </table>
524 <!-- INDENTATION -->
525 <table width="100%" border=0 rules="none" frame="void"
526 cols="2" cellspacing="0" cellpadding="0">
527 <tr valign="top" align="left">
528 <td width="10%"></td>
529 <td width="89%">
530 <p><b>&minus;h</b>, <b>&minus;&minus;help</b></p></td>
531 </table>
532 <!-- INDENTATION -->
533 <table width="100%" border=0 rules="none" frame="void"
534 cols="2" cellspacing="0" cellpadding="0">
535 <tr valign="top" align="left">
536 <td width="21%"></td>
537 <td width="77%">
538 <p>display this help and exit</p>
539 </td>
540 </table>
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><b>&minus;V</b>, <b>&minus;&minus;version</b></p></td>
548 </table>
549 <!-- INDENTATION -->
550 <table width="100%" border=0 rules="none" frame="void"
551 cols="2" cellspacing="0" cellpadding="0">
552 <tr valign="top" align="left">
553 <td width="21%"></td>
554 <td width="77%">
555 <p>output version information and exit</p>
556 </td>
557 </table>
558 <a name="AUTHOR"></a>
559 <h2>AUTHOR</h2>
560 <!-- INDENTATION -->
561 <table width="100%" border=0 rules="none" frame="void"
562 cols="2" cellspacing="0" cellpadding="0">
563 <tr valign="top" align="left">
564 <td width="10%"></td>
565 <td width="89%">
566 <p>Written by Bruno Haible.</p>
567 </td>
568 </table>
569 <a name="REPORTING BUGS"></a>
570 <h2>REPORTING BUGS</h2>
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>Report bugs to &lt;bug-gnu-gettext@gnu.org&gt;.</p>
578 </td>
579 </table>
580 <a name="COPYRIGHT"></a>
581 <h2>COPYRIGHT</h2>
582 <!-- INDENTATION -->
583 <table width="100%" border=0 rules="none" frame="void"
584 cols="2" cellspacing="0" cellpadding="0">
585 <tr valign="top" align="left">
586 <td width="10%"></td>
587 <td width="89%">
588 <p>Copyright &copy; 2001-2010 Free Software Foundation, Inc.
589 License GPLv3+: GNU GPL version 3 or later
590 &lt;http://gnu.org/licenses/gpl.html&gt;<br>
591 This is free software: you are free to change and
592 redistribute it. There is NO WARRANTY, to the extent
593 permitted by law.</p>
594 </td>
595 </table>
596 <a name="SEE ALSO"></a>
597 <h2>SEE ALSO</h2>
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="10%"></td>
603 <td width="89%">
604 <p>The full documentation for <b>msgconv</b> is maintained
605 as a Texinfo manual. If the <b>info</b> and <b>msgconv</b>
606 programs are properly installed at your site, the
607 command</p>
608 </td>
609 </table>
610 <!-- INDENTATION -->
611 <table width="100%" border=0 rules="none" frame="void"
612 cols="2" cellspacing="0" cellpadding="0">
613 <tr valign="top" align="left">
614 <td width="20%"></td>
615 <td width="79%">
616 <p><b>info msgconv</b></p>
617 </td>
618 </table>
619 <!-- INDENTATION -->
620 <table width="100%" border=0 rules="none" frame="void"
621 cols="2" cellspacing="0" cellpadding="0">
622 <tr valign="top" align="left">
623 <td width="10%"></td>
624 <td width="89%">
625 <p>should give you access to the complete manual.</p>
626 </td>
627 </table>
628 <hr>
629 </body>
630 </html>