Better Doxygen comments.

Increase efficiency of PointsToCentroidsWeighted.

-- RMonica