Add -lm dependency for gettextlib to fix LTO build
[platform/upstream/gettext.git] / gettext-tools / man / msgattrib.1.html
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>MSGATTRIB</title>
16
17 </head>
18 <body>
19
20 <h1 align="center">MSGATTRIB</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">msgattrib
39 &minus; attribute matching and manipulation on message
40 catalog</p>
41
42 <h2>SYNOPSIS
43 <a name="SYNOPSIS"></a>
44 </h2>
45
46
47
48 <p style="margin-left:11%; margin-top: 1em"><b>msgattrib</b>
49 [<i>OPTION</i>] [<i>INPUTFILE</i>]</p>
50
51 <h2>DESCRIPTION
52 <a name="DESCRIPTION"></a>
53 </h2>
54
55
56 <p style="margin-left:11%; margin-top: 1em">Filters the
57 messages of a translation catalog according to their
58 attributes, and manipulates the attributes.</p>
59
60 <p style="margin-left:11%; margin-top: 1em">Mandatory
61 arguments to long options are mandatory for short options
62 too.</p>
63
64 <p style="margin-left:11%; margin-top: 1em"><b>Input file
65 location:</b> <br>
66 INPUTFILE</p>
67
68 <p style="margin-left:22%;">input PO file</p>
69
70 <p style="margin-left:11%;"><b>&minus;D</b>,
71 <b>&minus;&minus;directory</b>=<i>DIRECTORY</i></p>
72
73 <p style="margin-left:22%;">add DIRECTORY to list for input
74 files search</p>
75
76 <p style="margin-left:11%; margin-top: 1em">If no input
77 file is given or if it is -, standard input is read.</p>
78
79 <p style="margin-left:11%; margin-top: 1em"><b>Output file
80 location: <br>
81 &minus;o</b>,
82 <b>&minus;&minus;output&minus;file</b>=<i>FILE</i></p>
83
84 <p style="margin-left:22%;">write output to specified
85 file</p>
86
87 <p style="margin-left:11%; margin-top: 1em">The results are
88 written to standard output if no output file is specified or
89 if it is -.</p>
90
91 <p style="margin-left:11%; margin-top: 1em"><b>Message
92 selection: <br>
93 &minus;&minus;translated</b></p>
94
95 <p style="margin-left:22%;">keep translated, remove
96 untranslated messages</p>
97
98
99 <p style="margin-left:11%;"><b>&minus;&minus;untranslated</b></p>
100
101 <p style="margin-left:22%;">keep untranslated, remove
102 translated messages</p>
103
104
105 <p style="margin-left:11%;"><b>&minus;&minus;no&minus;fuzzy</b></p>
106
107 <p style="margin-left:22%;">remove &rsquo;fuzzy&rsquo;
108 marked messages</p>
109
110
111 <p style="margin-left:11%;"><b>&minus;&minus;only&minus;fuzzy</b></p>
112
113 <p style="margin-left:22%;">keep &rsquo;fuzzy&rsquo; marked
114 messages</p>
115
116
117 <p style="margin-left:11%;"><b>&minus;&minus;no&minus;obsolete</b></p>
118
119 <p style="margin-left:22%;">remove obsolete #~ messages</p>
120
121
122 <p style="margin-left:11%;"><b>&minus;&minus;only&minus;obsolete</b></p>
123
124 <p style="margin-left:22%;">keep obsolete #~ messages</p>
125
126 <p style="margin-left:11%; margin-top: 1em"><b>Attribute
127 manipulation: <br>
128 &minus;&minus;set&minus;fuzzy</b></p>
129
130 <p style="margin-left:22%;">set all messages
131 &rsquo;fuzzy&rsquo;</p>
132
133
134 <p style="margin-left:11%;"><b>&minus;&minus;clear&minus;fuzzy</b></p>
135
136 <p style="margin-left:22%;">set all messages
137 non-&rsquo;fuzzy&rsquo;</p>
138
139
140 <p style="margin-left:11%;"><b>&minus;&minus;set&minus;obsolete</b></p>
141
142 <p style="margin-left:22%;">set all messages obsolete</p>
143
144
145 <p style="margin-left:11%;"><b>&minus;&minus;clear&minus;obsolete</b></p>
146
147 <p style="margin-left:22%;">set all messages
148 non-obsolete</p>
149
150
151 <p style="margin-left:11%;"><b>&minus;&minus;previous</b></p>
152
153 <p style="margin-left:22%;">when setting
154 &rsquo;fuzzy&rsquo;, keep previous msgids of translated
155 messages.</p>
156
157
158 <p style="margin-left:11%;"><b>&minus;&minus;clear&minus;previous</b></p>
159
160 <p style="margin-left:22%;">remove the &quot;previous
161 msgid&quot; from all messages</p>
162
163 <p style="margin-left:11%;"><b>&minus;&minus;empty</b></p>
164
165 <p style="margin-left:22%;">when removing
166 &rsquo;fuzzy&rsquo;, also set msgstr empty</p>
167
168
169 <p style="margin-left:11%;"><b>&minus;&minus;only&minus;file</b>=<i>FILE</i>.po</p>
170
171 <p style="margin-left:22%;">manipulate only entries listed
172 in FILE.po</p>
173
174
175 <p style="margin-left:11%;"><b>&minus;&minus;ignore&minus;file</b>=<i>FILE</i>.po</p>
176
177 <p style="margin-left:22%;">manipulate only entries not
178 listed in FILE.po</p>
179
180 <p style="margin-left:11%;"><b>&minus;&minus;fuzzy</b></p>
181
182 <p style="margin-left:22%;">synonym for
183 <b>&minus;&minus;only&minus;fuzzy
184 &minus;&minus;clear&minus;fuzzy</b></p>
185
186
187 <p style="margin-left:11%;"><b>&minus;&minus;obsolete</b></p>
188
189 <p style="margin-left:22%;">synonym for
190 <b>&minus;&minus;only&minus;obsolete
191 &minus;&minus;clear&minus;obsolete</b></p>
192
193 <p style="margin-left:11%; margin-top: 1em"><b>Input file
194 syntax: <br>
195 &minus;P</b>,
196 <b>&minus;&minus;properties&minus;input</b></p>
197
198 <p style="margin-left:22%;">input file is in Java
199 .properties syntax</p>
200
201
202 <p style="margin-left:11%;"><b>&minus;&minus;stringtable&minus;input</b></p>
203
204 <p style="margin-left:22%;">input file is in
205 NeXTstep/GNUstep .strings syntax</p>
206
207 <p style="margin-left:11%; margin-top: 1em"><b>Output
208 details: <br>
209 &minus;&minus;color</b></p>
210
211 <p style="margin-left:22%;">use colors and other text
212 attributes always</p>
213
214
215 <p style="margin-left:11%;"><b>&minus;&minus;color</b>=<i>WHEN</i></p>
216
217 <p style="margin-left:22%;">use colors and other text
218 attributes if WHEN. WHEN may be &rsquo;always&rsquo;,
219 &rsquo;never&rsquo;, &rsquo;auto&rsquo;, or
220 &rsquo;html&rsquo;.</p>
221
222
223 <p style="margin-left:11%;"><b>&minus;&minus;style</b>=<i>STYLEFILE</i></p>
224
225 <p style="margin-left:22%;">specify CSS style rule file for
226 <b>&minus;&minus;color</b></p>
227
228 <p style="margin-left:11%;"><b>&minus;e</b>,
229 <b>&minus;&minus;no&minus;escape</b></p>
230
231 <p style="margin-left:22%;">do not use C escapes in output
232 (default)</p>
233
234 <p style="margin-left:11%;"><b>&minus;E</b>,
235 <b>&minus;&minus;escape</b></p>
236
237 <p style="margin-left:22%;">use C escapes in output, no
238 extended chars</p>
239
240
241 <p style="margin-left:11%;"><b>&minus;&minus;force&minus;po</b></p>
242
243 <p style="margin-left:22%;">write PO file even if empty</p>
244
245 <p style="margin-left:11%;"><b>&minus;i</b>,
246 <b>&minus;&minus;indent</b></p>
247
248 <p style="margin-left:22%;">write the .po file using
249 indented style</p>
250
251
252 <p style="margin-left:11%;"><b>&minus;&minus;no&minus;location</b></p>
253
254 <p style="margin-left:22%;">do not write &rsquo;#:
255 filename:line&rsquo; lines</p>
256
257 <p style="margin-left:11%;"><b>&minus;n</b>,
258 <b>&minus;&minus;add&minus;location</b></p>
259
260 <p style="margin-left:22%;">generate &rsquo;#:
261 filename:line&rsquo; lines (default)</p>
262
263
264 <p style="margin-left:11%;"><b>&minus;&minus;strict</b></p>
265
266 <p style="margin-left:22%;">write out strict Uniforum
267 conforming .po file</p>
268
269 <p style="margin-left:11%;"><b>&minus;p</b>,
270 <b>&minus;&minus;properties&minus;output</b></p>
271
272 <p style="margin-left:22%;">write out a Java .properties
273 file</p>
274
275
276 <p style="margin-left:11%;"><b>&minus;&minus;stringtable&minus;output</b></p>
277
278 <p style="margin-left:22%;">write out a NeXTstep/GNUstep
279 .strings file</p>
280
281 <p style="margin-left:11%;"><b>&minus;w</b>,
282 <b>&minus;&minus;width</b>=<i>NUMBER</i></p>
283
284 <p style="margin-left:22%;">set output page width</p>
285
286
287 <p style="margin-left:11%;"><b>&minus;&minus;no&minus;wrap</b></p>
288
289 <p style="margin-left:22%;">do not break long message
290 lines, longer than the output page width, into several
291 lines</p>
292
293 <p style="margin-left:11%;"><b>&minus;s</b>,
294 <b>&minus;&minus;sort&minus;output</b></p>
295
296 <p style="margin-left:22%;">generate sorted output</p>
297
298 <p style="margin-left:11%;"><b>&minus;F</b>,
299 <b>&minus;&minus;sort&minus;by&minus;file</b></p>
300
301 <p style="margin-left:22%;">sort output by file
302 location</p>
303
304 <p style="margin-left:11%; margin-top: 1em"><b>Informative
305 output: <br>
306 &minus;h</b>, <b>&minus;&minus;help</b></p>
307
308 <p style="margin-left:22%;">display this help and exit</p>
309
310 <p style="margin-left:11%;"><b>&minus;V</b>,
311 <b>&minus;&minus;version</b></p>
312
313 <p style="margin-left:22%;">output version information and
314 exit</p>
315
316 <h2>AUTHOR
317 <a name="AUTHOR"></a>
318 </h2>
319
320
321 <p style="margin-left:11%; margin-top: 1em">Written by
322 Bruno Haible.</p>
323
324 <h2>REPORTING BUGS
325 <a name="REPORTING BUGS"></a>
326 </h2>
327
328
329 <p style="margin-left:11%; margin-top: 1em">Report bugs to
330 &lt;bug-gnu-gettext@gnu.org&gt;.</p>
331
332 <h2>COPYRIGHT
333 <a name="COPYRIGHT"></a>
334 </h2>
335
336
337 <p style="margin-left:11%; margin-top: 1em">Copyright
338 &copy; 2001-2010 Free Software Foundation, Inc. License
339 GPLv3+: GNU GPL version 3 or later
340 &lt;http://gnu.org/licenses/gpl.html&gt; <br>
341 This is free software: you are free to change and
342 redistribute it. There is NO WARRANTY, to the extent
343 permitted by law.</p>
344
345 <h2>SEE ALSO
346 <a name="SEE ALSO"></a>
347 </h2>
348
349
350 <p style="margin-left:11%; margin-top: 1em">The full
351 documentation for <b>msgattrib</b> is maintained as a
352 Texinfo manual. If the <b>info</b> and <b>msgattrib</b>
353 programs are properly installed at your site, the
354 command</p>
355
356 <p style="margin-left:22%; margin-top: 1em"><b>info
357 msgattrib</b></p>
358
359 <p style="margin-left:11%; margin-top: 1em">should give you
360 access to the complete manual.</p>
361 <hr>
362 </body>
363 </html>