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.
 
 
 
 
 

109 lines
4.0 KiB

  1. .TH querybts 1
  2. .SH NAME
  3. querybts \- view outstanding bug reports on a debbugs server
  4. .SH SYNOPSIS
  5. .B querybts
  6. .I "[options] <package | number [number2]...>"
  7. .SH "DESCRIPTION"
  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.
  13. .SH OPTIONS
  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.)
  78. .SH CONFIGURATION FILES
  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.
  92. .SH ENVIRONMENT
  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 <lawrencc@debian.org>,
  103. Sandro Tosi <morph@debian.org>.