added docstrings for doxygen docs