[GRASS-dev] /lib/gis/area_poly1.c: algorithm poorly described, new comments for consideration please

[Vaclav Petras]

On Thu, Nov 7, 2013 at 12:47 AM, Markus Neteler <neteler at osgeo.org> wrote:

> Richard,
>
> could you please download and edit the file
> http://svn.osgeo.org/grass/grass/trunk/lib/gis/area_poly1.c
>
> and send it back to me? Then I can update it as suggested.
>
> This would be great. Moreover, it would help if you put \verbatim before
the equations and \endverbatim after them, e.g.:

polygon's side) is defined by:
 * \verbatim
 *                                     lat_2  -  lat_1
 *     lat = lat_1 + (long - long_1) * ---------------
 *                                     long_2 - long_1
 * \endverbatim
 * where long_1 < long < long_2.

This ensures that the formatting will be preserved in generated programming
manual. Alternatively, it is possible to use also LaTeX syntax for
equations [1] but to be honest, I don't have a clear idea what's better.

Thanks for you explanation, Richard. It seems that it is really needed.

Vaclav

[1] http://www.stack.nl/~dimitri/doxygen/manual/formulas.html

thanks
> Markus
> _______________________________________________
> grass-dev mailing list
> grass-dev at lists.osgeo.org
> http://lists.osgeo.org/mailman/listinfo/grass-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/grass-dev/attachments/20131107/acacdc5f/attachment.html>