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