diff options
author | Victor Stinner <vstinner@python.org> | 2020-09-18 14:23:18 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2020-09-18 14:23:18 (GMT) |
commit | 8394500cca56490cc347604d39ca40abcdce46c3 (patch) | |
tree | 3768768a78bb905a1af867c18f89954f98ae2346 | |
parent | 6595cb0af4c51c0381c233b97884fe916a4ddd35 (diff) | |
download | cpython-8394500cca56490cc347604d39ca40abcdce46c3.zip cpython-8394500cca56490cc347604d39ca40abcdce46c3.tar.gz cpython-8394500cca56490cc347604d39ca40abcdce46c3.tar.bz2 |
bpo-35293: Travis CI uses "make venv" for the doc (GH-22307)
Doc/requirements.txt becomes the reference for packages and package
versions needed to build the Python documentation.
* Doc/Makefile now uses Doc/requirements.txt
* .travis.yml now uses "make env" of Doc/Makefile
-rw-r--r-- | .travis.yml | 5 | ||||
-rw-r--r-- | Doc/Makefile | 2 | ||||
-rw-r--r-- | Doc/requirements.txt | 13 |
3 files changed, 12 insertions, 8 deletions
diff --git a/.travis.yml b/.travis.yml index a915f7a..254a4ea 100644 --- a/.travis.yml +++ b/.travis.yml @@ -51,10 +51,7 @@ matrix: env: TESTING=docs before_script: - cd Doc - # Sphinx 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.) - # The theme used by the docs is stored separately, so we need to install that as well. - - python -m pip install sphinx==2.2.0 blurb python-docs-theme + - make venv PYTHON=python script: - make check suspicious html SPHINXOPTS="-q -W -j4" - name: "Documentation tests" diff --git a/Doc/Makefile b/Doc/Makefile index c11a7ca..f653d70 100644 --- a/Doc/Makefile +++ b/Doc/Makefile @@ -143,7 +143,7 @@ clean: venv: $(PYTHON) -m venv $(VENVDIR) $(VENVDIR)/bin/python3 -m pip install -U pip setuptools - $(VENVDIR)/bin/python3 -m pip install -U Sphinx==3.2.1 blurb python-docs-theme + $(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 index 198446b..2b70af3 100644 --- a/Doc/requirements.txt +++ b/Doc/requirements.txt @@ -1,5 +1,12 @@ -# Requirements for docs build on netlify -# Pin sphinx to version specified in .travis.yml -sphinx==2.2.0 +# 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==3.2.1 + blurb + +# The theme used by the documentation is stored separately, so we need +# to install that as well. python-docs-theme |