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.