asyncio doc: rewrite subprocess doc

* add a new example using transport and protocol
* rewrite the example using streams to make it much simpler (remove error
  handling, use a simpler Python code)
* copy (and adapt) more documentation from the subprocess module:

  - add a note about Process.wait() deadlock
  - add a note about shell injection
  - etc.

* sort Process methods and attributes in the same order than subprocess.Popen
  methods and attributes, so the documentation looks closer
* list differences between Process and subprocess.Popen APIs

asyncio doc: protocol_factory of subprocess_exec() and subprocess_shell() must
instanciate a subclass of SubprocessProtocol

asyncio doc: document BaseSubprocessTransport.close() method

Modify also the get_pipe_transport() doc to mention explicitly the supported
file descriptors.

Use https:// URLs for the bug tracker in the :issue: role.

Thanks to Ezio for noticing this

issue22626: Use https:// for a link to the bug tracker

merge heads

Issue #22435: Fix a file descriptor leak when SocketServer bind fails.

merge 3.3

note xmlrpclib doesn't verify certs (yet)

Issue #22614: Don't try to update deleted text.  Patch by Serhiy Storchaka.

asyncio: add missing @coroutine decorator

asyncio doc: update debug traces

asyncio doc: more explicit doc for async()

The function schedules the execution of coroutines, it's not just a wrapper for
something.

asyncio doc: reformat create_server() doc

Fix also the reate_unix_connection() doc: the method is not support on Windows,
not need to mention that ssl is not support with ProactorEventLoop.

asyncio doc: add TCP echo client/server using streams

#20815: small readability improvements in ipaddress tests.

Patch by Michel Albert.  We don't normally do patches that just tweak
whitespace, but ipaddress is relatively new and the package maintainers
approved the patch.

#13096: Fix segfault in CTypes POINTER handling of large values.

Patch by Meador Inge.

Always handle non-handled events before destoying root widget in tests.
This gets rid of  Tcl warnings when they are handled later when the root is
already destroyed.

#17325: Improve distutils PyPI documentation.

Patch by Chris Jerdonek.

#11973: add test for previously fixed kevent signed/unsigned bug.

Patch by David Naylor.

Closes #22586: clarify meaning of allow_fragments in urlparse.

asyncio doc: enhance TCP client example

asyncio doc: clarify how servers create protocol instances

asyncio doc: add UDP client and server examples

asyncio doc: use server.wait_closed() in TCP echo server example

asyncio: enhance protocol representation

Add "closed" or "closing" to repr() of selector and proactor transports

merge 3.3 into 3.4

Merge 3.2 into 3.3.

Added tag v3.3.6 for changeset 971fec30da1f

Bump to 3.3.6

Added tag v3.2.6 for changeset 0bd5f4f14de9

Bump to 3.2.6

#16040: fix unlimited read from connection in nntplib.

Closes #22568: fix UTIME_TO_* macros in posixmodule for rare cases.

Issue #14105: Change comment to reflect fix.  Patch by Saimadhav Heblikar.

Issue #22613: Fix reprlib.Repr subclass example on Python 3.

Reported by Jacques Ducasse.

Issue #21061: correctly note redirect_stdout is reentrant

asyncio doc: socket.socketpair() is not available on Windows yet

asyncio doc: add examples showing the 3 ways to wait for data from an open
socket

asyncio doc: cleanup Hello World examples

asyncio doc: the "Get HTTP headers" example now supports HTTPS

merge

Closes #18959: move optparse and imp to new "superseded modules" chapter

Closes #21687: delimiter in Py_SetPath is platform dependent

Closes #21675: fix ordering of description in library intro

Issue #22601: run_forever() now consumes BaseException of the temporary task

If the coroutine raised a BaseException, consume the exception to not log a
warning. The caller doesn't have access to the local task.

