Experimentation has started succesfully in using unit tests to docuemnt API.
Doxygen snippets are the way to go.