We use doxygen-style comments in headers, so that doxygen can generate at least some form of documentation for the functions ( http://mc-server.xoft.cz/doxy/ )