summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGeorg Brandl <georg@python.org>2010-03-13 11:02:07 (GMT)
committerGeorg Brandl <georg@python.org>2010-03-13 11:02:07 (GMT)
commitfe427fee6c77f2a2b8c7c1ad0fec14d8638a9db0 (patch)
tree7762f7e2a0616948d0770f960a8d35d653a0cc3b
parentd94b4a75e8d49a06798b0a0d6eb3d6f567aa3397 (diff)
downloadcpython-fe427fee6c77f2a2b8c7c1ad0fec14d8638a9db0.zip
cpython-fe427fee6c77f2a2b8c7c1ad0fec14d8638a9db0.tar.gz
cpython-fe427fee6c77f2a2b8c7c1ad0fec14d8638a9db0.tar.bz2
Merged revisions 78908 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk ........ r78908 | georg.brandl | 2010-03-13 11:12:39 +0100 (Sa, 13 Mär 2010) | 1 line Add Makefile targets for automatic doc build. Add script that will be used for daily build. ........
-rw-r--r--Doc/Makefile41
1 files changed, 31 insertions, 10 deletions
diff --git a/Doc/Makefile b/Doc/Makefile
index c4a1a57..9df8e1d 100644
--- a/Doc/Makefile
+++ b/Doc/Makefile
@@ -14,20 +14,27 @@ DISTVERSION = $(shell $(PYTHON) tools/sphinxext/patchlevel.py)
ALLSPHINXOPTS = -b $(BUILDER) -d build/doctrees -D latex_paper_size=$(PAPER) \
$(SPHINXOPTS) . build/$(BUILDER) $(SOURCES)
-.PHONY: help checkout update build html htmlhelp clean coverage dist check
+.PHONY: help checkout update build html htmlhelp latex text changes linkcheck \
+ suspicious coverage doctest pydoc-topics htmlview clean dist check serve \
+ autobuild-dev autobuild-stable
help:
@echo "Please use \`make <target>' where <target> is one of"
- @echo " html to make standalone HTML files"
- @echo " htmlhelp to make HTML files and a HTML help project"
- @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
- @echo " text to make plain text files"
- @echo " changes to make an overview over all changed/added/deprecated items"
- @echo " linkcheck to check all external links for integrity"
+ @echo " clean to remove build files"
+ @echo " update to update build tools"
+ @echo " html to make standalone HTML files"
+ @echo " htmlhelp to make HTML files and a HTML help project"
+ @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
+ @echo " text to make plain text files"
+ @echo " changes to make an overview over all changed/added/deprecated items"
+ @echo " linkcheck to check all external links for integrity"
+ @echo " coverage to check documentation coverage for library and C API"
+ @echo " doctest to run doctests in the documentation"
+ @echo " pydoc-topics to regenerate the pydoc topics file"
+ @echo " dist to create a \"dist\" directory with archived docs for download"
@echo " suspicious to check for suspicious markup in output text"
- @echo " coverage to check documentation coverage for library and C API"
- @echo " dist to create a \"dist\" directory with archived docs for download"
- @echo " serve to serve the documentation on the localhost (8000)"
+ @echo " check to run a check for frequent markup errors"
+ @echo " serve to serve the documentation on the localhost (8000)"
# Note: if you update versions here, do the same in make.bat and README.txt
checkout:
@@ -153,3 +160,17 @@ check:
serve:
../Tools/scripts/serve.py build/html
+
+# Targets for automatic doc build
+
+# for development releases: always build
+autobuild-dev:
+ make update
+ make dist
+
+# for stable releases: only build if not in development mode
+autobuild-stable:
+ @case $(DISTVERSION) in *[abc]*) \
+ echo "Not building; not a release version."; exit 1;; \
+ esac
+ @make autobuild-dev