1.PHONY: all
2all: sphinx
3
4# No -W for doctests because that disallows tests with empty output.
5SPHINX_DOCTEST_OPTS=-n -d build/doctress .
6SPHINXOPTS=-n -W -d build/doctrees .
7
8.PHONY: sphinx
9sphinx:
10	sphinx-build -b html $(SPHINXOPTS) build/html
11
12.PHONY: coverage
13coverage:
14	sphinx-build -b coverage ${SPHINXOPTS} build/coverage
15	cat build/coverage/python.txt
16
17.PHONY: latex
18latex:
19	sphinx-build -b latex $(SPHINXOPTS) build/latex
20
21# Building a pdf requires a latex installation.  For macports, the needed
22# packages are texlive-latex-extra and texlive-fonts-recommended.
23# The output is in build/latex/tornado.pdf
24.PHONY: pdf
25pdf: latex
26	cd build/latex && pdflatex -interaction=nonstopmode tornado.tex
27
28.PHONY: doctest
29doctest:
30	sphinx-build -b doctest $(SPHINX_DOCTEST_OPTS) build/doctest
31
32clean:
33	rm -rf build
34