Mercurial > cpython-lru_cache-weakref

annotate Doc/Makefile @ 80661:94de77bd0b4b 2.7

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Issue #16194: document imp.load_dynamic problems when read several extension modules from the same binary object file.
author Andrew Svetlov <andrew.svetlov@gmail.com>
date Thu, 29 Nov 2012 19:51:28 +0200
parents 7ddacd944cd6
children 30763929082c
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
42604
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
1 #
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
2 # Makefile for Python documentation
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
3 # ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
4 #
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
5
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
6 # You can set these variables from the command line.
42608
3cc2cc795765 Don't use "?=" which seems to be a GNUism.
Georg Brandl <georg@python.org>
parents: 42604
diff changeset
7 PYTHON = python
3cc2cc795765 Don't use "?=" which seems to be a GNUism.
Georg Brandl <georg@python.org>
parents: 42604
diff changeset
8 SVNROOT = http://svn.python.org/projects
3cc2cc795765 Don't use "?=" which seems to be a GNUism.
Georg Brandl <georg@python.org>
parents: 42604
diff changeset
9 SPHINXOPTS =
44323
e97f105d1c83 Adapt conf.py to new option names.
Georg Brandl <georg@python.org>
parents: 44103
diff changeset
10 PAPER =
46002
24083305d1c7 Allow giving source names on the cmdline.
Georg Brandl <georg@python.org>
parents: 46001
diff changeset
11 SOURCES =
50305
e673632e1885 Merged revisions 67898,67904-67907,67912,67918,67920-67921,67923-67924,67927,67930,67932,67943 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 49374
diff changeset
12 DISTVERSION = $(shell $(PYTHON) tools/sphinxext/patchlevel.py)
42604
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
13
44323
e97f105d1c83 Adapt conf.py to new option names.
Georg Brandl <georg@python.org>
parents: 44103
diff changeset
14 ALLSPHINXOPTS = -b $(BUILDER) -d build/doctrees -D latex_paper_size=$(PAPER) \
46002
24083305d1c7 Allow giving source names on the cmdline.
Georg Brandl <georg@python.org>
parents: 46001
diff changeset
15 $(SPHINXOPTS) . build/$(BUILDER) $(SOURCES)
42604
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
16
59574
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
17 .PHONY: help checkout update build html htmlhelp latex text changes linkcheck \
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
18 suspicious coverage doctest pydoc-topics htmlview clean dist check serve \
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
19 autobuild-dev autobuild-stable
42604
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
20
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
21 help:
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
22 @echo "Please use \`make <target>' where <target> is one of"
59574
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
23 @echo " clean to remove build files"
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
24 @echo " update to update build tools"
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
25 @echo " html to make standalone HTML files"
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
26 @echo " htmlhelp to make HTML files and a HTML help project"
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
27 @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
28 @echo " text to make plain text files"
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
29 @echo " changes to make an overview over all changed/added/deprecated items"
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
30 @echo " linkcheck to check all external links for integrity"
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
31 @echo " coverage to check documentation coverage for library and C API"
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
32 @echo " doctest to run doctests in the documentation"
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
33 @echo " pydoc-topics to regenerate the pydoc topics file"
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
34 @echo " dist to create a \"dist\" directory with archived docs for download"
50646
e496fdb927fa Merged revisions 68288-68291,68325-68326,68338,68388,68393,68423 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 50522
diff changeset
35 @echo " suspicious to check for suspicious markup in output text"
59574
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
36 @echo " check to run a check for frequent markup errors"
59569
f255a46b315a Add Makefile targets for automatic doc build. Add script that will be used for daily build.
Georg Brandl <georg@python.org>
parents: 59106
diff changeset
37 @echo " serve to serve the documentation on the localhost (8000)"
42604
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
38
53574
b28ddebbd835 Move comment to the right place.
Georg Brandl <georg@python.org>
parents: 53571
diff changeset
39 # Note: if you update versions here, do the same in make.bat and README.txt
42604
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
40 checkout:
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
41 @if [ ! -d tools/sphinx ]; then \
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
42 echo "Checking out Sphinx..."; \
74394
905f9d976e7e update Sphinx reference from 0.6.7 to 1.0.7
Sandro Tosi <sandro.tosi@gmail.com>
parents: 68256
diff changeset
43 svn checkout $(SVNROOT)/external/Sphinx-1.0.7/sphinx tools/sphinx; \
42604
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
44 fi
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
45 @if [ ! -d tools/docutils ]; then \
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
46 echo "Checking out Docutils..."; \
59573
460823c675f8 Merged revisions 78910 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59568
diff changeset
47 svn checkout $(SVNROOT)/external/docutils-0.6/docutils tools/docutils; \
42604
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
48 fi
50646
e496fdb927fa Merged revisions 68288-68291,68325-68326,68338,68388,68393,68423 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 50522
diff changeset
49 @if [ ! -d tools/jinja2 ]; then \
46436
03d9c664a7bc Check out Jinja as a separate step now that it's not included in the Sphinx package anymore.
Georg Brandl <georg@python.org>
parents: 46002
diff changeset
50 echo "Checking out Jinja..."; \
59573
460823c675f8 Merged revisions 78910 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59568
diff changeset
51 svn checkout $(SVNROOT)/external/Jinja-2.3.1/jinja2 tools/jinja2; \
46436
03d9c664a7bc Check out Jinja as a separate step now that it's not included in the Sphinx package anymore.
Georg Brandl <georg@python.org>
parents: 46002
diff changeset
52 fi
42604
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
53 @if [ ! -d tools/pygments ]; then \
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
54 echo "Checking out Pygments..."; \
59573
460823c675f8 Merged revisions 78910 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59568
diff changeset
55 svn checkout $(SVNROOT)/external/Pygments-1.3.1/pygments tools/pygments; \
42604
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
56 fi
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
57
59568
5a16bf6da989 Merged revisions 77152 via svnmerge from
Georg Brandl <georg@python.org>
parents: 58008
diff changeset
58 update: clean checkout
42604
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
59
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
60 build: checkout
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
61 mkdir -p build/$(BUILDER) build/doctrees
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
62 $(PYTHON) tools/sphinx-build.py $(ALLSPHINXOPTS)
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
63 @echo
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
64
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
65 html: BUILDER = html
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
66 html: build
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
67 @echo "Build finished. The HTML pages are in build/html."
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
68
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
69 htmlhelp: BUILDER = htmlhelp
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
70 htmlhelp: build
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
71 @echo "Build finished; now you can run HTML Help Workshop with the" \
42609
d3362c495296 Fix a wrong path in the Makefile.
Georg Brandl <georg@python.org>
parents: 42608
diff changeset
72 "build/htmlhelp/pydoc.hhp project file."
42604
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
73
44103
1e266015cf5b Add more entries to the glossary.
Georg Brandl <georg@python.org>
parents: 43647
diff changeset
74 latex: BUILDER = latex
1e266015cf5b Add more entries to the glossary.
Georg Brandl <georg@python.org>
parents: 43647
diff changeset
75 latex: build
1e266015cf5b Add more entries to the glossary.
Georg Brandl <georg@python.org>
parents: 43647
diff changeset
76 @echo "Build finished; the LaTeX files are in build/latex."
44323
e97f105d1c83 Adapt conf.py to new option names.
Georg Brandl <georg@python.org>
parents: 44103
diff changeset
77 @echo "Run \`make all-pdf' or \`make all-ps' in that directory to" \
e97f105d1c83 Adapt conf.py to new option names.
Georg Brandl <georg@python.org>
parents: 44103
diff changeset
78 "run these through (pdf)latex."
44103
1e266015cf5b Add more entries to the glossary.
Georg Brandl <georg@python.org>
parents: 43647
diff changeset
79
47420
e8797e6e07a7 Add plain text make target.
Georg Brandl <georg@python.org>
parents: 46436
diff changeset
80 text: BUILDER = text
e8797e6e07a7 Add plain text make target.
Georg Brandl <georg@python.org>
parents: 46436
diff changeset
81 text: build
e8797e6e07a7 Add plain text make target.
Georg Brandl <georg@python.org>
parents: 46436
diff changeset
82 @echo "Build finished; the text files are in build/text."
e8797e6e07a7 Add plain text make target.
Georg Brandl <georg@python.org>
parents: 46436
diff changeset
83
44383
3625234bf3d2 Some cleanup in the docs.
Georg Brandl <georg@python.org>
parents: 44323
diff changeset
84 changes: BUILDER = changes
3625234bf3d2 Some cleanup in the docs.
Georg Brandl <georg@python.org>
parents: 44323
diff changeset
85 changes: build
3625234bf3d2 Some cleanup in the docs.
Georg Brandl <georg@python.org>
parents: 44323
diff changeset
86 @echo "The overview file is in build/changes."
3625234bf3d2 Some cleanup in the docs.
Georg Brandl <georg@python.org>
parents: 44323
diff changeset
87
45087
99ef248fb315 Add link checker builder, written for GHOP by Thomas Lamb.
Georg Brandl <georg@python.org>
parents: 44383
diff changeset
88 linkcheck: BUILDER = linkcheck
99ef248fb315 Add link checker builder, written for GHOP by Thomas Lamb.
Georg Brandl <georg@python.org>
parents: 44383
diff changeset
89 linkcheck: build
65146
5b55e8a9c107 Merged revisions 85276 via svnmerge from
Georg Brandl <georg@python.org>
parents: 63679
diff changeset
90 @echo "Link check complete; look for any errors in the above output" \
45091
6492a78e93b4 Wording nit.
Georg Brandl <georg@python.org>
parents: 45087
diff changeset
91 "or in build/$(BUILDER)/output.txt"
45087
99ef248fb315 Add link checker builder, written for GHOP by Thomas Lamb.
Georg Brandl <georg@python.org>
parents: 44383
diff changeset
92
50646
e496fdb927fa Merged revisions 68288-68291,68325-68326,68338,68388,68393,68423 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 50522
diff changeset
93 suspicious: BUILDER = suspicious
e496fdb927fa Merged revisions 68288-68291,68325-68326,68338,68388,68393,68423 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 50522
diff changeset
94 suspicious: build
65146
5b55e8a9c107 Merged revisions 85276 via svnmerge from
Georg Brandl <georg@python.org>
parents: 63679
diff changeset
95 @echo "Suspicious check complete; look for any errors in the above output" \
5b55e8a9c107 Merged revisions 85276 via svnmerge from
Georg Brandl <georg@python.org>
parents: 63679
diff changeset
96 "or in build/$(BUILDER)/suspicious.csv. If all issues are false" \
5b55e8a9c107 Merged revisions 85276 via svnmerge from
Georg Brandl <georg@python.org>
parents: 63679
diff changeset
97 "positives, append that file to tools/sphinxext/susp-ignored.csv."
50646
e496fdb927fa Merged revisions 68288-68291,68325-68326,68338,68388,68393,68423 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 50522
diff changeset
98
45472
6ba5308f7ba4 Documentation coverage builder, part 1.
Georg Brandl <georg@python.org>
parents: 45091
diff changeset
99 coverage: BUILDER = coverage
6ba5308f7ba4 Documentation coverage builder, part 1.
Georg Brandl <georg@python.org>
parents: 45091
diff changeset
100 coverage: build
6ba5308f7ba4 Documentation coverage builder, part 1.
Georg Brandl <georg@python.org>
parents: 45091
diff changeset
101 @echo "Coverage finished; see c.txt and python.txt in build/coverage"
6ba5308f7ba4 Documentation coverage builder, part 1.
Georg Brandl <georg@python.org>
parents: 45091
diff changeset
102
46001
a99ca1e575ed Activate the Sphinx doctest extension and convert howto/functional to use it.
Georg Brandl <georg@python.org>
parents: 45472
diff changeset
103 doctest: BUILDER = doctest
a99ca1e575ed Activate the Sphinx doctest extension and convert howto/functional to use it.
Georg Brandl <georg@python.org>
parents: 45472
diff changeset
104 doctest: build
65146
5b55e8a9c107 Merged revisions 85276 via svnmerge from
Georg Brandl <georg@python.org>
parents: 63679
diff changeset
105 @echo "Testing of doctests in the sources finished, look at the" \
46001
a99ca1e575ed Activate the Sphinx doctest extension and convert howto/functional to use it.
Georg Brandl <georg@python.org>
parents: 45472
diff changeset
106 "results in build/doctest/output.txt"
a99ca1e575ed Activate the Sphinx doctest extension and convert howto/functional to use it.
Georg Brandl <georg@python.org>
parents: 45472
diff changeset
107
47431
c0d616f0ad86 Generate pydoc's topic help from the reST docs via Sphinx'
Georg Brandl <georg@python.org>
parents: 47420
diff changeset
108 pydoc-topics: BUILDER = pydoc-topics
c0d616f0ad86 Generate pydoc's topic help from the reST docs via Sphinx'
Georg Brandl <georg@python.org>
parents: 47420
diff changeset
109 pydoc-topics: build
65146
5b55e8a9c107 Merged revisions 85276 via svnmerge from
Georg Brandl <georg@python.org>
parents: 63679
diff changeset
110 @echo "Building finished; now copy build/pydoc-topics/topics.py" \
53461
64110c0ad530 Move pydoc_topics module to its own subdirectory, so that no generated code is in Lib/.
Georg Brandl <georg@python.org>
parents: 53460
diff changeset
111 "to Lib/pydoc_data/topics.py"
47431
c0d616f0ad86 Generate pydoc's topic help from the reST docs via Sphinx'
Georg Brandl <georg@python.org>
parents: 47420
diff changeset
112
47832
723c0ff698b7 add a htmlview directive
Benjamin Peterson <benjamin@python.org>
parents: 47831
diff changeset
113 htmlview: html
723c0ff698b7 add a htmlview directive
Benjamin Peterson <benjamin@python.org>
parents: 47831
diff changeset
114 $(PYTHON) -c "import webbrowser; webbrowser.open('build/html/index.html')"
49254
386a03ec1ff0 Add "dist" target.
Georg Brandl <georg@python.org>
parents: 49250
diff changeset
115
42604
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
116 clean:
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
117 -rm -rf build/*
9e1529bf0442 Move the 3k reST doc tree in place.
Georg Brandl <georg@python.org>
parents:
diff changeset
118 -rm -rf tools/sphinx
59568
5a16bf6da989 Merged revisions 77152 via svnmerge from
Georg Brandl <georg@python.org>
parents: 58008
diff changeset
119 -rm -rf tools/pygments
5a16bf6da989 Merged revisions 77152 via svnmerge from
Georg Brandl <georg@python.org>
parents: 58008
diff changeset
120 -rm -rf tools/jinja2
5a16bf6da989 Merged revisions 77152 via svnmerge from
Georg Brandl <georg@python.org>
parents: 58008
diff changeset
121 -rm -rf tools/docutils
49254
386a03ec1ff0 Add "dist" target.
Georg Brandl <georg@python.org>
parents: 49250
diff changeset
122
386a03ec1ff0 Add "dist" target.
Georg Brandl <georg@python.org>
parents: 49250
diff changeset
123 dist:
63679
71ae523eba5b Merged revisions 83663 via svnmerge from
Georg Brandl <georg@python.org>
parents: 62948
diff changeset
124 rm -rf dist
49254
386a03ec1ff0 Add "dist" target.
Georg Brandl <georg@python.org>
parents: 49250
diff changeset
125 mkdir -p dist
386a03ec1ff0 Add "dist" target.
Georg Brandl <georg@python.org>
parents: 49250
diff changeset
126
386a03ec1ff0 Add "dist" target.
Georg Brandl <georg@python.org>
parents: 49250
diff changeset
127 # archive the HTML
386a03ec1ff0 Add "dist" target.
Georg Brandl <georg@python.org>
parents: 49250
diff changeset
128 make html
50305
e673632e1885 Merged revisions 67898,67904-67907,67912,67918,67920-67921,67923-67924,67927,67930,67932,67943 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 49374
diff changeset
129 cp -pPR build/html dist/python-$(DISTVERSION)-docs-html
e673632e1885 Merged revisions 67898,67904-67907,67912,67918,67920-67921,67923-67924,67927,67930,67932,67943 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 49374
diff changeset
130 tar -C dist -cf dist/python-$(DISTVERSION)-docs-html.tar python-$(DISTVERSION)-docs-html
e673632e1885 Merged revisions 67898,67904-67907,67912,67918,67920-67921,67923-67924,67927,67930,67932,67943 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 49374
diff changeset
131 bzip2 -9 -k dist/python-$(DISTVERSION)-docs-html.tar
e673632e1885 Merged revisions 67898,67904-67907,67912,67918,67920-67921,67923-67924,67927,67930,67932,67943 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 49374
diff changeset
132 (cd dist; zip -q -r -9 python-$(DISTVERSION)-docs-html.zip python-$(DISTVERSION)-docs-html)
e673632e1885 Merged revisions 67898,67904-67907,67912,67918,67920-67921,67923-67924,67927,67930,67932,67943 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 49374
diff changeset
133 rm -r dist/python-$(DISTVERSION)-docs-html
e673632e1885 Merged revisions 67898,67904-67907,67912,67918,67920-67921,67923-67924,67927,67930,67932,67943 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 49374
diff changeset
134 rm dist/python-$(DISTVERSION)-docs-html.tar
49254
386a03ec1ff0 Add "dist" target.
Georg Brandl <georg@python.org>
parents: 49250
diff changeset
135
386a03ec1ff0 Add "dist" target.
Georg Brandl <georg@python.org>
parents: 49250
diff changeset
136 # archive the text build
386a03ec1ff0 Add "dist" target.
Georg Brandl <georg@python.org>
parents: 49250
diff changeset
137 make text
50305
e673632e1885 Merged revisions 67898,67904-67907,67912,67918,67920-67921,67923-67924,67927,67930,67932,67943 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 49374
diff changeset
138 cp -pPR build/text dist/python-$(DISTVERSION)-docs-text
e673632e1885 Merged revisions 67898,67904-67907,67912,67918,67920-67921,67923-67924,67927,67930,67932,67943 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 49374
diff changeset
139 tar -C dist -cf dist/python-$(DISTVERSION)-docs-text.tar python-$(DISTVERSION)-docs-text
e673632e1885 Merged revisions 67898,67904-67907,67912,67918,67920-67921,67923-67924,67927,67930,67932,67943 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 49374
diff changeset
140 bzip2 -9 -k dist/python-$(DISTVERSION)-docs-text.tar
e673632e1885 Merged revisions 67898,67904-67907,67912,67918,67920-67921,67923-67924,67927,67930,67932,67943 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 49374
diff changeset
141 (cd dist; zip -q -r -9 python-$(DISTVERSION)-docs-text.zip python-$(DISTVERSION)-docs-text)
e673632e1885 Merged revisions 67898,67904-67907,67912,67918,67920-67921,67923-67924,67927,67930,67932,67943 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 49374
diff changeset
142 rm -r dist/python-$(DISTVERSION)-docs-text
e673632e1885 Merged revisions 67898,67904-67907,67912,67918,67920-67921,67923-67924,67927,67930,67932,67943 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 49374
diff changeset
143 rm dist/python-$(DISTVERSION)-docs-text.tar
53461
64110c0ad530 Move pydoc_topics module to its own subdirectory, so that no generated code is in Lib/.
Georg Brandl <georg@python.org>
parents: 53460
diff changeset
144
49254
386a03ec1ff0 Add "dist" target.
Georg Brandl <georg@python.org>
parents: 49250
diff changeset
145 # archive the A4 latex
63679
71ae523eba5b Merged revisions 83663 via svnmerge from
Georg Brandl <georg@python.org>
parents: 62948
diff changeset
146 rm -rf build/latex
49254
386a03ec1ff0 Add "dist" target.
Georg Brandl <georg@python.org>
parents: 49250
diff changeset
147 make latex PAPER=a4
63512
9c75a94187c7 Merged revisions 82793-82794,82807,82876,83432 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59583
diff changeset
148 -sed -i 's/makeindex/makeindex -q/' build/latex/Makefile
49254
386a03ec1ff0 Add "dist" target.
Georg Brandl <georg@python.org>
parents: 49250
diff changeset
149 (cd build/latex; make clean && make all-pdf && make FMT=pdf zip bz2)
50305
e673632e1885 Merged revisions 67898,67904-67907,67912,67918,67920-67921,67923-67924,67927,67930,67932,67943 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 49374
diff changeset
150 cp build/latex/docs-pdf.zip dist/python-$(DISTVERSION)-docs-pdf-a4.zip
e673632e1885 Merged revisions 67898,67904-67907,67912,67918,67920-67921,67923-67924,67927,67930,67932,67943 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 49374
diff changeset
151 cp build/latex/docs-pdf.tar.bz2 dist/python-$(DISTVERSION)-docs-pdf-a4.tar.bz2
49254
386a03ec1ff0 Add "dist" target.
Georg Brandl <georg@python.org>
parents: 49250
diff changeset
152
386a03ec1ff0 Add "dist" target.
Georg Brandl <georg@python.org>
parents: 49250
diff changeset
153 # archive the letter latex
63679
71ae523eba5b Merged revisions 83663 via svnmerge from
Georg Brandl <georg@python.org>
parents: 62948
diff changeset
154 rm -rf build/latex
49254
386a03ec1ff0 Add "dist" target.
Georg Brandl <georg@python.org>
parents: 49250
diff changeset
155 make latex PAPER=letter
63512
9c75a94187c7 Merged revisions 82793-82794,82807,82876,83432 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59583
diff changeset
156 -sed -i 's/makeindex/makeindex -q/' build/latex/Makefile
49254
386a03ec1ff0 Add "dist" target.
Georg Brandl <georg@python.org>
parents: 49250
diff changeset
157 (cd build/latex; make clean && make all-pdf && make FMT=pdf zip bz2)
50305
e673632e1885 Merged revisions 67898,67904-67907,67912,67918,67920-67921,67923-67924,67927,67930,67932,67943 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 49374
diff changeset
158 cp build/latex/docs-pdf.zip dist/python-$(DISTVERSION)-docs-pdf-letter.zip
e673632e1885 Merged revisions 67898,67904-67907,67912,67918,67920-67921,67923-67924,67927,67930,67932,67943 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 49374
diff changeset
159 cp build/latex/docs-pdf.tar.bz2 dist/python-$(DISTVERSION)-docs-pdf-letter.tar.bz2
49254
386a03ec1ff0 Add "dist" target.
Georg Brandl <georg@python.org>
parents: 49250
diff changeset
160
50522
ee9ced92843a Merged revisions 68133-68134,68141-68142,68145-68146,68148-68149,68159-68162,68166,68171-68174,68179,68195-68196,68210,68214-68215,68217-68222 via svnmerge from
Georg Brandl <georg@python.org>
parents: 50305
diff changeset
161 check:
ee9ced92843a Merged revisions 68133-68134,68141-68142,68145-68146,68148-68149,68159-68162,68166,68171-68174,68179,68195-68196,68210,68214-68215,68217-68222 via svnmerge from
Georg Brandl <georg@python.org>
parents: 50305
diff changeset
162 $(PYTHON) tools/rstlint.py -i tools
59574
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
163
59106
9ebbcb7a3989 Issue #8004: add a serve target to the Doc Makefile.
Dirkjan Ochtman <dirkjan@ochtman.nl>
parents: 58012
diff changeset
164 serve:
9ebbcb7a3989 Issue #8004: add a serve target to the Doc Makefile.
Dirkjan Ochtman <dirkjan@ochtman.nl>
parents: 58012
diff changeset
165 ../Tools/scripts/serve.py build/html
59569
f255a46b315a Add Makefile targets for automatic doc build. Add script that will be used for daily build.
Georg Brandl <georg@python.org>
parents: 59106
diff changeset
166
59583
e1d51cd315d0 Merged revisions 78921 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59574
diff changeset
167 # Targets for daily automated doc build
59574
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
168
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
169 # for development releases: always build
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
170 autobuild-dev:
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
171 make update
79994
4a17784f2fee #8040: port versionswitcher patch to 2.6.
Georg Brandl <georg@python.org>
parents: 63512
diff changeset
172 make dist SPHINXOPTS='-A daily=1 -A versionswitcher=1'
59574
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
173
79999
7ddacd944cd6 Add a autobuild-quick target that only rebuilds HTML.
Georg Brandl <georg@python.org>
parents: 79995
diff changeset
174 # for quick rebuilds (HTML only)
7ddacd944cd6 Add a autobuild-quick target that only rebuilds HTML.
Georg Brandl <georg@python.org>
parents: 79995
diff changeset
175 autobuild-html:
7ddacd944cd6 Add a autobuild-quick target that only rebuilds HTML.
Georg Brandl <georg@python.org>
parents: 79995
diff changeset
176 make html SPHINXOPTS='-A daily=1 -A versionswitcher=1'
7ddacd944cd6 Add a autobuild-quick target that only rebuilds HTML.
Georg Brandl <georg@python.org>
parents: 79995
diff changeset
177
59583
e1d51cd315d0 Merged revisions 78921 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59574
diff changeset
178 # for stable releases: only build if not in pre-release stage (alpha, beta, rc)
59574
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
179 autobuild-stable:
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
180 @case $(DISTVERSION) in *[abc]*) \
59583
e1d51cd315d0 Merged revisions 78921 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59574
diff changeset
181 echo "Not building; $(DISTVERSION) is not a release version."; \
e1d51cd315d0 Merged revisions 78921 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59574
diff changeset
182 exit 1;; \
59574
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
183 esac
43ca67bd700a Merged revisions 78908 via svnmerge from
Georg Brandl <georg@python.org>
parents: 59573
diff changeset
184 @make autobuild-dev
79999
7ddacd944cd6 Add a autobuild-quick target that only rebuilds HTML.
Georg Brandl <georg@python.org>
parents: 79995
diff changeset
185