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.
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.
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: