How to generate documentation?

How can I generate documentation for the python code I write. Something like what the blender api uses.

Bonus points if it can present the documentation in plain text, but I suppose HTML will do.

http://www.stack.nl/~dimitri/doxygen/

??

I indeed have tried doxygen, but my lack of understanding about how to use it is a problem.

Hmm, I did manage to get it working eventually, but don’t like it’s output. It also doesn’t know about the @property statement, making custom attributes appear as functions.
(And something like VARIABLE = 1/60 gets doxumented as VARIABLE = 1 because / indicates part of a C-style comment?)

What Blender uses and what Python itself uses is Sphinx:
http://sphinx-doc.org/

It takes some getting used to, but these should get you started: