- DEBIAN BUG TRACKING SYSTEM
- --------------------------
+ debbugs, Debian bug tracking system
+ -----------------------------------
This bug tracking system was developed by Ian Jackson from 1994-1997,
with assistance from nCipher Corporation Limited in 1997. nCipher allowed
Ian to redistribute modifications he made to the system while working as an
employee of nCipher.
+Since then, it has been developed by the various administrators of
+bugs.debian.org, including Darren Benham, Adam Heath, Josip Rodin, Anthony
+Towns, and Colin Watson. As in the case of Ian, nCipher allowed Colin to
+redistribute modifications he made while working as an employee of nCipher.
+
=============================================================================
SYSTEM REQUIREMENTS
=============================================================================
+
- GNU date
- GNU gzip
- Perl 5 (5.005 is known to work)
1. Run "make install" from the source directory.
2. Edit the config files in /etc/debbugs/ directory to suit your needs.
+Re-run debbugsconfig when you're finished to regenerate the
+documentation.
3. Set up the mail arrangements to deliver mail to the right place, and to
set up a blackhole mail alias if you need one. Ensure that owner@bugs, the
If you need a template, look in /usr/share/doc/debbugs/examples/ directory.
+=============================================================================
+CONTRIBUTING TO DEBBUGS
+=============================================================================
+
+Getting the Source Code
+
+Debbugs is managed in git. You can clone the repository into your local workspace as follows:
+
+git clone http://bugs-master.debian.org/debbugs-source/debbugs.git
+
+Additional branches are available from:
+
+ * http://git.donarmstrong.com/debbugs.git/ (Maintainer: Don Armstrong)
+
+Make a working branch for your code and check it out to start working:
+
+git checkout -b example-branch
+
+Stage and commit your changes using appropriate commit messages
+
+git add example-file
+
+git commit -m "Created an example file to demonstrate basic git commands."
+
+Submitting a Patch
+
+Submitting a patch can be done using git format-patch.
+
+For example
+
+git format-patch origin/master
+
+Creates .patch files for all commits since the branch diverged from master.
+
+Debbugs bugs are tracked using debbugs (what else). Patches should therefore be attached to the bug report for the issue. This can be done by emailing xxxx@bugs.debian.org (where xxxx is the bug number) with the patches attached. That's a terrible way of saying it, Stoopid.
+
+Feature patches can also be emailed to the maintaining list at debian-debbugs@lists.debian.org
+
=============================================================================
FURTHER INFORMATION
=============================================================================
-Web: http://benham.net/debbugs/
+
Email: debian-debbugs@lists.debian.org (mailing list)
- debian-debbugs-request@lists.debian.org with the word subscribe in the
- subject line
+ To subscribe, email debian-debbugs-request@lists.debian.org
+ with the word "subscribe" in the subject line
+Outdated web site: http://benham.net/debbugs/
=============================================================================
COPYRIGHT AND LACK-OF-WARRANTY NOTICE
=============================================================================
-Copyright 1999 Darren O. Benham <gecko@debian.org>
-Copyright 1994,1995,1996,1997 Ian Jackson <ijackson@chiark.greenend.org.uk>
-Copyright 1997 nCipher Corporation Limited
+
+Copyright 1999 Darren O. Benham
+Copyright 1994-1997 Ian Jackson
+Copyright 1997,2003 nCipher Corporation Limited
This bug system is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free
with this program, or one should be available above; if not, write to the
Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA
02111-1307, USA.
-
- - Darren Benham 14 Oct, 1999