cpython/Doc
Guido van Rossum c5c67bc367 At release 1.0.1. Scripts, Makefile, README: cosmetic changes and
streamlined procedure; tut.tex: fixes by Tim Peters; libposix.tex:
added posix.fdopen; ext.tex: typos
1994-02-15 15:59:23 +00:00
..
ext Documented the fact that IRIX 5.x also supports Sun style shared 1994-01-01 17:32:24 +00:00
info * ext.tex: documentation for extending, reference counts, and embedding 1993-11-05 14:45:11 +00:00
lib At release 1.0.1. Scripts, Makefile, README: cosmetic changes and 1994-02-15 15:59:23 +00:00
mac Restructured library documentation 1994-01-02 01:22:07 +00:00
ref * lib2.tex (sys): updated sys.std{in,out,err} docs. Added 1993-12-17 12:13:53 +00:00
templates Initial revision 1992-06-03 17:59:07 +00:00
tools At release 1.0.1. Scripts, Makefile, README: cosmetic changes and 1994-02-15 15:59:23 +00:00
tut * lib2.tex (sys): updated sys.std{in,out,err} docs. Added 1993-12-17 12:13:53 +00:00
.cvsignore lib1.tex: Added builtin.round(x, [n]). 1993-02-12 16:29:30 +00:00
Makefile * lib2.tex (sys): updated sys.std{in,out,err} docs. Added 1993-12-17 12:13:53 +00:00
README Incorporated Jan-Hein's changes and texinfo conversion. 1992-12-08 14:37:55 +00:00
ext.tex Documented the fact that IRIX 5.x also supports Sun style shared 1994-01-01 17:32:24 +00:00
fix.el * ext.tex: documentation for extending, reference counts, and embedding 1993-11-05 14:45:11 +00:00
fix_hack Incorporated Jan-Hein's changes and texinfo conversion. 1992-12-08 14:37:55 +00:00
lib.tex * {lib,ref,ext,tut}.tex: added explicit \date{<date> \\ <release>}. 1993-11-23 16:28:45 +00:00
libal.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libamoeba.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libarray.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libaudio.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libaudioop.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libbltin.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libcrypto.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libdbm.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libexcs.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libfl.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libfm.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libfuncs.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libgetopt.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libgl.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libgrp.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libimageop.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libimgfile.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libintro.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libjpeg.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libmac.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libmain.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libmarshal.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libmath.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libmd5.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libmm.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libmods.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libmpz.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libobjs.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libos.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libpanel.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libposix.tex At release 1.0.1. Scripts, Makefile, README: cosmetic changes and 1994-02-15 15:59:23 +00:00
libppath.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libpwd.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
librand.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libregex.tex Added symcomp and resulting new data items 1994-01-03 00:00:31 +00:00
libregsub.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
librgbimg.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
librotor.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libselect.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libsgi.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libsocket.tex s.avail() has met its maker 1994-01-03 14:07:23 +00:00
libstd.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libstdwin.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libstring.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libstruct.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libsun.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libsys.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libtemplate.tex Initial revision 1992-06-03 17:59:07 +00:00
libthread.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libtime.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libtypes.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libunix.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libwhrandom.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
myformat.perl Support for latex2html (at version 0.5.1) 1994-01-25 20:06:09 +00:00
myformat.sty Incorporated Jan-Hein's changes and texinfo conversion. 1992-12-08 14:37:55 +00:00
partparse.py * ext.tex: documentation for extending, reference counts, and embedding 1993-11-05 14:45:11 +00:00
qua.tex * ext.tex: did most of the tedious changes from plain ASCII text to LaTeX. 1993-11-05 17:11:16 +00:00
quabib.bib Initial revision 1992-02-11 15:52:24 +00:00
ref.tex * {lib,ref,ext,tut}.tex: added explicit \date{<date> \\ <release>}. 1993-11-23 16:28:45 +00:00
ref1.tex Initial revision 1992-08-14 09:11:01 +00:00
ref2.tex Initial revision 1992-08-14 09:11:01 +00:00
ref3.tex * ext.tex: documentation for extending, reference counts, and embedding 1993-11-05 14:45:11 +00:00
ref4.tex * lib3.tex (module string): added rindex(). 1993-10-27 13:49:20 +00:00
ref5.tex * lib2.tex (sys): updated sys.std{in,out,err} docs. Added 1993-12-17 12:13:53 +00:00
ref6.tex "exec" is now a statement. execfile() is obsolete. 1993-10-18 17:59:42 +00:00
ref7.tex * lib2.tex (sys): updated sys.std{in,out,err} docs. Added 1993-12-17 12:13:53 +00:00
ref8.tex * lib3.tex (module string): added rindex(). 1993-10-27 13:49:20 +00:00
texipost.dat Incorporated Jan-Hein's changes and texinfo conversion. 1992-12-08 14:37:55 +00:00
texipre.dat * ext.tex: documentation for extending, reference counts, and embedding 1993-11-05 14:45:11 +00:00
text2latex.py * text2latex.py: call main() instead of always processing ext.tex. 1993-11-19 13:13:22 +00:00
tut.tex * lib2.tex (sys): updated sys.std{in,out,err} docs. Added 1993-12-17 12:13:53 +00:00
whichlibs At release 1.0.1. Scripts, Makefile, README: cosmetic changes and 1994-02-15 15:59:23 +00:00

README

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:

	tut.tex				The tutorial
	lib.tex, lib[1-5].tex		The library reference
	ref.tex, ref[1-8].tex		The reference manual
	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 some style parameters.

The style parameters are set up for European paper size (21 x 29.7 cm,
a.k.a. A4, or roughly 8.27 x 11.7 inch) by default.  To use US paper,
comment out the line saying \input{a4wide.sty} in myformat.sty (you
may want to fiddle with lay-out parameters like \textwidth and
\textheight, since the default format uses rather wide margins).

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.

Making the INFO version of the Library Reference
------------------------------------------------

The Library Reference can now also be read in hypertext form using the
Emacs INFO system.  This uses Texinfo format as an intermediate step.
It requires texinfo version 2 (we have used 2.14).

To build the info files (python-lib.info*), say "make libinfo".  This
takes a while, even on machines with 33 MIPS and 16 Mbytes :-) You can
ignore the output.

But first you'll have to change a site dependency in fix.el: if
texinfo 2.xx is installed by default at your site, comment out the two
lines starting with "(setq load-path"; if it isn't, change the path!
(I'm afraid that if you don't have texinfo 2.xx this won't work -- use
archie to locate a version and ftp to fetch it.)

The files used by the conversion process are:

partparse.py            the dirty-written Python script that converts
                        LaTeX sources to texi files. Output is left in
                        `@out.texi'

texi{pre,post}.dat      these files will be put before and after the
                        result

fix.sh                  calls emacs in order to update all the nodes and
                        menus. After this, makeinfo will convert the
                        texinfo-source to the info-file(s). Assumption:
                        the texi-source is called `@out.texi'

fix.el                  the elisp-file executed by emacs. Two calls to
                        'texinfo-all-menus-update are necessary in
			some cases

fix_hack                executable shell script that fixes the results
                        of the underscore hack. {\ptt \char'137} is
                        back-translated to a simple underscore. This is
                        needed for the texindex program

handy.el                some handy Emacs-macro's that helped converting
                        ``old'' documentation to a format that could be
                        understood by the converter scipt (partparse.py).
			(You don't really need this, but, as the name
			says, these macros are "handy")

A Million thanks for Jan-Hein B\"uhrman for writing and debugging the
convertor and related scripts, and for fixing the LaTeX sources and
writing new macros for myformat.sty!