1 <!-- Creator : groff version 1.18.1 -->
4 <meta name="generator" content="groff -Thtml, see www.gnu.org">
5 <meta name="Content-Style" content="text/css">
10 <h1 align=center>MSGGREP</h1>
11 <a href="#NAME">NAME</a><br>
12 <a href="#SYNOPSIS">SYNOPSIS</a><br>
13 <a href="#DESCRIPTION">DESCRIPTION</a><br>
14 <a href="#AUTHOR">AUTHOR</a><br>
15 <a href="#REPORTING BUGS">REPORTING BUGS</a><br>
16 <a href="#COPYRIGHT">COPYRIGHT</a><br>
17 <a href="#SEE ALSO">SEE ALSO</a><br>
23 <table width="100%" border=0 rules="none" frame="void"
24 cols="2" cellspacing="0" cellpadding="0">
25 <tr valign="top" align="left">
28 <p>msggrep − pattern matching on message catalog</p>
31 <a name="SYNOPSIS"></a>
34 <table width="100%" border=0 rules="none" frame="void"
35 cols="2" cellspacing="0" cellpadding="0">
36 <tr valign="top" align="left">
39 <p><b>msggrep</b> [<i>OPTION</i>] [<i>INPUTFILE</i>]</p>
42 <a name="DESCRIPTION"></a>
45 <table width="100%" border=0 rules="none" frame="void"
46 cols="2" cellspacing="0" cellpadding="0">
47 <tr valign="top" align="left">
50 <p>Extracts all messages of a translation catalog that match
51 a given pattern or belong to some given source files.</p>
53 <p>Mandatory arguments to long options are mandatory for
54 short options too.</p>
58 <table width="100%" border=0 rules="none" frame="void"
59 cols="2" cellspacing="0" cellpadding="0">
60 <tr valign="top" align="left">
63 <p><b>Input file location:</b></p></td>
66 <table width="100%" border=0 rules="none" frame="void"
67 cols="2" cellspacing="0" cellpadding="0">
68 <tr valign="top" align="left">
74 <table width="100%" border=0 rules="none" frame="void"
75 cols="2" cellspacing="0" cellpadding="0">
76 <tr valign="top" align="left">
83 <table width="100%" border=0 rules="none" frame="void"
84 cols="2" cellspacing="0" cellpadding="0">
85 <tr valign="top" align="left">
89 <b>−−directory</b>=<i>DIRECTORY</i></p></td>
92 <table width="100%" border=0 rules="none" frame="void"
93 cols="2" cellspacing="0" cellpadding="0">
94 <tr valign="top" align="left">
97 <p>add DIRECTORY to list for input files search</p>
101 <table width="100%" border=0 rules="none" frame="void"
102 cols="2" cellspacing="0" cellpadding="0">
103 <tr valign="top" align="left">
104 <td width="10%"></td>
106 <p>If no input file is given or if it is -, standard input
111 <table width="100%" border=0 rules="none" frame="void"
112 cols="2" cellspacing="0" cellpadding="0">
113 <tr valign="top" align="left">
116 <p><b>Output file location:</b></p></td>
119 <table width="100%" border=0 rules="none" frame="void"
120 cols="2" cellspacing="0" cellpadding="0">
121 <tr valign="top" align="left">
122 <td width="10%"></td>
125 <b>−−output−file</b>=<i>FILE</i></p></td>
128 <table width="100%" border=0 rules="none" frame="void"
129 cols="2" cellspacing="0" cellpadding="0">
130 <tr valign="top" align="left">
131 <td width="21%"></td>
133 <p>write output to specified file</p>
137 <table width="100%" border=0 rules="none" frame="void"
138 cols="2" cellspacing="0" cellpadding="0">
139 <tr valign="top" align="left">
140 <td width="10%"></td>
142 <p>The results are written to standard output if no output
143 file is specified or if it is -.</p>
147 <table width="100%" border=0 rules="none" frame="void"
148 cols="2" cellspacing="0" cellpadding="0">
149 <tr valign="top" align="left">
152 <p><b>Message selection:</b></p></td>
155 <table width="100%" border=0 rules="none" frame="void"
156 cols="2" cellspacing="0" cellpadding="0">
157 <tr valign="top" align="left">
158 <td width="20%"></td>
160 <p>[-N SOURCEFILE]... [-M DOMAINNAME]... [-J
161 MSGCTXT-PATTERN] [-K MSGID-PATTERN] [-T MSGSTR-PATTERN] [-C
162 COMMENT-PATTERN] [-X EXTRACTED-COMMENT-PATTERN]</p>
166 <table width="100%" border=0 rules="none" frame="void"
167 cols="2" cellspacing="0" cellpadding="0">
168 <tr valign="top" align="left">
169 <td width="10%"></td>
171 <p>A message is selected if it comes from one of the
172 specified source files, or if it comes from one of the
173 specified domains, or if <b>−J</b> is given and its
174 context (msgctxt) matches MSGCTXT-PATTERN, or if
175 <b>−K</b> is given and its key (msgid or msgid_plural)
176 matches MSGID-PATTERN, or if <b>−T</b> is given and
177 its translation (msgstr) matches MSGSTR-PATTERN, or if
178 <b>−C</b> is given and the translator’s comment
179 matches COMMENT-PATTERN, or if <b>−X</b> is given and
180 the extracted comment matches EXTRACTED-COMMENT-PATTERN.</p>
182 <p>When more than one selection criterion is specified, the
183 set of selected messages is the union of the selected
184 messages of each criterion.</p>
186 <p>MSGCTXT-PATTERN or MSGID-PATTERN or MSGSTR-PATTERN or
187 COMMENT-PATTERN or EXTRACTED-COMMENT-PATTERN syntax:</p>
191 <table width="100%" border=0 rules="none" frame="void"
192 cols="2" cellspacing="0" cellpadding="0">
193 <tr valign="top" align="left">
194 <td width="20%"></td>
196 <p>[-E | <b>−F]</b> [-e PATTERN | <b>−f</b>
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="10%"></td>
206 <p>PATTERNs are basic regular expressions by default, or
207 extended regular expressions if <b>−E</b> is given, or
208 fixed strings if <b>−F</b> is given.</p>
212 <table width="100%" border=0 rules="none" frame="void"
213 cols="2" cellspacing="0" cellpadding="0">
214 <tr valign="top" align="left">
215 <td width="10%"></td>
218 <b>−−location</b>=<i>SOURCEFILE</i></p></td>
221 <table width="100%" border=0 rules="none" frame="void"
222 cols="2" cellspacing="0" cellpadding="0">
223 <tr valign="top" align="left">
224 <td width="21%"></td>
226 <p>select messages extracted from SOURCEFILE</p>
230 <table width="100%" border=0 rules="none" frame="void"
231 cols="2" cellspacing="0" cellpadding="0">
232 <tr valign="top" align="left">
233 <td width="10%"></td>
236 <b>−−domain</b>=<i>DOMAINNAME</i></p></td>
239 <table width="100%" border=0 rules="none" frame="void"
240 cols="2" cellspacing="0" cellpadding="0">
241 <tr valign="top" align="left">
242 <td width="21%"></td>
244 <p>select messages belonging to domain DOMAINNAME</p>
248 <table width="100%" border=0 rules="none" frame="void"
249 cols="2" cellspacing="0" cellpadding="0">
250 <tr valign="top" align="left">
251 <td width="10%"></td>
253 <p><b>−J</b>, <b>−−msgctxt</b></p></td>
256 <table width="100%" border=0 rules="none" frame="void"
257 cols="2" cellspacing="0" cellpadding="0">
258 <tr valign="top" align="left">
259 <td width="21%"></td>
261 <p>start of patterns for the msgctxt</p>
265 <table width="100%" border=0 rules="none" frame="void"
266 cols="2" cellspacing="0" cellpadding="0">
267 <tr valign="top" align="left">
268 <td width="10%"></td>
270 <p><b>−K</b>, <b>−−msgid</b></p></td>
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>
278 <p>start of patterns for the msgid</p>
282 <table width="100%" border=0 rules="none" frame="void"
283 cols="2" cellspacing="0" cellpadding="0">
284 <tr valign="top" align="left">
285 <td width="10%"></td>
287 <p><b>−T</b>, <b>−−msgstr</b></p></td>
290 <table width="100%" border=0 rules="none" frame="void"
291 cols="2" cellspacing="0" cellpadding="0">
292 <tr valign="top" align="left">
293 <td width="21%"></td>
295 <p>start of patterns for the msgstr</p>
299 <table width="100%" border=0 rules="none" frame="void"
300 cols="2" cellspacing="0" cellpadding="0">
301 <tr valign="top" align="left">
302 <td width="10%"></td>
304 <p><b>−C</b>, <b>−−comment</b></p></td>
307 <table width="100%" border=0 rules="none" frame="void"
308 cols="2" cellspacing="0" cellpadding="0">
309 <tr valign="top" align="left">
310 <td width="21%"></td>
312 <p>start of patterns for the translator’s comment</p>
316 <table width="100%" border=0 rules="none" frame="void"
317 cols="2" cellspacing="0" cellpadding="0">
318 <tr valign="top" align="left">
319 <td width="10%"></td>
322 <b>−−extracted−comment</b></p></td>
325 <table width="100%" border=0 rules="none" frame="void"
326 cols="2" cellspacing="0" cellpadding="0">
327 <tr valign="top" align="left">
328 <td width="21%"></td>
330 <p>start of patterns for the extracted comment</p>
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="10%"></td>
340 <b>−−extended−regexp</b></p></td>
343 <table width="100%" border=0 rules="none" frame="void"
344 cols="2" cellspacing="0" cellpadding="0">
345 <tr valign="top" align="left">
346 <td width="21%"></td>
348 <p>PATTERN is an extended regular expression</p>
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>
358 <b>−−fixed−strings</b></p></td>
361 <table width="100%" border=0 rules="none" frame="void"
362 cols="2" cellspacing="0" cellpadding="0">
363 <tr valign="top" align="left">
364 <td width="21%"></td>
366 <p>PATTERN is a set of newline-separated strings</p>
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="10%"></td>
376 <b>−−regexp</b>=<i>PATTERN</i></p></td>
379 <table width="100%" border=0 rules="none" frame="void"
380 cols="2" cellspacing="0" cellpadding="0">
381 <tr valign="top" align="left">
382 <td width="21%"></td>
384 <p>use PATTERN as a regular expression</p>
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>
394 <b>−−file</b>=<i>FILE</i></p></td>
397 <table width="100%" border=0 rules="none" frame="void"
398 cols="2" cellspacing="0" cellpadding="0">
399 <tr valign="top" align="left">
400 <td width="21%"></td>
402 <p>obtain PATTERN from FILE</p>
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="10%"></td>
412 <b>−−ignore−case</b></p></td>
415 <table width="100%" border=0 rules="none" frame="void"
416 cols="2" cellspacing="0" cellpadding="0">
417 <tr valign="top" align="left">
418 <td width="21%"></td>
420 <p>ignore case distinctions</p>
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>
430 <b>−−invert−match</b></p></td>
433 <table width="100%" border=0 rules="none" frame="void"
434 cols="2" cellspacing="0" cellpadding="0">
435 <tr valign="top" align="left">
436 <td width="21%"></td>
438 <p>output only the messages that do not match any selection
443 <table width="100%" border=0 rules="none" frame="void"
444 cols="2" cellspacing="0" cellpadding="0">
445 <tr valign="top" align="left">
448 <p><b>Input file syntax:</b></p></td>
451 <table width="100%" border=0 rules="none" frame="void"
452 cols="2" cellspacing="0" cellpadding="0">
453 <tr valign="top" align="left">
454 <td width="10%"></td>
457 <b>−−properties−input</b></p></td>
460 <table width="100%" border=0 rules="none" frame="void"
461 cols="2" cellspacing="0" cellpadding="0">
462 <tr valign="top" align="left">
463 <td width="21%"></td>
465 <p>input file is in Java .properties syntax</p>
469 <table width="100%" border=0 rules="none" frame="void"
470 cols="2" cellspacing="0" cellpadding="0">
471 <tr valign="top" align="left">
472 <td width="10%"></td>
474 <p><b>−−stringtable−input</b></p></td>
477 <table width="100%" border=0 rules="none" frame="void"
478 cols="2" cellspacing="0" cellpadding="0">
479 <tr valign="top" align="left">
480 <td width="21%"></td>
482 <p>input file is in NeXTstep/GNUstep .strings syntax</p>
486 <table width="100%" border=0 rules="none" frame="void"
487 cols="2" cellspacing="0" cellpadding="0">
488 <tr valign="top" align="left">
491 <p><b>Output details:</b></p></td>
494 <table width="100%" border=0 rules="none" frame="void"
495 cols="2" cellspacing="0" cellpadding="0">
496 <tr valign="top" align="left">
497 <td width="10%"></td>
499 <p><b>−−color</b></p></td>
502 <table width="100%" border=0 rules="none" frame="void"
503 cols="2" cellspacing="0" cellpadding="0">
504 <tr valign="top" align="left">
505 <td width="21%"></td>
507 <p>use colors and other text attributes always</p>
511 <table width="100%" border=0 rules="none" frame="void"
512 cols="2" cellspacing="0" cellpadding="0">
513 <tr valign="top" align="left">
514 <td width="10%"></td>
516 <p><b>−−color</b>=<i>WHEN</i></p></td>
519 <table width="100%" border=0 rules="none" frame="void"
520 cols="2" cellspacing="0" cellpadding="0">
521 <tr valign="top" align="left">
522 <td width="21%"></td>
524 <p>use colors and other text attributes if WHEN. WHEN may be
525 ’always’, ’never’,
526 ’auto’, or ’html’.</p>
530 <table width="100%" border=0 rules="none" frame="void"
531 cols="2" cellspacing="0" cellpadding="0">
532 <tr valign="top" align="left">
533 <td width="10%"></td>
535 <p><b>−−style</b>=<i>STYLEFILE</i></p></td>
538 <table width="100%" border=0 rules="none" frame="void"
539 cols="2" cellspacing="0" cellpadding="0">
540 <tr valign="top" align="left">
541 <td width="21%"></td>
543 <p>specify CSS style rule file for
544 <b>−−color</b></p>
548 <table width="100%" border=0 rules="none" frame="void"
549 cols="2" cellspacing="0" cellpadding="0">
550 <tr valign="top" align="left">
551 <td width="10%"></td>
553 <p><b>−−no−escape</b></p></td>
556 <table width="100%" border=0 rules="none" frame="void"
557 cols="2" cellspacing="0" cellpadding="0">
558 <tr valign="top" align="left">
559 <td width="21%"></td>
561 <p>do not use C escapes in output (default)</p>
565 <table width="100%" border=0 rules="none" frame="void"
566 cols="2" cellspacing="0" cellpadding="0">
567 <tr valign="top" align="left">
568 <td width="10%"></td>
570 <p><b>−−escape</b></p></td>
573 <table width="100%" border=0 rules="none" frame="void"
574 cols="2" cellspacing="0" cellpadding="0">
575 <tr valign="top" align="left">
576 <td width="21%"></td>
578 <p>use C escapes in output, no extended chars</p>
582 <table width="100%" border=0 rules="none" frame="void"
583 cols="2" cellspacing="0" cellpadding="0">
584 <tr valign="top" align="left">
585 <td width="10%"></td>
587 <p><b>−−force−po</b></p></td>
590 <table width="100%" border=0 rules="none" frame="void"
591 cols="2" cellspacing="0" cellpadding="0">
592 <tr valign="top" align="left">
593 <td width="21%"></td>
595 <p>write PO file even if empty</p>
599 <table width="100%" border=0 rules="none" frame="void"
600 cols="2" cellspacing="0" cellpadding="0">
601 <tr valign="top" align="left">
602 <td width="10%"></td>
604 <p><b>−−indent</b></p></td>
607 <table width="100%" border=0 rules="none" frame="void"
608 cols="2" cellspacing="0" cellpadding="0">
609 <tr valign="top" align="left">
610 <td width="21%"></td>
612 <p>indented output style</p>
616 <table width="100%" border=0 rules="none" frame="void"
617 cols="2" cellspacing="0" cellpadding="0">
618 <tr valign="top" align="left">
619 <td width="10%"></td>
621 <p><b>−−no−location</b></p></td>
624 <table width="100%" border=0 rules="none" frame="void"
625 cols="2" cellspacing="0" cellpadding="0">
626 <tr valign="top" align="left">
627 <td width="21%"></td>
629 <p>suppress ’#: filename:line’ lines</p>
633 <table width="100%" border=0 rules="none" frame="void"
634 cols="2" cellspacing="0" cellpadding="0">
635 <tr valign="top" align="left">
636 <td width="10%"></td>
638 <p><b>−−add−location</b></p></td>
641 <table width="100%" border=0 rules="none" frame="void"
642 cols="2" cellspacing="0" cellpadding="0">
643 <tr valign="top" align="left">
644 <td width="21%"></td>
646 <p>preserve ’#: filename:line’ lines
651 <table width="100%" border=0 rules="none" frame="void"
652 cols="2" cellspacing="0" cellpadding="0">
653 <tr valign="top" align="left">
654 <td width="10%"></td>
656 <p><b>−−strict</b></p></td>
659 <table width="100%" border=0 rules="none" frame="void"
660 cols="2" cellspacing="0" cellpadding="0">
661 <tr valign="top" align="left">
662 <td width="21%"></td>
664 <p>strict Uniforum output style</p>
668 <table width="100%" border=0 rules="none" frame="void"
669 cols="2" cellspacing="0" cellpadding="0">
670 <tr valign="top" align="left">
671 <td width="10%"></td>
674 <b>−−properties−output</b></p></td>
677 <table width="100%" border=0 rules="none" frame="void"
678 cols="2" cellspacing="0" cellpadding="0">
679 <tr valign="top" align="left">
680 <td width="21%"></td>
682 <p>write out a Java .properties file</p>
686 <table width="100%" border=0 rules="none" frame="void"
687 cols="2" cellspacing="0" cellpadding="0">
688 <tr valign="top" align="left">
689 <td width="10%"></td>
691 <p><b>−−stringtable−output</b></p></td>
694 <table width="100%" border=0 rules="none" frame="void"
695 cols="2" cellspacing="0" cellpadding="0">
696 <tr valign="top" align="left">
697 <td width="21%"></td>
699 <p>write out a NeXTstep/GNUstep .strings file</p>
703 <table width="100%" border=0 rules="none" frame="void"
704 cols="2" cellspacing="0" cellpadding="0">
705 <tr valign="top" align="left">
706 <td width="10%"></td>
709 <b>−−width</b>=<i>NUMBER</i></p></td>
712 <table width="100%" border=0 rules="none" frame="void"
713 cols="2" cellspacing="0" cellpadding="0">
714 <tr valign="top" align="left">
715 <td width="21%"></td>
717 <p>set output page width</p>
721 <table width="100%" border=0 rules="none" frame="void"
722 cols="2" cellspacing="0" cellpadding="0">
723 <tr valign="top" align="left">
724 <td width="10%"></td>
726 <p><b>−−no−wrap</b></p></td>
729 <table width="100%" border=0 rules="none" frame="void"
730 cols="2" cellspacing="0" cellpadding="0">
731 <tr valign="top" align="left">
732 <td width="21%"></td>
734 <p>do not break long message lines, longer than the output
735 page width, into several lines</p>
739 <table width="100%" border=0 rules="none" frame="void"
740 cols="2" cellspacing="0" cellpadding="0">
741 <tr valign="top" align="left">
742 <td width="10%"></td>
744 <p><b>−−sort−output</b></p></td>
747 <table width="100%" border=0 rules="none" frame="void"
748 cols="2" cellspacing="0" cellpadding="0">
749 <tr valign="top" align="left">
750 <td width="21%"></td>
752 <p>generate sorted output</p>
756 <table width="100%" border=0 rules="none" frame="void"
757 cols="2" cellspacing="0" cellpadding="0">
758 <tr valign="top" align="left">
759 <td width="10%"></td>
761 <p><b>−−sort−by−file</b></p></td>
764 <table width="100%" border=0 rules="none" frame="void"
765 cols="2" cellspacing="0" cellpadding="0">
766 <tr valign="top" align="left">
767 <td width="21%"></td>
769 <p>sort output by file location</p>
773 <table width="100%" border=0 rules="none" frame="void"
774 cols="2" cellspacing="0" cellpadding="0">
775 <tr valign="top" align="left">
778 <p><b>Informative output:</b></p></td>
781 <table width="100%" border=0 rules="none" frame="void"
782 cols="2" cellspacing="0" cellpadding="0">
783 <tr valign="top" align="left">
784 <td width="10%"></td>
786 <p><b>−h</b>, <b>−−help</b></p></td>
789 <table width="100%" border=0 rules="none" frame="void"
790 cols="2" cellspacing="0" cellpadding="0">
791 <tr valign="top" align="left">
792 <td width="21%"></td>
794 <p>display this help and exit</p>
798 <table width="100%" border=0 rules="none" frame="void"
799 cols="2" cellspacing="0" cellpadding="0">
800 <tr valign="top" align="left">
801 <td width="10%"></td>
803 <p><b>−V</b>, <b>−−version</b></p></td>
806 <table width="100%" border=0 rules="none" frame="void"
807 cols="2" cellspacing="0" cellpadding="0">
808 <tr valign="top" align="left">
809 <td width="21%"></td>
811 <p>output version information and exit</p>
814 <a name="AUTHOR"></a>
817 <table width="100%" border=0 rules="none" frame="void"
818 cols="2" cellspacing="0" cellpadding="0">
819 <tr valign="top" align="left">
820 <td width="10%"></td>
822 <p>Written by Bruno Haible.</p>
825 <a name="REPORTING BUGS"></a>
826 <h2>REPORTING BUGS</h2>
828 <table width="100%" border=0 rules="none" frame="void"
829 cols="2" cellspacing="0" cellpadding="0">
830 <tr valign="top" align="left">
831 <td width="10%"></td>
833 <p>Report bugs to <bug-gnu-gettext@gnu.org>.</p>
836 <a name="COPYRIGHT"></a>
839 <table width="100%" border=0 rules="none" frame="void"
840 cols="2" cellspacing="0" cellpadding="0">
841 <tr valign="top" align="left">
842 <td width="10%"></td>
844 <p>Copyright © 2001-2010 Free Software Foundation, Inc.
845 License GPLv3+: GNU GPL version 3 or later
846 <http://gnu.org/licenses/gpl.html><br>
847 This is free software: you are free to change and
848 redistribute it. There is NO WARRANTY, to the extent
849 permitted by law.</p>
852 <a name="SEE ALSO"></a>
855 <table width="100%" border=0 rules="none" frame="void"
856 cols="2" cellspacing="0" cellpadding="0">
857 <tr valign="top" align="left">
858 <td width="10%"></td>
860 <p>The full documentation for <b>msggrep</b> is maintained
861 as a Texinfo manual. If the <b>info</b> and <b>msggrep</b>
862 programs are properly installed at your site, the
867 <table width="100%" border=0 rules="none" frame="void"
868 cols="2" cellspacing="0" cellpadding="0">
869 <tr valign="top" align="left">
870 <td width="20%"></td>
872 <p><b>info msggrep</b></p>
876 <table width="100%" border=0 rules="none" frame="void"
877 cols="2" cellspacing="0" cellpadding="0">
878 <tr valign="top" align="left">
879 <td width="10%"></td>
881 <p>should give you access to the complete manual.</p>