]> granicus.if.org Git - python/commitdiff
Build rules for the "long HTML" version.
authorFred Drake <fdrake@acm.org>
Fri, 31 Mar 2000 20:22:29 +0000 (20:22 +0000)
committerFred Drake <fdrake@acm.org>
Fri, 31 Mar 2000 20:22:29 +0000 (20:22 +0000)
Doc/longhtml/Makefile [new file with mode: 0644]

diff --git a/Doc/longhtml/Makefile b/Doc/longhtml/Makefile
new file mode 100644 (file)
index 0000000..4580c17
--- /dev/null
@@ -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='<hr>Send comments on this document to <a href="mailto:python-docs@python.org">python-docs@python.org</a>.'
+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/