prevent passing NULL to memcpy (closes #22605)

Patch by Jakub Wilk.

Issue #21986: Idle now matches interpreter in not pickling user code objects.
Patch by Claudiu Popa

Issue #22604: Fix assertion error in debug mode when dividing a complex number by (nan+0j).

Issue #15414: Clean and correct the os.path.join docs.

In particular, correctly describe the behavior of ntpath.join.

Based on a patch by Dave Sawyer.

Issue 22603: add Francisco Fernández Castaño to ACKS.

Issue 22603: add missing 'self'.  Patch by Francisco Fernández Castaño.

Issue #11694: Raise ConversionError in xdrlib as documented

test_venv: use support.rmtree() instead of shutil.rmtree() to fix sporadic
failures on Windows

Issue #21456: Skip two tests in test_urllib2net.py if _ssl module not present.

Patch by Remi Pointel.

Issue #22564: ssl doc: mention asyncio in the non-blocking section

Issue #22564: ssl doc: mention how SSLSocket are usually created

Issue #22564: ssl doc: use "class" marker to document the SSLSocket class

Issue #22564: ssl doc: document read(), write(), pending, server_side and
server_hostname methods and attributes of SSLSocket.

Issue #22564: ssl doc: fix typos

Issue #20167: revise condition to accomodate message change.

#18176: Change generic UCD PropList link to version specific link.

De-'colour'ize stdlib except for idlelib.configDialog.
Tweak docstrigs and comments in affected functions in idlelib.configHandler.

#18176: fix another reference and add it to the makeunicodedata comment.

#18176: updated stdtypes UCD link, added reminder to makeunicodedata.

Patch by Alexander Belopolsky.

Issue #22588: Fix typo in _testcapi.test_incref_decref_API()

Issue #22568: Fix compilation of posixmodule.c with Open Watcom: rename "utime"
variable to "ut" to avoid conflict with the C utime() function. Patch written
by Jeffrey Armstrong.

Closes #22580: Fix documentation of PyUnicode_Tailmatch()

The result type is Py_ssize_t (and not int).

Issue 3068: Move idlelib.configDialog action button creation into a separate
method so it can be reused by the new extension dialog.

Issue #21715: Extracted shared complicated code in the _io module to new
_PyErr_ChainExceptions() function.

Issue #22462: Fix pyexpat's creation of a dummy frame to make it appear in exception tracebacks.

Initial patch by Mark Shannon.

Issue #22576: Fix signatures of FTP.storbinary() and FTP.storlines() methods.

The correct parameter name is "fp", not "file".

Merge from 3.4.2 release head back into 3.4 mainline.

Post-release changes after 3.4.2 final.

idlelib.configHandler: revise docstrings, add spaces, use False/True, add some
TODOs (mostly to do after add tests), and make a few other changes.

use source role instead of linking to svn

Closes #16155: fix a few errors in doctest output of the FAQ pages.

Closes #12148: clarify "or's together option flags" in doctest docs.

Closes #21782: the default hash(x) is not exactly id(x) but derived from it.

Closes #10031: overhaul the "imports" section of the programming FAQ.

Remove the advice to never use relative imports; it is a leftover from 2.x implicit relative imports.
Remove the advice to locally import modules in __init__, it is a strange practice.
Remove the advice to use "from ... import *" with some modules.

Closes #21480: better explanation of "hg touch" in the Makefile.

Clean up the docs of PyObject_IsSubclass and PyObject_IsInstance, and mention that they call the PEP 3119 methods.

Closes #22507: document that PyType_IsSubtype does not call __subclasscheck__.

Document builtin classes as such, not functions.

Closes #22565: fix argument types of PyErr_WarnEx.

Issue #22546: update doc for mini-language float None presentation type.

Added tag v3.4.2 for changeset ab2c023a9432

Release bump for 3.4.2 final.

Update pydoc topics and fix supsicious markup for 3.4.2 final.

PyObject not PyType (closes #18494)

Closes #21173: Fix len() on a WeakKeyDictionary when .clear() was called with an iterator alive.

cleanup test_posix

Issue #22390: Remove files created by tests

Issue #22290: Fix error handling in the _posixsubprocess module.

* Don't call the garbage collector with an exception set: it causes an
  assertion to fail in debug mode.
* Enhance also error handling if allocating an array for the executable list
  failed.
* Add an unit test for 4 different errors in the _posixsubprocess module.

Closes #19477: remove outdated documentation of tp_print type object slot.

#14201: Update ctypes docs to match behavior changed from 214b28d7a999.

Original patch by Erik Johansson, slightly updated by Meador Inge.

#11866: Eliminate race condition in the computation of names for new threads.

Original patch by Peter Saveliev.

Issue #21905: Avoid RuntimeError in pickle.whichmodule() when sys.modules is mutated while iterating.

Patch by Olivier Grisel.

Added tag v3.3.6rc1 for changeset 51317c9786f5

Added tag v3.2.6rc1 for changeset 51382a5598ec