diff options
author | Georg Brandl <georg@python.org> | 2010-03-13 11:02:07 (GMT) |
---|---|---|
committer | Georg Brandl <georg@python.org> | 2010-03-13 11:02:07 (GMT) |
commit | fe427fee6c77f2a2b8c7c1ad0fec14d8638a9db0 (patch) | |
tree | 7762f7e2a0616948d0770f960a8d35d653a0cc3b | |
parent | d94b4a75e8d49a06798b0a0d6eb3d6f567aa3397 (diff) | |
download | cpython-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/Makefile | 41 |
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 |