]> Sergey Matveev's repositories - public-inbox.git/commitdiff
INSTALL: note Debian bug #808610 corruption
authorEric Wong <e@80x24.org>
Sun, 29 May 2016 02:17:58 +0000 (02:17 +0000)
committerEric Wong <e@80x24.org>
Sun, 29 May 2016 02:23:24 +0000 (02:23 +0000)
Ugh, this is a nasty corruption bug and I can't recommend
this project for Debian 8.0 users without documenting this.

INSTALL

diff --git a/INSTALL b/INSTALL
index 40cd6cae638b95f90f0e5296b70d2d3bf9b2837c..e57fbb60d008beec65c693cdf5630d80c79a86f6 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -51,6 +51,30 @@ Optional modules:
 [3] - Optional for HTML web interface and HTTP/NNTP servers
 [4] - Optional for HTTP and NNTP servers
 
+When installing Search::Xapian, make sure the underlying Xapian
+is patched against the index corruption bug documented in:
+
+       https://bugs.debian.org/808610
+
+For Debian 8.0, this means installing from jessie-backports
+until the fix lands in jessie.
+
+# Ensure the following line is in your apt sources.list(5)
+# (typically /etc/apt/sources.list):
+
+deb http://http.us.debian.org/debian jessie-backports main
+
+Then run:
+
+       apt-get update
+       apt-get install -t jessie-backports libxapian22
+
+to install the package.
+
+public-inbox will never store unregeneratable data in Xapian
+or any other search database we might use; Xapian corruption
+will not destroy critical data.
+
 Copyright
 ---------