You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

querybts.1 4.0 KiB

  1. .TH querybts 1
  2. .SH NAME
  3. querybts \- view outstanding bug reports on a debbugs server
  5. .B querybts
  6. .I "[options] <package | number [number2]...>"
  8. .B querybts
  9. is designed to provide a convenient and easy-to-use interface to the
  10. Debbugs bug tracking system, as used by Debian and several other
  11. projects. You can specify a package name or one or more report
  12. numbers.
  14. The program follows the usual GNU command line syntax, with long
  15. options starting with two dashes (`\fB\-\-\fP'). A summary of options
  16. are included below.
  17. .TP
  18. .B \-h, \-\-help
  19. Show summary of options.
  20. .TP
  21. .B \-\-version
  22. Show the version of \fBquerybts\fP and exit.
  23. .TP
  24. .B \-A, \-\-archive
  25. Browse archived bugs instead of current reports. Debbugs servers
  26. clear out closed reports after 28 days and place them in a separate
  27. archive; this option allows those older, resolved reports to be viewed
  28. (at least for servers that maintain an archive).
  29. .TP
  30. .B \-B SYSTEM, \-\-bts=SYSTEM
  31. Instead of the Debian bug server, use the server specified by
  32. \fBSYSTEM\fP. Valid options are \fBdefault\fP and \fBdebian\fP but
  33. check \fB\-\-help\fP for an updated list.
  34. .TP
  35. .B \-b, \-\-buglist
  36. Display a bugs list for the given package.
  37. .TP
  38. .B \-\-latest-first
  39. Display the bug reports list sorted and with the latest reports at the top.
  40. .TP
  41. .B \-\-mbox\-reader\-cmd=MBOX_READER_CMD
  42. Specify a command to open the bug reports mbox file. You can use
  43. \fB%s\fP to substitute the mbox file to be used, and \fB%%\fP to insert
  44. a literal percent sign. If no \fB%s\fP is specified, the mbox file name
  45. is supplied at the end of the argument list.
  46. .TP
  47. .B \-m, \-\-mbox
  48. Retrieve the given bug number(s) or package name(s) as a mailbox file,
  49. instead of viewing it. It will be dumped to standard output.
  50. .TP
  51. .B \-\-proxy=PROXY, \-\-http_proxy=PROXY
  52. Specify the WWW proxy server to use to handle the queries to the bug
  53. tracking system. You should only need this parameter if you are
  54. behind a firewall.
  55. .TP
  56. .B \-s, \-\-source
  57. Query on source packages, rather than binary packages.
  58. .TP
  59. .B \-\-timeout=SECONDS
  60. Specify the network timeout, the number of seconds to wait for a
  61. resource to respond. If nothing is specified, a default timeout of 1
  62. minute is selected.
  63. In case of a network error, there are chances it's due to a too low
  64. timeout: try passing the \-\-timeout option with a higher value than
  65. default.
  66. .TP
  67. .B \-u INTERFACE, \-\-ui=INTERFACE, \-\-interface=INTERFACE
  68. Specify the user interface to use. Valid options are \fBtext\fP,
  69. \fBurwid\fP, \fBgtk2\fP; default is taken from the reportbug
  70. configuration files.
  71. .TP
  72. .B \-w, \-\-web
  73. Launch a web browser to view bug reports, instead of using the
  74. internal interface. This will also allow you to see the whole
  75. discussion about a particular bug at once, instead of one message at a
  76. time as \fBquerybts\fP would do. (Only the first bug number on the
  77. command line will be opened.)
  79. .B querybts
  80. supports a simple run control file syntax. Commands are read from
  81. \fB/etc/reportbug.conf\fP and \fB$HOME/.reportbugrc\fP with commands
  82. in the latter overriding those in the former.
  83. Commands are not case sensitive, and currently take 0 or 1 argument;
  84. arguments containing whitespace must be enclosed in quotes.
  85. Any line starting with # is taken to be a comment and will be ignored.
  86. Generally, options corresponding to the long options for
  87. \fBquerybts\fP are supported, without leading \fB\-\-\fP sequences.
  88. See the default \fB/etc/reportbug.conf\fP for all acceptable options
  89. and \fBreportbug.conf(5)\fP for all acceptable options and detailed
  90. information.
  91. Options only supported by \fBreportbug\fP will be silently ignored.
  93. .TP
  94. .B http_proxy
  95. Provides the address of a proxy server to handle the BTS query. This
  96. should be a valid \fBhttp\fP URL for a proxy server, including any
  97. required port number (simply specifying a hostname, or omitting a port
  98. other than 80, WILL NOT WORK).
  99. .SH "SEE ALSO"
  100. reportbug(1), reportbug.conf(5)
  101. .SH AUTHOR
  102. Chris Lawrence <>,
  103. Sandro Tosi <>.