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’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’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 ’always’,
|
jpayne@68
|
233 ’never’, ’auto’, or
|
jpayne@68
|
234 ’html’.</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 ’#:
|
jpayne@68
|
268 filename:line’ 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 ’#:
|
jpayne@68
|
274 filename:line’ 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 <https://savannah.gnu.org/projects/gettext> or by
|
jpayne@68
|
345 email to <bug-gettext@gnu.org>.</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 © 2001-2023 Free Software Foundation, Inc.
|
jpayne@68
|
354 License GPLv3+: GNU GPL version 3 or later
|
jpayne@68
|
355 <https://gnu.org/licenses/gpl.html> <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>
|