Summarized changes: threading.local, Py_CLEAR, Py_VISIT, improved type
tutorial.

Documented the new Py_VISIT macro to simplify implementation of
tp_traverse handlers. (Tim made me do it. ;)

Implemented a new Py_CLEAR macro. This macro should be used when
decrementing the refcount of variables that might be accessed as a
result of calling Python

Updated documentation to:

- point out the importance of reassigning data members before
  assigning thier values

- correct my missconception about return values from visitprocs. Sigh.

- mention the labor saving Py_VISIT and Py_CLEAR macros.

Ported some features from zope:

- Fixed the display of tests in verbose output
- Allow setUp and tearDown functions to be provided for DocTestSuites.

* Hide a loop induction variable that was inadvertantly being picked up
  by the locals() call in the context constructor.

* Remove unnecessary properties for int, exp, and sign which duplicated
  information returned by as_tuple().

* Rename "Signals" to "_signals" making it non-public.
* Context.create_decimal can take a zero default just like Decimal().
* Fix typo in comment.

Recompiled after source file changes.

Ignore some more build products.

Add a warning so that it isn't forgotten to recreate the binaries AND
CHECK INTO CVS if these files are changed.

Don't complain that non-existant registry entries cannot be deleted.

This is Pete Shinners' patch from his bug report

[ 984722 ] Py_BuildValue loses reference counts on error

I'm ever-so-slightly uneasy at the amount of work this can do with an
exception pending, but I don't think that this can result in anything
more serious than a strange error message.

- Bug #981530: Fix UnboundLocalError in shutil.rmtree().  This affects
  the documented behavior: the function passed to the onerror()
  handler can now also be os.listdir.

[I could've sworn I checked this in, but apparently I didn't, or it
got lost???]

- Bug #981530: Fix UnboundLocalError in shutil.rmtree().  This affects
  the documented behavior: the function passed to the onerror()
  handler can now also be os.listdir.

[I could've sworn I checked this in, but apparently I didn't, or it
got lost???]

It helps when doing checks if something is in a tuple of strings that if you
put everything in the tuple in caps to use str.upper() instead of str.lower().

clarify where \versionadded and \versionchanged should be placed when
they are used

Claifications:  visit procs are supplied by the core, users aren't
expected to write their own.  A NULL "object" must not be passed to
the visit callback.  A non-zero return from a visit proc isn't
necessarily an error return (and it doesn't matter to the tp_traverse
code *what* it might signify, their only job is to return it).

generalize a bit; no need to mention my user id directly

Wordsmithing

Fixes a bug in testing code handling .pth files that did not restore the original
module that is removed for testing "import" lines.  Originally deleted the
entry from sys.modules and then just let other code that needed it to import it
again.  Problem with this solution is that it lead to code that had already
imported the module in question to have their own reference to a new copy of
the module in question that new code couldn't reach.  This lead to a failure in
test_strptime since it monkey-patched the 'time' module it had a reference to
while _strptime had its own reference to another copy of 'time' from being
imported by test___all__ that it was using for a calculation.

Also moved the testing code out of the PthFile class and into the actual test
class.  This was to stop using 'assert' which is useless with a -O execution.

Add another point in the "Restrictions" section about how the handling of FTP
URLs will seemingly succeed to read a URL that points to a file whose
permissions you do not have to read.

Backport candidate once everyone agrees with the wording.

Using repr() generates entries that the current stats package can't
collate, so setting it back to the function name

Updated my email address to something that works <wink>.

Fix test case for when time.tzname[0] is either UTC or GMT.  Also have test
output more telling details when there is a failure.

Fixed minor bugs in the example configuration file

Fix SF Bug #989066

Use set() instead of sets.Set()

Small elaboration and typo fixes.

Add more known macros.

this is patch

[ 988698 ] compiler.transformer fix for (a, b) = 1, 2

fixing bug

[ 988613 ] compiler.transformer and tuple unpacking

Fix markup.

