Merge from 3.2: Fix placement of shell=True warning in subprocess.Popen() docs.

Fix placement of shell=True warning in subprocess.Popen() docs.

Issue #16115: Merge subprocess.Popen() documentation improvements from 3.2.

Issue #16115: Make further improvements to subprocess.Popen() documentation.

Closes issue #15111: Calling __import__ with a module specified in
fromlist which causes its own ImportError (e.g. the module tries to
import a non-existent module) should have that exception propagate.

Issue #12947: Remove doctest directives from the doctest examples in the "Option Flag" section.

The doctest examples that illustrate the use of doctest option flags
independent of doctest directives should not display doctest directives.

Missed one instance of code-block:: text highlighting to revert.

merge 3.2

merge 3.2 heads

Issue #12947: revert earlier workaround and use a monkey-patch to enable showing doctest directives only in the doctest docs.

Issue #12947: revert earlier workaround and use a monkey-patch to enable showing doctest directives only in the doctest docs.

Issue #12947: Divide doctest "Option Flags and Directives" section into two.

This changeset also applies the rendering workaround to the last remaining
example in the file that has a doctest directive that should be displayed.

Fixes Issue #16114: The subprocess module no longer provides a
misleading error message stating that args[0] did not exist when
either the cwd or executable keyword arguments specified a path that
did not exist.

Fixes Issue #16114: The subprocess module no longer provides a
misleading error message stating that args[0] did not exist when
either the cwd or executable keyword arguments specified a path that
did not exist.

It now keeps track of if the child got as far as preexec and reports it if
not back to the parent via a special "noexec" error message value in
the error pipe so that the cwd can be blamed for a failed chdir
instead of the exec of the executable being blamed instead.

The executable is also always reported accurately when exec fails.

Unittests enhanced to cover these cases.

Issue #16170: Remove Linux skip from test_subprocess's test_executable test.

merge heads

