diff --git a/Doc/longhtml/Makefile b/Doc/longhtml/Makefile new file mode 100644 index 00000000000..4580c174aeb --- /dev/null +++ b/Doc/longhtml/Makefile @@ -0,0 +1,105 @@ +# 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 +MKAUX= PAPER=$(PAPER) TEXINPUTS=$(TEXINPUTS) $(TOOLSDIR)/mkdvi.sh --aux +MKHTML= PAPER=$(PAPER) $(TOOLSDIR)/mkhtml.sh --numeric +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='
Send comments on this document to python-docs@python.org.' +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) + +.PHONY: api ext lib mac ref tut + +api: api/api.html +doc: doc/doc.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 + +api/api.html: $(PAPERDIR)/api.aux $(BUILDINDEX) $(TOOLSDIR)/mkhtml.sh + $(MKHTML) api $(L2HARGS) -split 3 + +doc/doc.html: $(DOCFILES) $(BUILDINDEX) $(TOPDIR)/perl/ltxmarkup.perl + $(TOOLSDIR)/mkhowto --numeric --split=3 --address $(PYTHONDOCS) \ + --html $(TOPDIR)/doc/doc.tex + +ext/ext.html: $(PAPERDIR)/ext.aux $(TOOLSDIR)/mkhtml.sh + $(MKHTML) ext $(L2HARGS) -split 3 + +lib/lib.html: $(PAPERDIR)/lib.aux $(BUILDINDEX) $(TOOLSDIR)/mkhtml.sh + $(TOOLSDIR)/fix_libaux.sed <`$(KPSEWHICH) lib.aux` >lib1.aux + mv lib1.aux `$(KPSEWHICH) lib.aux` + $(MKHTML) lib $(L2HARGS) -split 3 + +mac/mac.html: $(MACFILES) $(BUILDINDEX) + $(TOOLSDIR)/mkhowto --numeric --split=3 --address $(PYTHONDOCS) \ + --html $(TOPDIR)/mac/mac.tex + +ref/ref.html: $(PAPERDIR)/ref.aux $(BUILDINDEX) $(TOOLSDIR)/mkhtml.sh + $(MKHTML) ref $(L2HARGS) -split 3 + +tut/tut.html: $(PAPERDIR)/tut.aux $(TOOLSDIR)/mkhtml.sh + $(MKHTML) tut $(L2HARGS) -split 3 + + +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) + + +clean: + : + +clobber: + rm -rf api/ doc/ ext/ lib/ mac/ ref/ tut/