add a bit of doxygen commenting