merge from 3.3

Improve the docstring of random.shuffle. Inform users not to provide int arg.
Addresses issue #14927

Improve the docstring of random.shuffle. Inform users not to provide int arg.
Addresses issue #14927

merge from 3.3

Clarify mmap.close method  behavior.  Addresses issue  #18815
Patch contributed by Anoop Thomas Mathew.

Clarify mmap.close method  behavior.  Addresses issue  #18815
Patch contributed by Anoop Thomas Mathew.

merge from 3.3

Document Fraction's numerator and denominator properties.
Addresses issue #18800

Document Fraction's numerator and denominator properties.
Addresses issue #18800

Get "stopped" back into repr(Thread) when appropriate.

Due to recent changes, a Thread doesn't know that it's over before
someone calls .join() or .is_alive().  That meant repr(Thread)
continued to include "started" (and not "stopped") before one of
those methods was called, even if hours passed since the thread
ended.

Repaired that.

Another stab at the thread cleanup patch.

Antoine Pitrou found a variation that worked for him on the
thread+fork tests, and added an important

    self._is_stopped = True

to the after-fork code.  I confess I don't know why things passed
before.  But then mixing fork with threads is insane ;-)

Backed out changeset 1f5a7853680c

Unixy buildbots were failing the thread + fork tests :-(

Minor cleanup of the new scheme for detecting thread termination.

Documented some obscurities, and assert'ed ._stop()'s crucial precondition.

Merge.

Post-3.4.0a2-release fixups.

Merge docstring typo fix from 3.3

Docstring typo fix: Arithmentic -> Arithmetic.

merge

Issue 18752:  Make chain.from_iterable() more visible in the documentation.

merge

merge

Issue 18301:  The classmethod decorator didn't fit well with the rough-equivalent example code.

Close #18980: Enum doc fixes.  Patch from Elazar Gershuni.

Issue 18752:  Make chain.from_iterable() more visible in the documentation.

Issue 18984:  Remove ._stopped Event from Thread internals.

The fix for issue 18808 left us checking two things to be sure a Thread
was done:  an Event (._stopped) and a mutex (._tstate_lock).  Clumsy &
brittle.  This patch removes the Event, leaving just a happy lock :-)

The bulk of the patch removes two excruciating tests, which were
verifying sanity of the internals of the ._stopped Event after a fork.
Thanks to Antoine Pitrou for verifying that's the only real value
these tests had.

One consequence of moving from an Event to a mutex:  waiters (threads
calling Thread.join()) used to block each on their own unique mutex
(internal to the ._stopped event), but now all contend on the same
mutex (._tstate_lock).  These approaches have different performance
characteristics on different platforms.  I don't think it matters in
this context.

