From f21b73a9204750f271f1f8d042eb96f83292e5d3 Mon Sep 17 00:00:00 2001
From: Ned Batchelder <ned@nedbatchelder.com>
Date: Sat, 7 Dec 2019 15:37:22 -0500
Subject: sphinx-autobuild is handy

---
 Makefile | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

(limited to 'Makefile')

diff --git a/Makefile b/Makefile
index 3556c038..3524d6fd 100644
--- a/Makefile
+++ b/Makefile
@@ -129,8 +129,10 @@ build_ext:
 
 # Documentation
 
+DOCBIN = .tox/doc/bin
 SPHINXOPTS = -aE
-SPHINXBUILD = .tox/doc/bin/sphinx-build $(SPHINXOPTS)
+SPHINXBUILD = $(DOCBIN)/sphinx-build $(SPHINXOPTS)
+SPHINXAUTOBUILD = $(DOCBIN)/sphinx-autobuild -p 9876 --ignore '.git/**' --open-browser
 WEBHOME = ~/web/stellated/
 WEBSAMPLE = $(WEBHOME)/files/sample_coverage_html
 WEBSAMPLEBETA = $(WEBHOME)/files/sample_coverage_html_beta
@@ -139,11 +141,11 @@ docreqs:
 	tox -q -e doc --notest
 
 dochtml: docreqs			## Build the docs HTML output.
-	.tox/doc/bin/python doc/check_copied_from.py doc/*.rst
+	$(DOCBIN)/python doc/check_copied_from.py doc/*.rst
 	$(SPHINXBUILD) -b html doc doc/_build/html
 
-docopen: dochtml
-	open doc/_build/html/index.html
+docdev: dochtml				## Build docs, and auto-watch for changes.
+	PATH=$(DOCBIN):$(PATH) $(SPHINXAUTOBUILD) -b html doc doc/_build/html
 
 docspell: docreqs
 	$(SPHINXBUILD) -b spelling doc doc/_spell
-- 
cgit v1.2.1