blob: 9a819568379c6134f920cf1bf29317e76149f191 [file] [log] [blame]
Guido van Rossume83e3801995-03-17 16:01:35 +00001# Makefile for Python documentation
2# ---------------------------------
3#
Guido van Rossum73827c61995-03-20 13:00:32 +00004# See also the README file.
5#
Guido van Rossume83e3801995-03-17 16:01:35 +00006# This is a bit of a mess. The main documents are:
7# tut -- Tutorial (file tut.tex)
8# lib -- Library Reference (file lib.tex, inputs lib*.tex)
Guido van Rossume83e3801995-03-17 16:01:35 +00009# ext -- Extending and Embedding (file ext.tex)
Guido van Rossum9231c8f1997-05-15 21:43:21 +000010# api -- Python-C API Reference
Guido van Rossume83e3801995-03-17 16:01:35 +000011#
Guido van Rossum1f175431996-10-22 20:00:02 +000012# The Reference Manual is now maintained as a FrameMaker document.
13# See the subdirectory ref; PostScript is included as ref/ref.ps.
14# (In the future, the Tutorial will also be converted to FrameMaker;
15# the other documents will be maintained in a text format such
16# as LaTeX or perhaps TIM.)
17#
Guido van Rossume83e3801995-03-17 16:01:35 +000018# The main target "make all" creates DVI and PostScript for these
19# four. You can also do "make lib" (etc.) to process individual
20# documents.
21#
Guido van Rossume83e3801995-03-17 16:01:35 +000022# There's one local style file: myformat.sty. This defines a number
23# of macros that are similar in name and intent as macros in Texinfo
24# (e.g. \code{...} and \emph{...}), as well as a number of
25# environments for formatting function and data definitions, also in
26# the style of Texinfo.
27#
28# Everything is processed by LaTeX. The following tools are used:
29# latex
30# makeindex
31# dvips
Guido van Rossume83e3801995-03-17 16:01:35 +000032#
33# There's a problem with generating the index which has been solved by
34# a sed command applied to the index file. The shell script fix_hack
35# does this (the Makefile takes care of calling it).
36#
37# To preview the dvi files produced by LaTeX it would be useful to
38# have xdvi as well.
39#
40# Additional targets attempt to convert selected LaTeX sources to
41# various other formats. These are generally site specific because
42# the tools used are all but universal. These targets are:
Guido van Rossum9231c8f1997-05-15 21:43:21 +000043# l2h -- convert tut, lib, ext, api from LaTeX to HTML
Guido van Rossum73827c61995-03-20 13:00:32 +000044# See the README file for more info on these targets.
Guido van Rossume83e3801995-03-17 16:01:35 +000045
Guido van Rossum73827c61995-03-20 13:00:32 +000046# Customizations -- you *may* have to edit these
Guido van Rossume83e3801995-03-17 16:01:35 +000047
Guido van Rossum73827c61995-03-20 13:00:32 +000048# Where are the various programs?
49LATEX= latex
50BIBTEX= bibtex
Guido van Rossum73827c61995-03-20 13:00:32 +000051DVIPS= dvips -f
52MAKEINDEX= makeindex
Fred Drakef93f1011996-10-29 16:07:46 +000053L2H= latex2html
Fred Drakeb4d4e251996-11-11 21:03:01 +000054L2HARGS= -address $$USER@`domainname`
Guido van Rossum73827c61995-03-20 13:00:32 +000055
56# Install destination -- not used now but might be useful some time...
57DESTDIR= /usr/local
58LIBDESTDIR= $DESTDIR/lib
59LIBDEST= $LIBDESTDIR/python
60DOCDESTDIR= $LIBDEST/doc
61
62# Ideally, you shouldn't need to edit beyond this point
Guido van Rossum5b343731992-07-07 09:06:34 +000063
Guido van Rossume83e3801995-03-17 16:01:35 +000064# Main target
Guido van Rossumeb8d5031996-08-09 21:46:05 +000065all: all-ps
66
Guido van Rossum9231c8f1997-05-15 21:43:21 +000067all-dvi: tut.dvi lib.dvi ext.dvi api.dvi
68all-ps: tut.ps lib.ps ext.ps api.ps
Guido van Rossum20aca5a1991-01-25 13:29:04 +000069
Guido van Rossume83e3801995-03-17 16:01:35 +000070# Individual document fake targets
Guido van Rossumeb8d5031996-08-09 21:46:05 +000071tut: tut.ps
72lib: lib.ps
Guido van Rossumeb8d5031996-08-09 21:46:05 +000073ext: ext.ps
Guido van Rossum9231c8f1997-05-15 21:43:21 +000074api: api.ps
Guido van Rossume83e3801995-03-17 16:01:35 +000075
76# Dependencies
Guido van Rossum9231c8f1997-05-15 21:43:21 +000077tut.dvi lib.dvi ext.dvi api.dvi: myformat.sty fix_hack
Guido van Rossum16d6e711994-08-08 12:30:22 +000078
Guido van Rossume83e3801995-03-17 16:01:35 +000079# Tutorial document
Guido van Rossum16d6e711994-08-08 12:30:22 +000080tut.dvi: tut.tex
Guido van Rossum73827c61995-03-20 13:00:32 +000081 $(LATEX) tut
82 $(LATEX) tut
Guido van Rossumeb8d5031996-08-09 21:46:05 +000083
84tut.ps: tut.dvi
Guido van Rossum6938f061994-08-01 12:22:53 +000085 $(DVIPS) tut >tut.ps
Guido van Rossumb3fa13c1991-01-22 11:47:14 +000086
Guido van Rossum16d6e711994-08-08 12:30:22 +000087# LaTeX source files for the Python Library Reference
88LIBFILES = lib.tex \
Guido van Rossum40006cf1996-08-19 22:58:03 +000089 libintro.tex libobjs.tex libtypes.tex libexcs.tex libfuncs.tex \
90 libpython.tex libsys.tex libtypes2.tex libtraceback.tex libpickle.tex \
91 libshelve.tex libcopy.tex libmarshal.tex libimp.tex libparser.tex \
92 libbltin.tex libmain.tex libstrings.tex libstring.tex libregex.tex \
93 libregsub.tex libstruct.tex libmisc.tex libmath.tex librand.tex \
94 libwhrandom.tex libarray.tex liballos.tex libos.tex libtime.tex \
95 libgetopt.tex libtempfile.tex liberrno.tex libsomeos.tex libsignal.tex \
96 libsocket.tex libselect.tex libthread.tex libunix.tex libposix.tex \
97 libppath.tex libpwd.tex libgrp.tex libcrypt.tex libdbm.tex libgdbm.tex \
98 libtermios.tex libfcntl.tex libposixfile.tex libsyslog.tex libpdb.tex \
99 libprofile.tex libwww.tex libcgi.tex liburllib.tex libhttplib.tex \
100 libftplib.tex libgopherlib.tex libnntplib.tex liburlparse.tex \
101 libhtmllib.tex libsgmllib.tex librfc822.tex libmimetools.tex \
102 libbinascii.tex libmm.tex libaudioop.tex libimageop.tex libaifc.tex \
103 libjpeg.tex librgbimg.tex libcrypto.tex libmd5.tex libmpz.tex \
104 librotor.tex libmac.tex libctb.tex libmacconsole.tex libmacdnr.tex \
105 libmacfs.tex libmacos.tex libmacostools.tex libmactcp.tex \
106 libmacspeech.tex libmacui.tex libstdwin.tex libsgi.tex libal.tex \
107 libcd.tex libfl.tex libfm.tex libgl.tex libimgfile.tex libsun.tex \
Guido van Rossuma80c3981996-10-22 01:12:13 +0000108 libxdrlib.tex libimghdr.tex \
109 librestricted.tex librexec.tex libbastion.tex \
Guido van Rossum3dd68d31996-12-31 02:24:54 +0000110 libformatter.tex liboperator.tex libsoundex.tex libresource.tex \
Guido van Rossum7f3b0421997-03-27 14:56:18 +0000111 libstat.tex libstrio.tex libundoc.tex libmailcap.tex libglob.tex \
Guido van Rossume76b7a81997-04-27 21:25:52 +0000112 libuser.tex libanydbm.tex librandom.tex libsite.tex libwhichdb.tex \
Guido van Rossum41c302f1997-06-02 17:36:12 +0000113 libbase64.tex libfnmatch.tex libquopri.tex libzlib.tex libsocksvr.tex \
Fred Drake18600a41997-07-18 20:43:27 +0000114 libmailbox.tex libcommands.tex libcmath.tex libni.tex libgzip.tex \
Guido van Rossum61c27031997-07-18 21:08:07 +0000115 libpprint.tex libcode.tex
Guido van Rossum16d6e711994-08-08 12:30:22 +0000116
Guido van Rossume83e3801995-03-17 16:01:35 +0000117# Library document
Guido van Rossum16d6e711994-08-08 12:30:22 +0000118lib.dvi: $(LIBFILES)
Guido van Rossumb83241c1992-03-06 10:56:42 +0000119 touch lib.ind
Guido van Rossum73827c61995-03-20 13:00:32 +0000120 $(LATEX) lib
Guido van Rossum95cd2ef1992-12-08 14:37:55 +0000121 ./fix_hack lib.idx
Fred Drakeb4d4e251996-11-11 21:03:01 +0000122 $(MAKEINDEX) lib.idx
Guido van Rossum73827c61995-03-20 13:00:32 +0000123 $(LATEX) lib
Guido van Rossumeb8d5031996-08-09 21:46:05 +0000124
125lib.ps: lib.dvi
Guido van Rossum6938f061994-08-01 12:22:53 +0000126 $(DVIPS) lib >lib.ps
Guido van Rossuma52117e1991-11-21 13:54:36 +0000127
Guido van Rossume83e3801995-03-17 16:01:35 +0000128# Extensions document
Guido van Rossum9231c8f1997-05-15 21:43:21 +0000129ext.dvi: ext.tex
Guido van Rossum7a2dba21993-11-05 14:45:11 +0000130 touch ext.ind
Guido van Rossum73827c61995-03-20 13:00:32 +0000131 $(LATEX) ext
Guido van Rossum7a2dba21993-11-05 14:45:11 +0000132 ./fix_hack ext.idx
Fred Drakeb4d4e251996-11-11 21:03:01 +0000133 $(MAKEINDEX) ext.idx
Guido van Rossum73827c61995-03-20 13:00:32 +0000134 $(LATEX) ext
Guido van Rossumeb8d5031996-08-09 21:46:05 +0000135
136ext.ps: ext.dvi
Guido van Rossum6938f061994-08-01 12:22:53 +0000137 $(DVIPS) ext >ext.ps
Guido van Rossum7a2dba21993-11-05 14:45:11 +0000138
Guido van Rossum9231c8f1997-05-15 21:43:21 +0000139# Python-C API document
140api.dvi: api.tex
141 touch api.ind
142 $(LATEX) api
143 ./fix_hack api.idx
144 $(MAKEINDEX) api.idx
145 $(LATEX) api
Guido van Rossumeb8d5031996-08-09 21:46:05 +0000146
Guido van Rossum9231c8f1997-05-15 21:43:21 +0000147api.ps: api.dvi
148 $(DVIPS) api >api.ps
Guido van Rossumb3fa13c1991-01-22 11:47:14 +0000149
Guido van Rossume83e3801995-03-17 16:01:35 +0000150
151# The remaining part of the Makefile is concerned with various
Guido van Rossum73827c61995-03-20 13:00:32 +0000152# conversions, as described above. See also the README file.
Guido van Rossume83e3801995-03-17 16:01:35 +0000153
Guido van Rossum73827c61995-03-20 13:00:32 +0000154# Targets to convert the manuals to HTML using Nikos Drakos' LaTeX to
155# HTML converter. For more info on this program, see
Guido van Rossume83e3801995-03-17 16:01:35 +0000156# <URL:http://cbl.leeds.ac.uk/nikos/tex2html/doc/latex2html/latex2html.html>.
Guido van Rossume83e3801995-03-17 16:01:35 +0000157
Fred Drakeb4d4e251996-11-11 21:03:01 +0000158# Note that LaTeX2HTML inserts references to an "icons" directory in
159# each page that it generates. You can customize where these icons
160# are to be found; I generally make it point to "../icons" and then
161# create a symbolic link to the icons directory in the LaTeX2HTML
162# source at the appropriate place. Change the definition of
163# $ICONSERVER in .latex2html-init to point to a different location.
Guido van Rossume83e3801995-03-17 16:01:35 +0000164
Fred Drakefc8f6f31996-12-06 18:45:30 +0000165# The sed hack rips out a superfluous comma which I haven't found the source
166# of; the prominent location makes it worth the extra step. This affects the
167# title pages!
168
Fred Drakebc0cd371997-07-30 15:59:25 +0000169l2h: l2htut l2hext l2hlib l2hapi
Guido van Rossum6938f061994-08-01 12:22:53 +0000170
Fred Drakeb4d4e251996-11-11 21:03:01 +0000171l2htut: tut.dvi myformat.perl
Guido van Rossum6938f061994-08-01 12:22:53 +0000172 $(L2H) $(L2HARGS) tut.tex
173 @rm -rf python-tut
Fred Drakefc8f6f31996-12-06 18:45:30 +0000174 sed 's/^<P CLASS=ABSTRACT>,/<P CLASS=ABSTRACT>/' \
175 <tut/tut.html >tut/xxx
176 mv tut/xxx tut/tut.html
Fred Draked5606051996-12-06 20:06:37 +0000177 ln -s tut.html tut/index.html
Guido van Rossum6938f061994-08-01 12:22:53 +0000178 mv tut python-tut
179
Fred Drakeb4d4e251996-11-11 21:03:01 +0000180l2hext: ext.dvi myformat.perl
Guido van Rossum6938f061994-08-01 12:22:53 +0000181 $(L2H) $(L2HARGS) ext.tex
182 @rm -rf python-ext
Fred Drakefc8f6f31996-12-06 18:45:30 +0000183 sed 's/^<P CLASS=ABSTRACT>,/<P CLASS=ABSTRACT>/' \
184 <ext/ext.html >ext/xxx
Fred Draked5606051996-12-06 20:06:37 +0000185 ln -s ext.html ext/index.html
Fred Drakefc8f6f31996-12-06 18:45:30 +0000186 mv ext/xxx ext/ext.html
Guido van Rossum6938f061994-08-01 12:22:53 +0000187 mv ext python-ext
Guido van Rossum970871f1993-02-21 20:10:26 +0000188
Fred Drakeb4d4e251996-11-11 21:03:01 +0000189l2hlib: lib.dvi myformat.perl
190 ./fix_libaux.sed <lib.aux >@lib.aux
191 mv @lib.aux lib.aux
Guido van Rossume83e3801995-03-17 16:01:35 +0000192 $(L2H) $(L2HARGS) lib.tex
Fred Drakef1e67071996-12-06 15:11:34 +0000193 sed 's/^<P CLASS=ABSTRACT>,/<P CLASS=ABSTRACT>/' \
194 <lib/lib.html >lib/xxx
195 mv lib/xxx lib/lib.html
Fred Draked5606051996-12-06 20:06:37 +0000196 ln -s lib.html lib/index.html
Guido van Rossume83e3801995-03-17 16:01:35 +0000197 @rm -rf python-lib
198 mv lib python-lib
199
Guido van Rossum9231c8f1997-05-15 21:43:21 +0000200l2hapi: api.dvi myformat.perl
201 $(L2H) $(L2HARGS) api.tex
202 @rm -rf python-api
203 sed 's/^<P CLASS=ABSTRACT>,/<P CLASS=ABSTRACT>/' \
204 <api/api.html >api/xxx
205 ln -s api.html api/index.html
206 mv api/xxx api/api.html
207 mv api python-api
208
Guido van Rossume83e3801995-03-17 16:01:35 +0000209
210# Housekeeping targets
211
Guido van Rossum9231c8f1997-05-15 21:43:21 +0000212# Remove temporary files; all except the following:
213# - sources: .tex, .bib, .sty
214# - useful results: .dvi, .ps, .texi, .info
Guido van Rossum7f777ed1990-08-09 14:25:15 +0000215clean:
Guido van Rossum4ac605e1992-12-17 15:31:02 +0000216 rm -f @* *~ *.aux *.idx *.ilg *.ind *.log *.toc *.blg *.bbl *.pyc
Guido van Rossume83e3801995-03-17 16:01:35 +0000217 rm -f *.bak *.orig
Guido van Rossum5b343731992-07-07 09:06:34 +0000218
Guido van Rossume83e3801995-03-17 16:01:35 +0000219# Remove temporaries as well as final products
Guido van Rossum5b343731992-07-07 09:06:34 +0000220clobber: clean
Guido van Rossum7a2dba21993-11-05 14:45:11 +0000221 rm -f *.dvi *.ps *.texi *.info *.info-[0-9]*