77# tut -- Tutorial (file tut.tex)
88# lib -- Library Reference (file lib.tex, inputs lib*.tex)
99# ext -- Extending and Embedding (file ext.tex)
10+ # api -- Python-C API Reference
1011#
1112# The Reference Manual is now maintained as a FrameMaker document.
1213# See the subdirectory ref; PostScript is included as ref/ref.ps.
1819# four. You can also do "make lib" (etc.) to process individual
1920# documents.
2021#
21- # There's also:
22- # qua -- Paper published in the CWI Quarterly (file qua.tex)
23- #
2422# There's one local style file: myformat.sty. This defines a number
2523# of macros that are similar in name and intent as macros in Texinfo
2624# (e.g. \code{...} and \emph{...}), as well as a number of
3129# latex
3230# makeindex
3331# dvips
34- # bibtex (only for formatting qua.tex)
3532#
3633# There's a problem with generating the index which has been solved by
3734# a sed command applied to the index file. The shell script fix_hack
4340# Additional targets attempt to convert selected LaTeX sources to
4441# various other formats. These are generally site specific because
4542# the tools used are all but universal. These targets are:
46- # l2h -- convert tut, lib, ext from LaTeX to HTML
43+ # l2h -- convert tut, lib, ext, api from LaTeX to HTML
4744# See the README file for more info on these targets.
4845
4946# Customizations -- you *may* have to edit these
@@ -67,19 +64,17 @@ DOCDESTDIR= $LIBDEST/doc
6764# Main target
6865all : all-ps
6966
70- all-dvi : tut.dvi lib.dvi ext.dvi
71- all-ps : tut.ps lib.ps ext.ps
67+ all-dvi : tut.dvi lib.dvi ext.dvi api.dvi
68+ all-ps : tut.ps lib.ps ext.ps api.ps
7269
7370# Individual document fake targets
7471tut : tut.ps
7572lib : lib.ps
7673ext : ext.ps
77-
78- # CWI Quarterly document fake target
79- qua : qua.ps
74+ api : api.ps
8075
8176# Dependencies
82- tut.dvi lib.dvi ext.dvi : myformat.sty fix_hack
77+ tut.dvi lib.dvi ext.dvi api.dvi : myformat.sty fix_hack
8378
8479# Tutorial document
8580tut.dvi : tut.tex
@@ -129,7 +124,7 @@ lib.ps: lib.dvi
129124 $(DVIPS ) lib > lib.ps
130125
131126# Extensions document
132- ext.dvi : ext.tex extref.tex
127+ ext.dvi : ext.tex
133128 touch ext.ind
134129 $(LATEX ) ext
135130 ./fix_hack ext.idx
@@ -139,15 +134,16 @@ ext.dvi: ext.tex extref.tex
139134ext.ps : ext.dvi
140135 $(DVIPS ) ext > ext.ps
141136
142- # Quarterly document
143- qua.dvi : qua.tex quabib.bib
144- $(LATEX ) qua
145- $(BIBTEX ) qua
146- $(LATEX ) qua
147- $(BIBTEX ) qua
137+ # Python-C API document
138+ api.dvi : api.tex
139+ touch api.ind
140+ $(LATEX ) api
141+ ./fix_hack api.idx
142+ $(MAKEINDEX ) api.idx
143+ $(LATEX ) api
148144
149- qua .ps : qua .dvi
150- $(DVIPS ) qua > qua .ps
145+ api .ps : api .dvi
146+ $(DVIPS ) api > api .ps
151147
152148
153149# The remaining part of the Makefile is concerned with various
@@ -168,7 +164,7 @@ qua.ps: qua.dvi
168164# of; the prominent location makes it worth the extra step. This affects the
169165# title pages!
170166
171- l2h : l2htut l2hext l2hlib
167+ l2h : l2htut l2hext l2hlib l2htut
172168
173169l2htut : tut.dvi myformat.perl
174170 $(L2H ) $(L2HARGS ) tut.tex
@@ -199,15 +195,24 @@ l2hlib: lib.dvi myformat.perl
199195 @rm -rf python-lib
200196 mv lib python-lib
201197
198+ l2hapi : api.dvi myformat.perl
199+ $(L2H ) $(L2HARGS ) api.tex
200+ @rm -rf python-api
201+ sed ' s/^<P CLASS=ABSTRACT>,/<P CLASS=ABSTRACT>/' \
202+ < api/api.html > api/xxx
203+ ln -s api.html api/index.html
204+ mv api/xxx api/api.html
205+ mv api python-api
206+
202207
203208# Housekeeping targets
204209
205- # Remove temporary files
210+ # Remove temporary files; all except the following:
211+ # - sources: .tex, .bib, .sty
212+ # - useful results: .dvi, .ps, .texi, .info
206213clean :
207214 rm -f @* * ~ * .aux * .idx * .ilg * .ind * .log * .toc * .blg * .bbl * .pyc
208215 rm -f * .bak * .orig
209- # Sources: .tex, .bib, .sty
210- # Useful results: .dvi, .ps, .texi, .info
211216
212217# Remove temporaries as well as final products
213218clobber : clean
0 commit comments