Fix a typo. (closes #18953)

Fix a typo. (closes #18953)

Fixed tests with Tcl/Tk <8.5 (closes #18964).

Fixed tests with Tcl/Tk <8.5 (closes #18964).

Issue #18904: test_os and test_socket use unittest.skipIf() to check if fcntl
module is present (to record skipped tests)

Issue #18808 again: fix the after-fork logic for not-yet-started or already-stopped threads.
(AFAICT, in theory, we must reset all the locks, not just those in use)

Merge.

Issue #18963: skip test_selectors.test_above_fd_setsize on older OS X versions.

Issue #18935: Fix test_regrtest.test_timeout when built --without-threads (the
'--timeout' option requires faulthandler.dump_traceback_later).

Issue #18904: test_socket: add inheritance tests using fcntl and FD_CLOEXEC

Issue #18904: Improve os.get/set_inheritable() tests

Close #18957: The PYTHONFAULTHANDLER environment variable now only enables the
faulthandler module if the variable is non-empty. Same behaviour than other
variables like PYTHONDONTWRITEBYTECODE.

Issue #18963: Fix test_selectors.test_above_fd_setsize on OS X, where the
default RLIMIT_NOFILE hard limit can be RLIMIT_INFINITY.

Issue #18934: Use poll/select-based selectors for multiprocessing.Connection,
to avoid one extra FD per Connection.

Put the defines in the logical section and fix indentation.

merge from 3.3

Fix the dead link of IEEE_854-1987 standard with the Wikipedia entry.
Addresses issue #18438

Fix the dead link of IEEE_854-1987 standard with the Wikipedia entry.
Addresses issue #18438

Minor code beautification.

Improve code clarity by removing two unattractive macros.

Remove the freelist scheme for setobjects.

The setobject freelist was consuming memory but not providing much value.
Even when a freelisted setobject was available, most of the setobject
fields still needed to be initialized and the small table still required
a memset().  This meant that the custom freelisting scheme for sets was
providing almost no incremental benefit over the default Python freelist
scheme used by _PyObject_Malloc() in Objects/obmalloc.c.

Merge #18952 fix from 3.3

Issue 18808:  blind attempt to repair some buildbot failures.

test_is_alive_after_fork is failing on some old Linux kernels, but
passing on all newer ones.  Since virtually anything can go wrong
with locks when mixing threads with fork, replace the most likely
cause with a redundant simple data member.

Close #18952: correctly download test support data

When test.support was converted to a package, it started silently
skipping the tests which needed to download support data to run.

This change refactors the affected code, and also tidies up
test.support.findfile to remove the unused *here* parameter, document
the *subdir* parameter and rename the *filename* parameter to avoid
shadowing the file builtin and be consistent with the documentation.

The unexpected skips were noticed and reported by Zachary Ware

merge from 3.3

Correct Profile class usage example. Addresses issue #18033.
Patch contributed by Olivier Hervieu and Dmi Baranov.

Correct Profile class usage example. Addresses issue #18033.
Patch contributed by Olivier Hervieu and Dmi Baranov.

Small rearrangement to bring together the three functions for probing the hash table.

Move the overview comment to the top of the file.

Issue #18808: Thread.join() now waits for the underlying thread state to be destroyed before returning.
This prevents unpredictable aborts in Py_EndInterpreter() when some non-daemon threads are still running.

Fix the merge conflict

merge from 3.3

Fix License URL display and add test to check for license url presence.
Fixes issue #18206 Patch contributed by  Berker Peksag and py.user

Fix License URL display and add test to check for license url presence.
Fixes issue #18206 Patch contributed by  Berker Peksag and py.user

merge from 3.3

Removing the mention of os.isatty mention as Unix only
Correct the wrong documentation.

Removing the mention of os.isatty mention as Unix only
Correct the wrong documentation.

Fix conversion from Py_ssize_t to int.

#18895: merge with 3.3.

#18895: split a sentence in unittest docs.

#18894: merge with 3.3.

#18894: remove mention of deprecated fail* methods.

Added tag v3.4.0a2 for changeset 9265a2168e2c

Version number bump for Python 3.4.0a2.

Update pydoc topic index for Python 3.4.0a2.

Close #18954: Fix some typo in fileutils.c comments

Patch written by Vajrasky Kok.

Added Elazar to Misc/ACKS.

Close #18908: Keep Enum docs in their own section.  Patch by Elazar Gershuni.

Issue #18458: Prevent crashes with newer versions of libedit.  Its readline
emulation has changed from 0-based indexing to 1-based like gnu readline.
Original patch by Ronald Oussoren.

Merge 3.3 into default.

Issue 18944:  fix a 1-character typo in test_set.py.

The error caused test_inline_methods() to test much less than intended.
Caught (& fixed) by Armin Rigo.

Issue 18944:  fix a 1-character typo in test_set.py.

The error caused test_inline_methods() to test much less than intended.
Caught (& fixed) by Armin Rigo.

Remove old-school inheritance

Issue #18934: Relax test_multiprocessing.test_invalid_handles a bit: we just
want to check that Connection.poll() doesn't crash.

Issue #18623: Factor out the _SuppressCoreFiles context manager into test.support.
Patch by Valerie Lambert.

#18852: Handle readline.__doc__ being None in site.py readline activation.

Patch by Berker Peksag.

Close #18924:  Block naive attempts to change an Enum member.

Update whatsnew/3.4 wrt. --version going to stdout. #18338, #18920, #18922

Issue #18920: argparse's default version action (for -v, --version) should
output to stdout, matching the 'python -v'

Reported by Wolfgang Maier

Issue #18849: Fixed a Windows-specific tempfile bug where collision with an
existing directory caused mkstemp and related APIs to fail instead of
retrying. Report and fix by Vlad Shcherbina.

Issue #18849: Fixed a Windows-specific tempfile bug where collision with an
existing directory caused mkstemp and related APIs to fail instead of
retrying. Report and fix by Vlad Shcherbina.

Closes #18941: Merged fix from 3.3.

Issue #18941: Respected delay when doing rollover.

Closes #18940: Merged fix from 3.3.

Issue #18940: Handled low-volume logging when delay is True.

Closes #18939: Merged documentation update from 3.3.

Issue #18939: Updated venv documentation with some clarifications.

Issue #15663: Tcl/Tk 8.5.14 is now included with the OS X 10.6+
64-bit/32-bit installer for 10.6+.  It is no longer necessary
to install a third-party version of Tcl/Tk 8.5 to work around the
problems in the Apple-supplied Tcl/Tk 8.5 shipped in OS X 10.6
and later releases.

Issue #1584: Provide options to override default search paths for Tcl and Tk
when building _tkinter.  configure has two new options; if used, both must
be specified:

  ./configure \
      --with-tcltk-includes="-I/opt/local/include" \
      --with-tcltk-libs="-L/opt/local/lib -ltcl8.5 -ltk8.5"

In addition, the options can be overridden with make:

   make \
       TCLTK_INCLUDES="-I/opt/local/include" \
       TCLTK_LIBS="-L/opt/local/lib -ltcl8.6 -ltk8.6"

merge from 3.3

Improve urlencode docstring. Patch by Brian Brazil.
Closes issue #15350

Improve urlencode docstring. Patch by Brian Brazil.

Nerge 3.3 into default.

Issue #18942: sys._debugmallocstats() output was damaged on Windows.

_PyDebugAllocatorStats() called PyOS_snprintf() with a %zd format
code, but MS doesn't support that code.  Interpolated
PY_FORMAT_SIZE_T in place of the "z".

Issue #18942: sys._debugmallocstats() output was damaged on Windows.

_PyDebugAllocatorStats() called PyOS_snprintf() with a %zd format
code, but MS doesn't support that code.  Interpolated
PY_FORMAT_SIZE_T in place of the "z".

Closes #18933: Merged update from 3.3.

Issue #18933: Added links to source code.

Issue #18934: multiprocessing: use selectors module.

Issue #18672: Fixed format specifiers for Py_ssize_t in debugging output in
the _sre moduel.

Issue #18672: Fixed format specifiers for Py_ssize_t in debugging output in
the _sre moduel.

Issue #18922: Now The Lib/smtpd.py and Tools/i18n/msgfmt.py scripts write
their version strings to stdout, and not to sderr.

Null merge

Merge heads

Merge heads

Issue #18830: inspect.getclasstree() no more produces duplicated entries even
when input list contains duplicates.