- 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

random.sample() uses one of two algorithms depending on the ratio of the
sample size to the population size.  One of the algorithms accepted any
iterable population argument so long as it defined __len__().  The other
had a stronger requirement that the population argument be indexable.

While it met the documentation specifications which insisted that the
population argument be a sequence, it made random.sample() less usable
with sets.  So, the second algorithm was modified to coerce non-indexable
iterables and dictionaries into a tuple before proceeding.

for PDF generation