[>DESCRIPTION]
\fBdebtags\fP manages package tag data in a debian system and performs basic
queries on it.
.P
\fBdebtags\fP can be used to perform basic queries on the Debtags system: the
vocabulary can be queried with the \fBtagshow\fP and \fBtagsearch\fP commands;
a package tag database can be checked against the vocabulary with the
\fBcheck\fP command; the whole collection can be copied to standard output to
be processed with \fBtagcoll\fP or other tools by the \fBcat\fP command;
packages can be searched by tags using the \fBgrep\fP command. Finally, tags
can be listed with \fBtag ls\fP, edited with the \fBtag add\fP and \fBtag
rm\fP, and submitted to the Debtags database with \fBsubmit\fP.
.P
The \fBupdate\fP command can be used to download extra tags as listed in
\fI/etc/debtags/sources.list\fP: see the contents of that file for more
information.

[>EXAMPLES]
Here are some example invocations of \fBdebtags\fP:
.P
.nf
  # Update the package tag database
  debtags update

  # Show apt-cache informations about the mutt package,
  # adding tag informations
  debtags show mutt

  # Search the tag vocabulary for mail-related tags
  debtags tagsearch mail

  # Output a list of all packages which can edit raster images, excluding
  # shared libraries and dummy packages
  debtags search "use::editing && works-with::image:raster && \\
                ! (role::shared-lib || role::dummy)"

  # Show all mail clients
  debtags search 'works-with::mail && network::client'

  # Output the collection of all mail clients, ready to be reprocessed via
  # tagcoll
  debtags grep 'works-with::mail && network::client'

  # Produce an easily navigable hierarchy with the collection data
  debtags cat | tagcoll hierarchy

  # Produce a local tag patch
  debtags cat > work-tags
  ...edit work-tags...
  debtags diff work-tags > my-tagpatch

  # Submit the patch
  debtags submit my-tagpatch

  # Edit the tags of a package (the patch will be stored in ~/.debtags/patch)
  # then send your changes
  debtags tag add debtags implemented-in::c++ interface::commandline
  debtags tag rm debtags devel::buildtools
  debtags submit
.fi

[>FILES]
.TP
.B /var/lib/debtags/vocabulary
.br
The normative tag vocabulary
.TP
.B /var/lib/debtags/package\-tags
.br
The system package tags database, only kept as an easily parsable reference.
In the same directory there is a the binary index with the same content, used
by applications for fast access.
.TP
.B /etc/debtags/sources.list
.br
The list of sources to build the package tags database from

[>SEE ALSO]
.BR tagcoll (1),
.BR axi-cache (1),
.br
.BR http://wiki.debian.org/Debtags
.br
.BR http://debtags.debian.net
