[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

sphinx and intersphinx doc generation.



Hello,

I am working on a package which use sphinx for its documentation.

the author of the package link this documentation to other packages, on the web.

So during the build I got thoses messages.

I can see two problems here, the pickle error ???

Someone already saw this ?

Running Sphinx v0.6.6
MainThread     INFO     2011-02-14 12:54:51,927 root: Generating grammar tables from /usr/lib/pymodules/python2.6/sphinx/pycode/Grammar.txt
MainThread     INFO     2011-02-14 12:54:52,013 root: Writing grammar tables to /usr/lib/pymodules/python2.6/sphinx/pycode/Grammar2.6.6.final.0.pickle
MainThread     INFO     2011-02-14 12:54:52,014 root: Writing failed:[Errno 13] Permission denied: '/usr/lib/pymodules/python2.6/sphinx/pycode/Grammar2.6.6.final.0.pickle'
loading pickled environment... not found

and the intersphinx problem

WARNING: intersphinx inventory 'http://www.tango-controls.org/static/PyTango/latest/doc/html/objects.inv' not readable due to <type 'exceptions.ValueError'>: unknown or unsupported inventory version
WARNING: intersphinx inventory 'http://docs.python.org/dev/objects.inv' not readable due to <type 'exceptions.ValueError'>: unknown or unsupported inventory version
WARNING: intersphinx inventory 'http://docs.scipy.org/doc/scipy/reference/objects.inv' not readable due to <type 'exceptions.ValueError'>: unknown or unsupported inventory version
WARNING: intersphinx inventory 'http://docs.scipy.org/doc/numpy/objects.inv' not readable due to <type 'exceptions.ValueError'>: unknown or unsupported inventory version

I can patch the documentation to point to the right location for a local installation but, then I need to find the right location for all the related packages.
pytango (I am workin on it also)
the python doc, scipt and numpy.

Is there a policy which says, ok for the sphinx documentation we need to create a 
python-<module>-doc package and make it depends on the other right python-<xxx>-doc.

Is this problem similar to the doc generated by javadoc for the java packages.


thanks for your attention.

Frederic

-- 
GPG public key   1024D/A59B1171 2009-08-11
    fingerprint = 1688 A3D6 F0BD E4DF 2E6B  06AA B6A9 BA6A A59B 1171
uid  Picca Frédéric-Emmanuel <picca@synchrotron-soleil.fr>

Attachment: signature.asc
Description: PGP signature


Reply to: