(py-shell): Set the default shell if not set yet.  It's sometimes
convenient to call py-shell before the first Python file has been
visited.

Allow comment characters (#) to be escaped:
  - did away with 'comment_re' option -- it's just not that simple anymore
  - heavily revised the main logic in 'readline()' to accomodate this
Beefed up 'warn()': 'line' can be list or tuple, and 'msg' is
  automatically converted to a string.

Added __del__ method to GzipFile class that will flush and close the
object, if required.

In note mentioning [].remove()'s exception, tell what exception is
raised.  Prompted by Barry's whining.  ;-0

Patch by Marc-Andre Lemburg to add a bunch more symbols.

Ofir Reichenberg suggested to apply htonl() to grpaddr in openmcastsock().
Also got rid of unnecessary use of eval() and regsub.gsub().

Add index entries for open():
buffer size, I/O
I/O control, buffering
line-buffered I/O
unbuffered I/O

Add index entry "I/O control, buffering" for fdopen().

Add index entry "I/O control, buffering" for makefile().

Vladimir Marangozov fixes an AIX-specific problem, writing:

"""
Following up Robin Dunn's troubles with freeze, here's a patch that
fixes an oddity regarding the import logic of shared modules on AIX.

Symbol resolution of shared modules is now handled properly for the cases
when the python library is linked to a binary with an arbitrary name.
This includes the standard python[version] executable, but also applications
that are embedding the python core (i.e. linked with libpython[version].a,
the latter being static or shared).
"""

Started documentation on buffer objects & types.  Very preliminary.

Greg Stein:  Please help with this; it's your baby!

PyBuffer_New():  Raise ValueError if size is negative (the other
 constructors didn't miss this).

 Raise MemoryError if malloc() fails, instead of just
 returning NULL.

Added available() method, which checks whether quicktime is installed at all (by
testing whether EnterMovies points to an actual routine or is a null pointer).

Change the directory tree walking example to use clearer variable
names, some suggested by Joe Ellsworth.

It turns out that modifying the environment strings is not safe.
Treat them as read-only, and make a copy as appropriately.  This was
first reported by Bill Janssend and later by Craig Rowland and Ron
Sedlmeyer.  This fix is mine.

Re-write in Python for portability.  About 30% slower, but who cares?!

remap_element_names():  Only used for things that the new conversion
engine in latex2esis.py can do, so discard it.

paragraph detection & markup:  Handle some of the list-like
environments properly, picking up paragraphs inside
list items.  (Only changed a few element-sets used for
recognition.)

fixup_refmodindexes_chunk():  Use the right attribute to determine the
module a <ref*modindex/> element is referring to.

convert():  Don't call remap_element_names(); it was removed.

The new conversion engine supports more of the table re-writing than
the old one, so use it.

Removed PyMapping_Clear() -- it was wishful thinking and serves no
great purpose.

Use the mksourcepgk script instead of mktarball.sh.

Remove obsolete version of script.

Re-implementation of mktarball.sh as a more portable Python script;
with a more descriptive name.

Allow creation of multiple archive formats with a single pass; useful
in this case since it uses a fresh export/checkout from CVS to ensure
that the tree is "clean" (no build turds, saved files, &c).  Use --all
to create all supported formats.

bwrite(), ewrite():  Helpers for diagnostic output; essentially the
same as sys.stderr.write(), but bwrite() will make it
bold if stderr is a tty (for visibility).

Use these everywhere instead of accessing
sys.stderr.write() directly.

find_all_child_elements():  Find all elements by type name that are
immediate children of another.

cleanup_synopses():  Receive both the document and fragment objects as
parameters; if only the document is passed, synopsis
information is never found since it's in the fragment!

build_para(): Add a chunk of code to ensure that a newline always
follows the </para> end-tag.  Not really important, but
makes presentation consistent for authoring/
maintenance.

fixup_bifuncindexes_chunk(): Use find_all_child_elements() instead of
find_all_elements() so we don't work with too many
levels at once; that could cause DOM exceptions with
the <elem>.removeChild() method.

Mostly minor changes.
Removed some obsolete commented-out code.

Merged BaseConversion into Conversion since there's only one
conversion process now.

Remove push/pop of output stream; it's no longer needed.

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.