debbugsconfig - copy basic debbugs configuration files from templates

debbugsconfig

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.

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.

debbugsconfig was originally written by Darren Benham and later rewritten by Josip Rodin. Colin Watson wrote this man page.