summaryrefslogtreecommitdiffstats
path: root/Doc/html
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>2000-08-31 06:12:35 (GMT)
committerFred Drake <fdrake@acm.org>2000-08-31 06:12:35 (GMT)
commitb9b4c5b56019759d5a5b04c5ecf55b7f1d067aba (patch)
treebbe86fe362f60ba02af4d734307559c3aef48b68 /Doc/html
parentfcab76350a97b1b24e770f39aaec3e6d429e27e1 (diff)
downloadcpython-b9b4c5b56019759d5a5b04c5ecf55b7f1d067aba.zip
cpython-b9b4c5b56019759d5a5b04c5ecf55b7f1d067aba.tar.gz
cpython-b9b4c5b56019759d5a5b04c5ecf55b7f1d067aba.tar.bz2
Centralize the processing logic for LaTeX documents into the mkhowto script;
do not use mkdvi.sh or mkhtl.sh any more. This slows down building all versions of the documentation, but if you are only building one format, it does not matter.
Diffstat (limited to 'Doc/html')
-rw-r--r--Doc/html/Makefile86
1 files changed, 27 insertions, 59 deletions
diff --git a/Doc/html/Makefile b/Doc/html/Makefile
index 2115132..0778fb8 100644
--- a/Doc/html/Makefile
+++ b/Doc/html/Makefile
@@ -1,9 +1,6 @@
-# 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.
+# 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.
PAPER=letter
TOPDIR=..
@@ -15,16 +12,10 @@ TEXINPUTS=$(TOPDIR)/paper-$(PAPER):$(TOPDIR)/texinputs:
# Where are the various programs?
PYTHON= python
WEBCHECKER=$(PYTHON) $(TOPDIR)/../Tools/webchecker/webchecker.py
-WCNEW=$(PYTHON) $(TOPDIR)/../Tools/webchecker/wcnew.py
-MKAUX= PAPER=$(PAPER) TEXINPUTS=$(TEXINPUTS) $(TOOLSDIR)/mkdvi.sh --aux
-MKHTML= PAPER=$(PAPER) $(TOOLSDIR)/mkhtml.sh
-KPSEWHICH= TEXINPUTS=$(TEXINPUTS) kpsewhich tex
+MKHOWTO= $(TOOLSDIR)/mkhowto
BUILDINDEX=$(TOOLSDIR)/buildindex.py
-# make it clear to l2h, since our support only generates HTML 4.0
-L2HARGS= -html_version 4.0
-
PYTHONDOCS='<hr>See <i><a href="about.html">About this document...</a></i> for information on suggesting changes.'
HTMLBASE= file:`pwd`
@@ -70,55 +61,43 @@ modindex.html: lib/lib.html mac/mac.html $(TOOLSDIR)/mkmodindex
--address $(PYTHONDOCS) \
lib/modindex.html mac/modindex.html
-api/api.html: $(PAPERDIR)/api.aux $(BUILDINDEX) $(TOOLSDIR)/mkhtml.sh
- $(MKHTML) api $(L2HARGS) -split 5
+api/api.html: $(APIFILES) $(BUILDINDEX)
+ $(MKHOWTO) --about stdabout.dat --address $(PYTHONDOCS) \
+ --html $(TOPDIR)/api/api.tex
-doc/doc.html: $(DOCFILES) $(BUILDINDEX) $(TOPDIR)/perl/ltxmarkup.perl
- $(TOOLSDIR)/mkhowto --about stdabout.dat --address $(PYTHONDOCS) \
+doc/doc.html: $(DOCFILES) $(BUILDINDEX)
+ $(MKHOWTO) --about stdabout.dat --address $(PYTHONDOCS) \
--html $(TOPDIR)/doc/doc.tex
-ext/ext.html: $(PAPERDIR)/ext.aux $(TOOLSDIR)/mkhtml.sh
- $(MKHTML) ext $(L2HARGS) -split 5
+ext/ext.html: $(EXTFILES)
+ echo $(EXTFILES)
+ $(MKHOWTO) --about stdabout.dat --address $(PYTHONDOCS) \
+ --html $(TOPDIR)/ext/ext.tex
-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 5
+lib/lib.html: $(LIBFILES) $(BUILDINDEX)
+ $(MKHOWTO) --about stdabout.dat --address $(PYTHONDOCS) \
+ --html $(TOPDIR)/lib/lib.tex
mac/mac.html: $(MACFILES) $(BUILDINDEX)
- $(TOOLSDIR)/mkhowto --about stdabout.dat --address $(PYTHONDOCS) \
+ $(MKHOWTO) --about stdabout.dat --address $(PYTHONDOCS) \
--html $(TOPDIR)/mac/mac.tex
-ref/ref.html: $(PAPERDIR)/ref.aux $(BUILDINDEX) $(TOOLSDIR)/mkhtml.sh
- $(MKHTML) ref $(L2HARGS) -split 5
+ref/ref.html: $(REFFILES) $(BUILDINDEX)
+ $(MKHOWTO) --about stdabout.dat --address $(PYTHONDOCS) \
+ --html $(TOPDIR)/ref/ref.tex
-tut/tut.html: $(PAPERDIR)/tut.aux $(TOOLSDIR)/mkhtml.sh
- $(MKHTML) --numeric tut $(L2HARGS) -split 3
+tut/tut.html: $(TUTFILES) $(TOOLSDIR)/mkhowto
+ $(MKHOWTO) --about stdabout.dat --address $(PYTHONDOCS) \
+ --html --numeric --split 3 $(TOPDIR)/tut/tut.tex
-inst/inst.html:$(INSTFILES) $(TOPDIR)/perl/distutils.perl
- $(TOOLSDIR)/mkhowto --about stdabout.dat --address $(PYTHONDOCS) \
+inst/inst.html: $(INSTFILES) $(TOPDIR)/perl/distutils.perl
+ $(MKHOWTO) --about stdabout.dat --address $(PYTHONDOCS) \
--html $(TOPDIR)/inst/inst.tex
dist/dist.html:$(DISTFILES) $(TOPDIR)/perl/distutils.perl
- $(TOOLSDIR)/mkhowto --about stdabout.dat --address $(PYTHONDOCS) \
+ $(MKHOWTO) --about stdabout.dat --address $(PYTHONDOCS) \
--html $(TOPDIR)/dist/dist.tex
-$(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)
-
-
webcheck: all
$(WEBCHECKER) $(HTMLBASE)/api/
$(WEBCHECKER) $(HTMLBASE)/doc/
@@ -130,16 +109,6 @@ webcheck: all
$(WEBCHECKER) $(HTMLBASE)/dist/
$(WEBCHECKER) $(HTMLBASE)/inst/
-wcnew: all
- $(WCNEW) $(HTMLBASE)/api/
- $(WCNEW) $(HTMLBASE)/doc/
- $(WCNEW) $(HTMLBASE)/ext/
- $(WCNEW) -m290000 $(HTMLBASE)/lib/
- $(WCNEW) $(HTMLBASE)/mac/
- $(WCNEW) $(HTMLBASE)/ref/
- $(WCNEW) $(HTMLBASE)/tut/
-
-
clean:
rm -rf @webchecker.pickle
@@ -154,7 +123,7 @@ distclean realclean clobber: clean
# It's at the end of the file since it wedges font-lock in XEmacs.
BOILERPLATE=$(TOPDIR)/texinputs/boilerplate.tex
-index.html: index.html.in $(BOILERPLATE)
+index.html: $(TOPDIR)/html/index.html.in $(BOILERPLATE)
REL=`grep '\\release{' $(BOILERPLATE) | sed 's/.*\\release{\(.*\)}.*$$/\1/'`; \
REL=`echo "$$REL" | sed 's/[$$]//g'`; \
sed "s/@RELEASE@/$$REL/g" $< >TEMP
@@ -162,4 +131,3 @@ index.html: index.html.in $(BOILERPLATE)
if [ "$$DATE" = '\today' ] ; then DATE=`date '+%B %e, %Y'`;fi;\
sed "s/@DATE@/$$DATE/g" TEMP >$@
rm -f TEMP
-