Sync typing.py with upstream.

(Upstream is https://github.com/python/typing)

- Add TYPE_CHECKING (false at runtime, true in type checkers) (upstream #230).
- Avoid error on Union[xml.etree.cElementTree.Element, str] (upstream #229).
- Repr of Tuple[()] should be 'Tuple[()]' (upstream #231).
- Add NewType() (upstream #189).

asyncio: Remove line about asyncio.timeout() from the NEWS file

asyncio: Remove asyncio.timeout() context manager.

It will probably be added back in Python 3.6, once its compatibility
issues are resolved; see [1] for more details.

[1] https://mail.python.org/pipermail/async-sig/2016-June/000045.html

asyncio: Update whatsnew/3.5.2

Issue #27136: Update asyncio docs

Issue #27136: Fix DNS static resolution; don't use it in getaddrinfo

Patch by A. Jesse Jiryu Davis

Issue #23275: Backport target list assignment documentation fixes

Issue #21593: Clarify that re.search() returns the first match

Issue #25738: Don’t send message body for 205 Reset Content

Patch by Susumu Koshiba.

Issue #21313: Tolerate truncated buildinfo in sys.version

Fixed #27251: corrected string/bytes handling in credentials.

Items for NEWS and idlelib/NEWS.txt.

os.urandom() doesn't block on Linux anymore

Issue #26839: On Linux, os.urandom() now calls getrandom() with GRND_NONBLOCK
to fall back on reading /dev/urandom if the urandom entropy pool is not
initialized yet. Patch written by Colm Buckley.

Issue #27229: Comment in middle of shell command fails on BSD and OS X

Issue #27229: Fix in-tree cross-build rule, by Xavier de Gaye

Issue #26014: Update 3.x packaging documentation:
- "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)

Issue #27164: Allow decompressing raw Deflate streams with predefined zdict

Based on patch by Xiang Zhang.

Issue #27225: Fixed a reference leak in type_new when setting __new__ fails.
Patch by Xiang Zhang.

Issue #21916: Added more tests for the turtle module.
Original patch by Jelle Zijlstra.

Issue #24291: Avoid WSGIRequestHandler doing partial writes

If the underlying send() method indicates a partial write, such as when the
call is interrupted to handle a signal, the server would silently drop the
remaining data.

Also add deprecated support for SimpleHandler.stdout.write() doing partial
writes.

issue27202 - Fix the mistake in changesets 70af472451cb (3.5) and 2bb806539ca6 (3.6)

exclude_patterns in Sphinx conf.py will exclude the .rsts from the build. It
was incorrect exclude 2.x rsts in that.  This fix contributed again Jelle
Zijlstra, excludes doctests in whatsnew/2.7.rst from being exercised by using
doctests skip option.

Issue #17888: Add a note about contributing to Python docs

Patch by Terry Chia and Laura Rupprecht.

issue27202 - Exclude 2.x release notes from python3 make doctests.

Patch contributed by Jelle Zijlstra.

Issue27203 - Fix doctests Doc/faq/programming.rst.

Patch contributed by Jelle Zijlstra.

Move the BrokenPipeError tests to the POSIXProcessTestCase class
instead of the generic ProcessTestCase class as they are posix
specific.

Issue #26930: Update OS X 32-bit-only installer builds to use OpenSSL 1.0.2h.

- Issue #26884: Fix linking extension modules for cross builds.
  Patch by Xavier de Gaye.

Merge heads

Issue #21916: Added tests for the turtle module.
Patch by ingrid, Gregory Loyse and Jelle Zijlstra.

Issue #24759: Add 'private' notice for idlelib.idle_test.

Revise and synchronize idle_test.test_configdialog.

Issue #26809: Add __all__ to string module.  Patch by Emanuel Barry

issue26372 - use os.devnull instead of /dev/null

Issue #20041: Fixed TypeError when frame.f_trace is set to None.
Patch by Xavier de Gaye.

Issue #19234: Documents socket.fileno() returns -1 on failure

Issue 27216: Fix typo (noticed by Alex Chan).

Clarify deprecation of ElementTree.XMLParser(html=...) parameter

IDLE test README: 'gui' to 'GUI', except in "'gui'" and '-ugui'.

merge heads

fix indentation of comment

Fix typos in code comment and documentation

Issue #27196: Stop 'application destroyed' warnings when running IDLE tests.
The update_idletasks solution was provided by Serhiy Storchaka.

Issue 20567: Revise idle_test/README.txt and some tests to match new advice.

Fixes Issue #26373: subprocess.Popen.communicate now correctly ignores
BrokenPipeError when the child process dies before .communicate()
is called in more (all?) circumstances.

#16484: Fix pydoc doc links to modules whose names are mixed case.

Patch by Sean Rodman, test by Kaushik N.

final step in backout of bad default->3.5 merge d085b4f779af. merge 3.5 heads

first step in backout of bad default->3.5 merge d085b4f779af.  Create new head and fix whitespace.

Merge: #22797: clarify when URLErrors are raised by urlopen.

#22797: clarify when URLErrors are raised by urlopen.

Null merge

Merge heads

Merge heads

Merge 3.5.

Merge heads

Issue #27185: Rename test_string_merged.py back to test_string.py.

Issue #27185: Merge test_pep292.py into test_string_merged.py.

Issue #27185: Rename test_pep292.py to test_string_merged.py.

Issue #27185: Rename test_string.py to test_string_merged.py.

[merge from 3.5] - issue27113 - Document "check_same_thread" parameter in sqlite3.connect api.

Patch contributed by Dave Sawyer.

issue27113 - Document "check_same_thread" parameter in sqlite3.connect api.

Patch contributed by Dave Sawyer.

[merge from 3.5] - issue8519 - Reference termios and ioctl manual pages in the library documentation.

issue8519 - Reference termios and ioctl manual pages in the library documentation.

issue27167: make the test not care about the exact signal name in the
error message as some numbers map to multiple names.

Issue #27167: Clarify the subprocess.CalledProcessError error message text
when the child process died due to a signal.

issue25931: document that socketserver.Forking* are unavailable on platforms
lacking os.fork().

Issue25931: fix tests broken by the conditional define of socketserver.Forking*

typo fix

merge 3.5

Document that CalledProcessError.returncode is the negative
signal number when the process died due to a signal.

Reindent properly.

Issue #25931: Don't defining socketserver.Forking* names on platforms such
as Windows that do not support os.fork().

Merge: #26829: Clarify that namespace is copied to a new __dict__ in instance creation.

#26829: Clarify that namespace is copied to a new __dict__ in instance creation.

Patch by Emily Morehouse.

Merge: #27185: move test_pep292 into test_string.

#27185: move test_pep292 into test_string.

This makes the Template tests discoverable.  Patch by Erin Braswell.

Issue #16192: Merge from 3.5

Issue #16192: Fix copy and paste mistake noticed by Eryk Sun

issue27186 -- initial docs, tests, and python version of os.fspath

Merge 3.5 (asyncio)

asyncio: Fix getaddrinfo to accept service names (for port)

Patch by A. Jesse Jiryu Davis

Merge 3.5  (asyncio)

Issue #21776: Merge from 3.5

Issue #21776: distutils.upload now correctly handles HTTPError

Initial patch by Claudiu Popa.

asyncio: Support host=b'' for getaddrinfo

Merge: #20973: add total ordering tests for ipaddress

#20973: add total ordering tests for ipaddress

Patch by Tommy Beadle.

merge 3.5

remove (hilarious) defaults for various constants getpath.c needs

Merge: #13784: fix xml.sax.reader getColumn/LineNumber docs.

Issue #16192: Merge from 3.5

Issue #16192: Clarify when c_int is an alias to c_long in ctypes documentation

#13784: fix xml.sax.reader getColumn/LineNumber docs.

verification and patch by Emily Morehouse.

merge 3.5

note that Py_VISIT handles NULL (closes #27183)

Issue #23116: Improve ask_ok() example in the Python tutorial

replace custom validation logic in the parse module with a simple DFA validator (closes #26526)

Patch from A. Skrobov.

Issue #23116: Merge from 3.5

Issue #21271: Adds new keyword only parameters in reset_mock call

We now have two keyword only parameters in the reset_mock function to
selectively reset the return_value or the side_effects, or both.

Issue #27171: Fix typo in exception message

Issue #27171: Merge typo fixes from 3.5