gettext-tools/man/msgcat.1.html

   1 <!-- Creator     : groff version 1.22.3 -->
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
   3 "http://www.w3.org/TR/html4/loose.dtd">
   4 <html>
   5 <head>
   6 <meta name="generator" content="groff -Thtml, see www.gnu.org">
   7 <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
   8 <meta name="Content-Style" content="text/css">
   9 <style type="text/css">
  10        p       { margin-top: 0; margin-bottom: 0; vertical-align: top }
  11        pre     { margin-top: 0; margin-bottom: 0; vertical-align: top }
  12        table   { margin-top: 0; margin-bottom: 0; vertical-align: top }
  13        h1      { text-align: center }
  14 </style>
  15 <title>MSGCAT</title>
  16
  17 </head>
  18 <body>
  19
  20 <h1 align="center">MSGCAT</h1>
  21
  22 <a href="#NAME">NAME</a><br>
  23 <a href="#SYNOPSIS">SYNOPSIS</a><br>
  24 <a href="#DESCRIPTION">DESCRIPTION</a><br>
  25 <a href="#AUTHOR">AUTHOR</a><br>
  26 <a href="#REPORTING BUGS">REPORTING BUGS</a><br>
  27 <a href="#COPYRIGHT">COPYRIGHT</a><br>
  28 <a href="#SEE ALSO">SEE ALSO</a><br>
  29
  30 <hr>
  31
  32
  33 <h2>NAME
  34 <a name="NAME"></a>
  35 </h2>
  36
  37
  38 <p style="margin-left:11%; margin-top: 1em">msgcat &minus;
  39 combines several message catalogs</p>
  40
  41 <h2>SYNOPSIS
  42 <a name="SYNOPSIS"></a>
  43 </h2>
  44
  45
  46 <p style="margin-left:11%; margin-top: 1em"><b>msgcat</b>
  47 [<i>OPTION</i>] [<i>INPUTFILE</i>]...</p>
  48
  49 <h2>DESCRIPTION
  50 <a name="DESCRIPTION"></a>
  51 </h2>
  52
  53
  54 <p style="margin-left:11%; margin-top: 1em">Concatenates
  55 and merges the specified PO files. Find messages which are
  56 common to two or more of the specified PO files. By using
  57 the <b>&minus;&minus;more&minus;than</b> option, greater
  58 commonality may be requested before messages are printed.
  59 Conversely, the <b>&minus;&minus;less&minus;than</b> option
  60 may be used to specify less commonality before messages are
  61 printed (i.e. <b>&minus;&minus;less&minus;than</b>=<i>2</i>
  62 will only print the unique messages). Translations,
  63 comments, extracted comments, and file positions will be
  64 cumulated, except that if
  65 <b>&minus;&minus;use&minus;first</b> is specified, they will
  66 be taken from the first PO file to define them.</p>
  67
  68 <p style="margin-left:11%; margin-top: 1em">Mandatory
  69 arguments to long options are mandatory for short options
  70 too.</p>
  71
  72 <p style="margin-left:11%; margin-top: 1em"><b>Input file
  73 location:</b> <br>
  74 INPUTFILE ...</p>
  75
  76 <p style="margin-left:22%;">input files</p>
  77
  78 <p style="margin-left:11%;"><b>&minus;f</b>,
  79 <b>&minus;&minus;files&minus;from</b>=<i>FILE</i></p>
  80
  81 <p style="margin-left:22%;">get list of input files from
  82 FILE</p>
  83
  84 <p style="margin-left:11%;"><b>&minus;D</b>,
  85 <b>&minus;&minus;directory</b>=<i>DIRECTORY</i></p>
  86
  87 <p style="margin-left:22%;">add DIRECTORY to list for input
  88 files search</p>
  89
  90 <p style="margin-left:11%; margin-top: 1em">If input file
  91 is -, standard input is read.</p>
  92
  93 <p style="margin-left:11%; margin-top: 1em"><b>Output file
  94 location: <br>
  95 &minus;o</b>,
  96 <b>&minus;&minus;output&minus;file</b>=<i>FILE</i></p>
  97
  98 <p style="margin-left:22%;">write output to specified
  99 file</p>
 100
 101 <p style="margin-left:11%; margin-top: 1em">The results are
 102 written to standard output if no output file is specified or
 103 if it is -.</p>
 104
 105 <p style="margin-left:11%; margin-top: 1em"><b>Message
 106 selection:</b> <br>
 107 -&lt;,
 108 <b>&minus;&minus;less&minus;than</b>=<i>NUMBER</i></p>
 109
 110 <p style="margin-left:22%;">print messages with less than
 111 this many definitions, defaults to infinite if not set</p>
 112
 113 <p style="margin-left:11%;">-&gt;,
 114 <b>&minus;&minus;more&minus;than</b>=<i>NUMBER</i></p>
 115
 116 <p style="margin-left:22%;">print messages with more than
 117 this many definitions, defaults to 0 if not set</p>
 118
 119 <p style="margin-left:11%;"><b>&minus;u</b>,
 120 <b>&minus;&minus;unique</b></p>
 121
 122 <p style="margin-left:22%;">shorthand for
 123 <b>&minus;&minus;less&minus;than</b>=<i>2</i>, requests that
 124 only unique messages be printed</p>
 125
 126 <p style="margin-left:11%; margin-top: 1em"><b>Input file
 127 syntax: <br>
 128 &minus;P</b>,
 129 <b>&minus;&minus;properties&minus;input</b></p>
 130
 131 <p style="margin-left:22%;">input files are in Java
 132 .properties syntax</p>
 133
 134
 135 <p style="margin-left:11%;"><b>&minus;&minus;stringtable&minus;input</b></p>
 136
 137 <p style="margin-left:22%;">input files are in
 138 NeXTstep/GNUstep .strings syntax</p>
 139
 140 <p style="margin-left:11%; margin-top: 1em"><b>Output
 141 details: <br>
 142 &minus;t</b>,
 143 <b>&minus;&minus;to&minus;code</b>=<i>NAME</i></p>
 144
 145 <p style="margin-left:22%;">encoding for output</p>
 146
 147
 148 <p style="margin-left:11%;"><b>&minus;&minus;use&minus;first</b></p>
 149
 150 <p style="margin-left:22%;">use first available translation
 151 for each message, don&rsquo;t merge several translations</p>
 152
 153
 154 <p style="margin-left:11%;"><b>&minus;&minus;lang</b>=<i>CATALOGNAME</i></p>
 155
 156 <p style="margin-left:22%;">set &rsquo;Language&rsquo;
 157 field in the header entry</p>
 158
 159 <p style="margin-left:11%;"><b>&minus;&minus;color</b></p>
 160
 161 <p style="margin-left:22%;">use colors and other text
 162 attributes always</p>
 163
 164
 165 <p style="margin-left:11%;"><b>&minus;&minus;color</b>=<i>WHEN</i></p>
 166
 167 <p style="margin-left:22%;">use colors and other text
 168 attributes if WHEN. WHEN may be &rsquo;always&rsquo;,
 169 &rsquo;never&rsquo;, &rsquo;auto&rsquo;, or
 170 &rsquo;html&rsquo;.</p>
 171
 172
 173 <p style="margin-left:11%;"><b>&minus;&minus;style</b>=<i>STYLEFILE</i></p>
 174
 175 <p style="margin-left:22%;">specify CSS style rule file for
 176 <b>&minus;&minus;color</b></p>
 177
 178 <p style="margin-left:11%;"><b>&minus;e</b>,
 179 <b>&minus;&minus;no&minus;escape</b></p>
 180
 181 <p style="margin-left:22%;">do not use C escapes in output
 182 (default)</p>
 183
 184 <p style="margin-left:11%;"><b>&minus;E</b>,
 185 <b>&minus;&minus;escape</b></p>
 186
 187 <p style="margin-left:22%;">use C escapes in output, no
 188 extended chars</p>
 189
 190
 191 <p style="margin-left:11%;"><b>&minus;&minus;force&minus;po</b></p>
 192
 193 <p style="margin-left:22%;">write PO file even if empty</p>
 194
 195 <p style="margin-left:11%;"><b>&minus;i</b>,
 196 <b>&minus;&minus;indent</b></p>
 197
 198 <p style="margin-left:22%;">write the .po file using
 199 indented style</p>
 200
 201
 202 <p style="margin-left:11%;"><b>&minus;&minus;no&minus;location</b></p>
 203
 204 <p style="margin-left:22%;">do not write &rsquo;#:
 205 filename:line&rsquo; lines</p>
 206
 207 <p style="margin-left:11%;"><b>&minus;n</b>,
 208 <b>&minus;&minus;add&minus;location</b></p>
 209
 210 <p style="margin-left:22%;">generate &rsquo;#:
 211 filename:line&rsquo; lines (default)</p>
 212
 213
 214 <p style="margin-left:11%;"><b>&minus;&minus;strict</b></p>
 215
 216 <p style="margin-left:22%;">write out strict Uniforum
 217 conforming .po file</p>
 218
 219 <p style="margin-left:11%;"><b>&minus;p</b>,
 220 <b>&minus;&minus;properties&minus;output</b></p>
 221
 222 <p style="margin-left:22%;">write out a Java .properties
 223 file</p>
 224
 225
 226 <p style="margin-left:11%;"><b>&minus;&minus;stringtable&minus;output</b></p>
 227
 228 <p style="margin-left:22%;">write out a NeXTstep/GNUstep
 229 .strings file</p>
 230
 231 <p style="margin-left:11%;"><b>&minus;w</b>,
 232 <b>&minus;&minus;width</b>=<i>NUMBER</i></p>
 233
 234 <p style="margin-left:22%;">set output page width</p>
 235
 236
 237 <p style="margin-left:11%;"><b>&minus;&minus;no&minus;wrap</b></p>
 238
 239 <p style="margin-left:22%;">do not break long message
 240 lines, longer than the output page width, into several
 241 lines</p>
 242
 243 <p style="margin-left:11%;"><b>&minus;s</b>,
 244 <b>&minus;&minus;sort&minus;output</b></p>
 245
 246 <p style="margin-left:22%;">generate sorted output</p>
 247
 248 <p style="margin-left:11%;"><b>&minus;F</b>,
 249 <b>&minus;&minus;sort&minus;by&minus;file</b></p>
 250
 251 <p style="margin-left:22%;">sort output by file
 252 location</p>
 253
 254 <p style="margin-left:11%; margin-top: 1em"><b>Informative
 255 output: <br>
 256 &minus;h</b>, <b>&minus;&minus;help</b></p>
 257
 258 <p style="margin-left:22%;">display this help and exit</p>
 259
 260 <p style="margin-left:11%;"><b>&minus;V</b>,
 261 <b>&minus;&minus;version</b></p>
 262
 263 <p style="margin-left:22%;">output version information and
 264 exit</p>
 265
 266 <h2>AUTHOR
 267 <a name="AUTHOR"></a>
 268 </h2>
 269
 270
 271 <p style="margin-left:11%; margin-top: 1em">Written by
 272 Bruno Haible.</p>
 273
 274 <h2>REPORTING BUGS
 275 <a name="REPORTING BUGS"></a>
 276 </h2>
 277
 278
 279 <p style="margin-left:11%; margin-top: 1em">Report bugs to
 280 &lt;bug-gnu-gettext@gnu.org&gt;.</p>
 281
 282 <h2>COPYRIGHT
 283 <a name="COPYRIGHT"></a>
 284 </h2>
 285
 286
 287 <p style="margin-left:11%; margin-top: 1em">Copyright
 288 &copy; 2001-2010 Free Software Foundation, Inc. License
 289 GPLv3+: GNU GPL version 3 or later
 290 &lt;http://gnu.org/licenses/gpl.html&gt; <br>
 291 This is free software: you are free to change and
 292 redistribute it. There is NO WARRANTY, to the extent
 293 permitted by law.</p>
 294
 295 <h2>SEE ALSO
 296 <a name="SEE ALSO"></a>
 297 </h2>
 298
 299
 300 <p style="margin-left:11%; margin-top: 1em">The full
 301 documentation for <b>msgcat</b> is maintained as a Texinfo
 302 manual. If the <b>info</b> and <b>msgcat</b> programs are
 303 properly installed at your site, the command</p>
 304
 305 <p style="margin-left:22%; margin-top: 1em"><b>info
 306 msgcat</b></p>
 307
 308 <p style="margin-left:11%; margin-top: 1em">should give you
 309 access to the complete manual.</p>
 310 <hr>
 311 </body>
 312 </html>