pydoc - how to generate documentation for an entire package?
j3nsby at gmail.com
Mon Nov 19 19:50:28 CET 2007
On 8 Nov., 02:46, Jens <j3n... at gmail.com> wrote:
> I have a project/package for which I want to generate documentation
> My problem is that when I type "pydoc.py -w MyPackage" it only
> generates documentation for the package - no modules, classes or
> methods or sub-packages. Just a single HTML file called
> That's strange - is there something here I'm missing. How do you
> generate documentation for a whole package?
No suggestions? All I can think of is to make a *.bat file on Windows
to call pydoc.py for each of my modules. Seems like a silly solution.
Also, when I have a module that imports from math (for example),
pydoc.py generates a broken link to the math module. This just seems
Generating documentation form code is a nice thing, but this pydoc.py
is driving me insane - isn't there are better way?
More information about the Python-list