Merge 3.2: tutorial typo fix

tutorial typo fix

Issue #15586: fix prompts in some documentation examples

Merge #15636: add versionadded for decodebytes

#15636: add versionadded for decodebytes

Merge #15355: Mention already-executing Exception in generator docs.

Patch by Chris Jerdonek.

#15355: Mention already-executing Exception in generator docs.

Patch by Chris Jerdonek.

Merge #15694: reflow paragraph.

#15694: reflow paragraph.

Merge #15694: Link discussion of file objects to glossary entry.

This is analogous to the link for `flie objects` in the description of
'open' that exists in the 2.7 docs, and adds a similar link to the
io docs.

Patch by Chris Jerdonek.

#15694: Link discussion of file objects to glossary entry.

This is analogous to the link for `flie objects` in the description of
'open' that exists in the 2.7 docs, and adds a similar link to the
io docs.

Patch by Chris Jerdonek.

Closes #15632: regrtest.py: fix spurious refleaks due to various caches
filling up with random data.

Issue #15678: Fix menu customization for IDLE started from OS X
command lines.  It was broken as a side effect of the changes to
pythonw.c in b79d276041a8 for #15307.  Since sys.executable no
longer includes 'Python.app' in the path name, test for a
framework build instead.  This should give the previous behavior
in nearly all cases.  Whether the previous behavior is sensible
is left as an issue for later releases.  IDLE.app behavior was
not affected as it does its own manipulation of sys.executable.

Merge with 3.2 #15660

Issue 15660: Clarify 0 prefix for width field in str.format doc.

Issue #15640: Document importlib.abc.Finder as deprecated.

The code for the class itself isn't deprecated for
backwards-compatibility reasons, but the class shouldn't be directly
inherited by anyone anymore as the API is no longer as widely valid as
it used to be.

Issue #15715: Ignore failed imports triggered by the use of fromlist.

When the fromlist argument is specified for __import__() and the
attribute doesn't already exist, an import is attempted. If that fails
(e.g. module doesn't exist), the ImportError will now be silenced (for
backwards-compatibility). This *does not* affect
``from ... import ...`` statements.

Thanks to Eric Snow for the patch and Simon Feltman for reporting the
regression.

Merge

Issue #15412: Remove erroneous note about weakrefs

Merge

Issue #14501: Clarify that authentication keys are byte strings

Update the getpeercert() example with a real-world cert showing non-trivial issuer, subject and subjectAltName.

Update the getpeercert() example with a real-world cert showing non-trivial issuer, subject and subjectAltName.

Fix subprocess test broken on Windows

Issue #14669: Fix pickling of connections and sockets on MacOSX
by sending/receiving an acknowledgment after file descriptor transfer.
TestPicklingConnection has been reenabled for MacOSX.

#11062: Fix universal newline support in Babyl._install_message()

#11062: Fix universal newline support in Babyl._install_message()

When adding a message from a binary file, \r\n was translated to
\r\r\n in the message body.

Merge str docstring fix from 3.2

Fix str docstring

Issue #15604: Update uses of PyObject_IsTrue() to check for and handle errors correctly.
Patch by Serhiy Storchaka.

Issue #15604: Update uses of PyObject_IsTrue() to check for and handle errors correctly.
Patch by Serhiy Storchaka.

merge heads

Add yet another test for subprocess.Popen.communicate

merge with 3.2

clarify in/not in in case of infinite iterators; thanks to Sergey Skovorodkin from docs@

#15543: reflow paragraph.

#15543: additional link in subprocess docs.

Patch by Chris Jerdonek.

Merge #15543: glossary entry for and 'universal newlines', and links to it.

Patch by Chris Jerdonek.

#15543: reflow paragraphs.

#15543: glossary entry for and 'universal newlines', and links to it.

Patch by Chris Jerdonek.

Cleanup universal_newlines usage for subprocess.Popen, remove unused param.

merge 3.2

merge heads in 3.2 branch

Issue #15656: fixing code sample in extending doc

#11062: Fix adding a message from file to Babyl mailbox

Issue #15586: typo fix. This commit is accompanied by an apology for all Liechtensteiners out there, and a thanks to Eric Araujo for noticing.

#11062: Fix adding a message from file to Babyl mailbox

Merge #15269: document dircmp.left and right, and add tests for them.

Patch by Chris Jerdonek.

#15269: document dircmp.left and right, and add tests for them.

Patch by Chris Jerdonek.

merge with 3.2

fix typo

Merge heads

Merge 3.2 to default

Merge 3.2

Issue #15592. Fix regression: subprocess.communicate() breaks on no input with universal newlines true.

Patch by Chris Jerdonek.

Add test to explicit check the absence regression in subprocess (issue #15592).

Patch by Chris Jerdonek.

merge 3.2

Modules/socketmodule.c: netdb_lock: define static.

Issue #14167: Document return statement in finally blocks.

Patch by Yury Selivanov.

Issue #14167: Document return statement in finally blocks.

Patch by Yury Selivanov.

Merge 3.2

Issue #15646: Prevent equivalent of a fork bomb when using multiprocessing
on Windows without the "if __name__ == '__main__'" idiom.

Review of signature docs.

merge with 3.2

Restore original line lengths.

Add Daniel Ellis to Misc/ACKS

Issue #15586: add some examples to ElementTree documentation. Patch by Daniel Ellis.

errant merge problem committed

Merge 3.2

Fix #15496. Add directory removal helpers to make Windows tests more reliable. Patch by Jeremy Kloth

Issue #15497: Correct characters in TextWrapper.replace_whitespace docs.

Patch by Chris Jerdonek.

Issue #15497: Correct characters in TextWrapper.replace_whitespace docs.

Patch by Chris Jerdonek.

Push importlib ABC hierarchy chart.

Issue #15561: Update subprocess docs to reference io.TextIOWrapper.

Patch by Chris Jerdonek.

Issue #15561: Update subprocess docs to reference io.TextIOWrapper.

Patch by Chris Jerdonek.

Mention PEP 362: Function Signature Object in whatsnew.

Minor update of docs for inspect module.

Issue #15151: PEP 362 — document signature and related classes for inspect.py

Initial patch by Yury Selivanov

Issue #15571: comment the fact what python impl of TextIOWrapper always works in write_throuth mode

Issue #15624: clarify newline documentation for open and io.TextIOWrapper

Thanks to Chris Jerdonek

Issue #15624: clarify newline documentation for open and io.TextIOWrapper

Thanks to Chris Jerdonek

merge from 3.2

Issue #15630: Add an example for "continue" statement in the tutorial. Patch by
Daniel Ellis.

Issue #15630: Add an example for "continue" statement in the tutorial. Patch by
Daniel Ellis.

merge with 3.2

add usage example from cli; thanks to Christian Clauss from docs@

Post-release updates.

merge with 3.2

escape '\'; thanks to Steve Holden from docs@

merge with 3.2

it's getstatus() not setstatus(); thanks to Shaddi Hasan from docs@

update doctests

fix doctest for email.header docs

merge with 3.2

add missing quote in splitlines() example; thanks to Yevgen Yampolskiy from docs@

merge with 3.2

update Geany URL; thanks to Karl Tarbet from docs@

merge with 3.2

add missing parenthesis to 'action' argparse doc; thanks to kishkin from docs@

update CodeTools link; thanks to Robert Kern from docs@

merge with 3.2