summary refs log tree commit diff
path: root/README.rst
diff options
context:
space:
mode:
authorDavid Baker <dbkr@matrix.org>2014-08-13 14:40:47 +0100
committerDavid Baker <dbkr@matrix.org>2014-08-13 14:40:47 +0100
commitcf965af3c5d233a1d62887d991d3a4e8996dbf70 (patch)
tree5400584181e8dd82cb308082885d6adc978d919a /README.rst
parentUse strings instead of opaque magic-number constants for presence states; ren... (diff)
downloadsynapse-cf965af3c5d233a1d62887d991d3a4e8996dbf70.tar.xz
Add troubleshooting section to help with PyNaCl bug.
Diffstat (limited to 'README.rst')
-rw-r--r--README.rst6
1 files changed, 6 insertions, 0 deletions
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).