Merge with 3.5

Issue #26029: Remove extraneous word.  Patch by Upendra Kumar.

merge from 3.5

Issue #22138: Fix mock.patch behavior when patching descriptors. Restore
original values after patching.

Patch contributed by Sean McCully.

Issue #22138: Fix mock.patch behavior when patching descriptors. Restore
original values after patching.

Patch contributed by Sean McCully.

Issue #25802: Add an examples section to importlib.

Thanks to Berker Peksag for the patch review.

merge from 3.5

Issue20969 - Set the Epub Author and Epub Publisher in Python docs.

Issue20969 - Set the Epub Author and Epub Publisher in Python docs.

merge 3.5 (#26046)

merge 3.4 (#26046)

fix typo in unittest docs (closes #26046)

Patch from Upendra Kumar.

merge 3.5 (closes #25672)

enable SSL_MODE_RELEASE_BUFFERS

Patch by Cory Benfield.

Hopeful fix for test_rglob_common on Windows without symlinks. (Merge 3.5->3.6)

Hopeful fix for test_rglob_common on Windows without symlinks. (Merge 3.4->3.5)

Hopeful fix for test_rglob_common on Windows without symlinks.

Add another try/except PermissionError to avoid depending on listdir order. Fix issues #24120 and #26012. (Merge 3.5->3.6)

Add another try/except PermissionError to avoid depending on listdir order. Fix issues #24120 and #26012. (Merge 3.4->3.5)

Add another try/except PermissionError to avoid depending on listdir order. Fix issues #24120 and #26012.

Fix typo in docstring of multiprocessing.spawn.spawn_main()

Fix typo in docstring of multiprocessing.spawn.spawn_main()

Issue #5501: Clarify that invoking freeze_support() on non-Windows platforms has no effect

Patch by Davin Potts and Camilla Montonen.

Issue #5501: Clarify that invoking freeze_support() on non-Windows platforms has no effect

Patch by Davin Potts and Camilla Montonen.

merge from 3.5

Issue16544 - Add a link to an external documentation resource in ast module docs.

merge from 3.4

Issue16544 - Add a link to an external documentation resource in ast module docs.

Issue16544 - Add a link to an external documentation resource in ast module docs.

Docs for issue #22570. (Merge 3.5->3.6)

Cross-reference os.DirEntry and pathlib.Path for issue #22570.

Add versionadded (3.4.5) to docs for issue #22570. (Merge 3.4->3.5)

Add versionadded (3.4.5) to docs for issue #22570.

Docs for issue #22570. (Merge 3.4->3.5)

Docs for issue #22570.

Issue #22570: Add 'path' attribute to pathlib.Path objects. (Merge 3.5->3.6)

Issue #22570: Add 'path' attribute to pathlib.Path objects. (Merge 3.4->3.5)

Issue #22570: Add 'path' attribute to pathlib.Path objects.

Issue #26012: Don't traverse into symlinks for ** pattern in pathlib.Path.[r]glob(). (Merge 3.5->3.6)

Issue #26012: Don't traverse into symlinks for ** pattern in pathlib.Path.[r]glob(). (Merge 3.4->3.5)

Issue #26012: Don't traverse into symlinks for ** pattern in pathlib.Path.[r]glob().

Issue #24120: Ignore PermissionError in pathlib.Path.[r]glob(). Ulrich Petri. (Merge 3.5->3.6)

Issue #24120: Ignore PermissionError in pathlib.Path.[r]glob(). Ulrich Petri. (Merge 3.4->3.5)

Issue #24120: Ignore PermissionError in pathlib.Path.[r]glob(). Ulrich Petri.

Issue #20440: Cleaning up the code by using Py_SETREF.

merge from 3.5

Issue24898 - Improve str.find documentation.

Simplify str.find explaination as per Georg Brandl's suggestion.

merge from 3.4

Issue24898 - Improve str.find documentation.

Simplify str.find explaination as per Georg Brandl's suggestion.

Issue24898 - Improve str.find documentation.

Simplify str.find explaination as per Georg Brandl's suggestion.

merge from 3.5

Issue21221 - Explain the usage of tm_isdst attribute of mktime, with valid
values and meaning.

Patch contributed by Andrew Scheller.

merge from 3.4

Issue21221 - Explain the usage of tm_isdst attribute of mktime, with valid
values and meaning.

Patch contributed by Andrew Scheller.

Issue21221 - Explain the usage of tm_isdst attribute of mktime, with valid
values and meaning.

Patch contributed by Andrew Scheller.

#21815: Make the doc change match what I actually did.

#21815: violate IMAP RFC to be compatible with, e.g., gmail

and others, including imaplib's own behavior.  I'm applying this only to 3.6
because there's a potential backward compatibility concern: if there are
servers that include ] characters in the 'text' portion of their imap
responses, this code change could introduce a new bug.

Patch by Lita Cho, reviewed by Jessica McKellar, Berker Peksag, Maciej Szulik,
silentghost, and me (I fleshed out the comments with the additional
info/concerns.)

Merge: #22709: Use stdin as-is if it does not have a buffer attribute.

#22709: Use stdin as-is if it does not have a buffer attribute.

This restores backward compatibility lost in the fix for #21075, and
is better duck typing.

Patch by Akira Li.

merge from 3.5

Issue25917 : Fix howto links in docs. Point the reference documentation instead of wiki.

merge from 3.4

Issue25917 : Fix howto links in docs. Point the reference documentation instead of wiki.

Issue25917 : Fix howto links in docs. Point the reference documentation instead of wiki.

Remove a duplicate test_addresses key:value as identified by Vincent
Davis reviewing code.

Remove a duplicate test_addresses key:value as identified by Vincent
Davis reviewing code.

Update copyrights for 2016.

Update copyrights for 2016.

Update copyrights for 2016.

Merge with 3.5

Fix grammar.

Reported by Anatoly Techtonik on docs@

merge 3.5

merge 3.4

merge 3.3

remove some copyright notices supserseded by the toplevel ones

add 2015 and 2016

merge 3.5

merge 3.4

merge 3.3

reflow

merge 3.5

merge 3.4

merge 3.3

2016 will be another year of writing copyrighted code

Issue #25961: Disallowed null characters in the type name.
Simplified testing for null characters in __name__ setter.

Issue #25961: Disallowed null characters in the type name.
Simplified testing for null characters in __name__ setter.

Make catched exception more specific and correct a comment.

Make catched exception more specific and correct a comment.

Fixed formatting comman-line usage message.

Fixed formatting comman-line usage message.

Issue #25977: Fix typos in Lib/tokenize.py

Patch by John Walker.

Issue #25977: Fix typos in Lib/tokenize.py

Patch by John Walker.

Clean up float.as_integer_ratio().

Issue #25971: Optimized creating Fractions from floats by 2 times and from
Decimals by 3 times.
Unified error messages in float.as_integer_ratio(), Decimal.as_integer_ratio(),
and Fraction constructors.

merge 3.5 (#25973)

make recording and reporting errors and nonlocal and global directives more robust (closes #25973)

Issue #25972, #20440: Fix compilation on Windows

Issue #25802: Deprecate load_module() on importlib.machinery.SourceFileLoader and SourcelessFileLoader.

They were the only remaining implementations of load_module() not
documented as deprecated.

Merge for backport  of fix for issue #25930

Backport of fix for issue #25930

Issue #25930: Document that os.unlink and os.remove are *semantically* identical.

Saying that the functions were identical confused some users who were
upset when the functions were no longer simply the same function under
different names.

Thanks to Anthony Sottile for the bug report and Swati Jaiswal for the
initial patch.

Issue #25234: Skip test_eintr.test_os_open under OS X.

Test inconsistently hangs.

Tweak skipping message

Merge

Issue #24725: Skip the test_socket.testFDPassEmpty on OS X.

In OS X 10.11, the test fails consistently due to a platform change
since 10.10. Thanks to Jeff Ramnani for the patch.

Issue #25940: Make buildbots usable again until a solution is found.

Issue #25928: Temporarily disable some tests in test_statistics in order
to sort out its assumptions about the as_integer_ratio() interface.

Fix typo.

Merge.

Issue #25928: Add Decimal.as_integer_ratio(). Python parts and docs by
Mark Dickinson.