<div dir="ltr"><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Apr 28, 2014 at 1:39 AM, Markus Neteler <span dir="ltr"><<a href="mailto:neteler@osgeo.org" target="_blank">neteler@osgeo.org</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div id=":z8" class="" style="overflow:hidden">At this point we may consider to document all Python API in reST<br>


(rather than using doxygen for<br>
<a href="http://grass.osgeo.org/programming7/pygrasslib.html" target="_blank">http://grass.osgeo.org/programming7/pygrasslib.html</a> )</div></blockquote></div><br>+1</div><div class="gmail_extra"><br></div><div class="gmail_extra">

Doxygen does not work well for Python and from what I understood on their mailing list it will not get better any time soon [0, 2]. Doxygen is great for C, C++ and others, Python support is only basic.</div><div class="gmail_extra">

<br></div><div class="gmail_extra">Moreover, it does not seem practical to have C API, Python API, and GUI (+-API and internals) in one documentation. So, I'm for 3 different documentations.</div><div class="gmail_extra">

<br></div><div class="gmail_extra">I'm not sure about merging Python API (including temporal) and PyGRASS. I also think that we will loose possibility to link between the documentations easily. And I'm also afraid of introducing another markup (we have now HTML for doc and HTML+Markdown+Doxygen+Doxygen-LaTeX-like for programming), although reStructuredText is almost Python standard. But anyway, I think that using Sphinx and reStructuredText for Python will be beneficial.</div>

<div class="gmail_extra"><br></div><div class="gmail_extra">Vaclav</div><div class="gmail_extra"><br></div><div class="gmail_extra"><br></div><div class="gmail_extra">PS: Just a reminder: The ! at the beginning of docstring in Python which we are using (to get Doxygen syntax working there) is undocumented feature and is not officially supported [1] (I asked about that [2]).</div>

<div class="gmail_extra"><br></div><div class="gmail_extra">[0] <a href="http://doxygen.10944.n7.nabble.com/Mixed-C-and-Python-project-td5793.html">http://doxygen.10944.n7.nabble.com/Mixed-C-and-Python-project-td5793.html</a></div>

<div class="gmail_extra">[1] <a href="http://www.stack.nl/~dimitri/doxygen/manual/docblocks.html#pythonblocks">http://www.stack.nl/~dimitri/doxygen/manual/docblocks.html#pythonblocks</a></div><div class="gmail_extra">[2] <a href="http://doxygen.10944.n7.nabble.com/Python-docstrings-and-exclamation-mark-td4689.html">http://doxygen.10944.n7.nabble.com/Python-docstrings-and-exclamation-mark-td4689.html</a><br>

</div></div>