2 # Makefile for Python documentation
3 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
6 # You can set these variables from the command line.
8 SVNROOT
= http
://svn.python.org
/projects
12 ALLSPHINXOPTS
= -b
$(BUILDER
) -d build
/doctrees
-D latex_paper_size
=$(PAPER
) \
13 $(SPHINXOPTS
) . build
/$(BUILDER
)
15 .PHONY
: help checkout update build html web htmlhelp
clean
18 @echo
"Please use \`make <target>' where <target> is one of"
19 @echo
" html to make standalone HTML files"
20 @echo
" web to make file usable by Sphinx.web"
21 @echo
" htmlhelp to make HTML files and a HTML help project"
22 @echo
" latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
23 @echo
" changes to make an overview over all changed/added/deprecated items"
26 @if
[ ! -d tools
/sphinx
]; then \
27 echo
"Checking out Sphinx..."; \
28 svn checkout
$(SVNROOT
)/doctools
/trunk
/sphinx tools
/sphinx
; \
30 @if
[ ! -d tools
/docutils
]; then \
31 echo
"Checking out Docutils..."; \
32 svn checkout
$(SVNROOT
)/external
/docutils-0.4
/docutils tools
/docutils
; \
34 @if
[ ! -d tools
/pygments
]; then \
35 echo
"Checking out Pygments..."; \
36 svn checkout
$(SVNROOT
)/external
/Pygments-0.9
/pygments tools
/pygments
; \
40 svn update tools
/sphinx
41 svn update tools
/docutils
42 svn update tools
/pygments
45 mkdir
-p build
/$(BUILDER
) build
/doctrees
46 $(PYTHON
) tools
/sphinx-build.py
$(ALLSPHINXOPTS
)
51 @echo
"Build finished. The HTML pages are in build/html."
55 @echo
"Build finished; now you can run"
56 @echo
" PYTHONPATH=tools $(PYTHON) -m sphinx.web build/web"
57 @echo
"to start the server."
59 htmlhelp
: BUILDER
= htmlhelp
61 @echo
"Build finished; now you can run HTML Help Workshop with the" \
62 "build/htmlhelp/pydoc.hhp project file."
64 latex
: BUILDER
= latex
66 @echo
"Build finished; the LaTeX files are in build/latex."
67 @echo
"Run \`make all-pdf' or \`make all-ps' in that directory to" \
68 "run these through (pdf)latex."
70 changes
: BUILDER
= changes
72 @echo
"The overview file is in build/changes."