c_encoding can never be NULL, which allows some code simplification

Dummy merge with 3.5

Issue #26390: Merge pbkdf2_hmac() doc from 3.5

merge with 3.5

Closes #26435: fix syntax in directives. Thanks to Jakub Stasiak.

merge with 3.5

Fix rstlint to also look for indented comments that should be directives.

Issue #26402: Merge XML-RPC client fix from 3.5

Issue #26402: Fix XML-RPC client retrying after server disconnection

This is a regression introduced in 3.5 by revision eba80326ba53. Fix by Jelte
Fennema, test case by me.

Issue #25801: Fixed resource warnings in test_zipfile64.
Patch by SilentGhost.

Issue #25801: Fixed resource warnings in test_zipfile64.
Patch by SilentGhost.

Fix out-of-date comment

Issue #25136: merge from 3.5

Issue #25136: Add reference to 'xcode-select --install' to Mac README.

Change OS X installer builds targeted for 10.10 and above to build
and link with a private copy of OpenSSL, like installers targeted
for 10.5 already do, since Apple has deprecated use of the system
OpenSSL and removed its header files from the Xcode 7 SDK.  Note
that this configuration is not currently used to build any
python.org-supplied installers and that the private copy of
OpenSSL requires its own root certificates.

Change OS X installer builds targeted for 10.10 and above to build
and link with a private copy of OpenSSL, like installers targeted
for 10.5 already do, since Apple has deprecated use of the system
OpenSSL and removed its header files from the Xcode 7 SDK.  Note
that this configuration is not currently used to build any
python.org-supplied installers and that the private copy of
OpenSSL requires its own root certificates.

Issue #25136: merge from 3.5

Issue #25136: Support Apple Xcode 7's new textual SDK stub libraries.

As of Xcode 7, SDKs for Apple platforms now include textual-format stub
libraries whose file names have a .tbd extension rather than the
standard OS X .dylib extension.  The Apple compiler tool chain handles
these stub libraries transparently and the installed system shared libraries
are still .dylibs.  However, the new stub libraries cause problems for
third-party programs that support building with Apple SDKs and make
build-time decisions based on the presence or paths of system-supplied
shared libraries in the SDK.  In particular, building Python itself with
an SDK fails to find system-supplied libraries during setup.py's build of
standard library extension modules.  The solution is to have
find_library_file() in Distutils search for .tbd files, along with
the existing types (.a, .so, and .dylib).  Patch by Tim Smith.

Issue #26302: merge from 3.5

Null merge

Fixed a bug in os.walk() with bytes path on Windows caused by merging fixes
for issues #25995 and #25911.

Issue #25913: Leading <~ is optional now in base64.a85decode() with adobe=True.
Patch by Swati Jaiswal.

Issue #25913: Leading <~ is optional now in base64.a85decode() with adobe=True.
Patch by Swati Jaiswal.

Issue #5824: Merge socketserver tests from 3.5

Issue #5824: Fix DatagramRequestHandler tests by binding the client socket

Issue #22088: Merge base64 docs from 3.5

Issue #22088: Clarify base-64 alphabets and which characters are discarded

* There are only two base-64 alphabets defined by the RFCs, not three
* Due to the internal translation, plus (+) and slash (/) are never discarded
* standard_ and urlsafe_b64decode() discard characters as well

Also update the doc strings to clarify data types, based on revision
92760d2edc9e, correct the exception raised by b16decode(), and correct the
parameter name for the base-85 functions.

Issue #26406: merge from 3.5

Issue #26406: Avoid unnecessary serialization of getaddrinfo(3) calls on
current versions of OpenBSD and NetBSD.  Patch by A. Jesse Jiryu Davis.

merge with 3.5

Update example; str(float) changed so there is difference now.

Issue #26268: Merge with 3.5

Issue #26261: Merge NamedTemporaryFile docs from 3.5

Issue #26261: Clarify NamedTemporaryFile name attribute vs file.name

Issue #26268: Update Windows builds to use OpenSSL 1.0.2f

Issue #26268: Update the prepare_ssl.py script

It can now handle OpenSSL versions 1.0.2e and greater, which don't
include include files in include/.

Note that sources prepared by this script no longer support the old
project files for 2.7; you now have to have Perl available to use
the old build_ssl.py script with sources from svn.python.org.

Issue #26390: Fix and test pbkdf2_hmac() parameter names

Based on patch by Daan Bakker.

Merge XML-RPC client documentation from 3.5

Fix errors in XML-RPC client example code

* http.client.HTTP (does not exist in Python 3) → HTTPConnection
* Server (deprecated) → ServerProxy
* Transport.send_request() grew a new “debug” parameter in Python 3 (revision
  a528f7f8f97a)

Issue #26401: Fix compile() documentation

After 25032ec29315, compile() will raise a ValueError
if source contains null bytes.

Patch by SilentGhost.

Issue #26401: Fix compile() documentation

After 25032ec29315, compile() will raise a ValueError
if source contains null bytes.

Patch by SilentGhost.

Fix some typos in the NEWS file

Fix some typos in the NEWS file

Issue #23430: Stop socketserver from catching SystemExit etc from handlers

Also make handle_error() consistently output to stderr, and fix the
documentation.

Fix a name in an example

Issue #26397: Update an importlib example to use util.module_from_spec() instead of create_module()

