comparison CSP2/CSP2_env/env-d9b9114564458d9d-741b3de822f2aaca6c6caa4325c4afce/share/doc/gettext/msgmerge.1.html @ 68:5028fdace37b

planemo upload commit 2e9511a184a1ca667c7be0c6321a36dc4e3d116d
author jpayne
date Tue, 18 Mar 2025 16:23:26 -0400
parents
children
comparison
equal deleted inserted replaced
67:0e9998148a16 68:5028fdace37b
1 <!-- Creator : groff version 1.22.3 -->
2 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
3 "http://www.w3.org/TR/html4/loose.dtd">
4 <html>
5 <head>
6 <meta name="generator" content="groff -Thtml, see www.gnu.org">
7 <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
8 <meta name="Content-Style" content="text/css">
9 <style type="text/css">
10 p { margin-top: 0; margin-bottom: 0; vertical-align: top }
11 pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
12 table { margin-top: 0; margin-bottom: 0; vertical-align: top }
13 h1 { text-align: center }
14 </style>
15 <title>MSGMERGE</title>
16
17 </head>
18 <body>
19
20 <h1 align="center">MSGMERGE</h1>
21
22 <a href="#NAME">NAME</a><br>
23 <a href="#SYNOPSIS">SYNOPSIS</a><br>
24 <a href="#DESCRIPTION">DESCRIPTION</a><br>
25 <a href="#AUTHOR">AUTHOR</a><br>
26 <a href="#REPORTING BUGS">REPORTING BUGS</a><br>
27 <a href="#COPYRIGHT">COPYRIGHT</a><br>
28 <a href="#SEE ALSO">SEE ALSO</a><br>
29
30 <hr>
31
32
33 <h2>NAME
34 <a name="NAME"></a>
35 </h2>
36
37
38 <p style="margin-left:11%; margin-top: 1em">msgmerge
39 - merge message catalog and template</p>
40
41 <h2>SYNOPSIS
42 <a name="SYNOPSIS"></a>
43 </h2>
44
45
46
47 <p style="margin-left:11%; margin-top: 1em"><b>msgmerge</b>
48 [<i>OPTION</i>] <i>def.po ref.pot</i></p>
49
50 <h2>DESCRIPTION
51 <a name="DESCRIPTION"></a>
52 </h2>
53
54
55 <p style="margin-left:11%; margin-top: 1em">Merges two
56 Uniforum style .po files together. The def.po file is an
57 existing PO file with translations which will be taken over
58 to the newly created file as long as they still match;
59 comments will be preserved, but extracted comments and file
60 positions will be discarded. The ref.pot file is the last
61 created PO file with up-to-date source
62 references but old translations, or a PO Template file
63 (generally created by xgettext); any translations or
64 comments in the file will be discarded, however dot comments
65 and file positions will be preserved. Where an exact match
66 cannot be found, fuzzy matching is used to produce better
67 results.</p>
68
69 <p style="margin-left:11%; margin-top: 1em">Mandatory
70 arguments to long options are mandatory for short options
71 too.</p>
72
73 <p style="margin-left:11%; margin-top: 1em"><b>Input file
74 location:</b></p>
75
76 <table width="100%" border="0" rules="none" frame="void"
77 cellspacing="0" cellpadding="0">
78 <tr valign="top" align="left">
79 <td width="11%"></td>
80 <td width="9%">
81
82
83 <p>def.po</p></td>
84 <td width="2%"></td>
85 <td width="56%">
86
87
88 <p>translations referring to old sources</p></td>
89 <td width="22%">
90 </td></tr>
91 </table>
92
93 <p style="margin-left:11%;">ref.pot</p>
94
95 <p style="margin-left:22%;">references to new sources</p>
96
97 <p style="margin-left:11%;"><b>-D</b>,
98 <b>--directory</b>=<i>DIRECTORY</i></p>
99
100 <p style="margin-left:22%;">add DIRECTORY to list for input
101 files search</p>
102
103 <p style="margin-left:11%;"><b>-C</b>,
104 <b>--compendium</b>=<i>FILE</i></p>
105
106 <p style="margin-left:22%;">additional library of message
107 translations, may be specified more than once</p>
108
109 <p style="margin-left:11%; margin-top: 1em"><b>Operation
110 mode: <br>
111 -U</b>, <b>--update</b></p>
112
113 <p style="margin-left:22%;">update def.po, do nothing if
114 def.po already up to date</p>
115
116 <p style="margin-left:11%; margin-top: 1em"><b>Output file
117 location: <br>
118 -o</b>,
119 <b>--output-file</b>=<i>FILE</i></p>
120
121 <p style="margin-left:22%;">write output to specified
122 file</p>
123
124 <p style="margin-left:11%; margin-top: 1em">The results are
125 written to standard output if no output file is specified or
126 if it is -.</p>
127
128 <p style="margin-left:11%; margin-top: 1em">Output file
129 location in update mode: The result is written back to
130 def.po. <b><br>
131 --backup</b>=<i>CONTROL</i></p>
132
133 <p style="margin-left:22%;">make a backup of def.po</p>
134
135
136 <p style="margin-left:11%;"><b>--suffix</b>=<i>SUFFIX</i></p>
137
138 <p style="margin-left:22%;">override the usual backup
139 suffix</p>
140
141 <p style="margin-left:11%; margin-top: 1em">The version
142 control method may be selected via the
143 <b>--backup</b> option or through the
144 VERSION_CONTROL environment variable. Here are the values:
145 <br>
146 none, off</p>
147
148 <p style="margin-left:22%;">never make backups (even if
149 <b>--backup</b> is given)</p>
150
151 <p style="margin-left:11%;">numbered, t</p>
152
153 <p style="margin-left:22%;">make numbered backups</p>
154
155 <p style="margin-left:11%;">existing, nil</p>
156
157 <p style="margin-left:22%;">numbered if numbered backups
158 exist, simple otherwise</p>
159
160 <p style="margin-left:11%;">simple, never</p>
161
162 <p style="margin-left:22%;">always make simple backups</p>
163
164 <p style="margin-left:11%; margin-top: 1em">The backup
165 suffix is &rsquo;~&rsquo;, unless set with
166 <b>--suffix</b> or the SIMPLE_BACKUP_SUFFIX
167 environment variable.</p>
168
169 <p style="margin-left:11%; margin-top: 1em"><b>Operation
170 modifiers: <br>
171 -m</b>, <b>--multi-domain</b></p>
172
173 <p style="margin-left:22%;">apply ref.pot to each of the
174 domains in def.po</p>
175
176
177 <p style="margin-left:11%;"><b>--for-msgfmt</b></p>
178
179 <p style="margin-left:22%;">produce output for
180 &rsquo;msgfmt&rsquo;, not for a translator</p>
181
182 <p style="margin-left:11%;"><b>-N</b>,
183 <b>--no-fuzzy-matching</b></p>
184
185 <p style="margin-left:22%;">do not use fuzzy matching</p>
186
187
188 <p style="margin-left:11%;"><b>--previous</b></p>
189
190 <p style="margin-left:22%;">keep previous msgids of
191 translated messages</p>
192
193 <p style="margin-left:11%; margin-top: 1em"><b>Input file
194 syntax: <br>
195 -P</b>,
196 <b>--properties-input</b></p>
197
198 <p style="margin-left:22%;">input files are in Java
199 .properties syntax</p>
200
201
202 <p style="margin-left:11%;"><b>--stringtable-input</b></p>
203
204 <p style="margin-left:22%;">input files are in
205 NeXTstep/GNUstep .strings syntax</p>
206
207 <p style="margin-left:11%; margin-top: 1em"><b>Output
208 details: <br>
209 --lang</b>=<i>CATALOGNAME</i></p>
210
211 <p style="margin-left:22%;">set &rsquo;Language&rsquo;
212 field in the header entry</p>
213
214 <p style="margin-left:11%;"><b>--color</b></p>
215
216 <p style="margin-left:22%;">use colors and other text
217 attributes always</p>
218
219
220 <p style="margin-left:11%;"><b>--color</b>=<i>WHEN</i></p>
221
222 <p style="margin-left:22%;">use colors and other text
223 attributes if WHEN. WHEN may be &rsquo;always&rsquo;,
224 &rsquo;never&rsquo;, &rsquo;auto&rsquo;, or
225 &rsquo;html&rsquo;.</p>
226
227
228 <p style="margin-left:11%;"><b>--style</b>=<i>STYLEFILE</i></p>
229
230 <p style="margin-left:22%;">specify CSS style rule file for
231 <b>--color</b></p>
232
233 <p style="margin-left:11%;"><b>-e</b>,
234 <b>--no-escape</b></p>
235
236 <p style="margin-left:22%;">do not use C escapes in output
237 (default)</p>
238
239 <p style="margin-left:11%;"><b>-E</b>,
240 <b>--escape</b></p>
241
242 <p style="margin-left:22%;">use C escapes in output, no
243 extended chars</p>
244
245
246 <p style="margin-left:11%;"><b>--force-po</b></p>
247
248 <p style="margin-left:22%;">write PO file even if empty</p>
249
250 <p style="margin-left:11%;"><b>-i</b>,
251 <b>--indent</b></p>
252
253 <p style="margin-left:22%;">indented output style</p>
254
255
256 <p style="margin-left:11%;"><b>--no-location</b></p>
257
258 <p style="margin-left:22%;">suppress &rsquo;#:
259 filename:line&rsquo; lines</p>
260
261 <p style="margin-left:11%;"><b>-n</b>,
262 <b>--add-location</b></p>
263
264 <p style="margin-left:22%;">preserve &rsquo;#:
265 filename:line&rsquo; lines (default)</p>
266
267
268 <p style="margin-left:11%;"><b>--strict</b></p>
269
270 <p style="margin-left:22%;">strict Uniforum output
271 style</p>
272
273 <p style="margin-left:11%;"><b>-p</b>,
274 <b>--properties-output</b></p>
275
276 <p style="margin-left:22%;">write out a Java .properties
277 file</p>
278
279
280 <p style="margin-left:11%;"><b>--stringtable-output</b></p>
281
282 <p style="margin-left:22%;">write out a NeXTstep/GNUstep
283 .strings file</p>
284
285 <p style="margin-left:11%;"><b>-w</b>,
286 <b>--width</b>=<i>NUMBER</i></p>
287
288 <p style="margin-left:22%;">set output page width</p>
289
290
291 <p style="margin-left:11%;"><b>--no-wrap</b></p>
292
293 <p style="margin-left:22%;">do not break long message
294 lines, longer than the output page width, into several
295 lines</p>
296
297 <p style="margin-left:11%;"><b>-s</b>,
298 <b>--sort-output</b></p>
299
300 <p style="margin-left:22%;">generate sorted output</p>
301
302 <p style="margin-left:11%;"><b>-F</b>,
303 <b>--sort-by-file</b></p>
304
305 <p style="margin-left:22%;">sort output by file
306 location</p>
307
308 <p style="margin-left:11%; margin-top: 1em"><b>Informative
309 output: <br>
310 -h</b>, <b>--help</b></p>
311
312 <p style="margin-left:22%;">display this help and exit</p>
313
314 <p style="margin-left:11%;"><b>-V</b>,
315 <b>--version</b></p>
316
317 <p style="margin-left:22%;">output version information and
318 exit</p>
319
320 <p style="margin-left:11%;"><b>-v</b>,
321 <b>--verbose</b></p>
322
323 <p style="margin-left:22%;">increase verbosity level</p>
324
325 <p style="margin-left:11%;"><b>-q</b>,
326 <b>--quiet</b>, <b>--silent</b></p>
327
328 <p style="margin-left:22%;">suppress progress
329 indicators</p>
330
331 <h2>AUTHOR
332 <a name="AUTHOR"></a>
333 </h2>
334
335
336 <p style="margin-left:11%; margin-top: 1em">Written by
337 Peter Miller.</p>
338
339 <h2>REPORTING BUGS
340 <a name="REPORTING BUGS"></a>
341 </h2>
342
343
344 <p style="margin-left:11%; margin-top: 1em">Report bugs in
345 the bug tracker at
346 &lt;https://savannah.gnu.org/projects/gettext&gt; or by
347 email to &lt;bug-gettext@gnu.org&gt;.</p>
348
349 <h2>COPYRIGHT
350 <a name="COPYRIGHT"></a>
351 </h2>
352
353
354 <p style="margin-left:11%; margin-top: 1em">Copyright
355 &copy; 1995-2023 Free Software Foundation, Inc.
356 License GPLv3+: GNU GPL version 3 or later
357 &lt;https://gnu.org/licenses/gpl.html&gt; <br>
358 This is free software: you are free to change and
359 redistribute it. There is NO WARRANTY, to the extent
360 permitted by law.</p>
361
362 <h2>SEE ALSO
363 <a name="SEE ALSO"></a>
364 </h2>
365
366
367 <p style="margin-left:11%; margin-top: 1em">The full
368 documentation for <b>msgmerge</b> is maintained as a Texinfo
369 manual. If the <b>info</b> and <b>msgmerge</b> programs are
370 properly installed at your site, the command</p>
371
372 <p style="margin-left:22%; margin-top: 1em"><b>info
373 msgmerge</b></p>
374
375 <p style="margin-left:11%; margin-top: 1em">should give you
376 access to the complete manual.</p>
377 <hr>
378 </body>
379 </html>