What big documentation you have

I used kdoc to some effect previously. It was a good habit to get into.

doxygen is the generator of choice where I am at the moment.

The incantation I stumbled on involves:

$ doxygen -g proj.dox
$ vi proj.dox
...
ALWAYS_DETAILED_SEC    = YES
JAVADOC_AUTOBRIEF      = YES
EXTRACT_ALL            = YES
INPUT                  = x.h y.h ...
GENERATE_MAN           = YES
...
$ doxygoen proj.dox

The html is ok and I like the man pages it spits out.