DEBBUGSCONFIG(8) System Manager's Manual DEBBUGSCONFIG(8)NAME
debbugsconfig - copy basic debbugs configuration files from templates
SYNOPSIS
debbugsconfig
DESCRIPTION
debbugsconfig will copy basic debbugs configuration files from templates if the files do not already exist, and will also create BTS user
documentation in HTML and text. It should be run on installation and whenever /etc/debbugs/config or /etc/debbugs/text are changed.
FILES
debbugsconfig creates the following template configuration files in $gConfigDir (/etc/debbugs by default):
config General debbugs configuration file.
text Longer messages output by debbugs.
Maintainers
Index of maintainers for each package. This will typically be automatically generated.
Maintainers.override
Manual overrides for the maintainer index.
pseudo-packages.description
Descriptions of any entries in the system's maintainer index that do not correspond to "real" packages. For example, the
Debian Project uses pseudo-packages for bugs against facilities such as the Debian web site, the mailing list archives, and
the bug tracking system itself.
sources
Index of source packages corresponding to each package. This may be used when several packages are produced from a single
source, in which case the bug tracking system will group them together with links in the web front-end.
debbugsconfig creates the following template state files in $gSpoolDir (/var/lib/debbugs/spool by default):
nextnumber
The file which records the tracking number that will be assigned to the next incoming bug report.
index.archive.realtime
Real-time index of archived bugs. Created empty.
index.db.realtime
Real-time index of non-archived bugs. Created empty.
debbugsconfig creates the following documents in $gWebDir (/var/lib/debbugs/www by default):
index.html
Main contents page.
Access.html, bug-log-access.txt
Description of how to access bug reports.
Reporting.html, bug-reporting.txt
Advice on reporting bugs.
server-control.html, bug-maint-mailcontrol.txt
Introduction to the bug control and manipulation mail server.
server-refcard.html, bug-mailserver-refcard.txt
Mail servers' reference card.
server-request.html, bug-log-mailserver.txt
Introduction to the bug system request server.
AUTHORS
debbugsconfig was originally written by Darren Benham and later rewritten by Josip Rodin. Colin Watson wrote this man page.
DEBBUGSCONFIG(8)
Check Out this Related Man Page
querybts(1) General Commands Manual 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 sepa-
rate 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 lit-
eral 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 dis-
cussion 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)