Python: Can the pydoc module output HTML docs with relative paths?

Question

I am using the pydoc module to output documentation for some types which I have defined with the C API. The types I want to document don't exist until the interpreter has been embedded inside my C program, so I can not use the pydoc command.

I get my C code to call a function which does something like this:

d = pydoc.HTMLDoc()
content = d.docmodule(sys.modules["mymodule"])

This works, but generates HTML pages with hard coded 'file:/' link targets. Is there a way to use relative paths for links?

(Extra points for a better way to document types defined in the C API)

Answer 1

I think Sphinx does a better job at this. Here is how you document a C domain:

http://www.sphinx-doc.org/en/master/usage/restructuredtext/domains.html#the-c-domain