mingw/share/man/man1/msgcat.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.24.
   2 .TH MSGCAT "1" "June 2010" "GNU gettext-tools 0.18.1" GNU
   3 .SH NAME
   4 msgcat \- combines several message catalogs
   5 .SH SYNOPSIS
   6 .B msgcat
   7 [\fIOPTION\fR] [\fIINPUTFILE\fR]...
   8 .SH DESCRIPTION
   9 .\" Add any additional description here
  10 .PP
  11 Concatenates and merges the specified PO files.
  12 Find messages which are common to two or more of the specified PO files.
  13 By using the \fB\-\-more\-than\fR option, greater commonality may be requested
  14 before messages are printed.  Conversely, the \fB\-\-less\-than\fR option may be
  15 used to specify less commonality before messages are printed (i.e.
  16 \fB\-\-less\-than\fR=\fI2\fR will only print the unique messages).  Translations,
  17 comments and extract comments will be cumulated, except that if \fB\-\-use\-first\fR
  18 is specified, they will be taken from the first PO file to define them.
  19 File positions from all PO files will be cumulated.
  20 .PP
  21 Mandatory arguments to long options are mandatory for short options too.
  22 .SS "Input file location:"
  23 .TP
  24 INPUTFILE ...
  25 input files
  26 .TP
  27 \fB\-f\fR, \fB\-\-files\-from\fR=\fIFILE\fR
  28 get list of input files from FILE
  29 .TP
  30 \fB\-D\fR, \fB\-\-directory\fR=\fIDIRECTORY\fR
  31 add DIRECTORY to list for input files search
  32 .PP
  33 If input file is -, standard input is read.
  34 .SS "Output file location:"
  35 .TP
  36 \fB\-o\fR, \fB\-\-output\-file\fR=\fIFILE\fR
  37 write output to specified file
  38 .PP
  39 The results are written to standard output if no output file is specified
  40 or if it is -.
  41 .SS "Message selection:"
  42 .TP
  43 -<, \fB\-\-less\-than\fR=\fINUMBER\fR
  44 print messages with less than this many
  45 definitions, defaults to infinite if not set
  46 .TP
  47 ->, \fB\-\-more\-than\fR=\fINUMBER\fR
  48 print messages with more than this many
  49 definitions, defaults to 0 if not set
  50 .TP
  51 \fB\-u\fR, \fB\-\-unique\fR
  52 shorthand for \fB\-\-less\-than\fR=\fI2\fR, requests
  53 that only unique messages be printed
  54 .SS "Input file syntax:"
  55 .TP
  56 \fB\-P\fR, \fB\-\-properties\-input\fR
  57 input files are in Java .properties syntax
  58 .TP
  59 \fB\-\-stringtable\-input\fR
  60 input files are in NeXTstep/GNUstep .strings
  61 syntax
  62 .SS "Output details:"
  63 .TP
  64 \fB\-t\fR, \fB\-\-to\-code\fR=\fINAME\fR
  65 encoding for output
  66 .TP
  67 \fB\-\-use\-first\fR
  68 use first available translation for each
  69 message, don't merge several translations
  70 .TP
  71 \fB\-\-lang\fR=\fICATALOGNAME\fR
  72 set 'Language' field in the header entry
  73 .TP
  74 \fB\-\-color\fR
  75 use colors and other text attributes always
  76 .TP
  77 \fB\-\-color\fR=\fIWHEN\fR
  78 use colors and other text attributes if WHEN.
  79 WHEN may be 'always', 'never', 'auto', or 'html'.
  80 .TP
  81 \fB\-\-style\fR=\fISTYLEFILE\fR
  82 specify CSS style rule file for \fB\-\-color\fR
  83 .TP
  84 \fB\-e\fR, \fB\-\-no\-escape\fR
  85 do not use C escapes in output (default)
  86 .TP
  87 \fB\-E\fR, \fB\-\-escape\fR
  88 use C escapes in output, no extended chars
  89 .TP
  90 \fB\-\-force\-po\fR
  91 write PO file even if empty
  92 .TP
  93 \fB\-i\fR, \fB\-\-indent\fR
  94 write the .po file using indented style
  95 .TP
  96 \fB\-\-no\-location\fR
  97 do not write '#: filename:line' lines
  98 .TP
  99 \fB\-n\fR, \fB\-\-add\-location\fR
 100 generate '#: filename:line' lines (default)
 101 .TP
 102 \fB\-\-strict\fR
 103 write out strict Uniforum conforming .po file
 104 .TP
 105 \fB\-p\fR, \fB\-\-properties\-output\fR
 106 write out a Java .properties file
 107 .TP
 108 \fB\-\-stringtable\-output\fR
 109 write out a NeXTstep/GNUstep .strings file
 110 .TP
 111 \fB\-w\fR, \fB\-\-width\fR=\fINUMBER\fR
 112 set output page width
 113 .TP
 114 \fB\-\-no\-wrap\fR
 115 do not break long message lines, longer than
 116 the output page width, into several lines
 117 .TP
 118 \fB\-s\fR, \fB\-\-sort\-output\fR
 119 generate sorted output
 120 .TP
 121 \fB\-F\fR, \fB\-\-sort\-by\-file\fR
 122 sort output by file location
 123 .SS "Informative output:"
 124 .TP
 125 \fB\-h\fR, \fB\-\-help\fR
 126 display this help and exit
 127 .TP
 128 \fB\-V\fR, \fB\-\-version\fR
 129 output version information and exit
 130 .SH AUTHOR
 131 Written by Bruno Haible.
 132 .SH "REPORTING BUGS"
 133 Report bugs to <bug-gnu-gettext@gnu.org>.
 134 .SH COPYRIGHT
 135 Copyright \(co 2001-2010 Free Software Foundation, Inc.
 136 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
 137 .br
 138 This is free software: you are free to change and redistribute it.
 139 There is NO WARRANTY, to the extent permitted by law.
 140 .SH "SEE ALSO"
 141 The full documentation for
 142 .B msgcat
 143 is maintained as a Texinfo manual.  If the
 144 .B info
 145 and
 146 .B msgcat
 147 programs are properly installed at your site, the command
 148 .IP
 149 .B info msgcat
 150 .PP
 151 should give you access to the complete manual.