Blame - Doc/html/Makefile - platform/external/python/cpython3

blob: e6bf339aaa114c7807c6fafc288cb089d75a92e1 [file] [log] [blame]

Fred Drake	60515f4	1998-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 Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	8	PAPER=letter
Fred Drake	f832f4c	1998-08-11 19:36:35 +0000	[diff] [blame]	9	TOPDIR=..
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	10	TOOLSDIR=$(TOPDIR)/tools
				11	PAPERDIR=$(TOPDIR)/paper-$(PAPER)
Fred Drake	f832f4c	1998-08-11 19:36:35 +0000	[diff] [blame]	12
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	13	TEXINPUTS=$(TOPDIR)/paper-$(PAPER):$(TOPDIR)/texinputs:
				14
				15	# Where are the various programs?
Fred Drake	4d33e4e	1999-02-15 19:29:08 +0000	[diff] [blame]	16	PYTHON= python
				17	WEBCHECKER=$(PYTHON) $(TOPDIR)/../Tools/webchecker/webchecker.py
				18	MKAUX= PAPER=$(PAPER) TEXINPUTS=$(TEXINPUTS) $(TOOLSDIR)/mkdvi.sh --aux
				19	MKHTML= PAPER=$(PAPER) $(TOOLSDIR)/mkhtml.sh
				20	KPSEWHICH= TEXINPUTS=$(TEXINPUTS) kpsewhich tex
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	21
Fred Drake	4d33e4e	1999-02-15 19:29:08 +0000	[diff] [blame]	22	BUILDINDEX=$(TOOLSDIR)/buildindex.py
Fred Drake	5d56d36	1999-01-05 15:49:39 +0000	[diff] [blame]	23
Fred Drake	5761b76	1999-02-12 21:42:23 +0000	[diff] [blame]	24	# make it clear to l2h, since our support only generates HTML 4.0
Fred Drake	4d33e4e	1999-02-15 19:29:08 +0000	[diff] [blame]	25	L2HARGS= -html_version 4.0
				26
Fred Drake	b41f97d	1999-03-04 21:25:05 +0000	[diff] [blame^]	27	PYTHONDOCS='<hr>Send comments to <a href="mailto:python-docs@python.org">python-docs@python.org</a>.'
Fred Drake	4d33e4e	1999-02-15 19:29:08 +0000	[diff] [blame]	28	HTMLBASE= file:`pwd`
Fred Drake	5761b76	1999-02-12 21:42:23 +0000	[diff] [blame]	29
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	30	INDEXFILES=api/api.html \
				31	ext/ext.html \
				32	lib/lib.html \
				33	mac/mac.html \
				34	ref/ref.html \
				35	tut/tut.html
				36
				37	COMMONPERL= $(TOPDIR)/perl/manual.perl \
Fred Drake	54c5205	1998-08-13 19:03:19 +0000	[diff] [blame]	38	$(TOPDIR)/perl/python.perl \
				39	$(TOPDIR)/perl/l2hinit.perl
Fred Drake	f832f4c	1998-08-11 19:36:35 +0000	[diff] [blame]	40
				41
Fred Drake	684f78f	1999-02-24 17:34:12 +0000	[diff] [blame]	42	all: $(INDEXFILES) modindex.html
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	43
				44	.PHONY: api ext lib mac ref tut
				45
Fred Drake	6f9dd5d	1999-02-15 21:43:55 +0000	[diff] [blame]	46	api: api/api.html
				47	ext: ext/ext.html
				48	lib: lib/lib.html
				49	mac: mac/mac.html
				50	ref: ref/ref.html
				51	tut: tut/tut.html
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	52
Fred Drake	a8ba364	1998-11-30 20:28:35 +0000	[diff] [blame]	53	$(INDEXFILES): $(COMMONPERL) $(TOPDIR)/html/about.dat
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	54
Fred Drake	684f78f	1999-02-24 17:34:12 +0000	[diff] [blame]	55	modindex.html: lib/lib.html mac/mac.html $(TOOLSDIR)/mkmodindex
Fred Drake	368b16a	1999-03-02 15:56:19 +0000	[diff] [blame]	56	$(TOOLSDIR)/mkmodindex --columns 4 --output modindex.html \
Fred Drake	b41f97d	1999-03-04 21:25:05 +0000	[diff] [blame^]	57	--address $(PYTHONDOCS) \
Fred Drake	684f78f	1999-02-24 17:34:12 +0000	[diff] [blame]	58	lib/modindex.html mac/modindex.html
				59
