Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / cpython3 / df49324c0bfb905a68b972952b661c6b2852dbf1 / . / Doc / Makefile
blob: 3fae30b9d6b6a126c55cb774cf62110e2337f65d [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#
Fred Drake6532b9b1999-04-22 14:16:14 +0000[diff] [blame]6# This is a bit of a mess. The documents are identified by short names:
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]7# api -- Python/C API Reference Manual
Fred Drake6532b9b1999-04-22 14:16:14 +0000[diff] [blame]8# doc -- Documenting Python
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]9# ext -- Extending and Embedding the Python Interpreter
10# lib -- Library Reference Manual
Fred Drake34116ba1998-07-24 15:42:12 +0000[diff] [blame]11# mac -- Macintosh Library Modules
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]12# ref -- Python Reference Manual
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]13# tut -- Python Tutorial
Greg Ward0862f802000-04-28 16:53:36 +0000[diff] [blame]14# inst -- Installing Python Modules
15# dist -- Distributing Python Modules
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]16#
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame]17# The LaTeX sources for each of these documents are in subdirectories
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]18# with the three-letter designations above as the directory names.
Guido van Rossum1f175431996-10-22 20:00:02 +0000[diff] [blame]19#
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame]20# 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 +0000[diff] [blame]23#
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]24# 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 +0000[diff] [blame]27# number of environments for formatting function and data definitions.
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame]28# 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 +0000[diff] [blame]31#
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]32# 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 +0000[diff] [blame]34#
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 +0000[diff] [blame]39# 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 +0000[diff] [blame]42#
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame]43# ps -- convert all documents from LaTeX to PostScript
44# pdf -- convert all documents from LaTeX to the
Fred Drakeefc17bd1998-07-28 21:05:16 +0000[diff] [blame]45# Portable Document Format
Fred Drake34116ba1998-07-24 15:42:12 +0000[diff] [blame]46#
Fred Drakeefc17bd1998-07-28 21:05:16 +0000[diff] [blame]47# See the README file for more information on these targets.
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]48#
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 +0000[diff] [blame]51# the html/ directory. If you want to fix the GNU info process, look
Fred Drake9d843082003-07-30 02:55:28 +0000[diff] [blame]52# in the info/ directory; please send patches to docs@python.org.
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]53
Fred Drake78430b62000-08-29 16:30:21 +0000[diff] [blame]54# 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 +0000[diff] [blame]57# Customization -- you *may* have to edit this
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]58
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame]59# You could set this to a4:
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]60PAPER=letter
61
Guido van Rossum73827c61995-03-20 13:00:32 +0000[diff] [blame]62# Ideally, you shouldn't need to edit beyond this point
Guido van Rossum5b343731992-07-07 09:06:34 +0000[diff] [blame]63
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]64INFODIR= info
65TOOLSDIR= tools
66
Fred Drake860e2561999-07-12 16:52:50 +0000[diff] [blame]67# This is the *documentation* release, and is used to construct the file
68# names of the downloadable tarballs.
Fred Drakeafc0d8e2003-07-30 18:43:28 +0000[diff] [blame]69RELEASE=2.4a0
Fred Drake860e2561999-07-12 16:52:50 +0000[diff] [blame]70
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]71PYTHON= python
72DVIPS= dvips -N0 -t $(PAPER)
73
Fred Drakedf493242003-09-25 15:25:37 +0000[diff] [blame^]74MKHOWTO= $(PYTHON) ../tools/mkhowto
75
76MKDVI= $(MKHOWTO) --paper=$(PAPER) --dvi
77MKHTML= $(MKHOWTO) --html --about html/stdabout.dat \
Fred Drakeb1510d52002-10-30 17:07:02 +0000[diff] [blame]78 --iconserver ../icons --favicon ../icons/pyfav.gif \
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]79 --address $(PYTHONDOCS) --up-link ../index.html \
80 --up-title "Python Documentation Index" \
Fred Drake345b8df2001-10-30 16:28:46 +0000[diff] [blame]81 --global-module-index "../modindex.html" --dvips-safe
Fred Drakedf493242003-09-25 15:25:37 +0000[diff] [blame^]82MKISILOHTML=$(MKHOWTO) --html --about html/stdabout.dat \
Fred Drake15a159c2002-10-01 15:20:20 +0000[diff] [blame]83 --iconserver ../icons \
Fred Drake345b8df2001-10-30 16:28:46 +0000[diff] [blame]84 --l2h-init perl/isilo.perl --numeric --split 1 \
85 --dvips-safe
Fred Drake0c77cf12001-10-19 21:12:57 +0000[diff] [blame]86MKISILO= iSilo386 -U -y -rCR -d0
Fred Drakedf493242003-09-25 15:25:37 +0000[diff] [blame^]87MKPDF= $(MKHOWTO) --paper=$(PAPER) --pdf
88MKPS= $(MKHOWTO) --paper=$(PAPER) --ps
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]89
90BUILDINDEX=$(TOOLSDIR)/buildindex.py
91
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]92PYTHONDOCS="See <i><a href=\"about.html\">About this document...</a></i> for information on suggesting changes."
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]93HTMLBASE= file:`pwd`
94
Fred Drakebfc18bd2002-05-03 04:50:51 +0000[diff] [blame]95# The emacs binary used to build the info docs. GNU Emacs 21 is required.
96EMACS= emacs
97
Fred Drake30140862002-03-26 19:53:56 +0000[diff] [blame]98# The end of this should reflect the major/minor version numbers of
99# the release:
Fred Drake90b20492003-07-30 19:14:54 +0000[diff] [blame]100WHATSNEW=whatsnew24
Fred Drake9ac14de2002-03-26 19:18:18 +0000[diff] [blame]101
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]102# what's what
103MANDVIFILES= paper-$(PAPER)/api.dvi paper-$(PAPER)/ext.dvi \
104 paper-$(PAPER)/lib.dvi paper-$(PAPER)/mac.dvi \
105 paper-$(PAPER)/ref.dvi paper-$(PAPER)/tut.dvi
106HOWTODVIFILES= paper-$(PAPER)/doc.dvi paper-$(PAPER)/inst.dvi \
Fred Drake9ac14de2002-03-26 19:18:18 +0000[diff] [blame]107 paper-$(PAPER)/dist.dvi paper-$(PAPER)/$(WHATSNEW).dvi
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]108
109MANPDFFILES= paper-$(PAPER)/api.pdf paper-$(PAPER)/ext.pdf \
110 paper-$(PAPER)/lib.pdf paper-$(PAPER)/mac.pdf \
111 paper-$(PAPER)/ref.pdf paper-$(PAPER)/tut.pdf
112HOWTOPDFFILES= paper-$(PAPER)/doc.pdf paper-$(PAPER)/inst.pdf \
Fred Drake9ac14de2002-03-26 19:18:18 +0000[diff] [blame]113 paper-$(PAPER)/dist.pdf paper-$(PAPER)/$(WHATSNEW).pdf
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]114
115MANPSFILES= paper-$(PAPER)/api.ps paper-$(PAPER)/ext.ps \
116 paper-$(PAPER)/lib.ps paper-$(PAPER)/mac.ps \
117 paper-$(PAPER)/ref.ps paper-$(PAPER)/tut.ps
118HOWTOPSFILES= paper-$(PAPER)/doc.ps paper-$(PAPER)/inst.ps \
Fred Drake9ac14de2002-03-26 19:18:18 +0000[diff] [blame]119 paper-$(PAPER)/dist.ps paper-$(PAPER)/$(WHATSNEW).ps
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]120
121DVIFILES= $(MANDVIFILES) $(HOWTODVIFILES)
122PDFFILES= $(MANPDFFILES) $(HOWTOPDFFILES)
123PSFILES= $(MANPSFILES) $(HOWTOPSFILES)
124
Fred Drake0099d8f2001-10-25 15:12:31 +0000[diff] [blame]125HTMLCSSFILES=html/api/api.css \
126 html/doc/doc.css \
127 html/ext/ext.css \
128 html/lib/lib.css \
129 html/mac/mac.css \
130 html/ref/ref.css \
131 html/tut/tut.css \
132 html/inst/inst.css \
133 html/dist/dist.css
134
135ISILOCSSFILES=isilo/api/api.css \
136 isilo/doc/doc.css \
137 isilo/ext/ext.css \
138 isilo/lib/lib.css \
139 isilo/mac/mac.css \
140 isilo/ref/ref.css \
141 isilo/tut/tut.css \
142 isilo/inst/inst.css \
143 isilo/dist/dist.css
144
145ALLCSSFILES=$(HTMLCSSFILES) $(ISILOCSSFILES)
146
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]147INDEXFILES=html/api/api.html \
148 html/doc/doc.html \
149 html/ext/ext.html \
150 html/lib/lib.html \
151 html/mac/mac.html \
152 html/ref/ref.html \
153 html/tut/tut.html \
154 html/inst/inst.html \
Fred Drake9ac14de2002-03-26 19:18:18 +0000[diff] [blame]155 html/dist/dist.html \
156 html/whatsnew/$(WHATSNEW).html
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]157
Fred Drake5afb5e52001-07-18 21:17:29 +0000[diff] [blame]158ALLHTMLFILES=$(INDEXFILES) html/index.html html/modindex.html html/acks.html
159
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]160COMMONPERL= perl/manual.perl perl/python.perl perl/l2hinit.perl
161
Fred Drake520b0092001-10-29 17:40:40 +0000[diff] [blame]162ANNOAPI=api/refcounts.dat tools/anno-api.py
163
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]164include Makefile.deps
Fred Drake33d05b91998-01-13 16:33:09 +0000[diff] [blame]165
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]166# These must be declared phony since there
167# are directories with matching names:
Greg Ward0862f802000-04-28 16:53:36 +0000[diff] [blame]168.PHONY: api doc ext lib mac ref tut inst dist
Fred Drake0c77cf12001-10-19 21:12:57 +0000[diff] [blame]169.PHONY: html info isilo
Fred Drake3f8a59f1998-07-24 13:58:27 +0000[diff] [blame]170
Fred Drakebbe33c51998-05-07 01:39:06 +0000[diff] [blame]171
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]172# Main target
Fred Drake38d53452002-05-25 20:28:46 +0000[diff] [blame]173default: html
174all: html dvi ps pdf isilo
Guido van Rossumeb8d5031996-08-09 21:46:05 +0000[diff] [blame]175
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]176dvi: $(DVIFILES)
177pdf: $(PDFFILES)
178ps: $(PSFILES)
Fred Drakee4837a11998-03-06 21:29:34 +0000[diff] [blame]179
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]180world: ps pdf html distfiles
Guido van Rossum20aca5a1991-01-25 13:29:04 +0000[diff] [blame]181
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]182
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]183# Rules to build PostScript and PDF formats
184.SUFFIXES: .dvi .ps
185
186.dvi.ps:
187 $(DVIPS) -o $@ $<
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]188
189
190# Targets for each document:
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]191# Python/C API Reference Manual
Fred Drake520b0092001-10-29 17:40:40 +0000[diff] [blame]192paper-$(PAPER)/api.dvi: $(ANNOAPIFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]193 cd paper-$(PAPER) && $(MKDVI) api.tex
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]194
Fred Drake520b0092001-10-29 17:40:40 +0000[diff] [blame]195paper-$(PAPER)/api.pdf: $(ANNOAPIFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]196 cd paper-$(PAPER) && $(MKPDF) api.tex
Fred Drake15087431999-03-16 16:11:27 +0000[diff] [blame]197
Fred Drake57b38ed2002-10-04 19:23:06 +0000[diff] [blame]198paper-$(PAPER)/api.tex: api/api.tex
199 cp api/api.tex $@
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]200
Fred Drake520b0092001-10-29 17:40:40 +0000[diff] [blame]201paper-$(PAPER)/abstract.tex: api/abstract.tex $(ANNOAPI)
202 $(PYTHON) $(TOOLSDIR)/anno-api.py -o $@ api/abstract.tex
203
204paper-$(PAPER)/concrete.tex: api/concrete.tex $(ANNOAPI)
205 $(PYTHON) $(TOOLSDIR)/anno-api.py -o $@ api/concrete.tex
206
207paper-$(PAPER)/exceptions.tex: api/exceptions.tex $(ANNOAPI)
208 $(PYTHON) $(TOOLSDIR)/anno-api.py -o $@ api/exceptions.tex
209
210paper-$(PAPER)/init.tex: api/init.tex $(ANNOAPI)
211 $(PYTHON) $(TOOLSDIR)/anno-api.py -o $@ api/init.tex
212
Fred Drake57b38ed2002-10-04 19:23:06 +0000[diff] [blame]213paper-$(PAPER)/intro.tex: api/intro.tex
214 cp api/intro.tex $@
Fred Drake520b0092001-10-29 17:40:40 +0000[diff] [blame]215
216paper-$(PAPER)/memory.tex: api/memory.tex $(ANNOAPI)
217 $(PYTHON) $(TOOLSDIR)/anno-api.py -o $@ api/memory.tex
218
219paper-$(PAPER)/newtypes.tex: api/newtypes.tex $(ANNOAPI)
220 $(PYTHON) $(TOOLSDIR)/anno-api.py -o $@ api/newtypes.tex
221
222paper-$(PAPER)/refcounting.tex: api/refcounting.tex $(ANNOAPI)
223 $(PYTHON) $(TOOLSDIR)/anno-api.py -o $@ api/refcounting.tex
224
225paper-$(PAPER)/utilities.tex: api/utilities.tex $(ANNOAPI)
226 $(PYTHON) $(TOOLSDIR)/anno-api.py -o $@ api/utilities.tex
227
228paper-$(PAPER)/veryhigh.tex: api/veryhigh.tex $(ANNOAPI)
229 $(PYTHON) $(TOOLSDIR)/anno-api.py -o $@ api/veryhigh.tex
230
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]231# Distributing Python Modules
232paper-$(PAPER)/dist.dvi: $(DISTFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]233 cd paper-$(PAPER) && $(MKDVI) ../dist/dist.tex
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]234
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]235paper-$(PAPER)/dist.pdf: $(DISTFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]236 cd paper-$(PAPER) && $(MKPDF) ../dist/dist.tex
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]237
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]238# Documenting Python
239paper-$(PAPER)/doc.dvi: $(DOCFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]240 cd paper-$(PAPER) && $(MKDVI) ../doc/doc.tex
Fred Drake3f8a59f1998-07-24 13:58:27 +0000[diff] [blame]241
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]242paper-$(PAPER)/doc.pdf: $(DOCFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]243 cd paper-$(PAPER) && $(MKPDF) ../doc/doc.tex
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]244
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]245# Extending and Embedding the Python Interpreter
246paper-$(PAPER)/ext.dvi: $(EXTFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]247 cd paper-$(PAPER) && $(MKDVI) ../ext/ext.tex
Greg Ward0862f802000-04-28 16:53:36 +0000[diff] [blame]248
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]249paper-$(PAPER)/ext.pdf: $(EXTFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]250 cd paper-$(PAPER) && $(MKPDF) ../ext/ext.tex
Greg Ward0862f802000-04-28 16:53:36 +0000[diff] [blame]251
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]252# Installing Python Modules
253paper-$(PAPER)/inst.dvi: $(INSTFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]254 cd paper-$(PAPER) && $(MKDVI) ../inst/inst.tex
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]255
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]256paper-$(PAPER)/inst.pdf: $(INSTFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]257 cd paper-$(PAPER) && $(MKPDF) ../inst/inst.tex
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]258
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]259# Python Library Reference
260paper-$(PAPER)/lib.dvi: $(LIBFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]261 cd paper-$(PAPER) && $(MKDVI) ../lib/lib.tex
Fred Drake15087431999-03-16 16:11:27 +0000[diff] [blame]262
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]263paper-$(PAPER)/lib.pdf: $(LIBFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]264 cd paper-$(PAPER) && $(MKPDF) ../lib/lib.tex
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]265
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]266# Macintosh Library Modules
267paper-$(PAPER)/mac.dvi: $(MACFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]268 cd paper-$(PAPER) && $(MKDVI) ../mac/mac.tex
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]269
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]270paper-$(PAPER)/mac.pdf: $(MACFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]271 cd paper-$(PAPER) && $(MKPDF) ../mac/mac.tex
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]272
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]273# Python Reference Manual
274paper-$(PAPER)/ref.dvi: $(REFFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]275 cd paper-$(PAPER) && $(MKDVI) ../ref/ref.tex
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]276
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]277paper-$(PAPER)/ref.pdf: $(REFFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]278 cd paper-$(PAPER) && $(MKPDF) ../ref/ref.tex
Fred Drakeddae4141998-02-17 15:45:25 +0000[diff] [blame]279
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]280# Python Tutorial
281paper-$(PAPER)/tut.dvi: $(TUTFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]282 cd paper-$(PAPER) && $(MKDVI) ../tut/tut.tex
Greg Ward0862f802000-04-28 16:53:36 +0000[diff] [blame]283
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]284paper-$(PAPER)/tut.pdf: $(TUTFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]285 cd paper-$(PAPER) && $(MKPDF) ../tut/tut.tex
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]286
Fred Drake9ac14de2002-03-26 19:18:18 +0000[diff] [blame]287# What's New in Python X.Y
Fred Drake4add68b2002-11-26 22:13:41 +0000[diff] [blame]288paper-$(PAPER)/$(WHATSNEW).dvi: whatsnew/$(WHATSNEW).tex
Fred Drake9ac14de2002-03-26 19:18:18 +0000[diff] [blame]289 cd paper-$(PAPER) && $(MKDVI) ../whatsnew/$(WHATSNEW).tex
290
Fred Drake4add68b2002-11-26 22:13:41 +0000[diff] [blame]291paper-$(PAPER)/$(WHATSNEW).pdf: whatsnew/$(WHATSNEW).tex
Fred Drake9ac14de2002-03-26 19:18:18 +0000[diff] [blame]292 cd paper-$(PAPER) && $(MKPDF) ../whatsnew/$(WHATSNEW).tex
293
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]294# The remaining part of the Makefile is concerned with various
Guido van Rossum73827c61995-03-20 13:00:32 +0000[diff] [blame]295# conversions, as described above. See also the README file.
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]296
Fred Drakeb9838d91998-05-08 15:43:08 +0000[diff] [blame]297info:
Fred Drakefa00f912003-07-16 04:01:04 +0000[diff] [blame]298 cd $(INFODIR) && $(MAKE) EMACS=$(EMACS) WHATSNEW=$(WHATSNEW)
Fred Drake5ad78f31998-02-22 19:47:13 +0000[diff] [blame]299
Guido van Rossum73827c61995-03-20 13:00:32 +0000[diff] [blame]300# Targets to convert the manuals to HTML using Nikos Drakos' LaTeX to
301# HTML converter. For more info on this program, see
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]302# <URL:http://cbl.leeds.ac.uk/nikos/tex2html/doc/latex2html/latex2html.html>.
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]303
Guido van Rossum9cb64801997-12-29 20:01:55 +0000[diff] [blame]304# Note that LaTeX2HTML inserts references to an icons directory in
305# each page that it generates. I have placed a copy of this directory
306# in the distribution to simplify the process of creating a
307# self-contained HTML distribution; for this purpose I have also added
308# a (trivial) index.html. Change the definition of $ICONSERVER in
Fred Drake9fab3aa1998-04-28 19:20:43 +0000[diff] [blame]309# perl/l2hinit.perl to use a different location for the icons directory.
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]310
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]311# If you have the standard LaTeX2HTML icons installed, the versions shipped
312# with this documentation should be stored in a separate directory and used
313# instead. The standard set does *not* include all the icons used in the
314# Python documentation.
Fred Drakebbe33c51998-05-07 01:39:06 +0000[diff] [blame]315
Fred Drake0099d8f2001-10-25 15:12:31 +0000[diff] [blame]316$(ALLCSSFILES): html/style.css
317 cp $< $@
318
Fred Drake5af41c52003-05-22 15:28:55 +0000[diff] [blame]319$(INDEXFILES): $(COMMONPERL) html/stdabout.dat tools/node2label.pl
Guido van Rossum6938f061994-08-01 12:22:53 +0000[diff] [blame]320
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]321html/acks.html: ACKS $(TOOLSDIR)/support.py $(TOOLSDIR)/mkackshtml
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]322 $(PYTHON) $(TOOLSDIR)/mkackshtml --address $(PYTHONDOCS) \
Fred Drakeb1510d52002-10-30 17:07:02 +0000[diff] [blame]323 --favicon icons/pyfav.gif \
Fred Draked27ed852001-02-22 23:06:21 +0000[diff] [blame]324 --output html/acks.html <ACKS
Guido van Rossum6938f061994-08-01 12:22:53 +0000[diff] [blame]325
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]326
327# html/index.html is dependent on $(INDEXFILES) since we want the date
328# on the front index to be updated whenever any of the child documents
329# are updated and boilerplate.tex uses \today as the date. The index
330# files are not used to actually generate content.
331
332BOILERPLATE=texinputs/boilerplate.tex
333html/index.html: $(INDEXFILES)
334html/index.html: html/index.html.in $(BOILERPLATE) tools/rewrite.py
Fred Drake4e526fe2002-03-26 20:29:11 +0000[diff] [blame]335 $(PYTHON) tools/rewrite.py $(BOILERPLATE) \
336 RELEASE=$(RELEASE) WHATSNEW=$(WHATSNEW) \
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]337 <$< >$@
338
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]339html/modindex.html: $(TOOLSDIR)/support.py $(TOOLSDIR)/mkmodindex
340html/modindex.html: html/lib/lib.html html/mac/mac.html
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]341 cd html && \
342 $(PYTHON) ../$(TOOLSDIR)/mkmodindex --columns 4 \
343 --output modindex.html --address $(PYTHONDOCS) \
Fred Drakeb1510d52002-10-30 17:07:02 +0000[diff] [blame]344 --favicon icons/pyfav.gif \
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]345 lib/modindex.html mac/modindex.html
Fred Drake7d5f5dd1999-03-18 19:08:47 +0000[diff] [blame]346
Fred Drake0099d8f2001-10-25 15:12:31 +0000[diff] [blame]347html: $(ALLHTMLFILES) $(HTMLCSSFILES)
Guido van Rossum970871f1993-02-21 20:10:26 +0000[diff] [blame]348
Fred Drake0099d8f2001-10-25 15:12:31 +0000[diff] [blame]349api: html/api/api.html html/api/api.css
Fred Drakedb2e3e32002-05-23 19:41:25 +0000[diff] [blame]350html/api/api.html: $(APIFILES) api/refcounts.dat
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]351 $(MKHTML) --dir html/api api/api.tex
Fred Drakea6bb3961998-05-06 19:51:39 +0000[diff] [blame]352
Fred Drake0099d8f2001-10-25 15:12:31 +0000[diff] [blame]353doc: html/doc/doc.html html/doc/doc.css
354html/doc/doc.html: $(DOCFILES)
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]355 $(MKHTML) --dir html/doc doc/doc.tex
Fred Drakecdbd3911998-05-15 17:02:10 +0000[diff] [blame]356
Fred Drake0099d8f2001-10-25 15:12:31 +0000[diff] [blame]357ext: html/ext/ext.html html/ext/ext.css
358html/ext/ext.html: $(EXTFILES)
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]359 $(MKHTML) --dir html/ext ext/ext.tex
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]360
Fred Drake0099d8f2001-10-25 15:12:31 +0000[diff] [blame]361lib: html/lib/lib.html html/lib/lib.css
362html/lib/lib.html: $(LIBFILES)
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]363 $(MKHTML) --dir html/lib lib/lib.tex
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]364
Fred Drake0099d8f2001-10-25 15:12:31 +0000[diff] [blame]365mac: html/mac/mac.html html/mac/mac.css
366html/mac/mac.html: $(MACFILES)
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]367 $(MKHTML) --dir html/mac mac/mac.tex
Greg Ward0862f802000-04-28 16:53:36 +0000[diff] [blame]368
Fred Drake0099d8f2001-10-25 15:12:31 +0000[diff] [blame]369ref: html/ref/ref.html html/ref/ref.css
370html/ref/ref.html: $(REFFILES)
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]371 $(MKHTML) --dir html/ref ref/ref.tex
Greg Ward0862f802000-04-28 16:53:36 +0000[diff] [blame]372
Fred Drake0099d8f2001-10-25 15:12:31 +0000[diff] [blame]373tut: html/tut/tut.html html/tut/tut.css
374html/tut/tut.html: $(TUTFILES)
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]375 $(MKHTML) --dir html/tut --numeric --split 3 tut/tut.tex
376
Fred Drake0099d8f2001-10-25 15:12:31 +0000[diff] [blame]377inst: html/inst/inst.html html/inst/inst.css
378html/inst/inst.html: $(INSTFILES) perl/distutils.perl
Fred Drake8c011582001-03-01 18:38:56 +0000[diff] [blame]379 $(MKHTML) --dir html/inst --split 4 inst/inst.tex
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]380
Fred Drake0099d8f2001-10-25 15:12:31 +0000[diff] [blame]381dist: html/dist/dist.html html/dist/dist.css
382html/dist/dist.html: $(DISTFILES) perl/distutils.perl
Fred Drake8c011582001-03-01 18:38:56 +0000[diff] [blame]383 $(MKHTML) --dir html/dist --split 4 dist/dist.tex
Fred Drakee7a8c972000-04-07 16:27:15 +0000[diff] [blame]384
Fred Drake9ac14de2002-03-26 19:18:18 +0000[diff] [blame]385whatsnew: html/whatsnew/$(WHATSNEW).html
386html/whatsnew/$(WHATSNEW).html: whatsnew/$(WHATSNEW).tex
387 $(MKHTML) --dir html/whatsnew --split 4 whatsnew/$(WHATSNEW).tex
388
Guido van Rossum9231c8f1997-05-15 21:43:21 +0000[diff] [blame]389
Fred Drake0c77cf12001-10-19 21:12:57 +0000[diff] [blame]390# The iSilo format is used by the iSilo document reader for PalmOS devices.
391
392ISILOINDEXFILES=isilo/api/api.html \
393 isilo/doc/doc.html \
394 isilo/ext/ext.html \
395 isilo/lib/lib.html \
396 isilo/mac/mac.html \
397 isilo/ref/ref.html \
398 isilo/tut/tut.html \
399 isilo/inst/inst.html \
Fred Drake30140862002-03-26 19:53:56 +0000[diff] [blame]400 isilo/dist/dist.html \
401 isilo/whatsnew/$(WHATSNEW).html
Fred Drake0c77cf12001-10-19 21:12:57 +0000[diff] [blame]402
Fred Drake5af41c52003-05-22 15:28:55 +0000[diff] [blame]403$(ISILOINDEXFILES): $(COMMONPERL) html/stdabout.dat perl/isilo.perl
Fred Drake0c77cf12001-10-19 21:12:57 +0000[diff] [blame]404
Fred Drake1a0199a2002-08-09 20:20:50 +0000[diff] [blame]405isilo: isilo/python-api.pdb \
406 isilo/python-doc.pdb \
407 isilo/python-ext.pdb \
408 isilo/python-lib.pdb \
409 isilo/python-mac.pdb \
410 isilo/python-ref.pdb \
411 isilo/python-tut.pdb \
412 isilo/python-dist.pdb \
413 isilo/python-inst.pdb \
414 isilo/python-whatsnew.pdb
Fred Drake0c77cf12001-10-19 21:12:57 +0000[diff] [blame]415
Fred Drake1a0199a2002-08-09 20:20:50 +0000[diff] [blame]416isilo/python-api.pdb: isilo/api/api.html isilo/api/api.css
Fred Drake0c77cf12001-10-19 21:12:57 +0000[diff] [blame]417 $(MKISILO) "-iPython/C API Reference Manual" \
418 isilo/api/api.html $@
419
Fred Drake1a0199a2002-08-09 20:20:50 +0000[diff] [blame]420isilo/python-doc.pdb: isilo/doc/doc.html isilo/doc/doc.css
Fred Drake0c77cf12001-10-19 21:12:57 +0000[diff] [blame]421 $(MKISILO) "-iDocumenting Python" \
422 isilo/doc/doc.html $@
423
Fred Drake1a0199a2002-08-09 20:20:50 +0000[diff] [blame]424isilo/python-ext.pdb: isilo/ext/ext.html isilo/ext/ext.css
Fred Drake0c77cf12001-10-19 21:12:57 +0000[diff] [blame]425 $(MKISILO) "-iExtending & Embedding Python" \
426 isilo/ext/ext.html $@
427
Fred Drake1a0199a2002-08-09 20:20:50 +0000[diff] [blame]428isilo/python-lib.pdb: isilo/lib/lib.html isilo/lib/lib.css
Fred Drake0c77cf12001-10-19 21:12:57 +0000[diff] [blame]429 $(MKISILO) "-iPython Library Reference" \
430 isilo/lib/lib.html $@
431
Fred Drake1a0199a2002-08-09 20:20:50 +0000[diff] [blame]432isilo/python-mac.pdb: isilo/mac/mac.html isilo/mac/mac.css
Fred Drake0c77cf12001-10-19 21:12:57 +0000[diff] [blame]433 $(MKISILO) "-iPython/C API Reference Manual" \
434 isilo/mac/mac.html $@
435
Fred Drake1a0199a2002-08-09 20:20:50 +0000[diff] [blame]436isilo/python-ref.pdb: isilo/ref/ref.html isilo/ref/ref.css
Fred Drake0c77cf12001-10-19 21:12:57 +0000[diff] [blame]437 $(MKISILO) "-iPython Reference Manual" \
438 isilo/ref/ref.html $@
439
Fred Drake1a0199a2002-08-09 20:20:50 +0000[diff] [blame]440isilo/python-tut.pdb: isilo/tut/tut.html isilo/tut/tut.css
Fred Drake0c77cf12001-10-19 21:12:57 +0000[diff] [blame]441 $(MKISILO) "-iPython Tutorial" \
442 isilo/tut/tut.html $@
443
Fred Drake1a0199a2002-08-09 20:20:50 +0000[diff] [blame]444isilo/python-dist.pdb: isilo/dist/dist.html isilo/dist/dist.css
Fred Drake0c77cf12001-10-19 21:12:57 +0000[diff] [blame]445 $(MKISILO) "-iDistributing Python Modules" \
446 isilo/dist/dist.html $@
447
Fred Drake1a0199a2002-08-09 20:20:50 +0000[diff] [blame]448isilo/python-inst.pdb: isilo/inst/inst.html isilo/inst/inst.css
Fred Drake0c77cf12001-10-19 21:12:57 +0000[diff] [blame]449 $(MKISILO) "-iInstalling Python Modules" \
450 isilo/inst/inst.html $@
451
Fred Drake1a0199a2002-08-09 20:20:50 +0000[diff] [blame]452isilo/python-whatsnew.pdb: isilo/whatsnew/$(WHATSNEW).html isilo/whatsnew/$(WHATSNEW).css
Fred Drake30140862002-03-26 19:53:56 +0000[diff] [blame]453 $(MKISILO) "-iWhat's New in Python X.Y" \
454 isilo/whatsnew/$(WHATSNEW).html $@
455
Fred Drakedb2e3e32002-05-23 19:41:25 +0000[diff] [blame]456isilo/api/api.html: $(APIFILES) api/refcounts.dat
Fred Drake0c77cf12001-10-19 21:12:57 +0000[diff] [blame]457 $(MKISILOHTML) --dir isilo/api api/api.tex
458
459isilo/doc/doc.html: $(DOCFILES)
460 $(MKISILOHTML) --dir isilo/doc doc/doc.tex
461
462isilo/ext/ext.html: $(EXTFILES)
463 $(MKISILOHTML) --dir isilo/ext ext/ext.tex
464
465isilo/lib/lib.html: $(LIBFILES)
466 $(MKISILOHTML) --dir isilo/lib lib/lib.tex
467
468isilo/mac/mac.html: $(MACFILES)
469 $(MKISILOHTML) --dir isilo/mac mac/mac.tex
470
471isilo/ref/ref.html: $(REFFILES)
472 $(MKISILOHTML) --dir isilo/ref ref/ref.tex
473
474isilo/tut/tut.html: $(TUTFILES)
475 $(MKISILOHTML) --dir isilo/tut tut/tut.tex
476
477isilo/inst/inst.html: $(INSTFILES) perl/distutils.perl
478 $(MKISILOHTML) --dir isilo/inst inst/inst.tex
479
480isilo/dist/dist.html: $(DISTFILES) perl/distutils.perl
481 $(MKISILOHTML) --dir isilo/dist dist/dist.tex
482
Fred Drake9ac14de2002-03-26 19:18:18 +0000[diff] [blame]483isilo/whatsnew/$(WHATSNEW).html: whatsnew/$(WHATSNEW).tex
484 $(MKISILOHTML) --dir isilo/whatsnew whatsnew/$(WHATSNEW).tex
485
Fred Drake0c77cf12001-10-19 21:12:57 +0000[diff] [blame]486# These are useful if you need to transport the iSilo-ready HTML to
487# another machine to perform the conversion:
488
489isilozip: isilo-html-$(RELEASE).zip
490
491isilo-html-$(RELEASE).zip: $(ISILOINDEXFILES)
492 rm -f $@
493 cd isilo && \
494 zip -q -9 ../$@ */*.css */*.html */*.txt
495
496
Fred Drakee4837a11998-03-06 21:29:34 +0000[diff] [blame]497# webchecker needs an extra flag to process the huge index from the libref
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]498WEBCHECKER=$(PYTHON) ../Tools/webchecker/webchecker.py
499HTMLBASE= file:`pwd`/html
500
Fred Drake5afb5e52001-07-18 21:17:29 +0000[diff] [blame]501webcheck: $(ALLHTMLFILES)
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]502 $(WEBCHECKER) $(HTMLBASE)/api/
503 $(WEBCHECKER) $(HTMLBASE)/doc/
504 $(WEBCHECKER) $(HTMLBASE)/ext/
505 $(WEBCHECKER) -m290000 $(HTMLBASE)/lib/
506 $(WEBCHECKER) $(HTMLBASE)/mac/
507 $(WEBCHECKER) $(HTMLBASE)/ref/
508 $(WEBCHECKER) $(HTMLBASE)/tut/
509 $(WEBCHECKER) $(HTMLBASE)/dist/
510 $(WEBCHECKER) $(HTMLBASE)/inst/
Fred Drake30140862002-03-26 19:53:56 +0000[diff] [blame]511 $(WEBCHECKER) $(HTMLBASE)/whatsnew/
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]512
Fred Drake5afb5e52001-07-18 21:17:29 +0000[diff] [blame]513fastwebcheck: $(ALLHTMLFILES)
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]514 $(WEBCHECKER) -x $(HTMLBASE)/api/
515 $(WEBCHECKER) -x $(HTMLBASE)/doc/
516 $(WEBCHECKER) -x $(HTMLBASE)/ext/
517 $(WEBCHECKER) -x -m290000 $(HTMLBASE)/lib/
518 $(WEBCHECKER) -x $(HTMLBASE)/mac/
519 $(WEBCHECKER) -x $(HTMLBASE)/ref/
520 $(WEBCHECKER) -x $(HTMLBASE)/tut/
521 $(WEBCHECKER) -x $(HTMLBASE)/dist/
522 $(WEBCHECKER) -x $(HTMLBASE)/inst/
Fred Drake30140862002-03-26 19:53:56 +0000[diff] [blame]523 $(WEBCHECKER) -x $(HTMLBASE)/whatsnew/
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]524
525
526# Release packaging targets:
Fred Drakee4837a11998-03-06 21:29:34 +0000[diff] [blame]527
Fred Drake5afb5e52001-07-18 21:17:29 +0000[diff] [blame]528paper-$(PAPER)/README: $(PSFILES) $(TOOLSDIR)/getpagecounts
Fred Drake3d0b6972002-04-17 03:31:08 +0000[diff] [blame]529 cd paper-$(PAPER) && ../$(TOOLSDIR)/getpagecounts -r $(RELEASE) >../$@
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]530
Fred Drakeb6584ca1999-01-08 15:49:45 +0000[diff] [blame]531info-$(RELEASE).tgz: info
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]532 cd $(INFODIR) && tar cf - README python.dir python-*.info* \
Fred Drakede7cdb22003-07-17 11:55:18 +0000[diff] [blame]533 | gzip -9 >../$@
Fred Drakea7998351998-02-19 16:01:04 +0000[diff] [blame]534
Fred Drake4ef3ea01999-07-27 16:30:59 +0000[diff] [blame]535info-$(RELEASE).tar.bz2: info
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]536 cd $(INFODIR) && tar cf - README python.dir python-*.info* \
Fred Drakede7cdb22003-07-17 11:55:18 +0000[diff] [blame]537 | bzip2 -9 >../$@
Fred Drake4ef3ea01999-07-27 16:30:59 +0000[diff] [blame]538
Fred Drakee34ab301998-05-11 21:10:15 +0000[diff] [blame]539latex-$(RELEASE).tgz:
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]540 $(PYTHON) $(TOOLSDIR)/mksourcepkg --gzip $(RELEASE)
Fred Drakee61d7af1998-03-05 16:37:34 +0000[diff] [blame]541
Fred Drake4ef3ea01999-07-27 16:30:59 +0000[diff] [blame]542latex-$(RELEASE).tar.bz2:
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]543 $(PYTHON) $(TOOLSDIR)/mksourcepkg --bzip2 $(RELEASE)
Fred Drake4ef3ea01999-07-27 16:30:59 +0000[diff] [blame]544
Fred Drake7dcc69a1999-07-23 16:11:36 +0000[diff] [blame]545latex-$(RELEASE).zip:
Fred Drake02ba6212000-04-04 20:58:25 +0000[diff] [blame]546 rm -f $@
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]547 $(PYTHON) $(TOOLSDIR)/mksourcepkg --zip $(RELEASE)
Fred Drake7dcc69a1999-07-23 16:11:36 +0000[diff] [blame]548
Fred Drake5afb5e52001-07-18 21:17:29 +0000[diff] [blame]549pdf-$(PAPER)-$(RELEASE).tar: $(PDFFILES)
Fred Drake1a0199a2002-08-09 20:20:50 +0000[diff] [blame]550 rm -f $@
551 mkdir Python-Docs-$(RELEASE)
552 cp paper-$(PAPER)/*.pdf Python-Docs-$(RELEASE)
553 tar cf $@ Python-Docs-$(RELEASE)
554 rm -r Python-Docs-$(RELEASE)
Fred Drake04cf4dc1998-02-12 22:33:50 +0000[diff] [blame]555
Fred Drake5afb5e52001-07-18 21:17:29 +0000[diff] [blame]556pdf-$(PAPER)-$(RELEASE).tgz: pdf-$(PAPER)-$(RELEASE).tar
557 gzip -9 <$? >$@
558
559pdf-$(PAPER)-$(RELEASE).tar.bz2: pdf-$(PAPER)-$(RELEASE).tar
560 bzip2 -9 <$? >$@
Fred Drake4ef3ea01999-07-27 16:30:59 +0000[diff] [blame]561
Fred Drake7dcc69a1999-07-23 16:11:36 +0000[diff] [blame]562pdf-$(PAPER)-$(RELEASE).zip: pdf
Fred Drake02ba6212000-04-04 20:58:25 +0000[diff] [blame]563 rm -f $@
Fred Drake1a0199a2002-08-09 20:20:50 +0000[diff] [blame]564 mkdir Python-Docs-$(RELEASE)
565 cp paper-$(PAPER)/*.pdf Python-Docs-$(RELEASE)
566 zip -q -r -9 $@ Python-Docs-$(RELEASE)
567 rm -r Python-Docs-$(RELEASE)
Fred Drake7dcc69a1999-07-23 16:11:36 +0000[diff] [blame]568
Fred Drake5afb5e52001-07-18 21:17:29 +0000[diff] [blame]569postscript-$(PAPER)-$(RELEASE).tar: $(PSFILES) paper-$(PAPER)/README
Fred Drake1a0199a2002-08-09 20:20:50 +0000[diff] [blame]570 rm -f $@
571 mkdir Python-Docs-$(RELEASE)
572 cp paper-$(PAPER)/*.ps Python-Docs-$(RELEASE)
573 cp paper-$(PAPER)/README Python-Docs-$(RELEASE)
574 tar cf $@ Python-Docs-$(RELEASE)
575 rm -r Python-Docs-$(RELEASE)
Fred Drake04cf4dc1998-02-12 22:33:50 +0000[diff] [blame]576
Fred Drake5afb5e52001-07-18 21:17:29 +0000[diff] [blame]577postscript-$(PAPER)-$(RELEASE).tar.bz2: postscript-$(PAPER)-$(RELEASE).tar
578 bzip2 -9 <$< >$@
Fred Drake4ef3ea01999-07-27 16:30:59 +0000[diff] [blame]579
Fred Drake5afb5e52001-07-18 21:17:29 +0000[diff] [blame]580postscript-$(PAPER)-$(RELEASE).tgz: postscript-$(PAPER)-$(RELEASE).tar
581 gzip -9 <$< >$@
582
583postscript-$(PAPER)-$(RELEASE).zip: $(PSFILES) paper-$(PAPER)/README
Fred Drake02ba6212000-04-04 20:58:25 +0000[diff] [blame]584 rm -f $@
Fred Drake1a0199a2002-08-09 20:20:50 +0000[diff] [blame]585 mkdir Python-Docs-$(RELEASE)
586 cp paper-$(PAPER)/*.ps Python-Docs-$(RELEASE)
587 cp paper-$(PAPER)/README Python-Docs-$(RELEASE)
588 zip -q -r -9 $@ Python-Docs-$(RELEASE)
589 rm -r Python-Docs-$(RELEASE)
590
591HTMLPKGFILES=*.html */*.css */*.html */*.gif */*.txt
Fred Drake7dcc69a1999-07-23 16:11:36 +0000[diff] [blame]592
Fred Drake0099d8f2001-10-25 15:12:31 +0000[diff] [blame]593html-$(RELEASE).tar: $(ALLHTMLFILES) $(HTMLCSSFILES)
Fred Drake1a0199a2002-08-09 20:20:50 +0000[diff] [blame]594 mkdir Python-Docs-$(RELEASE)
595 cd html && tar cf ../temp.tar $(HTMLPKGFILES)
596 cd Python-Docs-$(RELEASE) && tar xf ../temp.tar
597 rm temp.tar
598 tar cf html-$(RELEASE).tar Python-Docs-$(RELEASE)
599 rm -r Python-Docs-$(RELEASE)
Fred Drake33d05b91998-01-13 16:33:09 +0000[diff] [blame]600
Fred Drake8f65aef2001-07-17 23:35:46 +0000[diff] [blame]601html-$(RELEASE).tgz: html-$(RELEASE).tar
Fred Drake5afb5e52001-07-18 21:17:29 +0000[diff] [blame]602 gzip -9 <$? >$@
Fred Drake8f65aef2001-07-17 23:35:46 +0000[diff] [blame]603
604html-$(RELEASE).tar.bz2: html-$(RELEASE).tar
Fred Drake5afb5e52001-07-18 21:17:29 +0000[diff] [blame]605 bzip2 -9 <$? >$@
Fred Drake4ef3ea01999-07-27 16:30:59 +0000[diff] [blame]606
Fred Drake0099d8f2001-10-25 15:12:31 +0000[diff] [blame]607html-$(RELEASE).zip: $(ALLHTMLFILES) $(HTMLCSSFILES)
Fred Drake02ba6212000-04-04 20:58:25 +0000[diff] [blame]608 rm -f $@
Fred Drake1a0199a2002-08-09 20:20:50 +0000[diff] [blame]609 mkdir Python-Docs-$(RELEASE)
610 cd html && tar cf ../temp.tar $(HTMLPKGFILES)
611 cd Python-Docs-$(RELEASE) && tar xf ../temp.tar
612 rm temp.tar
613 zip -q -r -9 $@ Python-Docs-$(RELEASE)
614 rm -r Python-Docs-$(RELEASE)
Fred Drake7dcc69a1999-07-23 16:11:36 +0000[diff] [blame]615
Fred Drake0c77cf12001-10-19 21:12:57 +0000[diff] [blame]616isilo-$(RELEASE).zip: isilo
Fred Drake1a0199a2002-08-09 20:20:50 +0000[diff] [blame]617 rm -f $@
618 mkdir Python-Docs-$(RELEASE)
619 cp isilo/python-*.pdb Python-Docs-$(RELEASE)
620 zip -q -r -9 $@ Python-Docs-$(RELEASE)
621 rm -r Python-Docs-$(RELEASE)
Fred Drake0c77cf12001-10-19 21:12:57 +0000[diff] [blame]622
623
Fred Drakea7998351998-02-19 16:01:04 +0000[diff] [blame]624# convenience targets:
625
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]626tarhtml: html-$(RELEASE).tgz
Fred Drakeb6584ca1999-01-08 15:49:45 +0000[diff] [blame]627tarinfo: info-$(RELEASE).tgz
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]628tarps: postscript-$(PAPER)-$(RELEASE).tgz
629tarpdf: pdf-$(PAPER)-$(RELEASE).tgz
630tarlatex: latex-$(RELEASE).tgz
Fred Drakebbe33c51998-05-07 01:39:06 +0000[diff] [blame]631
Fred Drake83c09831999-08-02 20:20:14 +0000[diff] [blame]632tarballs: tarpdf tarps tarhtml
Guido van Rossum84cca441997-11-25 20:49:09 +0000[diff] [blame]633
Fred Drake7dcc69a1999-07-23 16:11:36 +0000[diff] [blame]634ziphtml: html-$(RELEASE).zip
635zipps: postscript-$(PAPER)-$(RELEASE).zip
636zippdf: pdf-$(PAPER)-$(RELEASE).zip
637ziplatex: latex-$(RELEASE).zip
Fred Drake0c77cf12001-10-19 21:12:57 +0000[diff] [blame]638zipisilo: isilo-$(RELEASE).zip
Fred Drake7dcc69a1999-07-23 16:11:36 +0000[diff] [blame]639
Fred Drakeb906d2e2000-07-01 02:37:37 +0000[diff] [blame]640zips: zippdf zipps ziphtml
Fred Drake7dcc69a1999-07-23 16:11:36 +0000[diff] [blame]641
Fred Drake4ef3ea01999-07-27 16:30:59 +0000[diff] [blame]642bziphtml: html-$(RELEASE).tar.bz2
643bzipinfo: info-$(RELEASE).tar.bz2
644bzipps: postscript-$(PAPER)-$(RELEASE).tar.bz2
645bzippdf: pdf-$(PAPER)-$(RELEASE).tar.bz2
646bziplatex: latex-$(RELEASE).tar.bz2
647
Fred Drake83c09831999-08-02 20:20:14 +0000[diff] [blame]648bzips: bzippdf bzipps bziphtml
Fred Drake4ef3ea01999-07-27 16:30:59 +0000[diff] [blame]649
Fred Drakefc4ee0a2001-04-13 18:00:23 +0000[diff] [blame]650disthtml: tarhtml bziphtml ziphtml
651distinfo: tarinfo bzipinfo
652distps: tarps bzipps zipps
653distpdf: tarpdf bzippdf zippdf
654distlatex: tarlatex bziplatex ziplatex
655
Fred Drake5afb5e52001-07-18 21:17:29 +0000[diff] [blame]656paperdist: distpdf distps
Fred Drake0106e1d2003-07-17 15:29:16 +0000[diff] [blame]657edist: disthtml distinfo zipisilo
Fred Drake5afb5e52001-07-18 21:17:29 +0000[diff] [blame]658
Fred Drakede7cdb22003-07-17 11:55:18 +0000[diff] [blame]659pkglist:
660 $(TOOLSDIR)/mkpkglist >pkglist.html
661
Fred Drake5afb5e52001-07-18 21:17:29 +0000[diff] [blame]662distfiles: paperdist edist
Fred Drake88634602001-01-25 17:32:51 +0000[diff] [blame]663 $(TOOLSDIR)/mksourcepkg --all $(RELEASE)
Fred Drake444e4342003-04-23 15:04:52 +0000[diff] [blame]664 $(TOOLSDIR)/mkpkglist >pkglist.html
Fred Drake4ef3ea01999-07-27 16:30:59 +0000[diff] [blame]665
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]666
667# Housekeeping targets
668
Guido van Rossum9231c8f1997-05-15 21:43:21 +0000[diff] [blame]669# Remove temporary files; all except the following:
Fred Drake6659c301998-03-03 22:02:19 +0000[diff] [blame]670# - sources: .tex, .bib, .sty, *.cls
Fred Drake04cf4dc1998-02-12 22:33:50 +0000[diff] [blame]671# - useful results: .dvi, .pdf, .ps, .texi, .info
Fred Drakee4837a11998-03-06 21:29:34 +0000[diff] [blame]672clean:
Fred Drake8f65aef2001-07-17 23:35:46 +0000[diff] [blame]673 rm -f html-$(RELEASE).tar
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]674 cd $(INFODIR) && $(MAKE) clean
Guido van Rossum5b343731992-07-07 09:06:34 +0000[diff] [blame]675
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]676# Remove temporaries as well as final products
Fred Drakeb6584ca1999-01-08 15:49:45 +0000[diff] [blame]677clobber:
Fred Drake8f65aef2001-07-17 23:35:46 +0000[diff] [blame]678 rm -f html-$(RELEASE).tar
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]679 rm -f html-$(RELEASE).tgz info-$(RELEASE).tgz
680 rm -f pdf-$(RELEASE).tgz postscript-$(RELEASE).tgz
Fred Drake7dcc69a1999-07-23 16:11:36 +0000[diff] [blame]681 rm -f latex-$(RELEASE).tgz html-$(RELEASE).zip
682 rm -f pdf-$(RELEASE).zip postscript-$(RELEASE).zip
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]683 rm -f $(DVIFILES) $(PSFILES) $(PDFFILES)
Fred Drake1385a572001-07-17 16:53:19 +0000[diff] [blame]684 cd $(INFODIR) && $(MAKE) clobber
Fred Drake210d3cc2002-02-04 19:49:29 +0000[diff] [blame]685 rm -f paper-$(PAPER)/*.tex paper-$(PAPER)/*.ind paper-$(PAPER)/*.idx
686 rm -f paper-$(PAPER)/*.l2h paper-$(PAPER)/*.how paper-$(PAPER)/README
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]687 rm -rf html/index.html html/modindex.html html/acks.html
688 rm -rf html/api/ html/doc/ html/ext/ html/lib/ html/mac/
689 rm -rf html/ref/ html/tut/ html/inst/ html/dist/
Fred Drake30140862002-03-26 19:53:56 +0000[diff] [blame]690 rm -rf html/whatsnew/
Fred Drake0c77cf12001-10-19 21:12:57 +0000[diff] [blame]691 rm -rf isilo/api/ isilo/doc/ isilo/ext/ isilo/lib/ isilo/mac/
692 rm -rf isilo/ref/ isilo/tut/ isilo/inst/ isilo/dist/
Fred Drake30140862002-03-26 19:53:56 +0000[diff] [blame]693 rm -rf isilo/whatsnew/
Fred Drake1a0199a2002-08-09 20:20:50 +0000[diff] [blame]694 rm -f isilo/python-*.pdb isilo-$(RELEASE).zip
Fred Drake5ad78f31998-02-22 19:47:13 +0000[diff] [blame]695
Fred Drakef6bfe8e2001-02-19 19:19:26 +0000[diff] [blame]696realclean distclean: clobber