xref: /netbsd-src/external/gpl2/gettext/dist/gettext-tools/man/msgen.1.html (revision 946379e7b37692fc43f68eb0d1c10daa0a7f3b6c)
1*946379e7Schristos<html>
2*946379e7Schristos<head>
3*946379e7Schristos<meta name="generator" content="groff -Thtml, see www.gnu.org">
4*946379e7Schristos<meta name="Content-Style" content="text/css">
5*946379e7Schristos<title>MSGEN</title>
6*946379e7Schristos</head>
7*946379e7Schristos<body>
8*946379e7Schristos
9*946379e7Schristos<h1 align=center>MSGEN</h1>
10*946379e7Schristos<a href="#NAME">NAME</a><br>
11*946379e7Schristos<a href="#SYNOPSIS">SYNOPSIS</a><br>
12*946379e7Schristos<a href="#DESCRIPTION">DESCRIPTION</a><br>
13*946379e7Schristos<a href="#AUTHOR">AUTHOR</a><br>
14*946379e7Schristos<a href="#REPORTING BUGS">REPORTING BUGS</a><br>
15*946379e7Schristos<a href="#COPYRIGHT">COPYRIGHT</a><br>
16*946379e7Schristos<a href="#SEE ALSO">SEE ALSO</a><br>
17*946379e7Schristos
18*946379e7Schristos<hr>
19*946379e7Schristos<!-- Creator     : groff version 1.17.2 -->
20*946379e7Schristos<a name="NAME"></a>
21*946379e7Schristos<h2>NAME</h2>
22*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
23*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
24*946379e7Schristos<tr valign="top" align="left">
25*946379e7Schristos<td width="10%"></td><td width="90%">
26*946379e7Schristosmsgen - create English message catalog</td></table>
27*946379e7Schristos<a name="SYNOPSIS"></a>
28*946379e7Schristos<h2>SYNOPSIS</h2>
29*946379e7Schristos
30*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
31*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
32*946379e7Schristos<tr valign="top" align="left">
33*946379e7Schristos<td width="10%"></td><td width="90%">
34*946379e7Schristos<b>msgen</b> [<i>OPTION</i>] <i>INPUTFILE</i></td></table>
35*946379e7Schristos<a name="DESCRIPTION"></a>
36*946379e7Schristos<h2>DESCRIPTION</h2>
37*946379e7Schristos
38*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
39*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
40*946379e7Schristos<tr valign="top" align="left">
41*946379e7Schristos<td width="10%"></td><td width="90%">
42*946379e7SchristosCreates an English translation catalog. The input file is
43*946379e7Schristosthe last created English PO file, or a PO Template file
44*946379e7Schristos(generally created by xgettext). Untranslated entries are
45*946379e7Schristosassigned a translation that is identical to the
46*946379e7Schristosmsgid.</td></table>
47*946379e7Schristos
48*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
49*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
50*946379e7Schristos<tr valign="top" align="left">
51*946379e7Schristos<td width="10%"></td><td width="90%">
52*946379e7SchristosMandatory arguments to long options are mandatory for short
53*946379e7Schristosoptions too.</td></table>
54*946379e7Schristos
55*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
56*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
57*946379e7Schristos<tr valign="top" align="left">
58*946379e7Schristos<td width="4%"></td><td width="96%">
59*946379e7Schristos<b>Input file location:</b></td></table>
60*946379e7Schristos
61*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
62*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
63*946379e7Schristos<tr valign="top" align="left">
64*946379e7Schristos<td width="10%"></td><td width="90%">
65*946379e7SchristosINPUTFILE</td></table>
66*946379e7Schristos
67*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
68*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
69*946379e7Schristos<tr valign="top" align="left">
70*946379e7Schristos<td width="21%"></td><td width="79%">
71*946379e7Schristosinput PO or POT file</td></table>
72*946379e7Schristos
73*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
74*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
75*946379e7Schristos<tr valign="top" align="left">
76*946379e7Schristos<td width="10%"></td><td width="90%">
77*946379e7Schristos<b>-D</b>, <b>--directory</b>=<i>DIRECTORY</i></td></table>
78*946379e7Schristos
79*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
80*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
81*946379e7Schristos<tr valign="top" align="left">
82*946379e7Schristos<td width="21%"></td><td width="79%">
83*946379e7Schristosadd DIRECTORY to list for input files search</td></table>
84*946379e7Schristos
85*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
86*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
87*946379e7Schristos<tr valign="top" align="left">
88*946379e7Schristos<td width="10%"></td><td width="90%">
89*946379e7SchristosIf input file is -, standard input is read.</td></table>
90*946379e7Schristos
91*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
92*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
93*946379e7Schristos<tr valign="top" align="left">
94*946379e7Schristos<td width="4%"></td><td width="96%">
95*946379e7Schristos<b>Output file location:</b></td></table>
96*946379e7Schristos
97*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
98*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
99*946379e7Schristos<tr valign="top" align="left">
100*946379e7Schristos<td width="10%"></td><td width="90%">
101*946379e7Schristos<b>-o</b>, <b>--output-file</b>=<i>FILE</i></td></table>
102*946379e7Schristos
103*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
104*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
105*946379e7Schristos<tr valign="top" align="left">
106*946379e7Schristos<td width="21%"></td><td width="79%">
107*946379e7Schristoswrite output to specified file</td></table>
108*946379e7Schristos
109*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
110*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
111*946379e7Schristos<tr valign="top" align="left">
112*946379e7Schristos<td width="10%"></td><td width="90%">
113*946379e7SchristosThe results are written to standard output if no output file
114*946379e7Schristosis specified or if it is -.</td></table>
115*946379e7Schristos
116*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
117*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
118*946379e7Schristos<tr valign="top" align="left">
119*946379e7Schristos<td width="4%"></td><td width="96%">
120*946379e7Schristos<b>Input file syntax:</b></td></table>
121*946379e7Schristos
122*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
123*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
124*946379e7Schristos<tr valign="top" align="left">
125*946379e7Schristos<td width="10%"></td><td width="90%">
126*946379e7Schristos<b>-P</b>, <b>--properties-input</b></td></table>
127*946379e7Schristos
128*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
129*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
130*946379e7Schristos<tr valign="top" align="left">
131*946379e7Schristos<td width="21%"></td><td width="79%">
132*946379e7Schristosinput file is in Java .properties syntax</td></table>
133*946379e7Schristos
134*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
135*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
136*946379e7Schristos<tr valign="top" align="left">
137*946379e7Schristos<td width="10%"></td><td width="90%">
138*946379e7Schristos<b>--stringtable-input</b></td></table>
139*946379e7Schristos
140*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
141*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
142*946379e7Schristos<tr valign="top" align="left">
143*946379e7Schristos<td width="21%"></td><td width="79%">
144*946379e7Schristosinput file is in NeXTstep/GNUstep .strings
145*946379e7Schristossyntax</td></table>
146*946379e7Schristos
147*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
148*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
149*946379e7Schristos<tr valign="top" align="left">
150*946379e7Schristos<td width="4%"></td><td width="96%">
151*946379e7Schristos<b>Output details:</b></td></table>
152*946379e7Schristos
153*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
154*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
155*946379e7Schristos<tr valign="top" align="left">
156*946379e7Schristos<td width="10%"></td><td width="90%">
157*946379e7Schristos<b>-e</b>, <b>--no-escape</b></td></table>
158*946379e7Schristos
159*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
160*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
161*946379e7Schristos<tr valign="top" align="left">
162*946379e7Schristos<td width="21%"></td><td width="79%">
163*946379e7Schristosdo not use C escapes in output (default)</td></table>
164*946379e7Schristos
165*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
166*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
167*946379e7Schristos<tr valign="top" align="left">
168*946379e7Schristos<td width="10%"></td><td width="90%">
169*946379e7Schristos<b>-E</b>, <b>--escape</b></td></table>
170*946379e7Schristos
171*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
172*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
173*946379e7Schristos<tr valign="top" align="left">
174*946379e7Schristos<td width="21%"></td><td width="79%">
175*946379e7Schristosuse C escapes in output, no extended chars</td></table>
176*946379e7Schristos
177*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
178*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
179*946379e7Schristos<tr valign="top" align="left">
180*946379e7Schristos<td width="10%"></td><td width="90%">
181*946379e7Schristos<b>--force-po</b></td></table>
182*946379e7Schristos
183*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
184*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
185*946379e7Schristos<tr valign="top" align="left">
186*946379e7Schristos<td width="21%"></td><td width="79%">
187*946379e7Schristoswrite PO file even if empty</td></table>
188*946379e7Schristos
189*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
190*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
191*946379e7Schristos<tr valign="top" align="left">
192*946379e7Schristos<td width="10%"></td><td width="90%">
193*946379e7Schristos<b>-i</b>, <b>--indent</b></td></table>
194*946379e7Schristos
195*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
196*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
197*946379e7Schristos<tr valign="top" align="left">
198*946379e7Schristos<td width="21%"></td><td width="79%">
199*946379e7Schristosindented output style</td></table>
200*946379e7Schristos
201*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
202*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
203*946379e7Schristos<tr valign="top" align="left">
204*946379e7Schristos<td width="10%"></td><td width="90%">
205*946379e7Schristos<b>--no-location</b></td></table>
206*946379e7Schristos
207*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
208*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
209*946379e7Schristos<tr valign="top" align="left">
210*946379e7Schristos<td width="21%"></td><td width="79%">
211*946379e7Schristossuppress '#: filename:line' lines</td></table>
212*946379e7Schristos
213*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
214*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
215*946379e7Schristos<tr valign="top" align="left">
216*946379e7Schristos<td width="10%"></td><td width="90%">
217*946379e7Schristos<b>--add-location</b></td></table>
218*946379e7Schristos
219*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
220*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
221*946379e7Schristos<tr valign="top" align="left">
222*946379e7Schristos<td width="21%"></td><td width="79%">
223*946379e7Schristospreserve '#: filename:line' lines (default)</td></table>
224*946379e7Schristos
225*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
226*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
227*946379e7Schristos<tr valign="top" align="left">
228*946379e7Schristos<td width="10%"></td><td width="90%">
229*946379e7Schristos<b>--strict</b></td></table>
230*946379e7Schristos
231*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
232*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
233*946379e7Schristos<tr valign="top" align="left">
234*946379e7Schristos<td width="21%"></td><td width="79%">
235*946379e7Schristosstrict Uniforum output style</td></table>
236*946379e7Schristos
237*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
238*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
239*946379e7Schristos<tr valign="top" align="left">
240*946379e7Schristos<td width="10%"></td><td width="90%">
241*946379e7Schristos<b>-p</b>, <b>--properties-output</b></td></table>
242*946379e7Schristos
243*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
244*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
245*946379e7Schristos<tr valign="top" align="left">
246*946379e7Schristos<td width="21%"></td><td width="79%">
247*946379e7Schristoswrite out a Java .properties file</td></table>
248*946379e7Schristos
249*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
250*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
251*946379e7Schristos<tr valign="top" align="left">
252*946379e7Schristos<td width="10%"></td><td width="90%">
253*946379e7Schristos<b>--stringtable-output</b></td></table>
254*946379e7Schristos
255*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
256*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
257*946379e7Schristos<tr valign="top" align="left">
258*946379e7Schristos<td width="21%"></td><td width="79%">
259*946379e7Schristoswrite out a NeXTstep/GNUstep .strings file</td></table>
260*946379e7Schristos
261*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
262*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
263*946379e7Schristos<tr valign="top" align="left">
264*946379e7Schristos<td width="10%"></td><td width="90%">
265*946379e7Schristos<b>-w</b>, <b>--width</b>=<i>NUMBER</i></td></table>
266*946379e7Schristos
267*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
268*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
269*946379e7Schristos<tr valign="top" align="left">
270*946379e7Schristos<td width="21%"></td><td width="79%">
271*946379e7Schristosset output page width</td></table>
272*946379e7Schristos
273*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
274*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
275*946379e7Schristos<tr valign="top" align="left">
276*946379e7Schristos<td width="10%"></td><td width="90%">
277*946379e7Schristos<b>--no-wrap</b></td></table>
278*946379e7Schristos
279*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
280*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
281*946379e7Schristos<tr valign="top" align="left">
282*946379e7Schristos<td width="21%"></td><td width="79%">
283*946379e7Schristosdo not break long message lines, longer than the output page
284*946379e7Schristoswidth, into several lines</td></table>
285*946379e7Schristos
286*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
287*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
288*946379e7Schristos<tr valign="top" align="left">
289*946379e7Schristos<td width="10%"></td><td width="90%">
290*946379e7Schristos<b>-s</b>, <b>--sort-output</b></td></table>
291*946379e7Schristos
292*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
293*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
294*946379e7Schristos<tr valign="top" align="left">
295*946379e7Schristos<td width="21%"></td><td width="79%">
296*946379e7Schristosgenerate sorted output</td></table>
297*946379e7Schristos
298*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
299*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
300*946379e7Schristos<tr valign="top" align="left">
301*946379e7Schristos<td width="10%"></td><td width="90%">
302*946379e7Schristos<b>-F</b>, <b>--sort-by-file</b></td></table>
303*946379e7Schristos
304*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
305*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
306*946379e7Schristos<tr valign="top" align="left">
307*946379e7Schristos<td width="21%"></td><td width="79%">
308*946379e7Schristossort output by file location</td></table>
309*946379e7Schristos
310*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
311*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
312*946379e7Schristos<tr valign="top" align="left">
313*946379e7Schristos<td width="4%"></td><td width="96%">
314*946379e7Schristos<b>Informative output:</b></td></table>
315*946379e7Schristos
316*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
317*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
318*946379e7Schristos<tr valign="top" align="left">
319*946379e7Schristos<td width="10%"></td><td width="90%">
320*946379e7Schristos<b>-h</b>, <b>--help</b></td></table>
321*946379e7Schristos
322*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
323*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
324*946379e7Schristos<tr valign="top" align="left">
325*946379e7Schristos<td width="21%"></td><td width="79%">
326*946379e7Schristosdisplay this help and exit</td></table>
327*946379e7Schristos
328*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
329*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
330*946379e7Schristos<tr valign="top" align="left">
331*946379e7Schristos<td width="10%"></td><td width="90%">
332*946379e7Schristos<b>-V</b>, <b>--version</b></td></table>
333*946379e7Schristos
334*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
335*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
336*946379e7Schristos<tr valign="top" align="left">
337*946379e7Schristos<td width="21%"></td><td width="79%">
338*946379e7Schristosoutput version information and exit</td></table>
339*946379e7Schristos<a name="AUTHOR"></a>
340*946379e7Schristos<h2>AUTHOR</h2>
341*946379e7Schristos
342*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
343*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
344*946379e7Schristos<tr valign="top" align="left">
345*946379e7Schristos<td width="10%"></td><td width="90%">
346*946379e7SchristosWritten by Bruno Haible.</td></table>
347*946379e7Schristos<a name="REPORTING BUGS"></a>
348*946379e7Schristos<h2>REPORTING BUGS</h2>
349*946379e7Schristos
350*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
351*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
352*946379e7Schristos<tr valign="top" align="left">
353*946379e7Schristos<td width="10%"></td><td width="90%">
354*946379e7SchristosReport bugs to &lt;bug-gnu-gettext@gnu.org&gt;.</td></table>
355*946379e7Schristos<a name="COPYRIGHT"></a>
356*946379e7Schristos<h2>COPYRIGHT</h2>
357*946379e7Schristos
358*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
359*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
360*946379e7Schristos<tr valign="top" align="left">
361*946379e7Schristos<td width="10%"></td><td width="90%">
362*946379e7SchristosCopyright 2001-2006 Free Software Foundation, Inc.<br>
363*946379e7SchristosThis is free software; see the source for copying
364*946379e7Schristosconditions. There is NO warranty; not even for
365*946379e7SchristosMERCHANTABILITY or FITNESS FOR A PARTICULAR
366*946379e7SchristosPURPOSE.</td></table>
367*946379e7Schristos<a name="SEE ALSO"></a>
368*946379e7Schristos<h2>SEE ALSO</h2>
369*946379e7Schristos
370*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
371*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
372*946379e7Schristos<tr valign="top" align="left">
373*946379e7Schristos<td width="10%"></td><td width="90%">
374*946379e7SchristosThe full documentation for <b>msgen</b> is maintained as a
375*946379e7SchristosTexinfo manual. If the <b>info</b> and <b>msgen</b> programs
376*946379e7Schristosare properly installed at your site, the
377*946379e7Schristoscommand</td></table>
378*946379e7Schristos
379*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
380*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
381*946379e7Schristos<tr valign="top" align="left">
382*946379e7Schristos<td width="21%"></td><td width="79%">
383*946379e7Schristos<b>info msgen</b></td></table>
384*946379e7Schristos
385*946379e7Schristos<table width="100%" border=0 rules="none" frame="void"
386*946379e7Schristos       cols="2" cellspacing="0" cellpadding="0">
387*946379e7Schristos<tr valign="top" align="left">
388*946379e7Schristos<td width="10%"></td><td width="90%">
389*946379e7Schristosshould give you access to the complete manual.</td></table>
390*946379e7Schristos<hr>
391*946379e7Schristos</body>
392*946379e7Schristos</html>
393