This does several things
- Uses a virtual environment for the documentent build. This allows
installing the proper NumPy version with pip and works with all
recent Python versions.
- Installs the dependencies current in the {doc|test}requirements files.
That makes it easier to insure that the proper versions are used.
- Removes the latex/pdf builds. Those builds are currently buggy and
hard to maintain and we have chosen to remove the pdf documents until
that is fixed. Removing them cleans up the file to some extent.
This all makes it easier to document how to build the docs. I was
editing the Makefile on the fly before this, and that sort of knowledge
is tricky to pass on to new maintainers.
Changed files are - doc/HOWTO_RELEASE.rst - doc/Makefile - doc/changelog/1.15.0-changelog.rst - doc/changelog/1.16.0-changelog.rst - doc/changelog/1.17.0-changelog.rst - doc/changelog/1.19.0-changelog.rst - doc/changelog/1.21.0-changelog.rst - doc/neps/nep-0045-c_style_guide.rst - doc/source/dev/howto_build_docs.rst - doc/source/dev/releasing.rst - doc/source/reference/distutils_guide.rst - doc/source/reference/testing.rst - doc/source/release/1.7.0-notes.rst - doc/source/release/1.8.0-notes.rst
The new tags look like '1.21.0.dev0+98.gaa0453721f', where '98' is the number of commits since the 1.21.0 branch was started and 'aa0453721f'. The chosen form may be specified in the 'setup.cfg' file. This PR adds two new files 'numpy/_version.py' and 'numpy/version.py'. The latter is kept because it is part of the public API and is actually used by some downstream projects, but it is no longer dynamically created. See https://github.com/python-versioneer/python-versioneer/ for more information.
Opens the front page of the docs built with `make html` in the default web browser. Idea copied from SciPy [ci skip]
DOC: Fix an obvious mistake in a message printed in doc/Makefile.
Switch html target for make dist to move away from the html-scipyorg theme. Makes the theme of the archived docs including stable consistent with the devdocs