Add documentation about as_string() mangling From_ lines.

as_string(): Indicate that this mangles From_ lines.

Big email 3.0 API changes, with updated unit tests and documentation.
Briefly (from the NEWS file):

- Updates for the email package:
  + All deprecated APIs that in email 2.x issued warnings have been removed:
    _encoder argument to the MIMEText constructor, Message.add_payload(),
    Utils.dump_address_pair(), Utils.decode(), Utils.encode()
  + New deprecations: Generator.__call__(), Message.get_type(),
    Message.get_main_type(), Message.get_subtype(), the 'strict' argument to
    the Parser constructor.  These will be removed in email 3.1.
  + Support for Python earlier than 2.3 has been removed (see PEP 291).
  + All defect classes have been renamed to end in 'Defect'.
  + Some FeedParser fixes; also a MultipartInvariantViolationDefect will be
    added to messages that claim to be multipart but really aren't.
  + Updates to documentation.

removed 2.2 support

use new readPlist() and writePlist() functions

Upon insertion, if memory runs out, the deque was left in a corrupted state.

deque_item(): a performance bug: the linked list of blocks was followed
from the left in most cases, because the test (i < (deque->len >> 1)) was
after "i %= BLOCKLEN".

deque_clear(): replaced a call to deque_len() with deque->len; not sure what
this call was here for, nor if all compilers under the sun would inline it.

deque_traverse(): I belive that it could be called by the GC when the deque
has leftblock==rightblock==NULL, because it is tracked before the first block
is allocated (though closely before).  Still, a C extension module subclassing
deque could provide its own tp_alloc that could trigger a GC collection after
the PyObject_GC_Track()...

deque_richcompare(): rewrote to cleanly check for end-of-iterations instead of
relying on deque.__iter__().next() to succeed exactly len(deque) times -- an
assumption which can break if deques are subclassed.  Added a test.

I wonder if the length should be explicitely bounded to INT_MAX, with
OverflowErrors, as in listobject.c.  On 64-bit machines, adding more than
INT_MAX in the deque will result in trouble.  (Note to anyone/me fixing
this: carefully check for overflows if len is close to INT_MAX in the
following functions: deque_rotate(), deque_item(), deque_ass_item())

SF bug#1038917 fix typos (Contributed by George Yoshida.)

Replace structure member before decreffing.

Which reminds me, I've had a much improved plistlib.py lying around for
ages. The main improvements are:
- a much more convenient API: readPlist() and writePlist()
- support non-dict top-level objects

* Bulletproof the method for detecting mutations during iteration.
  The previous approach was too easily fooled (a rotate() sufficed).

* Use it->counter to determine when iteration is complete.  The
  previous approach was too complex.

* Strengthen an assertion and add a comment here or there.

Restore the block length and add a comment.

Clarify the relationship between indices.

* Elaborate on the invariant comments and make them more precise.

* Change the centering by one to make it possible to test the module
  with BLOCKLEN's as low as two.  Testing small blocks makes end-point
  errors surface more readily.

Noted the fix to deque gc.

deque_traverse():  If the deque had one block, and its rightindex was
BLOCKLEN-1, this assert-failed in a debug build, or went wild with a
NULL pointer in a release build.  Reported on c.l.py by Stefan Behnel.

Typos in new comments.

Document some reverse-engineered invariants and pragmatic hints.

Get references working (except for references to "Extending optparse",
which isn't being converted from reST yet).

Definition consistency.

Trimmed trailing whitespace.

Add tests for syntax errors.

Added 2 notes about the complexities of testing SyntaxErrors.

Expand scope to include general mapping protocol tests.
Many of these tests are redundant, but this will ensure
that the mapping protocols all stay in sync.
Also, added a test for dictionary subclasses.

Add missing test_dict.py from patch #736962.

Improve test coverage.

SF bug #1035279:  hex() and oct() documentation is incorrect

* Updated docs to reflected signed return values.
* Fixed a doubled word typo.

Improve error message for augmented assignments to genexps or listcomps.
Rather than introduce new logic, took the approach of making the message
itself more general.

Fix two erroneous error messages.

Fix typo in PyDict_Items doc

Improve test coverage.

Improve test coverage.

minor doc tweaks for writexml

typo

Replaced a test with an assertion.
(Suggested by Michael Hudson.)

A number of list examples used 66.6, but I doubt there's any box on which
repr(66.6) == "66.6", so doubt that the claimed output has ever been seen.
Changed it to 66.25 everywhere, and manually verified that the new claimed
output is correct.

Reverted the addition of a NORMALIZE_NUMBERS option, per Tim Peter's
request.  Tim says that "correct 'fuzzy' comparison of floats cannot
be automated."  (The motivation behind adding the new option
was verifying interactive examples in Python's latex documentation;
several such examples use numbers that don't print consistently on
different platforms.)

* Increase test coverage.
* Have groupby() be careful about decreffing structure members.

Added a new NORMALIZE_NUMBERS option, which causes number literals in
the expected output to match corresponding number literals in the
actual output if their values are equal (to ten digits of precision).

Add note about inclusion of DarwinPorts directories in setup.py on darwin.

