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

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