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

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
|
|  # 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
|
|.SH 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
|
|.SH SEE ALSO
|.BR tagcoll (1),
|.BR axi-cache (1),
|.br
|.BR http://wiki.debian.org/Debtags
|.br
|.BR http://debtags.debian.net
