summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorGuido van Rossum <guido@python.org>1992-04-05 15:06:03 (GMT)
committerGuido van Rossum <guido@python.org>1992-04-05 15:06:03 (GMT)
commitcd7bf39c16fefa801f479ad46e9b3f4a6735c0ed (patch)
tree7116f61a76d5b56c58f68308006bf1512e925531 /Doc
parentbab9d0385585fcddf6ee96a4ca38dd18e3517f54 (diff)
downloadcpython-cd7bf39c16fefa801f479ad46e9b3f4a6735c0ed.zip
cpython-cd7bf39c16fefa801f479ad46e9b3f4a6735c0ed.tar.gz
cpython-cd7bf39c16fefa801f479ad46e9b3f4a6735c0ed.tar.bz2
Made ready for release
Diffstat (limited to 'Doc')
-rw-r--r--Doc/README33
1 files changed, 23 insertions, 10 deletions
diff --git a/Doc/README b/Doc/README
index b0ac174..0391e55 100644
--- a/Doc/README
+++ b/Doc/README
@@ -1,5 +1,8 @@
-This directory contains the LaTeX source to the Python documentation.
-It is not all finished, but good enough to get you started.
+Python main documentation -- in LaTeX
+-------------------------------------
+
+This directory contains the LaTeX sources to the Python documentation
+and a published article about Python.
The following are the LaTeX source files:
@@ -9,16 +12,26 @@ The following are the LaTeX source files:
qua.tex, quabib.bib Article published in CWI Quarterly
All except qua.tex use the style option file "myformat.sty". This
-contains some macro definitions and sets style parameters. You can
-easily edit it to change the paper size (the default is European
-paper, "A4": 21 x 29.7 cm).
+contains some macro definitions and sets some style parameters.
+
+All documents are set up for European paper size ("A4": 21 x 29.7 cm)
+by default. To use US paper, remove the "a4wide" style option from
+the \documentstyle options list in the first line of the main .tex
+files (you may want to fiddle with the lay-out parameters, since the
+default format uses rather wide margins to my taste).
-There's a Makefile to call latex and other utilities (makeindex and
-bibtex) in the right order and the right number of times. This will
-produce dvi files for each document made; to preview them, use xdvi.
-Printing depends on local conventions; at my site, I use dvips and
-lpr. For example:
+You need the makeindex utility to produce the index for ref.tex
+lib.tex; you need bibtex to produce the references list for qua.tex.
+
+There's a Makefile to call latex and the other utilities in the right
+order and the right number of times. This will produce dvi files for
+each document made; to preview them, use xdvi. Printing depends on
+local conventions; at my site, I use dvips and lpr. For example:
make ref # creates ref.dvi
xdvi ref # preview it
dvips -Ppsc ref | lpr -Ppsc # print it on printer "psc".
+
+If you don't have latex, you can ftp the pre-formatted PosytScript
+versions of the documents; see "../misc/FTP" for information about
+ftp-ing Python files.