.TH querybts 1
.SH NAME
querybts \- view outstanding bug reports on a debbugs server
.SH SYNOPSIS
.B querybts
.I "[options] <package | number [number2]...>"
.SH "DESCRIPTION"
.B querybts
is designed to provide a convenient and easy-to-use interface to the
Debbugs bug tracking system, as used by Debian and several other
projects.  You can specify a package name or one or more report
numbers.
.SH OPTIONS
The program follows the usual GNU command line syntax, with long
options starting with two dashes (`\-\-').
A summary of options are included below.
.TP
.B \-h, \-\-help
Show summary of options.
.TP
.B \-v, \-\-version
Show the version of
.B querybts
and exit.
.TP
.B \-A, \-\-archive
Browse archived bugs instead of current reports.  Debbugs servers
clear out closed reports after 28 days and place them in a separate
archive; this option allows those older, resolved reports to be viewed
(at least for servers that maintain an archive).
.TP
.B \-B SYSTEM, \-\-bts=SYSTEM
Instead of the Debian bug server, use the server specified by
.B SYSTEM.
You can specify
.B help
to get a list of supported servers.
.TP
.B \-m, \-\-mbox
Retrieve the given bug number as a mailbox file, instead of viewing
it.  It will be dumped to standard output.
.TP
.B \-\-proxy=PROXY, \-\-http_proxy=PROXY
Specify the WWW proxy server to use to handle the query of the bug
tracking system.  You should only need this parameter if you are
behind a firewall.
.TP
.B \-s, \-\-source
Query on source packages, rather than binary packages.
.TP
.B \-w, \-\-web
Launch a web browser to view bug reports, instead of using the
internal interface.  This will also allow you to see all of the
discussion about a particular bug, instead of the initial report.
(Only the first bug number on the command line will be opened.)
.SH CONFIGURATION FILES
.B querybts
supports a simple run control file syntax.  Commands are read from
.B /etc/reportbug.conf
and
.B $HOME/.reportbugrc
with commands in the latter overriding those in the former.  Commands
are not case sensitive, and currently take 0 or 1 arguments; arguments
containing whitespace must be enclosed in quotes.  Any line starting
with # is taken to be a comment and will be ignored.

Generally, options corresponding to the GNU long options for
.B querybts
are supported, without leading \-\- sequences.  See the default
.B /etc/reportbug.conf
for all acceptable options.  Options only supported by
.B reportbug
will be silently ignored.
.SH ENVIRONMENT
.TP
.B BROWSER
Colon-separated list of web browsers to try; they will be tried in
order, until one succeeds.  You can use %s to substitute the URL to be
used, and %% to insert a literal percent sign.  If no %s is specified,
the URL will be supplied as a normal argument.
.TP
.B http_proxy
Provides the address of a proxy server to handle the BTS query.  This
should be a valid
.B http
URL for a proxy server, including any required port number (simply
specifying a hostname, or omitting a port other than 80, WILL NOT WORK).
.SH NOTES
Python's getopt module is pickier than GNU getopt() about the order of
command line arguments; all switches must be specified before the
package name.

You must have the python-newt package installed to run this program.
.SH "SEE ALSO"
reportbug(1)
.SH AUTHOR
Chris Lawrence <lawrencc@debian.org>.