gnu/dist/gettext/gettext-tools/man/msggrep.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.24.
   2 .TH MSGGREP "1" "April 2005" "GNU gettext-tools 0.14.4" GNU
   3 .SH NAME
   4 msggrep \- pattern matching on message catalog
   5 .SH SYNOPSIS
   6 .B msggrep
   7 [\fIOPTION\fR] [\fIINPUTFILE\fR]
   8 .SH DESCRIPTION
   9 .\" Add any additional description here
  10 .PP
  11 Extracts all messages of a translation catalog that match a given pattern
  12 or belong to some given source files.
  13 .PP
  14 Mandatory arguments to long options are mandatory for short options too.
  15 .SS "Input file location:"
  16 .TP
  17 INPUTFILE
  18 input PO file
  19 .TP
  20 \fB\-D\fR, \fB\-\-directory\fR=\fIDIRECTORY\fR
  21 add DIRECTORY to list for input files search
  22 .PP
  23 If no input file is given or if it is -, standard input is read.
  24 .SS "Output file location:"
  25 .TP
  26 \fB\-o\fR, \fB\-\-output\-file\fR=\fIFILE\fR
  27 write output to specified file
  28 .PP
  29 The results are written to standard output if no output file is specified
  30 or if it is -.
  31 .SS "Message selection:"
  32 .IP
  33 [-N SOURCEFILE]... [-M DOMAINNAME]...
  34 [-K MSGID-PATTERN] [-T MSGSTR-PATTERN] [-C COMMENT-PATTERN]
  35 .PP
  36 A message is selected if it comes from one of the specified source files,
  37 or if it comes from one of the specified domains,
  38 or if \fB\-K\fR is given and its key (msgid or msgid_plural) matches MSGID-PATTERN,
  39 or if \fB\-T\fR is given and its translation (msgstr) matches MSGSTR-PATTERN,
  40 or if \fB\-C\fR is given and the translator's comment matches COMMENT-PATTERN.
  41 .PP
  42 When more than one selection criterion is specified, the set of selected
  43 messages is the union of the selected messages of each criterion.
  44 .SS "MSGID-PATTERN or MSGSTR-PATTERN or COMMENT-PATTERN syntax:"
  45 .IP
  46 [-E | \fB\-F]\fR [-e PATTERN | \fB\-f\fR FILE]...
  47 .PP
  48 PATTERNs are basic regular expressions by default, or extended regular
  49 expressions if \fB\-E\fR is given, or fixed strings if \fB\-F\fR is given.
  50 .TP
  51 \fB\-N\fR, \fB\-\-location\fR=\fISOURCEFILE\fR
  52 select messages extracted from SOURCEFILE
  53 .TP
  54 \fB\-M\fR, \fB\-\-domain\fR=\fIDOMAINNAME\fR
  55 select messages belonging to domain DOMAINNAME
  56 .TP
  57 \fB\-K\fR, \fB\-\-msgid\fR
  58 start of patterns for the msgid
  59 .TP
  60 \fB\-T\fR, \fB\-\-msgstr\fR
  61 start of patterns for the msgstr
  62 .TP
  63 \fB\-C\fR, \fB\-\-comment\fR
  64 start of patterns for the translator's comment
  65 .TP
  66 \fB\-E\fR, \fB\-\-extended\-regexp\fR
  67 PATTERN is an extended regular expression
  68 .TP
  69 \fB\-F\fR, \fB\-\-fixed\-strings\fR
  70 PATTERN is a set of newline-separated strings
  71 .TP
  72 \fB\-e\fR, \fB\-\-regexp\fR=\fIPATTERN\fR
  73 use PATTERN as a regular expression
  74 .TP
  75 \fB\-f\fR, \fB\-\-file\fR=\fIFILE\fR
  76 obtain PATTERN from FILE
  77 .TP
  78 \fB\-i\fR, \fB\-\-ignore\-case\fR
  79 ignore case distinctions
  80 .SS "Input file syntax:"
  81 .TP
  82 \fB\-P\fR, \fB\-\-properties\-input\fR
  83 input file is in Java .properties syntax
  84 .TP
  85 \fB\-\-stringtable\-input\fR
  86 input file is in NeXTstep/GNUstep .strings syntax
  87 .SS "Output details:"
  88 .TP
  89 \fB\-\-no\-escape\fR
  90 do not use C escapes in output (default)
  91 .TP
  92 \fB\-\-escape\fR
  93 use C escapes in output, no extended chars
  94 .TP
  95 \fB\-\-force\-po\fR
  96 write PO file even if empty
  97 .TP
  98 \fB\-\-indent\fR
  99 indented output style
 100 .TP
 101 \fB\-\-no\-location\fR
 102 suppress '#: filename:line' lines
 103 .TP
 104 \fB\-\-add\-location\fR
 105 preserve '#: filename:line' lines (default)
 106 .TP
 107 \fB\-\-strict\fR
 108 strict Uniforum output style
 109 .TP
 110 \fB\-p\fR, \fB\-\-properties\-output\fR
 111 write out a Java .properties file
 112 .TP
 113 \fB\-\-stringtable\-output\fR
 114 write out a NeXTstep/GNUstep .strings file
 115 .TP
 116 \fB\-w\fR, \fB\-\-width\fR=\fINUMBER\fR
 117 set output page width
 118 .TP
 119 \fB\-\-no\-wrap\fR
 120 do not break long message lines, longer than
 121 the output page width, into several lines
 122 .TP
 123 \fB\-\-sort\-output\fR
 124 generate sorted output
 125 .TP
 126 \fB\-\-sort\-by\-file\fR
 127 sort output by file location
 128 .SS "Informative output:"
 129 .TP
 130 \fB\-h\fR, \fB\-\-help\fR
 131 display this help and exit
 132 .TP
 133 \fB\-V\fR, \fB\-\-version\fR
 134 output version information and exit
 135 .SH AUTHOR
 136 Written by Bruno Haible.
 137 .SH "REPORTING BUGS"
 138 Report bugs to <bug-gnu-gettext@gnu.org>.
 139 .SH COPYRIGHT
 140 Copyright \(co 2001-2005 Free Software Foundation, Inc.
 141 .br
 142 This is free software; see the source for copying conditions.  There is NO
 143 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 144 .SH "SEE ALSO"
 145 The full documentation for
 146 .B msggrep
 147 is maintained as a Texinfo manual.  If the
 148 .B info
 149 and
 150 .B msggrep
 151 programs are properly installed at your site, the command
 152 .IP
 153 .B info msggrep
 154 .PP
 155 should give you access to the complete manual.