Automatically Generating Documentation for All Python Package Contents

Question

I\'m trying to auto-generate basic documentation for my codebase using Sphinx. However, I\'m having difficulty instructing Sphinx to recursively scan my files.

I have

Answer 1

Perhaps apigen.py can help: https://github.com/nipy/nipy/tree/master/tools.

This tool is described very briefly here: http://comments.gmane.org/gmane.comp.python.sphinx.devel/2912.

Or better yet, use pdoc.

---

Update: the sphinx-apidoc utility was added in Sphinx version 1.1.