.TH DEBTAGS 1 "October 26, 2014" "1.12.3" .SH NAME debtags \- Command line interface to access and manipulate Debian Package Tags .SH SYNOPSIS \fBdebtags\fP [options] [options and arguments] .SH 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. .SH COMMANDS \fBdebtags\fP accepts a non-switch argument, that indicates what is the operation that should be performed: .TP \fBhelp\fP [command] .br With no arguments, print a summary of available commands. If given a command name as argument, print detailed informations about that command. .TP \fBcat\fP .br output the full package tag database .TP \fBcheck\fP .br check that all the tags in the given tagged collection are present in the tag vocabulary. Checks the main database if no file is specified .TP \fBdiff\fP or \fBmkpatch\fP [filename] .br create a tag patch between the current tag database and the tag collection [filename]. Standard input is used if filename is not specified .TP \fBdumpavail\fP [tag expression] .br output the full package database .TP \fBgrep\fP .br output the lines of the full package tag database that match the given tag expression. A tag expression (given as a single argument) is an arbitrarily complex binary expression of tag names. For example: role::program && ((use::editing || use::viewing) && !works\-with::text) .TP \fBsearch\fP .br output the names and descriptions of the packages that match the given tag expression .TP \fBshow\fP .br show informations about a package, like apt\-cache show does, but adding the tag informations from the debtags index .TP \fBsubmit\fP [patch] .br upload the given patch file to the central tag repository. If [patch] is omitted, mail the local tag modifications (uses debtags\-submit\-patch) .TP \fBtag\fP {add|rm|ls} [tags...] .br General manipulation of tags, useful for automation in scripts. .br It can be used in three ways: .br tag add will add the tags to the given package .br tag rm will remove the tags from the given package .br tag ls will output the names of the tags of the given package .TP \fBtagcat\fP .br output the tag vocabulary .TP \fBtagshow\fP .br show the vocabulary informations about a tag .TP \fBtagsearch\fP .br show a summary of all tags whose data contains the given strings .TP \fBupdate\fP .br Collect package tag data from the sources listed in /etc/debtags/sources.list, then regenerate the debtags tag database and main index. .br It needs to be run as root .TP \fBvocfilter\fP tagfile .br filter out the tags that are not found in the given vocabulary file .SH OPTIONS This program follows the usual GNU command line syntax, with long options starting with two dashes (`\-'). Every one of the commands listed above has its own set of options. To keep this manpage readable, all the options are presented together. Please refer to "\fBdebtags\fP help \fIcommand\fP" to see which options are accepted by a given command. Help options: .TP .B \-h, \-?, \-\-help print commandline help and exit. .TP .B \-\-version print the program version and exit. .TP .B \-\-manpage=\fI[hooks]\fP output the debtags manpage and exit. .PP Other options: .TP .B \-v, \-\-verbose enable verbose output. .TP .B \-\-debug enable debugging output (including verbose output). \fBOptions for command help\fP .br \fBOptions for command cat\fP .br Options controlling matching of packages: .TP .B \-i, \-\-invert invert the match, selecting non-matching items. .PP Options controlling transformations of tag data on output: .TP .B \-\-facets output only the names of the facets (mainly used for computing statistics). .TP .B \-\-names output only the names of the packages. .TP .B \-q, \-\-quiet do not write anything to standard output. .PP \fBOptions for command check\fP .br \fBOptions for command diff\fP .br \fBOptions for command dumpavail\fP .br Options controlling matching of packages: .TP .B \-i, \-\-invert invert the match, selecting non-matching items. .PP Options controlling transformations of package data on output: .TP .B \-\-names output only the names of the packages. .TP .B \-q, \-\-quiet do not write anything to standard output. .TP .B \-\-full output the full record of package data. .TP .B \-\-short output the names of the packages, plus a short description. .PP \fBOptions for command grep\fP .br Options controlling matching of packages: .TP .B \-i, \-\-invert invert the match, selecting non-matching items. .PP Options controlling transformations of tag data on output: .TP .B \-\-facets output only the names of the facets (mainly used for computing statistics). .TP .B \-\-names output only the names of the packages. .TP .B \-q, \-\-quiet do not write anything to standard output. .PP \fBOptions for command search\fP .br Options controlling matching of packages: .TP .B \-i, \-\-invert invert the match, selecting non-matching items. .PP Options controlling transformations of package data on output: .TP .B \-\-names output only the names of the packages. .TP .B \-q, \-\-quiet do not write anything to standard output. .TP .B \-\-full output the full record of package data. .TP .B \-\-short output the names of the packages, plus a short description. .PP \fBOptions for command show\fP .br \fBOptions for command submit\fP .br \fBOptions for command tag\fP .br \fBOptions for command tagcat\fP .br \fBOptions for command tagshow\fP .br \fBOptions for command tagsearch\fP .br \fBOptions for command update\fP .br .TP .B \-\-local do not download files when performing an update. .TP .B \-\-reindex do not download any file, just do reindexing if needed. .PP \fBOptions for command vocfilter\fP .br .TP .B \-\-vocabulary=\fIfile\fP vocabulary file to use instead of the current debtags vocabulary. .PP .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 .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 .SH AUTHOR \fBdebtags\fP is maintained by enrico@enricozini.org. This manpage has been automatically generated by the debtags program.