der Mouse writes:
> If you find one, I'd love to see it.  The mdoc.samples manpage is the
> closest I've seen; it's good, but it's woefully inadequate; indeed, the
> first time I wanted to write a serious manpage, I found two macro calls
> (.Tn and .At) used in a page I was cribbing from - macros which simply
> weren't mentioned in mdoc.samples!

Please document them! Please, please, please!

> There also appears to be a bug in the package somewhere, or else in the
> documentation such that I'm misusing it.  I have a manpage that is
> incomplete because indentation started walking to the right edge of the
> page, indenting more and more with each item in a list, and I couldn't
> figure out why or how to stop it.  I also had a run-in once with an
> attempt to do alternation in a way that required more than 9 arguments
> to some macro, and I couldn't make .Xo and .Xc (or whatever the
> extend-argument-list calls are) work....