small improvements to comments
added Doxygen documentation
added comment referencing doxygen docs