[GRASS5] use of <em>,<i> and <strong>,<b> in the help pages

[Daniel Calvelo]

Well, I'd say, given the uses in the description.html files, it should
neither be <b>/<i> nor <strong>/<em> in most cases.

We are using (indiscriminately) <b>,<i>,<em> to mark-up parameters or
command names, i.e. code, rather than using them for emphasis proper.
Visually, it's fine, but semantically it's awfully wrong.

A more correct way of handling this would be to use <span>s with a
semantically marked class, and expanding Markus' CSS to handle that,
visually. I.e. instead of "the <b>col</b> parameter" we should have
"the <span class="param">col</span> parameter". We might borrow
texinfo or docbook semantic classes for that.

Not really an automatic conversion, rather a long style correction
through every description file.

Daniel.

PS. Personally, I'd rather move all the docs from HTML to reStructuredText.

On 4/5/06, Hamish <hamish_nospam at yahoo.com> wrote:
> mixed use of <em>,<i> and <strong>,<b> is rife in the help pages.
>
> "What's the Difference?"
>   http://www.think-ink.net/html/bold.htm
>
>
>
> comments?
>
> Hamish
>
> _______________________________________________
> grass5 mailing list
> grass5 at grass.itc.it
> http://grass.itc.it/mailman/listinfo/grass5
>


--
-- Daniel Calvelo Aros