1<html>
2<head>
3<meta name="generator" content="groff -Thtml, see www.gnu.org">
4<meta name="Content-Style" content="text/css">
5<title>MSGCAT</title>
6</head>
7<body>
8
9<h1 align=center>MSGCAT</h1>
10<a href="#NAME">NAME</a><br>
11<a href="#SYNOPSIS">SYNOPSIS</a><br>
12<a href="#DESCRIPTION">DESCRIPTION</a><br>
13<a href="#AUTHOR">AUTHOR</a><br>
14<a href="#REPORTING BUGS">REPORTING BUGS</a><br>
15<a href="#COPYRIGHT">COPYRIGHT</a><br>
16<a href="#SEE ALSO">SEE ALSO</a><br>
17
18<hr>
19<!-- Creator     : groff version 1.17.2 -->
20<a name="NAME"></a>
21<h2>NAME</h2>
22<table width="100%" border=0 rules="none" frame="void"
23       cols="2" cellspacing="0" cellpadding="0">
24<tr valign="top" align="left">
25<td width="10%"></td><td width="90%">
26msgcat - combines several message catalogs</td></table>
27<a name="SYNOPSIS"></a>
28<h2>SYNOPSIS</h2>
29
30<table width="100%" border=0 rules="none" frame="void"
31       cols="2" cellspacing="0" cellpadding="0">
32<tr valign="top" align="left">
33<td width="10%"></td><td width="90%">
34<b>msgcat</b> [<i>OPTION</i>]
35[<i>INPUTFILE</i>]...</td></table>
36<a name="DESCRIPTION"></a>
37<h2>DESCRIPTION</h2>
38
39<table width="100%" border=0 rules="none" frame="void"
40       cols="2" cellspacing="0" cellpadding="0">
41<tr valign="top" align="left">
42<td width="10%"></td><td width="90%">
43Concatenates and merges the specified PO files. Find
44messages which are common to two or more of the specified PO
45files. By using the <b>--more-than</b> option, greater
46commonality may be requested before messages are printed.
47Conversely, the <b>--less-than</b> option may be used to
48specify less commonality before messages are printed (i.e.
49<b>--less-than</b>=<i>2</i> will only print the unique
50messages). Translations, comments and extract comments will
51be cumulated, except that if <b>--use-first</b> is
52specified, they will be taken from the first PO file to
53define them. File positions from all PO files will be
54cumulated.</td></table>
55
56<table width="100%" border=0 rules="none" frame="void"
57       cols="2" cellspacing="0" cellpadding="0">
58<tr valign="top" align="left">
59<td width="10%"></td><td width="90%">
60Mandatory arguments to long options are mandatory for short
61options too.</td></table>
62
63<table width="100%" border=0 rules="none" frame="void"
64       cols="2" cellspacing="0" cellpadding="0">
65<tr valign="top" align="left">
66<td width="4%"></td><td width="96%">
67<b>Input file location:</b></td></table>
68
69<table width="100%" border=0 rules="none" frame="void"
70       cols="2" cellspacing="0" cellpadding="0">
71<tr valign="top" align="left">
72<td width="10%"></td><td width="90%">
73INPUTFILE ...</td></table>
74
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><td width="79%">
79input files</td></table>
80
81<table width="100%" border=0 rules="none" frame="void"
82       cols="2" cellspacing="0" cellpadding="0">
83<tr valign="top" align="left">
84<td width="10%"></td><td width="90%">
85<b>-f</b>, <b>--files-from</b>=<i>FILE</i></td></table>
86
87<table width="100%" border=0 rules="none" frame="void"
88       cols="2" cellspacing="0" cellpadding="0">
89<tr valign="top" align="left">
90<td width="21%"></td><td width="79%">
91get list of input files from FILE</td></table>
92
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="10%"></td><td width="90%">
97<b>-D</b>, <b>--directory</b>=<i>DIRECTORY</i></td></table>
98
99<table width="100%" border=0 rules="none" frame="void"
100       cols="2" cellspacing="0" cellpadding="0">
101<tr valign="top" align="left">
102<td width="21%"></td><td width="79%">
103add DIRECTORY to list for input files search</td></table>
104
105<table width="100%" border=0 rules="none" frame="void"
106       cols="2" cellspacing="0" cellpadding="0">
107<tr valign="top" align="left">
108<td width="10%"></td><td width="90%">
109If input file is -, standard input is read.</td></table>
110
111<table width="100%" border=0 rules="none" frame="void"
112       cols="2" cellspacing="0" cellpadding="0">
113<tr valign="top" align="left">
114<td width="4%"></td><td width="96%">
115<b>Output file location:</b></td></table>
116
117<table width="100%" border=0 rules="none" frame="void"
118       cols="2" cellspacing="0" cellpadding="0">
119<tr valign="top" align="left">
120<td width="10%"></td><td width="90%">
121<b>-o</b>, <b>--output-file</b>=<i>FILE</i></td></table>
122
123<table width="100%" border=0 rules="none" frame="void"
124       cols="2" cellspacing="0" cellpadding="0">
125<tr valign="top" align="left">
126<td width="21%"></td><td width="79%">
127write output to specified file</td></table>
128
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="10%"></td><td width="90%">
133The results are written to standard output if no output file
134is specified or if it is -.</td></table>
135
136<table width="100%" border=0 rules="none" frame="void"
137       cols="2" cellspacing="0" cellpadding="0">
138<tr valign="top" align="left">
139<td width="4%"></td><td width="96%">
140<b>Message selection:</b></td></table>
141
142<table width="100%" border=0 rules="none" frame="void"
143       cols="2" cellspacing="0" cellpadding="0">
144<tr valign="top" align="left">
145<td width="10%"></td><td width="90%">
146-&lt;, <b>--less-than</b>=<i>NUMBER</i></td></table>
147
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="21%"></td><td width="79%">
152print messages with less than this many definitions,
153defaults to infinite if not set</td></table>
154
155<table width="100%" border=0 rules="none" frame="void"
156       cols="2" cellspacing="0" cellpadding="0">
157<tr valign="top" align="left">
158<td width="10%"></td><td width="90%">
159-&gt;, <b>--more-than</b>=<i>NUMBER</i></td></table>
160
161<table width="100%" border=0 rules="none" frame="void"
162       cols="2" cellspacing="0" cellpadding="0">
163<tr valign="top" align="left">
164<td width="21%"></td><td width="79%">
165print messages with more than this many definitions,
166defaults to 0 if not set</td></table>
167
168<table width="100%" border=0 rules="none" frame="void"
169       cols="2" cellspacing="0" cellpadding="0">
170<tr valign="top" align="left">
171<td width="10%"></td><td width="90%">
172<b>-u</b>, <b>--unique</b></td></table>
173
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="21%"></td><td width="79%">
178shorthand for <b>--less-than</b>=<i>2</i>, requests that
179only unique messages be printed</td></table>
180
181<table width="100%" border=0 rules="none" frame="void"
182       cols="2" cellspacing="0" cellpadding="0">
183<tr valign="top" align="left">
184<td width="4%"></td><td width="96%">
185<b>Input file syntax:</b></td></table>
186
187<table width="100%" border=0 rules="none" frame="void"
188       cols="2" cellspacing="0" cellpadding="0">
189<tr valign="top" align="left">
190<td width="10%"></td><td width="90%">
191<b>-P</b>, <b>--properties-input</b></td></table>
192
193<table width="100%" border=0 rules="none" frame="void"
194       cols="2" cellspacing="0" cellpadding="0">
195<tr valign="top" align="left">
196<td width="21%"></td><td width="79%">
197input files are in Java .properties syntax</td></table>
198
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><td width="90%">
203<b>--stringtable-input</b></td></table>
204
205<table width="100%" border=0 rules="none" frame="void"
206       cols="2" cellspacing="0" cellpadding="0">
207<tr valign="top" align="left">
208<td width="21%"></td><td width="79%">
209input files are in NeXTstep/GNUstep .strings
210syntax</td></table>
211
212<table width="100%" border=0 rules="none" frame="void"
213       cols="2" cellspacing="0" cellpadding="0">
214<tr valign="top" align="left">
215<td width="4%"></td><td width="96%">
216<b>Output details:</b></td></table>
217
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="10%"></td><td width="90%">
222<b>-t</b>, <b>--to-code</b>=<i>NAME</i></td></table>
223
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><td width="79%">
228encoding for output</td></table>
229
230<table width="100%" border=0 rules="none" frame="void"
231       cols="2" cellspacing="0" cellpadding="0">
232<tr valign="top" align="left">
233<td width="10%"></td><td width="90%">
234<b>--use-first</b></td></table>
235
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><td width="79%">
240use first available translation for each message, don't
241merge several translations</td></table>
242
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="10%"></td><td width="90%">
247<b>-e</b>, <b>--no-escape</b></td></table>
248
249<table width="100%" border=0 rules="none" frame="void"
250       cols="2" cellspacing="0" cellpadding="0">
251<tr valign="top" align="left">
252<td width="21%"></td><td width="79%">
253do not use C escapes in output (default)</td></table>
254
255<table width="100%" border=0 rules="none" frame="void"
256       cols="2" cellspacing="0" cellpadding="0">
257<tr valign="top" align="left">
258<td width="10%"></td><td width="90%">
259<b>-E</b>, <b>--escape</b></td></table>
260
261<table width="100%" border=0 rules="none" frame="void"
262       cols="2" cellspacing="0" cellpadding="0">
263<tr valign="top" align="left">
264<td width="21%"></td><td width="79%">
265use C escapes in output, no extended chars</td></table>
266
267<table width="100%" border=0 rules="none" frame="void"
268       cols="2" cellspacing="0" cellpadding="0">
269<tr valign="top" align="left">
270<td width="10%"></td><td width="90%">
271<b>--force-po</b></td></table>
272
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><td width="79%">
277write PO file even if empty</td></table>
278
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="10%"></td><td width="90%">
283<b>-i</b>, <b>--indent</b></td></table>
284
285<table width="100%" border=0 rules="none" frame="void"
286       cols="2" cellspacing="0" cellpadding="0">
287<tr valign="top" align="left">
288<td width="21%"></td><td width="79%">
289write the .po file using indented style</td></table>
290
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><td width="90%">
295<b>--no-location</b></td></table>
296
297<table width="100%" border=0 rules="none" frame="void"
298       cols="2" cellspacing="0" cellpadding="0">
299<tr valign="top" align="left">
300<td width="21%"></td><td width="79%">
301do not write '#: filename:line' lines</td></table>
302
303<table width="100%" border=0 rules="none" frame="void"
304       cols="2" cellspacing="0" cellpadding="0">
305<tr valign="top" align="left">
306<td width="10%"></td><td width="90%">
307<b>-n</b>, <b>--add-location</b></td></table>
308
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="21%"></td><td width="79%">
313generate '#: filename:line' lines (default)</td></table>
314
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="10%"></td><td width="90%">
319<b>--strict</b></td></table>
320
321<table width="100%" border=0 rules="none" frame="void"
322       cols="2" cellspacing="0" cellpadding="0">
323<tr valign="top" align="left">
324<td width="21%"></td><td width="79%">
325write out strict Uniforum conforming .po file</td></table>
326
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><td width="90%">
331<b>-p</b>, <b>--properties-output</b></td></table>
332
333<table width="100%" border=0 rules="none" frame="void"
334       cols="2" cellspacing="0" cellpadding="0">
335<tr valign="top" align="left">
336<td width="21%"></td><td width="79%">
337write out a Java .properties file</td></table>
338
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><td width="90%">
343<b>--stringtable-output</b></td></table>
344
345<table width="100%" border=0 rules="none" frame="void"
346       cols="2" cellspacing="0" cellpadding="0">
347<tr valign="top" align="left">
348<td width="21%"></td><td width="79%">
349write out a NeXTstep/GNUstep .strings file</td></table>
350
351<table width="100%" border=0 rules="none" frame="void"
352       cols="2" cellspacing="0" cellpadding="0">
353<tr valign="top" align="left">
354<td width="10%"></td><td width="90%">
355<b>-w</b>, <b>--width</b>=<i>NUMBER</i></td></table>
356
357<table width="100%" border=0 rules="none" frame="void"
358       cols="2" cellspacing="0" cellpadding="0">
359<tr valign="top" align="left">
360<td width="21%"></td><td width="79%">
361set output page width</td></table>
362
363<table width="100%" border=0 rules="none" frame="void"
364       cols="2" cellspacing="0" cellpadding="0">
365<tr valign="top" align="left">
366<td width="10%"></td><td width="90%">
367<b>--no-wrap</b></td></table>
368
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><td width="79%">
373do not break long message lines, longer than the output page
374width, into several lines</td></table>
375
376<table width="100%" border=0 rules="none" frame="void"
377       cols="2" cellspacing="0" cellpadding="0">
378<tr valign="top" align="left">
379<td width="10%"></td><td width="90%">
380<b>-s</b>, <b>--sort-output</b></td></table>
381
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><td width="79%">
386generate sorted output</td></table>
387
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="10%"></td><td width="90%">
392<b>-F</b>, <b>--sort-by-file</b></td></table>
393
394<table width="100%" border=0 rules="none" frame="void"
395       cols="2" cellspacing="0" cellpadding="0">
396<tr valign="top" align="left">
397<td width="21%"></td><td width="79%">
398sort output by file location</td></table>
399
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="4%"></td><td width="96%">
404<b>Informative output:</b></td></table>
405
406<table width="100%" border=0 rules="none" frame="void"
407       cols="2" cellspacing="0" cellpadding="0">
408<tr valign="top" align="left">
409<td width="10%"></td><td width="90%">
410<b>-h</b>, <b>--help</b></td></table>
411
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><td width="79%">
416display this help and exit</td></table>
417
418<table width="100%" border=0 rules="none" frame="void"
419       cols="2" cellspacing="0" cellpadding="0">
420<tr valign="top" align="left">
421<td width="10%"></td><td width="90%">
422<b>-V</b>, <b>--version</b></td></table>
423
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><td width="79%">
428output version information and exit</td></table>
429<a name="AUTHOR"></a>
430<h2>AUTHOR</h2>
431
432<table width="100%" border=0 rules="none" frame="void"
433       cols="2" cellspacing="0" cellpadding="0">
434<tr valign="top" align="left">
435<td width="10%"></td><td width="90%">
436Written by Bruno Haible.</td></table>
437<a name="REPORTING BUGS"></a>
438<h2>REPORTING BUGS</h2>
439
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><td width="90%">
444Report bugs to &lt;bug-gnu-gettext@gnu.org&gt;.</td></table>
445<a name="COPYRIGHT"></a>
446<h2>COPYRIGHT</h2>
447
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="10%"></td><td width="90%">
452Copyright 2001-2005 Free Software Foundation, Inc.<br>
453This is free software; see the source for copying
454conditions. There is NO warranty; not even for
455MERCHANTABILITY or FITNESS FOR A PARTICULAR
456PURPOSE.</td></table>
457<a name="SEE ALSO"></a>
458<h2>SEE ALSO</h2>
459
460<table width="100%" border=0 rules="none" frame="void"
461       cols="2" cellspacing="0" cellpadding="0">
462<tr valign="top" align="left">
463<td width="10%"></td><td width="90%">
464The full documentation for <b>msgcat</b> is maintained as a
465Texinfo manual. If the <b>info</b> and <b>msgcat</b>
466programs are properly installed at your site, the
467command</td></table>
468
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="21%"></td><td width="79%">
473<b>info msgcat</b></td></table>
474
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="10%"></td><td width="90%">
479should give you access to the complete manual.</td></table>
480<hr>
481</body>
482</html>
483