adding documentation in doxygen valid form