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