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.