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> 8 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> 17 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%"> 26msggrep - pattern matching on message catalog</td></table> 27<a name="SYNOPSIS"></a> 28<h2>SYNOPSIS</h2> 29 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> 38 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%"> 43Extracts all messages of a translation catalog that match a 44given pattern or belong to some given source 45files.</td></table> 46 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%"> 51Mandatory arguments to long options are mandatory for short 52options too.</td></table> 53 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> 59 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%"> 64INPUTFILE</td></table> 65 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%"> 70input PO file</td></table> 71 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> 77 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%"> 82add DIRECTORY to list for input files search</td></table> 83 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%"> 88If no input file is given or if it is -, standard input is 89read.</td></table> 90 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> 96 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> 102 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%"> 107write output to specified file</td></table> 108 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%"> 113The results are written to standard output if no output file 114is specified or if it is -.</td></table> 115 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> 121 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 127MSGSTR-PATTERN] [-C COMMENT-PATTERN]</td></table> 128 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%"> 133A message is selected if it comes from one of the specified 134source files, or if it comes from one of the specified 135domains, or if <b>-K</b> is given and its key (msgid or 136msgid_plural) matches MSGID-PATTERN, or if <b>-T</b> is 137given and its translation (msgstr) matches MSGSTR-PATTERN, 138or if <b>-C</b> is given and the translator's comment 139matches COMMENT-PATTERN.</td></table> 140 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%"> 145When more than one selection criterion is specified, the set 146of selected messages is the union of the selected messages 147of each criterion.</td></table> 148 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 154syntax:</b></td></table> 155 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> 161FILE]...</td></table> 162 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%"> 167PATTERNs are basic regular expressions by default, or 168extended regular expressions if <b>-E</b> is given, or fixed 169strings if <b>-F</b> is given.</td></table> 170 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> 176 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%"> 181select messages extracted from SOURCEFILE</td></table> 182 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> 188 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%"> 193select messages belonging to domain DOMAINNAME</td></table> 194 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> 200 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%"> 205start of patterns for the msgid</td></table> 206 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> 212 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%"> 217start of patterns for the msgstr</td></table> 218 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> 224 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%"> 229start of patterns for the translator's comment</td></table> 230 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> 236 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%"> 241PATTERN is an extended regular expression</td></table> 242 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> 248 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%"> 253PATTERN is a set of newline-separated strings</td></table> 254 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> 260 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%"> 265use PATTERN as a regular expression</td></table> 266 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> 272 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%"> 277obtain PATTERN from FILE</td></table> 278 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> 284 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%"> 289ignore case distinctions</td></table> 290 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> 296 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> 302 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%"> 307input file is in Java .properties syntax</td></table> 308 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> 314 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%"> 319input file is in NeXTstep/GNUstep .strings 320syntax</td></table> 321 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> 327 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> 333 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%"> 338do not use C escapes in output (default)</td></table> 339 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> 345 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%"> 350use C escapes in output, no extended chars</td></table> 351 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> 357 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%"> 362write PO file even if empty</td></table> 363 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> 369 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%"> 374indented output style</td></table> 375 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> 381 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%"> 386suppress '#: filename:line' lines</td></table> 387 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> 393 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%"> 398preserve '#: filename:line' lines (default)</td></table> 399 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> 405 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%"> 410strict Uniforum output style</td></table> 411 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> 417 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%"> 422write out a Java .properties file</td></table> 423 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> 429 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%"> 434write out a NeXTstep/GNUstep .strings file</td></table> 435 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> 441 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%"> 446set output page width</td></table> 447 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> 453 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%"> 458do not break long message lines, longer than the output page 459width, into several lines</td></table> 460 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> 466 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%"> 471generate sorted output</td></table> 472 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> 478 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%"> 483sort output by file location</td></table> 484 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> 490 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> 496 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%"> 501display this help and exit</td></table> 502 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> 508 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%"> 513output version information and exit</td></table> 514<a name="AUTHOR"></a> 515<h2>AUTHOR</h2> 516 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%"> 521Written by Bruno Haible.</td></table> 522<a name="REPORTING BUGS"></a> 523<h2>REPORTING BUGS</h2> 524 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%"> 529Report bugs to <bug-gnu-gettext@gnu.org>.</td></table> 530<a name="COPYRIGHT"></a> 531<h2>COPYRIGHT</h2> 532 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%"> 537Copyright 2001-2005 Free Software Foundation, Inc.<br> 538This is free software; see the source for copying 539conditions. There is NO warranty; not even for 540MERCHANTABILITY or FITNESS FOR A PARTICULAR 541PURPOSE.</td></table> 542<a name="SEE ALSO"></a> 543<h2>SEE ALSO</h2> 544 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%"> 549The full documentation for <b>msggrep</b> is maintained as a 550Texinfo manual. If the <b>info</b> and <b>msggrep</b> 551programs are properly installed at your site, the 552command</td></table> 553 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> 559 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%"> 564should give you access to the complete manual.</td></table> 565<hr> 566</body> 567</html> 568