more doxygen documentation of api