adds doxygen doc for public methods