Miscellaneous refactorings

* Add comment to the maxlen structure entry about the meaning of maxlen == -1
* Factor-out code common to deque_append(left) and deque_extend(left)
* Factor inner-loop in deque_clear() to use only 1 test per loop instead of 2
* Tighten inner-loops for deque_item() and deque_ass_item() so that the
  compiler can combine the decrement and test into a single step.

Issue #26146: marshal.loads() now uses the empty frozenset singleton

Cleanup test_dict

* Write one import per line
* Sort imports by name
* Add an empty line: 2 empty lines between code blocks at the module level (PEP 8)

test_gc: remove unused imports

Issue #18018: Raise an ImportError if a relative import is attempted
with no known parent package.

Previously SystemError was raised if the parent package didn't exist
(e.g., __package__ was set to '').
Thanks to Florent Xicluna and Yongzhi Pan for reporting the issue.

Issue #25234: Skip test_eintr.test_open() under OS X to avoid hanging

whitespace cleanup

Issue #25791: Warn when __package__ != __spec__.parent.

In a previous change, __spec__.parent was prioritized over
__package__. That is a backwards-compatibility break, but we do
eventually want __spec__ to be the ground truth for module details. So
this change reverts the change in semantics and instead raises an
ImportWarning when __package__ != __spec__.parent to give people time
to adjust to using spec objects.

Merge from 3.5

Fix a typo in a code example