Fred Drake	5d56d36	1999-01-05 15:49:39 +0000	[diff] [blame]	60	api/api.html: $(PAPERDIR)/api.aux $(BUILDINDEX)
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	61	$(MKHTML) api $(L2HARGS)
				62
				63	ext/ext.html: $(PAPERDIR)/ext.aux
				64	$(MKHTML) ext $(L2HARGS)
				65
Fred Drake	5d56d36	1999-01-05 15:49:39 +0000	[diff] [blame]	66	lib/lib.html: $(PAPERDIR)/lib.aux $(BUILDINDEX)
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	67	$(TOOLSDIR)/fix_libaux.sed <`$(KPSEWHICH) lib.aux` >lib1.aux
				68	mv lib1.aux `$(KPSEWHICH) lib.aux`
				69	$(MKHTML) lib $(L2HARGS)
				70
Fred Drake	5d56d36	1999-01-05 15:49:39 +0000	[diff] [blame]	71	mac/mac.html: $(MACFILES) $(BUILDINDEX)
Fred Drake	b41f97d	1999-03-04 21:25:05 +0000	[diff] [blame^]	72	$(TOOLSDIR)/mkhowto --address $(PYTHONDOCS) --html \
				73	$(TOPDIR)/mac/mac.tex
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	74
Fred Drake	5d56d36	1999-01-05 15:49:39 +0000	[diff] [blame]	75	ref/ref.html: $(PAPERDIR)/ref.aux $(BUILDINDEX)
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	76	$(MKHTML) ref $(L2HARGS)
				77
				78	tut/tut.html: $(PAPERDIR)/tut.aux
				79	$(MKHTML) tut $(L2HARGS)
Fred Drake	f832f4c	1998-08-11 19:36:35 +0000	[diff] [blame]	80
Fred Drake	60515f4	1998-05-07 14:50:22 +0000	[diff] [blame]	81
Fred Drake	2e23c31	1998-10-07 22:03:45 +0000	[diff] [blame]	82	include ../Makefile.deps
				83
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	84	$(PAPERDIR)/api.aux: $(APIFILES)
Fred Drake	4d33e4e	1999-02-15 19:29:08 +0000	[diff] [blame]	85	(cd $(PAPERDIR); $(MKAUX) api)
Fred Drake	60515f4	1998-05-07 14:50:22 +0000	[diff] [blame]	86
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	87	$(PAPERDIR)/ext.aux: $(EXTFILES)
Fred Drake	4d33e4e	1999-02-15 19:29:08 +0000	[diff] [blame]	88	(cd $(PAPERDIR); $(MKAUX) ext)
Fred Drake	60515f4	1998-05-07 14:50:22 +0000	[diff] [blame]	89
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	90	$(PAPERDIR)/lib.aux: $(LIBFILES)
Fred Drake	4d33e4e	1999-02-15 19:29:08 +0000	[diff] [blame]	91	(cd $(PAPERDIR); $(MKAUX) lib)
Fred Drake	60515f4	1998-05-07 14:50:22 +0000	[diff] [blame]	92
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	93	$(PAPERDIR)/ref.aux: $(REFFILES)
Fred Drake	4d33e4e	1999-02-15 19:29:08 +0000	[diff] [blame]	94	(cd $(PAPERDIR); $(MKAUX) ref)
Fred Drake	60515f4	1998-05-07 14:50:22 +0000	[diff] [blame]	95
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	96	$(PAPERDIR)/tut.aux: $(TUTFILES)
Fred Drake	4d33e4e	1999-02-15 19:29:08 +0000	[diff] [blame]	97	(cd $(PAPERDIR); $(MKAUX) tut)
Fred Drake	60515f4	1998-05-07 14:50:22 +0000	[diff] [blame]	98
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	99
Fred Drake	4d33e4e	1999-02-15 19:29:08 +0000	[diff] [blame]	100	webcheck: all
				101	$(WEBCHECKER) $(HTMLBASE)/api/
				102	$(WEBCHECKER) $(HTMLBASE)/ext/
				103	$(WEBCHECKER) -m290000 $(HTMLBASE)/lib/
				104	$(WEBCHECKER) $(HTMLBASE)/mac/
				105	$(WEBCHECKER) $(HTMLBASE)/ref/
				106	$(WEBCHECKER) $(HTMLBASE)/tut/
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	107
				108	clean:
Fred Drake	6f9dd5d	1999-02-15 21:43:55 +0000	[diff] [blame]	109	rm -rf @webchecker.pickle
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	110
				111	clobber: clean
				112	rm -rf api/ ext/ lib/ mac/ ref/ tut/