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