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)