DESCRIPTION end
|\fBdebtags\fP manages package tag data in a debian system and performs basic
|queries on it.
|.P
|Package data are activated or updated in the system using the \fBdebtags
|update\fP command; that must be run by root.  Tag data are pulled from a
|variety of sources listed in /etc/debtags/sources.list and merged together.
|.P
|Recently, a basic version of the tag data is also present in the APT database.
|It is a very useful resource for applications that are not using
|debtags-specific functions (such as apt-cache or grep-dctrl), but it does not
|support local changes or merging from different sources.
|.P
|\fBdebtags\fP itself can also 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; packages related to a given one (or
|group) can be shown with the \fBrelated\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.

OPTIONS end
|.SH 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
|
|  # Show packages related to mutt
|  # (adjust the distance as needed)
|  debtags related -d 7 mutt
|
|  # Show packages related to galeon and mozilla-browser
|  # (adjust the distance as needed)
|  debtags related -d 5 galeon,mozilla-browser
|
|  # 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 && media::rasterimage && \\
|                ! (role::aux-shlib || role::aux-dummy)"
|
|  # Show all mail clients
|  debtags search 'works-with::mail && role::sw:client'
|
|  # Output the collection of all mail clients, ready to be reprocessed via
|  # tagcoll
|  debtags grep 'works-with::mail && role::sw: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 mkpatch work-tags > my-tagpatch
|
|  # Produce a local tag patch with tagcolledit
|  debtags cat > orig-tags
|  debtags cat > work-tags
|  tagcolledit work-tags
|  tagcoll diff orig-tags work-tags > my-tagpatch
|
|  # Submit the patch
|  debtags submit my-tagpatch
|
|  # Install all IRC clients
|  debtags install 'protocol::irc && role::sw:client'
|
|  # Look for friends ;)
|  # (adjust the distance as needed)
|  debtags maintainers | tagcoll related -d 12 'Enrico Zini <enrico@debian.org>'
|.fi
|
|.SH FILES
|.TP
|.B /var/lib/debtags/vocabulary
|.br
|The normative tag vocabulary
|.TP
|.B /etc/debtags/sources.list
|.br
|The list of sources to build the package tags database from
|.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.
|
|.SH SEE ALSO
|.BR debtags-edit (1),
|.BR tagcoll (1),
|.BR tagcolledit (1),
|.BR apt-cache (1),
|.br
|.BR http://debtags.alioth.debian.org/
|.br
|.BR http://debian.vitavonni.de/packagebrowser/
