In message <199804112143.XAA06930@orade.ora.de>, Christoph Badura writes:
>mcmahill@mtl.mit.edu (Dan McMahill) writes:
>
>>man 7 man
>
>>gave a summary of the macros for creating man pages and also had
>>the SunOs guidelines for a "good" man page.
>
>4.4BSD has switched to the -mdoc macros for man pages.
>There's /usr/share/misc/{man,mdoc}.template, mdoc(7), and mdoc.samples(7).
>
>HTH,

It's a huge help.  Exactly what I was looking for.  Perhaps  mdoc(7) should
be listed under the SEE ALSO section of the man(1) man page?  I'll see if
I can figure out the right person to suggest that to.

Dan