ENH: Make these comments about what the method does visible in doxygen and the paraview generated doc.