some pep8ification, NED doc fixes (can't have a literal block after
"returns" in numpydoc)