ipython's documentation generation uses sphinx with the numpydoc extension. Reproducible: Always
Created attachment 382006 [details, diff] include numpydoc as dependency for USE=doc
fine, ipython will be up for more changes, this can just wait and join or more complete list of changes
Found this bug report because I had the same problem. So I installed numpydoc manually. But there are more missing dependencies: * python2_7: running distutils-r1_run_phase python_compile_all make -j2 -C docs html make: Entering directory `/var/tmp/portage/dev-python/ipython-2.1.0/work/ipython-2.1.0-python2_7/docs' python autogen_api.py 313 files written Build API docs finished. mkdir -p build/html build/doctrees sphinx-build -b html -d build/doctrees source build/html Running Sphinx v1.1.3 Extension error: Could not import extension matplotlib.sphinxext.mathmpl (exception: No module named matplotlib.sphinxext.mathmpl) make: *** [html] Error 1 So I installed matplotlib, and now emerging ipython 2.1 went through. There were however a few glitches in the output while compiling the actual docs: --------------------- building [html]: targets for 388 source files that are out of date updating environment: 388 added, 0 changed, 0 removed [...] reading sources... [ 18%] api/generated/IPython.html.fabfile Traceback (most recent call last): File "/usr/lib64/python2.7/site-packages/sphinx/ext/autodoc.py", line 321, in import_object __import__(self.modname) File "/var/tmp/portage/dev-python/ipython-2.1.0/work/ipython-2.1.0-python2_7/build/lib/IPython/html/fabfile.py", line 3, in <module> from fabric.api import local,lcd ImportError: No module named fabric.api Traceback (most recent call last): File "/usr/lib64/python2.7/site-packages/sphinx/ext/autodoc.py", line 321, in import_object __import__(self.modname) File "/var/tmp/portage/dev-python/ipython-2.1.0/work/ipython-2.1.0-python2_7/build/lib/IPython/html/fabfile.py", line 3, in <module> from fabric.api import local,lcd ImportError: No module named fabric.api [...] reading sources... [ 58%] api/generated/IPython.parallel.controller.mongodb Traceback (most recent call last): File "/usr/lib64/python2.7/site-packages/sphinx/ext/autodoc.py", line 321, in import_object __import__(self.modname) File "/var/tmp/portage/dev-python/ipython-2.1.0/work/ipython-2.1.0-python2_7/build/lib/IPython/parallel/controller/mongodb.py", line 14, in <module> from pymongo import Connection ImportError: No module named pymongo Traceback (most recent call last): File "/usr/lib64/python2.7/site-packages/sphinx/ext/autodoc.py", line 321, in import_object __import__(self.modname) File "/var/tmp/portage/dev-python/ipython-2.1.0/work/ipython-2.1.0-python2_7/build/lib/IPython/parallel/controller/mongodb.py", line 14, in <module> from pymongo import Connection ImportError: No module named pymongo [...] reading sources... [ 70%] api/generated/IPython.testing.iptest Traceback (most recent call last): File "/usr/lib64/python2.7/site-packages/sphinx/ext/autodoc.py", line 321, in import_object __import__(self.modname) File "/var/tmp/portage/dev-python/ipython-2.1.0/work/ipython-2.1.0-python2_7/build/lib/IPython/testing/iptest.py", line 39, in <module> import nose.plugins.builtin ImportError: No module named nose.plugins.builtin [...] reading sources... [ 82%] config/extensions/cythonmagic Traceback (most recent call last): File "/usr/lib64/python2.7/site-packages/sphinx/ext/autodoc.py", line 321, in import_object __import__(self.modname) File "/var/tmp/portage/dev-python/ipython-2.1.0/work/ipython-2.1.0-python2_7/build/lib/IPython/extensions/cythonmagic.py", line 73, in <module> import Cython ImportError: No module named Cython reading sources... [ 83%] config/extensions/index reading sources... [ 83%] config/extensions/octavemagic Traceback (most recent call last): File "/usr/lib64/python2.7/site-packages/sphinx/ext/autodoc.py", line 321, in import_object __import__(self.modname) File "/var/tmp/portage/dev-python/ipython-2.1.0/work/ipython-2.1.0-python2_7/build/lib/IPython/extensions/octavemagic.py", line 48, in <module> import oct2py ImportError: No module named oct2py reading sources... [ 83%] config/extensions/rmagic Traceback (most recent call last): File "/usr/lib64/python2.7/site-packages/sphinx/ext/autodoc.py", line 321, in import_object __import__(self.modname) File "/var/tmp/portage/dev-python/ipython-2.1.0/work/ipython-2.1.0-python2_7/build/lib/IPython/extensions/rmagic.py", line 56, in <module> import rpy2.rinterface as ri ImportError: No module named rpy2.rinterface [...] --------------------- the affected pages seem empty in their respective content areas, for instance /usr/share/doc/python-2.1.0/html/config/extensions/cythonmagic.html
Building the docs is really messy. I will look into this once the testing is fixed. But don't expect too much. Currently, I'm getting more than 100 warnings which apparently originate from modules that are no longer present.
right. I actually emerged those deps then missed adding them to the ebuild. The prior version appears not to have even had a doc build. The doc build can wait. For now we're working the testsuite. However, so far we have numpydoc, matplotlib, fabric, nose, pymongo & rpy. Any more?
I have now; sphinx numpydoc nose cython rpy fabric matplotlib pymongo oct2py. matplotlib pymongo & oct2py are assured via REQUIRED_USE="doc? ( .... ) Also these deps will require additional keywording which I will add to the list already made for the ipython-2.1.0. Alternatively I can just delete the doc build, but that imo seems unnecessary. Are there any more to add? Holding off on account of further changes required.
fixed in the tree
