blob: 0f95b75903b20c764ff310529037390dea208dd4 [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#
Fred Drake6532b9b1999-04-22 14:16:14 +00006# This is a bit of a mess. The documents are identified by short names:
Fred Draked69e2c41998-05-11 18:25:46 +00007# api -- Python/C API Reference Manual
Fred Drake6532b9b1999-04-22 14:16:14 +00008# doc -- Documenting Python
Fred Draked69e2c41998-05-11 18:25:46 +00009# ext -- Extending and Embedding the Python Interpreter
10# lib -- Library Reference Manual
Fred Drake34116ba1998-07-24 15:42:12 +000011# mac -- Macintosh Library Modules
Fred Drakef2951131998-05-07 19:30:16 +000012# ref -- Python Reference Manual
Fred Draked69e2c41998-05-11 18:25:46 +000013# tut -- Python Tutorial
Greg Ward0862f802000-04-28 16:53:36 +000014# inst -- Installing Python Modules
15# dist -- Distributing Python Modules
Guido van Rossume83e3801995-03-17 16:01:35 +000016#
Fred Drake3a045e82001-01-22 20:47:26 +000017# The LaTeX sources for each of these documents are in subdirectories
Fred Drakef2951131998-05-07 19:30:16 +000018# with the three-letter designations above as the directory names.
Guido van Rossum1f175431996-10-22 20:00:02 +000019#
Fred Drake3a045e82001-01-22 20:47:26 +000020# The main target creates HTML for each of the documents. You can
21# also do "make lib" (etc.) to create the HTML versions of individual
22# documents.
Guido van Rossume83e3801995-03-17 16:01:35 +000023#
Fred Drakef2951131998-05-07 19:30:16 +000024# The document classes and styles are in the texinputs/ directory.
25# These define a number of macros that are similar in name and intent
26# as macros in Texinfo (e.g. \code{...} and \emph{...}), as well as a
Fred Drakeefc17bd1998-07-28 21:05:16 +000027# number of environments for formatting function and data definitions.
Fred Drake3a045e82001-01-22 20:47:26 +000028# Documentation for the macros is included in "Documenting Python"; see
29# http://www.python.org/doc/current/doc/doc.html, or the sources for
30# this document in the doc/ directory.
Guido van Rossume83e3801995-03-17 16:01:35 +000031#
Fred Draked69e2c41998-05-11 18:25:46 +000032# Everything is processed by LaTeX. See the file `README' for more
33# information on the tools needed for processing.
Guido van Rossume83e3801995-03-17 16:01:35 +000034#
35# There's a problem with generating the index which has been solved by
36# a sed command applied to the index file. The shell script fix_hack
37# does this (the Makefile takes care of calling it).
38#
Guido van Rossume83e3801995-03-17 16:01:35 +000039# Additional targets attempt to convert selected LaTeX sources to
40# various other formats. These are generally site specific because
41# the tools used are all but universal. These targets are:
Fred Drake34116ba1998-07-24 15:42:12 +000042#
Fred Drake3a045e82001-01-22 20:47:26 +000043# ps -- convert all documents from LaTeX to PostScript
44# pdf -- convert all documents from LaTeX to the
Fred Drakeefc17bd1998-07-28 21:05:16 +000045# Portable Document Format
Fred Drake34116ba1998-07-24 15:42:12 +000046#
Fred Drakeefc17bd1998-07-28 21:05:16 +000047# See the README file for more information on these targets.
Fred Draked69e2c41998-05-11 18:25:46 +000048#
49# The formatted output is located in subdirectories. For PDF and
50# PostScript, look in the paper-$(PAPER)/ directory. For HTML, look in
Fred Drake34116ba1998-07-24 15:42:12 +000051# the html/ directory. If you want to fix the GNU info process, look
Fred Drakeeb7fe4f1998-08-12 17:08:37 +000052# in the info/ directory; please send patches to python-docs@python.org.
Guido van Rossume83e3801995-03-17 16:01:35 +000053
Fred Drake78430b62000-08-29 16:30:21 +000054# This Makefile only includes information on how to perform builds; for
55# dependency information, see Makefile.deps.
56
Fred Drake3a045e82001-01-22 20:47:26 +000057# Customization -- you *may* have to edit this
Guido van Rossume83e3801995-03-17 16:01:35 +000058
Fred Drake3a045e82001-01-22 20:47:26 +000059# You could set this to a4:
Fred Drakef2951131998-05-07 19:30:16 +000060PAPER=letter
61
Guido van Rossum73827c61995-03-20 13:00:32 +000062# Ideally, you shouldn't need to edit beyond this point
Guido van Rossum5b343731992-07-07 09:06:34 +000063
Fred Drakeeb7fe4f1998-08-12 17:08:37 +000064INFODIR= info
65TOOLSDIR= tools
66
Fred Drake860e2561999-07-12 16:52:50 +000067# This is the *documentation* release, and is used to construct the file
68# names of the downloadable tarballs.
Fred Drake9ae09942001-10-18 18:46:22 +000069RELEASE=2.2b1
Fred Drake860e2561999-07-12 16:52:50 +000070
Fred Drakef6bfe8e2001-02-19 19:19:26 +000071PYTHON= python
72DVIPS= dvips -N0 -t $(PAPER)
73
Fred Drake1385a572001-07-17 16:53:19 +000074MKDVI= $(PYTHON) ../tools/mkhowto --paper=$(PAPER) --dvi
75MKHTML= $(PYTHON) tools/mkhowto --html --about html/stdabout.dat \
Fred Drakef6bfe8e2001-02-19 19:19:26 +000076 --address $(PYTHONDOCS) --up-link ../index.html \
77 --up-title "Python Documentation Index" \
78 --global-module-index "../modindex.html"
Fred Drake0c77cf12001-10-19 21:12:57 +000079MKISILOHTML=$(PYTHON) tools/mkhowto --html --about html/stdabout.dat \
80 --l2h-init perl/isilo.perl --numeric --split 1
81MKISILO= iSilo386 -U -y -rCR -d0
Fred Drake1385a572001-07-17 16:53:19 +000082MKPDF= $(PYTHON) ../tools/mkhowto --paper=$(PAPER) --pdf
83MKPS= $(PYTHON) ../tools/mkhowto --paper=$(PAPER) --ps
Fred Drakef6bfe8e2001-02-19 19:19:26 +000084
85BUILDINDEX=$(TOOLSDIR)/buildindex.py
86
Fred Drake1385a572001-07-17 16:53:19 +000087PYTHONDOCS="See <i><a href=\"about.html\">About this document...</a></i> for information on suggesting changes."
Fred Drakef6bfe8e2001-02-19 19:19:26 +000088HTMLBASE= file:`pwd`
89
90# what's what
91MANDVIFILES= paper-$(PAPER)/api.dvi paper-$(PAPER)/ext.dvi \
92 paper-$(PAPER)/lib.dvi paper-$(PAPER)/mac.dvi \
93 paper-$(PAPER)/ref.dvi paper-$(PAPER)/tut.dvi
94HOWTODVIFILES= paper-$(PAPER)/doc.dvi paper-$(PAPER)/inst.dvi \
95 paper-$(PAPER)/dist.dvi
96
97MANPDFFILES= paper-$(PAPER)/api.pdf paper-$(PAPER)/ext.pdf \
98 paper-$(PAPER)/lib.pdf paper-$(PAPER)/mac.pdf \
99 paper-$(PAPER)/ref.pdf paper-$(PAPER)/tut.pdf
100HOWTOPDFFILES= paper-$(PAPER)/doc.pdf paper-$(PAPER)/inst.pdf \
101 paper-$(PAPER)/dist.pdf
102
103MANPSFILES= paper-$(PAPER)/api.ps paper-$(PAPER)/ext.ps \
104 paper-$(PAPER)/lib.ps paper-$(PAPER)/mac.ps \
105 paper-$(PAPER)/ref.ps paper-$(PAPER)/tut.ps
106HOWTOPSFILES= paper-$(PAPER)/doc.ps paper-$(PAPER)/inst.ps \
107 paper-$(PAPER)/dist.ps
108
109DVIFILES= $(MANDVIFILES) $(HOWTODVIFILES)
110PDFFILES= $(MANPDFFILES) $(HOWTOPDFFILES)
111PSFILES= $(MANPSFILES) $(HOWTOPSFILES)
112
Fred Drake0099d8f2001-10-25 15:12:31 +0000113HTMLCSSFILES=html/api/api.css \
114 html/doc/doc.css \
115 html/ext/ext.css \
116 html/lib/lib.css \
117 html/mac/mac.css \
118 html/ref/ref.css \
119 html/tut/tut.css \
120 html/inst/inst.css \
121 html/dist/dist.css
122
123ISILOCSSFILES=isilo/api/api.css \
124 isilo/doc/doc.css \
125 isilo/ext/ext.css \
126 isilo/lib/lib.css \
127 isilo/mac/mac.css \
128 isilo/ref/ref.css \
129 isilo/tut/tut.css \
130 isilo/inst/inst.css \
131 isilo/dist/dist.css
132
133ALLCSSFILES=$(HTMLCSSFILES) $(ISILOCSSFILES)
134
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000135INDEXFILES=html/api/api.html \
136 html/doc/doc.html \
137 html/ext/ext.html \
138 html/lib/lib.html \
139 html/mac/mac.html \
140 html/ref/ref.html \
141 html/tut/tut.html \
142 html/inst/inst.html \
143 html/dist/dist.html
144
Fred Drake5afb5e52001-07-18 21:17:29 +0000145ALLHTMLFILES=$(INDEXFILES) html/index.html html/modindex.html html/acks.html
146
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000147COMMONPERL= perl/manual.perl perl/python.perl perl/l2hinit.perl
148
149include Makefile.deps
Fred Drake33d05b91998-01-13 16:33:09 +0000150
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000151# These must be declared phony since there
152# are directories with matching names:
Greg Ward0862f802000-04-28 16:53:36 +0000153.PHONY: api doc ext lib mac ref tut inst dist
Fred Drake0c77cf12001-10-19 21:12:57 +0000154.PHONY: html info isilo
Fred Drake3f8a59f1998-07-24 13:58:27 +0000155
Fred Drakebbe33c51998-05-07 01:39:06 +0000156
Guido van Rossume83e3801995-03-17 16:01:35 +0000157# Main target
Fred Drake3a045e82001-01-22 20:47:26 +0000158all: html
Guido van Rossumeb8d5031996-08-09 21:46:05 +0000159
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000160dvi: $(DVIFILES)
161pdf: $(PDFFILES)
162ps: $(PSFILES)
Fred Drakee4837a11998-03-06 21:29:34 +0000163
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000164world: ps pdf html distfiles
Guido van Rossum20aca5a1991-01-25 13:29:04 +0000165
Fred Drakef2951131998-05-07 19:30:16 +0000166
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000167# Rules to build PostScript and PDF formats
168.SUFFIXES: .dvi .ps
169
170.dvi.ps:
171 $(DVIPS) -o $@ $<
Fred Draked69e2c41998-05-11 18:25:46 +0000172
173
174# Targets for each document:
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000175# Python/C API Reference Manual
176paper-$(PAPER)/api.dvi: paper-$(PAPER)/api.tex $(APIFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000177 cd paper-$(PAPER) && $(MKDVI) api.tex
Fred Draked69e2c41998-05-11 18:25:46 +0000178
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000179paper-$(PAPER)/api.pdf: paper-$(PAPER)/api.tex $(APIFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000180 cd paper-$(PAPER) && $(MKPDF) api.tex
Fred Drake15087431999-03-16 16:11:27 +0000181
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000182paper-$(PAPER)/api.tex: api/api.tex api/refcounts.dat tools/anno-api.py
183 $(PYTHON) $(TOOLSDIR)/anno-api.py -o $@ api/api.tex
Fred Draked69e2c41998-05-11 18:25:46 +0000184
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000185# Distributing Python Modules
186paper-$(PAPER)/dist.dvi: $(DISTFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000187 cd paper-$(PAPER) && $(MKDVI) ../dist/dist.tex
Fred Draked69e2c41998-05-11 18:25:46 +0000188
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000189paper-$(PAPER)/dist.pdf: $(DISTFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000190 cd paper-$(PAPER) && $(MKPDF) ../dist/dist.tex
Fred Draked69e2c41998-05-11 18:25:46 +0000191
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000192# Documenting Python
193paper-$(PAPER)/doc.dvi: $(DOCFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000194 cd paper-$(PAPER) && $(MKDVI) ../doc/doc.tex
Fred Drake3f8a59f1998-07-24 13:58:27 +0000195
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000196paper-$(PAPER)/doc.pdf: $(DOCFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000197 cd paper-$(PAPER) && $(MKPDF) ../doc/doc.tex
Fred Draked69e2c41998-05-11 18:25:46 +0000198
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000199# Extending and Embedding the Python Interpreter
200paper-$(PAPER)/ext.dvi: $(EXTFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000201 cd paper-$(PAPER) && $(MKDVI) ../ext/ext.tex
Greg Ward0862f802000-04-28 16:53:36 +0000202
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000203paper-$(PAPER)/ext.pdf: $(EXTFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000204 cd paper-$(PAPER) && $(MKPDF) ../ext/ext.tex
Greg Ward0862f802000-04-28 16:53:36 +0000205
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000206# Installing Python Modules
207paper-$(PAPER)/inst.dvi: $(INSTFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000208 cd paper-$(PAPER) && $(MKDVI) ../inst/inst.tex
Fred Draked69e2c41998-05-11 18:25:46 +0000209
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000210paper-$(PAPER)/inst.pdf: $(INSTFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000211 cd paper-$(PAPER) && $(MKPDF) ../inst/inst.tex
Fred Drakef2951131998-05-07 19:30:16 +0000212
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000213# Python Library Reference
214paper-$(PAPER)/lib.dvi: $(LIBFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000215 cd paper-$(PAPER) && $(MKDVI) ../lib/lib.tex
Fred Drake15087431999-03-16 16:11:27 +0000216
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000217paper-$(PAPER)/lib.pdf: $(LIBFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000218 cd paper-$(PAPER) && $(MKPDF) ../lib/lib.tex
Fred Drakef2951131998-05-07 19:30:16 +0000219
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000220# Macintosh Library Modules
221paper-$(PAPER)/mac.dvi: $(MACFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000222 cd paper-$(PAPER) && $(MKDVI) ../mac/mac.tex
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000223
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000224paper-$(PAPER)/mac.pdf: $(MACFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000225 cd paper-$(PAPER) && $(MKPDF) ../mac/mac.tex
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000226
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000227# Python Reference Manual
228paper-$(PAPER)/ref.dvi: $(REFFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000229 cd paper-$(PAPER) && $(MKDVI) ../ref/ref.tex
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000230
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000231paper-$(PAPER)/ref.pdf: $(REFFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000232 cd paper-$(PAPER) && $(MKPDF) ../ref/ref.tex
Fred Drakeddae4141998-02-17 15:45:25 +0000233
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000234# Python Tutorial
235paper-$(PAPER)/tut.dvi: $(TUTFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000236 cd paper-$(PAPER) && $(MKDVI) ../tut/tut.tex
Greg Ward0862f802000-04-28 16:53:36 +0000237
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000238paper-$(PAPER)/tut.pdf: $(TUTFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000239 cd paper-$(PAPER) && $(MKPDF) ../tut/tut.tex
Guido van Rossume83e3801995-03-17 16:01:35 +0000240
241# The remaining part of the Makefile is concerned with various
Guido van Rossum73827c61995-03-20 13:00:32 +0000242# conversions, as described above. See also the README file.
Guido van Rossume83e3801995-03-17 16:01:35 +0000243
Fred Drakeb9838d91998-05-08 15:43:08 +0000244info:
Fred Drake1385a572001-07-17 16:53:19 +0000245 cd $(INFODIR) && $(MAKE)
Fred Drake5ad78f31998-02-22 19:47:13 +0000246
Guido van Rossum73827c61995-03-20 13:00:32 +0000247# Targets to convert the manuals to HTML using Nikos Drakos' LaTeX to
248# HTML converter. For more info on this program, see
Guido van Rossume83e3801995-03-17 16:01:35 +0000249# <URL:http://cbl.leeds.ac.uk/nikos/tex2html/doc/latex2html/latex2html.html>.
Guido van Rossume83e3801995-03-17 16:01:35 +0000250
Guido van Rossum9cb64801997-12-29 20:01:55 +0000251# Note that LaTeX2HTML inserts references to an icons directory in
252# each page that it generates. I have placed a copy of this directory
253# in the distribution to simplify the process of creating a
254# self-contained HTML distribution; for this purpose I have also added
255# a (trivial) index.html. Change the definition of $ICONSERVER in
Fred Drake9fab3aa1998-04-28 19:20:43 +0000256# perl/l2hinit.perl to use a different location for the icons directory.
Guido van Rossume83e3801995-03-17 16:01:35 +0000257
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000258# If you have the standard LaTeX2HTML icons installed, the versions shipped
259# with this documentation should be stored in a separate directory and used
260# instead. The standard set does *not* include all the icons used in the
261# Python documentation.
Fred Drakebbe33c51998-05-07 01:39:06 +0000262
Fred Drake0099d8f2001-10-25 15:12:31 +0000263$(ALLCSSFILES): html/style.css
264 cp $< $@
265
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000266$(INDEXFILES): $(COMMONPERL) html/about.dat tools/node2label.pl
Guido van Rossum6938f061994-08-01 12:22:53 +0000267
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000268html/acks.html: ACKS $(TOOLSDIR)/support.py $(TOOLSDIR)/mkackshtml
Fred Drake1385a572001-07-17 16:53:19 +0000269 $(PYTHON) $(TOOLSDIR)/mkackshtml --address $(PYTHONDOCS) \
Fred Draked27ed852001-02-22 23:06:21 +0000270 --output html/acks.html <ACKS
Guido van Rossum6938f061994-08-01 12:22:53 +0000271
Fred Drake1385a572001-07-17 16:53:19 +0000272
273# html/index.html is dependent on $(INDEXFILES) since we want the date
274# on the front index to be updated whenever any of the child documents
275# are updated and boilerplate.tex uses \today as the date. The index
276# files are not used to actually generate content.
277
278BOILERPLATE=texinputs/boilerplate.tex
279html/index.html: $(INDEXFILES)
280html/index.html: html/index.html.in $(BOILERPLATE) tools/rewrite.py
281 $(PYTHON) tools/rewrite.py $(BOILERPLATE) RELEASE=$(RELEASE) \
282 <$< >$@
283
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000284html/modindex.html: $(TOOLSDIR)/support.py $(TOOLSDIR)/mkmodindex
285html/modindex.html: html/lib/lib.html html/mac/mac.html
Fred Drake1385a572001-07-17 16:53:19 +0000286 cd html && \
287 $(PYTHON) ../$(TOOLSDIR)/mkmodindex --columns 4 \
288 --output modindex.html --address $(PYTHONDOCS) \
289 lib/modindex.html mac/modindex.html
Fred Drake7d5f5dd1999-03-18 19:08:47 +0000290
Fred Drake0099d8f2001-10-25 15:12:31 +0000291html: $(ALLHTMLFILES) $(HTMLCSSFILES)
Guido van Rossum970871f1993-02-21 20:10:26 +0000292
Fred Drake0099d8f2001-10-25 15:12:31 +0000293api: html/api/api.html html/api/api.css
294html/api/api.html: $(APIFILES)
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000295 $(MKHTML) --dir html/api api/api.tex
Fred Drakea6bb3961998-05-06 19:51:39 +0000296
Fred Drake0099d8f2001-10-25 15:12:31 +0000297doc: html/doc/doc.html html/doc/doc.css
298html/doc/doc.html: $(DOCFILES)
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000299 $(MKHTML) --dir html/doc doc/doc.tex
Fred Drakecdbd3911998-05-15 17:02:10 +0000300
Fred Drake0099d8f2001-10-25 15:12:31 +0000301ext: html/ext/ext.html html/ext/ext.css
302html/ext/ext.html: $(EXTFILES)
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000303 $(MKHTML) --dir html/ext ext/ext.tex
Guido van Rossume83e3801995-03-17 16:01:35 +0000304
Fred Drake0099d8f2001-10-25 15:12:31 +0000305lib: html/lib/lib.html html/lib/lib.css
306html/lib/lib.html: $(LIBFILES)
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000307 $(MKHTML) --dir html/lib lib/lib.tex
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000308
Fred Drake0099d8f2001-10-25 15:12:31 +0000309mac: html/mac/mac.html html/mac/mac.css
310html/mac/mac.html: $(MACFILES)
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000311 $(MKHTML) --dir html/mac mac/mac.tex
Greg Ward0862f802000-04-28 16:53:36 +0000312
Fred Drake0099d8f2001-10-25 15:12:31 +0000313ref: html/ref/ref.html html/ref/ref.css
314html/ref/ref.html: $(REFFILES)
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000315 $(MKHTML) --dir html/ref ref/ref.tex
Greg Ward0862f802000-04-28 16:53:36 +0000316
Fred Drake0099d8f2001-10-25 15:12:31 +0000317tut: html/tut/tut.html html/tut/tut.css
318html/tut/tut.html: $(TUTFILES)
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000319 $(MKHTML) --dir html/tut --numeric --split 3 tut/tut.tex
320
Fred Drake0099d8f2001-10-25 15:12:31 +0000321inst: html/inst/inst.html html/inst/inst.css
322html/inst/inst.html: $(INSTFILES) perl/distutils.perl
Fred Drake8c011582001-03-01 18:38:56 +0000323 $(MKHTML) --dir html/inst --split 4 inst/inst.tex
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000324
Fred Drake0099d8f2001-10-25 15:12:31 +0000325dist: html/dist/dist.html html/dist/dist.css
326html/dist/dist.html: $(DISTFILES) perl/distutils.perl
Fred Drake8c011582001-03-01 18:38:56 +0000327 $(MKHTML) --dir html/dist --split 4 dist/dist.tex
Fred Drakee7a8c972000-04-07 16:27:15 +0000328
Guido van Rossum9231c8f1997-05-15 21:43:21 +0000329
Fred Drake0c77cf12001-10-19 21:12:57 +0000330# The iSilo format is used by the iSilo document reader for PalmOS devices.
331
332ISILOINDEXFILES=isilo/api/api.html \
333 isilo/doc/doc.html \
334 isilo/ext/ext.html \
335 isilo/lib/lib.html \
336 isilo/mac/mac.html \
337 isilo/ref/ref.html \
338 isilo/tut/tut.html \
339 isilo/inst/inst.html \
340 isilo/dist/dist.html
341
342$(ISILOINDEXFILES): $(COMMONPERL) html/about.dat perl/isilo.perl
343
344isilo: isilo/python-api-$(RELEASE).pdb \
345 isilo/python-doc-$(RELEASE).pdb \
346 isilo/python-ext-$(RELEASE).pdb \
347 isilo/python-lib-$(RELEASE).pdb \
348 isilo/python-mac-$(RELEASE).pdb \
349 isilo/python-ref-$(RELEASE).pdb \
350 isilo/python-tut-$(RELEASE).pdb \
351 isilo/python-dist-$(RELEASE).pdb \
352 isilo/python-inst-$(RELEASE).pdb
353
Fred Drake0099d8f2001-10-25 15:12:31 +0000354isilo/python-api-$(RELEASE).pdb: isilo/api/api.html isilo/api/api.css
Fred Drake0c77cf12001-10-19 21:12:57 +0000355 $(MKISILO) "-iPython/C API Reference Manual" \
356 isilo/api/api.html $@
357
Fred Drake0099d8f2001-10-25 15:12:31 +0000358isilo/python-doc-$(RELEASE).pdb: isilo/doc/doc.html isilo/doc/doc.css
Fred Drake0c77cf12001-10-19 21:12:57 +0000359 $(MKISILO) "-iDocumenting Python" \
360 isilo/doc/doc.html $@
361
Fred Drake0099d8f2001-10-25 15:12:31 +0000362isilo/python-ext-$(RELEASE).pdb: isilo/ext/ext.html isilo/ext/ext.css
Fred Drake0c77cf12001-10-19 21:12:57 +0000363 $(MKISILO) "-iExtending & Embedding Python" \
364 isilo/ext/ext.html $@
365
Fred Drake0099d8f2001-10-25 15:12:31 +0000366isilo/python-lib-$(RELEASE).pdb: isilo/lib/lib.html isilo/lib/lib.css
Fred Drake0c77cf12001-10-19 21:12:57 +0000367 $(MKISILO) "-iPython Library Reference" \
368 isilo/lib/lib.html $@
369
Fred Drake0099d8f2001-10-25 15:12:31 +0000370isilo/python-mac-$(RELEASE).pdb: isilo/mac/mac.html isilo/mac/mac.css
Fred Drake0c77cf12001-10-19 21:12:57 +0000371 $(MKISILO) "-iPython/C API Reference Manual" \
372 isilo/mac/mac.html $@
373
Fred Drake0099d8f2001-10-25 15:12:31 +0000374isilo/python-ref-$(RELEASE).pdb: isilo/ref/ref.html isilo/ref/ref.css
Fred Drake0c77cf12001-10-19 21:12:57 +0000375 $(MKISILO) "-iPython Reference Manual" \
376 isilo/ref/ref.html $@
377
Fred Drake0099d8f2001-10-25 15:12:31 +0000378isilo/python-tut-$(RELEASE).pdb: isilo/tut/tut.html isilo/tut/tut.css
Fred Drake0c77cf12001-10-19 21:12:57 +0000379 $(MKISILO) "-iPython Tutorial" \
380 isilo/tut/tut.html $@
381
Fred Drake0099d8f2001-10-25 15:12:31 +0000382isilo/python-dist-$(RELEASE).pdb: isilo/dist/dist.html isilo/dist/dist.css
Fred Drake0c77cf12001-10-19 21:12:57 +0000383 $(MKISILO) "-iDistributing Python Modules" \
384 isilo/dist/dist.html $@
385
Fred Drake0099d8f2001-10-25 15:12:31 +0000386isilo/python-inst-$(RELEASE).pdb: isilo/inst/inst.html isilo/inst/inst.css
Fred Drake0c77cf12001-10-19 21:12:57 +0000387 $(MKISILO) "-iInstalling Python Modules" \
388 isilo/inst/inst.html $@
389
390isilo/api/api.html: $(APIFILES)
391 $(MKISILOHTML) --dir isilo/api api/api.tex
392
393isilo/doc/doc.html: $(DOCFILES)
394 $(MKISILOHTML) --dir isilo/doc doc/doc.tex
395
396isilo/ext/ext.html: $(EXTFILES)
397 $(MKISILOHTML) --dir isilo/ext ext/ext.tex
398
399isilo/lib/lib.html: $(LIBFILES)
400 $(MKISILOHTML) --dir isilo/lib lib/lib.tex
401
402isilo/mac/mac.html: $(MACFILES)
403 $(MKISILOHTML) --dir isilo/mac mac/mac.tex
404
405isilo/ref/ref.html: $(REFFILES)
406 $(MKISILOHTML) --dir isilo/ref ref/ref.tex
407
408isilo/tut/tut.html: $(TUTFILES)
409 $(MKISILOHTML) --dir isilo/tut tut/tut.tex
410
411isilo/inst/inst.html: $(INSTFILES) perl/distutils.perl
412 $(MKISILOHTML) --dir isilo/inst inst/inst.tex
413
414isilo/dist/dist.html: $(DISTFILES) perl/distutils.perl
415 $(MKISILOHTML) --dir isilo/dist dist/dist.tex
416
417# These are useful if you need to transport the iSilo-ready HTML to
418# another machine to perform the conversion:
419
420isilozip: isilo-html-$(RELEASE).zip
421
422isilo-html-$(RELEASE).zip: $(ISILOINDEXFILES)
423 rm -f $@
424 cd isilo && \
425 zip -q -9 ../$@ */*.css */*.html */*.txt
426
427
Fred Drakee4837a11998-03-06 21:29:34 +0000428# webchecker needs an extra flag to process the huge index from the libref
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000429WEBCHECKER=$(PYTHON) ../Tools/webchecker/webchecker.py
430HTMLBASE= file:`pwd`/html
431
Fred Drake5afb5e52001-07-18 21:17:29 +0000432webcheck: $(ALLHTMLFILES)
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000433 $(WEBCHECKER) $(HTMLBASE)/api/
434 $(WEBCHECKER) $(HTMLBASE)/doc/
435 $(WEBCHECKER) $(HTMLBASE)/ext/
436 $(WEBCHECKER) -m290000 $(HTMLBASE)/lib/
437 $(WEBCHECKER) $(HTMLBASE)/mac/
438 $(WEBCHECKER) $(HTMLBASE)/ref/
439 $(WEBCHECKER) $(HTMLBASE)/tut/
440 $(WEBCHECKER) $(HTMLBASE)/dist/
441 $(WEBCHECKER) $(HTMLBASE)/inst/
442
Fred Drake5afb5e52001-07-18 21:17:29 +0000443fastwebcheck: $(ALLHTMLFILES)
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000444 $(WEBCHECKER) -x $(HTMLBASE)/api/
445 $(WEBCHECKER) -x $(HTMLBASE)/doc/
446 $(WEBCHECKER) -x $(HTMLBASE)/ext/
447 $(WEBCHECKER) -x -m290000 $(HTMLBASE)/lib/
448 $(WEBCHECKER) -x $(HTMLBASE)/mac/
449 $(WEBCHECKER) -x $(HTMLBASE)/ref/
450 $(WEBCHECKER) -x $(HTMLBASE)/tut/
451 $(WEBCHECKER) -x $(HTMLBASE)/dist/
452 $(WEBCHECKER) -x $(HTMLBASE)/inst/
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000453
454
455# Release packaging targets:
Fred Drakee4837a11998-03-06 21:29:34 +0000456
Fred Drake5afb5e52001-07-18 21:17:29 +0000457paper-$(PAPER)/README: $(PSFILES) $(TOOLSDIR)/getpagecounts
Fred Drake1385a572001-07-17 16:53:19 +0000458 cd paper-$(PAPER) && ../$(TOOLSDIR)/getpagecounts >../$@
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000459
Fred Drakeb6584ca1999-01-08 15:49:45 +0000460info-$(RELEASE).tgz: info
Fred Drake1385a572001-07-17 16:53:19 +0000461 cd $(INFODIR) && tar cf - README python.dir python-*.info* \
Fred Drake28e66d11999-01-29 22:23:25 +0000462 | gzip -9 >$@
Fred Drakea7998351998-02-19 16:01:04 +0000463
Fred Drake4ef3ea01999-07-27 16:30:59 +0000464info-$(RELEASE).tar.bz2: info
Fred Drake1385a572001-07-17 16:53:19 +0000465 cd $(INFODIR) && tar cf - README python.dir python-*.info* \
Fred Drake4ef3ea01999-07-27 16:30:59 +0000466 | bzip2 -9 >$@
467
Fred Drakee34ab301998-05-11 21:10:15 +0000468latex-$(RELEASE).tgz:
Fred Drake1385a572001-07-17 16:53:19 +0000469 $(PYTHON) $(TOOLSDIR)/mksourcepkg --gzip $(RELEASE)
Fred Drakee61d7af1998-03-05 16:37:34 +0000470
Fred Drake4ef3ea01999-07-27 16:30:59 +0000471latex-$(RELEASE).tar.bz2:
Fred Drake1385a572001-07-17 16:53:19 +0000472 $(PYTHON) $(TOOLSDIR)/mksourcepkg --bzip2 $(RELEASE)
Fred Drake4ef3ea01999-07-27 16:30:59 +0000473
Fred Drake7dcc69a1999-07-23 16:11:36 +0000474latex-$(RELEASE).zip:
Fred Drake02ba6212000-04-04 20:58:25 +0000475 rm -f $@
Fred Drake1385a572001-07-17 16:53:19 +0000476 $(PYTHON) $(TOOLSDIR)/mksourcepkg --zip $(RELEASE)
Fred Drake7dcc69a1999-07-23 16:11:36 +0000477
Fred Drake5afb5e52001-07-18 21:17:29 +0000478pdf-$(PAPER)-$(RELEASE).tar: $(PDFFILES)
479 cd paper-$(PAPER) && tar cf ../$@ *.pdf
Fred Drake04cf4dc1998-02-12 22:33:50 +0000480
Fred Drake5afb5e52001-07-18 21:17:29 +0000481pdf-$(PAPER)-$(RELEASE).tgz: pdf-$(PAPER)-$(RELEASE).tar
482 gzip -9 <$? >$@
483
484pdf-$(PAPER)-$(RELEASE).tar.bz2: pdf-$(PAPER)-$(RELEASE).tar
485 bzip2 -9 <$? >$@
Fred Drake4ef3ea01999-07-27 16:30:59 +0000486
Fred Drake7dcc69a1999-07-23 16:11:36 +0000487pdf-$(PAPER)-$(RELEASE).zip: pdf
Fred Drake02ba6212000-04-04 20:58:25 +0000488 rm -f $@
Fred Drake1385a572001-07-17 16:53:19 +0000489 cd paper-$(PAPER) && zip -q -9 ../$@ *.pdf
Fred Drake7dcc69a1999-07-23 16:11:36 +0000490
Fred Drake5afb5e52001-07-18 21:17:29 +0000491postscript-$(PAPER)-$(RELEASE).tar: $(PSFILES) paper-$(PAPER)/README
492 cd paper-$(PAPER) && tar cf ../$@ *.ps README
Fred Drake04cf4dc1998-02-12 22:33:50 +0000493
Fred Drake5afb5e52001-07-18 21:17:29 +0000494postscript-$(PAPER)-$(RELEASE).tar.bz2: postscript-$(PAPER)-$(RELEASE).tar
495 bzip2 -9 <$< >$@
Fred Drake4ef3ea01999-07-27 16:30:59 +0000496
Fred Drake5afb5e52001-07-18 21:17:29 +0000497postscript-$(PAPER)-$(RELEASE).tgz: postscript-$(PAPER)-$(RELEASE).tar
498 gzip -9 <$< >$@
499
500postscript-$(PAPER)-$(RELEASE).zip: $(PSFILES) paper-$(PAPER)/README
Fred Drake02ba6212000-04-04 20:58:25 +0000501 rm -f $@
Fred Drake1385a572001-07-17 16:53:19 +0000502 cd paper-$(PAPER) && zip -q -9 ../$@ *.ps README
Fred Drake7dcc69a1999-07-23 16:11:36 +0000503
Fred Drake0099d8f2001-10-25 15:12:31 +0000504html-$(RELEASE).tar: $(ALLHTMLFILES) $(HTMLCSSFILES)
Fred Drake9ae09942001-10-18 18:46:22 +0000505 cd html && \
Fred Drake8f65aef2001-07-17 23:35:46 +0000506 tar cf ../html-$(RELEASE).tar *.html */*.css */*.html \
507 */*.gif */*.txt
Fred Drake33d05b91998-01-13 16:33:09 +0000508
Fred Drake8f65aef2001-07-17 23:35:46 +0000509html-$(RELEASE).tgz: html-$(RELEASE).tar
Fred Drake5afb5e52001-07-18 21:17:29 +0000510 gzip -9 <$? >$@
Fred Drake8f65aef2001-07-17 23:35:46 +0000511
512html-$(RELEASE).tar.bz2: html-$(RELEASE).tar
Fred Drake5afb5e52001-07-18 21:17:29 +0000513 bzip2 -9 <$? >$@
Fred Drake4ef3ea01999-07-27 16:30:59 +0000514
Fred Drake0099d8f2001-10-25 15:12:31 +0000515html-$(RELEASE).zip: $(ALLHTMLFILES) $(HTMLCSSFILES)
Fred Drake02ba6212000-04-04 20:58:25 +0000516 rm -f $@
Fred Drake9ae09942001-10-18 18:46:22 +0000517 cd html && \
Fred Drake1385a572001-07-17 16:53:19 +0000518 zip -q -9 ../$@ *.html */*.css */*.html */*.gif */*.txt
Fred Drake7dcc69a1999-07-23 16:11:36 +0000519
Fred Drake0c77cf12001-10-19 21:12:57 +0000520isilo-$(RELEASE).zip: isilo
521 cd isilo && zip -q -9 ../$@ python-*-$(RELEASE).pdb
522
523
Fred Drakea7998351998-02-19 16:01:04 +0000524# convenience targets:
525
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000526tarhtml: html-$(RELEASE).tgz
Fred Drakeb6584ca1999-01-08 15:49:45 +0000527tarinfo: info-$(RELEASE).tgz
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000528tarps: postscript-$(PAPER)-$(RELEASE).tgz
529tarpdf: pdf-$(PAPER)-$(RELEASE).tgz
530tarlatex: latex-$(RELEASE).tgz
Fred Drakebbe33c51998-05-07 01:39:06 +0000531
Fred Drake83c09831999-08-02 20:20:14 +0000532tarballs: tarpdf tarps tarhtml
Guido van Rossum84cca441997-11-25 20:49:09 +0000533
Fred Drake7dcc69a1999-07-23 16:11:36 +0000534ziphtml: html-$(RELEASE).zip
535zipps: postscript-$(PAPER)-$(RELEASE).zip
536zippdf: pdf-$(PAPER)-$(RELEASE).zip
537ziplatex: latex-$(RELEASE).zip
Fred Drake0c77cf12001-10-19 21:12:57 +0000538zipisilo: isilo-$(RELEASE).zip
Fred Drake7dcc69a1999-07-23 16:11:36 +0000539
Fred Drakeb906d2e2000-07-01 02:37:37 +0000540zips: zippdf zipps ziphtml
Fred Drake7dcc69a1999-07-23 16:11:36 +0000541
Fred Drake4ef3ea01999-07-27 16:30:59 +0000542bziphtml: html-$(RELEASE).tar.bz2
543bzipinfo: info-$(RELEASE).tar.bz2
544bzipps: postscript-$(PAPER)-$(RELEASE).tar.bz2
545bzippdf: pdf-$(PAPER)-$(RELEASE).tar.bz2
546bziplatex: latex-$(RELEASE).tar.bz2
547
Fred Drake83c09831999-08-02 20:20:14 +0000548bzips: bzippdf bzipps bziphtml
Fred Drake4ef3ea01999-07-27 16:30:59 +0000549
Fred Drakefc4ee0a2001-04-13 18:00:23 +0000550disthtml: tarhtml bziphtml ziphtml
551distinfo: tarinfo bzipinfo
552distps: tarps bzipps zipps
553distpdf: tarpdf bzippdf zippdf
554distlatex: tarlatex bziplatex ziplatex
555
Fred Drake5afb5e52001-07-18 21:17:29 +0000556paperdist: distpdf distps
557edist: disthtml
558
559distfiles: paperdist edist
Fred Drake88634602001-01-25 17:32:51 +0000560 $(TOOLSDIR)/mksourcepkg --all $(RELEASE)
Fred Drake4ef3ea01999-07-27 16:30:59 +0000561
Guido van Rossume83e3801995-03-17 16:01:35 +0000562
563# Housekeeping targets
564
Guido van Rossum9231c8f1997-05-15 21:43:21 +0000565# Remove temporary files; all except the following:
Fred Drake6659c301998-03-03 22:02:19 +0000566# - sources: .tex, .bib, .sty, *.cls
Fred Drake04cf4dc1998-02-12 22:33:50 +0000567# - useful results: .dvi, .pdf, .ps, .texi, .info
Fred Drakee4837a11998-03-06 21:29:34 +0000568clean:
Fred Drake8f65aef2001-07-17 23:35:46 +0000569 rm -f html-$(RELEASE).tar
Fred Drake1385a572001-07-17 16:53:19 +0000570 cd $(INFODIR) && $(MAKE) clean
Guido van Rossum5b343731992-07-07 09:06:34 +0000571
Guido van Rossume83e3801995-03-17 16:01:35 +0000572# Remove temporaries as well as final products
Fred Drakeb6584ca1999-01-08 15:49:45 +0000573clobber:
Fred Drake8f65aef2001-07-17 23:35:46 +0000574 rm -f html-$(RELEASE).tar
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000575 rm -f html-$(RELEASE).tgz info-$(RELEASE).tgz
576 rm -f pdf-$(RELEASE).tgz postscript-$(RELEASE).tgz
Fred Drake7dcc69a1999-07-23 16:11:36 +0000577 rm -f latex-$(RELEASE).tgz html-$(RELEASE).zip
578 rm -f pdf-$(RELEASE).zip postscript-$(RELEASE).zip
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000579 rm -f $(DVIFILES) $(PSFILES) $(PDFFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000580 cd $(INFODIR) && $(MAKE) clobber
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000581 rm -rf html/index.html html/modindex.html html/acks.html
582 rm -rf html/api/ html/doc/ html/ext/ html/lib/ html/mac/
583 rm -rf html/ref/ html/tut/ html/inst/ html/dist/
Fred Drake0c77cf12001-10-19 21:12:57 +0000584 rm -rf isilo/api/ isilo/doc/ isilo/ext/ isilo/lib/ isilo/mac/
585 rm -rf isilo/ref/ isilo/tut/ isilo/inst/ isilo/dist/
586 rm -f isilo/python-*-$(RELEASE).pdb isilo-$(RELEASE).zip
Fred Drake5ad78f31998-02-22 19:47:13 +0000587
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000588realclean distclean: clobber