FreeBSD's services file contains an additional echo service entry, with
a non-standard protocol and on a lower port than the tcp/udp entries,
which breaks the assumption that there will only be one service by a
given name on a given port when no protocol is specified.

Previous versions of this code have had other problems as a result of
different service definitions amongst common platforms.  As this platform
has an extra, unexpected, service entry, I've special cased the platform
rather than re-order the list of services checked to highlight the pitfall.

install test/decimaltestdata as well

install test/decimaltestdata as well

Removed debugging print statements from TimedRotatingFileHandler, and sorted list returned by glob.glob() (SF #987166)

another note for amk

Simplified the new get/get_nowait/put/put_nowait implementations a bit.

Bug #788520: Queue class has logic error when non-blocking

I don't agree it had a bug (see the report), so this is *not* a candidate
for backporting, but the docs were confusing and the Queue implementation
was old enough to vote.

Rewrote put/put_nowait/get/get_nowait from scratch, to use a pair of
Conditions (not_full and not_empty), sharing a common mutex.  The code
is 1/4 the size now, and 6.25x easier to understand.  For blocking
with timeout, we also get to reuse (indirectly) the tedious timeout
code from threading.Condition.  The Full and Empty exceptions raised
by non-blocking calls are now easy (instead of nearly impossible) to
explain truthfully:  Full is raised if and only if the Queue truly
is full when the non-blocking put call checks the queue size, and
similarly for Empty versus non-blocking get.

What I don't know is whether the new implementation is slower (or
faster) than the old one.  I don't really care.  Anyone who cares
a lot is encouraged to check that.

SF patch 986010: add missing doc for datetime C API, from
Anthony Tuininga.

This is a derived patch, taking the opportunity to add some organization
to the now-large pile of datetime-related macros, and to factor out
tedious repeated text.

Also improved some clumsy wording in NEWS.

Remove tabs introduced in last commit.

Patch [ 972332 ] urllib2 FTPHandler bugs / John J. Lee
Modified Files:
urllib2.py test/test_urllib2.py

Add FAQ on non-GNU make error.  Update copyright date to 2004.

Added documentation for the "smtpd" module.
Closes SF bug #450803.

Style nit.

Fix decimal write-up nits.

Minor improvements, fixups and wording changes everywhere.

Clarify requirement for GNU make

Patch 851752 (fixes bug 820583)
Patch by John J Lee
Reviewed by Jeff Epler / KBK
Doc built OK.

urlopen() may return None if no handler handles the request.

Also clarify what install_opener does.

M liburllib2.tex

SequenceMatcher(None, [], []).get_grouped_opcodes() now returns a generator
that behaves as if both lists has an empty string in each of them.

Closes bug #979794 (and duplicate bug #980117).