Merge 3.5 (i18n doc, issue #25907)

doc: i18n HTML templates

Issue #25907: Use {% trans %} tags in HTML templates to ease the translation of
the documentation. The tag comes from Jinja templating system, used by Sphinx.

Patch written by Julien Palard.

Null merge 3.5 (change already applied to default)

Issue #25876: Fix also test_set() of test_gdb when -E command line is used

Issue #25876: test_gdb: use subprocess._args_from_interpreter_flags() to test
Python with more options.

Use Py_uintptr_t for atomic pointers

Issue #26161: Use Py_uintptr_t instead of void* for atomic pointers in
pyatomic.h. Use atomic_uintptr_t when <stdatomic.h> is used.

Using void* causes compilation warnings depending on which implementation of
atomic types is used.

code_richcompare() now uses the constants types

Issue #25843: When compiling code, don't merge constants if they are equal but
have a different types. For example, "f1, f2 = lambda: 1, lambda: 1.0" is now
correctly compiled to two different functions: f1() returns 1 (int) and f2()
returns 1.0 (int), even if 1 and 1.0 are equal.

Add a new _PyCode_ConstantKey() private function.

code_richcompare() now uses the constants types

Issue #25843: When compiling code, don't merge constants if they are equal but
have a different types. For example, "f1, f2 = lambda: 1, lambda: 1.0" is now
correctly compiled to two different functions: f1() returns 1 (int) and f2()
returns 1.0 (int), even if 1 and 1.0 are equal.

Add a new _PyCode_ConstantKey() private function.

site: error on sitecustomize import error

Issue #26099: The site module now writes an error into stderr if sitecustomize
module can be imported but executing the module raise an ImportError. Same
change for usercustomize.

merge 3.5

merge 3.4

reject negative data_size

merge from 3.5

minor clarification on Zipfile 'x' mode - exclusive creation of a file.

(Based on the feedback from docs@python.org list)

minor clarification on Zipfile 'x' mode - exclusive creation of a file.

Merge update to pip

Merge update to pip

Upgrade pip to 8.0.2

Issue #18620: Improve Pool examples in multiprocessing documentation

A single call to Pool.apply_async() will create only one process. To use all
of the pool's processes, it should be invoked multiple times:

    with Pool(processes=4) as pool:
        results = [pool.apply_async(func, ()) for i in range(4)]

Patch by Davin Potts.

Issue #18620: Improve Pool examples in multiprocessing documentation

A single call to Pool.apply_async() will create only one process. To use all
of the pool's processes, it should be invoked multiple times:

    with Pool(processes=4) as pool:
        results = [pool.apply_async(func, ()) for i in range(4)]

Patch by Davin Potts.

merge from 3.5

issue25909 - Correct the documentation of PyMapping_Items, PyMapping_Keys and
PyMapping_Values in Include/abstract.h and Doc/c-api/mapping.rst.

Patch contributed by Sonali Gupta.

issue25909 - Correct the documentation of PyMapping_Items, PyMapping_Keys and
PyMapping_Values in Include/abstract.h and Doc/c-api/mapping.rst.

Patch contributed by Sonali Gupta.

Issue #26107: Fix typo in Objects/lnotab_notes.txt

Double parenthesis

Merge 3.5 (doc)

Issue #26106: doc: Move text of licenses to parsed literal block

This change helps to ignore text of PSF, BEOPEN.com and CNRI licenses when
translating the documentation. Patch written by Julien Palard who is
translating Python 3.5 doc to french. Text of other licenses already used
preformatted format.

merge 3.5 (#26171)

merge 3.4 (#26171)

prevent buffer overflow in get_data (closes #26171)

merge 3.5

merge 3.4

fix refleak in error condition

merge 3.5 (#26172)

merge 3.4 (#26172)

remove script from epub (closes #26172)

Merge 3.5 (issue #24520)

Replace fpgetmask() with fedisableexcept()

Issue #24520: On FreeBSD, fpgetmask() was deprecated long time ago.
fedisableexcept() is now preferred.

co_lnotab supports negative line number delta

Issue #26107: The format of the co_lnotab attribute of code objects changes to
support negative line number delta.

Changes:

* assemble_lnotab(): if line number delta is less than -128 or greater than
  127, emit multiple (offset_delta, lineno_delta) in co_lnotab
* update functions decoding co_lnotab to use signed 8-bit integers

  - dis.findlinestarts()
  - PyCode_Addr2Line()
  - _PyCode_CheckLineNumber()
  - frame_setlineno()

* update lnotab_notes.txt
* increase importlib MAGIC_NUMBER to 3361
* document the change in What's New in Python 3.6
* cleanup also PyCode_Optimize() to use better variable names

merge from 3.5

issue25982 - Add a class definition for managers.Namespace in the multiprocessing docs.

issue25982 - Add a class definition for managers.Namespace in the multiprocessing docs.

Merge 3.5

Issue #26154: Add a new private _PyThreadState_UncheckedGet() function.

Add _PyThreadState_UncheckedGet()

Issue #26154: Add a new private _PyThreadState_UncheckedGet() function which
gets the current thread state, but don't call Py_FatalError() if it is NULL.

Python 3.5.1 removed the _PyThreadState_Current symbol from the Python C API to
no more expose complex and private atomic types. Atomic types depends on the
compiler or can even depend on compiler options. The new function
_PyThreadState_UncheckedGet() allows to get the variable value without having
to care of the exact implementation of atomic types.

Changes:

* Replace direct usage of the _PyThreadState_Current variable with a call to
  _PyThreadState_UncheckedGet().
* In pystate.c, replace direct usage of the _PyThreadState_Current variable
  with the PyThreadState_GET() macro for readability.
* Document also PyThreadState_Get() in pystate.h

Issue #26147: xmlrpc now works with strings not encodable with used
non-UTF-8 encoding.

Issue #26147: xmlrpc now works with strings not encodable with used
non-UTF-8 encoding.

Issue #5626: Remove misleading comment from socket.gethostname() documentation

A machine can have more than one IP addresses so
socket.gethostbyname(socket.gethostname()) probably won't return the correct
one.

Issue #5626: Remove misleading comment from socket.gethostname() documentation

A machine can have more than one IP addresses so
socket.gethostbyname(socket.gethostname()) probably won't return the correct
one.

Issue #26157: Fix typos in asyncio-eventloop.rst

Initial patch by Carlo Beccarini.

Issue #26157: Fix typos in asyncio-eventloop.rst

Initial patch by Carlo Beccarini.

Merge update to pip/setuptools

Merge update to pip/setuptools

Update pip to 8.0.0 and setuptools to 19.4

Issue #25935: Garbage collector now breaks reference loops with OrderedDict.

Issue #25935: Garbage collector now breaks reference loops with OrderedDict.

Issue #16620: Got rid of using undocumented function glob.glob1().

Issue #16620: Fixed AttributeError in msilib.Directory.glob().

Issue #16620: Fixed AttributeError in msilib.Directory.glob().

Merge 3.5

Fix BytecodeTestCase.assertNotInBytecode()

Issue #11816: Fix bytecode_helper to handle correctly errors. Don't use
unassigned variables.

merge 3.5 (#25731)

set tp_new from the class in the hierarchy that actually owns the descriptor (closes #25731)

Debugging by Eryk Sun.

merge from 3.5

issue23962 - Reference the correct TimeoutError in concurrent.futures documentation.

Patch contributed by Ryder Lewis.

issue23962 - Reference the correct TimeoutError in concurrent.futures documentation.

Patch contributed by Ryder Lewis.

Issue #25859: Merge NNTP test server from 3.5

Issue #25859: Reimplement NNTP test_starttls() using local server

The previous test relied on a remote server, which currently seems to be
shutting the connection down once TLS has been set up, causing an EOFError.
Now the test is implemented using a minimal NNTP server running in a
background thread.

Issue #25366: Skip test_with_pip when threading module is not available

Some dependencies of pip import threading module unconditionally so
we need to skip the test to make buildbots happy.

Issue #25366: Skip test_with_pip when threading module is not available

Some dependencies of pip import threading module unconditionally so
we need to skip the test to make buildbots happy.

Added exceptins for testing non-reversible import mapping for Issue #26013.

Added exceptins for testing non-reversible import mapping for Issue #26013.

Issue #26013: Added compatibility with broken protocol 2 pickles created
in old Python 3 versions (3.4.3 and lower).

Issue #26013: Added compatibility with broken protocol 2 pickles created
in old Python 3 versions (3.4.3 and lower).

Issue #9006: Added tests for XML RPC with non-UTF-8 encoding.

Issue #9006: Added tests for XML RPC with non-UTF-8 encoding.

Issue #26129: Deprecated accepting non-integers in grp.getgrgid().

subprocess._optim_args_from_interpreter_flags()

Issue #26100:

* Add subprocess._optim_args_from_interpreter_flags()
* Add test.support.optim_args_from_interpreter_flags()
* Use new functions in distutils, test_cmd_line_script, test_compileall and
  test_inspect

The change enables test_details() test of test_inspect when -O or -OO command
line option is used.

Fix test_compilepath() of test_compileall

Issue #26101: Exclude Lib/test/ from sys.path in test_compilepath(). The
directory contains invalid Python files like Lib/test/badsyntax_pep3120.py,
whereas the test ensures that all files can be compiled.

Fix indentation of continuation lines.

Fix two instances of wrong indentation.

Issue26069 - Update whatsnew/3.6.rst on traceback module's api removals.

Merge from 3.5

Issue26017 - Suggest enclosing command args in double quotes when using characters which get interpreted by shell.

Issue26017 - Suggest enclosing command args in double quotes when using characters which get interpreted by shell.

Issue #26139: libmpdec: disable /W4 warning (non-standard dllimport behavior).

Merge with 3.5

Issue #25905: Specify 'ascii' encoding for README.txt and NEWS.txt.
Re-encode CREDITS.txt to utf-8 and open it with 'utf-8'.

merge from 3.5

Issue26135 - In the tutorial section on modules, reference importlib.reload instead of imp.reload.

Issue26135 - In the tutorial section on modules, reference importlib.reload instead of imp.reload.

Issue #26071: bdist_wininst created binaries fail to start and find 32bit Python

Issue #26071: bdist_wininst created binaries fail to start and find 32bit Python

Issue #26073: Update the list of magic numbers in launcher

Issue #26073: Update the list of magic numbers in launcher

Issue #26065: Excludes venv from library when generating embeddable distro.

Issue #26065: Excludes venv from library when generating embeddable distro.

Merge