compare singletons by identity not equality (closes #16712)

Patch from Serhiy Storchaka.

compare with equality not identity (issue #16172)

Patch from Serhiy Storchaka.

Issue #16082: clarify the documentation of tostring[list] saying that it may generate a bytestring, depending on the given encoding.

Issue #12322: clarify xpath reference for cases where the path reaches ancestors of the start element. Also add missing markup for a None. Thanks to patrick vrijlandt and Mike Hoy for the report and initial patches.

Issue #16169: Fix ctypes.WinError()'s confusion between errno and winerror

Merge issue #16174: Fix suggested usage of dummy_threading module.

Patch by Berker Peksag.

Issue #16174: Fix suggested usage of dummy_threading module.

Patch by Berker Peksag.

Fix Issue 15922: make howto/urllib2.rst doctests pass.
Patch by Chris Jerdonek. Address Ezio's review comment.

Fix Issue 15922: make howto/urllib2.rst doctests pass.
Patch by Chris Jerdonek. Address Ezio's review comment.

Issue #16168: Merged SysLogHandler update from 3.2.

Issue #16168: Use specified socket type for domain sockets in SysLogHandler.

Issue #16115: Merge subprocess.Popen() documentation improvements from 3.2.

Issue #16115: Improve subprocess.Popen() documentation around args, shell, and executable arguments.

Issue #16115: Skip a newly added subprocess.Popen() test on Linux.

Issue #16115: Improve testing of the executable argument to subprocess.Popen().

Merge 3.2

Issue #14783: Merge changes from 3.2.

Issue #14783: Improve int() docstring and also str(), range(), and slice().

This commit rewrites the docstring for int() to incorporate the documentation
changes made in issue #16036.  It also switches the docstrings for int(),
str(), range(), and slice() to use multi-line signatures.

Merge issue #14900: Add aliases for sorting params for pstat to follow column names from pstat output.

Patch by Arne Babenhauserheide.

Issue #14900: Add aliases for sorting params for pstat to follow column names from pstat output.

Patch by Arne Babenhauserheide.

#13498: Clarify docs of os.makedirs()'s exist_ok argument.

Done with great native-speaker help from R. David Murray.

Merge issue #14900: Distuguish call count and primitive call count in pstat output.

Patch by Arne Babenhauserheide.

Issue #14900: Distuguish call count and primitive call count in pstat output.

Patch by Arne Babenhauserheide.

Issue #15888: fixing problems in ipaddress doctests. Patch by Chris Jerdonek

More whatsnew updates, move some doc NEWS items into the doc section.

starmap/starmap_async for whatsnew, and fix multiprocessing Pool markup.

More whatsnew updates.  Also move a C-API NEWS item out of library section.

#9957: document that SpooledTemporaryFile.truncate now accepts a size arg

#9957: document that SpooledTemporaryFile.truncate does not take size arg

Null merge.

More whatsnew updates.

Fix markup in Counter note.

whatsnew updates for smtplib and collections.Counter.

Fix typos.

#10968: commit threading doc changes and corresponding whatsnew entry.

It is unfortunate that the '_' names were not kept as aliases, and that RLock
was not also converted to a class, but it is now too late to change either of
those things for 3.3.

Issue #16096: Fix signed overflow in Objects/longobject.c.  Thanks Serhiy Storchaka.

Issue #16096: Fix several occurrences of potential signed integer overflow.  Thanks Serhiy Storchaka.

revert accidental inclusion of subprocess tests

revert accidental inclusion of subprocess tests

Issue #16025: Minor corrections to the zipfile documentation.

Patch by Serhiy Storchaka.

Issue #16025: Minor corrections to the zipfile documentation.

Patch by Serhiy Storchaka.

Closes #11710: create "landing pages" (/library/package.html) for those packages that have no documented content themselves, e.g. "urllib" or "http".

Closes #16149: remove now-false statement about the inability to compare Decimal and float objects.

Closes #16149: remove now-false statement about the inability to compare Decimal and float objects.

Issue #16115: Add test for check that executable arg to Popen() takes precedence over args[0] arg\n                            \n                            Patch by Kushal Das

Merge ftplib doc fix with 3.2.

The file obj passed to ftp.storbinary/storlines must be opened in binary mode.

Merge issue #16138: fix typo.

Issue #16138: fix typo.

MERGE: #16112: platform.architecture does not correctly escape argument to /usr/bin/file. Fix original patch

#16112: platform.architecture does not correctly escape argument to /usr/bin/file. Fix original patch

#16112: platform.architecture does not correctly escape argument to /usr/bin/file. Use 'communicate()' and decode the bytes

#16127: remove outdated references to narrow builds.  Patch by Serhiy Storchaka.

Fix PyUnicode_Format(): return NULL if PyUnicode_READY(uformat) failed

This error cannot occur in practice: PyUnicode_FromObject() always return
a "ready" string.

Merge: Issue #14997: disable <F5> in idle shell window.

Thanks to Roger Serwy for patch.

Issue #14997: disable <F5> in idle shell window.

Thanks to Roger Serwy for patch.

Issue #16089: Allow ElementTree.TreeBuilder to work again with a non-Element element_factory (fixes a regression in SimpleTAL).

Fix typo in documentation for time module, thanks to docs@

Fix typo in documentation for collections.ChainMap, thanks to Olivier Bernard from docs@

Closes #16126: PyErr_Format format mismatch in _testcapimodule.c

MERGE: Closes #16112: platform.architecture does not correctly escape argument to /usr/bin/file

Closes #16112: platform.architecture does not correctly escape argument to /usr/bin/file

Whatsnew typo

whatsnew

Issue #12947: Better workaround for the problem with doctest directives being stripped from code examples that are intended to illustrate those directives

Issue #12947: Add a note to doctest until the example rendering is fixed

NULL merge

Closes #15897: zipimport.c doesn't check return value of fseek(). Typo

MERGE: Fix Misc/ACKS alphabetic order

MERGE: Closes #15897: zipimport.c doesn't check return value of fseek()

Fix Misc/ACKS alphabetic order

Closes #15897: zipimport.c doesn't check return value of fseek()

More whatsnew updates.

Reword the next version placeholder now that the changelog is part of the published What's New docs

Merge: Close open bracket, thanks to Josh Helzer from docs@

Close open bracket, thanks to Josh Helzer from docs@

Add multiprocessing.Process.sentinel to whatsnew, mention SSLFakeFile removal.

In this case it is not useful to hide "threading".

#15979: merge with 3.2.

#15979: improve timeit documentation.

Add threading.get_ident to whatsnew.

#11109: clean up docs, add whatsnew entry, and fix Justin's last name.

Fix/improve the changelog filtering.

Merge