|
1 | 1 | This directory contains the LaTeX source to the Python documentation. |
2 | | -The documentation is not all finished, but good enough to get you |
3 | | -started. |
| 2 | +It is not all finished, but good enough to get you started. |
4 | 3 |
|
5 | | -The following are the important latex source files: |
| 4 | +The following are the LaTeX source files: |
6 | 5 |
|
7 | | - tut.tex A tutorial |
| 6 | + tut.tex The tutorial |
8 | 7 | lib.tex, lib[1-5].tex The library reference |
| 8 | + ref.tex The reference manual |
| 9 | + qua.tex, quabib.bib Article published in CWI Quarterly |
9 | 10 |
|
10 | | -They both read the style option file "myformat.sty". |
11 | | - |
12 | | -You can use the Makefile to format, preview and print the documents. |
13 | | -Type "make tut" or "make mod" to preview either document with xdvi. |
14 | | -Type "make print" to print them both (this only works if your print |
15 | | -spooler is set up just like mine...), or "make all" to create postscript |
16 | | -files that you can you can print using your local printing commands. |
17 | | -Type "make clean" to get rid of all the intermediate files produced by |
18 | | -the latex process, and other junk files. |
19 | | - |
20 | | -You can just as well ignore the Makefile; all you really need is: |
21 | | - latex tut |
22 | | - latex tut |
23 | | - dvips tut | lpr |
24 | | -and similar for the "mod" document. |
| 11 | +All except qua.tex use the style option file "myformat.sty". This |
| 12 | +contains some simple macro definitions and sets style parameters. You |
| 13 | +can easily edit it to change the paper size (the default is European |
| 14 | +paper, "A4" or 21 x 29.7 cm). |
| 15 | + |
| 16 | +To format a document, run latex on it, twice, to get the forward |
| 17 | +references right, then use dvips and lpr to print it, e.g.: |
| 18 | + |
| 19 | + latex lib |
| 20 | + latex lib |
| 21 | + dvips lib | lpr |
| 22 | + |
| 23 | +Before calling dvips and lpr, you should really preview the dvi file, |
| 24 | +e.g. |
| 25 | + |
| 26 | + xdvi lib |
| 27 | + |
| 28 | +The qua document (which is not user documentation but a somewhat more |
| 29 | +abstract review of Python and some work for which it was used) needs |
| 30 | +a little more work: |
| 31 | + |
| 32 | + latex qua |
| 33 | + latex qua |
| 34 | + bibtex qua |
| 35 | + latex qua |
| 36 | + dvips qua | lpr |
0 commit comments