Add the directories where DarwinPorts installs library and include files to
the proper path directories for compiling extension modules.

Fixed minor typo in interactive example (extra '.'s in '...' prompts)

Fixed minor typo in interactive example (extra blank line)

SF bug #1033038:  Misleading error message in random.choice

Added a clarifying line to the docs.

Fixed minor typo in interactive example

Fixed minor typo in interactive example (backslash shouldn't be doubled)

Updated interactive examples in the "Examples" session to reflect the
fact that compiler.ast.Function now takes a "decorators" argument.

Silence a compiler warning by supplying the correct argument type to
the htons() function.

Use Py_CLEAR().  Add unrelated test.

Major overhaul to reflect Optik 1.5.  Section references currently broken.

Plug a leak and beef-up test coverage.

Rename test for comparision errors.

Beef-up tests for greater coverage and refcount checking.

Patch #1009075, bug #952953: allow execve with empty 2nd argument

Patch #1011240: SystemError generated by struct.pack('P', 'foo').

Trivial bug fix:  deque == []  is not a good way to check if a deque is empty.

Use floor division operator.

Use floor division operator.

- Added a "parser" option to testfile() and DocFileTest().

- Added a "parser" option to testfile() and DocFileTest().

- Fixed typo in multi-line exception example
- Fixed indentation for a verbatim block

Give a saner example for script_from_examples(); also mention an intended
but not entirely obvious use case.

Made most module references "clickable".

Docs for run_docstring_examples().

Checkin Tim's fix to an error discussed on python-dev.
Also, add a testcase.

Formerly, the list_extend() code used several local variables to remember
its state across iterations.  Since an iteration could call arbitrary
Python code, it was possible for the list state to be changed.  The new
code uses dynamic structure references instead of C locals.  So, they
are always up-to-date.

After list_resize() is called, its size has been updated but the new
cells are filled with NULLs.  These needed to be filled before arbitrary
iteration code was called; otherwise, that code could attempt to modify
a list that was in a semi-invalid state.  The solution was to change
the ob->size field back to a value reflecting the actual number of valid
cells.

Make the regex pattern easier to read, understand, and modify
by factoring out the common prefix (the delimiter).

Replace -soname with -h for Solaris compatibility. Fixes #1034496.
Backported to 2.3.

Updated doctest doc news.

Added a lot of new stuff to the debugging section.

Removed debug_script from the public API:  no docs, not public.  I'm in
the process of writing docs for the other "missing" debug support
functions.

register_optionflag():  Moved from the Debugging section to the section
on option flags; added a versionadded decoration.

Document set_unittest_reportflags().

Add set_unittest_reportflags() to the public API.  Docs will follow
"soon", after I repair the LaTeX I somehow damaged.

Removed two undocumented unittest support classes, and one undocumented
unittest support function, from the public interface.  If they're not
documented, they shouldn't be public.

Fix double word error.

Assorted minor changes, plus a lot more soap.

Explain the motivation for the unittest functions, and beef up the
example.  Squash repeated argument descriptions.  Minor rewordings.

Removed most of the module docstring.  There's too much to explain now,
and the LaTeX docs are in increasingly good shape.

Repaired mistakes in the descriptions of testmod()/testfile(), and
squashed massive duplication of common argument descriptions.

Add warning notation about using 'bomb' setting.

Remove 'extern' declaration for _Py_SwappedOp.

Since the doctest warnings section was reduced to one bullet point,
get rid of the itemize structure.

In the "doctest warnings" section, removed obsolete info, and noted that
ELLIPSIS can be used to deal with examples that embed object addresses.

Raymond observed that sometimes it's better not to link modules, so I reverted
part of my previous last changes.

Beef up the section on testfile(), giving a complete example in
reStructuredText format.  Remove words describing the return value of
testmod() and testfile() in the intro sections, since it's never
useful in such simple cases.

Typo.

Since the LaTeX isn't doctest'ed, examples are always wrong <wink>.

- Use itemize instead of plain-text '*' for marking up a list.
- Add more ulink's to modules (this should probably become a standard macro).

Whitespace normalization.

Port test_unpack to doctest (patch #736962).

Add yet more tests for buffer().

Ensure negative offsets cannot be passed to buffer().  When composing
buffers, compute the new buffer size based on the old buffer size.
Fixes SF bug #1034242.

Fix buffer offset calculation (need to compute it before changing
'base').  Fixes SF bug #1033720.  Move offset sanity checking to
buffer_from_memory().

Add a few more tests for the buffer() object.

Added log() function documentation

Added log() function

Added exception handling during handler initialization in fileConfig()

Whitespace normalization.

Add docstrings for regular expression objects and methods.

Granted Noam Raphael's request for minor improvements to the re module and
its documentation.

* Documented that the compiled re methods are supposed to be more full
  featured than their simpilified function counterparts.

* Documented the existing start and stop position arguments for the
  findall() and finditer() methods of compiled regular expression objects.

* Added an optional flags argument to the re.findall() and re.finditer()
  functions.  This aligns their API with that for re.search() and
  re.match().

Update for beta1