enabling doctests that Sphinx can run, and fixing and disabling tests that
Sphinx can't run.  I hand checked every test not now marked as a doctest,
and all except the two that have open bug reports against them now work,
at least on Linux/trunk. (I did not look at the last example at all since
there was already an open bug).  I did not read the whole document with
an editor's eye, but I did fix a few things I noticed while working on
the tests.

string is already in normalized form, by performing a quick check beforehand.
Original patch by Rauli Ruohonen.

at once could hit the recursion limit if the mimetypes database hadn't been
initialized before.

Issue #5793: rationalize isdigit / isalpha / tolower, etc. Will port to py3k. Should fix Windows buildbot errors.

works when an exception gets to the interactive prompt, and update the
examples after testing.  The last one is now a valid Sphinx doctest,
but of the preceding two one can't be made a doctest and the other one
I'm postponing to 3.x because sphinx handles doctests as Unicode strings
and that makes the 2.x output confusing.

should clutter the docs as possible.  Part 1: stuff that gets merged to Py3k.

Issue #5854: Updated __all__ to include some missing names and remove some names which should not be exported.

in path.  Bug 5559.

(Internal plumbing changes for float parsing.)

titlecase, but not their own uppercase.

If anyone wants to clean up the documentation, feel free. It's my first documentation foray, and it's not that great.

Will port to py3k with a different strategy.