No empty .Rs/.Re
[netbsd-mini2440.git] / gnu / dist / gettext / gettext-tools / man / msggrep.1.html
blob686f959fd14c9797da386ae17097b54b3479c4bf
1 <html>
2 <head>
3 <meta name="generator" content="groff -Thtml, see www.gnu.org">
4 <meta name="Content-Style" content="text/css">
5 <title>MSGGREP</title>
6 </head>
7 <body>
9 <h1 align=center>MSGGREP</h1>
10 <a href="#NAME">NAME</a><br>
11 <a href="#SYNOPSIS">SYNOPSIS</a><br>
12 <a href="#DESCRIPTION">DESCRIPTION</a><br>
13 <a href="#AUTHOR">AUTHOR</a><br>
14 <a href="#REPORTING BUGS">REPORTING BUGS</a><br>
15 <a href="#COPYRIGHT">COPYRIGHT</a><br>
16 <a href="#SEE ALSO">SEE ALSO</a><br>
18 <hr>
19 <!-- Creator : groff version 1.17.2 -->
20 <a name="NAME"></a>
21 <h2>NAME</h2>
22 <table width="100%" border=0 rules="none" frame="void"
23 cols="2" cellspacing="0" cellpadding="0">
24 <tr valign="top" align="left">
25 <td width="10%"></td><td width="90%">
26 msggrep - pattern matching on message catalog</td></table>
27 <a name="SYNOPSIS"></a>
28 <h2>SYNOPSIS</h2>
30 <table width="100%" border=0 rules="none" frame="void"
31 cols="2" cellspacing="0" cellpadding="0">
32 <tr valign="top" align="left">
33 <td width="10%"></td><td width="90%">
34 <b>msggrep</b> [<i>OPTION</i>]
35 [<i>INPUTFILE</i>]</td></table>
36 <a name="DESCRIPTION"></a>
37 <h2>DESCRIPTION</h2>
39 <table width="100%" border=0 rules="none" frame="void"
40 cols="2" cellspacing="0" cellpadding="0">
41 <tr valign="top" align="left">
42 <td width="10%"></td><td width="90%">
43 Extracts all messages of a translation catalog that match a
44 given pattern or belong to some given source
45 files.</td></table>
47 <table width="100%" border=0 rules="none" frame="void"
48 cols="2" cellspacing="0" cellpadding="0">
49 <tr valign="top" align="left">
50 <td width="10%"></td><td width="90%">
51 Mandatory arguments to long options are mandatory for short
52 options too.</td></table>
54 <table width="100%" border=0 rules="none" frame="void"
55 cols="2" cellspacing="0" cellpadding="0">
56 <tr valign="top" align="left">
57 <td width="4%"></td><td width="96%">
58 <b>Input file location:</b></td></table>
60 <table width="100%" border=0 rules="none" frame="void"
61 cols="2" cellspacing="0" cellpadding="0">
62 <tr valign="top" align="left">
63 <td width="10%"></td><td width="90%">
64 INPUTFILE</td></table>
66 <table width="100%" border=0 rules="none" frame="void"
67 cols="2" cellspacing="0" cellpadding="0">
68 <tr valign="top" align="left">
69 <td width="21%"></td><td width="79%">
70 input PO file</td></table>
72 <table width="100%" border=0 rules="none" frame="void"
73 cols="2" cellspacing="0" cellpadding="0">
74 <tr valign="top" align="left">
75 <td width="10%"></td><td width="90%">
76 <b>-D</b>, <b>--directory</b>=<i>DIRECTORY</i></td></table>
78 <table width="100%" border=0 rules="none" frame="void"
79 cols="2" cellspacing="0" cellpadding="0">
80 <tr valign="top" align="left">
81 <td width="21%"></td><td width="79%">
82 add DIRECTORY to list for input files search</td></table>
84 <table width="100%" border=0 rules="none" frame="void"
85 cols="2" cellspacing="0" cellpadding="0">
86 <tr valign="top" align="left">
87 <td width="10%"></td><td width="90%">
88 If no input file is given or if it is -, standard input is
89 read.</td></table>
91 <table width="100%" border=0 rules="none" frame="void"
92 cols="2" cellspacing="0" cellpadding="0">
93 <tr valign="top" align="left">
94 <td width="4%"></td><td width="96%">
95 <b>Output file location:</b></td></table>
97 <table width="100%" border=0 rules="none" frame="void"
98 cols="2" cellspacing="0" cellpadding="0">
99 <tr valign="top" align="left">
100 <td width="10%"></td><td width="90%">
101 <b>-o</b>, <b>--output-file</b>=<i>FILE</i></td></table>
103 <table width="100%" border=0 rules="none" frame="void"
104 cols="2" cellspacing="0" cellpadding="0">
105 <tr valign="top" align="left">
106 <td width="21%"></td><td width="79%">
107 write output to specified file</td></table>
109 <table width="100%" border=0 rules="none" frame="void"
110 cols="2" cellspacing="0" cellpadding="0">
111 <tr valign="top" align="left">
112 <td width="10%"></td><td width="90%">
113 The results are written to standard output if no output file
114 is specified or if it is -.</td></table>
116 <table width="100%" border=0 rules="none" frame="void"
117 cols="2" cellspacing="0" cellpadding="0">
118 <tr valign="top" align="left">
119 <td width="4%"></td><td width="96%">
120 <b>Message selection:</b></td></table>
122 <table width="100%" border=0 rules="none" frame="void"
123 cols="2" cellspacing="0" cellpadding="0">
124 <tr valign="top" align="left">
125 <td width="21%"></td><td width="79%">
126 [-N SOURCEFILE]... [-M DOMAINNAME]... [-K MSGID-PATTERN] [-T
127 MSGSTR-PATTERN] [-C COMMENT-PATTERN]</td></table>
129 <table width="100%" border=0 rules="none" frame="void"
130 cols="2" cellspacing="0" cellpadding="0">
131 <tr valign="top" align="left">
132 <td width="10%"></td><td width="90%">
133 A message is selected if it comes from one of the specified
134 source files, or if it comes from one of the specified
135 domains, or if <b>-K</b> is given and its key (msgid or
136 msgid_plural) matches MSGID-PATTERN, or if <b>-T</b> is
137 given and its translation (msgstr) matches MSGSTR-PATTERN,
138 or if <b>-C</b> is given and the translator's comment
139 matches COMMENT-PATTERN.</td></table>
141 <table width="100%" border=0 rules="none" frame="void"
142 cols="2" cellspacing="0" cellpadding="0">
143 <tr valign="top" align="left">
144 <td width="10%"></td><td width="90%">
145 When more than one selection criterion is specified, the set
146 of selected messages is the union of the selected messages
147 of each criterion.</td></table>
149 <table width="100%" border=0 rules="none" frame="void"
150 cols="2" cellspacing="0" cellpadding="0">
151 <tr valign="top" align="left">
152 <td width="4%"></td><td width="96%">
153 <b>MSGID-PATTERN or MSGSTR-PATTERN or COMMENT-PATTERN
154 syntax:</b></td></table>
156 <table width="100%" border=0 rules="none" frame="void"
157 cols="2" cellspacing="0" cellpadding="0">
158 <tr valign="top" align="left">
159 <td width="21%"></td><td width="79%">
160 [-E | <b>-F]</b> [-e PATTERN | <b>-f</b>
161 FILE]...</td></table>
163 <table width="100%" border=0 rules="none" frame="void"
164 cols="2" cellspacing="0" cellpadding="0">
165 <tr valign="top" align="left">
166 <td width="10%"></td><td width="90%">
167 PATTERNs are basic regular expressions by default, or
168 extended regular expressions if <b>-E</b> is given, or fixed
169 strings if <b>-F</b> is given.</td></table>
171 <table width="100%" border=0 rules="none" frame="void"
172 cols="2" cellspacing="0" cellpadding="0">
173 <tr valign="top" align="left">
174 <td width="10%"></td><td width="90%">
175 <b>-N</b>, <b>--location</b>=<i>SOURCEFILE</i></td></table>
177 <table width="100%" border=0 rules="none" frame="void"
178 cols="2" cellspacing="0" cellpadding="0">
179 <tr valign="top" align="left">
180 <td width="21%"></td><td width="79%">
181 select messages extracted from SOURCEFILE</td></table>
183 <table width="100%" border=0 rules="none" frame="void"
184 cols="2" cellspacing="0" cellpadding="0">
185 <tr valign="top" align="left">
186 <td width="10%"></td><td width="90%">
187 <b>-M</b>, <b>--domain</b>=<i>DOMAINNAME</i></td></table>
189 <table width="100%" border=0 rules="none" frame="void"
190 cols="2" cellspacing="0" cellpadding="0">
191 <tr valign="top" align="left">
192 <td width="21%"></td><td width="79%">
193 select messages belonging to domain DOMAINNAME</td></table>
195 <table width="100%" border=0 rules="none" frame="void"
196 cols="2" cellspacing="0" cellpadding="0">
197 <tr valign="top" align="left">
198 <td width="10%"></td><td width="90%">
199 <b>-K</b>, <b>--msgid</b></td></table>
201 <table width="100%" border=0 rules="none" frame="void"
202 cols="2" cellspacing="0" cellpadding="0">
203 <tr valign="top" align="left">
204 <td width="21%"></td><td width="79%">
205 start of patterns for the msgid</td></table>
207 <table width="100%" border=0 rules="none" frame="void"
208 cols="2" cellspacing="0" cellpadding="0">
209 <tr valign="top" align="left">
210 <td width="10%"></td><td width="90%">
211 <b>-T</b>, <b>--msgstr</b></td></table>
213 <table width="100%" border=0 rules="none" frame="void"
214 cols="2" cellspacing="0" cellpadding="0">
215 <tr valign="top" align="left">
216 <td width="21%"></td><td width="79%">
217 start of patterns for the msgstr</td></table>
219 <table width="100%" border=0 rules="none" frame="void"
220 cols="2" cellspacing="0" cellpadding="0">
221 <tr valign="top" align="left">
222 <td width="10%"></td><td width="90%">
223 <b>-C</b>, <b>--comment</b></td></table>
225 <table width="100%" border=0 rules="none" frame="void"
226 cols="2" cellspacing="0" cellpadding="0">
227 <tr valign="top" align="left">
228 <td width="21%"></td><td width="79%">
229 start of patterns for the translator's comment</td></table>
231 <table width="100%" border=0 rules="none" frame="void"
232 cols="2" cellspacing="0" cellpadding="0">
233 <tr valign="top" align="left">
234 <td width="10%"></td><td width="90%">
235 <b>-E</b>, <b>--extended-regexp</b></td></table>
237 <table width="100%" border=0 rules="none" frame="void"
238 cols="2" cellspacing="0" cellpadding="0">
239 <tr valign="top" align="left">
240 <td width="21%"></td><td width="79%">
241 PATTERN is an extended regular expression</td></table>
243 <table width="100%" border=0 rules="none" frame="void"
244 cols="2" cellspacing="0" cellpadding="0">
245 <tr valign="top" align="left">
246 <td width="10%"></td><td width="90%">
247 <b>-F</b>, <b>--fixed-strings</b></td></table>
249 <table width="100%" border=0 rules="none" frame="void"
250 cols="2" cellspacing="0" cellpadding="0">
251 <tr valign="top" align="left">
252 <td width="21%"></td><td width="79%">
253 PATTERN is a set of newline-separated strings</td></table>
255 <table width="100%" border=0 rules="none" frame="void"
256 cols="2" cellspacing="0" cellpadding="0">
257 <tr valign="top" align="left">
258 <td width="10%"></td><td width="90%">
259 <b>-e</b>, <b>--regexp</b>=<i>PATTERN</i></td></table>
261 <table width="100%" border=0 rules="none" frame="void"
262 cols="2" cellspacing="0" cellpadding="0">
263 <tr valign="top" align="left">
264 <td width="21%"></td><td width="79%">
265 use PATTERN as a regular expression</td></table>
267 <table width="100%" border=0 rules="none" frame="void"
268 cols="2" cellspacing="0" cellpadding="0">
269 <tr valign="top" align="left">
270 <td width="10%"></td><td width="90%">
271 <b>-f</b>, <b>--file</b>=<i>FILE</i></td></table>
273 <table width="100%" border=0 rules="none" frame="void"
274 cols="2" cellspacing="0" cellpadding="0">
275 <tr valign="top" align="left">
276 <td width="21%"></td><td width="79%">
277 obtain PATTERN from FILE</td></table>
279 <table width="100%" border=0 rules="none" frame="void"
280 cols="2" cellspacing="0" cellpadding="0">
281 <tr valign="top" align="left">
282 <td width="10%"></td><td width="90%">
283 <b>-i</b>, <b>--ignore-case</b></td></table>
285 <table width="100%" border=0 rules="none" frame="void"
286 cols="2" cellspacing="0" cellpadding="0">
287 <tr valign="top" align="left">
288 <td width="21%"></td><td width="79%">
289 ignore case distinctions</td></table>
291 <table width="100%" border=0 rules="none" frame="void"
292 cols="2" cellspacing="0" cellpadding="0">
293 <tr valign="top" align="left">
294 <td width="4%"></td><td width="96%">
295 <b>Input file syntax:</b></td></table>
297 <table width="100%" border=0 rules="none" frame="void"
298 cols="2" cellspacing="0" cellpadding="0">
299 <tr valign="top" align="left">
300 <td width="10%"></td><td width="90%">
301 <b>-P</b>, <b>--properties-input</b></td></table>
303 <table width="100%" border=0 rules="none" frame="void"
304 cols="2" cellspacing="0" cellpadding="0">
305 <tr valign="top" align="left">
306 <td width="21%"></td><td width="79%">
307 input file is in Java .properties syntax</td></table>
309 <table width="100%" border=0 rules="none" frame="void"
310 cols="2" cellspacing="0" cellpadding="0">
311 <tr valign="top" align="left">
312 <td width="10%"></td><td width="90%">
313 <b>--stringtable-input</b></td></table>
315 <table width="100%" border=0 rules="none" frame="void"
316 cols="2" cellspacing="0" cellpadding="0">
317 <tr valign="top" align="left">
318 <td width="21%"></td><td width="79%">
319 input file is in NeXTstep/GNUstep .strings
320 syntax</td></table>
322 <table width="100%" border=0 rules="none" frame="void"
323 cols="2" cellspacing="0" cellpadding="0">
324 <tr valign="top" align="left">
325 <td width="4%"></td><td width="96%">
326 <b>Output details:</b></td></table>
328 <table width="100%" border=0 rules="none" frame="void"
329 cols="2" cellspacing="0" cellpadding="0">
330 <tr valign="top" align="left">
331 <td width="10%"></td><td width="90%">
332 <b>--no-escape</b></td></table>
334 <table width="100%" border=0 rules="none" frame="void"
335 cols="2" cellspacing="0" cellpadding="0">
336 <tr valign="top" align="left">
337 <td width="21%"></td><td width="79%">
338 do not use C escapes in output (default)</td></table>
340 <table width="100%" border=0 rules="none" frame="void"
341 cols="2" cellspacing="0" cellpadding="0">
342 <tr valign="top" align="left">
343 <td width="10%"></td><td width="90%">
344 <b>--escape</b></td></table>
346 <table width="100%" border=0 rules="none" frame="void"
347 cols="2" cellspacing="0" cellpadding="0">
348 <tr valign="top" align="left">
349 <td width="21%"></td><td width="79%">
350 use C escapes in output, no extended chars</td></table>
352 <table width="100%" border=0 rules="none" frame="void"
353 cols="2" cellspacing="0" cellpadding="0">
354 <tr valign="top" align="left">
355 <td width="10%"></td><td width="90%">
356 <b>--force-po</b></td></table>
358 <table width="100%" border=0 rules="none" frame="void"
359 cols="2" cellspacing="0" cellpadding="0">
360 <tr valign="top" align="left">
361 <td width="21%"></td><td width="79%">
362 write PO file even if empty</td></table>
364 <table width="100%" border=0 rules="none" frame="void"
365 cols="2" cellspacing="0" cellpadding="0">
366 <tr valign="top" align="left">
367 <td width="10%"></td><td width="90%">
368 <b>--indent</b></td></table>
370 <table width="100%" border=0 rules="none" frame="void"
371 cols="2" cellspacing="0" cellpadding="0">
372 <tr valign="top" align="left">
373 <td width="21%"></td><td width="79%">
374 indented output style</td></table>
376 <table width="100%" border=0 rules="none" frame="void"
377 cols="2" cellspacing="0" cellpadding="0">
378 <tr valign="top" align="left">
379 <td width="10%"></td><td width="90%">
380 <b>--no-location</b></td></table>
382 <table width="100%" border=0 rules="none" frame="void"
383 cols="2" cellspacing="0" cellpadding="0">
384 <tr valign="top" align="left">
385 <td width="21%"></td><td width="79%">
386 suppress '#: filename:line' lines</td></table>
388 <table width="100%" border=0 rules="none" frame="void"
389 cols="2" cellspacing="0" cellpadding="0">
390 <tr valign="top" align="left">
391 <td width="10%"></td><td width="90%">
392 <b>--add-location</b></td></table>
394 <table width="100%" border=0 rules="none" frame="void"
395 cols="2" cellspacing="0" cellpadding="0">
396 <tr valign="top" align="left">
397 <td width="21%"></td><td width="79%">
398 preserve '#: filename:line' lines (default)</td></table>
400 <table width="100%" border=0 rules="none" frame="void"
401 cols="2" cellspacing="0" cellpadding="0">
402 <tr valign="top" align="left">
403 <td width="10%"></td><td width="90%">
404 <b>--strict</b></td></table>
406 <table width="100%" border=0 rules="none" frame="void"
407 cols="2" cellspacing="0" cellpadding="0">
408 <tr valign="top" align="left">
409 <td width="21%"></td><td width="79%">
410 strict Uniforum output style</td></table>
412 <table width="100%" border=0 rules="none" frame="void"
413 cols="2" cellspacing="0" cellpadding="0">
414 <tr valign="top" align="left">
415 <td width="10%"></td><td width="90%">
416 <b>-p</b>, <b>--properties-output</b></td></table>
418 <table width="100%" border=0 rules="none" frame="void"
419 cols="2" cellspacing="0" cellpadding="0">
420 <tr valign="top" align="left">
421 <td width="21%"></td><td width="79%">
422 write out a Java .properties file</td></table>
424 <table width="100%" border=0 rules="none" frame="void"
425 cols="2" cellspacing="0" cellpadding="0">
426 <tr valign="top" align="left">
427 <td width="10%"></td><td width="90%">
428 <b>--stringtable-output</b></td></table>
430 <table width="100%" border=0 rules="none" frame="void"
431 cols="2" cellspacing="0" cellpadding="0">
432 <tr valign="top" align="left">
433 <td width="21%"></td><td width="79%">
434 write out a NeXTstep/GNUstep .strings file</td></table>
436 <table width="100%" border=0 rules="none" frame="void"
437 cols="2" cellspacing="0" cellpadding="0">
438 <tr valign="top" align="left">
439 <td width="10%"></td><td width="90%">
440 <b>-w</b>, <b>--width</b>=<i>NUMBER</i></td></table>
442 <table width="100%" border=0 rules="none" frame="void"
443 cols="2" cellspacing="0" cellpadding="0">
444 <tr valign="top" align="left">
445 <td width="21%"></td><td width="79%">
446 set output page width</td></table>
448 <table width="100%" border=0 rules="none" frame="void"
449 cols="2" cellspacing="0" cellpadding="0">
450 <tr valign="top" align="left">
451 <td width="10%"></td><td width="90%">
452 <b>--no-wrap</b></td></table>
454 <table width="100%" border=0 rules="none" frame="void"
455 cols="2" cellspacing="0" cellpadding="0">
456 <tr valign="top" align="left">
457 <td width="21%"></td><td width="79%">
458 do not break long message lines, longer than the output page
459 width, into several lines</td></table>
461 <table width="100%" border=0 rules="none" frame="void"
462 cols="2" cellspacing="0" cellpadding="0">
463 <tr valign="top" align="left">
464 <td width="10%"></td><td width="90%">
465 <b>--sort-output</b></td></table>
467 <table width="100%" border=0 rules="none" frame="void"
468 cols="2" cellspacing="0" cellpadding="0">
469 <tr valign="top" align="left">
470 <td width="21%"></td><td width="79%">
471 generate sorted output</td></table>
473 <table width="100%" border=0 rules="none" frame="void"
474 cols="2" cellspacing="0" cellpadding="0">
475 <tr valign="top" align="left">
476 <td width="10%"></td><td width="90%">
477 <b>--sort-by-file</b></td></table>
479 <table width="100%" border=0 rules="none" frame="void"
480 cols="2" cellspacing="0" cellpadding="0">
481 <tr valign="top" align="left">
482 <td width="21%"></td><td width="79%">
483 sort output by file location</td></table>
485 <table width="100%" border=0 rules="none" frame="void"
486 cols="2" cellspacing="0" cellpadding="0">
487 <tr valign="top" align="left">
488 <td width="4%"></td><td width="96%">
489 <b>Informative output:</b></td></table>
491 <table width="100%" border=0 rules="none" frame="void"
492 cols="2" cellspacing="0" cellpadding="0">
493 <tr valign="top" align="left">
494 <td width="10%"></td><td width="90%">
495 <b>-h</b>, <b>--help</b></td></table>
497 <table width="100%" border=0 rules="none" frame="void"
498 cols="2" cellspacing="0" cellpadding="0">
499 <tr valign="top" align="left">
500 <td width="21%"></td><td width="79%">
501 display this help and exit</td></table>
503 <table width="100%" border=0 rules="none" frame="void"
504 cols="2" cellspacing="0" cellpadding="0">
505 <tr valign="top" align="left">
506 <td width="10%"></td><td width="90%">
507 <b>-V</b>, <b>--version</b></td></table>
509 <table width="100%" border=0 rules="none" frame="void"
510 cols="2" cellspacing="0" cellpadding="0">
511 <tr valign="top" align="left">
512 <td width="21%"></td><td width="79%">
513 output version information and exit</td></table>
514 <a name="AUTHOR"></a>
515 <h2>AUTHOR</h2>
517 <table width="100%" border=0 rules="none" frame="void"
518 cols="2" cellspacing="0" cellpadding="0">
519 <tr valign="top" align="left">
520 <td width="10%"></td><td width="90%">
521 Written by Bruno Haible.</td></table>
522 <a name="REPORTING BUGS"></a>
523 <h2>REPORTING BUGS</h2>
525 <table width="100%" border=0 rules="none" frame="void"
526 cols="2" cellspacing="0" cellpadding="0">
527 <tr valign="top" align="left">
528 <td width="10%"></td><td width="90%">
529 Report bugs to &lt;bug-gnu-gettext@gnu.org&gt;.</td></table>
530 <a name="COPYRIGHT"></a>
531 <h2>COPYRIGHT</h2>
533 <table width="100%" border=0 rules="none" frame="void"
534 cols="2" cellspacing="0" cellpadding="0">
535 <tr valign="top" align="left">
536 <td width="10%"></td><td width="90%">
537 Copyright 2001-2005 Free Software Foundation, Inc.<br>
538 This is free software; see the source for copying
539 conditions. There is NO warranty; not even for
540 MERCHANTABILITY or FITNESS FOR A PARTICULAR
541 PURPOSE.</td></table>
542 <a name="SEE ALSO"></a>
543 <h2>SEE ALSO</h2>
545 <table width="100%" border=0 rules="none" frame="void"
546 cols="2" cellspacing="0" cellpadding="0">
547 <tr valign="top" align="left">
548 <td width="10%"></td><td width="90%">
549 The full documentation for <b>msggrep</b> is maintained as a
550 Texinfo manual. If the <b>info</b> and <b>msggrep</b>
551 programs are properly installed at your site, the
552 command</td></table>
554 <table width="100%" border=0 rules="none" frame="void"
555 cols="2" cellspacing="0" cellpadding="0">
556 <tr valign="top" align="left">
557 <td width="21%"></td><td width="79%">
558 <b>info msggrep</b></td></table>
560 <table width="100%" border=0 rules="none" frame="void"
561 cols="2" cellspacing="0" cellpadding="0">
562 <tr valign="top" align="left">
563 <td width="10%"></td><td width="90%">
564 should give you access to the complete manual.</td></table>
565 <hr>
566 </body>
567 </html>