[GRASS-dev] Manpage HTML markup consistency

[Glynn Clements]

Dylan Beaudette wrote:

> I personally prefer LaTeX for documentation writing, but this may introduce 
> too much overhead for users interested only in HTML documents. There are 
> well-established tools to accomplish this, but not all users will have a TeX 
> install. I noticed a tool called Latex2Man [1] which could simplify man page 
> generation from a 'core' documentation set written in LaTeX.

TeX has much the same problem as HTML: if you need to generate any
kind of restricted format, you have to restrict usage to a subset
which can be accurately converted to all supported target formats.

E.g. complex equations may come out fine if you generate PostScript or
DVI output, but may be completely unintelligible when converted to
nroff and displayed on a terminal.

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