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)