Debian Codegraph @

upstream/debian-unstable/man1/msgfmt.1

raw
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.