[GRASS-translations] modules translation and description.html

[Markus Neteler]

Hi Maxim,

On Tue, Dec 16, 2008 at 10:51 PM, Maxim Dubinin <sim at gis-lab.info> wrote:
> Hi all,
>
> we've started looking into translating individual docs for modules,
> but found some inconsistency between html version from the website and
> description.html from some of the modules.

Note that description.html in the source code is used to *construct*
the final HTML version (this happens when the source code is
compiled).

> Take d.colorlist for example as html:
> http://grass.osgeo.org/grass64/manuals/html64_user/d.colorlist.html
> and compare with description.html for this command from either 6.3 or
> 6.4. For some reason description.html from neither 6.3 or 6.4 contains
> some parts such as NAME, SYNOPSIS etc. I assume these parts are added
> automatically, is it so?

Exactly.
Each module, using --html-description flag, generates the HTML template
which is then combined with the content of description.html.

...
> Can someone explain what is going on with them and how
> description.html should really look like? Based on what is in /doc for
> sample module page, the description.html should start from
> DESCRIPTION, is it so?

description.html contains the real descriptive content without parameters,
flags etc.

For translations, description.html is relevant. Not the web page.

Hope it is clear now.

Markus