---
name: "taggrep"
section: "1"
platform: "linux"
package: "libtagcoll-dev"
version: "1.6.3-2"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/taggrep"
---

# taggrep(1)

Filter the contents of a tagged collection using a tag expression

## NAME

taggrep - Filter the contents of a tagged collection using a tag expression

## SYNOPSIS

**taggrep** \[options\] \<tag-expression\> \[file1 \[file2 \[...\]\]\]

## DESCRIPTION

**taggrep** is a commandline utility to filter the elements of a tagged collection.

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.

**taggrep** reads a tagged collection and, like **grep**, prints only the lines that match or do not match a given expression.  Like **grep** uses regular expression to match strings, **taggrep** uses tag expressions to match the set of tags associated to a given item.

For documentation on the format of tagged collections and tag expressions, please refer to the **[tagcoll(1)](/tagcoll/1.md)** manpage.

## OPTIONS

This program follows the usual GNU command line syntax, with long options starting with two dashes (\`-').

Help options:

- **-h, -?, --help**

  print an help message and exit.

- **-V, --version**

  print the program version and exit.

Other options:

- **-v, --invert-match**

  invert the sense of matching, to select non-matching lines.

- **-q, --quiet**

  do not write anything to standard output, but exit with 0 if any match is found.

## EXAMPLES

```
# 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
```

## SEE ALSO

[tagcoll(1)](/tagcoll/1.md)

## AUTHOR

**taggrep** is maintained by enrico@debian.org.

This manpage has been automatically generated by the taggrep program.