some cleanup of the PowerSpectrum class documentation
(#387)