On 24.04.2018 20:36, Aditya Bharti wrote:
Regarding building the documentation, I was able to figure out that I needed to install sphinx separately. The HACKING.rst.txt file only mentions Numpy Cython and pytest as dependencies. I was able to get the make command running with `make html PYVER=3.5`, but I'm getting the follwing error:
Could not import extension numpydoc (exception: cannot import name 'Directive')
Hello Aditya, I had the same problem with my setup. I'm still a little bit confused but I think the error was due to an old version of numpydoc trying use an import that didn't work with new versions of sphinx. I think got the old version with the git-submodules included in the doc-dirctory (can be downloaded with `git submodule update`). Anyway I got it to work by modifying the faulty import itself. Try to find the file numpydoc/numpydoc.py and try to find the line: from sphinx.util.compat import Directive If you can find that line you may be in luck because replacing that line with: from docutils.parsers.rst import Directive fixed it for me. I hope this helps. By the way, perhaps it would be useful to extend the doc/README.txt with a more thorough explanation of the build process and mention that the submodules can be downloaded with `git submodule update`. I only found out because I looked at guide for NumPy https://github.com/numpy/numpy/blob/master/doc/source/docs/howto_build_docs.... while trying to figure out the build process myself. Best regards, Lars