[project @ 2002-11-25 12:25:05 by cjwatson]

Add a man page for debbugsconfig.

diff --git a/Makefile b/Makefile
index ff5dc1debc7b2f912a6750d3ad4b7d23ade42b15..16fb5ee99050f54681c0b5988b7585ecbc42e33b 100644 (file)
--- 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 5fa8cd5566476d246519233f74f13d9650b43363..19165d45e264f4a837663155989016cc18239e41 100644 (file)
--- 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 (file)
index 0000000..ea05557
--- /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 7bdc0c6b670315a80c5f592f35283f4769fdab36..0929fc3f7d4c821cb34f7038cdd4ed2871fac37e 100755 (executable)
--- 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