modify the comments to conform to doxygen standard