[GRASS-dev] pygrass documentation

[Vaclav Petras]

On Mon, Apr 28, 2014 at 9:23 AM, Pietro <peter.zamb at gmail.com> wrote:

> On Mon, Apr 28, 2014 at 2:57 PM, Vaclav Petras <wenzeslaus at gmail.com>
> wrote:
> > [cut] 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.
>
>
> Sphinx has support for python/C/C++/javascript [0].
> May be we could reconsider [1] to move everything under sphinx.
>
> But I'm not sure it is feasible.
>
> 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).


> [0] http://sphinx-doc.org/domains.html
> [1] https://trac.osgeo.org/grass/ticket/151

[2] http://michaeljones.github.io/breathe/
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/grass-dev/attachments/20140428/20b72f20/attachment.html>