Move doc build dependencies to Doc/requirements.txt (GH-96607)

This makes 3.7 doc builds similar to later releases,
simplifying build tooling.

diff --git a/Doc/Makefile b/Doc/Makefile
index 1b8cbfa479e50f6638d612a6f95027b6079e78b5..1ffa67ac93a1158f855f8b1380c4d2c4245cef2f 100644 (file)
--- a/Doc/Makefile
+++ b/Doc/Makefile
@@ -127,7 +127,8 @@ clean:
 
 venv:
        $(PYTHON) -m venv $(VENVDIR)
-       $(VENVDIR)/bin/python3 -m pip install -U Sphinx==2.3.1 blurb docutils==0.17.1 Jinja2==3.0.3
+       $(VENVDIR)/bin/python3 -m pip install -U pip setuptools
+       $(VENVDIR)/bin/python3 -m pip install -r requirements.txt
        @echo "The venv has been created in the $(VENVDIR) directory"
 
 dist:

diff --git a/Doc/requirements.txt b/Doc/requirements.txt
new file mode 100644 (file)
index 0000000..cba2d89
--- /dev/null
+++ b/Doc/requirements.txt
@@ -0,0 +1,18 @@
+# Requirements to build the Python documentation
+
+# Sphinx version is pinned so that new versions that introduce new warnings
+# won't suddenly cause build failures. Updating the version is fine as long
+# as no warnings are raised by doing so.
+sphinx==2.3.1
+# Docutils version is pinned to a version compatible with Sphinx
+# version 2.3.1. It can be removed after bumping Sphinx version to at
+# least 3.5.4.
+docutils==0.17.1
+# Jinja version is pinned to a version compatible with Sphinx version 2.3.1.
+jinja2==3.0.3
+
+blurb
+
+# The theme used by the documentation is stored separately, so we need
+# to install that as well.
+python-docs-theme