From b5e57bfefc170acc29124660db3c2c3f9b68da2a Mon Sep 17 00:00:00 2001
From: cjwatson <>
Date: Fri, 22 Aug 2003 01:36:19 -0800
Subject: [PATCH] [project @ 2003-08-22 02:36:19 by cjwatson] Add basic upgrade
 documentation. Install debbugs-upgradestatus.

---
 Makefile         |  3 ++-
 UPGRADE          | 11 +++++++++++
 debian/changelog |  3 +++
 3 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/Makefile b/Makefile
index cdcd78f..c5be9d1 100644
--- a/Makefile
+++ b/Makefile
@@ -59,9 +59,10 @@ $(var_dir)/spool/db-h $(scripts_dir) $(perl_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 migration tools
 	$(install_exec) migrate/debbugs-dbhash $(sbin_dir)
 	$(install_data) migrate/debbugs-dbhash.8 $(man8_dir)
+	$(install_exec) migrate/debbugs-upgradestatus $(sbin_dir)
 
 	# install the updateseqs file
 	$(install_data) misc/updateseqs $(var_dir)/spool
diff --git a/UPGRADE b/UPGRADE
index bbe1390..ad669c2 100644
--- a/UPGRADE
+++ b/UPGRADE
@@ -2,6 +2,17 @@
                             Debbugs upgrade notes
                            +=====================+
 
+From 2.4.1 to 2.4.2
+-------------------
+
+The file format used to store the status of a bug (package, severity, etc.)
+has changed; it is now in an RFC822-like format in order to be more
+extensible, and is written to .db files rather than the old .status files.
+Before accepting any mail with the new version of debbugs, you must run the
+'debbugs-upgradestatus' program over your bug spool. The old .status files
+will be left intact, and will continue to be written in sync with the .db
+files for compatibility with external tools.
+
 From 2.4 to 2.4.1
 -----------------
 
diff --git a/debian/changelog b/debian/changelog
index ac50c79..f1f3395 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -10,6 +10,9 @@ debbugs (2.4.2) UNRELEASED; urgency=low
     - Add support for an X-Debbugs-No-Ack: mail header to suppress
       acknowledgements.
     - Document how to deliver mail to debbugs via procmail and SpamAssassin.
+    - Implement new .status format that's extensible and easier to read; it
+      now lives in .db rather than .status. Use debbugs-upgradestatus to
+      convert existing bug databases.
 
  -- Colin Watson <cjwatson@debian.org>  Fri, 20 Jun 2003 18:57:25 +0100
 
-- 
2.39.2