Made a start with api.tex, the Python-C API Reference Manual.

Removed extref.tex (which provided the starting point).
Also removed qua.tex, which is out of date and no longer needed.

1 files changed, 29 insertions, 24 deletions

diff --git a/Doc/Makefile b/Doc/Makefile
index 3edd6b6..a136685 100644
--- a/Doc/Makefile
+++ b/Doc/Makefile
@@ -7,6 +7,7 @@
 #   tut -- Tutorial (file tut.tex)
 #   lib -- Library Reference (file lib.tex, inputs lib*.tex)
 #   ext -- Extending and Embedding (file ext.tex)
+#   api -- Python-C API Reference
 #
 # The Reference Manual is now maintained as a FrameMaker document.
 # See the subdirectory ref; PostScript is included as ref/ref.ps.
@@ -18,9 +19,6 @@
 # four.  You can also do "make lib" (etc.) to process individual
 # documents.
 #
-# There's also:
-#   qua -- Paper published in the CWI Quarterly (file qua.tex)
-#
 # There's one local style file: myformat.sty.  This defines a number
 # of macros that are similar in name and intent as macros in Texinfo
 # (e.g. \code{...} and \emph{...}), as well as a number of
@@ -31,7 +29,6 @@
 #   latex
 #   makeindex
 #   dvips
-#   bibtex (only for formatting qua.tex)
 #
 # There's a problem with generating the index which has been solved by
 # a sed command applied to the index file.  The shell script fix_hack
@@ -43,7 +40,7 @@
 # Additional targets attempt to convert selected LaTeX sources to
 # various other formats.  These are generally site specific because
 # the tools used are all but universal.  These targets are:
-#   l2h -- convert tut, lib, ext from LaTeX to HTML
+#   l2h -- convert tut, lib, ext, api from LaTeX to HTML
 # See the README file for more info on these targets.
 
 # Customizations -- you *may* have to edit these
@@ -67,19 +64,17 @@ DOCDESTDIR=	$LIBDEST/doc
 # Main target
 all:	all-ps
 
-all-dvi: tut.dvi lib.dvi ext.dvi
-all-ps:	tut.ps lib.ps ext.ps
+all-dvi: tut.dvi lib.dvi ext.dvi api.dvi
+all-ps:	tut.ps lib.ps ext.ps api.ps
 
 # Individual document fake targets
 tut:	tut.ps
 lib:	lib.ps
 ext:	ext.ps
-
-# CWI Quarterly document fake target
-qua:	qua.ps
+api:	api.ps
 
 # Dependencies
-tut.dvi lib.dvi ext.dvi: myformat.sty fix_hack
+tut.dvi lib.dvi ext.dvi api.dvi: myformat.sty fix_hack
 
 # Tutorial document
 tut.dvi: tut.tex 
@@ -129,7 +124,7 @@ lib.ps:	lib.dvi
 	$(DVIPS) lib >lib.ps
 
 # Extensions document
-ext.dvi: ext.tex extref.tex
+ext.dvi: ext.tex
 	touch ext.ind
 	$(LATEX) ext
 	./fix_hack ext.idx
@@ -139,15 +134,16 @@ ext.dvi: ext.tex extref.tex
 ext.ps:	ext.dvi
 	$(DVIPS) ext >ext.ps
 
-# Quarterly document
-qua.dvi: qua.tex quabib.bib
-	$(LATEX) qua
-	$(BIBTEX) qua
-	$(LATEX) qua
-	$(BIBTEX) qua
+# Python-C API document
+api.dvi: api.tex 
+	touch api.ind
+	$(LATEX) api
+	./fix_hack api.idx
+	$(MAKEINDEX) api.idx
+	$(LATEX) api
 
-qua.ps:	qua.dvi
-	$(DVIPS) qua >qua.ps
+api.ps:	api.dvi
+	$(DVIPS) api >api.ps
 
 
 # The remaining part of the Makefile is concerned with various
@@ -168,7 +164,7 @@ qua.ps:	qua.dvi
 # of; the prominent location makes it worth the extra step.  This affects the
 # title pages!
 
-l2h: l2htut l2hext l2hlib
+l2h: l2htut l2hext l2hlib l2htut
 
 l2htut: tut.dvi myformat.perl
 	$(L2H) $(L2HARGS) tut.tex
@@ -199,15 +195,24 @@ l2hlib: lib.dvi myformat.perl
 	@rm -rf python-lib
 	mv lib python-lib
 
+l2hapi: api.dvi myformat.perl
+	$(L2H) $(L2HARGS) api.tex
+	@rm -rf python-api
+	sed 's/^<P CLASS=ABSTRACT>,/<P CLASS=ABSTRACT>/' \
+		<api/api.html >api/xxx
+	ln -s api.html api/index.html
+	mv api/xxx api/api.html
+	mv api python-api
+
 
 # Housekeeping targets
 
-# Remove temporary files
+# Remove temporary files; all except the following:
+# - sources: .tex, .bib, .sty
+# - useful results: .dvi, .ps, .texi, .info
 clean:
 	rm -f @* *~ *.aux *.idx *.ilg *.ind *.log *.toc *.blg *.bbl *.pyc
 	rm -f *.bak *.orig
-	# Sources: .tex, .bib, .sty
-	# Useful results: .dvi, .ps, .texi, .info
 
 # Remove temporaries as well as final products
 clobber: clean