| .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.24. |
| .TH MSGCAT "1" "June 2010" "GNU gettext-tools 0.18.1" GNU |
| .SH NAME |
| msgcat \- combines several message catalogs |
| .SH SYNOPSIS |
| .B msgcat |
| [\fIOPTION\fR] [\fIINPUTFILE\fR]... |
| .SH DESCRIPTION |
| .\" Add any additional description here |
| .PP |
| Concatenates and merges the specified PO files. |
| Find messages which are common to two or more of the specified PO files. |
| By using the \fB\-\-more\-than\fR option, greater commonality may be requested |
| before messages are printed. Conversely, the \fB\-\-less\-than\fR option may be |
| used to specify less commonality before messages are printed (i.e. |
| \fB\-\-less\-than\fR=\fI2\fR will only print the unique messages). Translations, |
| comments and extract comments will be cumulated, except that if \fB\-\-use\-first\fR |
| is specified, they will be taken from the first PO file to define them. |
| File positions from all PO files will be cumulated. |
| .PP |
| Mandatory arguments to long options are mandatory for short options too. |
| .SS "Input file location:" |
| .TP |
| INPUTFILE ... |
| input files |
| .TP |
| \fB\-f\fR, \fB\-\-files\-from\fR=\fIFILE\fR |
| get list of input files from FILE |
| .TP |
| \fB\-D\fR, \fB\-\-directory\fR=\fIDIRECTORY\fR |
| add DIRECTORY to list for input files search |
| .PP |
| If input file is -, standard input is read. |
| .SS "Output file location:" |
| .TP |
| \fB\-o\fR, \fB\-\-output\-file\fR=\fIFILE\fR |
| write output to specified file |
| .PP |
| The results are written to standard output if no output file is specified |
| or if it is -. |
| .SS "Message selection:" |
| .TP |
| -<, \fB\-\-less\-than\fR=\fINUMBER\fR |
| print messages with less than this many |
| definitions, defaults to infinite if not set |
| .TP |
| ->, \fB\-\-more\-than\fR=\fINUMBER\fR |
| print messages with more than this many |
| definitions, defaults to 0 if not set |
| .TP |
| \fB\-u\fR, \fB\-\-unique\fR |
| shorthand for \fB\-\-less\-than\fR=\fI2\fR, requests |
| that only unique messages be printed |
| .SS "Input file syntax:" |
| .TP |
| \fB\-P\fR, \fB\-\-properties\-input\fR |
| input files are in Java .properties syntax |
| .TP |
| \fB\-\-stringtable\-input\fR |
| input files are in NeXTstep/GNUstep .strings |
| syntax |
| .SS "Output details:" |
| .TP |
| \fB\-t\fR, \fB\-\-to\-code\fR=\fINAME\fR |
| encoding for output |
| .TP |
| \fB\-\-use\-first\fR |
| use first available translation for each |
| message, don't merge several translations |
| .TP |
| \fB\-\-lang\fR=\fICATALOGNAME\fR |
| set 'Language' field in the header entry |
| .TP |
| \fB\-\-color\fR |
| use colors and other text attributes always |
| .TP |
| \fB\-\-color\fR=\fIWHEN\fR |
| use colors and other text attributes if WHEN. |
| WHEN may be 'always', 'never', 'auto', or 'html'. |
| .TP |
| \fB\-\-style\fR=\fISTYLEFILE\fR |
| specify CSS style rule file for \fB\-\-color\fR |
| .TP |
| \fB\-e\fR, \fB\-\-no\-escape\fR |
| do not use C escapes in output (default) |
| .TP |
| \fB\-E\fR, \fB\-\-escape\fR |
| use C escapes in output, no extended chars |
| .TP |
| \fB\-\-force\-po\fR |
| write PO file even if empty |
| .TP |
| \fB\-i\fR, \fB\-\-indent\fR |
| write the .po file using indented style |
| .TP |
| \fB\-\-no\-location\fR |
| do not write '#: filename:line' lines |
| .TP |
| \fB\-n\fR, \fB\-\-add\-location\fR |
| generate '#: filename:line' lines (default) |
| .TP |
| \fB\-\-strict\fR |
| write out strict Uniforum conforming .po file |
| .TP |
| \fB\-p\fR, \fB\-\-properties\-output\fR |
| write out a Java .properties file |
| .TP |
| \fB\-\-stringtable\-output\fR |
| write out a NeXTstep/GNUstep .strings file |
| .TP |
| \fB\-w\fR, \fB\-\-width\fR=\fINUMBER\fR |
| set output page width |
| .TP |
| \fB\-\-no\-wrap\fR |
| do not break long message lines, longer than |
| the output page width, into several lines |
| .TP |
| \fB\-s\fR, \fB\-\-sort\-output\fR |
| generate sorted output |
| .TP |
| \fB\-F\fR, \fB\-\-sort\-by\-file\fR |
| sort output by file location |
| .SS "Informative output:" |
| .TP |
| \fB\-h\fR, \fB\-\-help\fR |
| display this help and exit |
| .TP |
| \fB\-V\fR, \fB\-\-version\fR |
| output version information and exit |
| .SH AUTHOR |
| Written by Bruno Haible. |
| .SH "REPORTING BUGS" |
| Report bugs to <bug-gnu-gettext@gnu.org>. |
| .SH COPYRIGHT |
| Copyright \(co 2001-2010 Free Software Foundation, Inc. |
| License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> |
| .br |
| This is free software: you are free to change and redistribute it. |
| There is NO WARRANTY, to the extent permitted by law. |
| .SH "SEE ALSO" |
| The full documentation for |
| .B msgcat |
| is maintained as a Texinfo manual. If the |
| .B info |
| and |
| .B msgcat |
| programs are properly installed at your site, the command |
| .IP |
| .B info msgcat |
| .PP |
| should give you access to the complete manual. |
