summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>1996-11-11 21:03:01 (GMT)
committerFred Drake <fdrake@acm.org>1996-11-11 21:03:01 (GMT)
commitb4d4e25a628a06c1fae19e0fd6e9daf14dce7922 (patch)
treec1f1c8a9e8fa35d35a325bfaa3a5ff846bd367d5
parent446402279921d96c3e98c6f59715827c5165be94 (diff)
downloadcpython-b4d4e25a628a06c1fae19e0fd6e9daf14dce7922.zip
cpython-b4d4e25a628a06c1fae19e0fd6e9daf14dce7922.tar.gz
cpython-b4d4e25a628a06c1fae19e0fd6e9daf14dce7922.tar.bz2
(Makefile): Updated comments about using LaTeX2HTML for the library
reference. Made the extension to the input files for makeindex explicit; if not made explicit a directory of the given base name can cause makeindex to blow up. Specifically, if there is a directory ./lib/ created by LaTeX2HTML, "makeindex lib" will fail, but "makeindex lib.idx" will not. l2h{tut,ext,lib} are now dependent on myformat.perl. l2h adds ls2lib and removes the non-existant l2href.
-rw-r--r--Doc/Makefile43
1 files changed, 18 insertions, 25 deletions
diff --git a/Doc/Makefile b/Doc/Makefile
index b7f247c..4f4e634 100644
--- a/Doc/Makefile
+++ b/Doc/Makefile
@@ -60,7 +60,7 @@ MAKEINDEX= makeindex
PYTHON= python
MAKEINFO= makeinfo
L2H= latex2html
-L2HARGS= -address $$USER@`domainname` -info ""
+L2HARGS= -address $$USER@`domainname`
# Destination directory for output of libwww target.
PARTPARSE= $(PYTHON) ./partparse.pyc
@@ -131,7 +131,7 @@ lib.dvi: $(LIBFILES)
touch lib.ind
$(LATEX) lib
./fix_hack lib.idx
- $(MAKEINDEX) lib
+ $(MAKEINDEX) lib.idx
$(LATEX) lib
lib.ps: lib.dvi
@@ -142,7 +142,7 @@ ext.dvi: ext.tex extref.tex
touch ext.ind
$(LATEX) ext
./fix_hack ext.idx
- $(MAKEINDEX) ext
+ $(MAKEINDEX) ext.idx
$(LATEX) ext
ext.ps: ext.dvi
@@ -187,36 +187,29 @@ libwww: lib.texi texi2html.pyc
# Targets to convert the manuals to HTML using Nikos Drakos' LaTeX to
# HTML converter. For more info on this program, see
# <URL:http://cbl.leeds.ac.uk/nikos/tex2html/doc/latex2html/latex2html.html>.
-# (I've had some trouble getting this to work with the netpbm version
-# of the pbmplus library; ppmtogif dumped core because giftopnm
-# outputs bitmap (pbm) files. I've fixed this by changing the source
-# of LaTeX2HTML to insert a call to pnmtoppm, which I wrote myself.
-# You can probably also use "pbmtopgm | pgmtoppm"...
-
-# In order to use these targets, you must edit the definition of L2H
-# earlier in the Makefile to point to the latex2html program. Note
-# that LaTeX2HTML inserts references to an "icons" directory in each
-# page that it generates. You can customize where these icons are to
-# be found; I generally make it point to "../icons" and then create a
-# symbolic link to the icons directory in the LaTeX2HTML source at the
-# appropriate place.
-
-l2h: l2htut l2href l2hext
-
-l2htut: tut.dvi
+
+# Note that LaTeX2HTML inserts references to an "icons" directory in
+# each page that it generates. You can customize where these icons
+# are to be found; I generally make it point to "../icons" and then
+# create a symbolic link to the icons directory in the LaTeX2HTML
+# source at the appropriate place. Change the definition of
+# $ICONSERVER in .latex2html-init to point to a different location.
+
+l2h: l2htut l2hext l2hlib
+
+l2htut: tut.dvi myformat.perl
$(L2H) $(L2HARGS) tut.tex
@rm -rf python-tut
mv tut python-tut
-l2hext: ext.dvi
+l2hext: ext.dvi myformat.perl
$(L2H) $(L2HARGS) ext.tex
@rm -rf python-ext
mv ext python-ext
-# This target doesn't quite work, since l2h doesn't understand the
-# funcdesc and similar environments, and turns them into GIF images.
-# Use the "libwww" target above instead.
-l2hlib: lib.dvi
+l2hlib: lib.dvi myformat.perl
+ ./fix_libaux.sed <lib.aux >@lib.aux
+ mv @lib.aux lib.aux
$(L2H) $(L2HARGS) lib.tex
@rm -rf python-lib
mv lib python-lib