| Current File : //usr/local/apps/share/doc/gettext/msggrep.1.html |
<!-- Creator : groff version 1.22.3 -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="Content-Style" content="text/css">
<style type="text/css">
p { margin-top: 0; margin-bottom: 0; vertical-align: top }
pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
table { margin-top: 0; margin-bottom: 0; vertical-align: top }
h1 { text-align: center }
</style>
<title>MSGGREP</title>
</head>
<body>
<h1 align="center">MSGGREP</h1>
<a href="#NAME">NAME</a><br>
<a href="#SYNOPSIS">SYNOPSIS</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#AUTHOR">AUTHOR</a><br>
<a href="#REPORTING BUGS">REPORTING BUGS</a><br>
<a href="#COPYRIGHT">COPYRIGHT</a><br>
<a href="#SEE ALSO">SEE ALSO</a><br>
<hr>
<h2>NAME
<a name="NAME"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">msggrep −
pattern matching on message catalog</p>
<h2>SYNOPSIS
<a name="SYNOPSIS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>msggrep</b>
[<i>OPTION</i>] [<i>INPUTFILE</i>]</p>
<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">Extracts all
messages of a translation catalog that match a given pattern
or belong to some given source files.</p>
<p style="margin-left:11%; margin-top: 1em">Mandatory
arguments to long options are mandatory for short options
too.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Input file
location:</b> <br>
INPUTFILE</p>
<p style="margin-left:22%;">input PO file</p>
<p style="margin-left:11%;"><b>−D</b>,
<b>−−directory</b>=<i>DIRECTORY</i></p>
<p style="margin-left:22%;">add DIRECTORY to list for input
files search</p>
<p style="margin-left:11%; margin-top: 1em">If no input
file is given or if it is -, standard input is read.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Output file
location: <br>
−o</b>,
<b>−−output−file</b>=<i>FILE</i></p>
<p style="margin-left:22%;">write output to specified
file</p>
<p style="margin-left:11%; margin-top: 1em">The results are
written to standard output if no output file is specified or
if it is -.</p>
<p style="margin-left:11%; margin-top: 1em"><b>Message
selection:</b></p>
<p style="margin-left:22%;">[-N SOURCEFILE]... [-M
DOMAINNAME]... [-J MSGCTXT-PATTERN] [-K MSGID-PATTERN] [-T
MSGSTR-PATTERN] [-C COMMENT-PATTERN] [-X
EXTRACTED-COMMENT-PATTERN]</p>
<p style="margin-left:11%; margin-top: 1em">A message is
selected if it comes from one of the specified source files,
or if it comes from one of the specified domains, or if
<b>−J</b> is given and its context (msgctxt) matches
MSGCTXT-PATTERN, or if <b>−K</b> is given and its key
(msgid or msgid_plural) matches MSGID-PATTERN, or if
<b>−T</b> is given and its translation (msgstr)
matches MSGSTR-PATTERN, or if <b>−C</b> is given and
the translator’s comment matches COMMENT-PATTERN, or
if <b>−X</b> is given and the extracted comment
matches EXTRACTED-COMMENT-PATTERN.</p>
<p style="margin-left:11%; margin-top: 1em">When more than
one selection criterion is specified, the set of selected
messages is the union of the selected messages of each
criterion.</p>
<p style="margin-left:11%; margin-top: 1em">MSGCTXT-PATTERN
or MSGID-PATTERN or MSGSTR-PATTERN or COMMENT-PATTERN or
EXTRACTED-COMMENT-PATTERN syntax:</p>
<p style="margin-left:22%; margin-top: 1em">[-E |
<b>−F]</b> [-e PATTERN | <b>−f</b> FILE]...</p>
<p style="margin-left:11%; margin-top: 1em">PATTERNs are
basic regular expressions by default, or extended regular
expressions if <b>−E</b> is given, or fixed strings if
<b>−F</b> is given. <b><br>
−N</b>,
<b>−−location</b>=<i>SOURCEFILE</i></p>
<p style="margin-left:22%;">select messages extracted from
SOURCEFILE</p>
<p style="margin-left:11%;"><b>−M</b>,
<b>−−domain</b>=<i>DOMAINNAME</i></p>
<p style="margin-left:22%;">select messages belonging to
domain DOMAINNAME</p>
<p style="margin-left:11%;"><b>−J</b>,
<b>−−msgctxt</b></p>
<p style="margin-left:22%;">start of patterns for the
msgctxt</p>
<p style="margin-left:11%;"><b>−K</b>,
<b>−−msgid</b></p>
<p style="margin-left:22%;">start of patterns for the
msgid</p>
<p style="margin-left:11%;"><b>−T</b>,
<b>−−msgstr</b></p>
<p style="margin-left:22%;">start of patterns for the
msgstr</p>
<p style="margin-left:11%;"><b>−C</b>,
<b>−−comment</b></p>
<p style="margin-left:22%;">start of patterns for the
translator’s comment</p>
<p style="margin-left:11%;"><b>−X</b>,
<b>−−extracted−comment</b></p>
<p style="margin-left:22%;">start of patterns for the
extracted comment</p>
<p style="margin-left:11%;"><b>−E</b>,
<b>−−extended−regexp</b></p>
<p style="margin-left:22%;">PATTERN is an extended regular
expression</p>
<p style="margin-left:11%;"><b>−F</b>,
<b>−−fixed−strings</b></p>
<p style="margin-left:22%;">PATTERN is a set of
newline-separated strings</p>
<p style="margin-left:11%;"><b>−e</b>,
<b>−−regexp</b>=<i>PATTERN</i></p>
<p style="margin-left:22%;">use PATTERN as a regular
expression</p>
<p style="margin-left:11%;"><b>−f</b>,
<b>−−file</b>=<i>FILE</i></p>
<p style="margin-left:22%;">obtain PATTERN from FILE</p>
<p style="margin-left:11%;"><b>−i</b>,
<b>−−ignore−case</b></p>
<p style="margin-left:22%;">ignore case distinctions</p>
<p style="margin-left:11%;"><b>−v</b>,
<b>−−invert−match</b></p>
<p style="margin-left:22%;">output only the messages that
do not match any selection criterion</p>
<p style="margin-left:11%; margin-top: 1em"><b>Input file
syntax: <br>
−P</b>,
<b>−−properties−input</b></p>
<p style="margin-left:22%;">input file is in Java
.properties syntax</p>
<p style="margin-left:11%;"><b>−−stringtable−input</b></p>
<p style="margin-left:22%;">input file is in
NeXTstep/GNUstep .strings syntax</p>
<p style="margin-left:11%; margin-top: 1em"><b>Output
details: <br>
−−color</b></p>
<p style="margin-left:22%;">use colors and other text
attributes always</p>
<p style="margin-left:11%;"><b>−−color</b>=<i>WHEN</i></p>
<p style="margin-left:22%;">use colors and other text
attributes if WHEN. WHEN may be ’always’,
’never’, ’auto’, or
’html’.</p>
<p style="margin-left:11%;"><b>−−style</b>=<i>STYLEFILE</i></p>
<p style="margin-left:22%;">specify CSS style rule file for
<b>−−color</b></p>
<p style="margin-left:11%;"><b>−−no−escape</b></p>
<p style="margin-left:22%;">do not use C escapes in output
(default)</p>
<p style="margin-left:11%;"><b>−−escape</b></p>
<p style="margin-left:22%;">use C escapes in output, no
extended chars</p>
<p style="margin-left:11%;"><b>−−force−po</b></p>
<p style="margin-left:22%;">write PO file even if empty</p>
<p style="margin-left:11%;"><b>−−indent</b></p>
<p style="margin-left:22%;">indented output style</p>
<p style="margin-left:11%;"><b>−−no−location</b></p>
<p style="margin-left:22%;">suppress ’#:
filename:line’ lines</p>
<p style="margin-left:11%;"><b>−n</b>,
<b>−−add−location</b></p>
<p style="margin-left:22%;">preserve ’#:
filename:line’ lines (default)</p>
<p style="margin-left:11%;"><b>−−strict</b></p>
<p style="margin-left:22%;">strict Uniforum output
style</p>
<p style="margin-left:11%;"><b>−p</b>,
<b>−−properties−output</b></p>
<p style="margin-left:22%;">write out a Java .properties
file</p>
<p style="margin-left:11%;"><b>−−stringtable−output</b></p>
<p style="margin-left:22%;">write out a NeXTstep/GNUstep
.strings file</p>
<p style="margin-left:11%;"><b>−w</b>,
<b>−−width</b>=<i>NUMBER</i></p>
<p style="margin-left:22%;">set output page width</p>
<p style="margin-left:11%;"><b>−−no−wrap</b></p>
<p style="margin-left:22%;">do not break long message
lines, longer than the output page width, into several
lines</p>
<p style="margin-left:11%;"><b>−−sort−output</b></p>
<p style="margin-left:22%;">generate sorted output</p>
<p style="margin-left:11%;"><b>−−sort−by−file</b></p>
<p style="margin-left:22%;">sort output by file
location</p>
<p style="margin-left:11%; margin-top: 1em"><b>Informative
output: <br>
−h</b>, <b>−−help</b></p>
<p style="margin-left:22%;">display this help and exit</p>
<p style="margin-left:11%;"><b>−V</b>,
<b>−−version</b></p>
<p style="margin-left:22%;">output version information and
exit</p>
<h2>AUTHOR
<a name="AUTHOR"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">Written by
Bruno Haible.</p>
<h2>REPORTING BUGS
<a name="REPORTING BUGS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">Report bugs to
<bug-gnu-gettext@gnu.org>.</p>
<h2>COPYRIGHT
<a name="COPYRIGHT"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">Copyright
© 2001-2010 Free Software Foundation, Inc. License
GPLv3+: GNU GPL version 3 or later
<http://gnu.org/licenses/gpl.html> <br>
This is free software: you are free to change and
redistribute it. There is NO WARRANTY, to the extent
permitted by law.</p>
<h2>SEE ALSO
<a name="SEE ALSO"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">The full
documentation for <b>msggrep</b> is maintained as a Texinfo
manual. If the <b>info</b> and <b>msggrep</b> programs are
properly installed at your site, the command</p>
<p style="margin-left:22%; margin-top: 1em"><b>info
msggrep</b></p>
<p style="margin-left:11%; margin-top: 1em">should give you
access to the complete manual.</p>
<hr>
</body>
</html>