[cvs] bogofilter NEWS,1.299,1.300 RELEASE.NOTES-0.93,1.5,1.6

[<m-...@us...>]

Update of /cvsroot/bogofilter/bogofilter
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv30617

Modified Files:
	NEWS RELEASE.NOTES-0.93 
Log Message:
Revise documentation WRT QDBM and DB changes/fixes.

Index: NEWS
===================================================================
RCS file: /cvsroot/bogofilter/bogofilter/NEWS,v
retrieving revision 1.299
retrieving revision 1.300
diff -u -d -r1.299 -r1.300
--- NEWS	30 Oct 2004 19:55:39 -0000	1.299
+++ NEWS	31 Oct 2004 21:55:26 -0000	1.300
@@ -7,11 +7,27 @@
 
 RELEASE.NOTES-0.93 has two important sections entitled:
 
-        MAJOR CHANGES IN BOGOFILTER 0.93 
-and     INCOMPATIBLE CHANGES IN BOGOFILTER 0.93
+        INCOMPATIBLE CHANGES IN BOGOFILTER 0.93
+and     MAJOR CHANGES IN BOGOFILTER 0.93
 
 0.93.0	2004-10-??
 
+	2004-10-31
+
+	* Rearranged flag setting for Berkeley DB data store, so as only to set
+	  DB_CHKSUM[_SHA1] when creating the data base.
+	  Fixes "checksum error: catastrophic recovery required" and
+	  consequential "wordlist.db: page 1: reference count overflow" errors
+	  reported by Torsten Veller.
+
+	* Revised RELEASE.NOTES-0.93 to move QDBM change into "Incompatible
+	  Changes" section and to mention BerkeleyDB dump/load for 4.1 and 4.2
+	  to add checksums.
+
+	* Inserted new section 2.2 into doc/README.db to mention that it is
+	  recommended to dump/load the data base when using BerkeleyDB 4.1 and
+	  4.2.
+
 	2004-10-30
 
 	* Converted QDBM from hash files (DEPOT API) to B+ trees

Index: RELEASE.NOTES-0.93
===================================================================
RCS file: /cvsroot/bogofilter/bogofilter/RELEASE.NOTES-0.93,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -d -r1.5 -r1.6
--- RELEASE.NOTES-0.93	30 Oct 2004 19:17:24 -0000	1.5
+++ RELEASE.NOTES-0.93	31 Oct 2004 21:55:27 -0000	1.6
@@ -1,7 +1,6 @@
                INCOMPATIBLE CHANGES IN BOGOFILTER 0.93
                =======================================
 
-
 Defaults changed
 ----------------
 
@@ -17,17 +16,37 @@
 information to classify (with certainty) as spam or ham.
 
 
+QDBM database format changed to B+ trees
+----------------------------------------
+
+The QDBM database format has been changed from hash tables to B+
+trees, i.e. from the Depot API to the Villa API.  This results in
+significantly better performance, i.e. faster speed.  Unfortunately,
+the two modes are incompatible, so upgrading to 0.93 requires several
+special steps, i.e. dumping and renaming your wordlist before
+installing 0.93 and building a new wordlist afterwards.
+
+Use these commands:
+
+1:  bogoutil -d /your/path/wordlist.qdbm > wordlist.txt
+2:  mv /your/path/wordlist.qdbm /your/path/wordlist.qdbm.old
+3:  install new bogofilter
+4:  bogoutil -l /your/path/wordlist.qdbm < wordlist.txt
+
 
                    MAJOR CHANGES IN BOGOFILTER 0.93
                    ================================
 
-
 Berkeley DB switched to Transactional Data Store
 ------------------------------------------------
 
 Bogofilter will now use the Berkeley DB Transactional Data Store when
 compiled with Berkeley DB as the data base engine (the default).
 
+When using BerkeleyDB 4.1 or 4.2, it is recommended that you dump and
+load the data bases to add checksums, for enhanced reliablity. See
+section 2.2 in doc/README.db for details.
+
 This means that bogofilter programs now exhibit the A C I D traits:
 changes are atomic (all-or-nothing); the data base is always consistent;
 changes are always isolated from each other; and all changes that are
@@ -51,21 +70,5 @@
 These benefits are not available when bogofilter is compiled to use the
 TDB or QDBM data bases.
 
-QDBM database format changed to B+ trees
-----------------------------------------
-
-The QDBM database format has been changed from hash tables to B+
-trees, i.e. from the DEPOT API to the Villa API.  This results in
-significantly better performance, i.e. faster speed.  Unfortunately,
-the two modes are incompatible, so upgrading to 0.9.3 requires several
-special steps, i.e. dumping and renaming your wordlist before
-installing 0.93 and building a new wordlist afterwards.
-
-Use these commands:
-
-1:  bogoutil -d /your/path/wordlist.db > wordlist.txt
-2:  mv /your/path/wordlist.db /your/path/wordlist.db.old
-3:  install new bogofilter
-4:  bogoutil -l /your/path/wordlist.db < wordlist.txt
 
                   --- END of RELEASE.NOTES-0.93 ---