# HG changeset patch
# User Paul Boddie <paul@boddie.org.uk>
# Date 1309040975 -7200
# Node ID 79c6bb24d33f1fe55dc3851e9641d04986076b6b
# Parent  2713c85b03df92bac18196790da7f04c2d53c4f6
Added Xapian troubleshooting advice.

diff -r 2713c85b03df -r 79c6bb24d33f README.txt
--- a/README.txt	Sat Jun 25 23:55:42 2011 +0200
+++ b/README.txt	Sun Jun 26 00:29:35 2011 +0200
@@ -207,6 +207,20 @@
 This affects installations where migrations between versions have occurred,
 yet the Wiki configuration retains old regular expression details.
 
+Xapian can be troublesome, especially where file permissions are concerned: if
+something acquires a lock on the index (for example, the moin script, possibly
+invoked via moinsetup) nothing else will be able to modify the index, and this
+may cause pages to become detached from their categories in the index.
+
+To resolve index issues, try and run the following command (with the appropriate
+options):
+
+moin --config-dir=path-to-wiki --wiki-url=example.com/ index build --mode=rebuild
+
+It may be necessary to manually remove locks. This can be done as follows:
+
+find path-to-wiki/data/cache/xapian -depth -name "*-lock" -type d -exec rmdir '{}' \;
+
 Contact, Copyright and Licence Information
 ------------------------------------------