doxygen commenting added for functions