On Tue, Feb 12, 2002 at 02:21:42AM -0500, James K. Lowden wrote:
> Hi all, 
> 
> Every time I think about writing man pages, I look at mdoc.samples
> and think, that looks *hard*.  Isn't there an easier way?  No smgl and
> dsssl or xslt for man pages?  

The mdoc macros are actually quite high level.  IMHO comparable to the ease
of HTML, with a less intuitive syntax.

Maybe /usr/share/mdoc.template would be helpful.
Also refer to http://tylx.tripod.com/groff-resources.html

"mdoc" is pretty widespread, though I don't know the official history or
standards status, but i think more systems can handle it out of the box
than sgml formatted system manuals.

Ben
-- 
I think that many confuse `applicability' with `allegory'; but one resides
in the freedom of the reader, and the other in the purposed domination of
the author.  --J.R.R. Tolkien