msgfmt1
Compile message catalog to binary format
Usage
msgfmt [OPTION]
filename.po ...
Overview
Generate binary message catalog from textual translation description.
Mandatory arguments to long options are mandatory for short options too. Similarly for optional arguments.
Input file location:
- filename.po ...
-
input files
-
-D, --directory=DIRECTORY -
add DIRECTORY to list for input files search
If input file is -, standard input is read.
Operation mode:
-
-j, --java -
Java mode: generate a Java ResourceBundle class
-
--java2 -
like
--java, and assume Java2 (JDK 1.2 or higher)
-
--csharp -
C# mode: generate a .NET .dll file
-
--csharp-resources -
C# resources mode: generate a .NET .resources file
-
--tcl -
Tcl mode: generate a tcl/msgcat .msg file
-
--qt -
Qt mode: generate a Qt .qm file
-
--desktop -
Desktop Entry mode: generate a .desktop file
-
--xml -
XML mode: generate XML file
Output file location:
-
-o, --output-file=FILE -
write output to specified file
-
--strict -
enable strict Uniforum mode
If output file is -, output is written to standard output.
Output file location in Java mode:
-
-r, --resource=RESOURCE -
resource name
-
-l, --locale=LOCALE -
locale name, either language or language_COUNTRY
-
--source -
produce a .java file, instead of a .class file
-
-d DIRECTORY -
base directory of classes directory hierarchy
The class name is determined by appending the locale name to the resource name, separated with an underscore. The -d option is mandatory. The class is written under the specified directory.
Output file location in C# mode:
-
-r, --resource=RESOURCE -
resource name
-
-l, --locale=LOCALE -
locale name, either language or language_COUNTRY
-
-d DIRECTORY -
base directory for locale dependent .dll files
The -l and -d options are mandatory. The .dll file is written in a subdirectory of the specified directory whose name depends on the locale.
Output file location in Tcl mode:
-
-l, --locale=LOCALE -
locale name, either language or language_COUNTRY
-
-d DIRECTORY -
base directory of .msg message catalogs
The -l and -d options are mandatory. The .msg file is written in the specified directory.
Desktop Entry mode options:
-
-l, --locale=LOCALE -
locale name, either language or language_COUNTRY
-
-o, --output-file=FILE -
write output to specified file
-
--template=TEMPLATE -
a .desktop file used as a template
-
-d DIRECTORY -
base directory of .po files
-
-kWORD, --keyword=WORD -
look for WORD as an additional keyword
-
-k, --keyword -
do not to use default keywords
The -l, -o, and --template options are mandatory. If -D is specified, input files are read from the directory instead of the command line arguments.
XML mode options:
-
-l, --locale=LOCALE -
locale name, either language or language_COUNTRY
-
-L, --language=NAME -
recognise the specified XML language
-
-o, --output-file=FILE -
write output to specified file
-
--template=TEMPLATE -
an XML file used as a template
-
-d DIRECTORY -
base directory of .po files
-
--replace-text -
output XML with translated text replacing the original text, not augmenting the original text
The -l, -o, and --template options are mandatory. If -D is specified, input files are read from the directory instead of the command line arguments.
Input file syntax:
-
-P, --properties-input -
input files are in Java .properties syntax
-
--stringtable-input -
input files are in NeXTstep/GNUstep .strings syntax
Input file interpretation:
-
-c, --check -
perform all the checks implied by
--check-format,--check-header,--check-domain
-
--check-format -
check language dependent format strings
-
--check-header -
verify presence and contents of the header entry
-
--check-domain -
check for conflicts between domain directives and the
--output-fileoption
-
-C, --check-compatibility -
check that GNU msgfmt behaves like X/Open msgfmt
-
--check-accelerators[=CHAR] -
check presence of keyboard accelerators for menu items
-
-f, --use-fuzzy -
use fuzzy entries in output
Output details:
-
--no-convert -
don't convert the messages to UTF-8 encoding
-
--no-redundancy -
don't pre-expand ISO C 99 <inttypes.h> format string directive macros
-
-a, --alignment=NUMBER -
align strings to NUMBER bytes (default: 1)
-
--endianness=BYTEORDER -
write out 32-bit numbers in the given byte order (big or little, default depends on platform)
-
--no-hash -
binary file will not include the hash table
Informative output:
-
-h, --help -
display this help and exit
-
-V, --version -
output version information and exit
-
--statistics -
print statistics about translations
-
-v, --verbose -
increase verbosity level
Releases
15 releases since Debian 1.2 (Rex); the text changed 11 times.
--alignment since Debian 3.0 (Woody);
--check since Debian 3.0 (Woody);
--check-accelerators since Debian 3.1 (Sarge);
--check-compatibility since Debian 3.1 (Sarge);
--check-domain since Debian 3.1 (Sarge);
--check-format since Debian 3.1 (Sarge);
--check-header since Debian 3.1 (Sarge);
--csharp since Debian 3.1 (Sarge);
--csharp-resources since Debian 3.1 (Sarge);
--desktop since Debian 8 (Jessie);
--directory since Debian 3.0 (Woody);
--endianness since Debian 8 (Jessie);
--help since Debian 3.0 (Woody);
--java since Debian 3.1 (Sarge);
--java2 since Debian 3.1 (Sarge);
--keyword since Debian 8 (Jessie);
--language since Debian 9 (Stretch);
--locale since Debian 3.1 (Sarge);
--no-convert since Debian 13 (Trixie);
--no-hash since Debian 3.0 (Woody);
--no-redundancy since Debian 13 (Trixie);
--output-file since Debian 3.0 (Woody);
--properties-input since Debian 3.1 (Sarge);
--qt since Debian 3.1 (Sarge);
--replace-text since Debian 13 (Trixie);
--resource since Debian 3.1 (Sarge);
--source since Debian 8 (Jessie);
--statistics since Debian 3.0 (Woody);
--strict since Debian 3.0 (Woody);
--stringtable-input since Debian 3.1 (Sarge);
--tcl since Debian 3.1 (Sarge);
--template since Debian 8 (Jessie);
--use-fuzzy since Debian 3.0 (Woody);
--verbose since Debian 3.0 (Woody);
--version since Debian 3.0 (Woody);
--xml since Debian 9 (Stretch);
-C since Debian 3.1 (Sarge);
-D since Debian 3.0 (Woody);
-L since Debian 9 (Stretch);
-P since Debian 3.1 (Sarge);
-V since Debian 3.0 (Woody);
-a since Debian 3.0 (Woody);
-c since Debian 3.0 (Woody);
-d since Debian 3.1 (Sarge);
-f since Debian 3.0 (Woody);
-h since Debian 3.0 (Woody);
-j since Debian 3.1 (Sarge);
-k since Debian 8 (Jessie);
-kWORD since Debian 8 (Jessie);
-l since Debian 3.1 (Sarge);
-o since Debian 3.0 (Woody);
-r since Debian 3.1 (Sarge).