| 1 |
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.6. |
| 2 |
.TH MSGFMT "1" "July 2025" "GNU gettext-tools 0.26" "User Commands" |
| 3 |
.SH NAME |
| 4 |
msgfmt \- compile message catalog to binary format |
| 5 |
.SH SYNOPSIS |
| 6 |
.B msgfmt |
| 7 |
[\fI\,OPTION\/\fR] \fI\,filename.po \/\fR... |
| 8 |
.SH DESCRIPTION |
| 9 |
.\" Add any additional description here |
| 10 |
.PP |
| 11 |
Generate binary message catalog from textual translation description. |
| 12 |
.PP |
| 13 |
Mandatory arguments to long options are mandatory for short options too. |
| 14 |
Similarly for optional arguments. |
| 15 |
.SS "Input file location:" |
| 16 |
.TP |
| 17 |
filename.po ... |
| 18 |
input files |
| 19 |
.TP |
| 20 |
\fB\-D\fR, \fB\-\-directory\fR=\fI\,DIRECTORY\/\fR |
| 21 |
add DIRECTORY to list for input files search |
| 22 |
.PP |
| 23 |
If input file is \-, standard input is read. |
| 24 |
.SS "Operation mode:" |
| 25 |
.TP |
| 26 |
\fB\-j\fR, \fB\-\-java\fR |
| 27 |
Java mode: generate a Java ResourceBundle class |
| 28 |
.TP |
| 29 |
\fB\-\-java2\fR |
| 30 |
like \fB\-\-java\fR, and assume Java2 (JDK 1.2 or higher) |
| 31 |
.TP |
| 32 |
\fB\-\-csharp\fR |
| 33 |
C# mode: generate a .NET .dll file |
| 34 |
.TP |
| 35 |
\fB\-\-csharp\-resources\fR |
| 36 |
C# resources mode: generate a .NET .resources file |
| 37 |
.TP |
| 38 |
\fB\-\-tcl\fR |
| 39 |
Tcl mode: generate a tcl/msgcat .msg file |
| 40 |
.TP |
| 41 |
\fB\-\-qt\fR |
| 42 |
Qt mode: generate a Qt .qm file |
| 43 |
.TP |
| 44 |
\fB\-\-desktop\fR |
| 45 |
Desktop Entry mode: generate a .desktop file |
| 46 |
.TP |
| 47 |
\fB\-\-xml\fR |
| 48 |
XML mode: generate XML file |
| 49 |
.SS "Output file location:" |
| 50 |
.TP |
| 51 |
\fB\-o\fR, \fB\-\-output\-file\fR=\fI\,FILE\/\fR |
| 52 |
write output to specified file |
| 53 |
.TP |
| 54 |
\fB\-\-strict\fR |
| 55 |
enable strict Uniforum mode |
| 56 |
.PP |
| 57 |
If output file is \-, output is written to standard output. |
| 58 |
.SS "Output file location in Java mode:" |
| 59 |
.TP |
| 60 |
\fB\-r\fR, \fB\-\-resource\fR=\fI\,RESOURCE\/\fR |
| 61 |
resource name |
| 62 |
.TP |
| 63 |
\fB\-l\fR, \fB\-\-locale\fR=\fI\,LOCALE\/\fR |
| 64 |
locale name, either language or language_COUNTRY |
| 65 |
.TP |
| 66 |
\fB\-\-source\fR |
| 67 |
produce a .java file, instead of a .class file |
| 68 |
.TP |
| 69 |
\fB\-d\fR DIRECTORY |
| 70 |
base directory of classes directory hierarchy |
| 71 |
.PP |
| 72 |
The class name is determined by appending the locale name to the resource name, |
| 73 |
separated with an underscore. The \fB\-d\fR option is mandatory. The class is |
| 74 |
written under the specified directory. |
| 75 |
.SS "Output file location in C# mode:" |
| 76 |
.TP |
| 77 |
\fB\-r\fR, \fB\-\-resource\fR=\fI\,RESOURCE\/\fR |
| 78 |
resource name |
| 79 |
.TP |
| 80 |
\fB\-l\fR, \fB\-\-locale\fR=\fI\,LOCALE\/\fR |
| 81 |
locale name, either language or language_COUNTRY |
| 82 |
.TP |
| 83 |
\fB\-d\fR DIRECTORY |
| 84 |
base directory for locale dependent .dll files |
| 85 |
.PP |
| 86 |
The \fB\-l\fR and \fB\-d\fR options are mandatory. The .dll file is written in a |
| 87 |
subdirectory of the specified directory whose name depends on the locale. |
| 88 |
.SS "Output file location in Tcl mode:" |
| 89 |
.TP |
| 90 |
\fB\-l\fR, \fB\-\-locale\fR=\fI\,LOCALE\/\fR |
| 91 |
locale name, either language or language_COUNTRY |
| 92 |
.TP |
| 93 |
\fB\-d\fR DIRECTORY |
| 94 |
base directory of .msg message catalogs |
| 95 |
.PP |
| 96 |
The \fB\-l\fR and \fB\-d\fR options are mandatory. The .msg file is written in the |
| 97 |
specified directory. |
| 98 |
.SS "Desktop Entry mode options:" |
| 99 |
.TP |
| 100 |
\fB\-l\fR, \fB\-\-locale\fR=\fI\,LOCALE\/\fR |
| 101 |
locale name, either language or language_COUNTRY |
| 102 |
.TP |
| 103 |
\fB\-o\fR, \fB\-\-output\-file\fR=\fI\,FILE\/\fR |
| 104 |
write output to specified file |
| 105 |
.TP |
| 106 |
\fB\-\-template\fR=\fI\,TEMPLATE\/\fR |
| 107 |
a .desktop file used as a template |
| 108 |
.TP |
| 109 |
\fB\-d\fR DIRECTORY |
| 110 |
base directory of .po files |
| 111 |
.TP |
| 112 |
\fB\-kWORD\fR, \fB\-\-keyword\fR=\fI\,WORD\/\fR |
| 113 |
look for WORD as an additional keyword |
| 114 |
.TP |
| 115 |
\fB\-k\fR, \fB\-\-keyword\fR |
| 116 |
do not to use default keywords |
| 117 |
.PP |
| 118 |
The \fB\-l\fR, \fB\-o\fR, and \fB\-\-template\fR options are mandatory. If \fB\-D\fR is specified, input |
| 119 |
files are read from the directory instead of the command line arguments. |
| 120 |
.SS "XML mode options:" |
| 121 |
.TP |
| 122 |
\fB\-l\fR, \fB\-\-locale\fR=\fI\,LOCALE\/\fR |
| 123 |
locale name, either language or language_COUNTRY |
| 124 |
.TP |
| 125 |
\fB\-L\fR, \fB\-\-language\fR=\fI\,NAME\/\fR |
| 126 |
recognise the specified XML language |
| 127 |
.TP |
| 128 |
\fB\-o\fR, \fB\-\-output\-file\fR=\fI\,FILE\/\fR |
| 129 |
write output to specified file |
| 130 |
.TP |
| 131 |
\fB\-\-template\fR=\fI\,TEMPLATE\/\fR |
| 132 |
an XML file used as a template |
| 133 |
.TP |
| 134 |
\fB\-d\fR DIRECTORY |
| 135 |
base directory of .po files |
| 136 |
.TP |
| 137 |
\fB\-\-replace\-text\fR |
| 138 |
output XML with translated text replacing the |
| 139 |
original text, not augmenting the original text |
| 140 |
.PP |
| 141 |
The \fB\-l\fR, \fB\-o\fR, and \fB\-\-template\fR options are mandatory. If \fB\-D\fR is specified, input |
| 142 |
files are read from the directory instead of the command line arguments. |
| 143 |
.SS "Input file syntax:" |
| 144 |
.TP |
| 145 |
\fB\-P\fR, \fB\-\-properties\-input\fR |
| 146 |
input files are in Java .properties syntax |
| 147 |
.TP |
| 148 |
\fB\-\-stringtable\-input\fR |
| 149 |
input files are in NeXTstep/GNUstep .strings |
| 150 |
syntax |
| 151 |
.SS "Input file interpretation:" |
| 152 |
.TP |
| 153 |
\fB\-c\fR, \fB\-\-check\fR |
| 154 |
perform all the checks implied by |
| 155 |
\fB\-\-check\-format\fR, \fB\-\-check\-header\fR, \fB\-\-check\-domain\fR |
| 156 |
.TP |
| 157 |
\fB\-\-check\-format\fR |
| 158 |
check language dependent format strings |
| 159 |
.TP |
| 160 |
\fB\-\-check\-header\fR |
| 161 |
verify presence and contents of the header entry |
| 162 |
.TP |
| 163 |
\fB\-\-check\-domain\fR |
| 164 |
check for conflicts between domain directives |
| 165 |
and the \fB\-\-output\-file\fR option |
| 166 |
.TP |
| 167 |
\fB\-C\fR, \fB\-\-check\-compatibility\fR |
| 168 |
check that GNU msgfmt behaves like X/Open msgfmt |
| 169 |
.TP |
| 170 |
\fB\-\-check\-accelerators\fR[=\fI\,CHAR\/\fR] |
| 171 |
check presence of keyboard accelerators for |
| 172 |
menu items |
| 173 |
.TP |
| 174 |
\fB\-f\fR, \fB\-\-use\-fuzzy\fR |
| 175 |
use fuzzy entries in output |
| 176 |
.SS "Output details:" |
| 177 |
.TP |
| 178 |
\fB\-\-no\-convert\fR |
| 179 |
don't convert the messages to UTF\-8 encoding |
| 180 |
.TP |
| 181 |
\fB\-\-no\-redundancy\fR |
| 182 |
don't pre\-expand ISO C 99 <inttypes.h> |
| 183 |
format string directive macros |
| 184 |
.TP |
| 185 |
\fB\-a\fR, \fB\-\-alignment\fR=\fI\,NUMBER\/\fR |
| 186 |
align strings to NUMBER bytes (default: 1) |
| 187 |
.TP |
| 188 |
\fB\-\-endianness\fR=\fI\,BYTEORDER\/\fR |
| 189 |
write out 32\-bit numbers in the given byte order |
| 190 |
(big or little, default depends on platform) |
| 191 |
.TP |
| 192 |
\fB\-\-no\-hash\fR |
| 193 |
binary file will not include the hash table |
| 194 |
.SS "Informative output:" |
| 195 |
.TP |
| 196 |
\fB\-h\fR, \fB\-\-help\fR |
| 197 |
display this help and exit |
| 198 |
.TP |
| 199 |
\fB\-V\fR, \fB\-\-version\fR |
| 200 |
output version information and exit |
| 201 |
.TP |
| 202 |
\fB\-\-statistics\fR |
| 203 |
print statistics about translations |
| 204 |
.TP |
| 205 |
\fB\-v\fR, \fB\-\-verbose\fR |
| 206 |
increase verbosity level |
| 207 |
.SH AUTHOR |
| 208 |
Written by Ulrich Drepper. |
| 209 |
.SH "REPORTING BUGS" |
| 210 |
Report bugs in the bug tracker at <https://savannah.gnu.org/projects/gettext> |
| 211 |
or by email to <bug\[email protected]>. |
| 212 |
.SH COPYRIGHT |
| 213 |
Copyright \(co 1995\-2025 Free Software Foundation, Inc. |
| 214 |
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html> |
| 215 |
.br |
| 216 |
This is free software: you are free to change and redistribute it. |
| 217 |
There is NO WARRANTY, to the extent permitted by law. |
| 218 |
.SH "SEE ALSO" |
| 219 |
The full documentation for |
| 220 |
.B msgfmt |
| 221 |
is maintained as a Texinfo manual. If the |
| 222 |
.B info |
| 223 |
and |
| 224 |
.B msgfmt |
| 225 |
programs are properly installed at your site, the command |
| 226 |
.IP |
| 227 |
.B info msgfmt |
| 228 |
.PP |
| 229 |
should give you access to the complete manual. |