documentation improved and changed to fit the doxygen standard