[Patch #947352 from Jason Andryuk] Add support for AF_PACKET hardware addresses

Debug output is now printed to sys.stderr .

Closes bug #980938.

Fix minor error in example.

posixpath.realpath() now detects symlink loops and returns the path just before
the loop starts.

Closes bug #930024.  Thanks AM Kuchling.

Add PyArg_VaParseTupleAndKeywords().  Document this function and
PyArg_VaParse().

Closes patch #550732.  Thanks Greg Chapman.

[Patch #981794] Add support for Firefox/Firebird

[Patch 988444]
Read multiple special headers
- fixed/improved handling of extended/special headers
in read-mode (adding new extended headers should be
less painful now).
- improved nts() function.
- removed TarFile.chunks datastructure which is not
(and was never) needed.
- fixed TarInfo.tobuf(), fields could overflow with too
large values, values are now clipped.

[Patch #965175] Incorporate a suggestion for a better error message

Change some declarations from ``char *`` to ``const char *``.  Also added
docstrings for decode and encode; accidentally were left out of the PyMethodDev
table.

[Patch #909007] Enable a bunch of safe bug workarounds in OpenSSL, for compatibility with various broken SSL implementations out there.

Add item

[Patch #945642] Fix non-blocking SSL sockets, which blocked on reads/writes in Python 2.3.
(It turns out that the Debian unstable packaging of Python 2.3.4 includes this patch.)
Patch by Tino Lange.

Clarify docs for inspect.getargspec() that the fourth value is None when there
are no default arguments for the function.

Make ntpath compress multiple slashes between drive letter and the rest of the
path.  Also clarifies UNC handling and adds appropriate tests.

Applies patch #988607 to fix bug #980327.  Thanks Paul Moore.

[Patch #988602] Move the urllib2 tests into the test framework

Add comments at end of every #endif and fix ones already there when for closing
off #ifndef's.

Add note about closing of bug #679953 and add Jimmy Burgett for helping out to
Misc/ACKS.

Make struct formats for specifying file size to be unsigned instead of signed
(ZIP file spec. says in section K, "General notes" in point 1 that unless
specified otherwise values are unsigned and they are not specified as signed in
the spec).

Closes bug #679953.  Thanks Jimmy Burgett.

Add an item

[Patch #969900] Various corrections and updates to cookielib docs

[Patch #969907] Add traceback to warning output

[Patch #972310] Apply correction to docs

In poll(), check connections for exceptional conditions

Added note about new codecs module APIs.

Fix typo.

[Bug 949832] Fix example; edit sentence

Return value from .close(); move .set_file up

[Bug #835415] AIX can return modes that are >65536, which causes an OverflowError.  Fix from Albert Chin

[Patch #988504] Fix HTTP error handling via a patch from John J. Lee

[Patch #982665 ] add SO_EXCLUSIVEADDRUSE constant

[Patch #987052  from Thomas Guettler]
Don't output empty tags
Escape page header
Remove <p> before <table> (tidy complains)

Improve Context construction and representation:

* Rename "trap_enablers" to just "traps".
* Simplify names of "settraps" and "setflags" to just "traps" and "flags".
* Show "capitals" in the context representation
* Simplify the Context constructor to match its repr form so that only
  the set flags and traps need to be listed.
* Representation can now be run through eval().

Improve the error message when the Decimal constructor is given a float.

The test suite no longer needs a duplicate reset_flags method.

Remove a few elderly sentences

Replace example with simpler alternative using PyGILState_{Ensure,Require).  Can someone please confirm this change is OK?

[Bug #987835] Add documentation from PEP 311.  (Untested TeX code.)

Add generic codecs.encode() and .decode() APIs that don't impose
any restriction on the return type (like unicode.encode() et al. do).

Fix a copy&paste typo.

SF bug #987486: fix typo.

SF bug 988387:  markup nits.

Restructure testing of .pth files.  Move previous functions into a class and
create a testing method that can be called to make sure that the handling of
the .pth file was correct.

Add an #ifdef __APPLE__ around typedef of foreachfunc to match Apple's
incorrect declaration for ypall_callback in /usr/include/rpcsvc/ypcInt.h .
Shouldn't hurt any code since the differences are unsigned long instead of int and
void * instead of char *.  Removes warning about improper function pointer
assignment during compilation.

Change argument list for addsitedir() to not require a second argument and thus
match old verion's argument list (overlooked since API of the file is
undocumented).

Fix memory leak and bump the version per Greg

Cleanup support for older pythons (perhaps it should be removed?)

reminder for amk

Add some tests for corner cases.

* Update the test suite to reflect that ConversionSyntax was no longer
  public.
* Removed the non-signal conditions from __all__.
* Removed the XXX comment which was resolved.
* Use ^ instead of operator.xor
* Remove the threading lock which is no longer necessary.

Module and tests:
* Map conditions to related signals.
* Make contexts unhashable.
* Eliminate used "default" attribute in exception definitions.
* Eliminate the _filterfunc in favor of a straight list.

Docs:
* Eliminate documented references to conditions that are not signals.
* Eliminate parenthetical notes such as "1/0 --> Inf" which are no
  longer true with the new defaults.

post-release fun

post-release fun

Incorporate Facundo's suggestions.