debtags(1)


NAME

   debtags - Debian Package Tags support tools

DESCRIPTION

   usage: debtags [-h] [--version] [--verbose] [--debug]

          {tag,cat,grep,check,diff,mkpatch,search,dumpavail,show,submit,tagcat,tagshow,tagsearch,update,vocfilter}
          ...

   Command line interface to access and manipulate Debian Package Tags

   optional arguments:
   -h, --help
          show this help message and exit

   --version
          show program's version number and exit

   --verbose, -v
          enable verbose output

   --debug
          enable debugging output (including verbose output)

   subcommands:
          valid subcommands

   {tag,cat,grep,check,diff,mkpatch,search,dumpavail,show,submit,tagcat,tagshow,tagsearch,update,vocfilter}
          additional help

   tag    (not implemented anymore)

   cat (grep)
          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)

   check  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

   diff (mkpatch)
          Create  a tag patch between the current tag database and the tag
          collection [filename]. Standard input is used if filename is not
          specified

   search (dumpavail)
          Output the packages matching the given tag expression

   show   (deprecated) mostly the same as apt-cache show <pkgnames>

   submit (no  longer  supported) see https://debtags.debian.org/api/patch
          for patch submit.

   tagcat Output the tag vocabulary

   tagshow
          Show the vocabulary information about a tag

   tagsearch
          Show a summary of all tags whose data contains the given strings

   update Updates the package tag database (requires root) Collect package
          tag data from apt cache, regenerate the debtags tag database and
          main index. It needs to be run as root

   vocfilter
          Filter out the tags that are not found in the  given  vocabulary
          file  debtags  manages  package  tag data in a debian system and
          performs basic queries on it.

   debtags can be used to perform basic queries on the Debtags system: the
   vocabulary  can  be  queried with the tagshow and tagsearch commands; a
   package tag database can be checked against  the  vocabulary  with  the
   check command; the whole collection can be copied to standard output to
   be processed with tagcoll or other tools by the cat  command;  packages
   can  be  searched  by tags using the grep command. Finally, tags can be
   listed with tag ls, edited with the tag add and tag rm,  and  submitted
   to the Debtags database with submit.

   The  update  command  can  be  used to download extra tags as listed in
   /etc/debtags/sources.list: see the  contents  of  that  file  for  more
   information.

FILES

   /var/lib/debtags/vocabulary
          The normative tag vocabulary

   /var/lib/debtags/package-tags
          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.

   /etc/debtags/sources.list
          The list of sources to build the package tags database from

EXAMPLES

   Here are some example invocations of debtags:

     # Update the package tag database
     debtags update

     # Show apt-cache information about the mutt package,
     # adding tag information
     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

SEE ALSO

   tagcoll(1), axi-cache(1),
   http://wiki.debian.org/Debtags
   http://debtags.debian.net





Opportunity


Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.





Free Software


Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.


Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.





Free Books


The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.


Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.





Education


Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.


Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.