Merge doc change from 3.3

Merge doc change from 3.3

Update docs to reflect resurrection of Setuptools over Distribute

Merge from 3.4 (for #21226).

(Merge 3.4) Issue #21398: Fix an unicode error in the pydoc pager when the
documentation contains characters not encodable to the stdout encoding.

Issue #21398: Fix an unicode error in the pydoc pager when the documentation
contains characters not encodable to the stdout encoding.

Issue #21226: Set all attrs in PyImport_ExecCodeModuleObject.

(Merge 3.4) Issue #21418: Fix a crash in the builtin function super() when
called without argument and without current frame (ex: embedded Python).

Issue #21418: Fix a crash in the builtin function super() when called without
argument and without current frame (ex: embedded Python).

(Merge 3.4) Issue #21485: remove unnecesary .flush() calls in the asyncio
subprocess code example

Issue #21485: remove unnecesary .flush() calls in the asyncio subprocess code
example

(Merge 3.4) Issue #21422: Add a test to check that bool << int and bool >> int
return an int

Issue #21422: Add a test to check that bool << int and bool >> int return an int

Issue #16531: ipaddress.IPv4Network and ipaddress.IPv6Network now accept an (address, netmask) tuple argument, so as to easily construct network objects from existing addresses.

Merge 3.4->default: asyncio: Fix upstream issue 168: StreamReader.read(-1) from pipe may hang if data exceeds buffer limit.

asyncio: Fix upstream issue 168: StreamReader.read(-1) from pipe may hang if data exceeds buffer limit.

Issue 21383: merge from 3.4

Issue #21383: Allow "make touch" to work when building outside of the
source directory.

Issue #18104: News for 3.4, in proper place.

#18104: null merge of 3.4 News entry

Issue #18104: News for 3.4 (which will not merge forward).

Merge with 3.4

whitespace

Merge with 3.4

Issue #18104: Add idlelib/idle_test/htest.py with a few sample tests to begin
consolidating and improving human-validated tests of Idle. Change other files
as needed to work with htest.  Running the module as __main__ runs all tests.

merge 3.4

use logical rather than bit and

Issue 21424:  Apply the nlargest() optimizations to nsmallest() as well.

merge from 3.4 - clean up the subprocess docs warning-soup and
s/Unix/POSIX/.

Change all references to Unix to POSIX in the subprocess docs.  It's
more accurate and sounds less like a strange tale of yore.

Remove the warning-soup from the subprocess documentation by adding
a Security Considerations section as preferred by both the devguide
and documentation users who do not wish to go insane.

merge 3.4

remove confusing delete indexing (closes #21466)

Null merge

Try to fix issue #21425 workaround for shared library builds

Try to fix issue #21425 workaround for shared library builds

Fix printing out error message when test fails and run with -bb

Fix printing out error message when test fails and run with -bb

Null merge

Remove debugging output

Try workaround for test issues in #21425

Try workaround for test issues in #21425

Fix debugging output to work with -W

Fix debugging output to work with -bb

Add debugging output for #21425

Issue #21425: Fix flushing of standard streams in the interactive interpreter.

Issue #21425: Fix flushing of standard streams in the interactive interpreter.

By popular demand, add back a security warning.

Issue #21424:  Optimize heaqp.nlargest() to make fewer tuple comparisons.

Consolidates the logic for nlargest() into a single function so that
decoration tuples (elem,order) or (key, order, elem) only need to
be formed when a new element is added to the heap.  Formerly, a tuple
was created for every element regardless of whether it was added to
the heap.

The change reduces the number of tuples created, the number of ordering
integers created, and total number of tuple comparisons.

Merge 3.4 -> default: asyncio: Upstream issue #167: remove dead code, by Marc Schlaich.

asyncio: Upstream issue #167: remove dead code, by Marc Schlaich.

Remove the redundant and poorly worded warning message.

The paragraph above already says, clearly and correctly, that
"However, being completely deterministic, it is not suitable for
all purposes, and is completely unsuitable for cryptographic purposes."

Also we should make any promises about SystemRandom or os.urandom()
being cryptographically secure (they may be, but be can't validate
that promise).  Further, those are actual random number generators
not psuedo-random number generators.

Reindent long line

Replace overly-aggressive comparison for type equality with an isinstance check.

Drop support for Python 2.4 in upload command.

Replace import * with explicit import

Clean up style in distutils upload command

Issue #19655: Add tests for the new asdl parser.

This unit test runs only for source builds of Python, similarly to test_tools.

Issue #19655: Replace the ASDL parser carried with CPython

The new parser does not rely on Spark (which is now removed from our repo),
uses modern 3.x idioms and is significantly smaller and simpler.

It generates exactly the same AST files (.h and .c), so in practice no builds
should be affected.

Issue #19721: Consolidate test_importlib utility code into a single
module.

Issue #20776: Flesh out tests for importlib.machinery.PathFinder.

Issue21452 Add missing backslash to build path for make_buildinfo

Merge

Issue21452 Add missing backslash to build path for make_buildinfo

Issue10752 Be more robust when finding a PERL interpreter to build OpenSSL. Initial patch by Gabi Davar

Issue10752 Be more robust when finding a PERL interpreter to build OpenSSL. Initial patch by Gabi Davar

Issue #21156: importlib.abc.InspectLoader.source_to_code() is now a
staticmethod.

Merge for issue #21438

Issue #21438: Document what loaders don't require a module name for
load_module().

Merge for issue #21157

Issue #21157: Touch up imp docs to be more explicit about importlib
alternatives.

Issue #21141: The Windows build process no longer attempts to find Perl,
instead relying on OpenSSL source being configured and ready to build.  The
``PCbuild\build_ssl.py`` script has been re-written and re-named to
``PCbuild\prepare_ssl.py``, and takes care of configuring OpenSSL source
for both 32 and 64 bit platforms.  OpenSSL sources obtained from
svn.python.org will always be pre-configured and ready to build.

Merge from 3.4.

Issue #21435: Segfault in gc with cyclic trash
Changed the iteration logic in finalize_garbage() to tolerate objects vanishing
from the list as a side effect of executing a finalizer.

Issue #21435: Segfault in gc with cyclic trash
Changed the iteration logic in finalize_garbage() to tolerate objects vanishing
from the list as a side effect of executing a finalizer.

Issue #21396: Fix TextIOWrapper(..., write_through=True) to not force a flush() on the underlying binary stream.

Patch by akira.

Issue #21396: Fix TextIOWrapper(..., write_through=True) to not force a flush() on the underlying binary stream.

Patch by akira.

Issue #21037: Add a build option to enable AddressSanitizer support.

Merge #21300: fix typo

#21300: fix typo

Merge with 3.4

Merging from 3.3: The PyCOND_TIMEDWAIT must use microseconds for the timeout argument
in order to have the same resolution as pthreads condition variables.
At the same time, it must be large enough to accept 31 bits of
milliseconds, which is the maximum timeout value in the windows API.
A PY_LONG_LONG of microseconds fullfills both requirements.
This closes issue #20737

The PyCOND_TIMEDWAIT must use microseconds for the timeout argument
in order to have the same resolution as pthreads condition variables.
At the same time, it must be large enough to accept 31 bits of
milliseconds, which is the maximum timeout value in the windows API.
A PY_LONG_LONG of microseconds fullfills both requirements.
This closes issue #20737

The PyCOND_TIMEDWAIT must use microseconds for the timeout argument
in order to have the same resolution as pthreads condition variables.
At the same time, it must be large enough to accept 31 bits of
milliseconds, which is the maximum timeout value in the windows API.
A PY_LONG_LONG of microseconds fullfills both requirements.
This closes issue #20737

Issue19643 Fix whitespace

Issue19643 Add an example of shutil.rmtree which shows how to cope with readonly files on Windows

- Issue #17752: Fix distutils tests when run from the installed location.

- Issue #17752: Fix distutils tests when run from the installed location.

- Issue #17752: Fix distutils tests when run from the installed location.

Merge: #21300: Clean up the docs for the email "policy" arguments.

#21300: Clean up the docs for the email "policy" arguments.

Merge 3.4->default: asyncio: Fix the second half of issue #21447: race in _write_to_self().

asyncio: Fix the second half of issue #21447: race in _write_to_self().

Issue #21442: Fix MSVC compiler warning introduced by issue21377.

Merge with 3.4

Add prompts to interactive example.

This makes it match the new example below, and allows Sphinx's
"hide the prompts and output" feature to work.

Issue #21366: Document the fact that ``return`` in a ``finally`` clause
overrides a ``return`` in the ``try`` suite.

Issue #21366: Document the fact that ``return`` in a ``finally`` clause
overrides a ``return`` in the ``try`` suite.

Issue21393 Use CryptReleaseContext to release Crypt handle on Windows

Issue21440 Use support.rmtree in test_zipfile & test_tarfile

Issue #21233: Fix _PyObject_Alloc() when compiled with WITH_VALGRIND defined