more doxygen comments
few minor edits