<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Mon, Apr 28, 2014 at 9:23 AM, Pietro <span dir="ltr"><<a href="mailto:peter.zamb@gmail.com" target="_blank">peter.zamb@gmail.com</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">On Mon, Apr 28, 2014 at 2:57 PM, Vaclav Petras <<a href="mailto:wenzeslaus@gmail.com">wenzeslaus@gmail.com</a>> wrote:<br>


> [cut] I'm also afraid of introducing another markup (we have now HTML<br>
<div class="">> for doc and HTML+Markdown+Doxygen+Doxygen-LaTeX-like for programming),<br>
> although reStructuredText is almost Python standard. But anyway, I think<br>
> that using Sphinx and reStructuredText for Python will be beneficial.<br>
<br>
<br>
</div>Sphinx has support for python/C/C++/javascript [0].<br>
May be we could reconsider [1] to move everything under sphinx.<br>
<br>
But I'm not sure it is feasible.<br>
<br></blockquote><div>Doxygen has support for Python too, but it is not good enough, I would guess that it is the same for C in Sphinx. The only thing which could change this is Breathe [2]. More investigation is needed in this case (as well as in replacement? of HTML manual with Sphinx).</div>

<div> </div><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">
[0] <a href="http://sphinx-doc.org/domains.html" target="_blank">http://sphinx-doc.org/domains.html</a><br>
[1] <a href="https://trac.osgeo.org/grass/ticket/151" target="_blank">https://trac.osgeo.org/grass/ticket/151</a></blockquote><div>[2] <a href="http://michaeljones.github.io/breathe/">http://michaeljones.github.io/breathe/</a> </div>

</div><br></div></div>