Hi Jake,
Pygame does have a document generator, but it is tucked away in an
obscured directory and only processes Python files. Sphinx also comes
with a document generator. But first we would have to convert all the
doc strings to reST markup. Also, how would a doc generator handle
module level constants. These have no doc strings. I suppose they could
be mentioned in the module header. It's something to look at in the long
term. But first the existing docs have to be sorted out.
Lenard Lindstrom
On 30/03/11 02:00 AM, Jake b wrote:
Why not use a doc-generater?
It sounds like the current method you have to write the docstring twice.
( or at least decreases ease to update )