[GRASS-dev] Manpage HTML markup consistency

Glynn Clements glynn at gclements.plus.com
Mon Feb 25 01:43:44 EST 2008


Patton, Eric wrote:

> >The common usage has been:
> 
> >module names <em>
> >flags and option names <b>  (inline text; not within <pre> code)
> >shell commands, names, etc <tt>  (inline text; don't overuse)
> >emphasized phrase <i> (inline text; use instead of bolding the
> >sentence)
> >code: <div class="code"><pre>  ...  </pre></div>
> 
> >once formalized... -> SUBMITTING_DOCS
> 
> >I expect there are many dead links to non-ported GRASS 5 modules and
> >many help pages may talk of obsolete interactive mode.
> 
> Ok, I won't use up any more bandwidth about it; if no one objects,
> I'll change SUBMITTING_DOCS to use:
> 
> <em> tags for module names
> <b> for flags and parameter names
> shell commands, names, etc <tt>
> emphasized phrase <i>
> alphabetized SEE ALSO
> 
> I've been removing obsolete references to the old interactive mode 
> from the docs as I encounter them.

Also, although g.html2man attempts to handle tables, it doesn't seem
to work. Please remove <TABLE> <TD> <TH> from the list of allowed
tags.

-- 
Glynn Clements <glynn at gclements.plus.com>


More information about the grass-dev mailing list