>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.  

you could do what i usually do.  cut n paste n hack n slash pieces of
other man pages together, with the wording changed, until you get what
you want.

-- 
|-----< "CODE WARRIOR" >-----|
codewarrior@daemon.org             * "ah!  i see you have the internet
twofsonet@graffiti.com (Andrew Brown)                that goes *ping*!"
andrew@crossbar.com       * "information is power -- share the wealth."