Issue #22072: Fix a couple of SSL doc typos.  Patch by Alex Gaynor.

Merge.

Issue #19875: Fix random test_getsockaddrarg() failure.

asyncio, test_subprocess: relax timings for slow builbots

asyncio: sync with Tulip

* Fix _WaitHandleFuture.cancel(): return the result of the parent cancel()
  method.
* _OverlappedFuture.cancel() now clears its reference to the overlapped object.
  Make also the _OverlappedFuture.ov attribute private.
* Check if _WaitHandleFuture completed before unregistering it in the callback.
  Add also _WaitHandleFuture._poll() and repr(_WaitHandleFuture).
* _WaitHandleFuture now unregisters its wait handler if WaitForSingleObject()
  raises an exception.
* _OverlappedFuture.set_exception() now cancels the overlapped operation.

Issue #22061: Add deprecation warnings in empty obsolete methods.

Issue #22061: remove call of useless function slated for removal.

Issue #22053: Make help work, after previous patch for this issue disabled it
by removing global 'demo'. Refactor and remove duplicate code.

asyncio: sync with Tulip

Improve stability of the proactor event loop, especially operations on
overlapped objects:

* Tulip issue 195: Don't call UnregisterWait() twice if a _WaitHandleFuture is
  cancelled twice to fix a crash.
* IocpProactor.close(): cancel futures to cancel overlapped operations, instead
  of cancelling directly overlapped operations. Future objects may not call
  ov.cancel() if the future was cancelled or if the overlapped was already
  cancelled. The cancel() method of the future may also catch exceptions. Log
  also errors on cancellation.
* tests: rename "f" to "fut"
* Add a __repr__() method to IocpProactor
* Add a destructor to IocpProactor which closes it
* _OverlappedFuture.cancel() doesn't cancel the overlapped anymore if it is
  done: if it is already cancelled or completed. Log also an error if the
  cancellation failed.
* Add the address of the overlapped object in repr(_OverlappedFuture)
* _OverlappedFuture truncates the source traceback to hide the call to the
  parent constructor (useless in debug).

Issue #19884, readline: calling rl_variable_bind ("enable-meta-key", "off")
does crash on Mac OS X which uses libedit instead of readline.

Issue #16133: The asynchat.async_chat.handle_read() method now ignores
BlockingIOError exceptions. Initial patch written by Xavier de Gaye.

Document also in asyncore documentation that recv() may raise BlockingIOError.

Backport os.rst documentation from Python 3.5.

Issue #21813: Enhance documentation of the os.stat_result class.

