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
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
|
.\" Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH TAGGREP 1 "May 01, 2003" "0.13"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh disable hyphenation
.\" .hy enable hyphenation
.\" .ad l left justify
.\" .ad b justify to both left and right margins
.\" .nf disable filling
.\" .fi enable filling
.\" .br insert line break
.\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
taggrep \- print the parts of a tag collection matching a given tag expression
.SH SYNOPSIS
.B taggrep
.RI [ options ]
.RI [ expression ]
.RI [ files... ]
.br
.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 (`-').
.TP
.B \-\-help
Print an help message and exit.
.TP
.B \-\-version
Print the program version and exit.
.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 has been written by Enrico Zini <enrico@debian.org> for the
purpose of experimenting with tagged collections and related algorithms: all
possible feedback and ideas are thus more than welcome.
.P
Erich Schubert, Herv Eychenne, and many others have contributed a great deal
of feedback and ideas.
|
