1995-03-18 00:01:35 +08:00
|
|
|
# Makefile for Python documentation
|
|
|
|
# ---------------------------------
|
|
|
|
#
|
1995-03-20 21:00:32 +08:00
|
|
|
# See also the README file.
|
|
|
|
#
|
1995-03-18 00:01:35 +08:00
|
|
|
# This is a bit of a mess. The main documents are:
|
1998-05-12 02:25:46 +08:00
|
|
|
# api -- Python/C API Reference Manual
|
|
|
|
# ext -- Extending and Embedding the Python Interpreter
|
|
|
|
# lib -- Library Reference Manual
|
1998-07-24 23:42:12 +08:00
|
|
|
# mac -- Macintosh Library Modules
|
1998-05-08 03:30:16 +08:00
|
|
|
# ref -- Python Reference Manual
|
1998-05-12 02:25:46 +08:00
|
|
|
# tut -- Python Tutorial
|
1995-03-18 00:01:35 +08:00
|
|
|
#
|
1998-05-08 03:30:16 +08:00
|
|
|
# The latex sources for each of these documents are in subdirectories
|
|
|
|
# with the three-letter designations above as the directory names.
|
1996-10-23 04:00:02 +08:00
|
|
|
#
|
1998-05-12 02:25:46 +08:00
|
|
|
# The main target creates DVI and PostScript for the main each of the
|
1998-07-29 05:05:16 +08:00
|
|
|
# documents. You can also do "make lib" (etc.) to create the DVI and
|
|
|
|
# PostScript versions of individual documents.
|
1995-03-18 00:01:35 +08:00
|
|
|
#
|
1998-05-08 03:30:16 +08:00
|
|
|
# The document classes and styles are in the texinputs/ directory.
|
|
|
|
# These define a number of macros that are similar in name and intent
|
|
|
|
# as macros in Texinfo (e.g. \code{...} and \emph{...}), as well as a
|
1998-07-29 05:05:16 +08:00
|
|
|
# number of environments for formatting function and data definitions.
|
1995-03-18 00:01:35 +08:00
|
|
|
#
|
1998-05-12 02:25:46 +08:00
|
|
|
# Everything is processed by LaTeX. See the file `README' for more
|
|
|
|
# information on the tools needed for processing.
|
1995-03-18 00:01:35 +08:00
|
|
|
#
|
|
|
|
# There's a problem with generating the index which has been solved by
|
|
|
|
# a sed command applied to the index file. The shell script fix_hack
|
|
|
|
# does this (the Makefile takes care of calling it).
|
|
|
|
#
|
|
|
|
# Additional targets attempt to convert selected LaTeX sources to
|
|
|
|
# various other formats. These are generally site specific because
|
|
|
|
# the tools used are all but universal. These targets are:
|
1998-07-24 23:42:12 +08:00
|
|
|
#
|
|
|
|
# html -- convert all documents from LaTeX to HTML
|
1998-07-29 05:05:16 +08:00
|
|
|
# pdf -- convert all documents from LaTeX to the
|
|
|
|
# Portable Document Format
|
1998-07-24 23:42:12 +08:00
|
|
|
#
|
1998-07-29 05:05:16 +08:00
|
|
|
# See the README file for more information on these targets.
|
1998-05-12 02:25:46 +08:00
|
|
|
#
|
|
|
|
# The formatted output is located in subdirectories. For PDF and
|
|
|
|
# PostScript, look in the paper-$(PAPER)/ directory. For HTML, look in
|
1998-07-24 23:42:12 +08:00
|
|
|
# the html/ directory. If you want to fix the GNU info process, look
|
1998-08-13 01:08:37 +08:00
|
|
|
# in the info/ directory; please send patches to python-docs@python.org.
|
1995-03-20 21:00:32 +08:00
|
|
|
|
|
|
|
# Customizations -- you *may* have to edit these
|
|
|
|
|
1998-05-08 03:30:16 +08:00
|
|
|
# you could set this to a4
|
|
|
|
PAPER=letter
|
|
|
|
|
1998-08-13 01:08:37 +08:00
|
|
|
# Ideally, you shouldn't need to edit beyond this point
|
1995-03-18 00:01:35 +08:00
|
|
|
|
1998-08-13 01:08:37 +08:00
|
|
|
HTMLDIR= html
|
1998-05-08 23:43:08 +08:00
|
|
|
INFODIR= info
|
1998-08-13 01:08:37 +08:00
|
|
|
TOOLSDIR= tools
|
1992-07-07 17:06:34 +08:00
|
|
|
|
1999-02-17 04:23:55 +08:00
|
|
|
RELEASE=1.5.2b2
|
1998-01-14 00:33:09 +08:00
|
|
|
VERSION=1.5
|
|
|
|
|
1998-08-13 01:08:37 +08:00
|
|
|
# These must be declared phony since there
|
|
|
|
# are directories with matching names:
|
1999-03-18 00:06:51 +08:00
|
|
|
.PHONY: api doc ext lib mac ref tut
|
1998-08-13 01:08:37 +08:00
|
|
|
.PHONY: html info
|
1998-05-07 09:39:06 +08:00
|
|
|
|
|
|
|
|
1995-03-18 00:01:35 +08:00
|
|
|
# Main target
|
1998-07-24 23:42:12 +08:00
|
|
|
all: ps
|
1998-05-08 03:30:16 +08:00
|
|
|
|
1998-07-24 23:42:12 +08:00
|
|
|
dvi:
|
1998-08-13 01:08:37 +08:00
|
|
|
(cd paper-$(PAPER); $(MAKE) dvi)
|
1996-08-10 05:46:05 +08:00
|
|
|
|
1998-07-24 23:42:12 +08:00
|
|
|
pdf:
|
1998-08-13 01:08:37 +08:00
|
|
|
(cd paper-$(PAPER); $(MAKE) pdf)
|
1998-03-07 05:29:34 +08:00
|
|
|
|
1998-07-24 23:42:12 +08:00
|
|
|
ps:
|
1998-08-13 01:08:37 +08:00
|
|
|
(cd paper-$(PAPER); $(MAKE) ps)
|
1992-03-06 18:56:42 +08:00
|
|
|
|
1998-07-24 23:42:12 +08:00
|
|
|
world: ps pdf html tarballs
|
1998-05-12 02:25:46 +08:00
|
|
|
|
|
|
|
|
|
|
|
# Targets for each document:
|
1998-08-13 01:08:37 +08:00
|
|
|
api api.ps:
|
|
|
|
(cd paper-$(PAPER); $(MAKE) api.ps)
|
1998-05-12 02:25:46 +08:00
|
|
|
|
1999-03-17 00:11:27 +08:00
|
|
|
doc doc.ps:
|
|
|
|
(cd paper-$(PAPER); $(MAKE) doc.ps)
|
|
|
|
|
1998-08-13 01:08:37 +08:00
|
|
|
ext ext.ps:
|
|
|
|
(cd paper-$(PAPER); $(MAKE) ext.ps)
|
1998-05-12 02:25:46 +08:00
|
|
|
|
1998-08-13 01:08:37 +08:00
|
|
|
lib lib.ps:
|
|
|
|
(cd paper-$(PAPER); $(MAKE) lib.ps)
|
1998-05-12 02:25:46 +08:00
|
|
|
|
1998-08-13 01:08:37 +08:00
|
|
|
mac mac.ps:
|
|
|
|
(cd paper-$(PAPER); $(MAKE) mac.ps)
|
1998-05-12 02:25:46 +08:00
|
|
|
|
1998-08-13 01:08:37 +08:00
|
|
|
ref ref.ps:
|
|
|
|
(cd paper-$(PAPER); $(MAKE) ref.ps)
|
1998-07-24 21:58:27 +08:00
|
|
|
|
1998-08-13 01:08:37 +08:00
|
|
|
tut tut.ps:
|
|
|
|
(cd paper-$(PAPER); $(MAKE) tut.ps)
|
1998-05-12 02:25:46 +08:00
|
|
|
|
|
|
|
|
1998-08-13 01:08:37 +08:00
|
|
|
api.dvi:
|
|
|
|
(cd paper-$(PAPER); $(MAKE) api.dvi)
|
1998-05-12 02:25:46 +08:00
|
|
|
|
1999-03-17 00:11:27 +08:00
|
|
|
doc.dvi:
|
|
|
|
(cd paper-$(PAPER); $(MAKE) doc.dvi)
|
|
|
|
|
1998-08-13 01:08:37 +08:00
|
|
|
ext.dvi:
|
|
|
|
(cd paper-$(PAPER); $(MAKE) ext.dvi)
|
1998-05-08 03:30:16 +08:00
|
|
|
|
1998-08-13 01:08:37 +08:00
|
|
|
lib.dvi:
|
|
|
|
(cd paper-$(PAPER); $(MAKE) lib.dvi)
|
1998-05-08 03:30:16 +08:00
|
|
|
|
1998-08-13 01:08:37 +08:00
|
|
|
mac.dvi:
|
|
|
|
(cd paper-$(PAPER); $(MAKE) mac.dvi)
|
|
|
|
|
|
|
|
ref.dvi:
|
|
|
|
(cd paper-$(PAPER); $(MAKE) ref.dvi)
|
|
|
|
|
|
|
|
tut.dvi:
|
|
|
|
(cd paper-$(PAPER); $(MAKE) tut.dvi)
|
|
|
|
|
|
|
|
|
|
|
|
api.pdf:
|
|
|
|
(cd paper-$(PAPER); $(MAKE) api.pdf)
|
|
|
|
|
1999-03-17 00:11:27 +08:00
|
|
|
doc.pdf:
|
|
|
|
(cd paper-$(PAPER); $(MAKE) doc.pdf)
|
|
|
|
|
1998-08-13 01:08:37 +08:00
|
|
|
ext.pdf:
|
|
|
|
(cd paper-$(PAPER); $(MAKE) ext.pdf)
|
|
|
|
|
|
|
|
lib.pdf:
|
|
|
|
(cd paper-$(PAPER); $(MAKE) lib.pdf)
|
|
|
|
|
|
|
|
mac.pdf:
|
|
|
|
(cd paper-$(PAPER); $(MAKE) mac.pdf)
|
|
|
|
|
|
|
|
ref.pdf:
|
|
|
|
(cd paper-$(PAPER); $(MAKE) ref.pdf)
|
|
|
|
|
|
|
|
tut.pdf:
|
|
|
|
(cd paper-$(PAPER); $(MAKE) tut.pdf)
|
1998-05-08 03:30:16 +08:00
|
|
|
|
1995-03-18 00:01:35 +08:00
|
|
|
|
|
|
|
# The remaining part of the Makefile is concerned with various
|
1995-03-20 21:00:32 +08:00
|
|
|
# conversions, as described above. See also the README file.
|
1995-03-18 00:01:35 +08:00
|
|
|
|
1998-05-08 23:43:08 +08:00
|
|
|
info:
|
|
|
|
(cd $(INFODIR); $(MAKE))
|
1998-02-23 03:47:13 +08:00
|
|
|
|
1995-03-20 21:00:32 +08:00
|
|
|
# Targets to convert the manuals to HTML using Nikos Drakos' LaTeX to
|
|
|
|
# HTML converter. For more info on this program, see
|
1995-03-18 00:01:35 +08:00
|
|
|
# <URL:http://cbl.leeds.ac.uk/nikos/tex2html/doc/latex2html/latex2html.html>.
|
1996-11-12 05:03:01 +08:00
|
|
|
|
1997-12-30 04:01:55 +08:00
|
|
|
# Note that LaTeX2HTML inserts references to an icons directory in
|
|
|
|
# each page that it generates. I have placed a copy of this directory
|
|
|
|
# in the distribution to simplify the process of creating a
|
|
|
|
# self-contained HTML distribution; for this purpose I have also added
|
|
|
|
# a (trivial) index.html. Change the definition of $ICONSERVER in
|
1998-04-29 03:20:43 +08:00
|
|
|
# perl/l2hinit.perl to use a different location for the icons directory.
|
1996-11-12 05:03:01 +08:00
|
|
|
|
1998-08-13 01:08:37 +08:00
|
|
|
# If you have the standard LaTeX2HTML icons installed, the versions shipped
|
|
|
|
# with this documentation should be stored in a separate directory and used
|
|
|
|
# instead. The standard set does *not* include all the icons used in the
|
|
|
|
# Python documentation.
|
1998-05-07 09:39:06 +08:00
|
|
|
|
1998-08-13 01:08:37 +08:00
|
|
|
html:
|
|
|
|
(cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile)
|
1996-11-12 05:03:01 +08:00
|
|
|
|
1998-08-13 01:08:37 +08:00
|
|
|
htmlapi:
|
|
|
|
(cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile api)
|
1994-08-01 20:22:53 +08:00
|
|
|
|
1999-03-19 03:08:47 +08:00
|
|
|
htmldoc:
|
|
|
|
(cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile doc)
|
|
|
|
|
1998-08-13 01:08:37 +08:00
|
|
|
htmlext:
|
|
|
|
(cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile ext)
|
1993-02-22 04:10:26 +08:00
|
|
|
|
1998-08-13 01:08:37 +08:00
|
|
|
htmllib:
|
|
|
|
(cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile lib)
|
1998-05-07 03:51:39 +08:00
|
|
|
|
1998-08-13 01:08:37 +08:00
|
|
|
htmlmac:
|
|
|
|
(cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile mac)
|
1998-05-16 01:02:10 +08:00
|
|
|
|
1998-08-13 01:08:37 +08:00
|
|
|
htmlref:
|
|
|
|
(cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile ref)
|
|
|
|
|
|
|
|
htmltut:
|
|
|
|
(cd $(HTMLDIR); $(MAKE) PAPER=$(PAPER) -f ../html/Makefile tut)
|
1995-03-18 00:01:35 +08:00
|
|
|
|
1998-03-07 05:29:34 +08:00
|
|
|
|
|
|
|
# webchecker needs an extra flag to process the huge index from the libref
|
|
|
|
webcheck:
|
1998-08-13 01:08:37 +08:00
|
|
|
(cd $(HTMLDIR); $(MAKE) -f ../html/Makefile webcheck)
|
|
|
|
|
|
|
|
|
|
|
|
# Release packaging targets:
|
1997-05-16 05:43:21 +08:00
|
|
|
|
1999-01-08 23:49:45 +08:00
|
|
|
info-$(RELEASE).tgz: info
|
1999-01-30 06:23:25 +08:00
|
|
|
(cd $(INFODIR); tar cf - README python.dir python-???.info*) \
|
|
|
|
| gzip -9 >$@
|
1998-02-20 00:01:04 +08:00
|
|
|
|
1998-05-12 05:10:15 +08:00
|
|
|
latex-$(RELEASE).tgz:
|
1998-08-13 01:08:37 +08:00
|
|
|
$(TOOLSDIR)/mktarball.sh $(RELEASE)
|
1998-03-06 00:37:34 +08:00
|
|
|
|
1998-07-29 11:49:44 +08:00
|
|
|
pdf-$(PAPER)-$(RELEASE).tgz: pdf
|
1998-08-13 01:08:37 +08:00
|
|
|
(cd paper-$(PAPER); tar cf - *.pdf) | gzip -9 >$@
|
1998-02-13 06:33:50 +08:00
|
|
|
|
1998-07-29 11:49:44 +08:00
|
|
|
postscript-$(PAPER)-$(RELEASE).tgz: ps
|
1998-08-29 05:17:58 +08:00
|
|
|
(cd paper-$(PAPER); $(MAKE) README)
|
|
|
|
(cd paper-$(PAPER); tar cf - *.ps README) | gzip -9 >$@
|
1998-02-13 06:33:50 +08:00
|
|
|
|
1999-01-13 04:32:39 +08:00
|
|
|
html-$(RELEASE).tgz: html
|
1998-05-12 05:10:15 +08:00
|
|
|
(cd $(HTMLDIR); tar cf - index.html ???/???.css ???/*.html */*.gif) \
|
1998-05-12 02:53:07 +08:00
|
|
|
| gzip -9 >$@
|
1998-01-14 00:33:09 +08:00
|
|
|
|
1998-02-20 00:01:04 +08:00
|
|
|
# convenience targets:
|
|
|
|
|
1998-08-13 01:08:37 +08:00
|
|
|
tarhtml: html-$(RELEASE).tgz
|
1999-01-08 23:49:45 +08:00
|
|
|
tarinfo: info-$(RELEASE).tgz
|
1998-08-13 01:08:37 +08:00
|
|
|
tarps: postscript-$(PAPER)-$(RELEASE).tgz
|
|
|
|
tarpdf: pdf-$(PAPER)-$(RELEASE).tgz
|
|
|
|
tarlatex: latex-$(RELEASE).tgz
|
1998-02-20 00:01:04 +08:00
|
|
|
|
1999-01-30 06:23:25 +08:00
|
|
|
tarballs: tarpdf tarps tarhtml tarinfo tarlatex
|
1997-11-26 04:49:09 +08:00
|
|
|
|
1995-03-18 00:01:35 +08:00
|
|
|
|
|
|
|
# Housekeeping targets
|
|
|
|
|
1997-05-16 05:43:21 +08:00
|
|
|
# Remove temporary files; all except the following:
|
1998-03-04 06:02:19 +08:00
|
|
|
# - sources: .tex, .bib, .sty, *.cls
|
1998-02-13 06:33:50 +08:00
|
|
|
# - useful results: .dvi, .pdf, .ps, .texi, .info
|
1998-03-07 05:29:34 +08:00
|
|
|
clean:
|
1998-08-13 01:08:37 +08:00
|
|
|
(cd paper-$(PAPER); $(MAKE) clean)
|
|
|
|
(cd $(HTMLDIR); $(MAKE) clean)
|
1998-05-12 05:10:15 +08:00
|
|
|
(cd $(INFODIR); $(MAKE) clean)
|
1992-07-07 17:06:34 +08:00
|
|
|
|
1997-08-23 02:18:54 +08:00
|
|
|
l2hclean:
|
1999-01-08 23:49:45 +08:00
|
|
|
(cd $(HTMLDIR); $(MAKE) clean)
|
1997-08-23 02:18:54 +08:00
|
|
|
|
1995-03-18 00:01:35 +08:00
|
|
|
# Remove temporaries as well as final products
|
1999-01-08 23:49:45 +08:00
|
|
|
clobber:
|
|
|
|
(cd $(HTMLDIR); $(MAKE) clobber)
|
1998-08-13 01:08:37 +08:00
|
|
|
rm -f html-$(RELEASE).tgz info-$(RELEASE).tgz
|
|
|
|
rm -f pdf-$(RELEASE).tgz postscript-$(RELEASE).tgz
|
|
|
|
rm -f latex-$(RELEASE).tgz
|
|
|
|
(cd paper-$(PAPER); $(MAKE) clobber)
|
|
|
|
(cd $(HTMLDIR); $(MAKE) clobber)
|
1998-05-12 05:10:15 +08:00
|
|
|
(cd $(INFODIR); $(MAKE) clobber)
|
1998-02-23 03:47:13 +08:00
|
|
|
|
|
|
|
realclean: clobber
|
|
|
|
distclean: clobber
|