From 16cff2b08663f532fcd83660082380a1faaee618 Mon Sep 17 00:00:00 2001
From: cjwatson <>
Date: Mon, 25 Nov 2002 12:25:05 -0800
Subject: [PATCH] [project @ 2002-11-25 12:25:05 by cjwatson] Add a man page
 for debbugsconfig.

---
 Makefile               |  1 +
 debian/changelog       | 10 +++++
 debian/debbugsconfig.8 | 99 ++++++++++++++++++++++++++++++++++++++++++
 debian/rules           |  1 -
 4 files changed, 110 insertions(+), 1 deletion(-)
 create mode 100644 debian/debbugsconfig.8

diff --git a/Makefile b/Makefile
index ff5dc1de..16fb5ee9 100644
--- a/Makefile
+++ b/Makefile
@@ -53,6 +53,7 @@ $(var_dir)/spool/db-h $(scripts_dir) $(examples_dir) $(man8_dir); \
 
 	# install debbugsconfig
 	$(install_exec) debian/debbugsconfig $(sbin_dir)
+	$(install_data) debian/debbugsconfig.8 $(man8_dir)
 	# install the debbugs-dbhash migration tool
 	$(install_exec) migrate/debbugs-dbhash $(sbin_dir)
 	$(install_data) migrate/debbugs-dbhash.8 $(man8_dir)
diff --git a/debian/changelog b/debian/changelog
index 5fa8cd55..19165d45 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,13 @@
+debbugs (2.4.1) UNRELEASED; urgency=low
+
+  * Exit the CGI scripts straight away if the HTTP method is HEAD, to save
+    pointless work. [Colin]
+  * Display pending+fixed bugs as "fixed in NMU", not "pending upload".
+    [Colin]
+  * Add a man page for debbugsconfig. [Colin]
+
+ -- Colin Watson <cjwatson@debian.org>  Mon, 25 Nov 2002 03:50:20 +0000
+
 debbugs (2.4) experimental; urgency=low
 
   * Updating the package with what's in CVS, even though this might
diff --git a/debian/debbugsconfig.8 b/debian/debbugsconfig.8
new file mode 100644
index 00000000..ea05557b
--- /dev/null
+++ b/debian/debbugsconfig.8
@@ -0,0 +1,99 @@
+.TH DEBBUGSCONFIG 8
+.SH NAME
+debbugsconfig \- copy basic debbugs configuration files from templates
+.SH SYNOPSIS
+.B debbugsconfig
+.SH DESCRIPTION
+.B 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
+.I /etc/debbugs/config
+or
+.I /etc/debbugs/text
+are changed.
+.SH FILES
+.B debbugsconfig
+creates the following template configuration files in
+.I $gConfigDir
+.RI ( /etc/debbugs
+by default):
+.RS
+.TP
+.I config
+General debbugs configuration file.
+.TP
+.I text
+Longer messages output by debbugs.
+.TP
+.I Maintainers
+Index of maintainers for each package.
+This will typically be automatically generated.
+.TP
+.I Maintainers.override
+Manual overrides for the maintainer index.
+.TP
+.I pseudo-packages.description
+Descriptions of any entries in the system's maintainer index that do not
+correspond to \(lqreal\(rq 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.
+.TP
+.I 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.
+.RE
+.PP
+.B debbugsconfig
+creates the following template state files in
+.I $gSpoolDir
+.RI ( /var/lib/debbugs/spool
+by default):
+.RS
+.TP
+.I nextnumber
+The file which records the tracking number that will be assigned to the
+next incoming bug report.
+.TP
+.I index.archive.realtime
+Real-time index of archived bugs.
+Created empty.
+.TP
+.I index.db.realtime
+Real-time index of non-archived bugs.
+Created empty.
+.RE
+.PP
+.B debbugsconfig
+creates the following documents in
+.I $gWebDir
+.RI ( /var/lib/debbugs/www
+by default):
+.RS
+.TP
+.I index.html
+Main contents page.
+.TP
+.IR Access.html ", " bug-log-access.txt
+Description of how to access bug reports.
+.TP
+.IR Reporting.html ", " bug-reporting.txt
+Advice on reporting bugs.
+.TP
+.IR server-control.html ", " bug-maint-mailcontrol.txt
+Introduction to the bug control and manipulation mail server.
+.TP
+.IR server-refcard.html ", " bug-mailserver-refcard.txt
+Mail servers' reference card.
+.TP
+.IR server-request.html ", " bug-log-mailserver.txt
+Introduction to the bug system request server.
+.RE
+.SH AUTHORS
+.B debbugsconfig
+was originally written by Darren Benham.
+Colin Watson wrote this man page.
diff --git a/debian/rules b/debian/rules
index 7bdc0c6b..0929fc3f 100755
--- a/debian/rules
+++ b/debian/rules
@@ -28,7 +28,6 @@ binary-indep: build install
 	$(MAKE) install_mostfiles DESTDIR=$(tmp_dir)
 	dh_installdocs
 	dh_installchangelogs
-	dh_undocumented debbugsconfig.8
 	dh_strip
 	dh_compress -X examples/text
 	dh_fixperms
-- 
2.39.5