PS How about Boost.Test ;-)
I've be so irritated at the docs that I've tried to Doxygenate Boost.test but it blew up. I suspect it's something to do with the macro expansions that need some different settings in Doxygen but I was in the middle of trying to test something ...
Hmm, it's not just the docs, I'm getting pretty frustrated with the implementation too :-(
PPS I've also started on a Template/Prototype to guide people doing their docs using the QuickBook/Doxygen/Index/hetp/pdf toolchain but development has stalled. I'll try to get back to it.
The Wiki entry here: https://svn.boost.org/trac/boost/wiki/BoostDocs/GettingStarted is gradually getting more complete and should probably be the starting point for this? But an excellent idea in any case :-) John.