annotate CSP2/CSP2_env/env-d9b9114564458d9d-741b3de822f2aaca6c6caa4325c4afce/share/doc/gettext/msggrep.1.html @ 68:5028fdace37b

planemo upload commit 2e9511a184a1ca667c7be0c6321a36dc4e3d116d
author jpayne
date Tue, 18 Mar 2025 16:23:26 -0400
parents
children
rev   line source
jpayne@68 1 <!-- Creator : groff version 1.22.3 -->
jpayne@68 2 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
jpayne@68 3 "http://www.w3.org/TR/html4/loose.dtd">
jpayne@68 4 <html>
jpayne@68 5 <head>
jpayne@68 6 <meta name="generator" content="groff -Thtml, see www.gnu.org">
jpayne@68 7 <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
jpayne@68 8 <meta name="Content-Style" content="text/css">
jpayne@68 9 <style type="text/css">
jpayne@68 10 p { margin-top: 0; margin-bottom: 0; vertical-align: top }
jpayne@68 11 pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
jpayne@68 12 table { margin-top: 0; margin-bottom: 0; vertical-align: top }
jpayne@68 13 h1 { text-align: center }
jpayne@68 14 </style>
jpayne@68 15 <title>MSGGREP</title>
jpayne@68 16
jpayne@68 17 </head>
jpayne@68 18 <body>
jpayne@68 19
jpayne@68 20 <h1 align="center">MSGGREP</h1>
jpayne@68 21
jpayne@68 22 <a href="#NAME">NAME</a><br>
jpayne@68 23 <a href="#SYNOPSIS">SYNOPSIS</a><br>
jpayne@68 24 <a href="#DESCRIPTION">DESCRIPTION</a><br>
jpayne@68 25 <a href="#AUTHOR">AUTHOR</a><br>
jpayne@68 26 <a href="#REPORTING BUGS">REPORTING BUGS</a><br>
jpayne@68 27 <a href="#COPYRIGHT">COPYRIGHT</a><br>
jpayne@68 28 <a href="#SEE ALSO">SEE ALSO</a><br>
jpayne@68 29
jpayne@68 30 <hr>
jpayne@68 31
jpayne@68 32
jpayne@68 33 <h2>NAME
jpayne@68 34 <a name="NAME"></a>
jpayne@68 35 </h2>
jpayne@68 36
jpayne@68 37
jpayne@68 38 <p style="margin-left:11%; margin-top: 1em">msggrep -
jpayne@68 39 pattern matching on message catalog</p>
jpayne@68 40
jpayne@68 41 <h2>SYNOPSIS
jpayne@68 42 <a name="SYNOPSIS"></a>
jpayne@68 43 </h2>
jpayne@68 44
jpayne@68 45
jpayne@68 46 <p style="margin-left:11%; margin-top: 1em"><b>msggrep</b>
jpayne@68 47 [<i>OPTION</i>] [<i>INPUTFILE</i>]</p>
jpayne@68 48
jpayne@68 49 <h2>DESCRIPTION
jpayne@68 50 <a name="DESCRIPTION"></a>
jpayne@68 51 </h2>
jpayne@68 52
jpayne@68 53
jpayne@68 54 <p style="margin-left:11%; margin-top: 1em">Extracts all
jpayne@68 55 messages of a translation catalog that match a given pattern
jpayne@68 56 or belong to some given source files.</p>
jpayne@68 57
jpayne@68 58 <p style="margin-left:11%; margin-top: 1em">Mandatory
jpayne@68 59 arguments to long options are mandatory for short options
jpayne@68 60 too.</p>
jpayne@68 61
jpayne@68 62 <p style="margin-left:11%; margin-top: 1em"><b>Input file
jpayne@68 63 location:</b> <br>
jpayne@68 64 INPUTFILE</p>
jpayne@68 65
jpayne@68 66 <p style="margin-left:22%;">input PO file</p>
jpayne@68 67
jpayne@68 68 <p style="margin-left:11%;"><b>-D</b>,
jpayne@68 69 <b>--directory</b>=<i>DIRECTORY</i></p>
jpayne@68 70
jpayne@68 71 <p style="margin-left:22%;">add DIRECTORY to list for input
jpayne@68 72 files search</p>
jpayne@68 73
jpayne@68 74 <p style="margin-left:11%; margin-top: 1em">If no input
jpayne@68 75 file is given or if it is -, standard input is
jpayne@68 76 read.</p>
jpayne@68 77
jpayne@68 78 <p style="margin-left:11%; margin-top: 1em"><b>Output file
jpayne@68 79 location: <br>
jpayne@68 80 -o</b>,
jpayne@68 81 <b>--output-file</b>=<i>FILE</i></p>
jpayne@68 82
jpayne@68 83 <p style="margin-left:22%;">write output to specified
jpayne@68 84 file</p>
jpayne@68 85
jpayne@68 86 <p style="margin-left:11%; margin-top: 1em">The results are
jpayne@68 87 written to standard output if no output file is specified or
jpayne@68 88 if it is -.</p>
jpayne@68 89
jpayne@68 90 <p style="margin-left:11%; margin-top: 1em"><b>Message
jpayne@68 91 selection:</b></p>
jpayne@68 92
jpayne@68 93 <p style="margin-left:22%;">[-N SOURCEFILE]...
jpayne@68 94 [-M DOMAINNAME]... [-J MSGCTXT-PATTERN]
jpayne@68 95 [-K MSGID-PATTERN] [-T
jpayne@68 96 MSGSTR-PATTERN] [-C COMMENT-PATTERN]
jpayne@68 97 [-X EXTRACTED-COMMENT-PATTERN]</p>
jpayne@68 98
jpayne@68 99 <p style="margin-left:11%; margin-top: 1em">A message is
jpayne@68 100 selected if it comes from one of the specified source files,
jpayne@68 101 or if it comes from one of the specified domains, or if
jpayne@68 102 <b>-J</b> is given and its context (msgctxt) matches
jpayne@68 103 MSGCTXT-PATTERN, or if <b>-K</b> is given and
jpayne@68 104 its key (msgid or msgid_plural) matches MSGID-PATTERN,
jpayne@68 105 or if <b>-T</b> is given and its translation (msgstr)
jpayne@68 106 matches MSGSTR-PATTERN, or if <b>-C</b> is given
jpayne@68 107 and the translator&rsquo;s comment matches
jpayne@68 108 COMMENT-PATTERN, or if <b>-X</b> is given and
jpayne@68 109 the extracted comment matches
jpayne@68 110 EXTRACTED-COMMENT-PATTERN.</p>
jpayne@68 111
jpayne@68 112 <p style="margin-left:11%; margin-top: 1em">When more than
jpayne@68 113 one selection criterion is specified, the set of selected
jpayne@68 114 messages is the union of the selected messages of each
jpayne@68 115 criterion.</p>
jpayne@68 116
jpayne@68 117
jpayne@68 118 <p style="margin-left:11%; margin-top: 1em">MSGCTXT-PATTERN
jpayne@68 119 or MSGID-PATTERN or MSGSTR-PATTERN or
jpayne@68 120 COMMENT-PATTERN or
jpayne@68 121 EXTRACTED-COMMENT-PATTERN syntax:</p>
jpayne@68 122
jpayne@68 123 <p style="margin-left:22%; margin-top: 1em">[-E |
jpayne@68 124 <b>-F]</b> [-e PATTERN | <b>-f</b>
jpayne@68 125 FILE]...</p>
jpayne@68 126
jpayne@68 127 <p style="margin-left:11%; margin-top: 1em">PATTERNs are
jpayne@68 128 basic regular expressions by default, or extended regular
jpayne@68 129 expressions if <b>-E</b> is given, or fixed strings if
jpayne@68 130 <b>-F</b> is given. <b><br>
jpayne@68 131 -N</b>,
jpayne@68 132 <b>--location</b>=<i>SOURCEFILE</i></p>
jpayne@68 133
jpayne@68 134 <p style="margin-left:22%;">select messages extracted from
jpayne@68 135 SOURCEFILE</p>
jpayne@68 136
jpayne@68 137 <p style="margin-left:11%;"><b>-M</b>,
jpayne@68 138 <b>--domain</b>=<i>DOMAINNAME</i></p>
jpayne@68 139
jpayne@68 140 <p style="margin-left:22%;">select messages belonging to
jpayne@68 141 domain DOMAINNAME</p>
jpayne@68 142
jpayne@68 143 <p style="margin-left:11%;"><b>-J</b>,
jpayne@68 144 <b>--msgctxt</b></p>
jpayne@68 145
jpayne@68 146 <p style="margin-left:22%;">start of patterns for the
jpayne@68 147 msgctxt</p>
jpayne@68 148
jpayne@68 149 <p style="margin-left:11%;"><b>-K</b>,
jpayne@68 150 <b>--msgid</b></p>
jpayne@68 151
jpayne@68 152 <p style="margin-left:22%;">start of patterns for the
jpayne@68 153 msgid</p>
jpayne@68 154
jpayne@68 155 <p style="margin-left:11%;"><b>-T</b>,
jpayne@68 156 <b>--msgstr</b></p>
jpayne@68 157
jpayne@68 158 <p style="margin-left:22%;">start of patterns for the
jpayne@68 159 msgstr</p>
jpayne@68 160
jpayne@68 161 <p style="margin-left:11%;"><b>-C</b>,
jpayne@68 162 <b>--comment</b></p>
jpayne@68 163
jpayne@68 164 <p style="margin-left:22%;">start of patterns for the
jpayne@68 165 translator&rsquo;s comment</p>
jpayne@68 166
jpayne@68 167 <p style="margin-left:11%;"><b>-X</b>,
jpayne@68 168 <b>--extracted-comment</b></p>
jpayne@68 169
jpayne@68 170 <p style="margin-left:22%;">start of patterns for the
jpayne@68 171 extracted comment</p>
jpayne@68 172
jpayne@68 173 <p style="margin-left:11%;"><b>-E</b>,
jpayne@68 174 <b>--extended-regexp</b></p>
jpayne@68 175
jpayne@68 176 <p style="margin-left:22%;">PATTERN is an extended regular
jpayne@68 177 expression</p>
jpayne@68 178
jpayne@68 179 <p style="margin-left:11%;"><b>-F</b>,
jpayne@68 180 <b>--fixed-strings</b></p>
jpayne@68 181
jpayne@68 182 <p style="margin-left:22%;">PATTERN is a set of
jpayne@68 183 newline-separated strings</p>
jpayne@68 184
jpayne@68 185 <p style="margin-left:11%;"><b>-e</b>,
jpayne@68 186 <b>--regexp</b>=<i>PATTERN</i></p>
jpayne@68 187
jpayne@68 188 <p style="margin-left:22%;">use PATTERN as a regular
jpayne@68 189 expression</p>
jpayne@68 190
jpayne@68 191 <p style="margin-left:11%;"><b>-f</b>,
jpayne@68 192 <b>--file</b>=<i>FILE</i></p>
jpayne@68 193
jpayne@68 194 <p style="margin-left:22%;">obtain PATTERN from FILE</p>
jpayne@68 195
jpayne@68 196 <p style="margin-left:11%;"><b>-i</b>,
jpayne@68 197 <b>--ignore-case</b></p>
jpayne@68 198
jpayne@68 199 <p style="margin-left:22%;">ignore case distinctions</p>
jpayne@68 200
jpayne@68 201 <p style="margin-left:11%;"><b>-v</b>,
jpayne@68 202 <b>--invert-match</b></p>
jpayne@68 203
jpayne@68 204 <p style="margin-left:22%;">output only the messages that
jpayne@68 205 do not match any selection criterion</p>
jpayne@68 206
jpayne@68 207 <p style="margin-left:11%; margin-top: 1em"><b>Input file
jpayne@68 208 syntax: <br>
jpayne@68 209 -P</b>,
jpayne@68 210 <b>--properties-input</b></p>
jpayne@68 211
jpayne@68 212 <p style="margin-left:22%;">input file is in Java
jpayne@68 213 .properties syntax</p>
jpayne@68 214
jpayne@68 215
jpayne@68 216 <p style="margin-left:11%;"><b>--stringtable-input</b></p>
jpayne@68 217
jpayne@68 218 <p style="margin-left:22%;">input file is in
jpayne@68 219 NeXTstep/GNUstep .strings syntax</p>
jpayne@68 220
jpayne@68 221 <p style="margin-left:11%; margin-top: 1em"><b>Output
jpayne@68 222 details: <br>
jpayne@68 223 --color</b></p>
jpayne@68 224
jpayne@68 225 <p style="margin-left:22%;">use colors and other text
jpayne@68 226 attributes always</p>
jpayne@68 227
jpayne@68 228
jpayne@68 229 <p style="margin-left:11%;"><b>--color</b>=<i>WHEN</i></p>
jpayne@68 230
jpayne@68 231 <p style="margin-left:22%;">use colors and other text
jpayne@68 232 attributes if WHEN. WHEN may be &rsquo;always&rsquo;,
jpayne@68 233 &rsquo;never&rsquo;, &rsquo;auto&rsquo;, or
jpayne@68 234 &rsquo;html&rsquo;.</p>
jpayne@68 235
jpayne@68 236
jpayne@68 237 <p style="margin-left:11%;"><b>--style</b>=<i>STYLEFILE</i></p>
jpayne@68 238
jpayne@68 239 <p style="margin-left:22%;">specify CSS style rule file for
jpayne@68 240 <b>--color</b></p>
jpayne@68 241
jpayne@68 242
jpayne@68 243 <p style="margin-left:11%;"><b>--no-escape</b></p>
jpayne@68 244
jpayne@68 245 <p style="margin-left:22%;">do not use C escapes in output
jpayne@68 246 (default)</p>
jpayne@68 247
jpayne@68 248
jpayne@68 249 <p style="margin-left:11%;"><b>--escape</b></p>
jpayne@68 250
jpayne@68 251 <p style="margin-left:22%;">use C escapes in output, no
jpayne@68 252 extended chars</p>
jpayne@68 253
jpayne@68 254
jpayne@68 255 <p style="margin-left:11%;"><b>--force-po</b></p>
jpayne@68 256
jpayne@68 257 <p style="margin-left:22%;">write PO file even if empty</p>
jpayne@68 258
jpayne@68 259
jpayne@68 260 <p style="margin-left:11%;"><b>--indent</b></p>
jpayne@68 261
jpayne@68 262 <p style="margin-left:22%;">indented output style</p>
jpayne@68 263
jpayne@68 264
jpayne@68 265 <p style="margin-left:11%;"><b>--no-location</b></p>
jpayne@68 266
jpayne@68 267 <p style="margin-left:22%;">suppress &rsquo;#:
jpayne@68 268 filename:line&rsquo; lines</p>
jpayne@68 269
jpayne@68 270 <p style="margin-left:11%;"><b>-n</b>,
jpayne@68 271 <b>--add-location</b></p>
jpayne@68 272
jpayne@68 273 <p style="margin-left:22%;">preserve &rsquo;#:
jpayne@68 274 filename:line&rsquo; lines (default)</p>
jpayne@68 275
jpayne@68 276
jpayne@68 277 <p style="margin-left:11%;"><b>--strict</b></p>
jpayne@68 278
jpayne@68 279 <p style="margin-left:22%;">strict Uniforum output
jpayne@68 280 style</p>
jpayne@68 281
jpayne@68 282 <p style="margin-left:11%;"><b>-p</b>,
jpayne@68 283 <b>--properties-output</b></p>
jpayne@68 284
jpayne@68 285 <p style="margin-left:22%;">write out a Java .properties
jpayne@68 286 file</p>
jpayne@68 287
jpayne@68 288
jpayne@68 289 <p style="margin-left:11%;"><b>--stringtable-output</b></p>
jpayne@68 290
jpayne@68 291 <p style="margin-left:22%;">write out a NeXTstep/GNUstep
jpayne@68 292 .strings file</p>
jpayne@68 293
jpayne@68 294 <p style="margin-left:11%;"><b>-w</b>,
jpayne@68 295 <b>--width</b>=<i>NUMBER</i></p>
jpayne@68 296
jpayne@68 297 <p style="margin-left:22%;">set output page width</p>
jpayne@68 298
jpayne@68 299
jpayne@68 300 <p style="margin-left:11%;"><b>--no-wrap</b></p>
jpayne@68 301
jpayne@68 302 <p style="margin-left:22%;">do not break long message
jpayne@68 303 lines, longer than the output page width, into several
jpayne@68 304 lines</p>
jpayne@68 305
jpayne@68 306
jpayne@68 307 <p style="margin-left:11%;"><b>--sort-output</b></p>
jpayne@68 308
jpayne@68 309 <p style="margin-left:22%;">generate sorted output</p>
jpayne@68 310
jpayne@68 311
jpayne@68 312 <p style="margin-left:11%;"><b>--sort-by-file</b></p>
jpayne@68 313
jpayne@68 314 <p style="margin-left:22%;">sort output by file
jpayne@68 315 location</p>
jpayne@68 316
jpayne@68 317 <p style="margin-left:11%; margin-top: 1em"><b>Informative
jpayne@68 318 output: <br>
jpayne@68 319 -h</b>, <b>--help</b></p>
jpayne@68 320
jpayne@68 321 <p style="margin-left:22%;">display this help and exit</p>
jpayne@68 322
jpayne@68 323 <p style="margin-left:11%;"><b>-V</b>,
jpayne@68 324 <b>--version</b></p>
jpayne@68 325
jpayne@68 326 <p style="margin-left:22%;">output version information and
jpayne@68 327 exit</p>
jpayne@68 328
jpayne@68 329 <h2>AUTHOR
jpayne@68 330 <a name="AUTHOR"></a>
jpayne@68 331 </h2>
jpayne@68 332
jpayne@68 333
jpayne@68 334 <p style="margin-left:11%; margin-top: 1em">Written by
jpayne@68 335 Bruno Haible.</p>
jpayne@68 336
jpayne@68 337 <h2>REPORTING BUGS
jpayne@68 338 <a name="REPORTING BUGS"></a>
jpayne@68 339 </h2>
jpayne@68 340
jpayne@68 341
jpayne@68 342 <p style="margin-left:11%; margin-top: 1em">Report bugs in
jpayne@68 343 the bug tracker at
jpayne@68 344 &lt;https://savannah.gnu.org/projects/gettext&gt; or by
jpayne@68 345 email to &lt;bug-gettext@gnu.org&gt;.</p>
jpayne@68 346
jpayne@68 347 <h2>COPYRIGHT
jpayne@68 348 <a name="COPYRIGHT"></a>
jpayne@68 349 </h2>
jpayne@68 350
jpayne@68 351
jpayne@68 352 <p style="margin-left:11%; margin-top: 1em">Copyright
jpayne@68 353 &copy; 2001-2023 Free Software Foundation, Inc.
jpayne@68 354 License GPLv3+: GNU GPL version 3 or later
jpayne@68 355 &lt;https://gnu.org/licenses/gpl.html&gt; <br>
jpayne@68 356 This is free software: you are free to change and
jpayne@68 357 redistribute it. There is NO WARRANTY, to the extent
jpayne@68 358 permitted by law.</p>
jpayne@68 359
jpayne@68 360 <h2>SEE ALSO
jpayne@68 361 <a name="SEE ALSO"></a>
jpayne@68 362 </h2>
jpayne@68 363
jpayne@68 364
jpayne@68 365 <p style="margin-left:11%; margin-top: 1em">The full
jpayne@68 366 documentation for <b>msggrep</b> is maintained as a Texinfo
jpayne@68 367 manual. If the <b>info</b> and <b>msggrep</b> programs are
jpayne@68 368 properly installed at your site, the command</p>
jpayne@68 369
jpayne@68 370 <p style="margin-left:22%; margin-top: 1em"><b>info
jpayne@68 371 msggrep</b></p>
jpayne@68 372
jpayne@68 373 <p style="margin-left:11%; margin-top: 1em">should give you
jpayne@68 374 access to the complete manual.</p>
jpayne@68 375 <hr>
jpayne@68 376 </body>
jpayne@68 377 </html>