Executable code from numpy.doc shouldn't be in %doc.
Also, why is sphinx documentation not being built?
+++ This bug was initially created as a clone of Bug #1032651 +++
Description of problem:
numpy missing doc module
Steps to Reproduce:
$ python -c "import numpy.doc"
Traceback (most recent call last):
File "<string>", line 1, in <module>
ImportError: No module named doc
Looks like this has been this way since at least 0.9.4. Looks like sometime along the way, the doc/ directory became a module instead of a collection of text files.
Test out 1.8.0-3 - that should have the doc module.
As for the sphinx docs, that is failing with:
$ make html
mkdir -p build
mkdir -p build/html build/doctrees
LANG=C sphinx-build -b html -d build/doctrees source build/html
Running Sphinx v1.1.3
NOTE: linkcode extension not found -- no links to source generated
Looks like we are missing the sphinx.ext.linkcode module in Fedora
You are right. But it seems that this dependency was added in numpy-1.8 because I can build documentation for 1.7 just fine:
copying static files... done
dumping search index... done
dumping object inventory... done
build succeeded, 637 warnings.
python postprocess.py html build/html/*.html
Build finished. The HTML pages are in build/html.
Although the number of warnings is quite alarming.
After some further investigation I can see that we have sphinx-1.1 in Fedora and the extension  is new in version 1.2  and this version of sphinx is currently in beta . So I guess that when sphinx-1.2 will be released we could give it a shot and try to build & package the documentation.
Created attachment 829362 [details]
patch to build sphinx documentation
I've managed to build the docs today, it took some time so I'm posting patch here so anyone else wouldn't have to spent time on it.
numpy-1.8.0-3.fc20 has been submitted as an update for Fedora 20.
Thanks Tomas. For now I've got the doc module in 1.8.0-3.fc20, and I'm building 1.7.1-7.fc19 with the doc module and the sphinx docs. I only am shipping the html dir - not sure if the doctrees and plot_directive dirs are useful - they do not seem to referenced by anything in html anyway.
I wasn't sure either. I think that html dir will be sufficient (apart from that, whole built documentation has 80 MB, so shipping only 40 (the html dir) will be much better).
Thanks for doing it Orion, great job!
numpy-1.8.0-3.fc20 has been pushed to the Fedora 20 stable repository. If problems still persist, please make note of it in this bug report.
Not sure why this didn't get closed.