Issue #20387: Merge test and patch from 3.4.4

Issue #20387: Merge

Issue #24456: Fixed possible buffer over-read in adpcm2lin() and lin2adpcm()
functions of the audioop module.

Issue #24456: Fixed possible buffer over-read in adpcm2lin() and lin2adpcm()
functions of the audioop module.

Issue #20387: Merge patch and test

Issue #24336: The contextmanager decorator now works with functions with
keyword arguments called "func" and "self".  Patch by Martin Panter.

Issue #24336: The contextmanager decorator now works with functions with
keyword arguments called "func" and "self".  Patch by Martin Panter.

upgrade to Unicode 8.0.0

prevent integer overflow in escape_unicode (closes #24522)

merge 3.4

merge 3.3

add issue number

merge 3.4

merge 3.3

use safe allocation and reallocation macros

Issue #20387: Update Misc/NEWS

Issue #23684: Clarify the return value of the scheme attribute of ParseResult and SplitResult objects.

Patch by Martin Panter.

Issue #23684: Clarify the return value of the scheme attribute of ParseResult and SplitResult objects.

Patch by Martin Panter.

Merge 3.4 (issue #24509)

Issue #24509: Clarify Handle.cancel() and loop.call_* methods.

Merge 3.4

asyncio.docs: Use less confusing title

Issue #24439: Update tulip_coro.dia

Issue #24400, #24325: More tests for types._GeneratorWrapper

Also, make 'wrapped' and 'isgen' private.

Issue #24325, #24400: Add more unittests for types.coroutine; tweak wrapper implementation.

Issue #24439: Improve PEP 492 related docs.

Patch by Martin Panter.

Issue #24495, #24400: Test asyncio.Task.repr in debug mode

Fix asyncio unittests in debug mode

Fix asyncio unittests in debug mode

Issue #24400: Fix CoroWrapper for 'async def' coroutines

Issue #24400: Fix CoroWrapper for 'async def' coroutines

Merge 3.4

asyncio: Merge changes from issue #24400.

Closes #24244: Removes invalid test from test_time

docs.whatsnew: Update ref to tp_as_async

docs.capi: Fix tp_as_async doc

Issue #24489: ensure a previously set C errno doesn't disturb cmath.polar().

Issue #24489: ensure a previously set C errno doesn't disturb cmath.polar().

Issue #24400: Introduce a distinct type for 'async def' coroutines.

Summary of changes:

1. Coroutines now have a distinct, separate from generators
   type at the C level: PyGen_Type, and a new typedef PyCoroObject.
   PyCoroObject shares the initial segment of struct layout with
   PyGenObject, making it possible to reuse existing generators
   machinery.  The new type is exposed as 'types.CoroutineType'.

   As a consequence of having a new type, CO_GENERATOR flag is
   no longer applied to coroutines.

2. Having a separate type for coroutines made it possible to add
   an __await__ method to the type.  Although it is not used by the
   interpreter (see details on that below), it makes coroutines
   naturally (without using __instancecheck__) conform to
   collections.abc.Coroutine and collections.abc.Awaitable ABCs.

   [The __instancecheck__ is still used for generator-based
   coroutines, as we don't want to add __await__ for generators.]

3. Add new opcode: GET_YIELD_FROM_ITER.  The opcode is needed to
   allow passing native coroutines to the YIELD_FROM opcode.

   Before this change, 'yield from o' expression was compiled to:

      (o)
      GET_ITER
      LOAD_CONST
      YIELD_FROM

   Now, we use GET_YIELD_FROM_ITER instead of GET_ITER.

   The reason for adding a new opcode is that GET_ITER is used
   in some contexts (such as 'for .. in' loops) where passing
   a coroutine object is invalid.

4. Add two new introspection functions to the inspec module:
   getcoroutinestate(c) and getcoroutinelocals(c).

5. inspect.iscoroutine(o) is updated to test if 'o' is a native
   coroutine object.  Before this commit it used abc.Coroutine,
   and it was requested to update inspect.isgenerator(o) to use
   abc.Generator; it was decided, however, that inspect functions
   should really be tailored for checking for native types.

6. sys.set_coroutine_wrapper(w) API is updated to work with only
   native coroutines.  Since types.coroutine decorator supports
   any type of callables now, it would be confusing that it does
   not work for all types of coroutines.

7. Exceptions logic in generators C implementation was updated
   to raise clearer messages for coroutines:

   Before: TypeError("generator raised StopIteration")
   After: TypeError("coroutine raised StopIteration")

Issue #20387: Restore retention of indentation during untokenize.

Issue #20387: Correct test to properly capture expectation.

Fixed documentation of functions with const char* arguments.

Fixed documentation of functions with const char* arguments.

Added the const qualifier for char* argument of Py_EnterRecursiveCall().

Added the const qualifier for char* argument of Py_EnterRecursiveCall().

Issue #24436: Added const qualifiers for char* arguments of _PyTraceback_Add.
Patch by Michael Ensslin.

Issue #24436: Added const qualifiers for char* arguments of _PyTraceback_Add.
Patch by Michael Ensslin.

Issue #24408: Fixed test for tkinter.Font on OS X.
Based on patch by Martin Panter.

Issue #24408: Fixed test for tkinter.Font on OS X.
Based on patch by Martin Panter.

Issue #20387: Add test capturing failure to roundtrip indented code in tokenize module.

Remove unused import and remove doctest-only import into doctests.

Issue 24476: Statically links vcruntime140.dll and removes it from the installer

Merge 3.4

Merge 3.4's PCbuild/readme.txt update.

All the new information in 3.4's readme.txt was already here, but the
wrong name was used to refer to the script.  Also reworded the sentence.

Update PCbuild/readme.txt

It now recommends PCbuild/get_externals.bat instead of the scripts in
Tools/buildbot.

Deprecate unused scripts in Tools/buildbot.

I would just outright delete them, but the readme in PCbuild recommended
their use, so I figure it would be nice to leave them there for a while.

Issue #8232: Renamed WinFireFox to WinFirefox

null merge 3.4 to 3.5 (9a0c5ffe7420 merged 3.4 to default, bypassing 3.5)

Back porting changeset db302b88fdb6 to 3.4 branch, which fixed multiple documentation typos.

Related Issues:

#issue21528
#issue24453

merge

Issue #24453:  Fix doubled word.

Issue #24435: Use the devguide link instead of PEP 306 in Grammar/Grammar.

Issue #24435: Use the devguide link instead of PEP 306 in Grammar/Grammar.

Merge with 3.4

whitespace

Merge 3.4

Issue #24406: Add sentences on dict comparisons, similar to those for Sequence
and set comparisions.  Patch by Gareth Rees.

(Merge 3.4) Issue #15745: Rewrite os.utime() tests in test_os

* Don't use the timestamp of an existing file anymore, only use fixed
  timestamp
* Enhance the code checking the resolution of the filesystem timestamps.
* Check timestamps with a resolution of 1 microsecond instead of 1 millisecond
* When os.utime() uses the current system clock, tolerate a delta of 20 ms.
  Before some os.utime() tolerated a different of 10 seconds.
* Merge duplicated tests and simplify the code

Issue #15745: Rewrite os.utime() tests in test_os

* Don't use the timestamp of an existing file anymore, only use fixed
  timestamp
* Enhance the code checking the resolution of the filesystem timestamps.
* Check timestamps with a resolution of 1 microsecond instead of 1 millisecond
* When os.utime() uses the current system clock, tolerate a delta of 20 ms.
  Before some os.utime() tolerated a different of 10 seconds.
* Merge duplicated tests and simplify the code

Merge with 3.4

Closes issue #24405: mark set display as code.

Issue #24423: Fix formatting error in 3.5 whatsnew

Fixed indentation of Python examples in C comments.

Fixed indentation of Python examples in C comments.

Merge forward extras beyond #21907 backport.

Clean up/refactor the batch scripts used for building on Windows.

This is mostly a backport of issue #21907, but also includes a few
extras necessary to make the bulidbot scripts as thin as possible.

- Issue #24351: Clarify what is meant by "identifier" in the context of
  string.Template instances.

- Issue #24351: Clarify what is meant by "identifier" in the context of
  string.Template instances.

Merge from 3.4

#23891: correctly refer to PyPI as "Python Package Index"

Issue #24408: Added more tkinter.Font tests.

Issue #24408: Added more tkinter.Font tests.

Merge from 3.4

#23891: remove extra words

Merge from 3.4

#23891: add a section to the Tutorial describing virtual environments and pip

Merge from 3.4

Issue 24385: Adds "--as-flags=--32" when generating 32-bit MinGW library.

Issue #24299: Fixed test__locale on Solaris.

Issue #24299: Fixed test__locale on Solaris.

Issue #24408: Fixed AttributeError in measure() and metrics() methods of
tkinter.Font.

Issue #14373: Other attempt to fix threaded test for lru_cache().

Issue #14373: C implementation of functools.lru_cache() now can be used with
methods.

Issue #14373: Fixed threaded test for lru_cache(). Added new threaded test.

Issue #8232: webbrowser support incomplete on Windows. Patch by Brandon Milam

added matmul and imatmul to operator.__all__

Add link to pyvideoorg

repair my irrational excuberance

remove unnecessary braces and indentation

#23891: rework discussion of python-list a bit