blob: 4ff1dd34dcb6d1629a0b577c049ca2845470a1ca (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
|
# Convenience Makefile for building HTML documentation. You probably need to
# set TEXINPUTS from the command line for this to be useful, unless you
# actually build the .dvi files in the top level directory.
#
# Note that the .dvi files must already be built and TEXINPUTS must include the
# directory where latex's working files (esp. *.aux) are kept.
PAPER=letter
TOPDIR=..
TOOLSDIR=$(TOPDIR)/tools
PAPERDIR=$(TOPDIR)/paper-$(PAPER)
TEXINPUTS=$(TOPDIR)/paper-$(PAPER):$(TOPDIR)/texinputs:
# Where are the various programs?
PYTHON= python
WEBCHECKER=$(PYTHON) $(TOPDIR)/../Tools/webchecker/webchecker.py
MKAUX= PAPER=$(PAPER) TEXINPUTS=$(TEXINPUTS) $(TOOLSDIR)/mkdvi.sh --aux
MKHTML= PAPER=$(PAPER) $(TOOLSDIR)/mkhtml.sh
KPSEWHICH= TEXINPUTS=$(TEXINPUTS) kpsewhich tex
BUILDINDEX=$(TOOLSDIR)/buildindex.py
# make it clear to l2h, since our support only generates HTML 4.0
L2HARGS= -html_version 4.0
PYTHONDOCS='<hr>Send comments to <a href="mailto:python-docs@python.org">python-docs@python.org</a>.'
HTMLBASE= file:`pwd`
INDEXFILES=api/api.html \
doc/doc.html \
ext/ext.html \
lib/lib.html \
mac/mac.html \
ref/ref.html \
tut/tut.html
COMMONPERL= $(TOPDIR)/perl/manual.perl \
$(TOPDIR)/perl/python.perl \
$(TOPDIR)/perl/l2hinit.perl
all: $(INDEXFILES) modindex.html
.PHONY: api ext lib mac ref tut
api: api/api.html
ext: ext/ext.html
lib: lib/lib.html
mac: mac/mac.html
ref: ref/ref.html
tut: tut/tut.html
$(INDEXFILES): $(COMMONPERL) $(TOPDIR)/html/about.dat
modindex.html: lib/lib.html mac/mac.html $(TOOLSDIR)/mkmodindex
$(TOOLSDIR)/mkmodindex --columns 4 --output modindex.html \
--address $(PYTHONDOCS) \
lib/modindex.html mac/modindex.html
api/api.html: $(PAPERDIR)/api.aux $(BUILDINDEX)
$(MKHTML) api $(L2HARGS)
doc/doc.html: $(DOCFILES) $(BUILDINDEX) $(TOPDIR)/perl/ltxmarkup.perl
$(TOOLSDIR)/mkhowto --address $(PYTHONDOCS) --html \
$(TOPDIR)/doc/doc.tex
ext/ext.html: $(PAPERDIR)/ext.aux
$(MKHTML) ext $(L2HARGS)
lib/lib.html: $(PAPERDIR)/lib.aux $(BUILDINDEX)
$(TOOLSDIR)/fix_libaux.sed <`$(KPSEWHICH) lib.aux` >lib1.aux
mv lib1.aux `$(KPSEWHICH) lib.aux`
$(MKHTML) lib $(L2HARGS)
mac/mac.html: $(MACFILES) $(BUILDINDEX)
$(TOOLSDIR)/mkhowto --address $(PYTHONDOCS) --html \
$(TOPDIR)/mac/mac.tex
ref/ref.html: $(PAPERDIR)/ref.aux $(BUILDINDEX)
$(MKHTML) ref $(L2HARGS)
tut/tut.html: $(PAPERDIR)/tut.aux
$(MKHTML) tut $(L2HARGS)
include ../Makefile.deps
$(PAPERDIR)/api.aux: $(APIFILES)
(cd $(PAPERDIR); $(MKAUX) api)
$(PAPERDIR)/ext.aux: $(EXTFILES)
(cd $(PAPERDIR); $(MKAUX) ext)
$(PAPERDIR)/lib.aux: $(LIBFILES)
(cd $(PAPERDIR); $(MKAUX) lib)
$(PAPERDIR)/ref.aux: $(REFFILES)
(cd $(PAPERDIR); $(MKAUX) ref)
$(PAPERDIR)/tut.aux: $(TUTFILES)
(cd $(PAPERDIR); $(MKAUX) tut)
webcheck: all
$(WEBCHECKER) $(HTMLBASE)/api/
$(WEBCHECKER) $(HTMLBASE)/doc/
$(WEBCHECKER) $(HTMLBASE)/ext/
$(WEBCHECKER) -m290000 $(HTMLBASE)/lib/
$(WEBCHECKER) $(HTMLBASE)/mac/
$(WEBCHECKER) $(HTMLBASE)/ref/
$(WEBCHECKER) $(HTMLBASE)/tut/
clean:
rm -rf @webchecker.pickle
clobber: clean
rm -rf api/ doc/ ext/ lib/ mac/ ref/ tut/
|
