Clarify that the bool instances are acceptable return values from
__nonzero__(), in response to SF bug #579991.

Document handling of raw-unicode-escapes.  Closes SF bug 587087.

Added references to the email package.
Closes SF bug #586937.

SF patch #591305 Documentation err in bytecode defs

Remove calls to 2.1 GC API (they are noops).

SF 582071 clarified the .split() method's docstring to note that sep=None
will trigger splitting on any whitespace.

Add trace_frame. Fixes #534864.

Fix ref(), proxy() docstrings, based on comments from David Abrahams.

Backport:
Fix for SF bug 570678 (can't flush read-only file on Mac OS X).

Backport:

Tim found that once test_longexp has run, test_sort takes very much
longer to run than normal.  A profiler run showed that this was due to
PyFrame_New() taking up an unreasonable amount of time.  A little
thinking showed that this was due to the while loop clearing the space
available for the stack.  The solution is to only clear the local
variables (and cells and free variables), not the space available for
the stack, since anything beyond the stack top is considered to be
garbage anyway.  Also, use memset() instead of a while loop counting
backwards.  This should be a time savings for normal code too!  (By a
probably unmeasurable amount. :-)

Backport:

SF patch 588728 (Nathan Srebro).

The __delete__ method wrapper for descriptors was not supported

(I added a test, too.)

Put Cray fixes on the branch, too.

SF patch #581414: info reader bug

The "Matching vs. Searching" Info node is unreachable from the Info
program (but is fine in Emacs's Info mode). This patch seems to fix
it.  This is the only occurrence where the info reader fails, so
probably it could be addressed in the python docs as a workaround.
Forwarded the report to the info maintainer.

Fix docstring to be consistent with parameter name (prefix)

SF patch #587889, fix memory leak of tp_doc

Revert #571603 since it is ok to import codecs that are not subdirectories
of encodings. Skip modules that don't have a getregentry function.

Pass length of result structure into setipaddr. Fixes bug #565747.

Fix SF bug 587012, doc mentions inexistent builtin unistr

Patch #571603: Refer to encodings package explicitly.

Patch #554716: Use __va_copy where available.

Better yet, make it the same as the equivalent changes already made to
the version on the trunk.

Update references to Digital Creations.

Small clarifications when referring to the sys.exc_* variables so that
readers are not given the wrong impression that they should be using those
on a regualar basis.
This closes SF bug #585598.

SF patch #581396, Canvas "select_item" always returns None

Return the selected item, if there is any.

reduce(): Clarified what is returned in the case of a sequence 1 item long and
initial/default value.

Use sys.executable to run Python, as suggested by Neal Norwitz.

The atexit module effectively turned itself off if sys.exitfunc already
existed at the time atexit first got imported.  That's a bug, and this
fixes it.

Also reworked test_atexit.py to test for this too, and to stop using
an "expected output" file, and to test what actually happens at exit
instead of just simulating what it thinks atexit will do at exit.

Given the persistent id code a shot at a class before calling save_global().

Backported from the trunk.

The object returned by tp_new() may not have a tp_init.

If the object is an ExtensionClass, for example, the slot is not even
defined.  So we must check that the type has the slot (implied by
HAVE_CLASS) before calling tp_init().

Clarify the return value of __nonzero__(): It *must* be an integer.
Closes SF bug #579991.

Backport:

Remove httplib from tested modules.

The test of httplib makes it difficult to maintain httplib.  There are
two many idioms that pyclbr doesn't seem to understand, and I don't
understand how to update these tests to make them work.

Also remove commented out test of urllib2.

Update output for new tests.

Backport changes.

Change _begin() back to begin().
Fix for SF bug 579107.
Fix for SF bug #432621: httplib: multiple Set-Cookie headers
Fix SF bug #575360
Handle HTTP/0.9 responses.

(Backport.)

Fix SF bug 579701 (Fernando Pérez); an input line consisting of one or
more spaces only crashed pdb.

subtype_resurrection():  Removed unused import.

subtype_resurrection():  The test suite with -l properly reported the
immortal object here as a leak.  Made the object mortal again at the end.

Repaired optimistic comment in new test.

Attempting to resurrect a dying instance of a new-style class in a
__del__ method died with

    Fatal Python error: GC object already in linked list

in both release and debug builds.  Fixed that.  Added a new test that
dies without the fix.

Document gc.get_objects().
Closes SF bug #578308.

Update the comments on building the pyexpat extension.
Closes SF bug #577774.

Note that unicode() can raise LookupError for unknown codecs.
Closes SF bug #513666.

SF bug 578752: COUNT_ALLOCS vs heap types
Repair segfaults and infinite loops in COUNT_ALLOCS builds in the
presence of new-style (heap-allocated) classes/types.

Note:  test_gc fails in a COUNT_ALLOCS build now, because it expects
a new-style class to get garbage collected.

PyNode_AddChild():  Backporting an aggressive over-allocation policy
when a parse node grows a very large number of children.  This sidesteps
platform realloc() disasters on several platforms.

Fix typo.
Closes SF bug #578420.

Fix typo reported by Kent Engström, and a bunch of broken markup.

Fix typo:  "an Unicode string" --> "a Unicode string"
Clarify the return value when the parameter is a Unicode object.

Add annotations that describe the change in the "errors" and "failures"
attributes of the TestResult.

Update the documentation of the errors and failures attributes of the
TestResult object.  Add an example of how to get even more information for
apps that can use it.
Closes SF bug #558278.

Track change of begin() to _begin().

Backport various bug fixes from trunk.

The 2.2 maintenace branch is now identical to the trunk through rev
1.53.

Backport for SF bug #574132:  Major GC related performance regression.
2.2.1 has another bug that prevents the regression (which isn't a
regression at all) from showing up.  "The regression" is actually a
glitch in cyclic gc that's been there forever.

As the generation being collected is analyzed, objects that can't be
collected (because, e.g., we find they're externally referenced, or
are in an unreachable cycle but have a __del__ method) are moved out
of the list of candidates.  A tricksy scheme uses negative values of
gc_refs to mark such objects as being moved.  However, the exact
negative value set at the start may become "more negative" over time
for objects not in the generation being collected, and the scheme was
checking for an exact match on the negative value originally assigned.
As a result, objects in generations older than the one being collected
could get scanned too, and yanked back into a younger generation.  Doing
so doesn't lead to an error, but doesn't do any good, and can burn an
unbounded amount of time doing useless work.

A test case is simple (thanks to Kevin Jacobs for finding it!):

x = []
for i in xrange(200000):
    x.append((1,))

Without the patch, this ends up scanning all of x on every gen0 collection,
scans all of x twice on every gen1 collection, and x gets yanked back into
gen1 on every gen0 collection.  With the patch, once x gets to gen2, it's
never scanned again until another gen2 collection, and stays in gen2.

Opened another bug about that 2.2.1 isn't actually tracking (at least)
iterators, generators, and bound method objects, due to using the 2.1
gc API internally in those places (which #defines itself out of existence
in 2.2.x).

Fixed bug 574978 shutil example out of sync with source code

Fix bug 575221 referred to dictionary type instead of dict.

Clarify the version information for the unicode() built-in.
Closes SF bug #575272.

Backport 1.37: dis.dis() also supports modules, (also backport other changes back to 1.33 since these all apply to 2.2)

Fix various typos reported to python-docs.

Fix typo reported to python-docs.

Fix bug #573916.  Sender and recipients reversed in email example.

[Backport of recent changes to the SAX documentation.]

Add more links to the "See also" section for the xml.sax package.
Talk about interfaces rather than implementation classes where appropriate.
Add hyperlinks to make the documentation on the Attributes and AttributesNS
interfaces more discoverable.
Closes SF bug #484603.

Fix typo

Completed previous edit

Close bug 480337:  Dict used before dicts explained.  Added explanation
and examples of the dict() constructor.

Close bug 417930 by clarifying augmented assignment docs

Fix SF bug 568269 by enclosing 'computername' in a raw string

Backport change to 1.58 giving Lambda a separate section.

Fix SF Bug 572567: Memory leak in object comparison

SF # 572928 One word change for lib/libgettext.tex

Fix typo.

Correct the RE equivalent of scanf()'s %x and %X patterns.
Closes SF bug #572169.

Backport of Greg Ward's rev. 1.6 from the trunk:
Typo fix.

Corrected return type and value information for PyUnicode_Count() and
PyUnicode_Find().
This closes SF bug #566631.

Fix the docstring for sys.getrefcount().
Closes SF bug #571759.

Make the docs for string.capitalize() match those of str.capitalize()
(which makes it more clear).
Closes SF bug #571767.

SF 563530 added missing methods for emulating numeric types

Typo: bites --> bytes
(Hanging around small kids too much...;)

Add description of the deadlock problem with child processes and pipes, and
hints about how to work around it.
Closes SF bug #530637.

Add a note about "as" not being a keyword, though it has special meaning
when used as part of the import statement.

Note that both "as" and "None" becoming keywords in the future.

Closes SF bug #553262.

Note the limitation that mime_decode_header() only works for Latin-1.
Closes SF bug #551912.

Backport:
Patch from SF bug 570483 (Tim Northover).

In a fresh interpreter, type.mro(tuple) would segfault, because
PyType_Ready() isn't called for tuple yet.  To fix, call
PyType_Ready(type) if type->tp_dict is NULL.

Corect speling and add \n\ to line ends in new docstring for access().

Clarified documentation for os.access().
Based on patch contributed by Sean Reifschneider.
Closes SF patch #570618.

Clarified description of error handling for shutil.rmtree().
This closes SF patch #569832.

Update description of the Expat library.
Closes SF bug #556370.

PyModule_AddObject():  Added missing exceptions.
Closes SF bug #523473.

Fix documentation for PyMarshal_WriteObjectToFile() and
PyMarshal_WriteObjectToFile().
This closes SF bug #533735.

Clean up descriptions of PyObject_RichCompare() and PyObject_RichCompareBool()
based on comments from David Abrahams.
Added refcount information for these functions.

Test for the bug in recurse_down_subclasses() that I just fixed.

Backport:
Inexplicably, recurse_down_subclasses() was comparing the object
gotten from a weak reference to NULL instead of to None.  This caused
the following assert() to fail (but only in 2.2 in the debug build --
I have to find a better test case).

Refer the reader to the correct module for constant definitions.
This closes SF bug #550777.

Document the Binary.data attribute.
This closes SF bug #562878.

SF # 533070 Silence AIX C Compiler Warnings

Warning caused by using &func.  & is not necessary.

Backport:
Fix for SF bug 532646.  This is a little simpler than what Neal
suggested there, based upon a better analysis (__getattr__ is a red
herring).
[This might be a 2.1 bugfix candidate we well, if people care]

Do not claim that getlocale() returns a tulpe; that is not always true.
Closes SF bug #568577.

Add documentation for PyObject_RichCompare() and PyObject_RichCompareBool(),
constributed by David Abrahams.
This closes SF patch #568081.

Add version annotations for some older changes to the calendar module.
Closes SF patch #567867.

Backport 1.15:

Add a testcase to ensure that cycles going through the __class__ link
of a new-style instance are detected by the garbage collector.

Backport:

SF bug 567538: Generator can crash the interpreter (Finn Bock).

This was a simple typo.  Strange that the compiler didn't catch it!
Instead of WHY_CONTINUE, two tests used CONTINUE_LOOP, which isn't a
why_code at all, but an opcode; but even though 'why' is declared as
an enum, comparing it to an int is apparently not even worth a
warning -- not in gcc, and not in VC++. :-(

Completely revise markup for the list of list methods; the new markup matches
the semantics and presentation used in the library reference.
Added an explanation of the use of [...] to denote optional arguments, since
this is the only use of this in a signature line.
Closes SF bug #567127.

Record the latest fixes.

Backport:

SF patch 560794 (Greg Chapman): deepcopy can't handle custom
metaclasses.

This is essentially the same problem as that reported in bug 494904
for pickle: deepcopy should treat instances of custom metaclasses the
same way it treats instances of type 'type'.

Backport two patches that belong together:

(2.150)
In the recent python-dev thread "Bizarre new test failure", we
discovered that subtype_traverse must traverse the type if it is a
heap type, because otherwise some cycles involving a type and its
instance would not be collected.  Simplest example:
    while 1:
        class C(object): pass
        C.ref = C()
This program grows without bounds before this fix.  (It grows ever
slower since it spends ever more time in the collector.)

Simply adding the right visit() call to subtype_traverse() revealed
other problems.  With MvL's help we re-learned that type_clear()
doesn't have to clear *all* references, only the ones that may not be
cleared by other means.  Careful analysis (see comments in the code)
revealed that only tp_mro needs to be cleared.  (The previous checkin
to this file adds a test for tp_mro==NULL to _PyType_Lookup() that's
essential to prevent crashes due to tp_mro being NULL when
subtype_dealloc() tries to look for a __del__ method.)  The same kind
of analysis also revealed that subtype_clear() doesn't need to clear
the instance dict.

With this fix, a useful property of the collector is once again
guaranteed: a single gc.collect() call will clear out all garbage.
(It didn't always before, which put us on the track of this bug.)

(2.151)
Undo the last chunk of the previous patch, putting back a useful
assert into PyType_Ready(): now that we're not clearing tp_dict, we
can assert that it's non-NULL again.