gnu/dist/gettext/gettext-tools/man/msgcat.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.24.
   2 .TH MSGCAT "1" "April 2005" "GNU gettext-tools 0.14.4" 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\-e\fR, \fB\-\-no\-escape\fR
  72 do not use C escapes in output (default)
  73 .TP
  74 \fB\-E\fR, \fB\-\-escape\fR
  75 use C escapes in output, no extended chars
  76 .TP
  77 \fB\-\-force\-po\fR
  78 write PO file even if empty
  79 .TP
  80 \fB\-i\fR, \fB\-\-indent\fR
  81 write the .po file using indented style
  82 .TP
  83 \fB\-\-no\-location\fR
  84 do not write '#: filename:line' lines
  85 .TP
  86 \fB\-n\fR, \fB\-\-add\-location\fR
  87 generate '#: filename:line' lines (default)
  88 .TP
  89 \fB\-\-strict\fR
  90 write out strict Uniforum conforming .po file
  91 .TP
  92 \fB\-p\fR, \fB\-\-properties\-output\fR
  93 write out a Java .properties file
  94 .TP
  95 \fB\-\-stringtable\-output\fR
  96 write out a NeXTstep/GNUstep .strings file
  97 .TP
  98 \fB\-w\fR, \fB\-\-width\fR=\fINUMBER\fR
  99 set output page width
 100 .TP
 101 \fB\-\-no\-wrap\fR
 102 do not break long message lines, longer than
 103 the output page width, into several lines
 104 .TP
 105 \fB\-s\fR, \fB\-\-sort\-output\fR
 106 generate sorted output
 107 .TP
 108 \fB\-F\fR, \fB\-\-sort\-by\-file\fR
 109 sort output by file location
 110 .SS "Informative output:"
 111 .TP
 112 \fB\-h\fR, \fB\-\-help\fR
 113 display this help and exit
 114 .TP
 115 \fB\-V\fR, \fB\-\-version\fR
 116 output version information and exit
 117 .SH AUTHOR
 118 Written by Bruno Haible.
 119 .SH "REPORTING BUGS"
 120 Report bugs to <bug-gnu-gettext@gnu.org>.
 121 .SH COPYRIGHT
 122 Copyright \(co 2001-2005 Free Software Foundation, Inc.
 123 .br
 124 This is free software; see the source for copying conditions.  There is NO
 125 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 126 .SH "SEE ALSO"
 127 The full documentation for
 128 .B msgcat
 129 is maintained as a Texinfo manual.  If the
 130 .B info
 131 and
 132 .B msgcat
 133 programs are properly installed at your site, the command
 134 .IP
 135 .B info msgcat
 136 .PP
 137 should give you access to the complete manual.