Add troubleshooting section to help with PyNaCl bug.

10 years ago · cf965af3c5
parent 55944ccf72
commit cf965af3c5
1 changed files with 6 additions and 0 deletions
--- 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).