cpython/Doc
Guido van Rossum 6c4f003202 changes (suggested) by Soren Larsen 1995-03-07 10:14:09 +00:00
..
ext Moved author and date to boilerplate.tex. 1994-10-06 10:29:26 +00:00
info Oops! version numbers again! 1994-10-06 17:08:42 +00:00
lib changes (suggested) by Soren Larsen 1995-03-07 10:14:09 +00:00
mac The final bit of my Mac documentation. 1995-03-02 14:41:55 +00:00
ref clarified code objects 1995-03-07 10:09:55 +00:00
templates small nits and new files 1995-03-01 15:38:16 +00:00
texinputs fix version number 1995-02-14 09:46:19 +00:00
tools Can't remember the reason for the change, but it was necessary. :-) 1994-12-14 15:28:22 +00:00
tut a few typographical changes (e.g. -- => ---) and lots of new stuff in the WWW chapter 1995-02-28 17:14:32 +00:00
.cvsignore Merge alpha100 branch back to main trunk 1994-08-01 12:22:53 +00:00
Makefile added macdnr 1995-03-07 10:12:11 +00:00
README Merge alpha100 branch back to main trunk 1994-08-01 12:22:53 +00:00
boilerplate.tex fix version number 1995-02-14 09:46:19 +00:00
copyright.tex copyright.tex: Add 1995 to copyright message. 1995-01-04 19:17:34 +00:00
ext.tex Moved author and date to boilerplate.tex. 1994-10-06 10:29:26 +00:00
fix.el Merge alpha100 branch back to main trunk 1994-08-01 12:22:53 +00:00
fix_hack Merge alpha100 branch back to main trunk 1994-08-01 12:22:53 +00:00
keywords.py libsocket.tex: send[to] returns nbytes. 1994-08-01 12:18:36 +00:00
lib.tex added macdnr 1995-03-07 10:12:11 +00:00
libaifc.tex Added documentation on the aifc module. 1994-09-29 16:46:42 +00:00
libal.tex Lots of small corrections by Andrew Kuchling (plus all new rotor docs) 1994-08-08 12:30:22 +00:00
libamoeba.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libarray.tex changes (suggested) by Soren Larsen 1995-03-07 10:14:09 +00:00
libaudio.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libaudioop.tex Lots of small corrections by Andrew Kuchling (plus all new rotor docs) 1994-08-08 12:30:22 +00:00
libbltin.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libcgi.tex changes (suggested) by Soren Larsen 1995-03-07 10:14:09 +00:00
libcopy.tex added docs for pickle, shelve and copy 1995-02-15 15:53:08 +00:00
libcrypto.tex Lots of small corrections by Andrew Kuchling (plus all new rotor docs) 1994-08-08 12:30:22 +00:00
libctb.tex Added a missing line 1995-03-01 14:06:52 +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
libfcntl.tex Lots of small corrections by Andrew Kuchling (plus all new rotor docs) 1994-08-08 12:30:22 +00:00
libfl.tex Lots of small corrections by Andrew Kuchling (plus all new rotor docs) 1994-08-08 12:30:22 +00:00
libfm.tex Lots of small corrections by Andrew Kuchling (plus all new rotor docs) 1994-08-08 12:30:22 +00:00
libftplib.tex a few typographical changes (e.g. -- => ---) and lots of new stuff in the WWW chapter 1995-02-28 17:14:32 +00:00
libfuncs.tex changes (suggested) by Soren Larsen 1995-03-07 10:14:09 +00:00
libgdbm.tex Added gdbm docs 1994-08-08 08:03:24 +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
libgopherlib.tex a few typographical changes (e.g. -- => ---) and lots of new stuff in the WWW chapter 1995-02-28 17:14:32 +00:00
libgrp.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libhtmllib.tex clarified expanding %xx and form for print_form 1995-03-07 10:12:59 +00:00
libhttplib.tex changes (suggested) by Soren Larsen 1995-03-07 10:14:09 +00:00
libimageop.tex Lots of small corrections by Andrew Kuchling (plus all new rotor docs) 1994-08-08 12:30:22 +00:00
libimgfile.tex Lots of small corrections by Andrew Kuchling (plus all new rotor docs) 1994-08-08 12:30:22 +00:00
libimp.tex changes (suggested) by Soren Larsen 1995-03-07 10:14:09 +00:00
libintro.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libjpeg.tex Lots of small corrections by Andrew Kuchling (plus all new rotor docs) 1994-08-08 12:30:22 +00:00
libmac.tex small nits and new files 1995-03-01 15:38:16 +00:00
libmacconsole.tex a few typographical changes (e.g. -- => ---) and lots of new stuff in the WWW chapter 1995-02-28 17:14:32 +00:00
libmacdnr.tex The final bit of my Mac documentation. 1995-03-02 14:41:55 +00:00
libmacfs.tex a few typographical changes (e.g. -- => ---) and lots of new stuff in the WWW chapter 1995-02-28 17:14:32 +00:00
libmacspeech.tex a few typographical changes (e.g. -- => ---) and lots of new stuff in the WWW chapter 1995-02-28 17:14:32 +00:00
libmactcp.tex Half the mactcp documentation (macdnr still to come) 1995-03-01 14:54:30 +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 copyright.tex: Add 1995 to copyright message. 1995-01-04 19:17:34 +00:00
libmd5.tex copyright.tex: Add 1995 to copyright message. 1995-01-04 19:17:34 +00:00
libmimetools.tex a few typographical changes (e.g. -- => ---) and lots of new stuff in the WWW chapter 1995-02-28 17:14:32 +00:00
libmm.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libmods.tex Lots of small corrections by Andrew Kuchling (plus all new rotor docs) 1994-08-08 12:30:22 +00:00
libmpz.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libnntplib.tex a few typographical changes (e.g. -- => ---) and lots of new stuff in the WWW chapter 1995-02-28 17:14:32 +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
libpdb.tex changes (suggested) by Soren Larsen 1995-03-07 10:14:09 +00:00
libpickle.tex added docs for pickle, shelve and copy 1995-02-15 15:53:08 +00:00
libposix.tex optional bufsize arg for popen and fdopen 1995-01-12 12:38:22 +00:00
libposixfile.tex copyright.tex: Add 1995 to copyright message. 1995-01-04 19:17:34 +00:00
libppath.tex Documented new built-in function vars(). 1994-04-21 10:32:28 +00:00
libprofile.tex changes (suggested) by Soren Larsen 1995-03-07 10:14:09 +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 changes (suggested) by Soren Larsen 1995-03-07 10:14:09 +00:00
libregsub.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
librfc822.tex changes (suggested) by Soren Larsen 1995-03-07 10:14:09 +00:00
librgbimg.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
librotor.tex Lots of small corrections by Andrew Kuchling (plus all new rotor docs) 1994-08-08 12:30:22 +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
libsgmllib.tex changes (suggested) by Soren Larsen 1995-03-07 10:14:09 +00:00
libshelve.tex added list of restrictions 1995-02-16 16:29:01 +00:00
libsignal.tex added lots of useful info 1995-02-15 15:52:32 +00:00
libsocket.tex a few typographical changes (e.g. -- => ---) and lots of new stuff in the WWW chapter 1995-02-28 17:14:32 +00:00
libstd.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libstdwin.tex Lots of small corrections by Andrew Kuchling (plus all new rotor docs) 1994-08-08 12:30:22 +00:00
libstring.tex add warning about strop 1995-03-02 12:37:30 +00:00
libstruct.tex changes (suggested) by Soren Larsen 1995-03-07 10:14:09 +00:00
libsun.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libsys.tex changes (suggested) by Soren Larsen 1995-03-07 10:14:09 +00:00
libtempfile.tex en weer twee! 1995-03-01 14:36:00 +00:00
libtemplate.tex small nits and new files 1995-03-01 15:38:16 +00:00
libthread.tex * Doc/libfuncs.tex: don't use $math$ in description of pow(x,y,z); 1994-08-12 13:13:50 +00:00
libtime.tex changes (suggested) by Soren Larsen 1995-03-07 10:14:09 +00:00
libtraceback.tex en weer twee! 1995-03-01 14:36:00 +00:00
libtypes.tex added code objects 1995-03-07 10:11:15 +00:00
libtypes2.tex small nits and new files 1995-03-01 15:38:16 +00:00
libunix.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
liburllib.tex changes (suggested) by Soren Larsen 1995-03-07 10:14:09 +00:00
liburlparse.tex a few typographical changes (e.g. -- => ---) and lots of new stuff in the WWW chapter 1995-02-28 17:14:32 +00:00
libwhrandom.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libwww.tex added cgi 1995-02-27 17:51:26 +00:00
myformat.perl * Doc/libfuncs.tex: don't use $math$ in description of pow(x,y,z); 1994-08-12 13:13:50 +00:00
myformat.sty Lots of small corrections by Andrew Kuchling (plus all new rotor docs) 1994-08-08 12:30:22 +00:00
partparse.py Can't remember the reason for the change, but it was necessary. :-) 1994-12-14 15:28:22 +00:00
qua.tex Lots of small corrections by Andrew Kuchling (plus all new rotor docs) 1994-08-08 12:30:22 +00:00
quabib.bib Initial revision 1992-02-11 15:52:24 +00:00
ref.tex Moved author and date to boilerplate.tex. 1994-10-06 10:29:26 +00:00
ref1.tex Lots of small corrections by Andrew Kuchling (plus all new rotor docs) 1994-08-08 12:30:22 +00:00
ref2.tex Lots of small corrections by Andrew Kuchling (plus all new rotor docs) 1994-08-08 12:30:22 +00:00
ref3.tex clarified code objects 1995-03-07 10:09:55 +00:00
ref4.tex added ref to vars() 1995-03-07 10:09:34 +00:00
ref5.tex copyright.tex: Add 1995 to copyright message. 1995-01-04 19:17:34 +00:00
ref6.tex added ref to vars() 1995-03-07 10:09:34 +00:00
ref7.tex added classes as exceptions 1995-02-07 14:37:17 +00:00
ref8.tex Merge lost revisions back 1994-08-01 12:38:14 +00:00
texipost.dat Incorporated Jan-Hein's changes and texinfo conversion. 1992-12-08 14:37:55 +00:00
texipre.dat Oops! version numbers again! 1994-10-06 17:08:42 +00:00
text2latex.py * text2latex.py: call main() instead of always processing ext.tex. 1993-11-19 13:13:22 +00:00
tut.tex a few typographical changes (e.g. -- => ---) and lots of new stuff in the WWW chapter 1995-02-28 17:14:32 +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*.tex		The library reference
	ref.tex, ref[1-8].tex		The reference manual
	ext.tex				How to extend Python
	qua.tex, quabib.bib		Article published in CWI Quarterly

All except qua.tex (which isn't built by the default target) 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.  It should be in the same place where you
fetched the main Python distribution, if you got it by ftp.  (See
"../Misc/FAQ" 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 lib.info".  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 isn't installed by default at your site, you'll have to
install it (use archie to locate a version and ftp to fetch it).  If
you can't install it in the standard Emacs load path, uncomment the
line containing a "(setq load-path ...)" statement, and fill in the
path where you put it.

The files used by the conversion process are:

partparse.py            Python script that converts LaTeX sources to
			texi files.

texi{pre,post}.dat      Files placed before and after the result.

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

fix_hack		Shell script to fix the results of the
                        "underscore hack". {\ptt \char'137} is
                        back-translated to a simple underscore.  This
                        is needed for the texindex program.

whichlibs		Shell script to print a list of lib*.tex files
			to be processed.

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!