Add support for the iterator and mapping protocols.
For Py2.3, this was done for shelve, dumbdbm and other mapping objects, but
not for bsddb and dbhash which were inadvertently missed.

- removed use of the string module
- fixed some broken markup

- update a couple of URLs to point to more recent portions of
  python.org

little better, with similar spacing characteristics with the seealso
environment

(Contributed by George Yoshida.)

- cleaned up some markup

its first three arguments.

Closes RFE #798046 .

module

The documentation severely departed for the actual implementation.

1. Remove "idle" script, it lives in Tools/scripts/ now.
2. Remove shebang from idle.py, should be called explicitly.
3. Remove obsolete test code from rpc.py; needs unit test.

Will backport to 2.2.

Classical problem with int vs. long mismatch in varargs.
2.3 backport candidate.

file_truncate():  C doesn't define what fflush(fp) does if fp is open
for update, and the preceding I/O operation on fp was input.  On Windows,
fflush() actually changes the current file position then.  Because
Windows doesn't support ftruncate() directly, this not only caused
Python's file.truncate() to change the file position (contra our docs),
it also caused the file not to change size.

Repaired by getting the initial file position at the start, restoring
it at the end, and tossing all the complicated micro-efficiency checks
trying to avoid "provably unnecessary" seeks.  file.truncate() can't
be a frequent operation, and seeking to the current file position has
got to be cheap anyway.

Bugfix candidate.

spacing correct in the output.

will backport.

- correct section level error (module references are always \section)
- many markup revisions, including some minor rewordings