doxygen comments
changes after last code review