Another patch from Thomas Gellekum: add .overlay() and .overwrite()
    window methods

Whoops!  Two stray characters crept in to my last check-in

Patch #102492, fixing bug #116677:
    give minidom.py behaviour that complies with the DOM Level 1 REC,
    which says that when a node newChild is added to the tree, "if the
    newChild is already in the tree, it is first removed."

    pulldom.py is patched to use the public minidom interface instead
    of setting .parentNode itself.  Possibly this reduces pulldom's
    efficiency; someone else will have to pronounce on that.

Patch #102955, fixing one of the warnings in bug #121479:
Simplifies ord()'s logic at the cost of some code duplication, removing a
    " `ord' might be used uninitialized in this function" warning

Change expected message for ValueError, fixing bug #126400

Make the indentation consistently use tabs instead of using spaces just
in one place.

Add forgotten initialization.  Fixes bug #120994, "Traceback with
    DISTUTILS_DEBUG set"

Patch #102940: use only printable Unicode chars in reporting
 incorrect % characters; characters outside the printable range are
 replaced with '?'

Regenerated so that NewGWorld is included.

Emulate a few more non-carbon calls in carbon and the other way around.

Added hash() and compare() functions. Needed because multiple WinObj's can now refer to the same underlying WindowRef.

Blacklisted a few constants with funny definitions (and they're not important anyway: backward compatible error numbers).

Patch #102868 from cgw: fix memory leak when an EOF is encountered
    using GNU libc's getline()

Adding a warning about the regsub module.  This also disables further
warnings in this same module, to prevent getting a warning about
importing regex (we *know* that it's obsolete :-).

Adding a warning about the regex module.  This is the first official
use of PyErr_Warn()!  This module is a good guinea pig because it's
been obsolete since 1.5.0 was released.

Be explicit about scheme_chars -- string.letters is locale dependent
so we can't use it.

While I'm at it, got rid of string module use.  (Found several new
hard special cases for a hypothetical conversion tool: from string
import join, find, rfind; and a local assignment "find=string.find".)

Fix typo

Use binary mode to open "wave" files.

Document the warnings module.

Updated string literals description to encompass Unicode literals and the
additional escape sequences defined for Unicode.
This closes bug #117158.

Document warning categories.

Clarify __repr__ and __str__.

Added documentation on the ErrorHandler interface.
This closes bug #126034.

Oops.  The value "0 or +1" for the category argument of PyErr_Warn()
doesn't work.  Make it 0.  (Although it really *should* be 0 or +1 --
the refcount is incremented when it is raised as an exception, but not
otherwise.)

Document Pyerr_Warn().

Add an XXX comment at the beginning expressing disappointment over the
confusing way refcount behavior of arguments is documented.

Document Pyerr_Warn().

Document the -W option as best as I can.

Get rid of BeOpen references.

Improve error messages for invalid warning arguments; don't raise
exceptions but always print a warning message.

Make string.translate(s, table) work for Unicode s.  Two things are
required to work around restrictions on the arguments of
u.translate():

1) don't pass the deletions argument if it's empty;

2) convert table to Unicode if s is Unicode.

This fixes SF bug #124060.

Fix off-by-one error in split_substring().  Fixes SF bug #122162.

Test more split argument combinations:
1) multi-char separator
2) multi-char separator that only occurs at last position
3) all of the above with mixed Unicode and 8-bit-string arguments

