summaryrefslogtreecommitdiffstats
path: root/Doc/Makefile
diff options
context:
space:
mode:
authorNed Deily <nad@python.org>2017-09-05 07:10:31 (GMT)
committerNed Deily <nad@python.org>2017-09-05 07:46:18 (GMT)
commitfcd97d44382df520e39de477a5ec99dd89c3fda8 (patch)
treea08ff5bf3750396cf3c35f087628fd3d4163cfeb /Doc/Makefile
parente295b826099ecad6926d4f95e3f739b3ecdc3cc7 (diff)
downloadcpython-fcd97d44382df520e39de477a5ec99dd89c3fda8.zip
cpython-fcd97d44382df520e39de477a5ec99dd89c3fda8.tar.gz
cpython-fcd97d44382df520e39de477a5ec99dd89c3fda8.tar.bz2
Include additional changes to support blurbified NEWS (#3340)
Diffstat (limited to 'Doc/Makefile')
-rw-r--r--Doc/Makefile17
1 files changed, 16 insertions, 1 deletions
diff --git a/Doc/Makefile b/Doc/Makefile
index 526269d..63bbe1d 100644
--- a/Doc/Makefile
+++ b/Doc/Makefile
@@ -6,6 +6,7 @@
# You can set these variables from the command line.
PYTHON = python3
SPHINXBUILD = sphinx-build
+BLURB = $(PYTHON) -m blurb
PAPER =
SOURCES =
DISTVERSION = $(shell $(PYTHON) tools/extensions/patchlevel.py)
@@ -38,6 +39,20 @@ help:
@echo " serve to serve the documentation on the localhost (8000)"
build:
+ -mkdir -p build
+# Look first for a Misc/NEWS file (building from a source release tarball
+# or old repo) and use that, otherwise look for a Misc/NEWS.d directory
+# (building from a newer repo) and use blurb to generate the NEWS file.
+ @if [ -f ../Misc/NEWS ] ; then \
+ echo "Using existing Misc/NEWS file"; \
+ cp ../Misc/NEWS build/NEWS; \
+ elif [ -d ../Misc/NEWS.d ]; then \
+ echo "Building NEWS from Misc/NEWS.d with blurb"; \
+ $(BLURB) merge -f build/NEWS; \
+ else \
+ echo "Neither Misc/NEWS.d nor Misc/NEWS found; cannot build docs"; \
+ exit 1; \
+ fi
$(SPHINXBUILD) $(ALLSPHINXOPTS)
@echo
@@ -107,7 +122,7 @@ clean:
venv:
$(PYTHON) -m venv venv
- ./venv/bin/python3 -m pip install -U Sphinx
+ ./venv/bin/python3 -m pip install -U Sphinx blurb
dist:
rm -rf dist