This doesn't need to do nearly as much for the new conversion, so
simplify.

A few small improvements to the conversion.

Markup nits.

Adjust examples to use the object interface instead of the function
interface.

Fixed hyperlink references to the __builtin__ and __main__ modules;
error reported by Dale Nagata <DNagata@creo.com>.

Mark Hammond writes:

"""
If the filename being complained about contains a space, enclose the
file-name in quotes.

The reason is simply that when I try and parse tabnanny's output, filenames
with spaces make it very difficult to determine where the filename stops
and the linenumber begins!
"""

Tim approves.

I slightly changed the patch (use 'in' instead of string.find()) and
arbitrarily bumped the __version__ variable up to 6.

Remove some redundant code from Canvas.tag_bind(), which added all
bindings to a dictionary _tagcommands which was otherwise unused.
(This was checked in accidentally with rev. 1.125 and not deleted with
rev. 1.127 when the other half of this code was removed -- although
even as originally checked in the _tagcommands variable was never
used.)

(PR#40, reported by Peter Stoehr)

Ripped out the old conversion.

Added a few more passes through the document fragment.  Not actually
very interesting.

Massive changes.

Separate the Conversion class into a base and a subclass; the subclass
is pretty minimal but the separation is useful for....

NewConversion:  New class that implements a somewhat different
approach to the conversion.  This uses a table of
instances (rather than tuples) that have more
information than the tuples used for the older
conversion procedure.  This allows a lot more control
over the conversion, and it seems to be pretty
stable.

TableEntry,
Parameter: New classes that are used to build the conversion
specification used by NewConversion.

TableParser: xmllib.XMLParser subclass that builds a conversion
specification from an XML document.

load_table(): Convenience function that loads a table from a file.

main():  Added flags --new and --old; these select which conversion is
 used.  The default is --new.

Several fixes have been made in the old conversion as well; these were
done before writing & switching to the new conversion, and should be
archived.

The next checkin of this file will discard the old conversion; is is
kept in this checkin to allow it to be retrieved if needed, and to
avoid lossing the bugfixes that have been made to it in the interim.

Minor updates.

Use the (new) buildFragment() method of the EsisBuilder rather than
implementing it all here.

Some minor cleanup.

Conversion specification, used by a new path through latex2esis.py.
The specific markup conversion is coded here instead of an even more
cryptic table in the code of latex2esis.py.

Minor update.

Change an {\em ...} to \var{...} and a {\bf ...} to \program{...} (the
new markup makes sense in context).

These allow the SGML/XML conversion updates to work, & should not have
still been in there anyway.

A few minor Customize changes:

(python): Set defgroup :prefix to "py-" to make variable names cleaner.

(py-jpython-command, py-jpython-command-args): Set :tag for proper
capitalization of JPython in variable name display.

(python-mode): Set which interpreter (CPython or JPython) to use the
first time a py buffer is visited during the Emacs session.  This
ensures that py-which-shells is initialized and also guarantees that
the mode lines reflect the correct shell.  First bug found by GvR,
second one has long bugged :) me.

(py-toggle-shells): Programmatically, arg can also take the symbols
`cpython' or `jpython', which makes it easy to call with the value of
py-default-interpreter.

(py-shell): Don't need to initialize py-which-* variables since these
will guarantee to be initialized by python-mode when the first py
buffer is visited.

(py-default-interpreter): Update docstring.

Another patch from Andy Dustman:

"""
Here's a patch for the ForkingMixIn which will prevent the server from
forking itself into the ground. Note: I've tested a very similar patch
(subclassed ForkingMixIn) but not actually tested this one. As you might
surmise, this was done out of necessity...

If the maximum number of children are already running, block while waiting
for a child to exit.
"""

(I added that last sentence as a comment to the code --GvR.)

(py-beginning-of-def-or-class): Only move to match-beginning if the
regex match actually succeeded!

Add support for bzip2 compression.

New target: distfiles, create all distribution archives, regardless of
archive format.  (Individual targets remain for each archive format.)

Add support for bzip2 using --bzip2.

Ignore additional compressed formats.

Added description of optional parameter to UserDict constructor.
Omission reported by Barry Warsaw.

Add zip archive support for html, pdf, ps, and latex archives.

"zips" target produces all possible .zip files.

Add --zip parameter; make this able to produce .zip files as well as
.tgz files.

getsize(), getatime(), getmtime():
Constants from stat module were imported using "import *";
don't access them via stat.ST_*!

Reported by that other vR.  ;-)

Update getattr() description to document the optional third
parameter.  Thanks to Barry Warsaw for pointing out the oversight.

Make the default target xml instead of sgml.

Make the default target xml instead of sgml.

