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.

Fixed issue number for issue #22470 in Misc/NEWS.

Merge heads

Issue #22518: Fixed integer overflow issues in "backslashreplace",
"xmlcharrefreplace", and "surrogatepass" error handlers.

Realign packaging docs with PyPUG changes

Issue #22219: The zipfile module CLI now adds entries for directories
(including empty directories) in ZIP file.

#14056: Small improvements to the tarfile documentation.

Patch by Éric Araujo with help from Lars Gustäbel.

separate cert loading tests into Windows and non-Windows cases

also use openssl envvars to find certs on windows (closes #22449)

Patch by Christian Heimes and Alex Gaynor.

Fix a few typo/grammar issues in the multiprocessing docs.

Reported by Scott Hinton on docs@.

#12780: update inspect test skipIf for PEP 3147.

The test needs to be skipped if unicodedata is either part of the
main binary (a repackaging of cpython on Windows?) or has python
source (pypy?).  PEP 3147 makes __file__ point to the .py source,
so we need to change the extension check from looking for the
old .pyc/.pyo to just looking for .py.

Note that this skip should never trigger on CPython itself, so
one could argue it should be dropped instead.  But since it exists,
why risk breaking someone else's python.

#8473: Add tests that doctest uses universal newlines in testfile.

Python3 does not have the bug covered by the issue.

Closes #18729: minor markup improvement.

Closes #19434: fix copy-paste error in MIMENonMultipart docstring.

Issue #20079: Fixed tests.

Issue #20079: Updated alias mapping to glibc 2.19 SUPPORTED file.

Issue #20076: Remove just added the sr_rs.utf8@latn alias because it is
derived from sr_rs@latin.

closes #22528: add source links to symtable and compileall

Closes #19342: improve docstrings in grp module.

Remove unused and now removed config value.

Issue #21971: Index and update turtledemo doc.

- Issue #17219: Add library build dir for Python extension cross-builds.

- Issue #18096: Fix library order returned by python-config.

Issue #20076: Added non derived UTF-8 aliases to locale aliases table.

Issue #20079: Added locales supported in glibc 2.18 to locale alias table.

Issue 22492: Be explicit that print does not support binary mode files.
Original patch by Georg Brandl.

Remove old overridden version of a Sphinx CSS file.

All Python-specific styling is now in the theme anyway.

Make pydoctheme compatible with Sphinx 1.3 HTML output changes.

Update Idle news for 3.4.2 (and 3.4.1).

Issue #16537: Use the new *default* parameter of max().

Fix overlooked conf.py setting in flattening of Doc directory.

#21739: mention subtle difference between loops and listcomps in tutorial.

We don't want to go into a full explanation of scopes at this point in the
tutorial, so we just mention that the loop creates or overwrites a persistent
variable while the listcomp doesn't.  Not mentioning this would lead someone
to incorrectly assume loops and listcomps were *completely* equivalent, which
would confuse them later.

Original patch by Rose Ames, tweaked to remove the word 'scope'.

#22512: move distutils rpm test's .rpmdb to testing tmpdir.

Patch by Francis MB.

Issue 22465: grammar, number agreement.

Move Doc/tools/sphinxext content to Doc/tools, there is no need for the nested subdirectory anymore.

Dont define an empty SPHINXOPTS, which overrides a definition from the environment.

Prepare sphinx extensions for 1.3.

add link to pdb source (closes #22528)

Issue #22448: asyncio, cleanup _run_once(), only iterate once to remove delayed
calls that were cancelled.

faulthandler: test_gil_released() now uses _sigsegv() instead of _read_null(),
because _read_null() cannot be used on AIX. On AIX, reading from NULL is
allowed: the first page of memory is a mapped read-only on AIX.