1 <!-- Creator : groff version 1.18.1 -->
4 <meta name="generator" content="groff -Thtml, see www.gnu.org">
5 <meta name="Content-Style" content="text/css">
10 <h1 align=center>MSGCAT</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>
23 <table width="100%" border=0 rules="none" frame="void"
24 cols="2" cellspacing="0" cellpadding="0">
25 <tr valign="top" align="left">
28 <p>msgcat − combines several message catalogs</p>
31 <a name="SYNOPSIS"></a>
34 <table width="100%" border=0 rules="none" frame="void"
35 cols="2" cellspacing="0" cellpadding="0">
36 <tr valign="top" align="left">
39 <p><b>msgcat</b> [<i>OPTION</i>] [<i>INPUTFILE</i>]...</p>
42 <a name="DESCRIPTION"></a>
45 <table width="100%" border=0 rules="none" frame="void"
46 cols="2" cellspacing="0" cellpadding="0">
47 <tr valign="top" align="left">
50 <p>Concatenates and merges the specified PO files. Find
51 messages which are common to two or more of the specified PO
52 files. By using the <b>−−more−than</b>
53 option, greater commonality may be requested before messages
54 are printed. Conversely, the
55 <b>−−less−than</b> option may be used to
56 specify less commonality before messages are printed (i.e.
57 <b>−−less−than</b>=<i>2</i> will only
58 print the unique messages). Translations, comments and
59 extract comments will be cumulated, except that if
60 <b>−−use−first</b> is specified, they will
61 be taken from the first PO file to define them. File
62 positions from all PO files will be cumulated.</p>
64 <p>Mandatory arguments to long options are mandatory for
65 short options too.</p>
69 <table width="100%" border=0 rules="none" frame="void"
70 cols="2" cellspacing="0" cellpadding="0">
71 <tr valign="top" align="left">
74 <p><b>Input file location:</b></p></td>
77 <table width="100%" border=0 rules="none" frame="void"
78 cols="2" cellspacing="0" cellpadding="0">
79 <tr valign="top" align="left">
82 <p>INPUTFILE ...</p></td>
85 <table width="100%" border=0 rules="none" frame="void"
86 cols="2" cellspacing="0" cellpadding="0">
87 <tr valign="top" align="left">
94 <table width="100%" border=0 rules="none" frame="void"
95 cols="2" cellspacing="0" cellpadding="0">
96 <tr valign="top" align="left">
100 <b>−−files−from</b>=<i>FILE</i></p></td>
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="21%"></td>
108 <p>get list of input files from FILE</p>
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="10%"></td>
118 <b>−−directory</b>=<i>DIRECTORY</i></p></td>
121 <table width="100%" border=0 rules="none" frame="void"
122 cols="2" cellspacing="0" cellpadding="0">
123 <tr valign="top" align="left">
124 <td width="21%"></td>
126 <p>add DIRECTORY to list for input files search</p>
130 <table width="100%" border=0 rules="none" frame="void"
131 cols="2" cellspacing="0" cellpadding="0">
132 <tr valign="top" align="left">
133 <td width="10%"></td>
135 <p>If input file is -, standard input is read.</p>
139 <table width="100%" border=0 rules="none" frame="void"
140 cols="2" cellspacing="0" cellpadding="0">
141 <tr valign="top" align="left">
144 <p><b>Output file location:</b></p></td>
147 <table width="100%" border=0 rules="none" frame="void"
148 cols="2" cellspacing="0" cellpadding="0">
149 <tr valign="top" align="left">
150 <td width="10%"></td>
153 <b>−−output−file</b>=<i>FILE</i></p></td>
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="21%"></td>
161 <p>write output to specified file</p>
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="10%"></td>
170 <p>The results are written to standard output if no output
171 file is specified or if it is -.</p>
175 <table width="100%" border=0 rules="none" frame="void"
176 cols="2" cellspacing="0" cellpadding="0">
177 <tr valign="top" align="left">
180 <p><b>Message selection:</b></p></td>
183 <table width="100%" border=0 rules="none" frame="void"
184 cols="2" cellspacing="0" cellpadding="0">
185 <tr valign="top" align="left">
186 <td width="10%"></td>
189 <b>−−less−than</b>=<i>NUMBER</i></p></td>
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="21%"></td>
197 <p>print messages with less than this many definitions,
198 defaults to infinite if not set</p>
202 <table width="100%" border=0 rules="none" frame="void"
203 cols="2" cellspacing="0" cellpadding="0">
204 <tr valign="top" align="left">
205 <td width="10%"></td>
208 <b>−−more−than</b>=<i>NUMBER</i></p></td>
211 <table width="100%" border=0 rules="none" frame="void"
212 cols="2" cellspacing="0" cellpadding="0">
213 <tr valign="top" align="left">
214 <td width="21%"></td>
216 <p>print messages with more than this many definitions,
217 defaults to 0 if not set</p>
221 <table width="100%" border=0 rules="none" frame="void"
222 cols="2" cellspacing="0" cellpadding="0">
223 <tr valign="top" align="left">
224 <td width="10%"></td>
226 <p><b>−u</b>, <b>−−unique</b></p></td>
229 <table width="100%" border=0 rules="none" frame="void"
230 cols="2" cellspacing="0" cellpadding="0">
231 <tr valign="top" align="left">
232 <td width="21%"></td>
235 <b>−−less−than</b>=<i>2</i>, requests that
236 only unique messages be printed</p>
240 <table width="100%" border=0 rules="none" frame="void"
241 cols="2" cellspacing="0" cellpadding="0">
242 <tr valign="top" align="left">
245 <p><b>Input file syntax:</b></p></td>
248 <table width="100%" border=0 rules="none" frame="void"
249 cols="2" cellspacing="0" cellpadding="0">
250 <tr valign="top" align="left">
251 <td width="10%"></td>
254 <b>−−properties−input</b></p></td>
257 <table width="100%" border=0 rules="none" frame="void"
258 cols="2" cellspacing="0" cellpadding="0">
259 <tr valign="top" align="left">
260 <td width="21%"></td>
262 <p>input files are in Java .properties syntax</p>
266 <table width="100%" border=0 rules="none" frame="void"
267 cols="2" cellspacing="0" cellpadding="0">
268 <tr valign="top" align="left">
269 <td width="10%"></td>
271 <p><b>−−stringtable−input</b></p></td>
274 <table width="100%" border=0 rules="none" frame="void"
275 cols="2" cellspacing="0" cellpadding="0">
276 <tr valign="top" align="left">
277 <td width="21%"></td>
279 <p>input files are in NeXTstep/GNUstep .strings syntax</p>
283 <table width="100%" border=0 rules="none" frame="void"
284 cols="2" cellspacing="0" cellpadding="0">
285 <tr valign="top" align="left">
288 <p><b>Output details:</b></p></td>
291 <table width="100%" border=0 rules="none" frame="void"
292 cols="2" cellspacing="0" cellpadding="0">
293 <tr valign="top" align="left">
294 <td width="10%"></td>
297 <b>−−to−code</b>=<i>NAME</i></p></td>
300 <table width="100%" border=0 rules="none" frame="void"
301 cols="2" cellspacing="0" cellpadding="0">
302 <tr valign="top" align="left">
303 <td width="21%"></td>
305 <p>encoding for output</p>
309 <table width="100%" border=0 rules="none" frame="void"
310 cols="2" cellspacing="0" cellpadding="0">
311 <tr valign="top" align="left">
312 <td width="10%"></td>
314 <p><b>−−use−first</b></p></td>
317 <table width="100%" border=0 rules="none" frame="void"
318 cols="2" cellspacing="0" cellpadding="0">
319 <tr valign="top" align="left">
320 <td width="21%"></td>
322 <p>use first available translation for each message,
323 don’t merge several translations</p>
327 <table width="100%" border=0 rules="none" frame="void"
328 cols="2" cellspacing="0" cellpadding="0">
329 <tr valign="top" align="left">
330 <td width="10%"></td>
332 <p><b>−−lang</b>=<i>CATALOGNAME</i></p></td>
335 <table width="100%" border=0 rules="none" frame="void"
336 cols="2" cellspacing="0" cellpadding="0">
337 <tr valign="top" align="left">
338 <td width="21%"></td>
340 <p>set ’Language’ field in the header entry</p>
344 <table width="100%" border=0 rules="none" frame="void"
345 cols="2" cellspacing="0" cellpadding="0">
346 <tr valign="top" align="left">
347 <td width="10%"></td>
349 <p><b>−−color</b></p></td>
352 <table width="100%" border=0 rules="none" frame="void"
353 cols="2" cellspacing="0" cellpadding="0">
354 <tr valign="top" align="left">
355 <td width="21%"></td>
357 <p>use colors and other text attributes always</p>
361 <table width="100%" border=0 rules="none" frame="void"
362 cols="2" cellspacing="0" cellpadding="0">
363 <tr valign="top" align="left">
364 <td width="10%"></td>
366 <p><b>−−color</b>=<i>WHEN</i></p></td>
369 <table width="100%" border=0 rules="none" frame="void"
370 cols="2" cellspacing="0" cellpadding="0">
371 <tr valign="top" align="left">
372 <td width="21%"></td>
374 <p>use colors and other text attributes if WHEN. WHEN may be
375 ’always’, ’never’,
376 ’auto’, or ’html’.</p>
380 <table width="100%" border=0 rules="none" frame="void"
381 cols="2" cellspacing="0" cellpadding="0">
382 <tr valign="top" align="left">
383 <td width="10%"></td>
385 <p><b>−−style</b>=<i>STYLEFILE</i></p></td>
388 <table width="100%" border=0 rules="none" frame="void"
389 cols="2" cellspacing="0" cellpadding="0">
390 <tr valign="top" align="left">
391 <td width="21%"></td>
393 <p>specify CSS style rule file for
394 <b>−−color</b></p>
398 <table width="100%" border=0 rules="none" frame="void"
399 cols="2" cellspacing="0" cellpadding="0">
400 <tr valign="top" align="left">
401 <td width="10%"></td>
404 <b>−−no−escape</b></p></td>
407 <table width="100%" border=0 rules="none" frame="void"
408 cols="2" cellspacing="0" cellpadding="0">
409 <tr valign="top" align="left">
410 <td width="21%"></td>
412 <p>do not use C escapes in output (default)</p>
416 <table width="100%" border=0 rules="none" frame="void"
417 cols="2" cellspacing="0" cellpadding="0">
418 <tr valign="top" align="left">
419 <td width="10%"></td>
421 <p><b>−E</b>, <b>−−escape</b></p></td>
424 <table width="100%" border=0 rules="none" frame="void"
425 cols="2" cellspacing="0" cellpadding="0">
426 <tr valign="top" align="left">
427 <td width="21%"></td>
429 <p>use C escapes in output, no extended chars</p>
433 <table width="100%" border=0 rules="none" frame="void"
434 cols="2" cellspacing="0" cellpadding="0">
435 <tr valign="top" align="left">
436 <td width="10%"></td>
438 <p><b>−−force−po</b></p></td>
441 <table width="100%" border=0 rules="none" frame="void"
442 cols="2" cellspacing="0" cellpadding="0">
443 <tr valign="top" align="left">
444 <td width="21%"></td>
446 <p>write PO file even if empty</p>
450 <table width="100%" border=0 rules="none" frame="void"
451 cols="2" cellspacing="0" cellpadding="0">
452 <tr valign="top" align="left">
453 <td width="10%"></td>
455 <p><b>−i</b>, <b>−−indent</b></p></td>
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="21%"></td>
463 <p>write the .po file using indented style</p>
467 <table width="100%" border=0 rules="none" frame="void"
468 cols="2" cellspacing="0" cellpadding="0">
469 <tr valign="top" align="left">
470 <td width="10%"></td>
472 <p><b>−−no−location</b></p></td>
475 <table width="100%" border=0 rules="none" frame="void"
476 cols="2" cellspacing="0" cellpadding="0">
477 <tr valign="top" align="left">
478 <td width="21%"></td>
480 <p>do not write ’#: filename:line’ lines</p>
484 <table width="100%" border=0 rules="none" frame="void"
485 cols="2" cellspacing="0" cellpadding="0">
486 <tr valign="top" align="left">
487 <td width="10%"></td>
490 <b>−−add−location</b></p></td>
493 <table width="100%" border=0 rules="none" frame="void"
494 cols="2" cellspacing="0" cellpadding="0">
495 <tr valign="top" align="left">
496 <td width="21%"></td>
498 <p>generate ’#: filename:line’ lines
503 <table width="100%" border=0 rules="none" frame="void"
504 cols="2" cellspacing="0" cellpadding="0">
505 <tr valign="top" align="left">
506 <td width="10%"></td>
508 <p><b>−−strict</b></p></td>
511 <table width="100%" border=0 rules="none" frame="void"
512 cols="2" cellspacing="0" cellpadding="0">
513 <tr valign="top" align="left">
514 <td width="21%"></td>
516 <p>write out strict Uniforum conforming .po file</p>
520 <table width="100%" border=0 rules="none" frame="void"
521 cols="2" cellspacing="0" cellpadding="0">
522 <tr valign="top" align="left">
523 <td width="10%"></td>
526 <b>−−properties−output</b></p></td>
529 <table width="100%" border=0 rules="none" frame="void"
530 cols="2" cellspacing="0" cellpadding="0">
531 <tr valign="top" align="left">
532 <td width="21%"></td>
534 <p>write out a Java .properties file</p>
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="10%"></td>
543 <p><b>−−stringtable−output</b></p></td>
546 <table width="100%" border=0 rules="none" frame="void"
547 cols="2" cellspacing="0" cellpadding="0">
548 <tr valign="top" align="left">
549 <td width="21%"></td>
551 <p>write out a NeXTstep/GNUstep .strings file</p>
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>
561 <b>−−width</b>=<i>NUMBER</i></p></td>
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="21%"></td>
569 <p>set output page width</p>
573 <table width="100%" border=0 rules="none" frame="void"
574 cols="2" cellspacing="0" cellpadding="0">
575 <tr valign="top" align="left">
576 <td width="10%"></td>
578 <p><b>−−no−wrap</b></p></td>
581 <table width="100%" border=0 rules="none" frame="void"
582 cols="2" cellspacing="0" cellpadding="0">
583 <tr valign="top" align="left">
584 <td width="21%"></td>
586 <p>do not break long message lines, longer than the output
587 page width, into several lines</p>
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>
597 <b>−−sort−output</b></p></td>
600 <table width="100%" border=0 rules="none" frame="void"
601 cols="2" cellspacing="0" cellpadding="0">
602 <tr valign="top" align="left">
603 <td width="21%"></td>
605 <p>generate sorted output</p>
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>
615 <b>−−sort−by−file</b></p></td>
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>
623 <p>sort output by file location</p>
627 <table width="100%" border=0 rules="none" frame="void"
628 cols="2" cellspacing="0" cellpadding="0">
629 <tr valign="top" align="left">
632 <p><b>Informative output:</b></p></td>
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="10%"></td>
640 <p><b>−h</b>, <b>−−help</b></p></td>
643 <table width="100%" border=0 rules="none" frame="void"
644 cols="2" cellspacing="0" cellpadding="0">
645 <tr valign="top" align="left">
646 <td width="21%"></td>
648 <p>display this help and exit</p>
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="10%"></td>
657 <p><b>−V</b>, <b>−−version</b></p></td>
660 <table width="100%" border=0 rules="none" frame="void"
661 cols="2" cellspacing="0" cellpadding="0">
662 <tr valign="top" align="left">
663 <td width="21%"></td>
665 <p>output version information and exit</p>
668 <a name="AUTHOR"></a>
671 <table width="100%" border=0 rules="none" frame="void"
672 cols="2" cellspacing="0" cellpadding="0">
673 <tr valign="top" align="left">
674 <td width="10%"></td>
676 <p>Written by Bruno Haible.</p>
679 <a name="REPORTING BUGS"></a>
680 <h2>REPORTING BUGS</h2>
682 <table width="100%" border=0 rules="none" frame="void"
683 cols="2" cellspacing="0" cellpadding="0">
684 <tr valign="top" align="left">
685 <td width="10%"></td>
687 <p>Report bugs to <bug-gnu-gettext@gnu.org>.</p>
690 <a name="COPYRIGHT"></a>
693 <table width="100%" border=0 rules="none" frame="void"
694 cols="2" cellspacing="0" cellpadding="0">
695 <tr valign="top" align="left">
696 <td width="10%"></td>
698 <p>Copyright © 2001-2010 Free Software Foundation, Inc.
699 License GPLv3+: GNU GPL version 3 or later
700 <http://gnu.org/licenses/gpl.html><br>
701 This is free software: you are free to change and
702 redistribute it. There is NO WARRANTY, to the extent
703 permitted by law.</p>
706 <a name="SEE ALSO"></a>
709 <table width="100%" border=0 rules="none" frame="void"
710 cols="2" cellspacing="0" cellpadding="0">
711 <tr valign="top" align="left">
712 <td width="10%"></td>
714 <p>The full documentation for <b>msgcat</b> is maintained as
715 a Texinfo manual. If the <b>info</b> and <b>msgcat</b>
716 programs are properly installed at your site, the
721 <table width="100%" border=0 rules="none" frame="void"
722 cols="2" cellspacing="0" cellpadding="0">
723 <tr valign="top" align="left">
724 <td width="20%"></td>
726 <p><b>info msgcat</b></p>
730 <table width="100%" border=0 rules="none" frame="void"
731 cols="2" cellspacing="0" cellpadding="0">
732 <tr valign="top" align="left">
733 <td width="10%"></td>
735 <p>should give you access to the complete manual.</p>