cpython/Doc
Fred Drake 55a7cf3ee7 Update documentation release date. 1998-03-05 17:15:26 +00:00
..
api Convert LaTeX support to create a new class of documents. HTML generation 1998-03-03 22:02:19 +00:00
ext Simplify some of the escaping around ']' in \item[...] markup in light of 1998-03-04 03:51:42 +00:00
html Simple index for the reference manuals (mostly for use on the Windows 1997-11-25 18:27:23 +00:00
icons Adding the icons used by latex2html output to the CVS tree. 1997-11-25 20:14:07 +00:00
info Nit to prevent empty node in formatted version. 1998-02-27 05:21:36 +00:00
lib Convert LaTeX support to create a new class of documents. HTML generation 1998-03-03 22:02:19 +00:00
mac The list of module descriptions should be a {description} environment, not 1998-02-21 06:30:17 +00:00
perl For verbatim text, don't bounce down a size. 1998-03-05 17:00:55 +00:00
ref Removed a confusing note about coercions and __r*__ operators. 1998-01-19 23:16:55 +00:00
templates Logical markup. 1998-02-24 21:43:05 +00:00
texinputs Update documentation release date. 1998-03-05 17:15:26 +00:00
tools Build a tarball that extracts to Python-$VERSION/Doc/ instead of Doc/, 1998-03-05 16:31:22 +00:00
tut Convert LaTeX support to create a new class of documents. HTML generation 1998-03-03 22:02:19 +00:00
.cvsignore Ignore tarballs. 1998-03-03 17:14:23 +00:00
.latex2html-init Preliminary LaTeX2HTML 98.1p1 support. Includes patch from Ross Moore to 1998-03-04 05:36:59 +00:00
Makefile latex-$(VERSION).tar.gz, tarlatex: Create the source distribution. 1998-03-05 16:37:34 +00:00
README Update URL to get Perl. (Anyone want to re-write LaTeX2HTML in Python? ;) 1998-03-04 15:21:02 +00:00
TODO Remove item on migration to LaTeX2e document classes. Done. 1998-03-04 17:35:00 +00:00
api.tex Convert LaTeX support to create a new class of documents. HTML generation 1998-03-03 22:02:19 +00:00
boilerplate.tex Update documentation release date. 1998-03-05 17:15:26 +00:00
copyright.tex Mark the URL "ftp://ftp.python.org" with \url{}. 1998-02-11 14:42:06 +00:00
custlib.py A nicety (author lost). 1997-06-02 17:57:10 +00:00
ext.tex Simplify some of the escaping around ']' in \item[...] markup in light of 1998-03-04 03:51:42 +00:00
fix.el Work on a temporary file, not the input file. 1998-02-19 16:01:41 +00:00
fix_hack Merge alpha100 branch back to main trunk 1994-08-01 12:22:53 +00:00
fix_libaux.sed (fix_libaux.sed): Hackish little sed script to modify lib.aux to get section 1996-11-11 20:49:27 +00:00
fncychap.sty New file. Written by Ulf A. Lindgren <lindgren@ae.chalmers.se>; we have 1998-02-11 23:01:23 +00:00
index.html Simple index for the reference manuals (mostly for use on the Windows 1997-11-25 18:27:23 +00:00
indfix.py breakable_re: Fix the RE so that module definition entries don't prevent 1998-02-19 06:05:29 +00:00
keywords.py libsocket.tex: send[to] returns nbytes. 1994-08-01 12:18:36 +00:00
lib.tex Convert LaTeX support to create a new class of documents. HTML generation 1998-03-03 22:02:19 +00:00
libaifc.tex Normalization of markup. 1998-02-13 22:22:36 +00:00
libal.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
liballos.tex Added \label{} for logical addressing. 1998-02-18 15:22:08 +00:00
libamoeba.tex Added \label{} for logical addressing. 1998-02-18 15:10:24 +00:00
libanydbm.tex Added \label{} for logical addressing. 1998-02-18 15:05:47 +00:00
libarray.tex Deprecate the read() and write() methods. 1998-02-27 16:21:31 +00:00
libaudioop.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libbase64.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libbasehttp.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libbastion.tex Marked the unmarked AttributeError. (AMK) 1998-02-23 14:42:00 +00:00
libbinascii.tex Separate binhex and binuu documentation from binascii. Support better 1998-02-19 18:29:18 +00:00
libbinhex.tex Separate binhex and binuu documentation from binascii. Support better 1998-02-19 18:29:18 +00:00
libbltin.tex Used a named target to form the reference to the Built-in Functions section. 1997-12-16 04:06:06 +00:00
libcd.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libcgi.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libcmath.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libcode.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libcommands.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libcopy.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libcopyreg.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libcrypt.tex Use \manpage{} markup for referencing a UNIX man page. 1998-02-17 22:24:45 +00:00
libcrypto.tex Added \label{} for logical addressing. 1998-02-18 15:22:08 +00:00
libctb.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libdbm.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libdis.tex Added \label{} for logical addressing. 1998-02-19 20:07:39 +00:00
liberrno.tex Added \label{} for logical addressing. 1998-02-18 15:05:47 +00:00
libexcs.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libfcntl.tex Added \label{} for logical addressing. 1998-02-18 15:10:24 +00:00
libfl.tex Adjusted \label{} for *consistent* logical addressing. 1998-02-19 20:59:19 +00:00
libfm.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libfnmatch.tex Made the area for wildcards in the description wider, so we don't invade the 1998-02-16 21:37:58 +00:00
libformatter.tex In add_label_data() description, use "\samp{}" instead of "``\code{...}''" 1998-02-13 14:48:00 +00:00
libframework.tex Separate Mac user interface modules into separate files, to better support 1998-02-18 17:19:11 +00:00
libftplib.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libfuncs.tex Logical markup. 1998-03-03 21:56:15 +00:00
libgdbm.tex Added comment explaining the only warning produced by makeindex, since there 1998-02-17 20:31:08 +00:00
libgetopt.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libgl.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libglob.tex In the example file name, use the current Python version, not a hardcoded 1998-02-16 21:25:53 +00:00
libgopherlib.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libgrp.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libgzip.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libhtmllib.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libhttplib.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libimageop.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libimgfile.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libimghdr.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libimp.tex Added \label{} for logical addressing. 1998-02-19 20:50:52 +00:00
libintro.tex Added \label{} for logical addressing. 1998-02-18 15:21:26 +00:00
libjpeg.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libkeyword.tex Added \label{} for logical addressing. 1998-02-18 15:10:24 +00:00
liblocale.tex Fixed and extended the example; the original example contained some 1998-02-22 04:41:51 +00:00
libmac.tex The list of module descriptions should be a {description} environment, not 1998-02-21 06:30:17 +00:00
libmacconsole.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libmacdnr.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libmacfs.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libmacic.tex Added \label{} for logical addressing. 1998-02-18 15:10:24 +00:00
libmacos.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libmacostools.tex Added \label{} for logical addressing. 1998-02-19 19:40:17 +00:00
libmacspeech.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libmactcp.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libmacui.tex Separate Mac user interface modules into separate files, to better support 1998-02-18 17:19:11 +00:00
libmailbox.tex Don't capitalize identifiers at the beginning of the sentence; re-write to 1998-02-13 22:17:21 +00:00
libmailcap.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libmain.tex AMK's megapatch: 1997-07-17 16:34:52 +00:00
libmarshal.tex Mark up filename extensions consistently. 1998-02-16 20:40:37 +00:00
libmath.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libmd5.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libmimetools.tex Fix some markup so that the right characters are printed. 1998-02-13 22:13:07 +00:00
libmimify.tex Added \label{} for logical addressing. 1998-02-18 15:10:24 +00:00
libminiae.tex Separate Mac user interface modules into separate files, to better support 1998-02-18 17:19:11 +00:00
libmisc.tex Added \label{} for logical addressing. 1998-02-18 15:21:26 +00:00
libmm.tex Added \label{} for logical addressing. 1998-02-18 15:22:08 +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 Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libni.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libnntplib.tex NNTP.xgtitle() description: Add a missing ")" from the response value 1998-02-16 21:57:37 +00:00
libobjs.tex \nodename{} must immediately follow \chapter{} to be handled correctly; 1998-02-19 14:00:22 +00:00
liboperator.tex Added \label{} for logical addressing. 1998-02-17 22:30:13 +00:00
libos.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libpanel.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libparser.tex Clean up some stuff in the {seealso} at the end. This avoids a little nit 1998-02-23 21:31:24 +00:00
libpdb.tex Adjust grouping for the "b(reak)" command syntax description. This is 1998-02-19 15:18:02 +00:00
libpickle.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libposix.tex Change {datadesc} environments with empty descriptions to \dataline{}s; this 1998-02-13 21:55:21 +00:00
libposixfile.tex Added \label{} for logical addressing. 1998-02-18 15:22:08 +00:00
libppath.tex Add normpath(). Clarify normcase(). (Note -- this doc section 1998-02-18 14:00:05 +00:00
libpprint.tex Added \label{}s for logical addressing. 1998-02-20 06:03:52 +00:00
libprofile.tex Logical markup. 1998-02-27 05:23:37 +00:00
libpwd.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libpython.tex Added \label{} for logical addressing. 1998-02-18 15:39:15 +00:00
libqueue.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libquopri.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
librand.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
librandom.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libre.tex Logical markup. 1998-02-19 15:09:35 +00:00
libregex.tex {fulllineitems} is now an environment; use it as such. 1998-02-19 06:32:06 +00:00
libregsub.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libresource.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
librestricted.tex Added \label{} for logical addressing. 1998-02-18 15:40:11 +00:00
librexec.tex "streans" --> "streams" (AMK) 1998-02-23 14:37:40 +00:00
librfc822.tex Feature added by Bill van Melle: when no timezone is present, assume 1998-02-19 00:28:58 +00:00
librgbimg.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
librotor.tex Fixed formatting of the program name for crypt. 1998-02-16 21:36:57 +00:00
libselect.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libsgi.tex Added \label{} for logical addressing. 1998-02-18 15:40:11 +00:00
libsgmllib.tex Use "\samp{...}" instead of "``\code{...}''" when showing markup fragments 1998-02-13 14:37:12 +00:00
libshelve.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libsignal.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libsite.tex Jeff Kunce writes (and he is right): 1998-02-19 21:02:32 +00:00
libsocket.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libsocksvr.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libsomeos.tex Added \label{} for logical addressing. 1998-02-18 15:39:15 +00:00
libsoundex.tex In description of sound_similar(), break up the markup for long 1998-02-13 21:49:12 +00:00
libstat.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libstd.tex Restructured library documentation 1994-01-02 01:22:07 +00:00
libstdwin.tex Added \label{} for logical addressing. 1998-02-18 15:10:24 +00:00
libstring.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libstrings.tex Added \label{} for logical addressing. 1998-02-18 15:40:11 +00:00
libstrio.tex Consistency: "{\bf ...}" ==> "\strong{...}" 1998-01-14 14:51:31 +00:00
libstruct.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libsun.tex Separate chapter and section. 1998-02-19 18:59:48 +00:00
libsunaudio.tex Separate chapter and section. 1998-02-19 18:59:48 +00:00
libsymbol.tex Separate the parse, symbol, and token documentation into separate files. 1998-02-18 15:59:13 +00:00
libsys.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libsyslog.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libtempfile.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libtemplate.tex Logical markup. 1998-02-24 21:43:05 +00:00
libtermios.tex Added \label{} for logical addressing. 1998-02-19 20:07:39 +00:00
libthread.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libtime.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libtoken.tex Separate the parse, symbol, and token documentation into separate files. 1998-02-18 15:59:13 +00:00
libtraceback.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libtypes.tex Added \label{} for logical addressing. 1998-02-19 20:22:13 +00:00
libtypes2.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libundoc.tex Added msvcrt. 1998-03-03 02:00:14 +00:00
libunix.tex Added \label{} for logical addressing. 1998-02-18 15:47:17 +00:00
liburllib.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
liburlparse.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libuser.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libuserdict.tex Logical markup. 1998-02-19 06:26:35 +00:00
libuu.tex Separate binhex and binuu documentation from binascii. Support better 1998-02-19 18:29:18 +00:00
libwhichdb.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libwhrandom.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libwww.tex Added \label{} for logical addressing. 1998-02-18 15:47:17 +00:00
libxdrlib.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libxmllib.tex Use "\samp{...}" instead of "``\code{...}''" when showing markup fragments 1998-02-13 14:38:23 +00:00
libzlib.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
manual.cls Move the change to ending the abstract from python.sty to manual.cls; it 1998-03-05 16:41:42 +00:00
manual.perl Perish Evil Revelry and Lamentation. 1998-03-03 22:27:28 +00:00
mktarball.sh Build a tarball that extracts to Python-$VERSION/Doc/ instead of Doc/, 1998-03-05 16:31:22 +00:00
modindex.py main(): Include a \label{modindex} in the output so latex won't let us re-use 1998-02-17 23:13:19 +00:00
newind.py Use a Python script to create "empty" indexes. This solves Guido's 1998-02-27 05:18:28 +00:00
node2label.pl Adjusted to work with the newer version of LaTeX2HTML as well. 1998-02-26 18:49:58 +00:00
partparse.py Oops, remove some debugging prints. 1998-03-04 06:34:21 +00:00
python.perl For verbatim text, don't bounce down a size. 1998-03-05 17:00:55 +00:00
python.sty Move the change to ending the abstract from python.sty to manual.cls; it 1998-03-05 16:41:42 +00:00
texi2html.py (texi2html.py): Minor improvement to HTML 3.0 output for code examples. 1996-10-25 22:13:59 +00:00
texipost.dat Incorporated Jan-Hein's changes and texinfo conversion. 1992-12-08 14:37:55 +00:00
texipre.dat Nit to prevent empty node in formatted version. 1998-02-27 05:21:36 +00:00
text2latex.py * text2latex.py: call main() instead of always processing ext.tex. 1993-11-19 13:13:22 +00:00
tut.tex Convert LaTeX support to create a new class of documents. HTML generation 1998-03-03 22:02:19 +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.
They now require LaTeX2e (LaTeX 2.09 compatibility is dropped).

The Python Reference Manual is no longer maintained in LaTeX.  It is
now a FrameMaker document.  The FrameMaker 5.0 files (ref.book,
ref*.doc) as well as PostScript generated (ref.ps) from it are in the
subdirectory ref/.  (See <ftp://ftp.adobe.com/pub/adobe/framereader>
for a free reader for FrameMaker documents, for some platforms.)  Many 
thanks to Robin Friedrich for the conversion of the Reference Manual
to FrameMaker and his work on its index.

If you don't have LaTeX, or if you'd rather not format the
documentation yourself, you can ftp a tar file containing HTML, PDF,
or PostScript versions of all documents.  Additional formats may be
available.  These should be in the same place where you fetched the
main Python distribution (try <http://www.python.org> or
<ftp://ftp.python.org>).

The following are the LaTeX source files:

	tut.tex				The tutorial
	lib.tex, lib*.tex		The library reference
	ext.tex				How to extend Python
	api.tex				Reference for the Python/C API

All use the "manual" document class and "python" package, derived from 
the old "myformat.sty" style file.  These contains many macro
definitions useful in documenting Python, and set some style parameters.

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.  PostScript is produced
by the same Makefile target that produces the DVI files.  This uses
the dvips tool.  Printing depends on local conventions; at our site,
we use lpr.  For example:

	make lib			# create lib.dvi and lib.ps
	xdvi lib			# preview lib.dvi
	lpr lib.ps			# print on default printer


What if I find a bug?
---------------------

First, check that the bug is present in the online version of the
documentation at <http://www.python.org/docs/>; we may have already
fixed it.

If we haven't, tell us about it.  We'd like the documentation to be
complete and accurate, but have limited time.  If you discover any
inconsistencies between the documentation and implementation, or just
have suggestions as to how to improve the documentation, let is know!
Send comments and patches to the Python Documentation Team:

			   python-docs@python.org

Thanks!


What tools do I need?
---------------------

You need to install Python; some of the scripts used to produce the
documentation are written in Python.

The simplest way to get the rest of the tools in the configuration we
used is to install the teTeX TeX distribution, version 0.9.  More
information is available on teTeX at <http://www.tug.org/tetex/>.
This is a UNIX-only TeX distribution at this time.

If you don't want to get teTeX, or if you're not using UNIX, here is
what you'll need:

To create DVI, PDF, or PostScript files:

	- LaTeX2e, 1995/12/01 or newer.  Older versions are likely to 
	  choke.

	- makeindex.  This is used to produce the indexes for the
	  library reference and Python/C API reference.

To create PDF files:

	- pdflatex.  We used the one in the teTeX 0.9 distribution
	  (version 0.11 at the time of this writing).

To create PostScript files:

	- dvips.  Most TeX installations include this.  If you don't
	  have one, check CTAN (<ftp://ctan.tug.org/tex-archive/>).

To create info files:

	- makeinfo.  This is available from any GNU mirror.

To create HTML files:

	- Perl 5.004_04 or newer.  Find the software at
	  <http://language.perl.com/info/software.html>.

	- LaTeX2HTML 98.1p1, or newer.  Releases are available at
	  <http://www-dsed.llnl.gov/files/programs/unix/latex2html/>.


What if Times fonts are not available?
--------------------------------------

As distributed, the LaTeX documents use PostScript Times fonts.  This
is done since they are much better looking and produce smaller
PostScript files.  If, however, your TeX installation does not support 
them, they may be easily disabled.  Edit the file manual.cls and
comment out the line that starts "\RequirePackage{times}" using a "%"
character at the beginning of the line.  An alternative is to install
the right fonts and LaTeX style file.


Making HTML files
-----------------

The LaTeX documents can be converted to HTML using Nikos Drakos'
LaTeX2HTML converter.  See the Makefile; after some twiddling, "make
l2h" should do the trick.

For the reference manual, we use Harlequin's webmaker.  We're not very 
happy with it and hope that eventually FrameMaker will be able to
produce HTML without third party help.