Merge 3.4: ignore change specific to 3.4 for #21488, I had a different patch for Python 3.5

Issue #21488: Fix doc of codecs.decode() and codecs.encode(), no keyword support.
Patch written by Brad Aylsworth.

Merge: #21347: use string not list in shell=True example.

#21347: use string not list in shell=True example.

Patch by Akira.

merge

Issue #21470: Do a better job seeding the random number generator
to fully cover its state space.

Merge from 3.4 (for #21499).

Issue #21499: Ignore __builtins__ in several test_importlib.test_api tests.

Merge 3.4->default: Fix test-order-dependend asyncio test failure caused by rev 2af5a52b9b87 (in this branch).

Fix test-order-dependend asyncio test failure caused by rev 909ea8cc86bbab92dbb6231668f403b7360f30fa.

Merge from 3.4:
- Issue #17756: Fix test_code test when run from the installed location.

- Issue #17756: Fix test_code test when run from the installed location.

Issue #19775: Add a samefile() method to pathlib Path objects.

Initial patch by Vajrasky Kok.

Issue 21469:  Minor code modernization (convert and/or expression to an if/else expression).

Suggested by: Tal Einat

merge

Issue 21469:  Add missing news item

merge

Issue 21469:  Mitigate risk of false positives with robotparser.

* Repair the broken link to norobots-rfc.txt.

* HTTP response codes >= 500 treated as a failed read rather than as a not
found.  Not found means that we can assume the entire site is allowed.  A 5xx
server error tells us nothing.

* A successful read() or parse() updates the mtime (which is defined to be "the
  time the robots.txt file was last fetched").

* The can_fetch() method returns False unless we've had a read() with a 2xx or
4xx response.  This avoids false positives in the case where a user calls
can_fetch() before calling read().

* I don't see any easy way to test this patch without hitting internet
resources that might change or without use of mock objects that wouldn't
provide must reassurance.

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