added doxygen comments to format.hpp functions