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.

Moshe's section on the sched module, with edits.

Update to Sjoerd's documentation of the chunk module, with some
additions from Moshe's version.  Used my table for describing the
chunk format, and added some markup and index entries.

Close debugger when closing.  This may break a cycle.

Break cycle on close.

Destroy the tree when closing.

Add destroy() method to recursively destroy a tree.

Extend _close() to break cycles.
Break some other cycles too (and destroy the root when done).

Add _close() method that does the actual cleanup (close() asks the
user what they want first if there's unsaved stuff, and may cancel).
It closes more than before.

Add unload_extensions() method to unload all extensions; called from
_close().  It calls an extension's close() method if it has one.

Add close() method that breaks cycles.

Add unregister() method.
Unregister everything at closing.
Don't call close() in __del__, rely on explicit call to close().

Add close() method that breaks a cycle.

Break some cycles when the widget is destroyed.

Patch from Sjoerd Mullender:

Make argument names equal to what is used in the documentation of the
file object, since chunks are supposedly file-like.

Mikael Lyngvig writes:

I just noticed that the changes below also apply to cmpcache.py, which
is virtually identical to cmp.py.

Patch by Mikael Lyngvig:

1. Fix incorrect file open mode on Win32 platforms (use "rb" instead
of "r").

2. Add shallow parameter to cmp.cmp().  If false, deep file
comparisons are made.

The module should be 100 percent backwards compatible.

Clarify the example by explicitly importing the fcntl module -- this
avoid being fooled into thinking that fcntl and FCNTL are the same
thing -- they aren't!  (fcntl is the extension, FCNTL.py is h2py
output that defines all the constants).

(XXX The example is still weird -- I think there's a more portable way
to do locking now.  That's for someone else to fix...)

Sjoerd Mullender writes:

Urllib makes the URL of the opened file available through the geturl
method of the returned object.  For local files, this consists of
file: plus the name of the file.  This results in an invalid URL if
the file name was relative.  This patch fixes this so that the
returned URL is just a relative URL in that case.  When the file name
is absolute, the URL returned is of the form file:///absolute/path.

[I guess that a URL of the form "file:foo.html" is illegal...  GvR]

Small patch by Tim Peters - it was using self.maxlist when it should
be using self.maxdict.

Simplified version of a patch by Chih-Hao Huang, who wrote:

"""
When there are additional Setup files, specified by -e option of freeze,
checkextenstions.py assumes that *.o, *.a, -Lpath, and -Rpath are all
relative to where the Setup file is. select() inserts the path to the
Setup file to make them absolute. However, the assumption is not true.
There are cases that absolute paths are specified for them. The inserted
prefix, by select(), results in error.

The following fix check for absolute paths. The assumption is: an
absolute path begins with either '/' or '$'. In the latter case, it is
from the environmental variable. (Variables defined locally in the Setup
file have already been handled by expandvars())
"""

My version of the patch has been verified by Charles Waldman (a
colleague of Chih-Hao).

Removed tty module entry.

Add entries for tty module.

Updates from Moshe, again edited by me.  Describe the parameters to
border() using a table instead of text for ease of comprehension.

Added "See Also" section for termios module.

Various updates.

tty module documentation from Moshe, with some editing and an added
"See also" section.

Added more sections...

Two more from Moshe!

Drag manager constants.

Make the mode parameter to open() default in the same way as for wave.open().