Merge w/ 3.5

List what classes from importlib.machinery don't work with importlib.util.LazyLoader

Merge for issue #26186

Issue #26186: Remove an invalid type check in
importlib.util.LazyLoader.

The class was checking its argument as to whether its implementation
of create_module() came directly from importlib.abc.Loader. The
problem is that the classes coming from imoprtlib.machinery do not
directly inherit from the ABC as they come from _frozen_importlib.
Because the documentation has always said that create_module() was
ignored, the check has simply been removed.

Merge for issue #26367

Issue #26367: Have importlib.__init__() raise RuntimeError when
'level' is specified but no __package__.

This brings the function inline with builtins.__import__(). Thanks to
Manuel Jacob for the patch.

Merged cookbook update from 3.5.

Added simple threading example to logging cookbook.

Issue #22468: Merge gettarinfo() doc from 3.5

Issues #22468, #21996, #22208: Clarify gettarinfo() and TarInfo usage

* The Windows-specific binary notice was probably a Python 2 thing
* Make it more obvious gettarinfo() is based on stat(), and that non-ordinary
  files may need special care
* The file name must be text; suggest dummy arcname as a workaround
* Indicate TarInfo may be used directly, not just via gettarinfo()

merge with 3.5

Closes #20169: fix inner links random doc.

Issue #15608: Merge socketserver doc from 3.5

Issue #15608: Improve socketserver module documentation

* Add headings for each concrete and mix-in class and list methods and
  attributes under them
* Fix class and method cross references
* Changed RequestHandler to BaseRequestHandler and added class heading
* Pull out Stream/DatagramRequestHandler definitions
* Reordered the request handler setup(), handle(), finish() methods
* Document constructor parameters for the server classes
* Remove version 2.6 not relevant for Python 3 documentation

Issue #26309: Merge socketserver fix from 3.5

Issue #26309: Rewrite test in main thread and avoid race condition

Issue #16915: Clarify that mode parameter of socket.makefile() does not accept
the same values as open().

Issue #16915: Clarify that mode parameter of socket.makefile() does not accept
the same values as open().

Issue #26309: Merge socketserver fix from 3.5

Issue #26309: Shut down socketserver request if verify_request() is false

Patch by Aviv Palivoda.

merge 3.5 (#26378)

fix typo (closes #26378)

merge 3.5 (closes #25939)

merge 3.4 (closes #25939)

open the cert store readonly

Patch from Chi Hsuan Yen.

Issue #26368: fix typo in asynchio stream doc, reported by Ryan Stuart.

Issue #26368: fix typo in asynchio stream doc, reported by Ryan Stuart.

Minor clarification in tutorial.

Issue #25924: merge with 3.5

Issue #25924: Avoid unnecessary serialization of getaddrinfo(3) calls on OS X
versions 10.5 or higher.  Original patch by A. Jesse Jiryu Davis.

Issue #26268: merge from 3.5

Issue #26268: Update OS X 10.5+ installer build to use OpenSSL 1.0.2f.

The return type of a rich comparison is an int

Issue #26316: Merge Arg Clinic fix from 3.5

Issue #26316: Fix variable name typo in Argument Clinic

Merge 3.5 (issue #25887)

Issue #25887: Raise a RuntimeError when a coroutine is awaited more than once.

Fixes #26348: Merged fix from 3.5.

Fixes #26348: Corrected typos in activate.fish script.

Issue #25179: Documentation for formatted string literals aka f-strings

Some of the inspiration and wording is taken from the text of PEP 498 by Eric
V. Smith, and the existing str.format() documentation.

Issues #26289 and #26315: Optimize floor/modulo div for single-digit longs

Microbenchmarks show 2-2.5x improvement.  Built-in 'divmod' function
is now also ~10% faster.

-m timeit -s "x=22331" "x//2;x//-3;x//4;x//5;x//-6;x//7;x//8;x//-99;x//100;"
with patch: 0.321          without patch: 0.633

-m timeit -s "x=22331" "x%2;x%3;x%-4;x%5;x%6;x%-7;x%8;x%99;x%-100;"
with patch: 0.224          without patch: 0.66

Big thanks to Serhiy Storchaka, Mark Dickinson and Victor Stinner for
thorow code reviews and algorithms improvements.

Null merge

Issue #25995: os.walk() no longer uses FDs proportional to the tree depth.
Different solution from 3.5.

Issue #25995: os.walk() no longer uses FDs proportional to the tree depth.

Issue #25994: Added the close() method and the support of the context manager
protocol for the os.scandir() iterator.

Issue #26325: Added test.support.check_no_resource_warning() to check that
no ResourceWarning is emitted.

Issue #26325: Added test.support.check_no_resource_warning() to check that
no ResourceWarning is emitted.

Issue #25985: sys.version_info is now used instead of sys.version
to format short Python version.

Issue #26312: SystemError is now raised in all programming bugs with using
PyArg_ParseTupleAndKeywords().  RuntimeError did raised before in some
programming bugs.

Issue #23992: multiprocessing: make MapResult not fail-fast upon exception.

Null merge of typing.rst change

Hopefully clarify the difference between Optional[t] and an optional argument.

Hopefully clarify the difference between Optional[t] and an optional argument.

Issue #25698: Prevent possible replacing imported module with the empty one
if the stack is too deep.