1 # Makefile for (Sphinx based) restructured text documentation
4 # You can set these variables from the command line.
6 SPHINXBUILD
= sphinx-build
9 QCOLLECTIONGENERATOR
= qcollectiongenerator
12 PAPEROPT_a4
= -D latex_paper_size
=a4
13 PAPEROPT_letter
= -D latex_paper_size
=letter
14 ALLSPHINXOPTS
= -d build
/doctrees
$(PAPEROPT_
$(PAPER
)) $(SPHINXOPTS
) .
16 .PHONY
: help
clean distclean html web pickle htmlhelp qthelp qhc latex changes linkcheck
19 @echo
"Please use \`make <target>' where <target> is one of"
20 @echo
" html to make standalone HTML files"
21 @echo
" pickle to make pickle files"
22 @echo
" json to make JSON files"
23 @echo
" htmlhelp to make HTML files and a HTML help project"
24 @echo
" qthelp to make HTML files and a qthelp project"
25 @echo
" qhc to make QHC file"
26 @echo
" latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
27 @echo
" man to make manpages"
28 @echo
" changes to make an overview over all changed/added/deprecated items"
29 @echo
" linkcheck to check all external links for integrity"
38 mkdir
-p build
/html build
/doctrees
39 $(SPHINXBUILD
) -b html
$(ALLSPHINXOPTS
) build
/html
41 @echo
"Build finished. The HTML pages are in build/html."
44 (cd build
; zip TortoiseHg.html.zip
-r html
)
47 mkdir
-p build
/pickle build
/doctrees
48 $(SPHINXBUILD
) -b pickle
$(ALLSPHINXOPTS
) build
/pickle
50 @echo
"Build finished; now you can process the pickle files."
55 mkdir
-p build
/json build
/doctrees
56 $(SPHINXBUILD
) -b json
$(ALLSPHINXOPTS
) build
/json
58 @echo
"Build finished; now you can process the JSON files."
61 mkdir
-p build
/htmlhelp build
/doctrees
62 $(SPHINXBUILD
) -b htmlhelp
$(ALLSPHINXOPTS
) build
/htmlhelp
64 @echo
"Build finished; now you can run HTML Help Workshop with the" \
65 ".hhp project file in build/htmlhelp."
68 mkdir
-p build
/qthelp build
/doctrees
69 $(SPHINXBUILD
) -b qthelp
$(ALLSPHINXOPTS
) build
/qthelp
71 @echo
"Build finished; now you can run "qcollectiongenerator
" with the" \
72 ".qhcp project file in build/qthelp, like this:"
73 @echo
"# qcollectiongenerator build/qthelp/foo.qhcp"
74 @echo
"To view the help file:"
75 @echo
"# assistant -collectionFile build/qthelp/foo.qhc"
78 $(QCOLLECTIONGENERATOR
) build
/qthelp
/TortoiseHg.qhcp
79 @echo
"Build finished. To view the help file:"
80 @echo
"# assistant -collectionFile build/qthelp/TortoiseHg.qhc"
83 mkdir
-p build
/latex build
/doctrees
84 $(SPHINXBUILD
) -b latex
$(ALLSPHINXOPTS
) build
/latex
86 @echo
"Build finished; the LaTeX files are in build/latex."
87 @echo
"Run \`make all-pdf' or \`make all-ps' in that directory to" \
88 "run these through (pdf)latex."
91 mkdir
-p build
/man build
/doctrees
92 $(SPHINXBUILD
) -b man
$(ALLSPHINXOPTS
) build
/man
94 @echo
"Build finished; the manpages are in build/man."
95 @echo
"Run \`man -l build/man/x265.1' or \`man -l build/man/libx265.3'" \
99 mkdir
-p build
/changes build
/doctrees
100 $(SPHINXBUILD
) -b changes
$(ALLSPHINXOPTS
) build
/changes
102 @echo
"The overview file is in build/changes."
105 mkdir
-p build
/linkcheck build
/doctrees
106 $(SPHINXBUILD
) -b linkcheck
$(ALLSPHINXOPTS
) build
/linkcheck
108 @echo
"Link check complete; look for any errors in the above output " \
109 "or in build/linkcheck/output.txt."