summaryrefslogtreecommitdiffstats
path: root/Doc/README
diff options
context:
space:
mode:
authorGuido van Rossum <guido@python.org>1992-02-11 15:51:36 (GMT)
committerGuido van Rossum <guido@python.org>1992-02-11 15:51:36 (GMT)
commit676d6dadb97904d2c75e3bb1abe1690a96fd6a9a (patch)
treeb7f7e0616ba2facc5605c0b6d37e7a63c338d83b /Doc/README
parent19f2aec581482d233ce66439963d8fdaa7605c23 (diff)
downloadcpython-676d6dadb97904d2c75e3bb1abe1690a96fd6a9a.zip
cpython-676d6dadb97904d2c75e3bb1abe1690a96fd6a9a.tar.gz
cpython-676d6dadb97904d2c75e3bb1abe1690a96fd6a9a.tar.bz2
Added ref and qua; forget about the Makefile
Diffstat (limited to 'Doc/README')
-rw-r--r--Doc/README50
1 files changed, 31 insertions, 19 deletions
diff --git a/Doc/README b/Doc/README
index 831afac..2dbdcda 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".
-
-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