Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / cpython3 / 3a045e8993bb28837a6a132be2cd9ad8dd45c997 / . / Doc / Makefile
blob: 013307c80370dd201b85c874829f010bc16066a6 [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 Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]52# in the info/ directory; please send patches to python-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]64HTMLDIR= html
65INFODIR= info
66TOOLSDIR= tools
67
Fred Drake860e2561999-07-12 16:52:50 +0000[diff] [blame]68# This is the *documentation* release, and is used to construct the file
69# names of the downloadable tarballs.
Fred Drake91eb3e82000-10-13 15:35:27 +0000[diff] [blame]70RELEASE=2.0
Fred Drake860e2561999-07-12 16:52:50 +0000[diff] [blame]71
Fred Drake33d05b91998-01-13 16:33:09 +0000[diff] [blame]72
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]73# These must be declared phony since there
74# are directories with matching names:
Greg Ward0862f802000-04-28 16:53:36 +0000[diff] [blame]75.PHONY: api doc ext lib mac ref tut inst dist
Fred Drakee7a8c972000-04-07 16:27:15 +0000[diff] [blame]76.PHONY: html info longhtml
Fred Drake3f8a59f1998-07-24 13:58:27 +0000[diff] [blame]77
Fred Drakebbe33c51998-05-07 01:39:06 +0000[diff] [blame]78
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]79# Main target
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame^]80all: html
Guido van Rossumeb8d5031996-08-09 21:46:05 +0000[diff] [blame]81
Fred Drake34116ba1998-07-24 15:42:12 +0000[diff] [blame]82dvi:
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]83 (cd paper-$(PAPER); $(MAKE) dvi)
Fred Drakee4837a11998-03-06 21:29:34 +0000[diff] [blame]84
Fred Drake34116ba1998-07-24 15:42:12 +0000[diff] [blame]85pdf:
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]86 (cd paper-$(PAPER); $(MAKE) pdf)
Guido van Rossum20aca5a1991-01-25 13:29:04 +0000[diff] [blame]87
Fred Drake34116ba1998-07-24 15:42:12 +0000[diff] [blame]88ps:
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]89 (cd paper-$(PAPER); $(MAKE) ps)
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]90
Fred Drake34116ba1998-07-24 15:42:12 +0000[diff] [blame]91world: ps pdf html tarballs
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]92
93
94# Targets for each document:
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame^]95api.ps:
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]96 (cd paper-$(PAPER); $(MAKE) api.ps)
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]97
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame^]98doc.ps:
Fred Drake15087431999-03-16 16:11:27 +0000[diff] [blame]99 (cd paper-$(PAPER); $(MAKE) doc.ps)
100
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame^]101ext.ps:
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]102 (cd paper-$(PAPER); $(MAKE) ext.ps)
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]103
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame^]104lib.ps:
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]105 (cd paper-$(PAPER); $(MAKE) lib.ps)
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]106
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame^]107mac.ps:
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]108 (cd paper-$(PAPER); $(MAKE) mac.ps)
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]109
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame^]110ref.ps:
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]111 (cd paper-$(PAPER); $(MAKE) ref.ps)
Fred Drake3f8a59f1998-07-24 13:58:27 +0000[diff] [blame]112
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame^]113tut.ps:
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]114 (cd paper-$(PAPER); $(MAKE) tut.ps)
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]115
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame^]116inst.ps:
Greg Ward0862f802000-04-28 16:53:36 +0000[diff] [blame]117 (cd paper-$(PAPER); $(MAKE) inst.ps)
118
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame^]119dist.ps:
Greg Ward0862f802000-04-28 16:53:36 +0000[diff] [blame]120 (cd paper-$(PAPER); $(MAKE) dist.ps)
121
Fred Draked69e2c41998-05-11 18:25:46 +0000[diff] [blame]122
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]123api.dvi:
124 (cd paper-$(PAPER); $(MAKE) api.dvi)
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]125
Fred Drake15087431999-03-16 16:11:27 +0000[diff] [blame]126doc.dvi:
127 (cd paper-$(PAPER); $(MAKE) doc.dvi)
128
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]129ext.dvi:
130 (cd paper-$(PAPER); $(MAKE) ext.dvi)
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]131
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]132lib.dvi:
133 (cd paper-$(PAPER); $(MAKE) lib.dvi)
134
135mac.dvi:
136 (cd paper-$(PAPER); $(MAKE) mac.dvi)
137
138ref.dvi:
139 (cd paper-$(PAPER); $(MAKE) ref.dvi)
140
141tut.dvi:
142 (cd paper-$(PAPER); $(MAKE) tut.dvi)
Fred Drakeddae4141998-02-17 15:45:25 +0000[diff] [blame]143
Greg Ward0862f802000-04-28 16:53:36 +0000[diff] [blame]144inst.dvi:
145 (cd paper-$(PAPER); $(MAKE) inst.dvi)
146
147dist.dvi:
148 (cd paper-$(PAPER); $(MAKE) dist.dvi)
149
Fred Drakedd946761998-02-18 16:02:14 +0000[diff] [blame]150
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]151api.pdf:
152 (cd paper-$(PAPER); $(MAKE) api.pdf)
Fred Drake126d8401998-02-04 19:54:40 +0000[diff] [blame]153
Fred Drake15087431999-03-16 16:11:27 +0000[diff] [blame]154doc.pdf:
155 (cd paper-$(PAPER); $(MAKE) doc.pdf)
156
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]157ext.pdf:
158 (cd paper-$(PAPER); $(MAKE) ext.pdf)
Fred Drake126d8401998-02-04 19:54:40 +0000[diff] [blame]159
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]160lib.pdf:
161 (cd paper-$(PAPER); $(MAKE) lib.pdf)
Fred Drake126d8401998-02-04 19:54:40 +0000[diff] [blame]162
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]163mac.pdf:
164 (cd paper-$(PAPER); $(MAKE) mac.pdf)
Fred Drake3b26eed1998-02-16 17:06:10 +0000[diff] [blame]165
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]166ref.pdf:
167 (cd paper-$(PAPER); $(MAKE) ref.pdf)
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]168
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]169tut.pdf:
170 (cd paper-$(PAPER); $(MAKE) tut.pdf)
Fred Drakef2951131998-05-07 19:30:16 +0000[diff] [blame]171
Greg Ward0862f802000-04-28 16:53:36 +0000[diff] [blame]172inst.pdf:
173 (cd paper-$(PAPER); $(MAKE) inst.pdf)
174
175dist.pdf:
176 (cd paper-$(PAPER); $(MAKE) dist.pdf)
177
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]178
179# The remaining part of the Makefile is concerned with various
Guido van Rossum73827c61995-03-20 13:00:32 +0000[diff] [blame]180# conversions, as described above. See also the README file.
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]181
Fred Drakeb9838d91998-05-08 15:43:08 +0000[diff] [blame]182info:
183 (cd $(INFODIR); $(MAKE))
Fred Drake5ad78f31998-02-22 19:47:13 +0000[diff] [blame]184
Guido van Rossum73827c61995-03-20 13:00:32 +0000[diff] [blame]185# Targets to convert the manuals to HTML using Nikos Drakos' LaTeX to
186# HTML converter. For more info on this program, see
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]187# <URL:http://cbl.leeds.ac.uk/nikos/tex2html/doc/latex2html/latex2html.html>.
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]188
Guido van Rossum9cb64801997-12-29 20:01:55 +0000[diff] [blame]189# Note that LaTeX2HTML inserts references to an icons directory in
190# each page that it generates. I have placed a copy of this directory
191# in the distribution to simplify the process of creating a
192# self-contained HTML distribution; for this purpose I have also added
193# a (trivial) index.html. Change the definition of $ICONSERVER in
Fred Drake9fab3aa1998-04-28 19:20:43 +0000[diff] [blame]194# perl/l2hinit.perl to use a different location for the icons directory.
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]195
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]196# If you have the standard LaTeX2HTML icons installed, the versions shipped
197# with this documentation should be stored in a separate directory and used
198# instead. The standard set does *not* include all the icons used in the
199# Python documentation.
Fred Drakebbe33c51998-05-07 01:39:06 +0000[diff] [blame]200
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]201html:
202 (cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile)
Guido van Rossum6938f061994-08-01 12:22:53 +0000[diff] [blame]203
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame^]204api htmlapi:
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]205 (cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile api)
Guido van Rossum6938f061994-08-01 12:22:53 +0000[diff] [blame]206
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame^]207doc htmldoc:
Fred Drake7d5f5dd1999-03-18 19:08:47 +0000[diff] [blame]208 (cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile doc)
209
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame^]210ext htmlext:
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]211 (cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile ext)
Guido van Rossum970871f1993-02-21 20:10:26 +0000[diff] [blame]212
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame^]213lib htmllib:
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]214 (cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile lib)
Fred Drakea6bb3961998-05-06 19:51:39 +0000[diff] [blame]215
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame^]216mac htmlmac:
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]217 (cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile mac)
Fred Drakecdbd3911998-05-15 17:02:10 +0000[diff] [blame]218
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame^]219ref htmlref:
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]220 (cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile ref)
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]221
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame^]222tut htmltut:
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]223 (cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile tut)
224
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame^]225inst htmlinst:
Greg Ward0862f802000-04-28 16:53:36 +0000[diff] [blame]226 (cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile inst)
227
Fred Drake3a045e82001-01-22 20:47:26 +0000[diff] [blame^]228dist htmldist:
Greg Ward0862f802000-04-28 16:53:36 +0000[diff] [blame]229 (cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile dist)
230
Fred Drakee7a8c972000-04-07 16:27:15 +0000[diff] [blame]231longhtml:
232 (cd longhtml; $(MAKE) PAPER=$(PAPER))
233
Guido van Rossum9231c8f1997-05-15 21:43:21 +0000[diff] [blame]234
Fred Drakee4837a11998-03-06 21:29:34 +0000[diff] [blame]235# webchecker needs an extra flag to process the huge index from the libref
236webcheck:
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]237 (cd $(HTMLDIR); $(MAKE) -f ../html/Makefile webcheck)
238
239
240# Release packaging targets:
Fred Drakee4837a11998-03-06 21:29:34 +0000[diff] [blame]241
Fred Drakeb6584ca1999-01-08 15:49:45 +0000[diff] [blame]242info-$(RELEASE).tgz: info
Fred Drake28e66d11999-01-29 22:23:25 +0000[diff] [blame]243 (cd $(INFODIR); tar cf - README python.dir python-???.info*) \
244 | gzip -9 >$@
Fred Drakea7998351998-02-19 16:01:04 +0000[diff] [blame]245
Fred Drake4ef3ea01999-07-27 16:30:59 +0000[diff] [blame]246info-$(RELEASE).tar.bz2: info
247 (cd $(INFODIR); tar cf - README python.dir python-???.info*) \
248 | bzip2 -9 >$@
249
Fred Drakee34ab301998-05-11 21:10:15 +0000[diff] [blame]250latex-$(RELEASE).tgz:
Fred Drake83c09831999-08-02 20:20:14 +0000[diff] [blame]251 $(TOOLSDIR)/mksourcepkg --gzip $(RELEASE)
Fred Drakee61d7af1998-03-05 16:37:34 +0000[diff] [blame]252
Fred Drake4ef3ea01999-07-27 16:30:59 +0000[diff] [blame]253latex-$(RELEASE).tar.bz2:
Fred Drake83c09831999-08-02 20:20:14 +0000[diff] [blame]254 $(TOOLSDIR)/mksourcepkg --bzip2 $(RELEASE)
Fred Drake4ef3ea01999-07-27 16:30:59 +0000[diff] [blame]255
Fred Drake7dcc69a1999-07-23 16:11:36 +0000[diff] [blame]256latex-$(RELEASE).zip:
Fred Drake02ba6212000-04-04 20:58:25 +0000[diff] [blame]257 rm -f $@
Fred Drake83c09831999-08-02 20:20:14 +0000[diff] [blame]258 $(TOOLSDIR)/mksourcepkg --zip $(RELEASE)
Fred Drake7dcc69a1999-07-23 16:11:36 +0000[diff] [blame]259
Fred Draked19b9d61998-07-29 03:49:44 +0000[diff] [blame]260pdf-$(PAPER)-$(RELEASE).tgz: pdf
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]261 (cd paper-$(PAPER); tar cf - *.pdf) | gzip -9 >$@
Fred Drake04cf4dc1998-02-12 22:33:50 +0000[diff] [blame]262
Fred Drake4ef3ea01999-07-27 16:30:59 +0000[diff] [blame]263pdf-$(PAPER)-$(RELEASE).tar.bz2: pdf
264 (cd paper-$(PAPER); tar cf - *.pdf) | bzip2 -9 >$@
265
Fred Drake7dcc69a1999-07-23 16:11:36 +0000[diff] [blame]266pdf-$(PAPER)-$(RELEASE).zip: pdf
Fred Drake02ba6212000-04-04 20:58:25 +0000[diff] [blame]267 rm -f $@
268 (cd paper-$(PAPER); zip -q -9 ../$@ *.pdf)
Fred Drake7dcc69a1999-07-23 16:11:36 +0000[diff] [blame]269
Fred Drake4ef3ea01999-07-27 16:30:59 +0000[diff] [blame]270postscript-$(PAPER)-$(RELEASE).tar.bz2: ps
Fred Drake2335a301998-08-28 21:17:58 +0000[diff] [blame]271 (cd paper-$(PAPER); $(MAKE) README)
Fred Drake02ba6212000-04-04 20:58:25 +0000[diff] [blame]272 (cd paper-$(PAPER); tar cf - *.ps README) | bzip2 -9 >$@
Fred Drake04cf4dc1998-02-12 22:33:50 +0000[diff] [blame]273
Fred Drake4ef3ea01999-07-27 16:30:59 +0000[diff] [blame]274postscript-$(PAPER)-$(RELEASE).tgz: ps
275 (cd paper-$(PAPER); $(MAKE) README)
Fred Drake02ba6212000-04-04 20:58:25 +0000[diff] [blame]276 (cd paper-$(PAPER); tar cf - *.ps README) | gzip -9 >$@
Fred Drake4ef3ea01999-07-27 16:30:59 +0000[diff] [blame]277
Fred Drake7dcc69a1999-07-23 16:11:36 +0000[diff] [blame]278postscript-$(PAPER)-$(RELEASE).zip: ps
279 (cd paper-$(PAPER); $(MAKE) README)
Fred Drake02ba6212000-04-04 20:58:25 +0000[diff] [blame]280 rm -f $@
281 (cd paper-$(PAPER); zip -q -9 ../$@ *.ps README)
Fred Drake7dcc69a1999-07-23 16:11:36 +0000[diff] [blame]282
Fred Drakefcb7adb1999-01-12 20:32:39 +0000[diff] [blame]283html-$(RELEASE).tgz: html
Fred Drake02ba6212000-04-04 20:58:25 +0000[diff] [blame]284 (cd $(HTMLDIR); \
Fred Drake90f87672000-09-08 21:54:44 +0000[diff] [blame]285 tar cf - *.html */*.css */*.html */*.gif) \
Fred Drake29cabd41998-05-11 18:53:07 +0000[diff] [blame]286 | gzip -9 >$@
Fred Drake33d05b91998-01-13 16:33:09 +0000[diff] [blame]287
Fred Drake4ef3ea01999-07-27 16:30:59 +0000[diff] [blame]288html-$(RELEASE).tar.bz2: html
Fred Drake02ba6212000-04-04 20:58:25 +0000[diff] [blame]289 (cd $(HTMLDIR); \
Fred Drake90f87672000-09-08 21:54:44 +0000[diff] [blame]290 tar cf - *.html */*.css */*.html */*.gif) \
Fred Drake4ef3ea01999-07-27 16:30:59 +0000[diff] [blame]291 | bzip2 -9 >$@
292
Fred Drake7dcc69a1999-07-23 16:11:36 +0000[diff] [blame]293html-$(RELEASE).zip: html
Fred Drake02ba6212000-04-04 20:58:25 +0000[diff] [blame]294 rm -f $@
295 (cd $(HTMLDIR); \
Fred Drake90f87672000-09-08 21:54:44 +0000[diff] [blame]296 zip -q -9 ../$@ *.html */*.css */*.html */*.gif)
Fred Drake7dcc69a1999-07-23 16:11:36 +0000[diff] [blame]297
Fred Drakee7a8c972000-04-07 16:27:15 +0000[diff] [blame]298longhtml-$(RELEASE).zip: longhtml
299 rm -f $@
300 (cd longhtml; \
301 zip -q -9 ../$@ */*.css */*.html */*.gif)
302
Fred Drakea7998351998-02-19 16:01:04 +0000[diff] [blame]303# convenience targets:
304
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]305tarhtml: html-$(RELEASE).tgz
Fred Drakeb6584ca1999-01-08 15:49:45 +0000[diff] [blame]306tarinfo: info-$(RELEASE).tgz
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]307tarps: postscript-$(PAPER)-$(RELEASE).tgz
308tarpdf: pdf-$(PAPER)-$(RELEASE).tgz
309tarlatex: latex-$(RELEASE).tgz
Fred Drakebbe33c51998-05-07 01:39:06 +0000[diff] [blame]310
Fred Drake83c09831999-08-02 20:20:14 +0000[diff] [blame]311tarballs: tarpdf tarps tarhtml
Guido van Rossum84cca441997-11-25 20:49:09 +0000[diff] [blame]312
Fred Drake7dcc69a1999-07-23 16:11:36 +0000[diff] [blame]313ziphtml: html-$(RELEASE).zip
Fred Drakee7a8c972000-04-07 16:27:15 +0000[diff] [blame]314ziplonghtml: longhtml-$(RELEASE).zip
Fred Drake7dcc69a1999-07-23 16:11:36 +0000[diff] [blame]315zipps: postscript-$(PAPER)-$(RELEASE).zip
316zippdf: pdf-$(PAPER)-$(RELEASE).zip
317ziplatex: latex-$(RELEASE).zip
318
Fred Drakeb906d2e2000-07-01 02:37:37 +0000[diff] [blame]319# Only build the longhtml version for final releases; use the second
320# version of this for pre-release versions.
321#
322#zips: zippdf zipps ziphtml ziplonghtml
323zips: zippdf zipps ziphtml
Fred Drake7dcc69a1999-07-23 16:11:36 +0000[diff] [blame]324
Fred Drake4ef3ea01999-07-27 16:30:59 +0000[diff] [blame]325bziphtml: html-$(RELEASE).tar.bz2
326bzipinfo: info-$(RELEASE).tar.bz2
327bzipps: postscript-$(PAPER)-$(RELEASE).tar.bz2
328bzippdf: pdf-$(PAPER)-$(RELEASE).tar.bz2
329bziplatex: latex-$(RELEASE).tar.bz2
330
Fred Drake83c09831999-08-02 20:20:14 +0000[diff] [blame]331bzips: bzippdf bzipps bziphtml
Fred Drake4ef3ea01999-07-27 16:30:59 +0000[diff] [blame]332
Fred Drakea577aa22000-10-19 13:25:15 +0000[diff] [blame]333distfiles: tarballs zips
334 $(TOOLSDIR)/mksourcepkg --zip --gzip $(RELEASE)
Fred Drake4ef3ea01999-07-27 16:30:59 +0000[diff] [blame]335
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]336
337# Housekeeping targets
338
Guido van Rossum9231c8f1997-05-15 21:43:21 +0000[diff] [blame]339# Remove temporary files; all except the following:
Fred Drake6659c301998-03-03 22:02:19 +0000[diff] [blame]340# - sources: .tex, .bib, .sty, *.cls
Fred Drake04cf4dc1998-02-12 22:33:50 +0000[diff] [blame]341# - useful results: .dvi, .pdf, .ps, .texi, .info
Fred Drakee4837a11998-03-06 21:29:34 +0000[diff] [blame]342clean:
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]343 (cd paper-$(PAPER); $(MAKE) clean)
Fred Drakee7a8c972000-04-07 16:27:15 +0000[diff] [blame]344 (cd longhtml; $(MAKE) clean)
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]345 (cd $(HTMLDIR); $(MAKE) clean)
Fred Drakee34ab301998-05-11 21:10:15 +0000[diff] [blame]346 (cd $(INFODIR); $(MAKE) clean)
Guido van Rossum5b343731992-07-07 09:06:34 +0000[diff] [blame]347
Fred Drake03ff6f71997-08-22 18:18:54 +0000[diff] [blame]348l2hclean:
Fred Drakeb6584ca1999-01-08 15:49:45 +0000[diff] [blame]349 (cd $(HTMLDIR); $(MAKE) clean)
Fred Drake03ff6f71997-08-22 18:18:54 +0000[diff] [blame]350
Guido van Rossume83e3801995-03-17 16:01:35 +0000[diff] [blame]351# Remove temporaries as well as final products
Fred Drakeb6584ca1999-01-08 15:49:45 +0000[diff] [blame]352clobber:
353 (cd $(HTMLDIR); $(MAKE) clobber)
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]354 rm -f html-$(RELEASE).tgz info-$(RELEASE).tgz
355 rm -f pdf-$(RELEASE).tgz postscript-$(RELEASE).tgz
Fred Drake7dcc69a1999-07-23 16:11:36 +0000[diff] [blame]356 rm -f latex-$(RELEASE).tgz html-$(RELEASE).zip
357 rm -f pdf-$(RELEASE).zip postscript-$(RELEASE).zip
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]358 (cd paper-$(PAPER); $(MAKE) clobber)
Fred Drakee7a8c972000-04-07 16:27:15 +0000[diff] [blame]359 (cd longhtml; $(MAKE) clobber)
Fred Drakeeb7fe4f1998-08-12 17:08:37 +0000[diff] [blame]360 (cd $(HTMLDIR); $(MAKE) clobber)
Fred Drakee34ab301998-05-11 21:10:15 +0000[diff] [blame]361 (cd $(INFODIR); $(MAKE) clobber)
Fred Drake5ad78f31998-02-22 19:47:13 +0000[diff] [blame]362
363realclean: clobber
364distclean: clobber