Minimal fix for the complaints about pickling Unicode objects.  (SF
bugs #126161 and 123634).

The solution doesn't use the unicode-escape encoding; that has other
problems (it seems not 100% reversible).  Rather, it transforms the
input Unicode object slightly before encoding it using
raw-unicode-escape, so that the decoding will reconstruct the original
string: backslash and newline characters are translated into their
\uXXXX counterparts.

This is backwards incompatible for strings containing backslashes, but
for some of those strings, the pickling was already broken.

Note that SF bug #123634 complains specifically that cPickle fails to
unpickle the pickle for u'' (the empty Unicode string) correctly.
This was an off-by-one error in load_unicode().

XXX Ugliness: in order to do the modified raw-unicode-escape, I've
cut-and-pasted a copy of PyUnicode_EncodeRawUnicodeEscape() into this
file that also encodes '\\' and '\n'.  It might be nice to migrate
this into the Unicode implementation and give this encoding a new name
('half-raw-unicode-escape'? 'pickle-unicode-escape'?); that would help
pickle.py too.  But right now I can't be bothered with the necessary
infrastructural changes.

Test some Unicode pickling endcases.

Minimal fix for the complaints about pickling Unicode objects.  (SF
bugs #126161 and 123634).

The solution doesn't use the unicode-escape encoding; that has other
problems (it seems not 100% reversible).  Rather, it transforms the
input Unicode object slightly before encoding it using
raw-unicode-escape, so that the decoding will reconstruct the original
string: backslash and newline characters are translated into their
\uXXXX counterparts.

This is backwards incompatible for strings containing backslashes, but
for some of those strings, the pickling was already broken.

Adapted from a patch by Barry Scott, SF patch #102875 and SF bug
#125981: closing sockets was not thread-safe.

gdbm.open() no longer accepts garbage in the flags string.  Fix the tests.

Do not talk about "real" numbers; talk about "floats" or "floating point
numbers" instead; we have not described "reals" anywhere else in the
documentation, and this is not the place to change the story!

Reported by Keith Briggs <keith.briggs@bt.com>.

Add support for gdbm2 open flags ('s' and 'u').  Add module constant
open_flags which contains the flags supported by gdbm.  Closes patch
#102802.

Add returns_unicode to the __members__ list.
Fix a small style consistency nit.

Do not assume that types.UnicodeType exists; we might be running in an old
version of Python.  ;-(

Use the string module instead of string methods; this should still work
with Python 1.5.2 for now.

urlretrieve() description included explanation of "data" parameter, but
did not include it in the signature.

Fixed some markup nits.

Typo caught by /F -- thanks!

Add definitions for PySys_ResetWarnOptions() and
PySys_AddWarnOption().

Add declarations for PySys_ResetWarnOptions() and
PySys_AddWarnOption().

Add the -W option.

Python part of the warnings subsystem.

Add PyErr_Warn().

Add definitions for standard warning category classes (PyExc_Warning
etc.).

Add declarations for standard warning category classes (PyExc_Warning
etc.) and the PyErr_Warn() function.

Before calling traceback.print_exc(), call sys.stdout.flush().  This makes
it much easier to see where things went wrong.

DOMException.__init__():  Remember to pass self to Exception.__init__().

Comment out a debugging print statement that triggered a complaint in
c.l.py.

Added documentation for random.shuffle().

Get rid of string functions.

Get rid of string functions.  References to string.whitespace,
string.digits are left.

Get rid of string functions.

There should really be a little tool to help with this -- it's rather
tedious and there are lots of special cases!

Get rid of string functions, except maketrans() (which is *not*
obsolete!).

Fix a bug in ftpwrapper.retrfile() where somehow ftplib.error_perm was
assumed to be a string.  (The fix applies str().)

Also break some long lines and change the output from test() slightly.

Add test case for error message raised by bad % format character
(Oh, look, it adds another little utility function for testing)

[ Patch #102852 ] Make % error a bit more informative by indicates the
index at which an unknown %-escape was found

Grant Griffin <grant.griffin@honeywell.com>:
Clarify that invert() is a *bitwise* operation.

Fix typo

Document napms()
Add reference to demo directory

[Patch #102827] Fix for PR#119558, avoiding core dumps by checking for
malloc() returning NULL

Wrapper for napms() function, contributed by Thomas Gellekum <tg@FreeBSD.org>

Curses demos contributed by Thomas Gellekum <tg@FreeBSD.org>.
ncurses.py requires panel support, and therefore doesn't work yet.

Various tweaks. It now returns the exact same files as Matthias' tool 95% of the time.

Oops, interaction() returned a single value in stead of a tuple (I thought that bug was loooong fixed??!?).

First stab at a script that mimicks Matthias Neerachers tool used to build GUSI.

Set autodispose only if RefCon isn't set yet on the window. This way we don't accidentally dispose of windows that are actually dialogs-in-disguise.

Fix bit rot: use sock.connect((host, port)) and allow 2nd cmd line
arg.

For the title page, insert the package version number before the date.
This makes the title area more like the title are of the top-level
index, and puts the information more people are interested in first.

Update the test suite to cover more ground.

This closes patch #102477.

Lots of small bug fixes and DOM API conformance improvements:

Make Node inherit from xml.dom.Node to pick up the NodeType values
defined by the W3C recommendation.

When raising AttributeError, be sure to provide the name of the attribute
that does not exist.

Node.normalize():  Make sure we do not allow an empty text node to survive
                   as the first child; update the sibling links properly.

_getElementsByTagNameNSHelper():  Make recursive calls using the right
                                  number of parameters.

Attr.__setattr__():  Be sure to update name and nodeName at the same time
                     since they are synonyms for this node type.

AttributeList:  Renamed to NamedNodeMap (AttributeList maintained as an
                alias).  Compute the length attribute dynamically to allow
                the underlying structures to mutate.

AttributeList.item():  Call .keys() on the dictionary rather than using
                       self.keys() for performance.

AttributeList.setNamedItem(), .setNamedItemNS():
        Added methods.

Text.splitText():
        Added method.

DocumentType:
        Added implementation class.

DOMImplementation:
        Added implementation class.

Document.appendChild():  Do not allow a second document element to be added.

Document.documentElement:  Find this dynamically, so that one can be
        removed and another added.

Document.unlink():  Clear the doctype attribute.

_get_StringIO():  Only use the StringIO module; cStringIO does not support
                  Unicode.

Adjust PullDOM to use a DOMImplementation instance to create new Document
objects; uses minidom if one is not provided to the constructor.

parse():  Pick up the default_bufsize default value dynamically so that
          the value in the module may be (meaningfully) changed at runtime.

This (partially) closes patch #102477.

Test for NULL returned from PyObject_NEW().

Test for NULL returned from PyObject_NEW().

Update information on the locking() function, added the needed constants.
(Thanks for the info, Tim!)

Add long-overdue docstrings to dict methods.

Finish a sentence that was left half-written!

Use METH_VARARGS instead of "1" in list method table.

When raising KeyError, provide the key value that failed.

Changing allow_reuse_address's default value, and documenting it.

Untabify!  (Barry, this is gonna cost you a bottle of wine! ;)

Typo repair in comments.  Fell for GregS's .popitem() poke.

Added "stub" documentation for xml.dom.pulldom for Paul to fill out with
useful explanations.

Get rid of string module and string exceptions.

Added descriptions of the defined exceptions and their mapping to the
DOM recommendation.

Set CXX even when --with-cxx is not specified. Closes bug 14782.

Set CXX even when --with-cxx is not specified. Closes bug #124782

Add code to DOMException to ensure it cannot be instantiated directly,
since the API documentation will state specifically that the specializations
must be used by the DOM implementations.

Add standard DOM exception hierarchy.

Document --with-cxx.

Check in README file and one demo program

Bring comments up to date (e.g., they still said the table had to be
a prime size, which is in fact never true anymore ...).

Update the code to better reflect recommended style:

Use != instead of <> since <> is documented as "obsolescent".
Use "is" and "is not" when comparing with None or type objects.

Change the file's indentation from tabs to 4 spaces per level.

Accept Finn Bock's patch #102208 to hardcode EINVAL to 22 when errno
can't be imported.  This makes StringIO.py work with Jython.

Also, get rid of the string module by converting to string methods.

Shorten some lines by using augmented assignment where appropriate.

Update the code to better reflect recommended style:

Use != instead of <> since <> is documented as "obsolescent".
Use "is" and "is not" when comparing with None or type objects.

The Mac C library (MSL from CodeWarrior 6) and I/O library (GUSI
2.1.3) finally agree on when the epoch is, so the code to convert
epochs has been disabled.