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?  

I know, if it's hard to read it should be hard to write.  

If mdoc is the way, could someone tell me how widely it's used?  I'm
part of a project that could use a lot of man pages, and I'd expect
the sources would wind up getting built on non-NetBSD systems.  

Thanks for any guidance.  

--jkl