cpython/Doc
Fred Drake cea0e7350d Added \label{} for logical addressing. 1998-02-19 19:40:17 +00:00
..
api Removed various "(New in 1.5a?!)" constructs. Other notes pertaining to 1998-02-16 15:27:08 +00:00
ext "--" --> "---" in two places. 1998-02-16 14:47:27 +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 Bring date into line with the last documentation release. 1998-02-19 16:18:19 +00:00
lib Separate chapter and section. 1998-02-19 18:59:48 +00:00
mac Added \label{} for logical addressing. 1998-02-19 19:40:17 +00:00
ref Removed a confusing note about coercions and __r*__ operators. 1998-01-19 23:16:55 +00:00
templates Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
texinputs Updated date for interim documentation release. 1998-02-17 15:41:45 +00:00
tools Work on a temporary file, not the input file. 1998-02-19 16:01:41 +00:00
tut Remove \bcode / \ecode everywhere. 1998-02-13 07:16:30 +00:00
.cvsignore Tell CVS to ignore PDF files. 1998-02-04 20:27:39 +00:00
.latex2html-init Make sure the general index and about nodes get labels assigned, so they get 1998-02-19 18:51:39 +00:00
Makefile Revised some targets to make better use of make "special" variables, to avoid 1998-02-19 16:01:04 +00:00
README Add note about dropping latex 2.09 compatibility. 1998-01-19 23:10:21 +00:00
TODO Added a number of items.... 1998-02-18 16:03:43 +00:00
api.tex Removed various "(New in 1.5a?!)" constructs. Other notes pertaining to 1998-02-16 15:27:08 +00:00
boilerplate.tex Updated date for interim documentation release. 1998-02-17 15:41:45 +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 "--" --> "---" in two places. 1998-02-16 14:47:27 +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 Separate chapter and section. 1998-02-19 18:59:48 +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 Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +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 Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +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 Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +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 \nodename{} must appear immediately after \section{} for the info conversion. 1998-02-17 02:10:41 +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 In description of __import__, second paragraph, break up the markup for long 1998-02-13 21:26:35 +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 Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +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 Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libmac.tex Added \label{} for logical addressing. 1998-02-18 15:21:26 +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 Separate the parse, symbol, and token documentation into separate files. 1998-02-18 15:59:13 +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 Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libprofile.tex Added \label{} for logical addressing. 1998-02-18 15:40:11 +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 Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +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 Use \version to get the current Python version number, where possible. This 1998-02-16 20:58:58 +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 Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +00:00
libtermios.tex Remove all \bcode / \ecode cruft; this is no longer needed. See previous 1998-02-13 06:58:54 +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-18 15:40:11 +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 \label{} for logical addressing. 1998-02-18 15:47:17 +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
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
myformat.perl Remove debugging print. 1998-02-19 17:26:48 +00:00
myformat.sty Mostly LaTeX style cleanup. 1998-02-19 06:23:06 +00:00
node2label.pl assure a consistent assignment for nodes with multiple labels 1998-02-18 16:10:22 +00:00
partparse.py Support environments {fulllineitems} and {classdesc}, more of the new logical 1998-02-19 15:20:30 +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 Bring date into line with the last documentation release. 1998-02-19 16:18:19 +00:00
text2latex.py * text2latex.py: call main() instead of always processing ext.tex. 1993-11-19 13:13:22 +00:00
tut.tex Remove \bcode / \ecode everywhere. 1998-02-13 07:16:30 +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, you can ftp a tar file containing PostScript
of all documents.  It 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 style option file "myformat.sty".  This contains some
macro definitions and sets some style parameters.

You need the makeindex utility to produce the index for lib.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.  PostScript is produced
by the same Makefile target that produces the DVI files.  This uses
the dvips tool.  Printing depends on local conventions; at my site, I
use lp.  For example:

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


Using Times fonts
-----------------

As distributed, the Latex documents use the default Tex fonts (CMR).
These qre quite ugly.  If you have the "PSfont" Latex add-on
installed, you can produce versions using Times fonts (and Courier for
fixed text) by inserting "times," in the list of options in the
documentstyle macro in the first line of the files lib.tex, tut.tex,
ext.tex, api.tex, e.g.

	\documentstyle[twoside,times,myformat]{report}


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, I use Harlequin's webmaker.  I'm not very
happy with it and hope that eventually FrameMaker will be able to
produce HTML without third party help.