I reviewed the documentation and tested the examples with Python 3.

I found many parts which are changed or irrelevant.
Here is the patch.

Updated patch with suggestions of Ezio.

Thanks, committed in r76886, r76887.

Commit r76886 on Python 2.7 is fine.

But the patch is not merged completly on branches/py3k.

I prepared a new patch against py3k to fix what is missing.

I saw two small things:
- dict.has_key is still used instead of `in`
- Pyrex is mentioned, but not Cython (http://www.cython.org/); Cython is
probably much more active than Pyrex, though.

> I saw two small things:
> - dict.has_key is still used instead of `in`

Florent pointed to me that it's not true. I was watching a stale
version, sorry.

Thanks, applied in r76923.

For future patches, please use notes sparingly, and warnings even more
so.  Not every sentences starting with "Note that..." needs to be a
Note.  Also, Notes should contain whole sentences (i.e. the first word
is uppercased).