astropy/astropy — pull request #275 by eteq (2012-06-12 21:52:41+00:00)
Title: fixed autosummary tables everywhere

#231 included a fix to the `astropy.sphinx.ext.automodsumm` that kept it from cutting off the first sentence of a docstring at the end of a line (in certain cases). However, that fix only applied to ``automodsumm`` directive, meaning the problem still existed for ``autosummary`` directives. (Which are used in the pages ``automodsumm`` generates...) This implements the fix as an AstropyAutosummary class that overrides the standard sphinx ``autosummary``.

This may eventually be fixed if https://bitbucket.org/birkenfeld/sphinx/issue/943/autosummary-doesnt-always-get-first is addressed, but for now it's necessary to make the summary tables look right. In the future, we might only have this get included if the version of sphinx is too old.