# http://git.mdcc.cx/ad1810-doc.git
# note to self: see also nusku:~/debian/README and agni:~/debian/bts/Makefile


                           bts in 3 minutes

         "working offline with the Debian Bug Tracking System"

                                 by

             Joost van Baal-Ilić, autumn 2014, winter 2026


introduction
============

The bts utility is a Debian developers' command line interface to the Debian
Bug Tracking system (http://bugs.debian.org/).  It is written by Joey Hess,
Julian Gilbey, Josh Triplett e.a.

The bts utility is shipped with the "devscripts" Debian package by Christoph
Lameter, James McCoy e.a.; the devscripts code is available online at
https://salsa.debian.org/debian/devscripts/ .

Install bts by running

 % sudo apt --update install devscripts


example usage
=============

 % bts select package:frog
 723316
 734151

 % bts --cache-mode=mbox cache src:ucto
 Downloading http://bugs.debian.org/src:ucto ... (cached new version) 
 Downloading http://bugs.debian.org/735963 ... (cached new version) 1/2
 Downloading http://bugs.debian.org/722543 ... (cached new version) 2/2

 % bts --mbox show 769464

 % mutt -f ~/.devscripts_cache/bts/769464.mbox
 % w3m ~/devscripts_cache/bts/frog.html

refreshing the cache
====================

once you're online, refresh your bug cache by running

 % bts --cache-mode=mbox cache