man-pages/man1/msgfmt.1.html
2021-03-31 01:06:50 +01:00

290 lines
8.8 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of MSGFMT</TITLE>
</HEAD><BODY>
<H1>MSGFMT</H1>
Section: GNU (1)<BR>Updated: June 2016<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
msgfmt - compile message catalog to binary format
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>msgfmt</B>
[<I>OPTION</I>] <I>filename.po </I>...
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<P>
Generate binary message catalog from textual translation description.
<P>
Mandatory arguments to long options are mandatory for short options too.
Similarly for optional arguments.
<A NAME="lbAE">&nbsp;</A>
<H3>Input file location:</H3>
<DL COMPACT>
<DT id="1">filename.po ...<DD>
input files
<DT id="2"><B>-D</B>, <B>--directory</B>=<I>DIRECTORY</I><DD>
add DIRECTORY to list for input files search
</DL>
<P>
If input file is -, standard input is read.
<A NAME="lbAF">&nbsp;</A>
<H3>Operation mode:</H3>
<DL COMPACT>
<DT id="3"><B>-j</B>, <B>--java</B><DD>
Java mode: generate a Java ResourceBundle class
<DT id="4"><B>--java2</B><DD>
like <B>--java</B>, and assume Java2 (JDK 1.2 or higher)
<DT id="5"><B>--csharp</B><DD>
C# mode: generate a .NET .dll file
<DT id="6"><B>--csharp-resources</B><DD>
C# resources mode: generate a .NET .resources file
<DT id="7"><B>--tcl</B><DD>
Tcl mode: generate a tcl/msgcat .msg file
<DT id="8"><B>--qt</B><DD>
Qt mode: generate a Qt .qm file
<DT id="9"><B>--desktop</B><DD>
Desktop Entry mode: generate a .desktop file
<DT id="10"><B>--xml</B><DD>
XML mode: generate XML file
</DL>
<A NAME="lbAG">&nbsp;</A>
<H3>Output file location:</H3>
<DL COMPACT>
<DT id="11"><B>-o</B>, <B>--output-file</B>=<I>FILE</I><DD>
write output to specified file
<DT id="12"><B>--strict</B><DD>
enable strict Uniforum mode
</DL>
<P>
If output file is -, output is written to standard output.
<A NAME="lbAH">&nbsp;</A>
<H3>Output file location in Java mode:</H3>
<DL COMPACT>
<DT id="13"><B>-r</B>, <B>--resource</B>=<I>RESOURCE</I><DD>
resource name
<DT id="14"><B>-l</B>, <B>--locale</B>=<I>LOCALE</I><DD>
locale name, either language or language_COUNTRY
<DT id="15"><B>--source</B><DD>
produce a .java file, instead of a .class file
<DT id="16"><B>-d</B> DIRECTORY<DD>
base directory of classes directory hierarchy
</DL>
<P>
The class name is determined by appending the locale name to the resource name,
separated with an underscore. The <B>-d</B> option is mandatory. The class is
written under the specified directory.
<A NAME="lbAI">&nbsp;</A>
<H3>Output file location in C# mode:</H3>
<DL COMPACT>
<DT id="17"><B>-r</B>, <B>--resource</B>=<I>RESOURCE</I><DD>
resource name
<DT id="18"><B>-l</B>, <B>--locale</B>=<I>LOCALE</I><DD>
locale name, either language or language_COUNTRY
<DT id="19"><B>-d</B> DIRECTORY<DD>
base directory for locale dependent .dll files
</DL>
<P>
The <B>-l</B> and <B>-d</B> options are mandatory. The .dll file is written in a
subdirectory of the specified directory whose name depends on the locale.
<A NAME="lbAJ">&nbsp;</A>
<H3>Output file location in Tcl mode:</H3>
<DL COMPACT>
<DT id="20"><B>-l</B>, <B>--locale</B>=<I>LOCALE</I><DD>
locale name, either language or language_COUNTRY
<DT id="21"><B>-d</B> DIRECTORY<DD>
base directory of .msg message catalogs
</DL>
<P>
The <B>-l</B> and <B>-d</B> options are mandatory. The .msg file is written in the
specified directory.
<A NAME="lbAK">&nbsp;</A>
<H3>Desktop Entry mode options:</H3>
<DL COMPACT>
<DT id="22"><B>-l</B>, <B>--locale</B>=<I>LOCALE</I><DD>
locale name, either language or language_COUNTRY
<DT id="23"><B>-o</B>, <B>--output-file</B>=<I>FILE</I><DD>
write output to specified file
<DT id="24"><B>--template</B>=<I>TEMPLATE</I><DD>
a .desktop file used as a template
<DT id="25"><B>-d</B> DIRECTORY<DD>
base directory of .po files
<DT id="26"><B>-kWORD</B>, <B>--keyword</B>=<I>WORD</I><DD>
look for WORD as an additional keyword
<DT id="27"><B>-k</B>, <B>--keyword</B><DD>
do not to use default keywords
</DL>
<P>
The <B>-l</B>, <B>-o</B>, and <B>--template</B> options are mandatory. If <B>-D</B> is specified, input
files are read from the directory instead of the command line arguments.
<A NAME="lbAL">&nbsp;</A>
<H3>XML mode options:</H3>
<DL COMPACT>
<DT id="28"><B>-l</B>, <B>--locale</B>=<I>LOCALE</I><DD>
locale name, either language or language_COUNTRY
<DT id="29"><B>-L</B>, <B>--language</B>=<I>NAME</I><DD>
recognise the specified XML language
<DT id="30"><B>-o</B>, <B>--output-file</B>=<I>FILE</I><DD>
write output to specified file
<DT id="31"><B>--template</B>=<I>TEMPLATE</I><DD>
an XML file used as a template
<DT id="32"><B>-d</B> DIRECTORY<DD>
base directory of .po files
</DL>
<P>
The <B>-l</B>, <B>-o</B>, and <B>--template</B> options are mandatory. If <B>-D</B> is specified, input
files are read from the directory instead of the command line arguments.
<A NAME="lbAM">&nbsp;</A>
<H3>Input file syntax:</H3>
<DL COMPACT>
<DT id="33"><B>-P</B>, <B>--properties-input</B><DD>
input files are in Java .properties syntax
<DT id="34"><B>--stringtable-input</B><DD>
input files are in NeXTstep/GNUstep .strings
syntax
</DL>
<A NAME="lbAN">&nbsp;</A>
<H3>Input file interpretation:</H3>
<DL COMPACT>
<DT id="35"><B>-c</B>, <B>--check</B><DD>
perform all the checks implied by
<B>--check-format</B>, <B>--check-header</B>, <B>--check-domain</B>
<DT id="36"><B>--check-format</B><DD>
check language dependent format strings
<DT id="37"><B>--check-header</B><DD>
verify presence and contents of the header entry
<DT id="38"><B>--check-domain</B><DD>
check for conflicts between domain directives
and the <B>--output-file</B> option
<DT id="39"><B>-C</B>, <B>--check-compatibility</B><DD>
check that GNU msgfmt behaves like X/Open msgfmt
<DT id="40"><B>--check-accelerators</B>[=<I>CHAR</I>]<DD>
check presence of keyboard accelerators for
menu items
<DT id="41"><B>-f</B>, <B>--use-fuzzy</B><DD>
use fuzzy entries in output
</DL>
<A NAME="lbAO">&nbsp;</A>
<H3>Output details:</H3>
<DL COMPACT>
<DT id="42"><B>-a</B>, <B>--alignment</B>=<I>NUMBER</I><DD>
align strings to NUMBER bytes (default: 1)
<DT id="43"><B>--endianness</B>=<I>BYTEORDER</I><DD>
write out 32-bit numbers in the given byte order
(big or little, default depends on platform)
<DT id="44"><B>--no-hash</B><DD>
binary file will not include the hash table
</DL>
<A NAME="lbAP">&nbsp;</A>
<H3>Informative output:</H3>
<DL COMPACT>
<DT id="45"><B>-h</B>, <B>--help</B><DD>
display this help and exit
<DT id="46"><B>-V</B>, <B>--version</B><DD>
output version information and exit
<DT id="47"><B>--statistics</B><DD>
print statistics about translations
<DT id="48"><B>-v</B>, <B>--verbose</B><DD>
increase verbosity level
</DL>
<A NAME="lbAQ">&nbsp;</A>
<H2>AUTHOR</H2>
Written by Ulrich Drepper.
<A NAME="lbAR">&nbsp;</A>
<H2>REPORTING BUGS</H2>
Report bugs to &lt;<A HREF="mailto:bug-gnu-gettext@gnu.org">bug-gnu-gettext@gnu.org</A>&gt;.
<A NAME="lbAS">&nbsp;</A>
<H2>COPYRIGHT</H2>
Copyright &#169; 1995-1998, 2000-2016 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later &lt;<A HREF="http://gnu.org/licenses/gpl.html">http://gnu.org/licenses/gpl.html</A>&gt;
<BR>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
<A NAME="lbAT">&nbsp;</A>
<H2>SEE ALSO</H2>
The full documentation for
<B>msgfmt</B>
is maintained as a Texinfo manual. If the
<B>info</B>
and
<B>msgfmt</B>
programs are properly installed at your site, the command
<DL COMPACT>
<DT id="49"><DD>
<B>info msgfmt</B>
</DL>
<P>
should give you access to the complete manual.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="50"><A HREF="#lbAB">NAME</A><DD>
<DT id="51"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="52"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT id="53"><A HREF="#lbAE">Input file location:</A><DD>
<DT id="54"><A HREF="#lbAF">Operation mode:</A><DD>
<DT id="55"><A HREF="#lbAG">Output file location:</A><DD>
<DT id="56"><A HREF="#lbAH">Output file location in Java mode:</A><DD>
<DT id="57"><A HREF="#lbAI">Output file location in C# mode:</A><DD>
<DT id="58"><A HREF="#lbAJ">Output file location in Tcl mode:</A><DD>
<DT id="59"><A HREF="#lbAK">Desktop Entry mode options:</A><DD>
<DT id="60"><A HREF="#lbAL">XML mode options:</A><DD>
<DT id="61"><A HREF="#lbAM">Input file syntax:</A><DD>
<DT id="62"><A HREF="#lbAN">Input file interpretation:</A><DD>
<DT id="63"><A HREF="#lbAO">Output details:</A><DD>
<DT id="64"><A HREF="#lbAP">Informative output:</A><DD>
</DL>
<DT id="65"><A HREF="#lbAQ">AUTHOR</A><DD>
<DT id="66"><A HREF="#lbAR">REPORTING BUGS</A><DD>
<DT id="67"><A HREF="#lbAS">COPYRIGHT</A><DD>
<DT id="68"><A HREF="#lbAT">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:19 GMT, March 31, 2021
</BODY>
</HTML>