1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58
|
.TH TAGGREP 1 "June 01, 2006" "1.6.2"
.SH NAME
taggrep \- Filter the contents of a tagged collection using a tag expression
.SH SYNOPSIS
\fBtaggrep\fP [options] <tag-expression> [file1 [file2 [...]]]
.SH DESCRIPTION
\fBtaggrep\fP is a commandline utility to filter the elements of a tagged
collection.
.P
A tagged collection is a set of items in which each item is associated with a
set of zero or more tags, in no particular order.
.P
\fBtaggrep\fP reads a tagged collection and, like \fBgrep\fP, prints only the lines
that match or do not match a given expression. Like \fBgrep\fP uses regular
expression to match strings, \fBtaggrep\fP uses tag expressions to match the
set of tags associated to a given item.
.P
For documentation on the format of tagged collections and tag expressions,
please refer to the \fBtagcoll(1)\fP manpage.
.SH OPTIONS
This program follows the usual GNU command line syntax, with long options starting with two dashes (`\-').
Help options:
.TP
.B \-h, \-?, \-\-help
print an help message and exit.
.TP
.B \-V, \-\-version
print the program version and exit.
.PP
Other options:
.TP
.B \-v, \-\-invert-match
invert the sense of matching, to select non-matching lines.
.TP
.B \-q, \-\-quiet
do not write anything to standard output, but exit with 0 if any match is found.
.SH EXAMPLES
.P
.nf
# Output the collection of all mail clients
taggrep 'mail && client' collection
# Output a collection without all elements marked with 'partially-tagged'
taggrep -v 'partially-tagged' collection
# Check if a collection contains mail clients and word processors
taggrep -q '(mail && client) || office::wordproc' collection-file && echo Yes
.fi
.SH SEE ALSO
tagcoll(1)
.SH AUTHOR
\fBtaggrep\fP is maintained by enrico@debian.org.
This manpage has been automatically generated by the taggrep program.
|