Lines Matching +full:- +full:- +full:build
9 SPHINXBUILD = PATH=$(VENVDIR)/bin:$$PATH sphinx-build
14 SPHINXERRORHANDLING = -W
17 PAPEROPT_a4 = -D latex_elements.papersize=a4paper
18 PAPEROPT_letter = -D latex_elements.papersize=letterpaper
20 ALLSPHINXOPTS = -b $(BUILDER) -d build/doctrees $(PAPEROPT_$(PAPER)) \
21 $(SPHINXOPTS) $(SPHINXERRORHANDLING) . build/$(BUILDER) $(SOURCES)
23 .PHONY: help build html htmlhelp latex text texinfo changes linkcheck \
24 suspicious coverage doctest pydoc-topics htmlview clean dist check serve \
25 autobuild-dev autobuild-stable venv
29 @echo " clean to remove build files"
42 @echo " pydoc-topics to regenerate the pydoc topics file"
48 build: target
49 -mkdir -p build
53 @if [ -f ../Misc/NEWS ] ; then \
55 cp ../Misc/NEWS build/NEWS; \
56 elif $(BLURB) help >/dev/null 2>&1 && $(SPHINXBUILD) --version >/dev/null 2>&1; then \
57 if [ -d ../Misc/NEWS.d ]; then \
59 $(BLURB) merge -f build/NEWS; \
61 echo "Neither Misc/NEWS.d nor Misc/NEWS found; cannot build docs"; \
66 echo "Missing the required blurb or sphinx-build tools."; \
75 html: build
76 @echo "Build finished. The HTML pages are in build/html."
79 htmlhelp: build
80 @echo "Build finished; now you can run HTML Help Workshop with the" \
81 "build/htmlhelp/pydoc.hhp project file."
84 latex: build
85 @echo "Build finished; the LaTeX files are in build/latex."
86 @echo "Run \`make all-pdf' or \`make all-ps' in that directory to" \
90 text: build
91 @echo "Build finished; the text files are in build/text."
94 texinfo: build
95 @echo "Build finished; the python.texi file is in build/texinfo."
99 epub: build
100 @echo "Build finished; the epub files are in build/epub."
103 changes: build
104 @echo "The overview file is in build/changes."
108 @$(MAKE) build BUILDER=$(BUILDER) || { \
110 "or in build/$(BUILDER)/output.txt"; \
115 @$(MAKE) build BUILDER=$(BUILDER) || { \
117 "or in build/$(BUILDER)/suspicious.csv. If all issues are false" \
118 "positives, append that file to tools/susp-ignored.csv."; \
122 coverage: build
123 @echo "Coverage finished; see c.txt and python.txt in build/coverage"
127 @$(MAKE) build BUILDER=$(BUILDER) || { \
129 "results in build/doctest/output.txt"; \
132 pydoc-topics: BUILDER = pydoc-topics
133 pydoc-topics: build
135 "cp build/pydoc-topics/topics.py ../Lib/pydoc_data/topics.py"
138 $(PYTHON) -c "import webbrowser; webbrowser.open('build/html/index.html')"
140 clean: clean-venv
141 -rm -rf build/*
143 clean-venv:
144 rm -rf $(VENVDIR)
147 @if [ -d $(VENVDIR) ] ; then \
149 echo "To recreate it, remove it first with \`make clean-venv'."; \
151 $(PYTHON) -m venv $(VENVDIR); \
152 $(VENVDIR)/bin/python3 -m pip install -U pip setuptools; \
153 $(VENVDIR)/bin/python3 -m pip install -r requirements.txt; \
158 rm -rf dist
159 mkdir -p dist
163 cp -pPR build/html dist/python-$(DISTVERSION)-docs-html
164 tar -C dist -cf dist/python-$(DISTVERSION)-docs-html.tar python-$(DISTVERSION)-docs-html
165 bzip2 -9 -k dist/python-$(DISTVERSION)-docs-html.tar
166 (cd dist; zip -q -r -9 python-$(DISTVERSION)-docs-html.zip python-$(DISTVERSION)-docs-html)
167 rm -r dist/python-$(DISTVERSION)-docs-html
168 rm dist/python-$(DISTVERSION)-docs-html.tar
170 # archive the text build
172 cp -pPR build/text dist/python-$(DISTVERSION)-docs-text
173 tar -C dist -cf dist/python-$(DISTVERSION)-docs-text.tar python-$(DISTVERSION)-docs-text
174 bzip2 -9 -k dist/python-$(DISTVERSION)-docs-text.tar
175 (cd dist; zip -q -r -9 python-$(DISTVERSION)-docs-text.zip python-$(DISTVERSION)-docs-text)
176 rm -r dist/python-$(DISTVERSION)-docs-text
177 rm dist/python-$(DISTVERSION)-docs-text.tar
180 rm -rf build/latex
182 -sed -i 's/makeindex/makeindex -q/' build/latex/Makefile
183 (cd build/latex; make clean && make all-pdf && make FMT=pdf zip bz2)
184 cp build/latex/docs-pdf.zip dist/python-$(DISTVERSION)-docs-pdf-a4.zip
185 cp build/latex/docs-pdf.tar.bz2 dist/python-$(DISTVERSION)-docs-pdf-a4.tar.bz2
188 rm -rf build/latex
190 -sed -i 's/makeindex/makeindex -q/' build/latex/Makefile
191 (cd build/latex; make clean && make all-pdf && make FMT=pdf zip bz2)
192 cp build/latex/docs-pdf.zip dist/python-$(DISTVERSION)-docs-pdf-letter.zip
193 cp build/latex/docs-pdf.tar.bz2 dist/python-$(DISTVERSION)-docs-pdf-letter.tar.bz2
195 # copy the epub build
196 rm -rf build/epub
198 cp -pPR build/epub/Python.epub dist/python-$(DISTVERSION)-docs.epub
200 # archive the texinfo build
201 rm -rf build/texinfo
203 make info --directory=build/texinfo
204 cp -pPR build/texinfo dist/python-$(DISTVERSION)-docs-texinfo
205 tar -C dist -cf dist/python-$(DISTVERSION)-docs-texinfo.tar python-$(DISTVERSION)-docs-texinfo
206 bzip2 -9 -k dist/python-$(DISTVERSION)-docs-texinfo.tar
207 (cd dist; zip -q -r -9 python-$(DISTVERSION)-docs-texinfo.zip python-$(DISTVERSION)-docs-texinfo)
208 rm -r dist/python-$(DISTVERSION)-docs-texinfo
209 rm dist/python-$(DISTVERSION)-docs-texinfo.tar
212 $(PYTHON) tools/rstlint.py -i tools -i $(VENVDIR) -i README.rst
216 $(PYTHON) ../Tools/scripts/serve.py build/html
218 # Targets for daily automated doc build
221 # To ensure such changes are picked up, we build the published docs with
222 # `-E` (to ignore the cached environment) and `-a` (to ignore already existing
225 # for development releases: always build
226 autobuild-dev:
227 make dist SPHINXOPTS='$(SPHINXOPTS) -Ea -A daily=1'
230 autobuild-dev-html:
231 make html SPHINXOPTS='$(SPHINXOPTS) -Ea -A daily=1'
233 # for stable releases: only build if not in pre-release stage (alpha, beta)
235 autobuild-stable:
240 @make autobuild-dev
242 autobuild-stable-html:
247 @make autobuild-dev-html