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.

Merge heads

Issue #25447: Copying the lru_cache() wrapper object now always works,
independedly from the type of the wrapped object (by returning the original
object unchanged).

Issue #25447: Copying the lru_cache() wrapper object now always works,
independedly from the type of the wrapped object (by returning the original
object unchanged).

Remove duplicate method in test_pathlib.  Initial patch by Navneet Suman.

Issue #25768: Make compileall functions return booleans and document
the return values as well as test them.

Thanks to Nicholas Chammas for the bug report and initial patch.

Merge for issue #12484

Issue #12484: Remove a mention of Py_InitModule() and _PyImport_FixupExtension().

Thanks to Alejandro Santos for the bug report and Anish Shah for the
patch.

Merge for issue #25874

Issue #25874: Clarify platform support in the "Using Python on Windows" doc.

Thanks to Chris Wilcox for the initial patch.

Issue #20440: Cleaning up the code by using Py_SETREF and Py_CLEAR.
Old code is correct, but with Py_SETREF and Py_CLEAR it can be cleaner.
This patch doesn't fix bugs and hence there is no need to backport it.

Issue #20440: More use of Py_SETREF.
This patch is manually crafted and contains changes that couldn't be handled
automatically.

Issue #20440: More use of Py_SETREF.
This patch is manually crafted and contains changes that couldn't be handled
automatically.

Issue #20440: Applied yet one patch for using Py_SETREF.
The patch is automatically generated, it replaces the code that uses Py_CLEAR.

Issue #20440: Applied yet one patch for using Py_SETREF.
The patch is automatically generated, it replaces the code that uses Py_CLEAR.

Closes #25360: Merged fix from 3.5.

Fixes #25360: Search for pythonw.exe when in pyw.exe.

Closes #25685: Merged fix from 3.5.

Closes #25685: Made SocketHandler emission more efficient.

Closes #25789: Improved buffering behaviour in launcher.

Issue #22995: Instances of extension types with a state that aren't
subclasses of list or dict and haven't implemented any pickle-related
methods (__reduce__, __reduce_ex__, __getnewargs__, __getnewargs_ex__,
or __getstate__), can no longer be pickled.  Including memoryview.

Issue #22995: Instances of extension types with a state that aren't
subclasses of list or dict and haven't implemented any pickle-related
methods (__reduce__, __reduce_ex__, __getnewargs__, __getnewargs_ex__,
or __getstate__), can no longer be pickled.  Including memoryview.

Issue #25923: Added more const qualifiers to signatures of static and private functions.