Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit 9231c8f

Browse files
committed
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 parent d0c87ee commit 9231c8f

9 files changed

Lines changed: 1800 additions & 2042 deletions

File tree

Doc/Makefile

Lines changed: 29 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@
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.
@@ -18,9 +19,6 @@
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
@@ -31,7 +29,6 @@
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
@@ -43,7 +40,7 @@
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
6865
all: 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
7471
tut: tut.ps
7572
lib: lib.ps
7673
ext: 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
8580
tut.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
139134
ext.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

173169
l2htut: 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
206213
clean:
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
213218
clobber: clean

0 commit comments

Comments
 (0)