shouldn't this be generated automatically by numpydoc? If we have to do this by hand for everything we are in trouble!