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.
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 @@
# 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 @@
$(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.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 @@
# 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 @@
@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