Issue #19884: readline: Disable the meta modifier key if stdout is not a
terminal to not write the ANSI sequence "\033[1034h" into stdout. This sequence
is used on some terminal (ex: TERM=xterm-256color") to enable support of 8 bit
characters.

test_gettext: use support.rmtree() instead of shutil.rmtree()

asyncio tests: relax timings for slow buildbots

Issue #20055: Fix BaseEventLoop.stop() docstring, incomplete sentence.
Patch written by Saimadhav Heblikar.

Fix incomplete sentence in asyncio docs.

Asyncio doc fixes: spelling, grammar, duplication.

Englich grammar nit.

s/stringobject/bytesobject/ (closes #22036)

Patch by Martin Matusiak.

Fix doc example bug reported on python-list by Akshay Verma.

Issue #22053: Cleanup turtledemo start and stop and fix debug shutdown warning.

Issue #19493: Fix two uses of ctypes.test.requires (it's not a decorator)
and skip test_win32.FunctionCallTestCase.test_SEH when Python was compiled
in debug configuration or by a non-MSC compiler.

Merge heads

Issue #6167: Backported tests for Scrollbar.activate() and Scrollbar.set()
from 6ae34a948cb4.

Issue #21597: Turtledemo text pane can now be widened to view or copy complete
lines or narrowed for small screens.
Issie #19132: Turtledemo buttons no longer disappear when window is shrun.
Patch mostly by Lita Cho (21597) using idea from patch by Jan Kanis (18132).

Issue #22002: Make full use of test discovery in test sub-packages.

Adds `load_package_tests` function to test.support, uses it in test_asyncio,
test_email, test_json, test_tools, test_importlib and all test_importlib
sub-packages to implement test discovery.

asyncio: sync with Tulip

* Tulip issue 194: Don't use sys.getrefcount() in unit tests
* signal.set_wakeup_fd() can now raise an OSError on Python 3.5

Issue #21888: plistlib's load() and loads() now work if the fmt parameter is
specified.

Correct issue #21044 patch author.

Fix grammar

Issue #21901: Cap the maximum number of file descriptors to use for the test.

asyncio, tulip issue 193: Convert StreamWriter.drain() to a classic coroutine

Replace also _make_drain_waiter() function with a classic _drain_helper()
coroutine.

Fixed bugs in reprs of CookieJar and multiprocessing.dummy.Value.

Merge heads

Issue #15759: "make suspicious", "make linkcheck" and "make doctest" in Doc/
now display special message when and only when there are failures.

Fix localhost checking in FileHandler. Raised in #21970.

Issue #21976: Fix test_ssl to accept LibreSSL version strings.
Thanks to William Orr.

Issue #19629: Add missing "import stat"

Sort also imports in support/__init__.py

Issue #19811, #22022: test_pathlib uses support.rmtree() instead of
shutil.rmtree() to remove the temporary directory.

Issue #19629: Fix support.rmtree(), use os.lstat() to check if the file is a
directory, not os.path.isdir()

asyncio: Fix test_stdin_broken_pipe(), drain() is not a coroutine

Issue #21868: Prevent turtle crash due to invalid undo buffer size.

add #

args doesn't need to be a tuple (closes #17210)

Issue #22006: Remove outdated _thread caveat.  Thanks Dan O'Reilly for the report.

Issue #22004: Correct an argument name.

Fix asyncio.__all__: export also unix_events and windows_events symbols

For example, on Windows, it was not possible to get ProactorEventLoop or
DefaultEventLoopPolicy using "from asyncio import *".

Issue #21247: Fix a race condition in test_send_signal() of asyncio

Add a basic synchronization mechanism to wait until the child process is ready
before sending it a signal.

Python issue #21645, Tulip issue 192: Rewrite signal handling

Since Python 3.3, the C signal handler writes the signal number into the wakeup
file descriptor and then schedules the Python call using Py_AddPendingCall().

asyncio uses the wakeup file descriptor to wake up the event loop, and relies
on Py_AddPendingCall() to schedule the final callback with call_soon().

If the C signal handler is called in a thread different than the thread of the
event loop, the loop is awaken but Py_AddPendingCall() was not called yet. In
this case, the event loop has nothing to do and go to sleep again.
Py_AddPendingCall() is called while the event loop is sleeping again and so the
final callback is not scheduled immediatly.

This patch changes how asyncio handles signals. Instead of relying on
Py_AddPendingCall() and the wakeup file descriptor, asyncio now only relies on
the wakeup file descriptor. asyncio reads signal numbers from the wakeup file
descriptor to call its signal handler.

asyncio: Fix test_stdin_broken_pipe(), drain() can also raise
ConnectionResetError

asyncio, tulip issue 190: Process.communicate() now ignores
ConnectionResetError too

asyncio, tulip issue 190: Process.communicate() must ignore BrokenPipeError

If you want to handle the BrokenPipeError, you can easily reimplement
communicate().

Add also a unit test to ensure that stdin.write() + stdin.drain() raises
BrokenPipeError.

Issue #21994: Fix SyntaxError in the SSLContext.check_hostname documentation.

Issue 21044: tarfile.open() now handles fileobj with an integer 'name'
attribute.  Based on patch by Martin Panter.

Fix a minor typo in the turtle docs.  Found by Brandon Passmore on docs@.

Issue #21918: Convert test_tools.py to a sub-package of test.

Remove Tools/scripts/pydocgui.pyw.

pydoc.gui was removed over 3 years ago (#10818), this script has been
utterly bereft of worth since then.

asyncio: test_as_completed(): disable "slow callback" warning

Issue #21163: Fix "destroy pending task" warning in test_wait_errors()

Issue #21163, asyncio: Ignore "destroy pending task" warnings for private tasks
in gather().

asyncio: test_selector_events: remove duplicate call to _on_handshake() method

The _SelectorSslTransport constructor already calls it.

Issue #21765: Add support for non-ascii identifiers to HyperParser

Issue #21982: Add minimal unittest for configDialog with 46% coverage.
Fix regression that this test would have caught.

asyncio tests: make quiet the logs of SSL handshake failures when running tests
in debug mode

asyncio: sync with Tulip

* Tulip issue #184: Log subprocess events in debug mode

  - Log stdin, stdout and stderr transports and protocols
  - Log process identifier (pid)
  - Log connection of pipes
  - Log process exit
  - Log Process.communicate() tasks: feed stdin, read stdout and stderr
  - Add __repr__() method to many classes related to subprocesses

* Add BaseSubprocessTransport._pid attribute. Store the pid so it is still
  accessible after the process exited. It's more convinient for debug.

* create_connection(): add the socket in the "connected to" debug log

* Clean up some docstrings and comments. Remove unused unimplemented
  _read_from_self().

Call PyErr_NoMemory() when PyMem_Malloc() fails.

Issue 21977:  Minor improvements to the regexes in the tokenizer example.

Issue #18592: Method return signature changes made to SearchDialogBase for
test purposes are now reflected in GrepDialog and ReplaceDialog.  Docstrings
are improved. Initial patch by Saimadhav Heblikar

Issue #21323: Fix http.server to again handle scripts in CGI subdirectories,
broken by the fix for security issue #19435.  Patch by Zach Byrne.

Issue #21323: Fix http.server to again handle scripts in CGI subdirectories,
broken by the fix for security issue #19435.  Patch by Zach Byrne.

Issue #21323: Fix http.server to again handle scripts in CGI subdirectories,
broken by the fix for security issue #19435.  Patch by Zach Byrne.

Issue #19076: Don't pass the redundant 'file' argument to self.error().

asyncio: Server.close() leaves client sockets open

asyncio: sync with Tulip

* Tulip issue #183: log socket events in debug mode

  - Log most important socket events: socket connected, new client, connection
    reset or closed by peer (EOF), etc.
  - Log time elapsed in DNS resolution (getaddrinfo)
  - Log pause/resume reading
  - Log time of SSL handshake
  - Log SSL handshake errors
  - Add a __repr__() method to many classes

* Fix ProactorEventLoop() in debug mode. ProactorEventLoop._make_self_pipe()
  doesn't call call_soon() directly because it checks for the current loop
  which fails, because the method is called to build the event loop.

* Cleanup _ProactorReadPipeTransport constructor. Not need to set again
  _read_fut attribute to None, it is already done in the base class.

asyncio: improve the documentation of servers

- Fix the documentation of Server.close(): it closes sockets
- Replace AbstractServer with Server
- Document Server.sockets attribute

asyncio, Tulip issue 180: Make Server attributes and methods private

- loop, waiters and active_count attributes are now private
- attach(), detach() and wakeup() methods are now private

The sockets attribute remains public.

Issue #21906: Make Tools/scripts/md5sum.py work in Python 3.

Patch by Zachary Ware.

asyncio: enhance documentation of platform support

asyncio: sync with Tulip

* Tulip issue #182: Improve logs of BaseEventLoop._run_once()

  - Don't log non-blocking poll
  - Only log polling with a timeout if it gets events or if it timed out after
    more than 1 second.

* Fix some pyflakes warnings: remove unused imports

Issue #18592: Make unittest for SearchDialogBase work on all tk versions.

Idle News entries.

#21940: Add unittest for WidgetRedirector. Initial patch by Saimadhav Heblikar.

asyncio: sync with Tulip

- CoroWrapper.__del__() now reuses repr(CoroWrapper) to log the "... was never
  yielded from" warning
- Improve CoroWrapper: copy also the qualified name on Python 3.4, not only on
  Python 3.5+

asyncio: sync with Tulip

- repr(Task) and repr(CoroWrapper) now also includes where these objects were
  created. If the coroutine is not a generator (don't use "yield from"), use
  the location of the function, not the location of the coro() wrapper.
- Fix create_task(): truncate the traceback to hide the call to create_task().

asyncio: sync with Tulip

- Issues #21936, #21163: Fix sporadic failures of
  test_future_exception_never_retrieved()
- Handle.cancel() now clears references to callback and args
- In debug mode, repr(Handle) now contains the location where the Handle was
  created.

Issue #21942: Fixed source file viewing in pydoc's server mode on Windows.

Issue #21940: add docstrings to idlelib.WidgetRedirector.

Issues #21948 and #16040: Fix typos.

asyncion, Tulip issue 181: BaseEventLoop.create_datagram_endpoint() now waits
until protocol.connection_made() has been called. Document also why transport
constructors use a waiter.

Issue #21680: Document asyncio event loops

Update asyncio documentation

- Document the new create_task() method
- "Hide" the Task class: point to the create_task() method for interoperability
- Rewrite the documentation of the Task class
- Document the "Pending task destroyed"
- Update output in debug mode of examples in the dev section
- Replace Task() with create_task() in examples

asyncio: sync with Tulip

- Tulip issue 185: Add a create_task() method to event loops. The create_task()
  method can be overriden in custom event loop to implement their own task
  class. For example, greenio and Pulsar projects use their own task class. The
  create_task() method is now preferred over creating directly task using the
  Task class.
- tests: fix a warning
- fix typo in the name of a test function
- Update AbstractEventLoop: add new event loop methods; update also the unit test

Issue #11259: asynchat.async_chat().set_terminator() now raises a ValueError if
the number of received bytes is negative.

asynchat: PEP8-ify the code

Issue #12523: asynchat.async_chat.push() now raises a TypeError if it doesn't
get a bytes string

Issue #21925: PyImport_Cleanup(): Remove unused parameter in
PySys_FormatStderr() call

Issue #21781, _ssl: Fix asn1obj2py() on Windows 64-bit, "s#" format requires
size to be a Py_ssize_t, not an int. _ssl.c is now "Py_ssize_t clean".

Issue #17846: Clarify note about Solution Folders.

Initial patch by Kathleen Weaver.