querybts(1)

NAME

   querybts - view outstanding bug reports on a debbugs server

SYNOPSIS

   querybts [options] <package | number [number2]...>

DESCRIPTION

   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.

OPTIONS

   The program follows the  usual  GNU  command  line  syntax,  with  long
   options  starting  with  two  dashes  (`--').  A summary of options are
   included below.

   -h, --help
          Show summary of options.

   --version
          Show the version of querybts and exit.

   -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).

   -B SYSTEM, --bts=SYSTEM
          Instead of the Debian bug server, use the  server  specified  by
          SYSTEM.   Valid  options are default and debian but check --help
          for an updated list.

   -b, --buglist
          Display a bugs list for the given package.

   --latest-first
          Display the bug reports list sorted and with the latest  reports
          at the top.

   --mbox-reader-cmd=MBOX_READER_CMD
          Specify a command to open the bug reports mbox file. You can use
          %s to substitute the mbox file to be used, and %%  to  insert  a
          literal  percent sign. If no %s is specified, the mbox file name
          is supplied at the end of the argument list.

   -m, --mbox
          Retrieve the given bug number(s) or package name(s) as a mailbox
          file,  instead  of  viewing  it.  It  will be dumped to standard
          output.

   --proxy=PROXY, --http_proxy=PROXY
          Specify the WWW proxy server to use to handle the queries to the
          bug tracking system.  You should only need this parameter if you
          are behind a firewall.

   -s, --source
          Query on source packages, rather than binary packages.

   --timeout=SECONDS
          Specify the network timeout, the number of seconds to wait for a
          resource  to respond. If nothing is specified, a default timeout
          of 1 minute is selected.

          In case of a network error, there are chances it's due to a  too
          low  timeout:  try  passing  the  --timeout option with a higher
          value than default.

   -u INTERFACE, --ui=INTERFACE, --interface=INTERFACE
          Specify the user interface to  use.   Valid  options  are  text,
          urwid,  gtk2;  default is taken from the reportbug configuration
          files.

   -w, --web
          Launch a web browser to view bug reports, instead of  using  the
          internal  interface.   This will also allow you to see the whole
          discussion about a  particular  bug  at  once,  instead  of  one
          message  at  a  time  as querybts would do.  (Only the first bug
          number on the command line will be opened.)

CONFIGURATION FILES

   querybts supports a simple run control file syntax.  Commands are  read
   from  /etc/reportbug.conf  and  $HOME/.reportbugrc with commands in the
   latter overriding those in the former.

   Commands are not case sensitive, and currently take 0  or  1  argument;
   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 long options for querybts are
   supported,   without   leading   --   sequences.    See   the   default
   /etc/reportbug.conf  for  all  acceptable options and reportbug.conf(5)
   for all acceptable options and detailed information.

   Options only supported by reportbug will be silently ignored.

ENVIRONMENT

   http_proxy
          Provides the address of a proxy server to handle the BTS  query.
          This  should  be  a valid 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).

SEE ALSO

   reportbug(1), reportbug.conf(5)

AUTHOR

   Chris Lawrence <lawrencc@debian.org>, Sandro Tosi <morph@debian.org>.

                                                               querybts(1)

---

Free and Open Source Software