[Qgis-developer] Python Documentation

[Matthias Kuhn]

Hi all,

As already mentioned at the Hackfest, I would really like to see a
Python API documentation.

At the moment, there is only the standard API documentation available,
which lists lots of functions, which are available for core development
only, sometimes the signature is not the same (e.g. a method might
return a tuple for two return values in python and take a reference
where it will write the result value into in C++) and it can be, that
some python-specific accessors are available (e.g. attributes as a dict,
constructor as __init__ )

This does not make it very easy to develop python plugins (I'm sometimes
reading sip-Files to know, what I'm supposed to do).

I would propose, we add a second API documentation, targeted at python
developers. I tried today to compile a python API with doxygen from the
sip files. This kind of works and lists only the methods which are
really available, but still in a C++ style (you shouldn't know if it's a
pointer, reference or whatsoever in python). Of course all this stuff
could also be described in the comments, but it would be nice to have
something like the PyQt documentation [1]

Does anybody know, how to produce such an output?
And would there be somebody willing to take over the lead and/or
maintenance for this? It would be a nice thing to have for the plugin
community.

Best regards,
Matthias

http://pyqt.sourceforge.net/Docs/PyQt4/classes.html