From cf965af3c5d233a1d62887d991d3a4e8996dbf70 Mon Sep 17 00:00:00 2001
From: David Baker <dbkr@matrix.org>
Date: Wed, 13 Aug 2014 14:40:47 +0100
Subject: [PATCH] Add troubleshooting section to help with PyNaCl bug.

---
 README.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.rst b/README.rst
index 2885c9f2f2..49c2105991 100644
--- a/README.rst
+++ b/README.rst
@@ -297,3 +297,9 @@ sphinxcontrib-napoleon::
 Building internal API documentation::
 
     $ python setup.py build_sphinx
+
+Troubleshooting
+===============
+
+fatal error: sodium.h: No such file or directory
+    There is a bug in PyNaCl 0.2.3 which can cause the module to fail to import. The bug is fixed in HEAD so you can work around it by checking PyNaCl out of git directly (https://github.com/pyca/pynacl) and installing it. Installing PyNaCl using pip may also work (remember to remove any other versions installed by setuputils in, for example, ~/.local/lib).