1 DEBIAN BUG TRACKING SYSTEM
2 --------------------------
4 This bug tracking system was developed by Ian Jackson from 1994-1997,
5 with assistance from nCipher Corporation Limited in 1997. nCipher allowed
6 Ian to redistribute modifications he made to the system while working as an
9 =============================================================================
11 =============================================================================
15 - Perl 5 (5.004 is known to work)
16 - Mailtools perl module to manipulate email
18 - The bug system requires its own mail domain. It comes with code
19 which understands how exim, qmail and sendmail deliver mail for such a
21 - A webserver (this is easiest if the bug system can write
22 directly to the webspace).
23 - Somewhere to run CGI scripts (unless you don't need the `go to
24 bug' and `go to package' forms to work).
26 =============================================================================
27 INSTALLATION INSTRUCTIONS
28 =============================================================================
29 1. Install the deb. If you don't have a deb, consult the file list at the
32 2. Copy the template files from /usr/share/doc/debbugs/examples to
33 /etc/debbugs. Edit the config file, it is necessary. Edit the text file if
34 you wish to change some of the text as it gets displayed.
36 3. Run "debbugsconfig"
38 4. Edit the /etc/debbugs/Maintainers file in the format of
39 "package<whitespece>maintianer".
41 5. Set up the mail arrangements to deliver mail to the right place, and to
42 set up a blackhole mail alias if you need one. Ensure that owner@bugs, if
43 that's what you're using, is handled by the MTA.
45 6. Test things a bit, by sending mail messages to the bug system and
46 running .../scripts/processall and/or .../scripts/update-html.
48 7. If all seems well then install the crontab in `misc/crontab.out'.
50 =============================================================================
52 =============================================================================
53 Web: http://benham.net/debbugs/
54 Email: debbugs@benham.net (mailing list)
55 debbugs-REQUEST@benham.net with the word subscribe in the body
57 =============================================================================
58 Filelist of installed files
59 =============================================================================
60 ********************config files**
61 -rw-r--r-- root/root 1293 1999-10-14 13:14:08 ./etc/debbugs/html/Access.html
62 -rw-r--r-- root/root 6983 1999-10-14 13:14:08 ./etc/debbugs/html/Reporting.html
63 -rw-r--r-- root/root 7460 1999-10-14 13:14:08 ./etc/debbugs/html/Developer.html
64 -rw-r--r-- root/root 3394 1999-10-14 13:14:08 ./etc/debbugs/html/index.html
65 -rw-r--r-- root/root 7608 1999-10-14 13:14:08 ./etc/debbugs/html/server-control.html
66 -rw-r--r-- root/root 6434 1999-10-14 13:14:08 ./etc/debbugs/html/server-request.html
67 -rw-r--r-- root/root 3579 1999-10-14 13:14:08 ./etc/debbugs/html/server-refcard.html
68 -rw-r--r-- root/root 2 1999-10-14 13:14:08 ./etc/debbugs/lynx-cfg
69 -rw-r--r-- root/root 79 1999-10-14 13:14:08 ./etc/debbugs/Maintainers
70 -rw-r--r-- root/root 59 1999-10-14 13:14:08 ./etc/debbugs/pseudo-packages.description
71 ********************scripts**
72 -rwxr-xr-x root/root 177 1999-10-14 13:14:07 ./usr/lib/debbugs/age-1
73 -rwxr-xr-x root/root 24471 1999-10-14 13:14:07 ./usr/lib/debbugs/db2html
74 -rwxr-xr-x root/root 2159 1999-10-14 13:14:07 ./usr/lib/debbugs/expire
75 -rwxr-xr-x root/root 3925 1999-10-14 13:14:07 ./usr/lib/debbugs/html-install
76 -rwxr-xr-x root/root 2747 1999-10-14 13:14:07 ./usr/lib/debbugs/mailsummary
77 -rwxr-xr-x root/root 1621 1999-10-14 13:14:07 ./usr/lib/debbugs/processall
78 -rwxr-xr-x root/root 25566 1999-10-14 13:14:08 ./usr/lib/debbugs/service
79 -rw-r--r-- root/root 2952 1999-10-14 13:14:08 ./usr/lib/debbugs/errorlib
80 -rwxr-xr-x root/root 3024 1999-10-14 13:14:08 ./usr/lib/debbugs/html-control
81 -rwxr-xr-x root/root 29290 1999-10-14 13:14:08 ./usr/lib/debbugs/process
82 -rwxr-xr-x root/root 3664 1999-10-14 13:14:08 ./usr/lib/debbugs/receive
83 -rwxr-xr-x root/root 3056 1999-10-14 13:14:08 ./usr/lib/debbugs/summary
84 ********************admin scripts*
85 -rwxr-xr-x root/root 1958 1999-10-14 13:14:08 ./usr/sbin/debbugsconfig
86 -rwxr-xr-x root/root 859 1999-10-14 13:14:08 ./usr/sbin/debbugs-maketxt
87 ********************documentation**
88 -rw-r--r-- root/root 2390 1999-10-14 13:14:08 ./usr/share/doc/debbugs/examples/config
89 -rw-r--r-- root/root 11146 1999-10-14 13:14:08 ./usr/share/doc/debbugs/examples/text
90 -rw-r--r-- root/root 432 1999-10-14 13:14:08 ./usr/share/doc/debbugs/examples/crontab
91 -rw-r--r-- root/root 3 1999-10-14 13:14:08 ./usr/share/doc/debbugs/examples/nextnumber
92 -rw-r--r-- root/root 321 1999-04-02 10:12:03 ./usr/share/doc/debbugs/TODO
93 -rw-r--r-- root/root 1430 1999-04-02 10:08:36 ./usr/share/doc/debbugs/README.Debian
94 -rw-r--r-- root/root 321 1999-04-02 10:12:03 ./usr/share/doc/debbugs/TODO.Debian
95 -rw-r--r-- root/root 1419 1999-03-27 11:26:38 ./usr/share/doc/debbugs/copyright
96 -rw-r--r-- root/root 1977 1999-04-16 17:21:00 ./usr/share/doc/debbugs/README.mail.gz
97 -rw-r--r-- root/root 812 1999-07-27 11:27:22 ./usr/share/doc/debbugs/changelog.Debian.gz
98 ********************web/data files
99 drwxr-xr-x root/root 0 1999-10-14 13:14:08 ./var/lib/debbugs/www/cgi/
100 -rwxr-xr-x root/root 1807 1999-10-14 13:14:08 ./var/lib/debbugs/www/cgi/bugs-fetch2.pl
101 -rwxr-xr-x root/root 4755 1999-10-14 13:14:08 ./var/lib/debbugs/www/cgi/cgi-lib.pl
102 drwxr-xr-x root/root 0 1999-10-14 13:14:08 ./var/lib/debbugs/www/db/
103 -rw-r--r-- root/root 37 1999-10-14 13:14:08 ./var/lib/debbugs/www/db/.htaccess
104 drwxr-xr-x root/root 0 1999-10-14 13:14:07 ./var/lib/debbugs/www/txt/
105 -rw-r--r-- root/root 17 1999-10-14 13:14:08 ./var/lib/debbugs/spool/updateseqs
106 ********************needed, precreated directories
107 drwxr-xr-x root/root 0 1999-10-14 13:14:07 ./var/lib/debbugs/indices/
108 drwxr-xr-x root/root 0 1999-10-14 13:14:07 ./var/lib/debbugs/spool/lock/
109 drwxr-xr-x root/root 0 1999-10-14 13:14:07 ./var/lib/debbugs/spool/archive/
110 drwxr-xr-x root/root 0 1999-10-14 13:14:07 ./var/lib/debbugs/spool/incoming/
111 drwxr-xr-x root/root 0 1999-10-14 13:14:07 ./var/lib/debbugs/spool/db/
113 =============================================================================
114 COPYRIGHT AND LACK-OF-WARRANTY NOTICE
115 =============================================================================
116 Copyright 1999 Darren O. Benham <gecko@debian.org>
117 Copyright 1994,1995,1996,1997 Ian Jackson <ijackson@chiark.greenend.org.uk>
118 Copyright 1997 nCipher Corporation Limited
119 Copyright 1995 Steven Brenner (for cgi-lib.pl).
121 This bug system is free software; you can redistribute it and/or modify it
122 under the terms of the GNU General Public License as published by the Free
123 Software Foundation; version 2 of the License.
125 This program and documentation is distributed in the hope that it will be
126 useful, but without any warranty; without even the implied warranty of
127 merchantability or fitness for a particular purpose. See the GNU General
128 Public License for more details.
130 You should have received a copy of the GNU General Public License along
131 with this program, or one should be available above; if not, write to the
132 Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA