Undo last checkin.

Straighten out some markup.
"boolean" --> "Boolean" (per the style guide).

Undo last checkin, since it duplicated the code.

slot_sq_length(): squash a leak.

Refer to the objects which define __len__(), __*item__(), and __iter__()
as container objects rather than as mapping objects (in the index entries).
Change the section heading and intro sentence to be a little more general,
since that's how things have actually evolved.

slot_tp_new(): newargs was leaking.

Clarify comments about mailbox objects being iterable.

Docs for SF patch #462628

Another SF patch contributor.

SF patch #462628 (Travers Naran) NNTPLib supports saving BODY to a file.

  I modified nntplib so the body method can accept an
  optional second parameter pointing to a filehandle or
  filename (string). This way, really long body
  articles can be stored to disk instead of kept in
  memory. The way I made the modification should make
  it easy to extend this functionality to other extended
  return methods.

Fix typo found by doerwalter.

Patch #426880: Implement Listbox itemcget and itemconfigure.

Patch #462122: add readline startup and pre_event hooks.

Patch #462190, patch #464070: Support quoted printable in the binascii module.
Decode and encode underscores for header style encoding. Fixes bug #463996.

Properly detect recursive structures. Adopted from patch #465298.

The execfile() docs imply it acts on locals same as exec.  But in truth
it acts more like assigning to keys in locals(), i.e. modifications to
function locals aren't reflected in the locals when execfile() returns.

Correct docs for long(float).

SF bug [#466173] unpack TypeError unclear
Replaced 3 instances of "iter() of non-sequence" with
"iteration over non-sequence".
Restored "unpack non-sequence" for stuff like "a, b = 1".

SF [#466125] PyLong_AsLongLong works for any integer.
Generalize PyLong_AsLongLong to accept int arguments too.  The real point
is so that PyArg_ParseTuple's 'L' code does too.  That code was
undocumented (AFAICT), so documented it.

Handle PEP references the same way RFC references.

Fix two typos in the text about compile(), and add two caveats from
recent user feedback: you must end the input with \n and you must use
\n, not \r\n to represent line endings.

forgot to mark use of StringType and UnicodeType in the text.

added description of StringTypes object

Fix up whitespace in <args> elements; reduce sequences of consecutive
whitespace characters to a single space.
Small changes elsewhere, mostly to clean up the code a little.

Minor markup improvement.

For Python 2.2, do not use __getattr__(), only use computed properties.
This is probably a little bit faster, but mostly is just cleaner code.
The old-style support is still used for Python versions < 2.2 so this
source file can be shared with PyXML.

_dispatch():  Do no re-define the resolve_dotted_atttribute() function
    every time this gets called; move it out as a global helper function.
    Simplify the call to the _dispatch() method of the registered instance.

The list.sort() docs require a function that returns -1, 0 or +1.  That's
never been true, and in particular implies cmp() can't be used(!).  Get
closer to the truth.

The changes to ternary_op could cause a core dump.  Fix this, and
rewrite the code a bit to avoid calling the same slot more than once.

Clarify the warning about the relative dates of Setup.dist and Setup;
Jeremy had seen the warning but not realized what he should do about
it.  Add the hint "Usually, copying Setup.dist to Setup will work."

Add a few ``__dynamic__ = 0'' lines in classes that need to preserve
staticness when __dynamic__ = 1 becomes the default:

- Some classes which are used to test the difference between static
  and dynamic.

- Subclasses of complex: complex uses old-style numbers and the slot
  wrappers used by dynamic classes only support new-style numbers.
  (Ideally, the complex type should be fixed, but that looks like a
  labor-intensive job.)

It's a fact: for binary operators, *under certain circumstances*,
__rop__ now takes precendence over __op__.  Those circumstances are:

  - Both arguments are new-style classes
  - Both arguments are new-style numbers
  - Their implementation slots for tp_op differ
  - Their types differ
  - The right argument's type is a subtype of the left argument's type

Also did this for the ternary operator (pow) -- only the binary case
is dealt with properly though, since __rpow__ is not supported anyway.

Ouch.  The wrapper for __rpow__ was the same as for __pow__, resulting
in bizarre outcomes.  Test forthcoming.

Move XML-RPC-related docs to the "Internet Protocols" chapter.
Add entry for the SimpleXMLRPCServer module.

Add entry for the SimpleXMLRPCServer module.

Preliminary documentation for the SimpleXMLRPCServer module.

Post-release fiddling (prep for 2.2b1).

Minor additions and rewrites.
Bump version number.

Update the xml.dom.minidom tests to cover the DOM-compliant parts of the
NodeList interface.

Install the new compiler and email packages

Tighten up the new NodeList implementation.
Clean up a little; do not create an alias that is only used once, or store
attributes with constant values in an instance.

Remove an infelicitous space.

regrtest's -g option stopped working, during the changes to improve
 error-reporting for the classic compare-expected-output tests.
Curiously, the bug consisted of not simplifying the logic enough!

Reflect recent refinements of the regression testing framework.

Be more rigorous about making pathnames absolute, to address SF bug
#424002.

Refactor init_path_from_argv0() and rename to copy_absolute(); add
absolutize() which does the same in-place.

Clean up whitespace (leading tabs -> spaces, delete trailing
spaces/tabs).

Clean up circular references in the Weak*Dictionary classes; this avoids
depending on the cycle detector code in the library implementation.
This is a *slightly* different patch than SF patch #417795, but takes
the same approach.  (This version avoids calling the __len__() method of
the dict in the remove() functions.)
This closes SF patch #417795.

Reorder Still To Do items (highest priority on top), add one.

Add complex to the dispatch tables, to avoid going through the whole
rigmarole of __reduce__.

Changes to copy() and deepcopy() in copy.py to support __reduce__ as a
fallback for objects that are neither supported by our dispatch table
nor have a __copy__ or __deepcopy__ method.

Changes to _reduce() in copy_reg.py to support reducing objects that
don't have a __dict__ -- copy.copy(complex()) now invokes _reduce().

Add tests for copy.copy() and copy.deepcopy() to test_regrtest.py.

Removed files no longer needed.

PY_RELEASE_SERIAL => 4
PY_VERSION => "2.2a4+"

Convert to string methods.

For the real document element, make sure the prolog is migrated into
the document element so it isn't left stranded.

Make fixup_trailing_whitespace() whitespace do what was really intended.

Add the *desc environments used in the C API manual to the list of
things that can exist at the paragraph level so they don't get wrapped
in <para>...</para>.

Fixed a minor typo.

Use consistent version annotations instead of something ad hoc.

Convert most uses of the string module to string methods.
(string.join() lives!)

Added note about non-support of UNC paths on Windows.
This fixes SF bug #465447.

State that encode() and encodestring() append a newline to the input data
if it does not already end with a newline.
This fixes SF bug #463330.

Fix SF bug 419062: building pbs on AIX 4.3.2

Apply patch from "china@thewrittenword.com" to put the correct
location for ld_so_aix in BLDSHARED.

Merged changes from 22a4 branch.

For Python 2.2 and newer, actually support the full NodeList interface by
subclassing list to add the length and item() attributes.

Merge branch changes (coercion, rich comparisons) into trunk.

Add entries for the email and compiler packages.

Markup adjustments.

Added dependencies for the compiler and email packages.
(Migrate to branch, along with new files compiler.tex and asttable.tex.)

Migrate the compiler documentation from the Tools/compiler/doc/ directory.
Changes made to make it work in the new location.

Do not distinguish \refmodule from \module in the generated output;
whether or not a link will be generated will depend on the link database.
Add a couple of explanatory comments for one of the stranger constructs
(giving input an empty name).

Re-write <ulink> elements as described in the conversion spec.

Change the sense of a test in how the profiler interprets exception events.
This should fix a bug in how time is allocated during exception propogation
(esp. in the presence of finally clauses).

Bump Windows build numbers for 2.2a4; installer changes were done earlier.

Turn \input, \include, and \verbatiminput into XInclude elements instead
of something ad-hoc.

Added note about new StringIO/cStringIO feature.

Add support for some more markup that had slipped in.
Fixed a typo in a comment.

Fix comment typo

Fix some markup errors.

Markup adjustment: \[...\] is math markup and does not translate well when
used with text as was done here.  Fixed so that the typeset version wraps
the warning text and the HTML version does not create images of the warning
text.

docroutine() (both instances):  Docstrings for class methods weren't
getting displayed, due to a special case here whose purpose I didn't
understand.  So just disabled the doc suppression here.

Another special case here skips the docs when picking apart a method
and finding that the im_func is also in the class __dict__ under
the same name.  That one I understood.  It has a curious consequence,
though, wrt inherited properties:  a static class copies inherited stuff
into the inheriting class's dict, and that affects whether or not this
special case triggers.  The upshoot is that pydoc doesn't show the
function docstrings of getter/setter/deleter functions of inherited
properties in the property section when the class is static, but does
when the class is dynamic (bring up Lib/test/pydocfodder.py under
GUI pydoc to see this).

List class attrs in MRO order of defining class instead of by alphabetic
order of defining class's name.

Removed no-longer-true comment about pydoc working under all versions of
Python since 1.5 (virtually everything I changed over the last week relies
on "modern" features, particularly nested scopes).

Remove comment that no longer applies.

Updates do email package documentation for markup, style, and
organization.

Display a class's method resolution order, if it's non-trivial.  "Trivial"
here means it has no more than one base class to rummage through (in which
cases there's no potential confusion about resolution order).

More test cases, including something that simulates what the profiler
probably *should* be doing.

A file just to look at (using pydoc).

Add tests for new PyErr_NormalizeException() behavior

Add raise_exception() to the _testcapi module.  It isn't a test, but
the C API exists only to support test_exceptions.  raise_exception()
takes two arguments -- an exception class and an integer specifying
how many arguments it should be called with.

test_exceptions uses BadException() to test the interpreter's behavior
when there is a problem instantiating the exception.  test_capi1()
calls it with too many arguments.  test_capi2() causes an exception to
be raised in the Python code of the constructor.

PyErr_NormalizeException()

If a new exception occurs while an exception instance is being
created, try harder to make sure there is a traceback.  If the
original exception had a traceback associated with it and the new
exception does not, keep the old exception.

Of course, callers to PyErr_NormalizeException() must still be
prepared to have tb set to NULL.

XXX This isn't an ideal solution, but it's better than no traceback at
all.  It occurs if, for example, the exception occurs when the call to
the constructor fails before any Python code is executed.  Guido
suggests that it there is Python code that was about to be executed
-- but wasn't, say, because it was called with the wrong number of
arguments -- then we should point at the first line of the code object
anyway.

Don't export generators future info

Prevent a NULL pointer from being pushed onto the stack.

It's possible for PyErr_NormalizeException() to set the traceback
pointer to NULL.  I'm not sure how to provoke this directly from
Python, although it may be possible.  The error occurs when an
exception is set using PyErr_SetObject() and another exception occurs
while PyErr_NormalizeException() is creating the exception instance.

XXX As a result of this change, it's possible for an exception to
occur but sys.last_traceback to be left undefined.  Not sure if this
is a problem.

Move the styling for the HTML version of \mailheader into the CSS file.
In both the HTML and typeset versions of the documentation, add a colon
after the name of a mail header so that it is more easily distinguished
from other text.

Note that the colon following a mail header name should not be included
when using the \mailheader markup.
Change a couple of inline examples to show the markup rather than the
result.

Typo fix.

Move the \mailheader description to the right place.
Clarify the \mimetype description; it can be used to refer to a part of a
MIME type name, so \mimetype{text} or \mimetype{plain} can be used, not
just \mimetype{text/plain}.

Start making some markup adjustments; Barry has indicated he will work on
this before we finish the integration, along with some restructuring.

Test case for SF bugs #463359 and #462937, added to test_grammar for lack of
a better place. Excessively fragile code, but at least it breaks when
something in this area changes!

Update the tests for the current incarnation of the email package, and
added some new tests of message/delivery-status content type messages.

More test messages for test_email.py

_parsebody(): Use get_boundary() and get_type().

    Also, add a clause to the big-if to handle message/delivery-status
    content types.  These create a message with subparts that are
    Message instances, which best represent the header blocks of this
    content type.

has_key(): Implement in terms of get().

get_type(): Use a compiled regular expression, which can be shared.

_get_params_preserve(): A helper method which extracts the header's
    parameter list preserving value quoting.  I'm not sure that this
    needs to be a public method.  It's necessary because we want
    get_param() and friends to return the unquoted parameter value,
    however we want the quote-preserved form for set_boundary().

get_params(), get_param(), set_boundary(): Implement in terms of
    _get_params_preserve().

walk(): Yield ourself first, then recurse over our subparts (if any).

__init__(): Arguments major renamed to maintype and minor renamed to
    subtype for consistency with the rest of the package.

Updated docstrings.  Also,

typed_subpart_iterator(): Arguments major renamed to maintype and
    minor renamed to subtype for consistency with the rest of the
    package.

Image.py and class Image => MIMEImage.py and MIMEImage

Text.py and class Text => MIMEText.py and MIMEText

MessageRFC822.py and class MessageRFC822 => MIMEMessage.py and MIMEMessage

These are renamed so as to be more consistent; these are MIME specific
derived classes for when creating the object model out of whole cloth.