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

   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%">
  26 msgcat - 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%">
  43 Concatenates and merges the specified PO files. Find
  44 messages which are common to two or more of the specified PO
  45 files. By using the <b>--more-than</b> option, greater
  46 commonality may be requested before messages are printed.
  47 Conversely, the <b>--less-than</b> option may be used to
  48 specify less commonality before messages are printed (i.e.
  49 <b>--less-than</b>=<i>2</i> will only print the unique
  50 messages). Translations, comments and extract comments will
  51 be cumulated, except that if <b>--use-first</b> is
  52 specified, they will be taken from the first PO file to
  53 define them. File positions from all PO files will be
  54 cumulated.</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%">
  60 Mandatory arguments to long options are mandatory for short
  61 options 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%">
  73 INPUTFILE ...</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%">
  79 input 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%">
  91 get 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%">
 103 add 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%">
 109 If 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%">
 127 write 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%">
 133 The results are written to standard output if no output file
 134 is 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%">
 152 print messages with less than this many definitions,
 153 defaults 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%">
 165 print messages with more than this many definitions,
 166 defaults 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%">
 178 shorthand for <b>--less-than</b>=<i>2</i>, requests that
 179 only 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%">
 197 input 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%">
 209 input files are in NeXTstep/GNUstep .strings
 210 syntax</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%">
 228 encoding 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%">
 240 use first available translation for each message, don't
 241 merge 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%">
 253 do 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%">
 265 use 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%">
 277 write 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%">
 289 write 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%">
 301 do 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%">
 313 generate '#: 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%">
 325 write 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%">
 337 write 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%">
 349 write 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%">
 361 set 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%">
 373 do not break long message lines, longer than the output page
 374 width, 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%">
 386 generate 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%">
 398 sort 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%">
 416 display 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%">
 428 output 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%">
 436 Written 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%">
 444 Report 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%">
 452 Copyright 2001-2005 Free Software Foundation, Inc.<br>
 453 This is free software; see the source for copying
 454 conditions. There is NO warranty; not even for
 455 MERCHANTABILITY or FITNESS FOR A PARTICULAR
 456 PURPOSE.</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%">
 464 The full documentation for <b>msgcat</b> is maintained as a
 465 Texinfo manual. If the <b>info</b> and <b>msgcat</b>
 466 programs are properly installed at your site, the
 467 command</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%">
 479 should give you access to the complete manual.</td></table>
 480 <hr>
 481 </body>
 482 </html>