fix problematic ccomments that trip up doxygen generator. Mostly
c style comments in class description but a few cases of comments
not in expected location that leads to stripped out code and comp fails
fix trailing whitespaces that will fail style check when committed
Thanks Andrew Maclean for updating the url to VTK publications.