gettext-tools/man/msgmerge.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>MSGMERGE</title>
  16
  17 </head>
  18 <body>
  19
  20 <h1 align="center">MSGMERGE</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">msgmerge
  39 &minus; merge message catalog and template</p>
  40
  41 <h2>SYNOPSIS
  42 <a name="SYNOPSIS"></a>
  43 </h2>
  44
  45
  46
  47 <p style="margin-left:11%; margin-top: 1em"><b>msgmerge</b>
  48 [<i>OPTION</i>] <i>def.po ref.pot</i></p>
  49
  50 <h2>DESCRIPTION
  51 <a name="DESCRIPTION"></a>
  52 </h2>
  53
  54
  55 <p style="margin-left:11%; margin-top: 1em">Merges two
  56 Uniforum style .po files together. The def.po file is an
  57 existing PO file with translations which will be taken over
  58 to the newly created file as long as they still match;
  59 comments will be preserved, but extracted comments and file
  60 positions will be discarded. The ref.pot file is the last
  61 created PO file with up-to-date source references but old
  62 translations, or a PO Template file (generally created by
  63 xgettext); any translations or comments in the file will be
  64 discarded, however dot comments and file positions will be
  65 preserved. Where an exact match cannot be found, fuzzy
  66 matching is used to produce better results.</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></p>
  74
  75 <table width="100%" border="0" rules="none" frame="void"
  76        cellspacing="0" cellpadding="0">
  77 <tr valign="top" align="left">
  78 <td width="11%"></td>
  79 <td width="9%">
  80
  81
  82 <p>def.po</p></td>
  83 <td width="2%"></td>
  84 <td width="56%">
  85
  86
  87 <p>translations referring to old sources</p></td>
  88 <td width="22%">
  89 </td></tr>
  90 </table>
  91
  92 <p style="margin-left:11%;">ref.pot</p>
  93
  94 <p style="margin-left:22%;">references to new sources</p>
  95
  96 <p style="margin-left:11%;"><b>&minus;D</b>,
  97 <b>&minus;&minus;directory</b>=<i>DIRECTORY</i></p>
  98
  99 <p style="margin-left:22%;">add DIRECTORY to list for input
 100 files search</p>
 101
 102 <p style="margin-left:11%;"><b>&minus;C</b>,
 103 <b>&minus;&minus;compendium</b>=<i>FILE</i></p>
 104
 105 <p style="margin-left:22%;">additional library of message
 106 translations, may be specified more than once</p>
 107
 108 <p style="margin-left:11%; margin-top: 1em"><b>Operation
 109 mode: <br>
 110 &minus;U</b>, <b>&minus;&minus;update</b></p>
 111
 112 <p style="margin-left:22%;">update def.po, do nothing if
 113 def.po already up to date</p>
 114
 115 <p style="margin-left:11%; margin-top: 1em"><b>Output file
 116 location: <br>
 117 &minus;o</b>,
 118 <b>&minus;&minus;output&minus;file</b>=<i>FILE</i></p>
 119
 120 <p style="margin-left:22%;">write output to specified
 121 file</p>
 122
 123 <p style="margin-left:11%; margin-top: 1em">The results are
 124 written to standard output if no output file is specified or
 125 if it is -.</p>
 126
 127 <p style="margin-left:11%; margin-top: 1em">Output file
 128 location in update mode: The result is written back to
 129 def.po. <b><br>
 130 &minus;&minus;backup</b>=<i>CONTROL</i></p>
 131
 132 <p style="margin-left:22%;">make a backup of def.po</p>
 133
 134
 135 <p style="margin-left:11%;"><b>&minus;&minus;suffix</b>=<i>SUFFIX</i></p>
 136
 137 <p style="margin-left:22%;">override the usual backup
 138 suffix</p>
 139
 140 <p style="margin-left:11%; margin-top: 1em">The version
 141 control method may be selected via the
 142 <b>&minus;&minus;backup</b> option or through the
 143 VERSION_CONTROL environment variable. Here are the values:
 144 <br>
 145 none, off</p>
 146
 147 <p style="margin-left:22%;">never make backups (even if
 148 <b>&minus;&minus;backup</b> is given)</p>
 149
 150 <p style="margin-left:11%;">numbered, t</p>
 151
 152 <p style="margin-left:22%;">make numbered backups</p>
 153
 154 <p style="margin-left:11%;">existing, nil</p>
 155
 156 <p style="margin-left:22%;">numbered if numbered backups
 157 exist, simple otherwise</p>
 158
 159 <p style="margin-left:11%;">simple, never</p>
 160
 161 <p style="margin-left:22%;">always make simple backups</p>
 162
 163 <p style="margin-left:11%; margin-top: 1em">The backup
 164 suffix is &rsquo;~&rsquo;, unless set with
 165 <b>&minus;&minus;suffix</b> or the SIMPLE_BACKUP_SUFFIX
 166 environment variable.</p>
 167
 168 <p style="margin-left:11%; margin-top: 1em"><b>Operation
 169 modifiers: <br>
 170 &minus;m</b>, <b>&minus;&minus;multi&minus;domain</b></p>
 171
 172 <p style="margin-left:22%;">apply ref.pot to each of the
 173 domains in def.po</p>
 174
 175 <p style="margin-left:11%;"><b>&minus;N</b>,
 176 <b>&minus;&minus;no&minus;fuzzy&minus;matching</b></p>
 177
 178 <p style="margin-left:22%;">do not use fuzzy matching</p>
 179
 180
 181 <p style="margin-left:11%;"><b>&minus;&minus;previous</b></p>
 182
 183 <p style="margin-left:22%;">keep previous msgids of
 184 translated messages</p>
 185
 186 <p style="margin-left:11%; margin-top: 1em"><b>Input file
 187 syntax: <br>
 188 &minus;P</b>,
 189 <b>&minus;&minus;properties&minus;input</b></p>
 190
 191 <p style="margin-left:22%;">input files are in Java
 192 .properties syntax</p>
 193
 194
 195 <p style="margin-left:11%;"><b>&minus;&minus;stringtable&minus;input</b></p>
 196
 197 <p style="margin-left:22%;">input files are in
 198 NeXTstep/GNUstep .strings syntax</p>
 199
 200 <p style="margin-left:11%; margin-top: 1em"><b>Output
 201 details: <br>
 202 &minus;&minus;lang</b>=<i>CATALOGNAME</i></p>
 203
 204 <p style="margin-left:22%;">set &rsquo;Language&rsquo;
 205 field in the header entry</p>
 206
 207 <p style="margin-left:11%;"><b>&minus;&minus;color</b></p>
 208
 209 <p style="margin-left:22%;">use colors and other text
 210 attributes always</p>
 211
 212
 213 <p style="margin-left:11%;"><b>&minus;&minus;color</b>=<i>WHEN</i></p>
 214
 215 <p style="margin-left:22%;">use colors and other text
 216 attributes if WHEN. WHEN may be &rsquo;always&rsquo;,
 217 &rsquo;never&rsquo;, &rsquo;auto&rsquo;, or
 218 &rsquo;html&rsquo;.</p>
 219
 220
 221 <p style="margin-left:11%;"><b>&minus;&minus;style</b>=<i>STYLEFILE</i></p>
 222
 223 <p style="margin-left:22%;">specify CSS style rule file for
 224 <b>&minus;&minus;color</b></p>
 225
 226 <p style="margin-left:11%;"><b>&minus;e</b>,
 227 <b>&minus;&minus;no&minus;escape</b></p>
 228
 229 <p style="margin-left:22%;">do not use C escapes in output
 230 (default)</p>
 231
 232 <p style="margin-left:11%;"><b>&minus;E</b>,
 233 <b>&minus;&minus;escape</b></p>
 234
 235 <p style="margin-left:22%;">use C escapes in output, no
 236 extended chars</p>
 237
 238
 239 <p style="margin-left:11%;"><b>&minus;&minus;force&minus;po</b></p>
 240
 241 <p style="margin-left:22%;">write PO file even if empty</p>
 242
 243 <p style="margin-left:11%;"><b>&minus;i</b>,
 244 <b>&minus;&minus;indent</b></p>
 245
 246 <p style="margin-left:22%;">indented output style</p>
 247
 248
 249 <p style="margin-left:11%;"><b>&minus;&minus;no&minus;location</b></p>
 250
 251 <p style="margin-left:22%;">suppress &rsquo;#:
 252 filename:line&rsquo; lines</p>
 253
 254 <p style="margin-left:11%;"><b>&minus;n</b>,
 255 <b>&minus;&minus;add&minus;location</b></p>
 256
 257 <p style="margin-left:22%;">preserve &rsquo;#:
 258 filename:line&rsquo; lines (default)</p>
 259
 260
 261 <p style="margin-left:11%;"><b>&minus;&minus;strict</b></p>
 262
 263 <p style="margin-left:22%;">strict Uniforum output
 264 style</p>
 265
 266 <p style="margin-left:11%;"><b>&minus;p</b>,
 267 <b>&minus;&minus;properties&minus;output</b></p>
 268
 269 <p style="margin-left:22%;">write out a Java .properties
 270 file</p>
 271
 272
 273 <p style="margin-left:11%;"><b>&minus;&minus;stringtable&minus;output</b></p>
 274
 275 <p style="margin-left:22%;">write out a NeXTstep/GNUstep
 276 .strings file</p>
 277
 278 <p style="margin-left:11%;"><b>&minus;w</b>,
 279 <b>&minus;&minus;width</b>=<i>NUMBER</i></p>
 280
 281 <p style="margin-left:22%;">set output page width</p>
 282
 283
 284 <p style="margin-left:11%;"><b>&minus;&minus;no&minus;wrap</b></p>
 285
 286 <p style="margin-left:22%;">do not break long message
 287 lines, longer than the output page width, into several
 288 lines</p>
 289
 290 <p style="margin-left:11%;"><b>&minus;s</b>,
 291 <b>&minus;&minus;sort&minus;output</b></p>
 292
 293 <p style="margin-left:22%;">generate sorted output</p>
 294
 295 <p style="margin-left:11%;"><b>&minus;F</b>,
 296 <b>&minus;&minus;sort&minus;by&minus;file</b></p>
 297
 298 <p style="margin-left:22%;">sort output by file
 299 location</p>
 300
 301 <p style="margin-left:11%; margin-top: 1em"><b>Informative
 302 output: <br>
 303 &minus;h</b>, <b>&minus;&minus;help</b></p>
 304
 305 <p style="margin-left:22%;">display this help and exit</p>
 306
 307 <p style="margin-left:11%;"><b>&minus;V</b>,
 308 <b>&minus;&minus;version</b></p>
 309
 310 <p style="margin-left:22%;">output version information and
 311 exit</p>
 312
 313 <p style="margin-left:11%;"><b>&minus;v</b>,
 314 <b>&minus;&minus;verbose</b></p>
 315
 316 <p style="margin-left:22%;">increase verbosity level</p>
 317
 318 <p style="margin-left:11%;"><b>&minus;q</b>,
 319 <b>&minus;&minus;quiet</b>, <b>&minus;&minus;silent</b></p>
 320
 321 <p style="margin-left:22%;">suppress progress
 322 indicators</p>
 323
 324 <h2>AUTHOR
 325 <a name="AUTHOR"></a>
 326 </h2>
 327
 328
 329 <p style="margin-left:11%; margin-top: 1em">Written by
 330 Peter Miller.</p>
 331
 332 <h2>REPORTING BUGS
 333 <a name="REPORTING BUGS"></a>
 334 </h2>
 335
 336
 337 <p style="margin-left:11%; margin-top: 1em">Report bugs to
 338 &lt;bug-gnu-gettext@gnu.org&gt;.</p>
 339
 340 <h2>COPYRIGHT
 341 <a name="COPYRIGHT"></a>
 342 </h2>
 343
 344
 345 <p style="margin-left:11%; margin-top: 1em">Copyright
 346 &copy; 1995-1998, 2000-2010 Free Software Foundation, Inc.
 347 License GPLv3+: GNU GPL version 3 or later
 348 &lt;http://gnu.org/licenses/gpl.html&gt; <br>
 349 This is free software: you are free to change and
 350 redistribute it. There is NO WARRANTY, to the extent
 351 permitted by law.</p>
 352
 353 <h2>SEE ALSO
 354 <a name="SEE ALSO"></a>
 355 </h2>
 356
 357
 358 <p style="margin-left:11%; margin-top: 1em">The full
 359 documentation for <b>msgmerge</b> is maintained as a Texinfo
 360 manual. If the <b>info</b> and <b>msgmerge</b> programs are
 361 properly installed at your site, the command</p>
 362
 363 <p style="margin-left:22%; margin-top: 1em"><b>info
 364 msgmerge</b></p>
 365
 366 <p style="margin-left:11%; margin-top: 1em">should give you
 367 access to the complete manual.</p>
 368 <hr>
 369 </body>
 370 </html>