fix incorrect statements in dox re: centroids
(#612)
also fix up some of the dox in .h file
(#612)