- add some doxygen comments laying around