Use a temporary file to pass results from latex2esis.py to
docfixer.py; this makes for better error detection by make (if the
first pipeline stage fails, make wasn't catching it).

typo: privide --> provide

Reported by Nadim Ghaznavi <nadim@ghaznavi.com>.

Fixed order of parameters in slice() docstring.  The Library Reference
had it right!  Reported by Tim Hochberg <tim.hochberg@ieee.org>.

New wishes.

Add test case for bug just fixed by Stephen Turner.

Patch by Stephen Turner, who writes:

"""
It fixes a memory corruption error resulting from BadPickleGet
exceptions in load_get, load_binget and load_long_binget.  This was
initially reported on c.l.py as a problem with Cookie.py; see the thread
titled "python core dump (SIGBUS) on Solaris" for more details.

If PyDict_GetItem(self->memo, py_key) call failed, then py_key was being
Py_DECREF'd out of existence before call was made to
PyErr_SetObject(BadPickleGet, py_key).

The bug can be duplicated as follows:

import cPickle
cPickle.loads('garyp')

This raises a BadPickleGet exception whose value is a freed object.  A
core dump will soon follow.
"""

Jim Fulton approves of the patch.

Mark Favas was quick to note that the last checkin divides by zero
when n == 0...  So divide by a->ob_size instead which was already
tested for 0.

Appropriate overflow checks so that things like sys.maxint*(1,) can't
dump core.

added a test for "To: :" patch

AddrlistClass.getaddress(): when parsing `:'s, in the loop, watch out
for gotonext() pushing self.pos past the end of the string.  This can
happen if the message has a To field like "To: :" and you call
msg.getaddrlist('to').

Added comment clarifying that RELEASE is the documentation release
number, not the Python release.

Removed VERSION since it is not used.

do_cmd_funclineni():  New function; non-indexing form of \funcline.

Move chdir() and getcwd() descriptions to "Files and Directories" with
a pointer from the "Process Parameters" section.  Based on comments
from Aahz Maruch, Tim Peters, and GvR.

Use the same names for CLASS attributes as elsewhere.

Updated Milan's email address.

Make the color for stderr red (i.e. the standard warning/danger/stop
color) rather than green.  Suggested by Sam Schulenburg.

The first concrete subclass of CCompiler: defines a barebones Unix C compiler.

The abstract base class that defines the C/C++ compiler abstraction model.

Added a self-berating command relating to installation directories for
module distributions that contain platform-specific files.

Don't pollute importer's namespace with type objects from types modules.
Added DistutilsPlatformError.

Patch by Jeffrey Chang to add docstrings everywhere.
The text is condensed from the library manual.

Marc-Andre Lemburg discovered that the switch from .pyc to .pyo files,
done by _PyImport_Init(), comes to late to affect the import of
exceptions.py by _PyBuiltin_Init_2().  Move  _PyImport_Init() up few lines.

Several methods return tuples, not lists.

Move some misc. comments from the example section to the main section.

Use the lowercase versions of the method names in the example, since
that's what's documented (Greg Stein's suggestion).  Add a blank line
after the import line for clarity.

FTP.dir():  Fix typo in docstring.

dir() method description revised based on comments from Greg Stein.

make_view_popups(): Catch import error which can occur if a viewer is
dynamically imported when Pynche is running via askcolor out of a
package.  If the ImportError occurs, try again, prepending the package
name and digging out the module.

Missing space; reported by Robert Kern <kernr@ncifcrf.gov>.

Fix a number of minor problems pointed out by /F.

Fixed typo reported by /F; thanks!

Bump the release number to 1.5.2p1.

Drag module added.

Darn!  Forgot to re-target.

Remove one item.

Rearrange & comment on others.

Minor markup nit.

Added entry for asyncore module.

Fix a few markup nits, improve some index entries.

New documentation from Chris Petrilli <petrilli@amber.org>.

For spawn*(), point to the magic constants; some readers have a hard
time finding the bindings.

Milton L. Hankin reports that on Windows it is possible to have two
different values in the environ dict with the same key (although he
couldn't explain exactly how this came to be).  Since getenv() uses
the first one, Python should do too. (Some doubts about case
sensitivity, but for now this at least seems the right thing to do
regardless of platform.)

Sjoerd Mullender:

In splithost, accept empty host part in URLs.  This is required for
file URLs that can have an empty host part.  For such URLs, we should
not return the initial 2 slashes as part of the file name.

Removed entries for several modules which have been documented.

Updated comments on several remaining modules.

Documentation for dl module from Moshe.

Added entry for dl module.

Relocating file to Lib/lib-old.

Remove extraneous "contains" -- pointed out by Daniel Barclay
<danielb@digitalfocus.com>.

Added credit to Martin von Loewis for creating the module and
documentation.

Per Frank Stajano's suggestion, state explicitly that the functions
described in the sub-sections are directly available at the module
level.  He found this confusing.

Make the reference to the os module in the module synopsis (for the
table at the front of the chapter) a hyperlink.

Don't set type of application, it's taken care of elsewhere -- jvr

Made several grammatical corrections based on comments from Daniel
Barcla <danielb@digitalfocus.com>.

Also added example of what happens when a parameter is set both
positionally and by a keyword (one of Daniels suggestions related to
that paragraph).

For "Matching vs. Searching", remove comment that the section is
incomplete; I don't remember what else I thought I was going to put
in, but it looks o.k. to me know.

Added some reminders.

Move the setting for secnumdepth to the document classes; make the numbering
for the manual class go one deeper than it previously did (\subsection
entries will now be numbered); no change for howto documents.

This makes it easier to refer precisely to smaller sections using \ref.

Added some minor prose before the descriptions of the data attributes
to make it clear that these are instance attributes, not module data.

Added entry for pty module.

pty documentation from Moshe; with small edits.

Improve description of the example.

Usage nit: a bunch of "nor"s should have been a single "or".

Make reference to the copy_reg module a hyperlink.

Minor wording change in section title.

byteswap() method:  Tell *what* exception gets raised when the type
    cannot be byteswapped.

Remove unnecessary comma.

Define NotANumber as a subclass of ValueError when using class-based
exceptions.

When raising NotANumber, pass the string that failed as the exception
value.

Comment out XXX comment; this needn't appear in the formatted
versions.  XXX comments only need to be grep-able.

Add note about not being able to use this module with modules not
implemented in Python.

Moshe:  Remove extraneous "and".

Added entries for mutex and nis modules.

NIS documentation from Moshe.

Mutex documentation from Moshe.

Separate documentation of SUNAUDIODEV from sunaudiodev; this mirrors
similar constructs elsewhere (al/AL, gl/GL/DEVICE).

Fix some typos.

Add an index entry.

Add entries for the sched module.

While we're at it, convert to docstrings and set the indentation level
to 4.