(for future commits) could you make the doxygen doc for these functions?