Provided by: reportbug_5.1.1ubuntu1_all bug

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.

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

       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.

       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)