This matches the usage by BufferedReader, BufferedWriter, etc. Also document
and test that the write() methods should only access their argument before
they return.

Previous fix was only made to dead and removed code.

Patch by Susumu Koshiba.

- the top-level 2.7 docs page now links to the newer doc pages
  (installing and distribution) rather than the legacy ones
- the legacy install and distutils pages are now labeled as "legacy"
- the library/distutils page is updated to match the 3.x version
- "See also" links to the new docs are now provided in the legacy pages
- links to setuptools documentation have been updated

(original patch by Susan Sun)

Original patch by Xiang Zhang.

Original patch by Jelle Zijlstra.

Patch by ingrid, Gregory Loyse and Jelle Zijlstra.

Patch by Xavier de Gaye.

[backport to 2.7] - issue8519 - Reference termios and ioctl manual pages in the library documentation.

that support os.fork.

take a rediculious amount of time to run, fail or provide little use
to the profile feedback.  (similar to what is already done in 3.5 and
by major Linux distro builds own profiling runs)

enable link time optimizations at build time during a make profile-opt.
Some compilers and toolchains are known to not produce stable code when
using LTO, be sure to test things thoroughly before relying on it.
It can provide a few % speed up over profile-opt alone.

verification and patch by Emily Morehouse.

I wonder why I keep forgetting 2.7 :P

Patch by Bryce Verdier.