From 676d6dadb97904d2c75e3bb1abe1690a96fd6a9a Mon Sep 17 00:00:00 2001 From: Guido van Rossum Date: Tue, 11 Feb 1992 15:51:36 +0000 Subject: [PATCH] Added ref and qua; forget about the Makefile --- Doc/README | 46 +++++++++++++++++++++++++++++----------------- 1 file changed, 29 insertions(+), 17 deletions(-) diff --git a/Doc/README b/Doc/README index 831afac16cc..2dbdcda97d3 100644 --- a/Doc/README +++ b/Doc/README @@ -1,24 +1,36 @@ This directory contains the LaTeX source to the Python documentation. -The documentation is not all finished, but good enough to get you -started. +It is not all finished, but good enough to get you started. -The following are the important latex source files: +The following are the LaTeX source files: - tut.tex A tutorial + tut.tex The tutorial lib.tex, lib[1-5].tex The library reference + ref.tex The reference manual + qua.tex, quabib.bib Article published in CWI Quarterly -They both read the style option file "myformat.sty". +All except qua.tex use the style option file "myformat.sty". This +contains some simple macro definitions and sets style parameters. You +can easily edit it to change the paper size (the default is European +paper, "A4" or 21 x 29.7 cm). -You can use the Makefile to format, preview and print the documents. -Type "make tut" or "make mod" to preview either document with xdvi. -Type "make print" to print them both (this only works if your print -spooler is set up just like mine...), or "make all" to create postscript -files that you can you can print using your local printing commands. -Type "make clean" to get rid of all the intermediate files produced by -the latex process, and other junk files. +To format a document, run latex on it, twice, to get the forward +references right, then use dvips and lpr to print it, e.g.: -You can just as well ignore the Makefile; all you really need is: - latex tut - latex tut - dvips tut | lpr -and similar for the "mod" document. + latex lib + latex lib + dvips lib | lpr + +Before calling dvips and lpr, you should really preview the dvi file, +e.g. + + xdvi lib + +The qua document (which is not user documentation but a somewhat more +abstract review of Python and some work for which it was used) needs +a little more work: + + latex qua + latex qua + bibtex qua + latex qua + dvips qua | lpr