DESCRIPTION end
|\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.

OPTIONS end
|.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)
