merge 3.4 (#13143)

clarify that islink only really works if python knows about symlinks (closes #13143)

Patch from Yayoi Ukai.

merge 3.4 (#16667)

some timezone doc improvements (closes #16667)

From the combined efforts of Berber Peksage, Andrew Svetlov, and Yayoi Ukai.

(Merge 3.4) asyncio, Tulip issue 171: BaseEventLoop.close() now raises an
exception if the event loop is running. You must first stop the event loop and
then wait until it stopped, before closing it.

asyncio, Tulip issue 171: BaseEventLoop.close() now raises an exception if the
event loop is running. You must first stop the event loop and then wait until
it stopped, before closing it.

(Merge 3.4) asyncio: document the debug mode

asyncio: document the debug mode

(Merge 3.4) asyncio, Tulip issue 172: only log selector timing in debug mode

asyncio, Tulip issue 172: only log selector timing in debug mode

(Merge 3.4) asyncio: Add an unit test to check that setting the
PYTHONASYNCIODEBUG env var enables debug mode of the event loop.

asyncio: Add an unit test to check that setting the PYTHONASYNCIODEBUG env var
enables debug mode of the event loop.

(Merge 3.4) asyncio: Enable the debug mode of event loops when the
PYTHONASYNCIODEBUG environment variable is set

asyncio: Enable the debug mode of event loops when the PYTHONASYNCIODEBUG
environment variable is set

(Merge 3.4) asyncio: BaseEventLoop._assert_is_current_event_loop() now only
raises an exception if the current loop is not None.

Guido van Rossum wrote:

"The behavior that you can set the loop to None (and keep track of it
explicitly) is part of the spec, and this should still be supported even in
debug mode. The behavior that we raise an error if you are caught having
multiple active loops per thread is just a debugging heuristic, and it
shouldn't break code that follows the spec."

asyncio: BaseEventLoop._assert_is_current_event_loop() now only raises an
exception if the current loop is not None.

Guido van Rossum wrote:

"The behavior that you can set the loop to None (and keep track of it
explicitly) is part of the spec, and this should still be supported even in
debug mode. The behavior that we raise an error if you are caught having
multiple active loops per thread is just a debugging heuristic, and it
shouldn't break code that follows the spec."

reflow to 80 chars

add BufferedIOBase.readinto1 (closes #20578)

Patch by Nikolaus Rath.

Issue #10747: Merge with 3.4

Issue #10747: Use versioned labels in the Windows start menu.
Patch by Olive Kilburn.

merge heads

#6916: attempt to fix BB failure

merge

Issue #21812:  Trigger immediate transformation in turtle.shapetransform().

Merge with 3.4

Issue #21823: Catch turtle.Terminator exceptions in turtledemo.
Add note to demohelp.txt about doing so.

Issue 21786:  Clean-up test_pydoc taking taking advantage of diffing in unittest.

merge

Issue 21635:  Fix caching in difflib.SequenceMatcher.get_matching_blocks().

merge heads

#6916: raise a deprecation warning if using asynchat.fifo

Fix test_pydoc failure introduced by cddb17c4975e. Patch by Berker Peksag.

Merge.

Fix test_pydoc failure introduced by 7aa72075d440. Patch by Berker Peksag.

Merge.

Issue #21491: socketserver: Fix a race condition in child processes reaping.

Merge with 3.4

Issue #21770: Call function instead of module. Patch by Claudiu Popa.

Merge.

Merge.

Issue #21491: socketserver: Fix a race condition in child processes reaping.

Merge with 3.4

Issue #21768: fix NameError in test_pydescr. Patch by Claudiu Popa.

Merge with 3.4

Issue #21768: fix type in test_pydoc, patch by Claudiu Popa.

(Merge 3.4) asyncio, Tulip issue 105: in debug mode, log callbacks taking more
than 100 ms to be executed.

asyncio, Tulip issue 105: in debug mode, log callbacks taking more than 100 ms
to be executed.

Simplify a badly written condition.

merge from 3.4

issue 20091 - index entry for __main__ in runpy docs.

issue 20091 - index entry for __main__ in runpy docs.

#21690: merge with 3.4.

#21690: fix a couple of links in the docs of the re module.  Noticed by Julian Gilbey.

(Merge 3.4) Tulip issue 83: document more asyncio functions in docstrings

Tulip issue 83: document more asyncio functions in docstrings

Issue #21741: Add st_file_attributes to os.stat_result on Windows.

Patch by Ben Hoyt.

(Merge 3.4) Closes #21595: asyncio.BaseSelectorEventLoop._read_from_self() now
reads all available bytes from the "self pipe", not only a single byte. This
change reduces the risk of having the pipe full and so getting the innocuous
"BlockingIOError: [Errno 11] Resource temporarily unavailable" message.

Closes #21595: asyncio.BaseSelectorEventLoop._read_from_self() now reads all
available bytes from the "self pipe", not only a single byte. This change
reduces the risk of having the pipe full and so getting the innocuous
"BlockingIOError: [Errno 11] Resource temporarily unavailable" message.

(Merge 3.4) Closes #21758: asyncio doc: mention explicitly that subprocess
parameters are bytes or character strings

Closes #21758: asyncio doc: mention explicitly that subprocess parameters are
bytes or character strings

Issue #21722: The distutils "upload" command now exits with a non-zero return code when uploading fails.
Patch by Martin Dengler.

Issue #21722: The distutils "upload" command now exits with a non-zero return code when uploading fails.
Patch by Martin Dengler.

Issue #3485: merge from 3.4

Issue #3485: remove misleading comment

Merge typo fix

Fix typo pointed out by cocoatomo on docs@

(Merge 3.4) asyncio: Fix pyflakes errors

- Add a missing import
- Remove an unused import
- Remove unused variables

asyncio: Fix pyflakes errors

- Add a missing import
- Remove an unused import
- Remove unused variables

(Merge 3.4) asyncio: Refactor tests: add a base TestCase class

asyncio: Refactor tests: add a base TestCase class

(Merge 3.4) asyncio: Refactor test__run_once_logging() to not rely on the exact
number of calls to time.monotonic(). Use a "fast select" and a "slow select"
instead.

asyncio: Refactor test__run_once_logging() to not rely on the exact number of
calls to time.monotonic(). Use a "fast select" and a "slow select" instead.

(Merge 3.4) asyncio: Set __qualname__ attribute of CoroWrapper in @coroutine
decorator on Python 3.5.

- Drop __slots__ optimization of CoroWrapper to be able to set the __qualname__
  attribute.
- Add tests on __name__, __qualname__ and __module__ of a coroutine function
  and coroutine object.
- Fix test_tasks when run in debug mode (PYTHONASYNCIODEBUG env var set) on
  Python 3.3 or 3.4

asyncio: Set __qualname__ attribute of CoroWrapper in @coroutine decorator on
Python 3.5

- Drop __slots__ optimization of CoroWrapper to be able to set the __qualname__
  attribute.
- Add tests on __name__, __qualname__ and __module__ of a coroutine function
  and coroutine object.
- Fix test_tasks when run in debug mode (PYTHONASYNCIODEBUG env var set) on
  Python 3.3 or 3.4

(Merge 3.4) Issue #21723: asyncio.Queue: support any type of number (ex: float)
for the maximum size. Patch written by Vajrasky Kok.

Issue #21723: asyncio.Queue: support any type of number (ex: float) for the
maximum size. Patch written by Vajrasky Kok.

Issue #10310: Use "unsigned int field:1" instead of "signed int field:1" in a
private structure of the _io module to fix a compiler warning (overflow when
assigning the value 1). Fix also a cast in
incrementalnewlinedecoder_setstate().  Patch written by Hallvard B Furuseth.

Merge with 3.4

Issue #21694: Add unittest for ParenMatch. Patch by Saimadhav Heblikar.

merge 3.4

add Ammar Brohi for running ssllab's test on python.org and reporting a problem

merge 3.4

revert tstate_delete_common, since it's pretty much wrong

merge 3.4

remove extra call to tstate_delete_common (merge artifact)

merge 3.4

merge 3.3

merge 3.2

expect the correct platform-dependent linesep

merge 3.4

avoid a deadlock with the interpreter head lock and the GIL during finalization

merge 3.4

check if the thread is finalizing after retaking the GIL

Add Idle news entries.

Add Idle news entries.

Merge with 3.4

Issue #21686: add unittest for idlelib.HyperParser.  Original patch by Saimadhav
Heblikar. Correct a minor 3.x bug in HyperParser discovered by testing.

(Merge 3.4) asyncio: Task.__repr__() now also handles CoroWrapper

asyncio: Task.__repr__() now also handles CoroWrapper

(Merge 3.4) Issue #21773: Fix TestStdLib.test_pydoc() of test_enum. Patch
written by Claudiu Popa.

The print_diffs() function was not defined, using the assertEqual() is more
reliable.

Issue #21773: Fix TestStdLib.test_pydoc() of test_enum. Patch written by
Claudiu Popa.

The print_diffs() function was not defined, using the assertEqual() is more
reliable.