mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-08-04 00:48:58 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8
cpython/Doc/Makefile
Fred Drake d69e2c4f33 Update some of the comments. 
Update the .tar.gz targets so that they work from the top level.

Reinstate the api, ext, lib, ref, and tut targets.
1998-05-11 18:25:46 +00:00

373 lines
12 KiB
Makefile
Raw Blame History

# Makefile for Python documentation
# ---------------------------------
#
# See also the README file.
#
# This is a bit of a mess. The main documents are:
# api -- Python/C API Reference Manual
# ext -- Extending and Embedding the Python Interpreter
# lib -- Library Reference Manual
# ref -- Python Reference Manual
# tut -- Python Tutorial
#
# The latex sources for each of these documents are in subdirectories
# with the three-letter designations above as the directory names.
#
# The main target creates DVI and PostScript for the main each of the
# documents. You can also do "make lib" (etc.) to process individual
# documents.
#
# 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
# number of environments for formatting function and data definitions,
# also in the style of Texinfo.
#
# Everything is processed by LaTeX. See the file `README' for more
# information on the tools needed for processing.
#
# 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:
# l2h -- convert tut, ref, lib, ext, api from LaTeX to HTML
# See the README file for more info on these targets.
#
# The formatted output is located in subdirectories. For PDF and
# PostScript, look in the paper-$(PAPER)/ directory. For HTML, look in
# the html/ directory. If you fix the GNU info process, look in the
# info/ directory.
# Customizations -- you *may* have to edit these
# you could set this to a4
PAPER=letter
# Where are the various programs?
LATEX= latex
PDFLATEX= pdflatex
DVIPS= dvips -N0
KPSEWHICH= TEXINPUTS=$(TEXINPUTS) kpsewhich tex
MAKEINDEX= makeindex -s $(srcdir)/texinputs/myindex.ist
ACROREAD= acroread
L2HARGS=
# HTMLDIR should not be '.'!
HTMLDIR= html
PYTHON= python
WEBCHECKER= $(PYTHON) $(srcdir)/../Tools/webchecker/webchecker.py
# Install destination -- not used now but might be useful some time...
DESTDIR= /usr/local
LIBDESTDIR= $DESTDIR/lib
LIBDEST= $LIBDESTDIR/python$(VERSION)
DOCDESTDIR= $LIBDEST/doc
INFODIR= info
srcdir=.
VPATH=.
# Ideally, you shouldn't need to edit beyond this point
RELEASE=1.5.1
VERSION=1.5
DVIFILES= api.dvi ext.dvi lib.dvi ref.dvi tut.dvi
PDFFILES= api.pdf ext.pdf lib.pdf ref.pdf tut.pdf
PSFILES= api.ps ext.ps lib.ps ref.ps tut.ps
# Be careful when messing with this one!
TEXINPUTS= .:../texinputs:
MKDVI= TEXINPUTS=$(TEXINPUTS) $(srcdir)/tools/mkdvi.sh
MKHTML= TEXINPUTS=$(TEXINPUTS) $(srcdir)/tools/mkhtml.sh
MKPDF= TEXINPUTS=$(TEXINPUTS) $(srcdir)/tools/mkdvi.sh --pdf
# Main target
all: all-ps
all-dvi:
(cd paper-$(PAPER); \
$(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \
-f ../Makefile do-dvi)
all-pdf:
(cd paper-$(PAPER); \
$(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \
-f ../Makefile do-pdf)
all-ps:
(cd paper-$(PAPER); \
$(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \
-f ../Makefile do-ps)
world: all-ps all-pdf l2h tarballs
# Targets for each document:
.PHONY: api ext lib ref tut
api:
(cd paper-$(PAPER); \
$(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \
-f ../Makefile api.ps)
ext:
(cd paper-$(PAPER); \
$(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \
-f ../Makefile ext.ps)
lib:
(cd paper-$(PAPER); \
$(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \
-f ../Makefile lib.ps)
ref:
(cd paper-$(PAPER); \
$(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \
-f ../Makefile ref.ps)
tut:
(cd paper-$(PAPER); \
$(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \
-f ../Makefile tut.ps)
# Internal targets:
do-dvi: $(DVIFILES)
do-pdf: $(PDFFILES)
do-ps: $(PSFILES)
# This target gets both the PDF and PS files updated.
#
all-formats: $(PSFILES) $(PDFFILES)
# Rules to build PostScript and PDF formats
.SUFFIXES: .dvi .ps .pdf
.dvi.ps:
$(DVIPS) -o $@ $<
#.pdf.ps:
# $(ACROREAD) -toPostScript $<
# Dependencies
# We really need some support of dependency generator for this...
MANSTYLES=texinputs/fncychap.sty texinputs/manual.cls \
texinputs/python.sty texinputs/myindex.ist
COMMONTEX=$(MANSTYLES) texinputs/copyright.tex texinputs/boilerplate.tex
$(DVIFILES): tools/fix_hack tools/mkdvi.sh $(COMMONTEX)
$(PDFFILES): tools/fix_hack tools/mkdvi.sh $(COMMONTEX)
REFFILES = ref/ref1.tex ref/ref2.tex ref/ref3.tex ref/ref4.tex \
ref/ref5.tex ref/ref6.tex ref/ref7.tex ref/ref8.tex
# LaTeX source files for the Python Library Reference
LIBFILES = lib/lib.tex \
lib/libintro.tex lib/libobjs.tex lib/libtypes.tex lib/libexcs.tex \
lib/libfuncs.tex lib/libpython.tex lib/libsys.tex lib/libtypes2.tex \
lib/libtraceback.tex lib/libpickle.tex lib/libshelve.tex \
lib/libcopy.tex lib/libmarshal.tex lib/libimp.tex lib/libparser.tex \
lib/libbltin.tex lib/libmain.tex lib/libstrings.tex lib/libstring.tex \
lib/libregex.tex lib/libregsub.tex lib/libstruct.tex lib/libmisc.tex \
lib/libmath.tex lib/librand.tex lib/libwhrandom.tex lib/libarray.tex \
lib/liballos.tex lib/libos.tex lib/libtime.tex lib/libgetopt.tex \
lib/libtempfile.tex lib/liberrno.tex lib/libsomeos.tex lib/libsignal.tex \
lib/libsocket.tex lib/libselect.tex lib/libthread.tex lib/libunix.tex \
lib/libposix.tex lib/libppath.tex lib/libpwd.tex lib/libgrp.tex \
lib/libcrypt.tex lib/libdbm.tex lib/libgdbm.tex lib/libtermios.tex \
lib/libfcntl.tex lib/libposixfile.tex lib/libsyslog.tex lib/libpdb.tex \
lib/libprofile.tex lib/libwww.tex lib/libcgi.tex lib/liburllib.tex \
lib/libhttplib.tex lib/libftplib.tex lib/libgopherlib.tex \
lib/libnntplib.tex lib/liburlparse.tex lib/libhtmllib.tex \
lib/libsgmllib.tex lib/librfc822.tex lib/libmimetools.tex \
lib/libbinascii.tex lib/libmm.tex lib/libaudioop.tex lib/libimageop.tex \
lib/libaifc.tex lib/libjpeg.tex lib/librgbimg.tex lib/libcrypto.tex \
lib/libmd5.tex lib/libmpz.tex lib/librotor.tex lib/libstdwin.tex \
lib/libsgi.tex lib/libal.tex lib/libcd.tex lib/libfl.tex lib/libfm.tex \
lib/libgl.tex lib/libimgfile.tex lib/libsun.tex lib/libxdrlib.tex \
lib/libimghdr.tex lib/librestricted.tex lib/librexec.tex \
lib/libbastion.tex lib/libformatter.tex lib/liboperator.tex \
lib/libsoundex.tex lib/libresource.tex lib/libstat.tex lib/libstrio.tex \
lib/libundoc.tex lib/libmailcap.tex lib/libglob.tex lib/libuser.tex \
lib/libanydbm.tex lib/librandom.tex lib/libsite.tex lib/libwhichdb.tex \
lib/libbase64.tex lib/libfnmatch.tex lib/libquopri.tex lib/libzlib.tex \
lib/libsocksvr.tex lib/libmailbox.tex lib/libcommands.tex \
lib/libcmath.tex lib/libgzip.tex lib/libpprint.tex \
lib/libcode.tex lib/libmimify.tex lib/libre.tex lib/libuserdict.tex \
lib/libdis.tex lib/libxmllib.tex lib/libqueue.tex lib/liblocale.tex \
lib/libbasehttp.tex lib/libcopyreg.tex lib/libsymbol.tex lib/libtoken.tex \
lib/libbinhex.tex lib/libuu.tex \
lib/libsunaudio.tex lib/libfileinput.tex lib/libimaplib.tex \
lib/libpoplib.tex lib/libcalendar.tex lib/libpopen2.tex lib/libbisect.tex
# LaTeX source files for Macintosh Library Modules.
MACLIBFILES = mac/mac.tex mac/libmac.tex mac/libctb.tex mac/libmacconsole.tex \
mac/libmacdnr.tex mac/libmacfs.tex mac/libmacos.tex mac/libmacostools.tex \
mac/libmactcp.tex mac/libmacspeech.tex mac/libmacui.tex mac/libmacic.tex \
mac/libframework.tex mac/libminiae.tex
# Python Library Reference
lib.dvi: tools/indfix.py $(LIBFILES)
$(srcdir)/tools/newind.py >$*.ind
$(srcdir)/tools/newind.py modindex >mod$*.ind
TEXINPUTS=$(srcdir)/lib:$(TEXINPUTS) $(LATEX) $*
$(MAKEINDEX) mod$*.idx
$(srcdir)/tools/fix_hack $*.idx
$(MAKEINDEX) $*.idx
$(srcdir)/tools/indfix.py $*.ind
TEXINPUTS=$(srcdir)/lib:$(TEXINPUTS) $(LATEX) $*
lib.pdf: tools/indfix.py $(LIBFILES)
$(srcdir)/tools/newind.py >$*.ind
$(srcdir)/tools/newind.py modindex >mod$*.ind
TEXINPUTS=$(srcdir)/lib:$(TEXINPUTS) $(PDFLATEX) $*
$(MAKEINDEX) mod$*.idx
$(srcdir)/tools/fix_hack $*.idx
$(MAKEINDEX) $*.idx
$(srcdir)/tools/indfix.py $*.ind
TEXINPUTS=$(srcdir)/lib:$(TEXINPUTS) $(PDFLATEX) $*
# Python/C API Reference Manual
api.dvi: api/api.tex
$(MKDVI) api
api.pdf: api/api.tex
$(MKPDF) api
# Extending and Embedding the Python Interpreter
ext.dvi: ext/ext.tex
$(MKDVI) ext
ext.pdf: ext/ext.tex
$(MKPDF) ext
# Python Reference Manual
ref.dvi: $(REFFILES)
$(MKDVI) ref
ref.pdf: $(REFFILES)
$(MKPDF) ref
# Python Tutorial
tut.dvi: tut/tut.tex
$(MKDVI) tut
tut.pdf: tut/tut.tex
$(MKPDF) tut
# The remaining part of the Makefile is concerned with various
# conversions, as described above. See also the README file.
.PHONY: html info
info:
(cd $(INFODIR); $(MAKE))
# Targets to convert the manuals to HTML using Nikos Drakos' LaTeX to
# HTML converter. For more info on this program, see
# <URL:http://cbl.leeds.ac.uk/nikos/tex2html/doc/latex2html/latex2html.html>.
# 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
# perl/l2hinit.perl to use a different location for the icons directory.
COMMONPERL=perl/manual.perl perl/python.perl
html: l2h
l2h:
(cd $(HTMLDIR); $(MAKE) TEXINPUTS=../paper-$(PAPER):../texinputs)
l2hapi: $(COMMONPERL)
$(MKHTML) api $(L2HARGS)
l2hext: $(COMMONPERL)
$(MKHTML) ext $(L2HARGS)
l2hlib: $(COMMONPERL)
$(srcdir)/tools/fix_libaux.sed <`$(KPSEWHICH) lib.aux` >lib1.aux
mv lib1.aux `$(KPSEWHICH) lib.aux`
$(MKHTML) lib $(L2HARGS)
l2href: $(COMMONPERL)
$(MKHTML) ref $(L2HARGS)
l2htut: $(COMMONPERL)
$(MKHTML) tut $(L2HARGS)
# webchecker needs an extra flag to process the huge index from the libref
webcheck:
$(WEBCHECKER) file:`pwd`/api/
$(WEBCHECKER) file:`pwd`/ext/
$(WEBCHECKER) -m290000 file:`pwd`/lib/
$(WEBCHECKER) file:`pwd`/ref/
$(WEBCHECKER) file:`pwd`/tut/
lib-info-$(RELEASE).tar.gz: info
(cd $(INFODIR); tar cf - python-???.info*) | gzip -9 >$@
latex-$(RELEASE).tar.gz:
$(srcdir)/tools/mktarball.sh
pdf-$(RELEASE).tar.gz: all-pdf
(cd paper-$(PAPER); tar cf - $(PDFFILES)) | gzip -9 >$@
postscript-$(RELEASE).tar.gz: all-ps
(cd paper-$(PAPER); tar cf - $(PSFILES)) | gzip -9 >$@
html-$(RELEASE).tar.gz:
tar cf - -C $(HTMLDIR) index.html ???/???.css ???/*.html */*.gif \
| gzip -9 >html-$(RELEASE).tar.gz
# convenience targets:
tarhtml: html-$(RELEASE).tar.gz
tarinfo: lib-info-$(RELEASE).tar.gz
tarps: postscript-$(RELEASE).tar.gz
tarpdf: pdf-$(RELEASE).tar.gz
tarlatex: latex-$(RELEASE).tar.gz
tarballs: tarpdf tarps tarhtml tarlatex
# Housekeeping targets
# Remove temporary files; all except the following:
# - sources: .tex, .bib, .sty, *.cls
# - useful results: .dvi, .pdf, .ps, .texi, .info
clean:
(cd paper-$(PAPER); rm -f *~ *.aux *.idx *.ilg *.ind *.log *.toc *.bkm)
rm -f *.bak *.orig lib1.texi
(cd $(HTMLDIR); rm -f @webchecker.pickle)
rm -f html-$(RELEASE).tar.gz info-$(RELEASE).tar.gz
rm -f pdf-$(RELEASE).tar.gz postscript-$(RELEASE).tar.gz
rm -f latex-$(RELEASE).tar.gz
l2hclean:
(cd $(HTMLDIR); rm -rf api ext lib ref tut)
# Remove temporaries as well as final products
clobber: clean l2hclean
(cd paper-$(PAPER); rm -f $(DVIFILES) $(PSFILES) $(PDFFILES))
(cd $(HTMLDIR); rm -f *.texi python-???.info python-???.info-[0-9]*)
realclean: clobber
distclean: clobber
Reference in a new issue View git blame Copy permalink