gettext-tools/man/msgfmt.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>MSGFMT</title>
  16
  17 </head>
  18 <body>
  19
  20 <h1 align="center">MSGFMT</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">msgfmt &minus;
  39 compile message catalog to binary format</p>
  40
  41 <h2>SYNOPSIS
  42 <a name="SYNOPSIS"></a>
  43 </h2>
  44
  45
  46 <p style="margin-left:11%; margin-top: 1em"><b>msgfmt</b>
  47 [<i>OPTION</i>] <i>filename.po</i> ...</p>
  48
  49 <h2>DESCRIPTION
  50 <a name="DESCRIPTION"></a>
  51 </h2>
  52
  53
  54 <p style="margin-left:11%; margin-top: 1em">Generate binary
  55 message catalog from textual translation description.</p>
  56
  57 <p style="margin-left:11%; margin-top: 1em">Mandatory
  58 arguments to long options are mandatory for short options
  59 too. Similarly for optional arguments.</p>
  60
  61 <p style="margin-left:11%; margin-top: 1em"><b>Input file
  62 location:</b> <br>
  63 filename.po ...</p>
  64
  65 <p style="margin-left:22%;">input files</p>
  66
  67 <p style="margin-left:11%;"><b>&minus;D</b>,
  68 <b>&minus;&minus;directory</b>=<i>DIRECTORY</i></p>
  69
  70 <p style="margin-left:22%;">add DIRECTORY to list for input
  71 files search</p>
  72
  73 <p style="margin-left:11%; margin-top: 1em">If input file
  74 is -, standard input is read.</p>
  75
  76 <p style="margin-left:11%; margin-top: 1em"><b>Operation
  77 mode: <br>
  78 &minus;j</b>, <b>&minus;&minus;java</b></p>
  79
  80 <p style="margin-left:22%;">Java mode: generate a Java
  81 ResourceBundle class</p>
  82
  83 <p style="margin-left:11%;"><b>&minus;&minus;java2</b></p>
  84
  85 <p style="margin-left:22%;">like <b>&minus;&minus;java</b>,
  86 and assume Java2 (JDK 1.2 or higher)</p>
  87
  88
  89 <p style="margin-left:11%;"><b>&minus;&minus;csharp</b></p>
  90
  91 <p style="margin-left:22%;">C# mode: generate a .NET .dll
  92 file</p>
  93
  94
  95 <p style="margin-left:11%;"><b>&minus;&minus;csharp&minus;resources</b></p>
  96
  97 <p style="margin-left:22%;">C# resources mode: generate a
  98 .NET .resources file</p>
  99
 100 <table width="100%" border="0" rules="none" frame="void"
 101        cellspacing="0" cellpadding="0">
 102 <tr valign="top" align="left">
 103 <td width="11%"></td>
 104 <td width="7%">
 105
 106
 107 <p><b>&minus;&minus;tcl</b></p></td>
 108 <td width="4%"></td>
 109 <td width="63%">
 110
 111
 112 <p>Tcl mode: generate a tcl/msgcat .msg file</p></td>
 113 <td width="15%">
 114 </td></tr>
 115 <tr valign="top" align="left">
 116 <td width="11%"></td>
 117 <td width="7%">
 118
 119
 120 <p><b>&minus;&minus;qt</b></p></td>
 121 <td width="4%"></td>
 122 <td width="63%">
 123
 124
 125 <p>Qt mode: generate a Qt .qm file</p></td>
 126 <td width="15%">
 127 </td></tr>
 128 </table>
 129
 130
 131 <p style="margin-left:11%;"><b>&minus;&minus;desktop</b></p>
 132
 133 <p style="margin-left:22%;">Desktop Entry mode: generate a
 134 .desktop file</p>
 135
 136 <table width="100%" border="0" rules="none" frame="void"
 137        cellspacing="0" cellpadding="0">
 138 <tr valign="top" align="left">
 139 <td width="11%"></td>
 140 <td width="7%">
 141
 142
 143 <p><b>&minus;&minus;xml</b></p></td>
 144 <td width="4%"></td>
 145 <td width="41%">
 146
 147
 148 <p>XML mode: generate XML file</p></td>
 149 <td width="37%">
 150 </td></tr>
 151 </table>
 152
 153 <p style="margin-left:11%; margin-top: 1em"><b>Output file
 154 location: <br>
 155 &minus;o</b>,
 156 <b>&minus;&minus;output&minus;file</b>=<i>FILE</i></p>
 157
 158 <p style="margin-left:22%;">write output to specified
 159 file</p>
 160
 161
 162 <p style="margin-left:11%;"><b>&minus;&minus;strict</b></p>
 163
 164 <p style="margin-left:22%;">enable strict Uniforum mode</p>
 165
 166 <p style="margin-left:11%; margin-top: 1em">If output file
 167 is -, output is written to standard output.</p>
 168
 169 <p style="margin-left:11%; margin-top: 1em"><b>Output file
 170 location in Java mode: <br>
 171 &minus;r</b>,
 172 <b>&minus;&minus;resource</b>=<i>RESOURCE</i></p>
 173
 174 <p style="margin-left:22%;">resource name</p>
 175
 176 <p style="margin-left:11%;"><b>&minus;l</b>,
 177 <b>&minus;&minus;locale</b>=<i>LOCALE</i></p>
 178
 179 <p style="margin-left:22%;">locale name, either language or
 180 language_COUNTRY</p>
 181
 182
 183 <p style="margin-left:11%;"><b>&minus;&minus;source</b></p>
 184
 185 <p style="margin-left:22%;">produce a .java file, instead
 186 of a .class file</p>
 187
 188 <p style="margin-left:11%;"><b>&minus;d</b> DIRECTORY</p>
 189
 190 <p style="margin-left:22%;">base directory of classes
 191 directory hierarchy</p>
 192
 193 <p style="margin-left:11%; margin-top: 1em">The class name
 194 is determined by appending the locale name to the resource
 195 name, separated with an underscore. The <b>&minus;d</b>
 196 option is mandatory. The class is written under the
 197 specified directory.</p>
 198
 199 <p style="margin-left:11%; margin-top: 1em"><b>Output file
 200 location in C# mode: <br>
 201 &minus;r</b>,
 202 <b>&minus;&minus;resource</b>=<i>RESOURCE</i></p>
 203
 204 <p style="margin-left:22%;">resource name</p>
 205
 206 <p style="margin-left:11%;"><b>&minus;l</b>,
 207 <b>&minus;&minus;locale</b>=<i>LOCALE</i></p>
 208
 209 <p style="margin-left:22%;">locale name, either language or
 210 language_COUNTRY</p>
 211
 212 <p style="margin-left:11%;"><b>&minus;d</b> DIRECTORY</p>
 213
 214 <p style="margin-left:22%;">base directory for locale
 215 dependent .dll files</p>
 216
 217 <p style="margin-left:11%; margin-top: 1em">The
 218 <b>&minus;l</b> and <b>&minus;d</b> options are mandatory.
 219 The .dll file is written in a subdirectory of the specified
 220 directory whose name depends on the locale.</p>
 221
 222 <p style="margin-left:11%; margin-top: 1em"><b>Output file
 223 location in Tcl mode: <br>
 224 &minus;l</b>, <b>&minus;&minus;locale</b>=<i>LOCALE</i></p>
 225
 226 <p style="margin-left:22%;">locale name, either language or
 227 language_COUNTRY</p>
 228
 229 <p style="margin-left:11%;"><b>&minus;d</b> DIRECTORY</p>
 230
 231 <p style="margin-left:22%;">base directory of .msg message
 232 catalogs</p>
 233
 234 <p style="margin-left:11%; margin-top: 1em">The
 235 <b>&minus;l</b> and <b>&minus;d</b> options are mandatory.
 236 The .msg file is written in the specified directory.</p>
 237
 238 <p style="margin-left:11%; margin-top: 1em"><b>Desktop
 239 Entry mode options: <br>
 240 &minus;l</b>, <b>&minus;&minus;locale</b>=<i>LOCALE</i></p>
 241
 242 <p style="margin-left:22%;">locale name, either language or
 243 language_COUNTRY</p>
 244
 245 <p style="margin-left:11%;"><b>&minus;o</b>,
 246 <b>&minus;&minus;output&minus;file</b>=<i>FILE</i></p>
 247
 248 <p style="margin-left:22%;">write output to specified
 249 file</p>
 250
 251
 252 <p style="margin-left:11%;"><b>&minus;&minus;template</b>=<i>TEMPLATE</i></p>
 253
 254 <p style="margin-left:22%;">a .desktop file used as a
 255 template</p>
 256
 257 <p style="margin-left:11%;"><b>&minus;d</b> DIRECTORY</p>
 258
 259 <p style="margin-left:22%;">base directory of .po files</p>
 260
 261 <p style="margin-left:11%;"><b>&minus;kWORD</b>,
 262 <b>&minus;&minus;keyword</b>=<i>WORD</i></p>
 263
 264 <p style="margin-left:22%;">look for WORD as an additional
 265 keyword</p>
 266
 267 <p style="margin-left:11%;"><b>&minus;k</b>,
 268 <b>&minus;&minus;keyword</b></p>
 269
 270 <p style="margin-left:22%;">do not to use default
 271 keywords</p>
 272
 273 <p style="margin-left:11%; margin-top: 1em">The
 274 <b>&minus;l</b>, <b>&minus;o</b>, and
 275 <b>&minus;&minus;template</b> options are mandatory. If
 276 <b>&minus;D</b> is specified, input files are read from the
 277 directory instead of the command line arguments.</p>
 278
 279 <p style="margin-left:11%; margin-top: 1em"><b>XML mode
 280 options: <br>
 281 &minus;l</b>, <b>&minus;&minus;locale</b>=<i>LOCALE</i></p>
 282
 283 <p style="margin-left:22%;">locale name, either language or
 284 language_COUNTRY</p>
 285
 286 <p style="margin-left:11%;"><b>&minus;L</b>,
 287 <b>&minus;&minus;language</b>=<i>NAME</i></p>
 288
 289 <p style="margin-left:22%;">recognise the specified XML
 290 language</p>
 291
 292 <p style="margin-left:11%;"><b>&minus;o</b>,
 293 <b>&minus;&minus;output&minus;file</b>=<i>FILE</i></p>
 294
 295 <p style="margin-left:22%;">write output to specified
 296 file</p>
 297
 298
 299 <p style="margin-left:11%;"><b>&minus;&minus;template</b>=<i>TEMPLATE</i></p>
 300
 301 <p style="margin-left:22%;">an XML file used as a
 302 template</p>
 303
 304 <p style="margin-left:11%;"><b>&minus;d</b> DIRECTORY</p>
 305
 306 <p style="margin-left:22%;">base directory of .po files</p>
 307
 308 <p style="margin-left:11%; margin-top: 1em">The
 309 <b>&minus;l</b>, <b>&minus;o</b>, and
 310 <b>&minus;&minus;template</b> options are mandatory. If
 311 <b>&minus;D</b> is specified, input files are read from the
 312 directory instead of the command line arguments.</p>
 313
 314 <p style="margin-left:11%; margin-top: 1em"><b>Input file
 315 syntax: <br>
 316 &minus;P</b>,
 317 <b>&minus;&minus;properties&minus;input</b></p>
 318
 319 <p style="margin-left:22%;">input files are in Java
 320 .properties syntax</p>
 321
 322
 323 <p style="margin-left:11%;"><b>&minus;&minus;stringtable&minus;input</b></p>
 324
 325 <p style="margin-left:22%;">input files are in
 326 NeXTstep/GNUstep .strings syntax</p>
 327
 328 <p style="margin-left:11%; margin-top: 1em"><b>Input file
 329 interpretation: <br>
 330 &minus;c</b>, <b>&minus;&minus;check</b></p>
 331
 332 <p style="margin-left:22%;">perform all the checks implied
 333 by <b>&minus;&minus;check&minus;format</b>,
 334 <b>&minus;&minus;check&minus;header</b>,
 335 <b>&minus;&minus;check&minus;domain</b></p>
 336
 337
 338 <p style="margin-left:11%;"><b>&minus;&minus;check&minus;format</b></p>
 339
 340 <p style="margin-left:22%;">check language dependent format
 341 strings</p>
 342
 343
 344 <p style="margin-left:11%;"><b>&minus;&minus;check&minus;header</b></p>
 345
 346 <p style="margin-left:22%;">verify presence and contents of
 347 the header entry</p>
 348
 349
 350 <p style="margin-left:11%;"><b>&minus;&minus;check&minus;domain</b></p>
 351
 352 <p style="margin-left:22%;">check for conflicts between
 353 domain directives and the
 354 <b>&minus;&minus;output&minus;file</b> option</p>
 355
 356 <p style="margin-left:11%;"><b>&minus;C</b>,
 357 <b>&minus;&minus;check&minus;compatibility</b></p>
 358
 359 <p style="margin-left:22%;">check that GNU msgfmt behaves
 360 like X/Open msgfmt</p>
 361
 362
 363 <p style="margin-left:11%;"><b>&minus;&minus;check&minus;accelerators</b>[=<i>CHAR</i>]</p>
 364
 365 <p style="margin-left:22%;">check presence of keyboard
 366 accelerators for menu items</p>
 367
 368 <p style="margin-left:11%;"><b>&minus;f</b>,
 369 <b>&minus;&minus;use&minus;fuzzy</b></p>
 370
 371 <p style="margin-left:22%;">use fuzzy entries in output</p>
 372
 373 <p style="margin-left:11%; margin-top: 1em"><b>Output
 374 details: <br>
 375 &minus;a</b>,
 376 <b>&minus;&minus;alignment</b>=<i>NUMBER</i></p>
 377
 378 <p style="margin-left:22%;">align strings to NUMBER bytes
 379 (default: 1)</p>
 380
 381
 382 <p style="margin-left:11%;"><b>&minus;&minus;endianness</b>=<i>BYTEORDER</i></p>
 383
 384 <p style="margin-left:22%;">write out 32-bit numbers in the
 385 given byte order (big or little, default depends on
 386 platform)</p>
 387
 388
 389 <p style="margin-left:11%;"><b>&minus;&minus;no&minus;hash</b></p>
 390
 391 <p style="margin-left:22%;">binary file will not include
 392 the hash table</p>
 393
 394 <p style="margin-left:11%; margin-top: 1em"><b>Informative
 395 output: <br>
 396 &minus;h</b>, <b>&minus;&minus;help</b></p>
 397
 398 <p style="margin-left:22%;">display this help and exit</p>
 399
 400 <p style="margin-left:11%;"><b>&minus;V</b>,
 401 <b>&minus;&minus;version</b></p>
 402
 403 <p style="margin-left:22%;">output version information and
 404 exit</p>
 405
 406
 407 <p style="margin-left:11%;"><b>&minus;&minus;statistics</b></p>
 408
 409 <p style="margin-left:22%;">print statistics about
 410 translations</p>
 411
 412 <p style="margin-left:11%;"><b>&minus;v</b>,
 413 <b>&minus;&minus;verbose</b></p>
 414
 415 <p style="margin-left:22%;">increase verbosity level</p>
 416
 417 <h2>AUTHOR
 418 <a name="AUTHOR"></a>
 419 </h2>
 420
 421
 422 <p style="margin-left:11%; margin-top: 1em">Written by
 423 Ulrich Drepper.</p>
 424
 425 <h2>REPORTING BUGS
 426 <a name="REPORTING BUGS"></a>
 427 </h2>
 428
 429
 430 <p style="margin-left:11%; margin-top: 1em">Report bugs to
 431 &lt;bug-gnu-gettext@gnu.org&gt;.</p>
 432
 433 <h2>COPYRIGHT
 434 <a name="COPYRIGHT"></a>
 435 </h2>
 436
 437
 438 <p style="margin-left:11%; margin-top: 1em">Copyright
 439 &copy; 1995-1998, 2000-2010 Free Software Foundation, Inc.
 440 License GPLv3+: GNU GPL version 3 or later
 441 &lt;http://gnu.org/licenses/gpl.html&gt; <br>
 442 This is free software: you are free to change and
 443 redistribute it. There is NO WARRANTY, to the extent
 444 permitted by law.</p>
 445
 446 <h2>SEE ALSO
 447 <a name="SEE ALSO"></a>
 448 </h2>
 449
 450
 451 <p style="margin-left:11%; margin-top: 1em">The full
 452 documentation for <b>msgfmt</b> is maintained as a Texinfo
 453 manual. If the <b>info</b> and <b>msgfmt</b> programs are
 454 properly installed at your site, the command</p>
 455
 456 <p style="margin-left:22%; margin-top: 1em"><b>info
 457 msgfmt</b></p>
 458
 459 <p style="margin-left:11%; margin-top: 1em">should give you
 460 access to the complete manual.</p>
 461 <hr>
 462 </body>
 463 </html>