summaryrefslogtreecommitdiffstats
path: root/Doc/longhtml
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>2000-03-31 20:22:29 (GMT)
committerFred Drake <fdrake@acm.org>2000-03-31 20:22:29 (GMT)
commite018beea94e2d09721ad91e578d1a3520610c57a (patch)
tree3032c12200b5aa917f7436f5af5f59b052b73623 /Doc/longhtml
parentc0605ad952b4dc16c89785d471adcfab5ad56e94 (diff)
downloadcpython-e018beea94e2d09721ad91e578d1a3520610c57a.zip
cpython-e018beea94e2d09721ad91e578d1a3520610c57a.tar.gz
cpython-e018beea94e2d09721ad91e578d1a3520610c57a.tar.bz2
Build rules for the "long HTML" version.
Diffstat (limited to 'Doc/longhtml')
-rw-r--r--Doc/longhtml/Makefile105
1 files changed, 105 insertions, 0 deletions
diff --git a/Doc/longhtml/Makefile b/Doc/longhtml/Makefile
new file mode 100644
index 0000000..4580c17
--- /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='<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/