code remarks cleanup and doxygen: #21

cleaned up remarks, generated doxygen.