mirror of https://github.com/python/cpython
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. ........
This commit is contained in:
parent
d94b4a75e8
commit
fe427fee6c
41
Doc/Makefile
41
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
|
||||
|
|
Loading…
Reference in New Issue