Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / cpython3 / efc17bd96820c513007a63f5a014a40048027837 / . / Doc / Makefile
blob: c4043bf746bba0578bc86a5525fe463c2dc12241 [file] [log] [blame]
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]1# Makefile for Python documentation
2# ---------------------------------
3#
Guido van Rossum73827c61995-03-20 13:00:32 +0000[diff] [blame]4# See also the README file.
5#
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]6# This is a bit of a mess. The main documents are:
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]7# api -- Python/C API Reference Manual
8# ext -- Extending and Embedding the Python Interpreter
9# lib -- Library Reference Manual
Fred Drake34116ba1998-07-24 15:42:12 +0000[diff] [blame]10# mac -- Macintosh Library Modules
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]11# ref -- Python Reference Manual
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]12# tut -- Python Tutorial
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]13#
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]14# The latex sources for each of these documents are in subdirectories
15# with the three-letter designations above as the directory names.
Guido van Rossum1f175431996-10-22 20:00:02 +0000[diff] [blame]16#
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]17# The main target creates DVI and PostScript for the main each of the
Fred Drakeefc17bd1998-07-28 21:05:16 +0000[diff] [blame^]18# documents. You can also do "make lib" (etc.) to create the DVI and
19# PostScript versions of individual documents.
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]20#
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]21# The document classes and styles are in the texinputs/ directory.
22# These define a number of macros that are similar in name and intent
23# as macros in Texinfo (e.g. \code{...} and \emph{...}), as well as a
Fred Drakeefc17bd1998-07-28 21:05:16 +0000[diff] [blame^]24# number of environments for formatting function and data definitions.
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]25#
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]26# Everything is processed by LaTeX. See the file `README' for more
27# information on the tools needed for processing.
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]28#
29# There's a problem with generating the index which has been solved by
30# a sed command applied to the index file. The shell script fix_hack
31# does this (the Makefile takes care of calling it).
32#
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]33# Additional targets attempt to convert selected LaTeX sources to
34# various other formats. These are generally site specific because
35# the tools used are all but universal. These targets are:
Fred Drake34116ba1998-07-24 15:42:12 +0000[diff] [blame]36#
37# html -- convert all documents from LaTeX to HTML
Fred Drakeefc17bd1998-07-28 21:05:16 +0000[diff] [blame^]38# pdf -- convert all documents from LaTeX to the
39# Portable Document Format
Fred Drake34116ba1998-07-24 15:42:12 +0000[diff] [blame]40#
Fred Drakeefc17bd1998-07-28 21:05:16 +0000[diff] [blame^]41# See the README file for more information on these targets.
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]42#
43# The formatted output is located in subdirectories. For PDF and
44# PostScript, look in the paper-$(PAPER)/ directory. For HTML, look in
Fred Drake34116ba1998-07-24 15:42:12 +0000[diff] [blame]45# the html/ directory. If you want to fix the GNU info process, look
46# in the info/ directory.
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]47
Guido van Rossum73827c61995-03-20 13:00:32 +0000[diff] [blame]48# Customizations -- you *may* have to edit these
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]49
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]50# you could set this to a4
51PAPER=letter
52
Guido van Rossum73827c61995-03-20 13:00:32 +0000[diff] [blame]53# Where are the various programs?
Fred Drake9cdf0871998-05-07 15:03:25 +0000[diff] [blame]54LATEX= latex
55PDFLATEX= pdflatex
Fred Drake9fab3aa1998-04-28 19:20:43 +0000[diff] [blame]56DVIPS= dvips -N0
Fred Drakedf68e3d1998-05-08 03:46:38 +0000[diff] [blame]57KPSEWHICH= TEXINPUTS=$(TEXINPUTS) kpsewhich tex
Fred Drake3af9f251998-04-24 21:07:22 +0000[diff] [blame]58MAKEINDEX= makeindex -s $(srcdir)/texinputs/myindex.ist
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]59ACROREAD= acroread
Fred Drake0d27d081998-04-23 20:07:55 +0000[diff] [blame]60L2HARGS=
Fred Drakeb9838d91998-05-08 15:43:08 +0000[diff] [blame]61# HTMLDIR should not be '.'!
62HTMLDIR= html
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]63PYTHON= python
Fred Drake3af9f251998-04-24 21:07:22 +0000[diff] [blame]64WEBCHECKER= $(PYTHON) $(srcdir)/../Tools/webchecker/webchecker.py
Guido van Rossum73827c61995-03-20 13:00:32 +0000[diff] [blame]65
66# Install destination -- not used now but might be useful some time...
67DESTDIR= /usr/local
68LIBDESTDIR= $DESTDIR/lib
Fred Drakee4837a11998-03-06 21:29:34 +0000[diff] [blame]69LIBDEST= $LIBDESTDIR/python$(VERSION)
Guido van Rossum73827c61995-03-20 13:00:32 +0000[diff] [blame]70DOCDESTDIR= $LIBDEST/doc
71
Fred Drakeb9838d91998-05-08 15:43:08 +0000[diff] [blame]72INFODIR= info
Fred Drake3af9f251998-04-24 21:07:22 +0000[diff] [blame]73
74srcdir=.
75VPATH=.
Fred Drake05dd3c01997-12-29 17:17:54 +0000[diff] [blame]76
Guido van Rossum73827c61995-03-20 13:00:32 +0000[diff] [blame]77# Ideally, you shouldn't need to edit beyond this point
Guido van Rossum5b343731992-07-07 09:06:34 +0000[diff] [blame]78
Fred Drakef5013f11998-04-13 21:02:49 +0000[diff] [blame]79RELEASE=1.5.1
Fred Drake33d05b91998-01-13 16:33:09 +0000[diff] [blame]80VERSION=1.5
81
Fred Drake3f8a59f1998-07-24 13:58:27 +0000[diff] [blame]82MANDVIFILES= api.dvi ext.dvi lib.dvi ref.dvi tut.dvi
83HOWTODVIFILES= mac.dvi
84
85MANPDFFILES= api.pdf ext.pdf lib.pdf ref.pdf tut.pdf
86HOWTOPDFFILES= mac.pdf
87
88MANPSFILES= api.ps ext.ps lib.ps ref.ps tut.ps
89HOWTOPSFILES= mac.ps
90
91DVIFILES= $(MANDVIFILES) $(HOWTODVIFILES)
92PDFFILES= $(MANPDFFILES) $(HOWTOPDFFILES)
93PSFILES= $(MANPSFILES) $(HOWTOPSFILES)
Fred Drake04cf4dc1998-02-12 22:33:50 +0000[diff] [blame]94
Fred Drakebbe33c51998-05-07 01:39:06 +0000[diff] [blame]95# Be careful when messing with this one!
Fred Drakeb9838d91998-05-08 15:43:08 +0000[diff] [blame]96TEXINPUTS= .:../texinputs:
Fred Drakebbe33c51998-05-07 01:39:06 +0000[diff] [blame]97
98MKDVI= TEXINPUTS=$(TEXINPUTS) $(srcdir)/tools/mkdvi.sh
Fred Drakecdbd3911998-05-15 17:02:10 +0000[diff] [blame]99MKHOWTO= $(srcdir)/tools/mkhowto.sh --keep
100MKHTML= PAPER=$(PAPER) $(srcdir)/tools/mkhtml.sh
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]101MKPDF= TEXINPUTS=$(TEXINPUTS) $(srcdir)/tools/mkdvi.sh --pdf
Fred Drakebbe33c51998-05-07 01:39:06 +0000[diff] [blame]102
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]103# Main target
Fred Drake34116ba1998-07-24 15:42:12 +0000[diff] [blame]104all: ps
Guido van Rossumeb8d5031996-08-09 21:46:05 +0000[diff] [blame]105
Fred Drake34116ba1998-07-24 15:42:12 +0000[diff] [blame]106dvi:
Fred Drakeb9838d91998-05-08 15:43:08 +0000[diff] [blame]107 (cd paper-$(PAPER); \
108 $(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \
109 -f ../Makefile do-dvi)
Fred Drakee4837a11998-03-06 21:29:34 +0000[diff] [blame]110
Fred Drake34116ba1998-07-24 15:42:12 +0000[diff] [blame]111pdf:
Fred Drakeb9838d91998-05-08 15:43:08 +0000[diff] [blame]112 (cd paper-$(PAPER); \
113 $(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \
114 -f ../Makefile do-pdf)
Guido van Rossum20aca5a1991-01-25 13:29:04 +0000[diff] [blame]115
Fred Drake34116ba1998-07-24 15:42:12 +0000[diff] [blame]116ps:
Fred Drakeb9838d91998-05-08 15:43:08 +0000[diff] [blame]117 (cd paper-$(PAPER); \
118 $(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \
119 -f ../Makefile do-ps)
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]120
Fred Drake34116ba1998-07-24 15:42:12 +0000[diff] [blame]121world: ps pdf html tarballs
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]122
123
124# Targets for each document:
Fred Drake3f8a59f1998-07-24 13:58:27 +0000[diff] [blame]125.PHONY: api ext lib mac ref tut
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]126
127api:
128 (cd paper-$(PAPER); \
129 $(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \
130 -f ../Makefile api.ps)
131
132ext:
133 (cd paper-$(PAPER); \
134 $(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \
135 -f ../Makefile ext.ps)
136
137lib:
138 (cd paper-$(PAPER); \
139 $(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \
140 -f ../Makefile lib.ps)
141
Fred Drake3f8a59f1998-07-24 13:58:27 +0000[diff] [blame]142mac:
143 (cd paper-$(PAPER); \
144 $(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \
145 -f ../Makefile mac.ps)
146
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]147ref:
148 (cd paper-$(PAPER); \
149 $(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \
150 -f ../Makefile ref.ps)
151
152tut:
153 (cd paper-$(PAPER); \
154 $(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \
155 -f ../Makefile tut.ps)
156
157
158# Internal targets:
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]159
160do-dvi: $(DVIFILES)
161do-pdf: $(PDFFILES)
Fred Drakecdbd3911998-05-15 17:02:10 +0000[diff] [blame]162do-ps: $(PSFILES)
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]163
164# This target gets both the PDF and PS files updated.
Fred Drakeddae4141998-02-17 15:45:25 +0000[diff] [blame]165#
166all-formats: $(PSFILES) $(PDFFILES)
167
Fred Drakedd946761998-02-18 16:02:14 +0000[diff] [blame]168
Fred Drake126d8401998-02-04 19:54:40 +0000[diff] [blame]169# Rules to build PostScript and PDF formats
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]170.SUFFIXES: .dvi .ps .pdf
Fred Drake126d8401998-02-04 19:54:40 +0000[diff] [blame]171
172.dvi.ps:
Fred Drake9fab3aa1998-04-28 19:20:43 +0000[diff] [blame]173 $(DVIPS) -o $@ $<
Fred Drake126d8401998-02-04 19:54:40 +0000[diff] [blame]174
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]175#.pdf.ps:
176# $(ACROREAD) -toPostScript $<
Fred Drake126d8401998-02-04 19:54:40 +0000[diff] [blame]177
Fred Drake3b26eed1998-02-16 17:06:10 +0000[diff] [blame]178
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]179# Dependencies
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]180# We really need some support of dependency generator for this...
181
Fred Drake3f8a59f1998-07-24 13:58:27 +0000[diff] [blame]182COMMONSTYLES=texinputs/python.sty texinputs/pypaper.sty texinputs/myindex.ist
183COMMONTEX=texinputs/copyright.tex texinputs/boilerplate.tex
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]184
Fred Drake3f8a59f1998-07-24 13:58:27 +0000[diff] [blame]185MANSTYLES=texinputs/fncychap.sty texinputs/manual.cls $(COMMONSTYLES)
186HOWTOSTYLES=texinputs/howto.cls $(COMMONSTYLES)
Fred Drake5d8f0ed1998-02-11 14:43:38 +0000[diff] [blame]187
Fred Drake3f8a59f1998-07-24 13:58:27 +0000[diff] [blame]188
189$(DVIFILES): tools/fix_hack tools/mkdvi.sh $(COMMONTEX)
190$(PDFFILES): tools/fix_hack tools/mkdvi.sh $(COMMONTEX)
191
192$(MANDVIFILES): $(MANSTYLES)
193$(MANPDFFILES): $(MANSTYLES)
194
195$(HOWTODVIFILES): tools/mkhowto.sh $(HOWTOSTYLES)
196$(HOWTOPDFFILES): tools/mkhowto.sh $(HOWTOSTYLES)
197
Guido van Rossumeb8d5031996-08-09 21:46:05 +0000[diff] [blame]198
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]199REFFILES = ref/ref1.tex ref/ref2.tex ref/ref3.tex ref/ref4.tex \
Fred Drakeefc17bd1998-07-28 21:05:16 +0000[diff] [blame^]200 ref/ref5.tex ref/ref6.tex ref/ref7.tex ref/ref8.tex \
201 ref/ref.tex
Fred Drakea6bb3961998-05-06 19:51:39 +0000[diff] [blame]202
Guido van Rossum16d6e711994-08-08 12:30:22 +0000[diff] [blame]203# LaTeX source files for the Python Library Reference
Fred Drake9cdf0871998-05-07 15:03:25 +0000[diff] [blame]204LIBFILES = lib/lib.tex \
Fred Drake3f8a59f1998-07-24 13:58:27 +0000[diff] [blame]205 lib/libintro.tex lib/libobjs.tex lib/libstdtypes.tex lib/libexcs.tex \
206 lib/libfuncs.tex lib/libpython.tex lib/libsys.tex lib/libtypes.tex \
Fred Drake9cdf0871998-05-07 15:03:25 +0000[diff] [blame]207 lib/libtraceback.tex lib/libpickle.tex lib/libshelve.tex \
208 lib/libcopy.tex lib/libmarshal.tex lib/libimp.tex lib/libparser.tex \
209 lib/libbltin.tex lib/libmain.tex lib/libstrings.tex lib/libstring.tex \
210 lib/libregex.tex lib/libregsub.tex lib/libstruct.tex lib/libmisc.tex \
211 lib/libmath.tex lib/librand.tex lib/libwhrandom.tex lib/libarray.tex \
212 lib/liballos.tex lib/libos.tex lib/libtime.tex lib/libgetopt.tex \
213 lib/libtempfile.tex lib/liberrno.tex lib/libsomeos.tex lib/libsignal.tex \
214 lib/libsocket.tex lib/libselect.tex lib/libthread.tex lib/libunix.tex \
Fred Drake3f8a59f1998-07-24 13:58:27 +0000[diff] [blame]215 lib/libposix.tex lib/libposixpath.tex lib/libpwd.tex lib/libgrp.tex \
Fred Drake9cdf0871998-05-07 15:03:25 +0000[diff] [blame]216 lib/libcrypt.tex lib/libdbm.tex lib/libgdbm.tex lib/libtermios.tex \
217 lib/libfcntl.tex lib/libposixfile.tex lib/libsyslog.tex lib/libpdb.tex \
218 lib/libprofile.tex lib/libwww.tex lib/libcgi.tex lib/liburllib.tex \
219 lib/libhttplib.tex lib/libftplib.tex lib/libgopherlib.tex \
220 lib/libnntplib.tex lib/liburlparse.tex lib/libhtmllib.tex \
221 lib/libsgmllib.tex lib/librfc822.tex lib/libmimetools.tex \
222 lib/libbinascii.tex lib/libmm.tex lib/libaudioop.tex lib/libimageop.tex \
223 lib/libaifc.tex lib/libjpeg.tex lib/librgbimg.tex lib/libcrypto.tex \
224 lib/libmd5.tex lib/libmpz.tex lib/librotor.tex lib/libstdwin.tex \
225 lib/libsgi.tex lib/libal.tex lib/libcd.tex lib/libfl.tex lib/libfm.tex \
226 lib/libgl.tex lib/libimgfile.tex lib/libsun.tex lib/libxdrlib.tex \
227 lib/libimghdr.tex lib/librestricted.tex lib/librexec.tex \
228 lib/libbastion.tex lib/libformatter.tex lib/liboperator.tex \
Fred Drake3f8a59f1998-07-24 13:58:27 +0000[diff] [blame]229 lib/libsoundex.tex lib/libresource.tex lib/libstat.tex \
230 lib/libstringio.tex lib/libtoken.tex \
Fred Drake9cdf0871998-05-07 15:03:25 +0000[diff] [blame]231 lib/libundoc.tex lib/libmailcap.tex lib/libglob.tex lib/libuser.tex \
232 lib/libanydbm.tex lib/librandom.tex lib/libsite.tex lib/libwhichdb.tex \
233 lib/libbase64.tex lib/libfnmatch.tex lib/libquopri.tex lib/libzlib.tex \
234 lib/libsocksvr.tex lib/libmailbox.tex lib/libcommands.tex \
235 lib/libcmath.tex lib/libgzip.tex lib/libpprint.tex \
236 lib/libcode.tex lib/libmimify.tex lib/libre.tex lib/libuserdict.tex \
237 lib/libdis.tex lib/libxmllib.tex lib/libqueue.tex lib/liblocale.tex \
Fred Drake3f8a59f1998-07-24 13:58:27 +0000[diff] [blame]238 lib/libbasehttp.tex lib/libcopyreg.tex lib/libsymbol.tex \
Fred Drake9cdf0871998-05-07 15:03:25 +0000[diff] [blame]239 lib/libbinhex.tex lib/libuu.tex \
240 lib/libsunaudio.tex lib/libfileinput.tex lib/libimaplib.tex \
Fred Drakeedde1501998-05-19 15:04:21 +0000[diff] [blame]241 lib/libpoplib.tex lib/libcalendar.tex lib/libpopen2.tex \
Guido van Rossumf78a52c1998-06-28 17:57:05 +0000[diff] [blame]242 lib/libbisect.tex lib/libmimetypes.tex lib/libsmtplib.tex lib/libcmd.tex \
Fred Drakea9f445c1998-07-20 14:01:20 +0000[diff] [blame]243 lib/libmultifile.tex lib/libthreading.tex
Guido van Rossum16d6e711994-08-08 12:30:22 +0000[diff] [blame]244
Fred Drake9cdf0871998-05-07 15:03:25 +0000[diff] [blame]245# LaTeX source files for Macintosh Library Modules.
246MACLIBFILES = mac/mac.tex mac/libmac.tex mac/libctb.tex mac/libmacconsole.tex \
247 mac/libmacdnr.tex mac/libmacfs.tex mac/libmacos.tex mac/libmacostools.tex \
248 mac/libmactcp.tex mac/libmacspeech.tex mac/libmacui.tex mac/libmacic.tex \
249 mac/libframework.tex mac/libminiae.tex
Fred Drakebdbdb801998-04-17 14:01:44 +0000[diff] [blame]250
Fred Drakebbe33c51998-05-07 01:39:06 +0000[diff] [blame]251# Python Library Reference
Fred Drake520f8bd1998-03-09 16:43:54 +0000[diff] [blame]252lib.dvi: tools/indfix.py $(LIBFILES)
Fred Drake3af9f251998-04-24 21:07:22 +0000[diff] [blame]253 $(srcdir)/tools/newind.py >$*.ind
254 $(srcdir)/tools/newind.py modindex >mod$*.ind
Fred Drake9cdf0871998-05-07 15:03:25 +0000[diff] [blame]255 TEXINPUTS=$(srcdir)/lib:$(TEXINPUTS) $(LATEX) $*
Fred Drake8bc96571998-03-09 16:37:52 +0000[diff] [blame]256 $(MAKEINDEX) mod$*.idx
Fred Drake3af9f251998-04-24 21:07:22 +0000[diff] [blame]257 $(srcdir)/tools/fix_hack $*.idx
Fred Drake5ad78f31998-02-22 19:47:13 +0000[diff] [blame]258 $(MAKEINDEX) $*.idx
Fred Drake3af9f251998-04-24 21:07:22 +0000[diff] [blame]259 $(srcdir)/tools/indfix.py $*.ind
Fred Drake9cdf0871998-05-07 15:03:25 +0000[diff] [blame]260 TEXINPUTS=$(srcdir)/lib:$(TEXINPUTS) $(LATEX) $*
Guido van Rossumeb8d5031996-08-09 21:46:05 +0000[diff] [blame]261
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]262lib.pdf: tools/indfix.py $(LIBFILES)
263 $(srcdir)/tools/newind.py >$*.ind
264 $(srcdir)/tools/newind.py modindex >mod$*.ind
265 TEXINPUTS=$(srcdir)/lib:$(TEXINPUTS) $(PDFLATEX) $*
266 $(MAKEINDEX) mod$*.idx
267 $(srcdir)/tools/fix_hack $*.idx
268 $(MAKEINDEX) $*.idx
269 $(srcdir)/tools/indfix.py $*.ind
Fred Drake34116ba1998-07-24 15:42:12 +0000[diff] [blame]270 $(srcdir)/tools/toc2bkm.py $*
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]271 TEXINPUTS=$(srcdir)/lib:$(TEXINPUTS) $(PDFLATEX) $*
272
Fred Drakebbe33c51998-05-07 01:39:06 +0000[diff] [blame]273# Python/C API Reference Manual
274api.dvi: api/api.tex
275 $(MKDVI) api
Guido van Rossumeb8d5031996-08-09 21:46:05 +0000[diff] [blame]276
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]277api.pdf: api/api.tex
278 $(MKPDF) api
279
Fred Drakebbe33c51998-05-07 01:39:06 +0000[diff] [blame]280# Extending and Embedding the Python Interpreter
281ext.dvi: ext/ext.tex
282 $(MKDVI) ext
283
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]284ext.pdf: ext/ext.tex
285 $(MKPDF) ext
286
Fred Drakecdbd3911998-05-15 17:02:10 +0000[diff] [blame]287# Macintosh Library Modules
Fred Drake3f8a59f1998-07-24 13:58:27 +0000[diff] [blame]288mac.dvi: $(MACLIBFILES)
Fred Drakecdbd3911998-05-15 17:02:10 +0000[diff] [blame]289 $(MKHOWTO) --dvi $(srcdir)/$*/$*.tex
290
Fred Drake3f8a59f1998-07-24 13:58:27 +0000[diff] [blame]291mac.pdf: $(MACLIBFILES)
Fred Drakecdbd3911998-05-15 17:02:10 +0000[diff] [blame]292 $(MKHOWTO) --pdf $(srcdir)/$*/$*.tex
293
Fred Drakebbe33c51998-05-07 01:39:06 +0000[diff] [blame]294# Python Reference Manual
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]295ref.dvi: $(REFFILES)
Fred Drakebbe33c51998-05-07 01:39:06 +0000[diff] [blame]296 $(MKDVI) ref
297
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]298ref.pdf: $(REFFILES)
299 $(MKPDF) ref
300
Fred Drakebbe33c51998-05-07 01:39:06 +0000[diff] [blame]301# Python Tutorial
302tut.dvi: tut/tut.tex
303 $(MKDVI) tut
Guido van Rossumeb8d5031996-08-09 21:46:05 +0000[diff] [blame]304
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]305tut.pdf: tut/tut.tex
306 $(MKPDF) tut
307
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]308
309# The remaining part of the Makefile is concerned with various
Guido van Rossum73827c61995-03-20 13:00:32 +0000[diff] [blame]310# conversions, as described above. See also the README file.
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]311
Fred Drake6f5bf8d1998-07-27 19:12:58 +0000[diff] [blame]312.PHONY: html l2h info
Fred Drake05dd3c01997-12-29 17:17:54 +0000[diff] [blame]313
Fred Drakeb9838d91998-05-08 15:43:08 +0000[diff] [blame]314info:
315 (cd $(INFODIR); $(MAKE))
Fred Drake5ad78f31998-02-22 19:47:13 +0000[diff] [blame]316
Guido van Rossum73827c61995-03-20 13:00:32 +0000[diff] [blame]317# Targets to convert the manuals to HTML using Nikos Drakos' LaTeX to
318# HTML converter. For more info on this program, see
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]319# <URL:http://cbl.leeds.ac.uk/nikos/tex2html/doc/latex2html/latex2html.html>.
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]320
Guido van Rossum9cb64801997-12-29 20:01:55 +0000[diff] [blame]321# Note that LaTeX2HTML inserts references to an icons directory in
322# each page that it generates. I have placed a copy of this directory
323# in the distribution to simplify the process of creating a
324# self-contained HTML distribution; for this purpose I have also added
325# a (trivial) index.html. Change the definition of $ICONSERVER in
Fred Drake9fab3aa1998-04-28 19:20:43 +0000[diff] [blame]326# perl/l2hinit.perl to use a different location for the icons directory.
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]327
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]328COMMONPERL=perl/manual.perl perl/python.perl
Fred Drakebbe33c51998-05-07 01:39:06 +0000[diff] [blame]329
Fred Drake34116ba1998-07-24 15:42:12 +0000[diff] [blame]330l2h html:
Fred Drakee593b621998-05-15 17:50:32 +0000[diff] [blame]331 (cd $(HTMLDIR); $(MAKE) TEXINPUTS=../paper-$(PAPER):../texinputs: \
332 -f ../html/Makefile)
Guido van Rossum6938f061994-08-01 12:22:53 +0000[diff] [blame]333
Fred Drake9cdf0871998-05-07 15:03:25 +0000[diff] [blame]334l2hapi: $(COMMONPERL)
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]335 $(MKHTML) api $(L2HARGS)
Guido van Rossum6938f061994-08-01 12:22:53 +0000[diff] [blame]336
Fred Drake9cdf0871998-05-07 15:03:25 +0000[diff] [blame]337l2hext: $(COMMONPERL)
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]338 $(MKHTML) ext $(L2HARGS)
Guido van Rossum970871f1993-02-21 20:10:26 +0000[diff] [blame]339
Fred Drakecdbd3911998-05-15 17:02:10 +0000[diff] [blame]340l2hlib: $(COMMONPERL) $(LIBFILES)
Fred Drake9fab3aa1998-04-28 19:20:43 +0000[diff] [blame]341 $(srcdir)/tools/fix_libaux.sed <`$(KPSEWHICH) lib.aux` >lib1.aux
342 mv lib1.aux `$(KPSEWHICH) lib.aux`
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]343 $(MKHTML) lib $(L2HARGS)
Fred Drakea6bb3961998-05-06 19:51:39 +0000[diff] [blame]344
Fred Drakecdbd3911998-05-15 17:02:10 +0000[diff] [blame]345l2hmac: $(COMMONPERL) $(MACLIBFILES)
346 $(srcdir)/tools/mkhowto.sh --html $(srcdir)/mac/mac.tex
347
Fred Drake9cdf0871998-05-07 15:03:25 +0000[diff] [blame]348l2href: $(COMMONPERL)
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]349 $(MKHTML) ref $(L2HARGS)
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]350
Fred Drake9cdf0871998-05-07 15:03:25 +0000[diff] [blame]351l2htut: $(COMMONPERL)
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]352 $(MKHTML) tut $(L2HARGS)
Guido van Rossum9231c8f1997-05-15 21:43:21 +0000[diff] [blame]353
Fred Drakee4837a11998-03-06 21:29:34 +0000[diff] [blame]354# webchecker needs an extra flag to process the huge index from the libref
355webcheck:
Fred Drake79c0f0e1998-05-19 18:04:13 +0000[diff] [blame]356 $(WEBCHECKER) file:`pwd`/$(HTMLDIR)/api/
357 $(WEBCHECKER) file:`pwd`/$(HTMLDIR)/ext/
358 $(WEBCHECKER) -m290000 file:`pwd`/$(HTMLDIR)/lib/
359 $(WEBCHECKER) file:`pwd`/$(HTMLDIR)/mac/
360 $(WEBCHECKER) file:`pwd`/$(HTMLDIR)/ref/
361 $(WEBCHECKER) file:`pwd`/$(HTMLDIR)/tut/
Fred Drakee4837a11998-03-06 21:29:34 +0000[diff] [blame]362
Fred Drakee34ab301998-05-11 21:10:15 +0000[diff] [blame]363lib-info-$(RELEASE).tgz: info
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]364 (cd $(INFODIR); tar cf - python-???.info*) | gzip -9 >$@
Fred Drakea7998351998-02-19 16:01:04 +0000[diff] [blame]365
Fred Drakee34ab301998-05-11 21:10:15 +0000[diff] [blame]366latex-$(RELEASE).tgz:
Fred Drake29cabd41998-05-11 18:53:07 +0000[diff] [blame]367 $(srcdir)/tools/mktarball.sh $(RELEASE)
Fred Drakee61d7af1998-03-05 16:37:34 +0000[diff] [blame]368
Fred Drakee34ab301998-05-11 21:10:15 +0000[diff] [blame]369pdf-$(PAPER)-$(RELEASE).tgz: all-pdf
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]370 (cd paper-$(PAPER); tar cf - $(PDFFILES)) | gzip -9 >$@
Fred Drake04cf4dc1998-02-12 22:33:50 +0000[diff] [blame]371
Fred Drakee34ab301998-05-11 21:10:15 +0000[diff] [blame]372postscript-$(PAPER)-$(RELEASE).tgz: all-ps
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]373 (cd paper-$(PAPER); tar cf - $(PSFILES)) | gzip -9 >$@
Fred Drake04cf4dc1998-02-12 22:33:50 +0000[diff] [blame]374
Fred Drakee34ab301998-05-11 21:10:15 +0000[diff] [blame]375html-$(RELEASE).tgz:
376 (cd $(HTMLDIR); tar cf - index.html ???/???.css ???/*.html */*.gif) \
Fred Drake29cabd41998-05-11 18:53:07 +0000[diff] [blame]377 | gzip -9 >$@
Fred Drake33d05b91998-01-13 16:33:09 +0000[diff] [blame]378
Fred Drakea7998351998-02-19 16:01:04 +0000[diff] [blame]379# convenience targets:
380
Fred Drakee34ab301998-05-11 21:10:15 +0000[diff] [blame]381tarhtml: html-$(RELEASE).tgz
Fred Drakebbe33c51998-05-07 01:39:06 +0000[diff] [blame]382
Fred Drakee34ab301998-05-11 21:10:15 +0000[diff] [blame]383tarinfo: lib-info-$(RELEASE).tgz
Fred Drakea7998351998-02-19 16:01:04 +0000[diff] [blame]384
Fred Drakee34ab301998-05-11 21:10:15 +0000[diff] [blame]385tarps: postscript-$(PAPER)-$(RELEASE).tgz
Fred Drake33d05b91998-01-13 16:33:09 +0000[diff] [blame]386
Fred Drakee34ab301998-05-11 21:10:15 +0000[diff] [blame]387tarpdf: pdf-$(PAPER)-$(RELEASE).tgz
Fred Drake04cf4dc1998-02-12 22:33:50 +0000[diff] [blame]388
Fred Drakee34ab301998-05-11 21:10:15 +0000[diff] [blame]389tarlatex: latex-$(RELEASE).tgz
Fred Drakee61d7af1998-03-05 16:37:34 +0000[diff] [blame]390
Fred Drakeefc17bd1998-07-28 21:05:16 +0000[diff] [blame^]391tarballs: tarpdf tarps tarhtml tarlatex
Guido van Rossum84cca441997-11-25 20:49:09 +0000[diff] [blame]392
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]393
394# Housekeeping targets
395
Guido van Rossum9231c8f1997-05-15 21:43:21 +0000[diff] [blame]396# Remove temporary files; all except the following:
Fred Drake6659c301998-03-03 22:02:19 +0000[diff] [blame]397# - sources: .tex, .bib, .sty, *.cls
Fred Drake04cf4dc1998-02-12 22:33:50 +0000[diff] [blame]398# - useful results: .dvi, .pdf, .ps, .texi, .info
Fred Drakee4837a11998-03-06 21:29:34 +0000[diff] [blame]399clean:
Fred Drake3f8a59f1998-07-24 13:58:27 +0000[diff] [blame]400 (cd paper-$(PAPER); rm -f *~ *.aux *.idx *.ilg *.ind *.log *.toc *.bkm *.syn)
Fred Drakee34ab301998-05-11 21:10:15 +0000[diff] [blame]401 (cd $(INFODIR); $(MAKE) clean)
Fred Drakeb9838d91998-05-08 15:43:08 +0000[diff] [blame]402 (cd $(HTMLDIR); rm -f @webchecker.pickle)
Fred Drakee34ab301998-05-11 21:10:15 +0000[diff] [blame]403 rm -f html-$(RELEASE).tgz info-$(RELEASE).tgz
404 rm -f pdf-$(RELEASE).tgz postscript-$(RELEASE).tgz
405 rm -f latex-$(RELEASE).tgz
Guido van Rossum5b343731992-07-07 09:06:34 +0000[diff] [blame]406
Fred Drake03ff6f71997-08-22 18:18:54 +0000[diff] [blame]407l2hclean:
Fred Drakeb9838d91998-05-08 15:43:08 +0000[diff] [blame]408 (cd $(HTMLDIR); rm -rf api ext lib ref tut)
Fred Drake03ff6f71997-08-22 18:18:54 +0000[diff] [blame]409
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]410# Remove temporaries as well as final products
Fred Drakee4837a11998-03-06 21:29:34 +0000[diff] [blame]411clobber: clean l2hclean
Fred Drakeb9838d91998-05-08 15:43:08 +0000[diff] [blame]412 (cd paper-$(PAPER); rm -f $(DVIFILES) $(PSFILES) $(PDFFILES))
Fred Drakee34ab301998-05-11 21:10:15 +0000[diff] [blame]413 (cd $(INFODIR); $(MAKE) clobber)
Fred Drake5ad78f31998-02-22 19:47:13 +0000[diff] [blame]414
415realclean: clobber
416distclean: clobber