diff options
Diffstat (limited to 'Doc/Makefile')
| -rw-r--r-- | Doc/Makefile | 53 |
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 |