Partly responds to SF bug #505152.

on how a system is configured.
This closes SF bug #497160 (which has the patch) and #460613.

Bugfix candidate.

Clarify that os.waitpid() on Windows takes a process handle, not a process ID.
This closes SF bug #537582.

This closes SF bug #537511.

types for each code, and give the actual C types.

Clarified the support for slice operations and note when some TypeError
exceptions are raised.

This closes SF bugs 518767 and 536469.

the manual refer to it.

XXX Not sure that it belongs in this section, or that the concept is
particularly important for writing documentation.  Perhaps references
to the frame should be removed entirely.

free variable and is subject to those rules.

function is enforced.

    Names bound by import statements may not occur in global
    statements in the same scope.

Why not?

Note that deleteing an unbound local will raise a NameError.

How do I create a cross reference to section 4.1?

Replace section 4.1 with section A.3.

The new section 4.1 is titled "Naming and binding."  It includes the
text of section A.3 augmented with some of the detailed text from the
old section 4.1.

The \dfn, \index stuff is probably wrong, but I tried.

Also update other parts of appendix A to mention that nested scopes
and generators are standard features.

Add an item

possible pool states.  I think it's much clearer now.

Added a new long overdue block-management overview comment block.

I believe the comments are in good shape now.

Added two comments about possible small optimizations (one getting rid
of runtime multiplications at the cost of a new pool_header member; the
other getting rid of runtime divisions and the pool_header capacity
member, at the cost of a static const vector of 32 uints).

Fix two typos spotted by Joonas Paalasmaa

Split the description of co_flags into two paragraphs.  The first
describes the flags that are used for non-future purposes, where
CO_GENERATOR was added.  The second describes __future__'s use of
co_flags and mentions the only one currently meaningful,
CO_FUTURE_DIVISION.

func_closure is a readonly attribute.
Add \ttindex{} for func_closure.
Remove discussion of func_closure specific to 2.1.

directly.

Convert to use PyModule_*() instead of manipulating the module dict directly.

This displays stats about the # of arenas, pools, blocks and bytes, to
stderr, both used and reserved but unused.

CAUTION:  Because PYMALLOC_DEBUG is on, the debug malloc routine adds
16 bytes to each request.  This makes each block appear two size classes
higher than it would be if PYMALLOC_DEBUG weren't on.

So far, playing with this confirms the obvious:  there's a lot of activity
in the "small dict" size class, but nothing in the core makes any use of
the 8-byte or 16-byte classes.

directly.

Fix floating point exception if mpz.powm(10, 1, 0) (modulus == 0).
Add a test.

I left the email pkg alone; I'm not sure how Barry would like to handle
that.

Add test for file.readinto().