From: Eric Wong <e@80x24.org>
Date: Sun, 29 May 2016 02:17:58 +0000 (+0000)
Subject: INSTALL: note Debian bug #808610 corruption
X-Git-Tag: v1.0.0~476
X-Git-Url: http://www.git.stargrave.org/?p=public-inbox.git;a=commitdiff_plain;h=2980bf96b647f2e2461ded6b5c05da13ab89650f

INSTALL: note Debian bug #808610 corruption

Ugh, this is a nasty corruption bug and I can't recommend
this project for Debian 8.0 users without documenting this.
---

diff --git a/INSTALL b/INSTALL
index 40cd6cae..e57fbb60 100644
--- 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
 ---------