Astropy-helpers

------------------

- Fixed issue with the sphinx documentation css where the line numbers for code
blocks were not aligned with the code. [179, 180]

- Fixed crash that could occur when trying to build Cython extension modules
when Cython isn't installed. Normally this still results in a failed build,
but was supposed to provide a useful error message rather than crash
outright (this was a regression introduced in v1.0.3). [181]

- Fixed a crash that could occur on Python 3 when a working C compiler isn't
found. [182]

- Quieted warnings about deprecated Numpy API in Cython extensions, when
building Cython extensions against Numpy >= 1.7. [183, 186]

- Improved support for py.test >= 2.7--running the ``./setup.py test`` command
now copies all doc pages into the temporary test directory as well, so that
all test files have a "common root directory". [189, 190]

------------------

- Added workaround for sphinx-doc/sphinx1843, a but in Sphinx which
prevented descriptor classes with a custom metaclass from being documented
correctly. [158]

- Added an alias for the ``./setup.py build_sphinx`` command as
``./setup.py build_docs`` which, to a new contributor, should hopefully be
less cryptic. [161]

- The fonts in graphviz diagrams now match the font of the HTML content. [169]

- When the documentation is built on readthedocs.org, MathJax will be
used for math rendering. When built elsewhere, the "pngmath"
extension is still used for math rendering. [170]

- Fix crash when importing astropy_helpers when running with ``python -OO``
[171]

- The ``build`` and ``build_ext`` stages now correctly recognize the presence
of C++ files in Cython extensions (previously only vanilla C worked). [173]

------------------

- Various fixes enabling the astropy-helpers Sphinx build command and
Sphinx extensions to work with Sphinx 1.3. [148]

- More improvement to the ability to handle multiple versions of
astropy-helpers being imported in the same Python interpreter session
in the (somewhat rare) case of nested installs. [147]

- To better support high resolution displays, use SVG for the astropy
logo and linkout image, falling back to PNGs for browsers that
support it. [150, 151]

- Improve ``setup_helpers.get_compiler_version`` to work with more compilers,
and to return more info. This will help fix builds of Astropy on less
common compilers, like Sun C. [153]

------------------

- Released in concert with v0.4.8 to address the same issues.

----------------

- Added new pre-/post-command hook points for ``setup.py`` commands. Now any
package can define code to run before and/or after any ``setup.py`` command
without having to manually subclass that command by adding
``pre_<command_name>_hook`` and ``post_<command_name>_hook`` callables to
the package's ``setup_package.py`` module. See the PR for more details.
[112]

- The following objects in the ``astropy_helpers.setup_helpers`` module have
been relocated:

- ``get_dummy_distribution``, ``get_distutils_*``, ``get_compiler_option``,
``add_command_option``, ``is_distutils_display_option`` ->
``astropy_helpers.distutils_helpers``

- ``should_build_with_cython``, ``generate_build_ext_command`` ->
``astropy_helpers.commands.build_ext``

- ``AstropyBuildPy`` -> ``astropy_helpers.commands.build_py``

- ``AstropyBuildSphinx`` -> ``astropy_helpers.commands.build_sphinx``

- ``AstropyInstall`` -> ``astropy_helpers.commands.install``

- ``AstropyInstallLib`` -> ``astropy_helpers.commands.install_lib``

- ``AstropyRegister`` -> ``astropy_helpers.commands.register``

- ``get_pkg_version_module`` -> ``astropy_helpers.version_helpers``

- ``write_if_different``, ``import_file``, ``get_numpy_include_path`` ->
``astropy_helpers.utils``

All of these are "soft" deprecations in the sense that they are still
importable from ``astropy_helpers.setup_helpers`` for now, and there is
no (easy) way to produce deprecation warnings when importing these objects
from ``setup_helpers`` rather than directly from the modules they are
defined in. But please consider updating any imports to these objects.
[110]

- Use of the ``astropy.sphinx.ext.astropyautosummary`` extension is deprecated
for use with Sphinx < 1.2. Instead it should suffice to remove this
extension for the ``extensions`` list in your ``conf.py`` and add the stock
``sphinx.ext.autosummary`` instead. [131]

------------------

- Improved the ``ah_bootstrap`` script's ability to override existing
installations of astropy-helpers with new versions in the context of
installing multiple packages simultaneously within the same Python
interpreter (e.g. when one package has in its ``setup_requires`` another
package that uses a different version of astropy-helpers. [144]

- Added a workaround to an issue in matplotlib that can, in rare cases, lead
to a crash when installing packages that import matplotlib at build time.
[144]