Address reviews for open’s opener argument doc patch (#13424).

* Remove example deemed not helpful.
* Simplify the other one.
* Add missing target to ref.

Null merge with 3.2.

Remove unused variabile "plain" in builtin_exec.

Null merge from 3.2.

Fix label in docs (from issue #13538).

Improve str() and object.__str__() documentation (issue #13538).

Null merge from 3.2 (issue #13538).

Improve str() and object.__str__() documentation (issue #13538).

null merge

Do a better job of preserving the state of sys.modules.

Do a better job of ensuring test reproducibility and clean up.

Merge test from issue #1160.

Issue #1160: Fix compiling large regular expressions on UCS2 builds.
Patch by Serhiy Storchaka.

- Issue #16514: Fix regression causing a traceback when sys.path[0] is None
  (actually, any non-string or non-bytes type).

Fix typo in multiprocessing documentation, thanks to Dmitry Tolstoy from docs@

Backport 9dd4638de73b.

#7782: merge with 3.2.

#7782: add a test for test_iter.

The poplib module provides two classes, not one.

The poplib module provides two classes, not one.

#16306: merge with 3.2.

#16306: Fix multiple error messages when unknown command line parameters where passed to the interpreter.  Patch by Hieu Nguyen.

#14313: null merge.

#14313: zipfile now raises NotImplementedError when the compression type is unknown.

#16053: merge with 3.2.

#16053: document csv.Dialect.strict.  Patch by Kushal Das.

Merge typo fix from 3.2.

Typo fix.

Issue #12005: merge doc patch from 3.2

Issue #12005: clarify behaviour of % and // for Decimal objects.

Issue #16408: Fix file descriptors not being closed in error conditions in the zipfile module.
Patch by Serhiy Storchaka.

Issue #16408: Fix file descriptors not being closed in error conditions in the zipfile module.
Patch by Serhiy Storchaka.

Issue #16215: Fix potential double memory free in str.replace().
Patch by Serhiy Storchaka.

#16157: fix links in the whatsnew files.

#16420: merge with 3.2.

#16420: document a way to escape metacharacters in glob/fnmatch.

Issue #16489: Make it clearer that importlib.find_loader() requires
the user to import any parent packages.

Merge updates about dir() with 3.2.

Update section about dir() in the tutorial.

Merge rephrasing with 3.2.

Rephrase a sentence in the set and dict comprehensions tutorial page.

MERGE: Closes #16461: Wave library should be able to deal with 4GB wav files, and sample rate of 44100 Hz.

Closes #16461: Wave library should be able to deal with 4GB wav files, and sample rate of 44100 Hz.

#16478: merge with 3.2.

#16478: use floor division in tabnanny and fix a ResourceWarning.  Patch by Serhiy Storchaka.

Issue #16481: multiprocessing no longer leaks process handles on Windows.

Issue #16144: Fix misleading sentence in reference/import.

Patch by Manuel Pégourié-Gonnard

merge 3.2

don't gc_collect on CPython to guarantee a lack of ref cycles (thanks Antoine)

Merge from 3.2: update the PyPI docs regarding listing versions (issue #16400).

Update the description of which package versions PyPI displays (issue #16400).

Issue #16378: Updated docstrings to reflect the defaults present in the code.

merge 3.2

add gc_collects to weakref tests

recompile importlib.h

missing letter

Issue #15835: Define PATH_MAX on HP-UX.

Issue #16218, #16444: Backport improvment on tests for non-ASCII characters

Add a test for hashing of unaligned memory buffers (from issue #16427).

Merge heads

Merge heads

Issue #16453: Fix equality testing of dead weakref objects.
Also add tests for ordering and hashing.

Issue #16453: Fix equality testing of dead weakref objects.
Also add tests for ordering and hashing.

Refactor test_preexec_errpipe to not create an uncollectable reference cycle.

Refactor test_preexec_errpipe to not create an uncollectable reference cycle.

Issue #15677: Document that zlib and gzip accept a compression level of 0 to mean 'no compression'.

Patch by Brian Brazil.

Issue #15677: Document that zlib and gzip accept a compression level of 0 to mean 'no compression'.

Patch by Brian Brazil.

Fixes issue #16140: The subprocess module no longer double closes its
child subprocess.PIPE parent file descriptors on child error prior to
exec().

This would lead to race conditions in multithreaded programs where
another thread opened a file reusing the fd which was then closed out
from beneath it by the errant second close.

Fixes issue #16140: The subprocess module no longer double closes its
child subprocess.PIPE parent file descriptors on child error prior to
exec().

This would lead to race conditions in multithreaded programs where
another thread opened a file reusing the fd which was then closed out
from beneath it by the errant second close.

Remove the subprocess "bad exception data" warning (formerly a print!)
all together and just include the repr of the data in the exception
itself instead of the useless string "Unknown".

This code path is unlikely to even be possible to take given the
nature of the pipe it gets subprocess data from.

Remove the subprocess "bad exception data" warning (formerly a print!)
all together and just include the repr of the data in the exception
itself instead of the useless string "Unknown".

This code path is unlikely to even be possible to take given the
nature of the pipe it gets subprocess data from.

Rename a local variable for readability and change a "this can't
happen" print() call into a RuntimeWarning as it should've been in the
first place.  Because nothing should ever cause unexpected stdout output.

Rename a local variable for readability and change a "this can't
happen" print() call into a RuntimeWarning as it should've been in the
first place.  Because nothing should ever cause unexpected stdout output.

Fixes issue #16327: The subprocess module no longer leaks file descriptors
used for stdin/stdout/stderr pipes to the child when fork() fails.

Fixes issue #16327: The subprocess module no longer leaks file descriptors
used for stdin/stdout/stderr pipes to the child when fork() fails.

null merge

move note to the right section

Fixes issue #14396: Handle the odd rare case of waitpid returning 0
when not expected in subprocess.Popen.wait().

Fixes issue #14396: Handle the odd rare case of waitpid returning 0 when
not expected in subprocess.Popen.wait().

Fixes issue #9535: Fix pending signals that have been received but not
yet handled by Python to not persist after os.fork() in the child process.

Fixes issue #9535: Fix pending signals that have been received but not
yet handled by Python to not persist after os.fork() in the child process.

Issue #16411: Fix a bug where zlib.decompressobj().flush() might try to access previously-freed memory.

Patch by Serhiy Storchaka.

Issue #16411: Fix a bug where zlib.decompressobj().flush() might try to access previously-freed memory.

Patch by Serhiy Storchaka.

Issue #16350, part 2: Set unused_data (and unconsumed_tail) correctly in decompressobj().flush().

Additionally, fix a bug where a MemoryError in allocating a bytes object could
leave the decompressor object in an invalid state (with its unconsumed_tail
member being NULL).

Patch by Serhiy Storchaka.

Issue #16350, part 2: Set unused_data (and unconsumed_tail) correctly in decompressobj().flush().

Additionally, fix a bug where a MemoryError in allocating a bytes object could
leave the decompressor object in an invalid state (with its unconsumed_tail
member being NULL).

Patch by Serhiy Storchaka.

Issue #16357: fix calling accept() on a SSLSocket created through SSLContext.wrap_socket().
Original patch by Jeff McNeil.

Issue #16357: fix calling accept() on a SSLSocket created through SSLContext.wrap_socket().
Original patch by Jeff McNeil.

Fix test_urllib broken by my previous commits.  The assumptions it was
testing were added as part of the issue10050 change that caused the
wrong behavior in the first place.  now all test cases agree on the
behavior.

Accept Unicode legacy strings in the Decimal constructor.

Fixes issue #16409: The reporthook callback made by the legacy
urllib.request.urlretrieve API now properly supplies a constant
non-zero block_size as it did in Python 3.2 and 2.7.  This matches the
behavior of urllib.request.URLopener.retrieve.

Merge from 3.2: adjust set and frozenset function docs (issue #16436).

Link set and frozenset function docs to their class definitions (issue #16436).

Merge from 3.2: improve FAQ link in documentation (for issue #16435).

Improve FAQ link in documentation (for issue #16435).

#13301: merge with 3.2.

#13301: use ast.literal_eval() instead of eval() in Tools/i18n/msgfmt.py.  Patch by Serhiy Storchaka.

#16440: merge with 3.2.

#16440: fix exception type and clarify example.

Merge issue #16439: Fix markup in example for stdtypes.

Thanks to Yongzhi Pan.

Issue #16439: Fix markup in example for stdtypes.

Thanks to Yongzhi Pan.