[IPython-dev] GSoC applicants: patch and blog required

[Fernando Perez]

On Thu, Apr 15, 2010 at 2:29 PM, Gerardo Gutierrez <muzgash at gmail.com> wrote:
> Hi again, this is really strange, I've done all the steps you show above but
> there's another problem :'( ...
> /home/muzgash/MyProjects/ipython/docs/sphinxext/docscrape.py:117:
> UserWarning: Unknown section Options
>   warn("Unknown section %s" % key)
> reading sources... [ 19%] api/generated/IPython.kernel.clientconnector
> Exception occurred:
>   File
> "/home/muzgash/MyProjects/ipython/docs/sphinxext/inheritance_diagram.py",
> line 107, in _import_class_or_module
>     "Could not import class or module '%s' specified for inheritance
> diagram" % name)
> ValueError: Could not import class or module
> 'IPython.kernel.clientconnector' specified for inheritance diagram
> The full traceback has been saved in /tmp/sphinx-err-L_nA3u.log, if you want
> to report the issue to the developers.
> Please also report this if it was a user error, so that a better error
> message can be provided next time.
> Either send bugs to the mailing list at
> <http://groups.google.com/group/sphinx-dev/>,
> or report them in the tracker at
> <http://bitbucket.org/birkenfeld/sphinx/issues/>. Thanks!
> make: *** [latex] Error 1
> And i'm doing this with the trunk (installed).

You needed to have installed

python-foolscap python-nose

Basically, to build the docs you need to have an install of IPython
with full dependencies, not just the command-line client.  This is
because to build the api docs, Sphinx needs to be able to import all
of the modules.

I've just added them in your system (I just logged in and did it from
here), and the docs now build, you can have a look at the pdfs there:

muzgash at he1:~/MyProjects/ipython/docs/build/latex$ ls -ltr *pdf
-rw-r--r-- 1 muzgash muzgash   74773 Apr 15 16:21 two_digit_counts.pdf
-rw-r--r-- 1 muzgash muzgash   41799 Apr 15 16:21 single_digits.pdf
-rw-r--r-- 1 muzgash muzgash   48750 Apr 15 16:21 mec_simple.pdf
-rw-r--r-- 1 muzgash muzgash   50227 Apr 15 16:21 ipython_shell.pdf
-rw-r--r-- 1 muzgash muzgash   95697 Apr 15 16:21 ipcluster_start.pdf
-rw-r--r-- 1 muzgash muzgash   39558 Apr 15 16:21 ipcluster_create.pdf
-rw-r--r-- 1 muzgash muzgash   80828 Apr 15 16:21 hpc_job_manager.pdf
-rw-r--r-- 1 muzgash muzgash   42631 Apr 15 16:21 asian_put.pdf
-rw-r--r-- 1 muzgash muzgash   41078 Apr 15 16:21 asian_call.pdf
-rw-r--r-- 1 muzgash muzgash 4938311 Apr 15 20:13 ipython.pdf
-rw-r--r-- 1 muzgash muzgash  688836 Apr 15 20:14 winhpc_whitepaper.pdf


Cheers,

f