diff options
author | Hugo van Kemenade <hugovk@users.noreply.github.com> | 2022-04-29 13:47:26 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2022-04-29 13:47:26 (GMT) |
commit | 89c6b2b8f615a1c1827a92c4582c213b1a5027fb (patch) | |
tree | f4e4996942f7d0e314d0a2e4c732d74b098aef36 /Doc/Makefile | |
parent | 64113a4ba801126028505c50a7383f3e9df29573 (diff) | |
download | cpython-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/Makefile | 6 |
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. |