add some doxygen comments and reminder todo's