summaryrefslogtreecommitdiffstats
path: root/Doc/Makefile
diff options
context:
space:
mode:
authorHugo van Kemenade <hugovk@users.noreply.github.com>2022-04-29 13:47:26 (GMT)
committerGitHub <noreply@github.com>2022-04-29 13:47:26 (GMT)
commit89c6b2b8f615a1c1827a92c4582c213b1a5027fb (patch)
treef4e4996942f7d0e314d0a2e4c732d74b098aef36 /Doc/Makefile
parent64113a4ba801126028505c50a7383f3e9df29573 (diff)
downloadcpython-89c6b2b8f615a1c1827a92c4582c213b1a5027fb.zip
cpython-89c6b2b8f615a1c1827a92c4582c213b1a5027fb.tar.gz
cpython-89c6b2b8f615a1c1827a92c4582c213b1a5027fb.tar.bz2
bpo-36329: Remove 'make -C Doc serve' in favour of 'make -C Doc htmlview' (GH-32354)
Also updated `make -C htmlview` so it used a full path with `file://`, because the original didn't open the page (macOS). For example: ```sh cd Doc # Doesn't open anything: python3 -c "import webbrowser; webbrowser.open('build/html/index.html')" # Opens the docs page e.g. file:///Users/hugo/github/cpython/Doc/build/html/index.html : python3 -c "import os, webbrowser; webbrowser.open('file://' + os.path.realpath('build/html/index.html'))" ``` https://bugs.python.org/issue36329
Diffstat (limited to 'Doc/Makefile')
-rw-r--r--Doc/Makefile6
1 files changed, 2 insertions, 4 deletions
diff --git a/Doc/Makefile b/Doc/Makefile
index 61a7ce0..3a3417b 100644
--- a/Doc/Makefile
+++ b/Doc/Makefile
@@ -13,7 +13,6 @@ PAPER =
SOURCES =
DISTVERSION = $(shell $(PYTHON) tools/extensions/patchlevel.py)
SPHINXERRORHANDLING = -W
-SERVE_PORT =
# Internal variables.
PAPEROPT_a4 = -D latex_elements.papersize=a4paper
@@ -45,7 +44,6 @@ help:
@echo " dist to create a \"dist\" directory with archived docs for download"
@echo " suspicious to check for suspicious markup in output text"
@echo " check to run a check for frequent markup errors"
- @echo " serve to serve the documentation on the localhost (8000)"
build:
-mkdir -p build
@@ -141,7 +139,7 @@ pydoc-topics: build
"cp build/pydoc-topics/topics.py ../Lib/pydoc_data/topics.py"
htmlview: html
- $(PYTHON) -c "import webbrowser; webbrowser.open('build/html/index.html')"
+ $(PYTHON) -c "import os, webbrowser; webbrowser.open('file://' + os.path.realpath('build/html/index.html'))"
clean: clean-venv
-rm -rf build/*
@@ -219,7 +217,7 @@ check:
$(SPHINXLINT) ../Misc/NEWS.d/next/
serve:
- $(PYTHON) ../Tools/scripts/serve.py build/html $(SERVE_PORT)
+ @echo "The serve target was removed, use htmlview instead (see bpo-36329)"
# Targets for daily automated doc build
# By default, Sphinx only rebuilds pages where the page content has changed.