annotate CSP2/CSP2_env/env-d9b9114564458d9d-741b3de822f2aaca6c6caa4325c4afce/share/doc/gettext/msgmerge.1.html @ 68:5028fdace37b

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