merge 2.7.7 release branch

include test data in the windows installer, so tests don't fail (closes #19866)

Don't grow strings by concatenation.  Use ''.join() instead.

Added tag v2.7.7rc1 for changeset e32e3a9f3902

bump to 2.7.7rc1

update pydoc_topics

'sunos' not 'solaris

just skip this test on Solaris

some platforms apparently don't care about fdopen'ing with a different mode

support pep 3118 format strings for ctypes objects with nontrivial shapes (closes #10744)

Patch from Matti Picus.

reindent for consistency

Document changes to OS X installer configurations for 2.7.7.
As of 2.7.8, the 32-bit-only installer will support OS X 10.5
and later systems as is currently done for Python 3.x installers.

For 2.7.7 only, we will provide three installers:
the legacy deprecated 10.3+ 32-bit-only format;
the newer 10.5+ 32-bit-only format;
and the unchanged 10.6+ 64-/32-bit format.

Although binary installers will no longer be available from
python.org as of 2.7.8, it will still be possible to build from
source on 10.3.9 and 10.4 systems if necessary.

Backport Fix for Issue #7776: Fix ``Host:'' header and reconnection when using http.client.HTTPConnection.set_tunnel().

Patch by Nikolaus Rath.

Issue #18104: revise docstrings, remove obsolete comments.

Issue #21488: Oops, the patch for codecs.encode/decode doc was written by
Berker Peksag (already present in Misc/ACKS). The issue was reported by Brad
Aylsworth.

Issue #21488: Fix doc of codecs.decode() and codecs.encode(), no keyword support.
Patch written by Brad Aylsworth.

#21347: use string not list in shell=True example.

Patch by Akira.

Issue #21470: Do a better job seeding the random number generator
to fully cover its state space.

Issue 21469:  Mitigate risk of false positives with robotparser.

* Repair the broken link to norobots-rfc.txt.

* HTTP response codes >= 500 treated as a failed read rather than as a not
found.  Not found means that we can assume the entire site is allowed.  A 5xx
server error tells us nothing.

* A successful read() or parse() updates the mtime (which is defined to be "the
  time the robots.txt file was last fetched").

* The can_fetch() method returns False unless we've had a read() with a 2xx or
4xx response.  This avoids false positives in the case where a user calls
can_fetch() before calling read().

* I don't see any easy way to test this patch without hitting internet
resources that might change or without use of mock objects that wouldn't
provide must reassurance.

whitespace

Issue #18104: Add idlelib/idle_test/htest.py with a few sample tests to begin
consolidating and improving human-validated tests of Idle. Change other files
as needed to work with htest.  Running the module as __main__ runs all tests.

use logical rather than bit and

this file now has utf-8 chars

cast away warnings

backport hmac.compare_digest to partially implement PEP 466 (closes #21306)

Backport from Alex Gaynor.

remove confusing delete indexing (closes #21466)

Issue #21476 Include idle icon files in Windows installer

Backport 4e9f1017355f from #3561.

This brings the option to install Python on the Windows Path.
Committed per Benjamin Peterson's approval on python-dev.

Issue #21350: Fix file.writelines() to accept arbitrary buffer objects, as advertised.
Patch by Brian Kearns.

 - Issue #17752: Fix distutils tests when run from the installed location.

Add prompts to interactive example.

This makes it match the new example below, and allows Sphinx's
"hide the prompts and output" feature to work.

Issue #21366: Document the fact that ``return`` in a ``finally`` clause
overrides a ``return`` in the ``try`` suite.

Issue 21375:  Fix possible Py_ssizet overflow in heapq.

Issue #18604: Consolidated checks for GUI availability.

test_support._is_gui_available is now defined the same way on every
platform, and now includes the Windows-specific check that had been in the
Windows version of _is_gui_available and the OSX-specific check that was
in runtktests.check_tk_availability.  Also, every platform checks whether
Tk can be instantiated (if the platform-specific checks passed).

Issue #19630 Emphasise that the file parameter to marshal.dump must be a real file object

Issue #21321: itertools.islice() now releases the reference to the source iterator when the slice is exhausted.

Patch by Anton Afanasyev.

Closes #21055: Index (augmented) assignment symbols.

Closes 21048: Index 'as' in import and with statements.

Closes #21026: Augment site doc based on experiments. Patch by Carol Willing.

#21225: copy docstrings from base classes

Issue #9291 Add ACKS & NEWS

Issue #9291 Do not attempt to re-encode mimetype data read from registry in ANSI mode. Initial patches by Dmitry Jemerov & Vladimir Iofik

#18243: Remove obsolete cautionary note from email mktime_tz docs.

Issue #17145:  Document array.array buffer interface limitations.

Issue #18944: backport typo fix

Add NEWS entry for issue21349

Issue21349 Passing a memoryview to _winreg.SetValueEx now correctly raises a TypeError where it previously crashed the interpreter. Patch by Brian Kearns

Issue #20434 Correct error handlin of _PyString_Resize and _PyBytes_Resize

Issue #21346: Fix typos in test_itertools.  Patch by Brian Kearns.

fix off-by-one error (closes #21330)

Issue #21303, #20565: Updated the version of Tcl/Tk used on Windows
from 8.5.2 to 8.5.15.

Issue #21138: Change default reformat paragraph width to PEP 8's 72.

Issue 21284: Idle: make test_formatparagraph pass even when a user changes the
reformat width in the configuration menu.

Issue #21311: Avoid exception in _osx_support with non-standard compiler
configurations.  Patch by John Szakmeister.

- Issue #21285: Refactor and fix curses configure check to always search
  in a ncursesw directory.

#18628: clarify index entry for source file encoding declaration.

#18566: Whitespace

Issue #18566: Clarify unittest setUp, tearDown doc. Patch by Nitika Agarwal.

Issue #21245: updated documentation on exception() method and function.

#1704474: mark refleak test as specific to CPython

Patch by Christian Hudon.

#15840: make docs consistent by saying operations on closed files raise ValueError.

Patch by Caelyn McAulay.

Neither Caelyn nor I could find any cases in 2.7 or 3.4/5 where an
operation on a closed stream raised IOError; generally the C
implementation have a macro to check for the stream being closed, and
these macros all raised ValueError.  If we find any, a new bug should
be opened.

whitespace chaps my hide

Some cleanup of the subprocess docs in 2.7.  Adds a reference to the
subprocess32 project in PyPI for posix users.

add missing NULL check

when an exception is raised in fdopen, never close the fd (changing on my mind on #21191)

Backed out changeset 81abb121dc65

temporary change to get better debugging from windows bots

Closes #20956: 2.7 tokenize does not produce named tuples. Patch by Sam Kimbrel.

do not generate pipe names in the temporary dir

disallow a negative idx parameter

Issue #20624: Merge exception docs tweak from 3.4 branch.

Issue #12546: Allow \x00 as a fill character for builtin type __format__ methods.

in scan_once, prevent the reading of arbitrary memory when passed a negative index

Bug reported by Guido Vranken.

Remove references to the obsolete Mac Carbon modules in the GUI
section of the FAQ.

Issue #21170: Removed invalid parameter names from unittest doc.
Patch by Kushal Das.

Issue #21172: isinstance check relaxed from dict to collections.Mapping.

teach 2to3 about 'yield from'

add matrix multiplication operator support to 2to3

Issue #21187: Fix OS X installer fail-to-build with Xcode 5.1.

Issue #20644: Keep build-installer.py in sync across active versions.

make sure fdopen always closes the fd in error cases (closes #21191)

issue #21190: Fix the docs README link

Issue #21179: Fix description of 'round' function for numbers.Real.

use imperative

PySequence_Fast generally returns a list (#16305)

PySequence_Fast generally returns a list not a tuple (closes #16395)

the name of the slot of nb_multiply not nb_mul

fix verb (closes #21174)

minor docfix (reported at docs@python.org) trace.py argument is --count not --counts

use with statement

explicitly close file object (#21128)

properly explicitly close file (#21128)

make temporary read-only files writable, so rmtree can remove them (#21128)

note that the hash of an arbitrary object is only derived from its address (closes #21154)

Patch from Armin Rigo.

Issue #21149: Improved thread-safety in logging cleanup during interpreter shutdown.

properly close files in test_zipfile (#20887)

Patch by Matti Picus.

make sure to test UnicodeEncodeError, too

bail in unicode error's __str__ methods if the objects are not properly initialized (closes #21134)

Issue 21125: minor wording tweak.

Issue #15067: Remove reference to a rejected PEP.

Further explanation of the concept stands alone without this reference,
no need to potentially confuse people by bringing up a feature that
doesn't exist.