Scroll to navigation

MSGFMT(1) GNU MSGFMT(1)

NAME

msgfmt - compile message catalog to binary format

SYNOPSIS

msgfmt [OPTION] filename.po ...

DESCRIPTION

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:

input files
add DIRECTORY to list for input files search

If input file is -, standard input is read.

Operation mode:

Java mode: generate a Java ResourceBundle class
like --java, and assume Java2 (JDK 1.2 or higher)
C# mode: generate a .NET .dll file
C# resources mode: generate a .NET .resources file
Tcl mode: generate a tcl/msgcat .msg file
Qt mode: generate a Qt .qm file

Output file location:

write output to specified file
enable strict Uniforum mode

If output file is -, output is written to standard output.

Output file location in Java mode:

resource name
locale name, either language or language_COUNTRY
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:

resource name
locale name, either language or language_COUNTRY
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:

locale name, either language or language_COUNTRY
base directory of .msg message catalogs

The -l and -d options are mandatory. The .msg file is written in the specified directory.

Input file syntax:

input files are in Java .properties syntax
input files are in NeXTstep/GNUstep .strings syntax

Input file interpretation:

perform all the checks implied by --check-format, --check-header, --check-domain
check language dependent format strings
verify presence and contents of the header entry
check for conflicts between domain directives and the --output-file option
check that GNU msgfmt behaves like X/Open msgfmt
check presence of keyboard accelerators for menu items
use fuzzy entries in output

Output details:

align strings to NUMBER bytes (default: 1)
binary file will not include the hash table

Informative output:

display this help and exit
output version information and exit
print statistics about translations
increase verbosity level

AUTHOR

Written by Ulrich Drepper.

REPORTING BUGS

Report bugs to <bug-gnu-gettext@gnu.org>.

COPYRIGHT

Copyright © 1995-1998, 2000-2007 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

SEE ALSO

The full documentation for msgfmt is maintained as a Texinfo manual. If the info and msgfmt programs are properly installed at your site, the command

info msgfmt

should give you access to the complete manual.

November 2007 GNU gettext-tools 0.17