]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
Added ref and qua; forget about the Makefile
authorGuido van Rossum <guido@python.org>
Tue, 11 Feb 1992 15:51:36 +0000 (15:51 +0000)
committerGuido van Rossum <guido@python.org>
Tue, 11 Feb 1992 15:51:36 +0000 (15:51 +0000)
Doc/README

index 831afac16ccb5cb07f20a3031c6515eda3c39347..2dbdcda97d3ded3ec545883d260e7e5606981d72 100644 (file)
@@ -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".
-
-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.
-
-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.
+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).
+
+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.:
+
+       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