summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorBrett Cannon <brett@python.org>2014-12-05 20:17:31 (GMT)
committerBrett Cannon <brett@python.org>2014-12-05 20:17:31 (GMT)
commitd5ea39d1b86ce8ba0db8ea919797adb29b137add (patch)
tree8e49c8782d6eb45b7b77cd2a6411a9bf7454166f /Doc
parent1a7b8d143965c281467379123187e0ef323380c3 (diff)
downloadcpython-d5ea39d1b86ce8ba0db8ea919797adb29b137add.zip
cpython-d5ea39d1b86ce8ba0db8ea919797adb29b137add.tar.gz
cpython-d5ea39d1b86ce8ba0db8ea919797adb29b137add.tar.bz2
Issue #22394: Add a 'venv' command to Doc/Makefile.
This will create a venv using the interpreter specified by the PYTHON variable for the Makefile that also install Sphinx. Typical usage is expected to be: cd Doc make venv PYTHON=../python make html PYTHON=venv/bin/python3
Diffstat (limited to 'Doc')
-rw-r--r--Doc/Makefile10
1 files changed, 7 insertions, 3 deletions
diff --git a/Doc/Makefile b/Doc/Makefile
index 5b5f68a..93e59ef 100644
--- a/Doc/Makefile
+++ b/Doc/Makefile
@@ -15,11 +15,12 @@ ALLSPHINXOPTS = -b $(BUILDER) -d build/doctrees -D latex_paper_size=$(PAPER) \
.PHONY: help build html htmlhelp latex text changes linkcheck \
suspicious coverage doctest pydoc-topics htmlview clean dist check serve \
- autobuild-dev autobuild-stable
+ autobuild-dev autobuild-stable venv
help:
@echo "Please use \`make <target>' where <target> is one of"
@echo " clean to remove build files"
+ @echo " venv to create a venv with necessary tools"
@echo " html to make standalone HTML files"
@echo " htmlview to open the index page built by the html target in your browser"
@echo " htmlhelp to make HTML files and a HTML help project"
@@ -102,7 +103,11 @@ htmlview: html
$(PYTHON) -c "import webbrowser; webbrowser.open('build/html/index.html')"
clean:
- -rm -rf build/*
+ -rm -rf build/* venv/*
+
+venv:
+ $(PYTHON) -m venv venv
+ ./venv/bin/python3 -m pip install -U Sphinx
dist:
rm -rf dist
@@ -172,4 +177,3 @@ autobuild-stable:
exit 1;; \
esac
@make autobuild-dev
-