finished writing doxygen comments for functions in api