Guido van Rossum | e83e380 | 1995-03-17 16:01:35 +0000 | [diff] [blame] | 1 | # Makefile for Python documentation |
| 2 | # --------------------------------- |
| 3 | # |
Guido van Rossum | 73827c6 | 1995-03-20 13:00:32 +0000 | [diff] [blame] | 4 | # See also the README file. |
| 5 | # |
Guido van Rossum | e83e380 | 1995-03-17 16:01:35 +0000 | [diff] [blame] | 6 | # This is a bit of a mess. The main documents are: |
Fred Drake | d69e2c4 | 1998-05-11 18:25:46 +0000 | [diff] [blame] | 7 | # api -- Python/C API Reference Manual |
| 8 | # ext -- Extending and Embedding the Python Interpreter |
| 9 | # lib -- Library Reference Manual |
Fred Drake | 34116ba | 1998-07-24 15:42:12 +0000 | [diff] [blame] | 10 | # mac -- Macintosh Library Modules |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 11 | # ref -- Python Reference Manual |
Fred Drake | d69e2c4 | 1998-05-11 18:25:46 +0000 | [diff] [blame] | 12 | # tut -- Python Tutorial |
Guido van Rossum | e83e380 | 1995-03-17 16:01:35 +0000 | [diff] [blame] | 13 | # |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 14 | # The latex sources for each of these documents are in subdirectories |
| 15 | # with the three-letter designations above as the directory names. |
Guido van Rossum | 1f17543 | 1996-10-22 20:00:02 +0000 | [diff] [blame] | 16 | # |
Fred Drake | d69e2c4 | 1998-05-11 18:25:46 +0000 | [diff] [blame] | 17 | # The main target creates DVI and PostScript for the main each of the |
Fred Drake | efc17bd | 1998-07-28 21:05:16 +0000 | [diff] [blame] | 18 | # documents. You can also do "make lib" (etc.) to create the DVI and |
| 19 | # PostScript versions of individual documents. |
Guido van Rossum | e83e380 | 1995-03-17 16:01:35 +0000 | [diff] [blame] | 20 | # |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 21 | # The document classes and styles are in the texinputs/ directory. |
| 22 | # These define a number of macros that are similar in name and intent |
| 23 | # as macros in Texinfo (e.g. \code{...} and \emph{...}), as well as a |
Fred Drake | efc17bd | 1998-07-28 21:05:16 +0000 | [diff] [blame] | 24 | # number of environments for formatting function and data definitions. |
Guido van Rossum | e83e380 | 1995-03-17 16:01:35 +0000 | [diff] [blame] | 25 | # |
Fred Drake | d69e2c4 | 1998-05-11 18:25:46 +0000 | [diff] [blame] | 26 | # Everything is processed by LaTeX. See the file `README' for more |
| 27 | # information on the tools needed for processing. |
Guido van Rossum | e83e380 | 1995-03-17 16:01:35 +0000 | [diff] [blame] | 28 | # |
| 29 | # There's a problem with generating the index which has been solved by |
| 30 | # a sed command applied to the index file. The shell script fix_hack |
| 31 | # does this (the Makefile takes care of calling it). |
| 32 | # |
Guido van Rossum | e83e380 | 1995-03-17 16:01:35 +0000 | [diff] [blame] | 33 | # Additional targets attempt to convert selected LaTeX sources to |
| 34 | # various other formats. These are generally site specific because |
| 35 | # the tools used are all but universal. These targets are: |
Fred Drake | 34116ba | 1998-07-24 15:42:12 +0000 | [diff] [blame] | 36 | # |
| 37 | # html -- convert all documents from LaTeX to HTML |
Fred Drake | efc17bd | 1998-07-28 21:05:16 +0000 | [diff] [blame] | 38 | # pdf -- convert all documents from LaTeX to the |
| 39 | # Portable Document Format |
Fred Drake | 34116ba | 1998-07-24 15:42:12 +0000 | [diff] [blame] | 40 | # |
Fred Drake | efc17bd | 1998-07-28 21:05:16 +0000 | [diff] [blame] | 41 | # See the README file for more information on these targets. |
Fred Drake | d69e2c4 | 1998-05-11 18:25:46 +0000 | [diff] [blame] | 42 | # |
| 43 | # The formatted output is located in subdirectories. For PDF and |
| 44 | # PostScript, look in the paper-$(PAPER)/ directory. For HTML, look in |
Fred Drake | 34116ba | 1998-07-24 15:42:12 +0000 | [diff] [blame] | 45 | # the html/ directory. If you want to fix the GNU info process, look |
| 46 | # in the info/ directory. |
Guido van Rossum | e83e380 | 1995-03-17 16:01:35 +0000 | [diff] [blame] | 47 | |
Guido van Rossum | 73827c6 | 1995-03-20 13:00:32 +0000 | [diff] [blame] | 48 | # Customizations -- you *may* have to edit these |
Guido van Rossum | e83e380 | 1995-03-17 16:01:35 +0000 | [diff] [blame] | 49 | |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 50 | # you could set this to a4 |
| 51 | PAPER=letter |
| 52 | |
Guido van Rossum | 73827c6 | 1995-03-20 13:00:32 +0000 | [diff] [blame] | 53 | # Where are the various programs? |
Fred Drake | 9cdf087 | 1998-05-07 15:03:25 +0000 | [diff] [blame] | 54 | LATEX= latex |
| 55 | PDFLATEX= pdflatex |
Fred Drake | b3563158 | 1998-07-29 05:07:41 +0000 | [diff] [blame] | 56 | DVIPS= dvips -N0 -t $(PAPER) |
Fred Drake | df68e3d | 1998-05-08 03:46:38 +0000 | [diff] [blame] | 57 | KPSEWHICH= TEXINPUTS=$(TEXINPUTS) kpsewhich tex |
Fred Drake | 3af9f25 | 1998-04-24 21:07:22 +0000 | [diff] [blame] | 58 | MAKEINDEX= makeindex -s $(srcdir)/texinputs/myindex.ist |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 59 | ACROREAD= acroread |
Fred Drake | 0d27d08 | 1998-04-23 20:07:55 +0000 | [diff] [blame] | 60 | L2HARGS= |
Fred Drake | b9838d9 | 1998-05-08 15:43:08 +0000 | [diff] [blame] | 61 | # HTMLDIR should not be '.'! |
| 62 | HTMLDIR= html |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 63 | PYTHON= python |
Fred Drake | 3af9f25 | 1998-04-24 21:07:22 +0000 | [diff] [blame] | 64 | WEBCHECKER= $(PYTHON) $(srcdir)/../Tools/webchecker/webchecker.py |
Guido van Rossum | 73827c6 | 1995-03-20 13:00:32 +0000 | [diff] [blame] | 65 | |
| 66 | # Install destination -- not used now but might be useful some time... |
| 67 | DESTDIR= /usr/local |
| 68 | LIBDESTDIR= $DESTDIR/lib |
Fred Drake | e4837a1 | 1998-03-06 21:29:34 +0000 | [diff] [blame] | 69 | LIBDEST= $LIBDESTDIR/python$(VERSION) |
Guido van Rossum | 73827c6 | 1995-03-20 13:00:32 +0000 | [diff] [blame] | 70 | DOCDESTDIR= $LIBDEST/doc |
| 71 | |
Fred Drake | b9838d9 | 1998-05-08 15:43:08 +0000 | [diff] [blame] | 72 | INFODIR= info |
Fred Drake | 3af9f25 | 1998-04-24 21:07:22 +0000 | [diff] [blame] | 73 | |
| 74 | srcdir=. |
| 75 | VPATH=. |
Fred Drake | 05dd3c0 | 1997-12-29 17:17:54 +0000 | [diff] [blame] | 76 | |
Guido van Rossum | 73827c6 | 1995-03-20 13:00:32 +0000 | [diff] [blame] | 77 | # Ideally, you shouldn't need to edit beyond this point |
Guido van Rossum | 5b34373 | 1992-07-07 09:06:34 +0000 | [diff] [blame] | 78 | |
Fred Drake | 228e31e | 1998-08-04 16:59:29 +0000 | [diff] [blame] | 79 | RELEASE=1.5.1p1 |
Fred Drake | 33d05b9 | 1998-01-13 16:33:09 +0000 | [diff] [blame] | 80 | VERSION=1.5 |
| 81 | |
Fred Drake | 3f8a59f | 1998-07-24 13:58:27 +0000 | [diff] [blame] | 82 | MANDVIFILES= api.dvi ext.dvi lib.dvi ref.dvi tut.dvi |
| 83 | HOWTODVIFILES= mac.dvi |
| 84 | |
| 85 | MANPDFFILES= api.pdf ext.pdf lib.pdf ref.pdf tut.pdf |
| 86 | HOWTOPDFFILES= mac.pdf |
| 87 | |
| 88 | MANPSFILES= api.ps ext.ps lib.ps ref.ps tut.ps |
| 89 | HOWTOPSFILES= mac.ps |
| 90 | |
| 91 | DVIFILES= $(MANDVIFILES) $(HOWTODVIFILES) |
| 92 | PDFFILES= $(MANPDFFILES) $(HOWTOPDFFILES) |
| 93 | PSFILES= $(MANPSFILES) $(HOWTOPSFILES) |
Fred Drake | 04cf4dc | 1998-02-12 22:33:50 +0000 | [diff] [blame] | 94 | |
Fred Drake | bbe33c5 | 1998-05-07 01:39:06 +0000 | [diff] [blame] | 95 | # Be careful when messing with this one! |
Fred Drake | b9838d9 | 1998-05-08 15:43:08 +0000 | [diff] [blame] | 96 | TEXINPUTS= .:../texinputs: |
Fred Drake | bbe33c5 | 1998-05-07 01:39:06 +0000 | [diff] [blame] | 97 | |
| 98 | MKDVI= TEXINPUTS=$(TEXINPUTS) $(srcdir)/tools/mkdvi.sh |
Fred Drake | cdbd391 | 1998-05-15 17:02:10 +0000 | [diff] [blame] | 99 | MKHOWTO= $(srcdir)/tools/mkhowto.sh --keep |
| 100 | MKHTML= PAPER=$(PAPER) $(srcdir)/tools/mkhtml.sh |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 101 | MKPDF= TEXINPUTS=$(TEXINPUTS) $(srcdir)/tools/mkdvi.sh --pdf |
Fred Drake | bbe33c5 | 1998-05-07 01:39:06 +0000 | [diff] [blame] | 102 | |
Guido van Rossum | e83e380 | 1995-03-17 16:01:35 +0000 | [diff] [blame] | 103 | # Main target |
Fred Drake | 34116ba | 1998-07-24 15:42:12 +0000 | [diff] [blame] | 104 | all: ps |
Guido van Rossum | eb8d503 | 1996-08-09 21:46:05 +0000 | [diff] [blame] | 105 | |
Fred Drake | 34116ba | 1998-07-24 15:42:12 +0000 | [diff] [blame] | 106 | dvi: |
Fred Drake | b9838d9 | 1998-05-08 15:43:08 +0000 | [diff] [blame] | 107 | (cd paper-$(PAPER); \ |
| 108 | $(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \ |
| 109 | -f ../Makefile do-dvi) |
Fred Drake | e4837a1 | 1998-03-06 21:29:34 +0000 | [diff] [blame] | 110 | |
Fred Drake | 34116ba | 1998-07-24 15:42:12 +0000 | [diff] [blame] | 111 | pdf: |
Fred Drake | b9838d9 | 1998-05-08 15:43:08 +0000 | [diff] [blame] | 112 | (cd paper-$(PAPER); \ |
| 113 | $(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \ |
| 114 | -f ../Makefile do-pdf) |
Guido van Rossum | 20aca5a | 1991-01-25 13:29:04 +0000 | [diff] [blame] | 115 | |
Fred Drake | 34116ba | 1998-07-24 15:42:12 +0000 | [diff] [blame] | 116 | ps: |
Fred Drake | b9838d9 | 1998-05-08 15:43:08 +0000 | [diff] [blame] | 117 | (cd paper-$(PAPER); \ |
| 118 | $(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \ |
| 119 | -f ../Makefile do-ps) |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 120 | |
Fred Drake | 34116ba | 1998-07-24 15:42:12 +0000 | [diff] [blame] | 121 | world: ps pdf html tarballs |
Fred Drake | d69e2c4 | 1998-05-11 18:25:46 +0000 | [diff] [blame] | 122 | |
| 123 | |
| 124 | # Targets for each document: |
Fred Drake | 3f8a59f | 1998-07-24 13:58:27 +0000 | [diff] [blame] | 125 | .PHONY: api ext lib mac ref tut |
Fred Drake | d69e2c4 | 1998-05-11 18:25:46 +0000 | [diff] [blame] | 126 | |
| 127 | api: |
| 128 | (cd paper-$(PAPER); \ |
| 129 | $(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \ |
| 130 | -f ../Makefile api.ps) |
| 131 | |
| 132 | ext: |
| 133 | (cd paper-$(PAPER); \ |
| 134 | $(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \ |
| 135 | -f ../Makefile ext.ps) |
| 136 | |
| 137 | lib: |
| 138 | (cd paper-$(PAPER); \ |
| 139 | $(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \ |
| 140 | -f ../Makefile lib.ps) |
| 141 | |
Fred Drake | 3f8a59f | 1998-07-24 13:58:27 +0000 | [diff] [blame] | 142 | mac: |
| 143 | (cd paper-$(PAPER); \ |
| 144 | $(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \ |
| 145 | -f ../Makefile mac.ps) |
| 146 | |
Fred Drake | d69e2c4 | 1998-05-11 18:25:46 +0000 | [diff] [blame] | 147 | ref: |
| 148 | (cd paper-$(PAPER); \ |
| 149 | $(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \ |
| 150 | -f ../Makefile ref.ps) |
| 151 | |
| 152 | tut: |
| 153 | (cd paper-$(PAPER); \ |
| 154 | $(MAKE) srcdir=.. VPATH=.. TEXINPUTS=$(TEXINPUTS) \ |
| 155 | -f ../Makefile tut.ps) |
| 156 | |
| 157 | |
| 158 | # Internal targets: |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 159 | |
| 160 | do-dvi: $(DVIFILES) |
| 161 | do-pdf: $(PDFFILES) |
Fred Drake | cdbd391 | 1998-05-15 17:02:10 +0000 | [diff] [blame] | 162 | do-ps: $(PSFILES) |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 163 | |
| 164 | # This target gets both the PDF and PS files updated. |
Fred Drake | ddae414 | 1998-02-17 15:45:25 +0000 | [diff] [blame] | 165 | # |
| 166 | all-formats: $(PSFILES) $(PDFFILES) |
| 167 | |
Fred Drake | dd94676 | 1998-02-18 16:02:14 +0000 | [diff] [blame] | 168 | |
Fred Drake | 126d840 | 1998-02-04 19:54:40 +0000 | [diff] [blame] | 169 | # Rules to build PostScript and PDF formats |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 170 | .SUFFIXES: .dvi .ps .pdf |
Fred Drake | 126d840 | 1998-02-04 19:54:40 +0000 | [diff] [blame] | 171 | |
| 172 | .dvi.ps: |
Fred Drake | 9fab3aa | 1998-04-28 19:20:43 +0000 | [diff] [blame] | 173 | $(DVIPS) -o $@ $< |
Fred Drake | 126d840 | 1998-02-04 19:54:40 +0000 | [diff] [blame] | 174 | |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 175 | #.pdf.ps: |
| 176 | # $(ACROREAD) -toPostScript $< |
Fred Drake | 126d840 | 1998-02-04 19:54:40 +0000 | [diff] [blame] | 177 | |
Fred Drake | 3b26eed | 1998-02-16 17:06:10 +0000 | [diff] [blame] | 178 | |
Guido van Rossum | e83e380 | 1995-03-17 16:01:35 +0000 | [diff] [blame] | 179 | # Dependencies |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 180 | # We really need some support of dependency generator for this... |
| 181 | |
Fred Drake | 3f8a59f | 1998-07-24 13:58:27 +0000 | [diff] [blame] | 182 | COMMONSTYLES=texinputs/python.sty texinputs/pypaper.sty texinputs/myindex.ist |
| 183 | COMMONTEX=texinputs/copyright.tex texinputs/boilerplate.tex |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 184 | |
Fred Drake | 3f8a59f | 1998-07-24 13:58:27 +0000 | [diff] [blame] | 185 | MANSTYLES=texinputs/fncychap.sty texinputs/manual.cls $(COMMONSTYLES) |
| 186 | HOWTOSTYLES=texinputs/howto.cls $(COMMONSTYLES) |
Fred Drake | 5d8f0ed | 1998-02-11 14:43:38 +0000 | [diff] [blame] | 187 | |
Fred Drake | 3f8a59f | 1998-07-24 13:58:27 +0000 | [diff] [blame] | 188 | |
| 189 | $(DVIFILES): tools/fix_hack tools/mkdvi.sh $(COMMONTEX) |
| 190 | $(PDFFILES): tools/fix_hack tools/mkdvi.sh $(COMMONTEX) |
| 191 | |
| 192 | $(MANDVIFILES): $(MANSTYLES) |
| 193 | $(MANPDFFILES): $(MANSTYLES) |
| 194 | |
| 195 | $(HOWTODVIFILES): tools/mkhowto.sh $(HOWTOSTYLES) |
| 196 | $(HOWTOPDFFILES): tools/mkhowto.sh $(HOWTOSTYLES) |
| 197 | |
Guido van Rossum | eb8d503 | 1996-08-09 21:46:05 +0000 | [diff] [blame] | 198 | |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 199 | REFFILES = ref/ref1.tex ref/ref2.tex ref/ref3.tex ref/ref4.tex \ |
Fred Drake | efc17bd | 1998-07-28 21:05:16 +0000 | [diff] [blame] | 200 | ref/ref5.tex ref/ref6.tex ref/ref7.tex ref/ref8.tex \ |
| 201 | ref/ref.tex |
Fred Drake | a6bb396 | 1998-05-06 19:51:39 +0000 | [diff] [blame] | 202 | |
Guido van Rossum | 16d6e71 | 1994-08-08 12:30:22 +0000 | [diff] [blame] | 203 | # LaTeX source files for the Python Library Reference |
Fred Drake | 9cdf087 | 1998-05-07 15:03:25 +0000 | [diff] [blame] | 204 | LIBFILES = lib/lib.tex \ |
Fred Drake | f54556e | 1998-08-04 20:53:55 +0000 | [diff] [blame] | 205 | lib/libintro.tex lib/libobjs.tex lib/libstdtypes.tex \ |
| 206 | lib/libexcs.tex lib/libfuncs.tex lib/libpython.tex lib/libsys.tex \ |
| 207 | lib/libtypes.tex lib/libtraceback.tex lib/libpickle.tex \ |
| 208 | lib/libshelve.tex lib/libcopy.tex lib/libmarshal.tex \ |
| 209 | lib/libimp.tex lib/libparser.tex lib/libbltin.tex lib/libmain.tex \ |
| 210 | lib/libstrings.tex lib/libstring.tex lib/libregex.tex \ |
| 211 | lib/libregsub.tex lib/libstruct.tex lib/libmisc.tex \ |
| 212 | lib/libmath.tex lib/librand.tex lib/libwhrandom.tex \ |
| 213 | lib/libarray.tex lib/liballos.tex lib/libos.tex lib/libtime.tex \ |
| 214 | lib/libgetopt.tex lib/libtempfile.tex lib/liberrno.tex \ |
| 215 | lib/libsomeos.tex lib/libsignal.tex lib/libsocket.tex \ |
| 216 | lib/libselect.tex lib/libthread.tex lib/libunix.tex \ |
| 217 | lib/libposix.tex lib/libposixpath.tex lib/libpwd.tex \ |
| 218 | lib/libgrp.tex lib/libcrypt.tex lib/libdbm.tex lib/libgdbm.tex \ |
| 219 | lib/libtermios.tex lib/libfcntl.tex lib/libposixfile.tex \ |
Fred Drake | 96e1102 | 1998-08-07 18:01:37 +0000 | [diff] [blame^] | 220 | lib/libsyslog.tex lib/libpdb.tex lib/libprofile.tex \ |
Fred Drake | f54556e | 1998-08-04 20:53:55 +0000 | [diff] [blame] | 221 | lib/libcgi.tex lib/liburllib.tex lib/libhttplib.tex \ |
| 222 | lib/libftplib.tex lib/libgopherlib.tex lib/libnntplib.tex \ |
| 223 | lib/liburlparse.tex lib/libhtmllib.tex lib/libsgmllib.tex \ |
| 224 | lib/librfc822.tex lib/libmimetools.tex lib/libbinascii.tex \ |
| 225 | lib/libmm.tex lib/libaudioop.tex lib/libimageop.tex \ |
| 226 | lib/libaifc.tex lib/libjpeg.tex lib/librgbimg.tex \ |
| 227 | lib/libcrypto.tex lib/libmd5.tex lib/libmpz.tex lib/librotor.tex \ |
| 228 | lib/libstdwin.tex lib/libsgi.tex lib/libal.tex lib/libcd.tex \ |
| 229 | lib/libfl.tex lib/libfm.tex lib/libgl.tex lib/libimgfile.tex \ |
| 230 | lib/libsun.tex lib/libxdrlib.tex lib/libimghdr.tex \ |
| 231 | lib/librestricted.tex lib/librexec.tex lib/libbastion.tex \ |
| 232 | lib/libformatter.tex lib/liboperator.tex lib/libsoundex.tex \ |
| 233 | lib/libresource.tex lib/libstat.tex lib/libstringio.tex \ |
| 234 | lib/libtoken.tex lib/libundoc.tex lib/libmailcap.tex \ |
| 235 | lib/libglob.tex lib/libuser.tex lib/libanydbm.tex \ |
| 236 | lib/librandom.tex lib/libsite.tex lib/libwhichdb.tex \ |
| 237 | lib/libbase64.tex lib/libfnmatch.tex lib/libquopri.tex \ |
| 238 | lib/libzlib.tex lib/libsocksvr.tex lib/libmailbox.tex \ |
| 239 | lib/libcommands.tex lib/libcmath.tex lib/libgzip.tex \ |
| 240 | lib/libpprint.tex lib/libcode.tex lib/libmimify.tex lib/libre.tex \ |
| 241 | lib/libuserdict.tex lib/libdis.tex lib/libxmllib.tex \ |
| 242 | lib/libqueue.tex lib/liblocale.tex lib/libbasehttp.tex \ |
| 243 | lib/libcopyreg.tex lib/libsymbol.tex lib/libbinhex.tex \ |
| 244 | lib/libuu.tex lib/libsunaudio.tex lib/libfileinput.tex \ |
| 245 | lib/libimaplib.tex lib/libpoplib.tex lib/libcalendar.tex \ |
| 246 | lib/libpopen2.tex lib/libbisect.tex lib/libmimetypes.tex \ |
| 247 | lib/libsmtplib.tex lib/libcmd.tex lib/libmultifile.tex \ |
Fred Drake | 96e1102 | 1998-08-07 18:01:37 +0000 | [diff] [blame^] | 248 | lib/libthreading.tex lib/internet.tex lib/netdata.tex |
Guido van Rossum | 16d6e71 | 1994-08-08 12:30:22 +0000 | [diff] [blame] | 249 | |
Fred Drake | 9cdf087 | 1998-05-07 15:03:25 +0000 | [diff] [blame] | 250 | # LaTeX source files for Macintosh Library Modules. |
Fred Drake | f54556e | 1998-08-04 20:53:55 +0000 | [diff] [blame] | 251 | MACLIBFILES = mac/mac.tex mac/libmac.tex mac/libctb.tex \ |
| 252 | mac/libmacconsole.tex mac/libmacdnr.tex mac/libmacfs.tex \ |
| 253 | mac/libmacos.tex mac/libmacostools.tex mac/libmactcp.tex \ |
| 254 | mac/libmacspeech.tex mac/libmacui.tex mac/libmacic.tex \ |
Fred Drake | 9cdf087 | 1998-05-07 15:03:25 +0000 | [diff] [blame] | 255 | mac/libframework.tex mac/libminiae.tex |
Fred Drake | bdbdb80 | 1998-04-17 14:01:44 +0000 | [diff] [blame] | 256 | |
Fred Drake | bbe33c5 | 1998-05-07 01:39:06 +0000 | [diff] [blame] | 257 | # Python Library Reference |
Fred Drake | 520f8bd | 1998-03-09 16:43:54 +0000 | [diff] [blame] | 258 | lib.dvi: tools/indfix.py $(LIBFILES) |
Fred Drake | 3af9f25 | 1998-04-24 21:07:22 +0000 | [diff] [blame] | 259 | $(srcdir)/tools/newind.py >$*.ind |
| 260 | $(srcdir)/tools/newind.py modindex >mod$*.ind |
Fred Drake | 9cdf087 | 1998-05-07 15:03:25 +0000 | [diff] [blame] | 261 | TEXINPUTS=$(srcdir)/lib:$(TEXINPUTS) $(LATEX) $* |
Fred Drake | 8bc9657 | 1998-03-09 16:37:52 +0000 | [diff] [blame] | 262 | $(MAKEINDEX) mod$*.idx |
Fred Drake | 3af9f25 | 1998-04-24 21:07:22 +0000 | [diff] [blame] | 263 | $(srcdir)/tools/fix_hack $*.idx |
Fred Drake | 5ad78f3 | 1998-02-22 19:47:13 +0000 | [diff] [blame] | 264 | $(MAKEINDEX) $*.idx |
Fred Drake | 3af9f25 | 1998-04-24 21:07:22 +0000 | [diff] [blame] | 265 | $(srcdir)/tools/indfix.py $*.ind |
Fred Drake | 9cdf087 | 1998-05-07 15:03:25 +0000 | [diff] [blame] | 266 | TEXINPUTS=$(srcdir)/lib:$(TEXINPUTS) $(LATEX) $* |
Guido van Rossum | eb8d503 | 1996-08-09 21:46:05 +0000 | [diff] [blame] | 267 | |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 268 | lib.pdf: tools/indfix.py $(LIBFILES) |
| 269 | $(srcdir)/tools/newind.py >$*.ind |
| 270 | $(srcdir)/tools/newind.py modindex >mod$*.ind |
| 271 | TEXINPUTS=$(srcdir)/lib:$(TEXINPUTS) $(PDFLATEX) $* |
| 272 | $(MAKEINDEX) mod$*.idx |
| 273 | $(srcdir)/tools/fix_hack $*.idx |
| 274 | $(MAKEINDEX) $*.idx |
| 275 | $(srcdir)/tools/indfix.py $*.ind |
Fred Drake | 34116ba | 1998-07-24 15:42:12 +0000 | [diff] [blame] | 276 | $(srcdir)/tools/toc2bkm.py $* |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 277 | TEXINPUTS=$(srcdir)/lib:$(TEXINPUTS) $(PDFLATEX) $* |
| 278 | |
Fred Drake | bbe33c5 | 1998-05-07 01:39:06 +0000 | [diff] [blame] | 279 | # Python/C API Reference Manual |
| 280 | api.dvi: api/api.tex |
| 281 | $(MKDVI) api |
Guido van Rossum | eb8d503 | 1996-08-09 21:46:05 +0000 | [diff] [blame] | 282 | |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 283 | api.pdf: api/api.tex |
| 284 | $(MKPDF) api |
| 285 | |
Fred Drake | bbe33c5 | 1998-05-07 01:39:06 +0000 | [diff] [blame] | 286 | # Extending and Embedding the Python Interpreter |
| 287 | ext.dvi: ext/ext.tex |
| 288 | $(MKDVI) ext |
| 289 | |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 290 | ext.pdf: ext/ext.tex |
| 291 | $(MKPDF) ext |
| 292 | |
Fred Drake | cdbd391 | 1998-05-15 17:02:10 +0000 | [diff] [blame] | 293 | # Macintosh Library Modules |
Fred Drake | 3f8a59f | 1998-07-24 13:58:27 +0000 | [diff] [blame] | 294 | mac.dvi: $(MACLIBFILES) |
Fred Drake | cdbd391 | 1998-05-15 17:02:10 +0000 | [diff] [blame] | 295 | $(MKHOWTO) --dvi $(srcdir)/$*/$*.tex |
| 296 | |
Fred Drake | 3f8a59f | 1998-07-24 13:58:27 +0000 | [diff] [blame] | 297 | mac.pdf: $(MACLIBFILES) |
Fred Drake | cdbd391 | 1998-05-15 17:02:10 +0000 | [diff] [blame] | 298 | $(MKHOWTO) --pdf $(srcdir)/$*/$*.tex |
| 299 | |
Fred Drake | bbe33c5 | 1998-05-07 01:39:06 +0000 | [diff] [blame] | 300 | # Python Reference Manual |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 301 | ref.dvi: $(REFFILES) |
Fred Drake | bbe33c5 | 1998-05-07 01:39:06 +0000 | [diff] [blame] | 302 | $(MKDVI) ref |
| 303 | |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 304 | ref.pdf: $(REFFILES) |
| 305 | $(MKPDF) ref |
| 306 | |
Fred Drake | bbe33c5 | 1998-05-07 01:39:06 +0000 | [diff] [blame] | 307 | # Python Tutorial |
| 308 | tut.dvi: tut/tut.tex |
| 309 | $(MKDVI) tut |
Guido van Rossum | eb8d503 | 1996-08-09 21:46:05 +0000 | [diff] [blame] | 310 | |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 311 | tut.pdf: tut/tut.tex |
| 312 | $(MKPDF) tut |
| 313 | |
Guido van Rossum | e83e380 | 1995-03-17 16:01:35 +0000 | [diff] [blame] | 314 | |
| 315 | # The remaining part of the Makefile is concerned with various |
Guido van Rossum | 73827c6 | 1995-03-20 13:00:32 +0000 | [diff] [blame] | 316 | # conversions, as described above. See also the README file. |
Guido van Rossum | e83e380 | 1995-03-17 16:01:35 +0000 | [diff] [blame] | 317 | |
Fred Drake | 6f5bf8d | 1998-07-27 19:12:58 +0000 | [diff] [blame] | 318 | .PHONY: html l2h info |
Fred Drake | 05dd3c0 | 1997-12-29 17:17:54 +0000 | [diff] [blame] | 319 | |
Fred Drake | b9838d9 | 1998-05-08 15:43:08 +0000 | [diff] [blame] | 320 | info: |
| 321 | (cd $(INFODIR); $(MAKE)) |
Fred Drake | 5ad78f3 | 1998-02-22 19:47:13 +0000 | [diff] [blame] | 322 | |
Guido van Rossum | 73827c6 | 1995-03-20 13:00:32 +0000 | [diff] [blame] | 323 | # Targets to convert the manuals to HTML using Nikos Drakos' LaTeX to |
| 324 | # HTML converter. For more info on this program, see |
Guido van Rossum | e83e380 | 1995-03-17 16:01:35 +0000 | [diff] [blame] | 325 | # <URL:http://cbl.leeds.ac.uk/nikos/tex2html/doc/latex2html/latex2html.html>. |
Guido van Rossum | e83e380 | 1995-03-17 16:01:35 +0000 | [diff] [blame] | 326 | |
Guido van Rossum | 9cb6480 | 1997-12-29 20:01:55 +0000 | [diff] [blame] | 327 | # Note that LaTeX2HTML inserts references to an icons directory in |
| 328 | # each page that it generates. I have placed a copy of this directory |
| 329 | # in the distribution to simplify the process of creating a |
| 330 | # self-contained HTML distribution; for this purpose I have also added |
| 331 | # a (trivial) index.html. Change the definition of $ICONSERVER in |
Fred Drake | 9fab3aa | 1998-04-28 19:20:43 +0000 | [diff] [blame] | 332 | # perl/l2hinit.perl to use a different location for the icons directory. |
Guido van Rossum | e83e380 | 1995-03-17 16:01:35 +0000 | [diff] [blame] | 333 | |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 334 | COMMONPERL=perl/manual.perl perl/python.perl |
Fred Drake | bbe33c5 | 1998-05-07 01:39:06 +0000 | [diff] [blame] | 335 | |
Fred Drake | 34116ba | 1998-07-24 15:42:12 +0000 | [diff] [blame] | 336 | l2h html: |
Fred Drake | 96e1102 | 1998-08-07 18:01:37 +0000 | [diff] [blame^] | 337 | (TOPDIR=`pwd`; cd $(HTMLDIR); \ |
| 338 | $(MAKE) TEXINPUTS=../paper-$(PAPER):../texinputs: \ |
| 339 | -f $$TOPDIR/html/Makefile) |
Guido van Rossum | 6938f06 | 1994-08-01 12:22:53 +0000 | [diff] [blame] | 340 | |
Fred Drake | 96e1102 | 1998-08-07 18:01:37 +0000 | [diff] [blame^] | 341 | l2hapi: $(COMMONPERL) api/api.tex |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 342 | $(MKHTML) api $(L2HARGS) |
Guido van Rossum | 6938f06 | 1994-08-01 12:22:53 +0000 | [diff] [blame] | 343 | |
Fred Drake | 96e1102 | 1998-08-07 18:01:37 +0000 | [diff] [blame^] | 344 | l2hext: $(COMMONPERL) ext/ext.tex |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 345 | $(MKHTML) ext $(L2HARGS) |
Guido van Rossum | 970871f | 1993-02-21 20:10:26 +0000 | [diff] [blame] | 346 | |
Fred Drake | cdbd391 | 1998-05-15 17:02:10 +0000 | [diff] [blame] | 347 | l2hlib: $(COMMONPERL) $(LIBFILES) |
Fred Drake | 9fab3aa | 1998-04-28 19:20:43 +0000 | [diff] [blame] | 348 | $(srcdir)/tools/fix_libaux.sed <`$(KPSEWHICH) lib.aux` >lib1.aux |
| 349 | mv lib1.aux `$(KPSEWHICH) lib.aux` |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 350 | $(MKHTML) lib $(L2HARGS) |
Fred Drake | a6bb396 | 1998-05-06 19:51:39 +0000 | [diff] [blame] | 351 | |
Fred Drake | cdbd391 | 1998-05-15 17:02:10 +0000 | [diff] [blame] | 352 | l2hmac: $(COMMONPERL) $(MACLIBFILES) |
| 353 | $(srcdir)/tools/mkhowto.sh --html $(srcdir)/mac/mac.tex |
| 354 | |
Fred Drake | 96e1102 | 1998-08-07 18:01:37 +0000 | [diff] [blame^] | 355 | l2href: $(COMMONPERL) $(REFFILES) |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 356 | $(MKHTML) ref $(L2HARGS) |
Guido van Rossum | e83e380 | 1995-03-17 16:01:35 +0000 | [diff] [blame] | 357 | |
Fred Drake | 96e1102 | 1998-08-07 18:01:37 +0000 | [diff] [blame^] | 358 | l2htut: $(COMMONPERL) tut/tut.tex |
Fred Drake | f295113 | 1998-05-07 19:30:16 +0000 | [diff] [blame] | 359 | $(MKHTML) tut $(L2HARGS) |
Guido van Rossum | 9231c8f | 1997-05-15 21:43:21 +0000 | [diff] [blame] | 360 | |
Fred Drake | e4837a1 | 1998-03-06 21:29:34 +0000 | [diff] [blame] | 361 | # webchecker needs an extra flag to process the huge index from the libref |
| 362 | webcheck: |
Fred Drake | 79c0f0e | 1998-05-19 18:04:13 +0000 | [diff] [blame] | 363 | $(WEBCHECKER) file:`pwd`/$(HTMLDIR)/api/ |
| 364 | $(WEBCHECKER) file:`pwd`/$(HTMLDIR)/ext/ |
| 365 | $(WEBCHECKER) -m290000 file:`pwd`/$(HTMLDIR)/lib/ |
| 366 | $(WEBCHECKER) file:`pwd`/$(HTMLDIR)/mac/ |
| 367 | $(WEBCHECKER) file:`pwd`/$(HTMLDIR)/ref/ |
| 368 | $(WEBCHECKER) file:`pwd`/$(HTMLDIR)/tut/ |
Fred Drake | e4837a1 | 1998-03-06 21:29:34 +0000 | [diff] [blame] | 369 | |
Fred Drake | e34ab30 | 1998-05-11 21:10:15 +0000 | [diff] [blame] | 370 | lib-info-$(RELEASE).tgz: info |
Fred Drake | d69e2c4 | 1998-05-11 18:25:46 +0000 | [diff] [blame] | 371 | (cd $(INFODIR); tar cf - python-???.info*) | gzip -9 >$@ |
Fred Drake | a799835 | 1998-02-19 16:01:04 +0000 | [diff] [blame] | 372 | |
Fred Drake | e34ab30 | 1998-05-11 21:10:15 +0000 | [diff] [blame] | 373 | latex-$(RELEASE).tgz: |
Fred Drake | 29cabd4 | 1998-05-11 18:53:07 +0000 | [diff] [blame] | 374 | $(srcdir)/tools/mktarball.sh $(RELEASE) |
Fred Drake | e61d7af | 1998-03-05 16:37:34 +0000 | [diff] [blame] | 375 | |
Fred Drake | d19b9d6 | 1998-07-29 03:49:44 +0000 | [diff] [blame] | 376 | pdf-$(PAPER)-$(RELEASE).tgz: pdf |
Fred Drake | d69e2c4 | 1998-05-11 18:25:46 +0000 | [diff] [blame] | 377 | (cd paper-$(PAPER); tar cf - $(PDFFILES)) | gzip -9 >$@ |
Fred Drake | 04cf4dc | 1998-02-12 22:33:50 +0000 | [diff] [blame] | 378 | |
Fred Drake | d19b9d6 | 1998-07-29 03:49:44 +0000 | [diff] [blame] | 379 | postscript-$(PAPER)-$(RELEASE).tgz: ps |
Fred Drake | d69e2c4 | 1998-05-11 18:25:46 +0000 | [diff] [blame] | 380 | (cd paper-$(PAPER); tar cf - $(PSFILES)) | gzip -9 >$@ |
Fred Drake | 04cf4dc | 1998-02-12 22:33:50 +0000 | [diff] [blame] | 381 | |
Fred Drake | 96e1102 | 1998-08-07 18:01:37 +0000 | [diff] [blame^] | 382 | html-$(RELEASE).tgz: $(HTMLDIR)/api/api.html $(HTMLDIR)/ext/ext.html \ |
| 383 | $(HTMLDIR)/lib/lib.html $(HTMLDIR)/mac/mac.html \ |
| 384 | $(HTMLDIR)/ref/ref.html $(HTMLDIR)/tut/tut.html |
| 385 | |
Fred Drake | e34ab30 | 1998-05-11 21:10:15 +0000 | [diff] [blame] | 386 | html-$(RELEASE).tgz: |
| 387 | (cd $(HTMLDIR); tar cf - index.html ???/???.css ???/*.html */*.gif) \ |
Fred Drake | 29cabd4 | 1998-05-11 18:53:07 +0000 | [diff] [blame] | 388 | | gzip -9 >$@ |
Fred Drake | 33d05b9 | 1998-01-13 16:33:09 +0000 | [diff] [blame] | 389 | |
Fred Drake | a799835 | 1998-02-19 16:01:04 +0000 | [diff] [blame] | 390 | # convenience targets: |
| 391 | |
Fred Drake | e34ab30 | 1998-05-11 21:10:15 +0000 | [diff] [blame] | 392 | tarhtml: html-$(RELEASE).tgz |
Fred Drake | bbe33c5 | 1998-05-07 01:39:06 +0000 | [diff] [blame] | 393 | |
Fred Drake | e34ab30 | 1998-05-11 21:10:15 +0000 | [diff] [blame] | 394 | tarinfo: lib-info-$(RELEASE).tgz |
Fred Drake | a799835 | 1998-02-19 16:01:04 +0000 | [diff] [blame] | 395 | |
Fred Drake | e34ab30 | 1998-05-11 21:10:15 +0000 | [diff] [blame] | 396 | tarps: postscript-$(PAPER)-$(RELEASE).tgz |
Fred Drake | 33d05b9 | 1998-01-13 16:33:09 +0000 | [diff] [blame] | 397 | |
Fred Drake | e34ab30 | 1998-05-11 21:10:15 +0000 | [diff] [blame] | 398 | tarpdf: pdf-$(PAPER)-$(RELEASE).tgz |
Fred Drake | 04cf4dc | 1998-02-12 22:33:50 +0000 | [diff] [blame] | 399 | |
Fred Drake | e34ab30 | 1998-05-11 21:10:15 +0000 | [diff] [blame] | 400 | tarlatex: latex-$(RELEASE).tgz |
Fred Drake | e61d7af | 1998-03-05 16:37:34 +0000 | [diff] [blame] | 401 | |
Fred Drake | efc17bd | 1998-07-28 21:05:16 +0000 | [diff] [blame] | 402 | tarballs: tarpdf tarps tarhtml tarlatex |
Guido van Rossum | 84cca44 | 1997-11-25 20:49:09 +0000 | [diff] [blame] | 403 | |
Guido van Rossum | e83e380 | 1995-03-17 16:01:35 +0000 | [diff] [blame] | 404 | |
| 405 | # Housekeeping targets |
| 406 | |
Guido van Rossum | 9231c8f | 1997-05-15 21:43:21 +0000 | [diff] [blame] | 407 | # Remove temporary files; all except the following: |
Fred Drake | 6659c30 | 1998-03-03 22:02:19 +0000 | [diff] [blame] | 408 | # - sources: .tex, .bib, .sty, *.cls |
Fred Drake | 04cf4dc | 1998-02-12 22:33:50 +0000 | [diff] [blame] | 409 | # - useful results: .dvi, .pdf, .ps, .texi, .info |
Fred Drake | e4837a1 | 1998-03-06 21:29:34 +0000 | [diff] [blame] | 410 | clean: |
Fred Drake | f54556e | 1998-08-04 20:53:55 +0000 | [diff] [blame] | 411 | (cd paper-$(PAPER); \ |
| 412 | rm -f *~ *.aux *.idx *.ilg *.ind *.log *.toc *.bkm *.syn) |
Fred Drake | e34ab30 | 1998-05-11 21:10:15 +0000 | [diff] [blame] | 413 | (cd $(INFODIR); $(MAKE) clean) |
Fred Drake | b9838d9 | 1998-05-08 15:43:08 +0000 | [diff] [blame] | 414 | (cd $(HTMLDIR); rm -f @webchecker.pickle) |
Fred Drake | e34ab30 | 1998-05-11 21:10:15 +0000 | [diff] [blame] | 415 | rm -f html-$(RELEASE).tgz info-$(RELEASE).tgz |
| 416 | rm -f pdf-$(RELEASE).tgz postscript-$(RELEASE).tgz |
| 417 | rm -f latex-$(RELEASE).tgz |
Guido van Rossum | 5b34373 | 1992-07-07 09:06:34 +0000 | [diff] [blame] | 418 | |
Fred Drake | 03ff6f7 | 1997-08-22 18:18:54 +0000 | [diff] [blame] | 419 | l2hclean: |
Fred Drake | b9838d9 | 1998-05-08 15:43:08 +0000 | [diff] [blame] | 420 | (cd $(HTMLDIR); rm -rf api ext lib ref tut) |
Fred Drake | 03ff6f7 | 1997-08-22 18:18:54 +0000 | [diff] [blame] | 421 | |
Guido van Rossum | e83e380 | 1995-03-17 16:01:35 +0000 | [diff] [blame] | 422 | # Remove temporaries as well as final products |
Fred Drake | e4837a1 | 1998-03-06 21:29:34 +0000 | [diff] [blame] | 423 | clobber: clean l2hclean |
Fred Drake | b9838d9 | 1998-05-08 15:43:08 +0000 | [diff] [blame] | 424 | (cd paper-$(PAPER); rm -f $(DVIFILES) $(PSFILES) $(PDFFILES)) |
Fred Drake | e34ab30 | 1998-05-11 21:10:15 +0000 | [diff] [blame] | 425 | (cd $(INFODIR); $(MAKE) clobber) |
Fred Drake | 5ad78f3 | 1998-02-22 19:47:13 +0000 | [diff] [blame] | 426 | |
| 427 | realclean: clobber |
| 428 | distclean: clobber |