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

blob: df07dd4fde39f353abb9441677a5b529a765a56e [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
				27	HTMLBASE= file:`pwd`
Fred Drake	5761b76	1999-02-12 21:42:23 +0000	[diff] [blame]	28
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	29	INDEXFILES=api/api.html \
				30	ext/ext.html \
				31	lib/lib.html \
				32	mac/mac.html \
				33	ref/ref.html \
				34	tut/tut.html
				35
				36	COMMONPERL= $(TOPDIR)/perl/manual.perl \
Fred Drake	54c5205	1998-08-13 19:03:19 +0000	[diff] [blame]	37	$(TOPDIR)/perl/python.perl \
				38	$(TOPDIR)/perl/l2hinit.perl
Fred Drake	f832f4c	1998-08-11 19:36:35 +0000	[diff] [blame]	39
				40
Fred Drake	684f78f	1999-02-24 17:34:12 +0000	[diff] [blame]	41	all: $(INDEXFILES) modindex.html
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	42
				43	.PHONY: api ext lib mac ref tut
				44
Fred Drake	6f9dd5d	1999-02-15 21:43:55 +0000	[diff] [blame]	45	api: api/api.html
				46	ext: ext/ext.html
				47	lib: lib/lib.html
				48	mac: mac/mac.html
				49	ref: ref/ref.html
				50	tut: tut/tut.html
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	51
Fred Drake	a8ba364	1998-11-30 20:28:35 +0000	[diff] [blame]	52	$(INDEXFILES): $(COMMONPERL) $(TOPDIR)/html/about.dat
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	53
Fred Drake	684f78f	1999-02-24 17:34:12 +0000	[diff] [blame]	54	modindex.html: lib/lib.html mac/mac.html $(TOOLSDIR)/mkmodindex
Fred Drake	368b16a	1999-03-02 15:56:19 +0000	[diff] [blame^]	55	$(TOOLSDIR)/mkmodindex --columns 4 --output modindex.html \
Fred Drake	684f78f	1999-02-24 17:34:12 +0000	[diff] [blame]	56	lib/modindex.html mac/modindex.html
				57
Fred Drake	5d56d36	1999-01-05 15:49:39 +0000	[diff] [blame]	58	api/api.html: $(PAPERDIR)/api.aux $(BUILDINDEX)
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	59	$(MKHTML) api $(L2HARGS)
				60
				61	ext/ext.html: $(PAPERDIR)/ext.aux
				62	$(MKHTML) ext $(L2HARGS)
				63
Fred Drake	5d56d36	1999-01-05 15:49:39 +0000	[diff] [blame]	64	lib/lib.html: $(PAPERDIR)/lib.aux $(BUILDINDEX)
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	65	$(TOOLSDIR)/fix_libaux.sed <`$(KPSEWHICH) lib.aux` >lib1.aux
				66	mv lib1.aux `$(KPSEWHICH) lib.aux`
				67	$(MKHTML) lib $(L2HARGS)
				68
Fred Drake	5d56d36	1999-01-05 15:49:39 +0000	[diff] [blame]	69	mac/mac.html: $(MACFILES) $(BUILDINDEX)
Fred Drake	a8ba364	1998-11-30 20:28:35 +0000	[diff] [blame]	70	$(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 Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	71
Fred Drake	5d56d36	1999-01-05 15:49:39 +0000	[diff] [blame]	72	ref/ref.html: $(PAPERDIR)/ref.aux $(BUILDINDEX)
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	73	$(MKHTML) ref $(L2HARGS)
				74
				75	tut/tut.html: $(PAPERDIR)/tut.aux
				76	$(MKHTML) tut $(L2HARGS)
Fred Drake	f832f4c	1998-08-11 19:36:35 +0000	[diff] [blame]	77
Fred Drake	60515f4	1998-05-07 14:50:22 +0000	[diff] [blame]	78
Fred Drake	2e23c31	1998-10-07 22:03:45 +0000	[diff] [blame]	79	include ../Makefile.deps
				80
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	81	$(PAPERDIR)/api.aux: $(APIFILES)
Fred Drake	4d33e4e	1999-02-15 19:29:08 +0000	[diff] [blame]	82	(cd $(PAPERDIR); $(MKAUX) api)
Fred Drake	60515f4	1998-05-07 14:50:22 +0000	[diff] [blame]	83
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	84	$(PAPERDIR)/ext.aux: $(EXTFILES)
Fred Drake	4d33e4e	1999-02-15 19:29:08 +0000	[diff] [blame]	85	(cd $(PAPERDIR); $(MKAUX) ext)
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)/lib.aux: $(LIBFILES)
Fred Drake	4d33e4e	1999-02-15 19:29:08 +0000	[diff] [blame]	88	(cd $(PAPERDIR); $(MKAUX) lib)
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)/ref.aux: $(REFFILES)
Fred Drake	4d33e4e	1999-02-15 19:29:08 +0000	[diff] [blame]	91	(cd $(PAPERDIR); $(MKAUX) ref)
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)/tut.aux: $(TUTFILES)
Fred Drake	4d33e4e	1999-02-15 19:29:08 +0000	[diff] [blame]	94	(cd $(PAPERDIR); $(MKAUX) tut)
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
Fred Drake	4d33e4e	1999-02-15 19:29:08 +0000	[diff] [blame]	97	webcheck: all
				98	$(WEBCHECKER) $(HTMLBASE)/api/
				99	$(WEBCHECKER) $(HTMLBASE)/ext/
				100	$(WEBCHECKER) -m290000 $(HTMLBASE)/lib/
				101	$(WEBCHECKER) $(HTMLBASE)/mac/
				102	$(WEBCHECKER) $(HTMLBASE)/ref/
				103	$(WEBCHECKER) $(HTMLBASE)/tut/
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	104
				105	clean:
Fred Drake	6f9dd5d	1999-02-15 21:43:55 +0000	[diff] [blame]	106	rm -rf @webchecker.pickle
Fred Drake	07b12f2	1998-08-12 17:06:03 +0000	[diff] [blame]	107
				108	clobber: clean
				109	rm -rf api/ ext/ lib/ mac/ ref/ tut/