added doxygen function description
documentation updated
documentation updated