[GRASS-dev] sphinx python documentation

[Vaclav Petras]

On Fri, May 30, 2014 at 7:45 PM, Luca Delucchi <lucadeluge at gmail.com> wrote:

> On 30 May 2014 17:20, Vaclav Petras <wenzeslaus at gmail.com> wrote:
> >
> > On Wed, May 28, 2014 at 2:53 AM, Luca Delucchi <lucadeluge at gmail.com>
> wrote:
> >>
> >> >>
> >> >> [0] http://grass.osgeo.org/grass71/manuals/pygrass/index.html
> >> >
> >> >
> >> > Nice, perhaps bit too conservative design but fits to GRASS manual
> >> > nicely. I
> >> > wish to have something similar for Doxygen but I'm afraid of
> maintenance
> >> > issues.
> >> >
> >>
> >> what do you mean for "conservative design" ?
> >
> >
> > Probably that there are no distinct (graphically strong) elements:
> >
> >
> http://grass.osgeo.org/grass71/manuals/pygrass/raster_elements.html#pygrass.raster.category.Category.set_cats_fmt
> >
> > But it seems that Python documentation goes into the same direction:
> >
> > https://docs.python.org/2/library/unittest.html >
> > https://docs.python.org/3/library/unittest.html
> >
> > I'm not able to contribute anything more exciting and I actually
> appreciate
> > a lot that it is the same design as the user manual, so well done, I
> should
> > say.
> >
> > I'm looking forward to separate Python and GUI documentations.
> >
>
> I can work on it next week, if you like the pygrass documentation I
> could do the same for Python and GUI
>
> This would be really great. For Python and GUI I'm always looking to
source code rather than Doxygen but I hope that with Sphinx it will be a
start of a new documentation which I will actually use.

> Vaclav
>
>
> --
> ciao
> Luca
>
> http://gis.cri.fmach.it/delucchi/
> www.lucadelu.org
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/grass-dev/attachments/20140530/fe0ee8d0/attachment.html>