| Guido van Rossum | cd7bf39 | 1992-04-05 15:06:03 +0000 | [diff] [blame] | 1 | Python main documentation -- in LaTeX |
| 2 | ------------------------------------- |
| 3 | |
| 4 | This directory contains the LaTeX sources to the Python documentation |
| 5 | and a published article about Python. |
| Guido van Rossum | 7f777ed | 1990-08-09 14:25:15 +0000 | [diff] [blame] | 6 | |
| Guido van Rossum | 676d6da | 1992-02-11 15:51:36 +0000 | [diff] [blame] | 7 | The following are the LaTeX source files: |
| Guido van Rossum | 7f777ed | 1990-08-09 14:25:15 +0000 | [diff] [blame] | 8 | |
| Guido van Rossum | 676d6da | 1992-02-11 15:51:36 +0000 | [diff] [blame] | 9 | tut.tex The tutorial |
| Guido van Rossum | ddfb3eb | 1991-11-12 15:40:23 +0000 | [diff] [blame] | 10 | lib.tex, lib[1-5].tex The library reference |
| Guido van Rossum | 676d6da | 1992-02-11 15:51:36 +0000 | [diff] [blame] | 11 | ref.tex The reference manual |
| 12 | qua.tex, quabib.bib Article published in CWI Quarterly |
| Guido van Rossum | 7f777ed | 1990-08-09 14:25:15 +0000 | [diff] [blame] | 13 | |
| Guido van Rossum | 676d6da | 1992-02-11 15:51:36 +0000 | [diff] [blame] | 14 | All except qua.tex use the style option file "myformat.sty". This |
| Guido van Rossum | cd7bf39 | 1992-04-05 15:06:03 +0000 | [diff] [blame] | 15 | contains some macro definitions and sets some style parameters. |
| Guido van Rossum | 7f777ed | 1990-08-09 14:25:15 +0000 | [diff] [blame] | 16 | |
| Guido van Rossum | d18b8af | 1992-04-06 14:02:37 +0000 | [diff] [blame^] | 17 | The style parameters are set up for European paper size (21 x 29.7 cm, |
| 18 | a.k.a. A4, or roughly 8.27 x 11.7 inch) by default. To use US paper, |
| 19 | comment out the line saying \input{a4wide.sty} in myformat.sty (you |
| 20 | may want to fiddle with lay-out parameters like \textwidth and |
| 21 | \textheight, since the default format uses rather wide margins). |
| Guido van Rossum | cd7bf39 | 1992-04-05 15:06:03 +0000 | [diff] [blame] | 22 | |
| 23 | You need the makeindex utility to produce the index for ref.tex |
| 24 | lib.tex; you need bibtex to produce the references list for qua.tex. |
| 25 | |
| 26 | There's a Makefile to call latex and the other utilities in the right |
| 27 | order and the right number of times. This will produce dvi files for |
| 28 | each document made; to preview them, use xdvi. Printing depends on |
| 29 | local conventions; at my site, I use dvips and lpr. For example: |
| Guido van Rossum | 7f777ed | 1990-08-09 14:25:15 +0000 | [diff] [blame] | 30 | |
| Guido van Rossum | 0e5f009 | 1992-03-06 10:56:17 +0000 | [diff] [blame] | 31 | make ref # creates ref.dvi |
| 32 | xdvi ref # preview it |
| 33 | dvips -Ppsc ref | lpr -Ppsc # print it on printer "psc". |
| Guido van Rossum | cd7bf39 | 1992-04-05 15:06:03 +0000 | [diff] [blame] | 34 | |
| 35 | If you don't have latex, you can ftp the pre-formatted PosytScript |
| 36 | versions of the documents; see "../misc/FTP" for information about |
| 37 | ftp-ing Python files. |