merge with 3.4

Prepare sphinx extensions for 1.3.

merge 3.4 (#22528)

add link to pdb source (closes #22528)

Reorganize C API docs of the exception API

Issue #18711: Add a new `PyErr_FormatV` function, similar to `PyErr_Format` but accepting a `va_list` argument.

(Merge 3.4) Issue #22448: asyncio, cleanup _run_once(), only iterate once to
remove delayed calls that were cancelled.

Issue #22448: asyncio, cleanup _run_once(), only iterate once to remove delayed
calls that were cancelled.

remove merge goop from f86fde20e9ce

Remove pointless "vile hack" that can cause the build step to fail when some extension modules can't be imported.

See issue #5309 for the build failures, issue #458343 for the original motivation.

(Merge 3.4) faulthandler: test_gil_released() now uses _sigsegv() instead of
_read_null(), because _read_null() cannot be used on AIX. On AIX, reading from
NULL is allowed: the first page of memory is a mapped read-only on AIX.

_read_null() and _sigabrt() don't accept parameters.

faulthandler: test_gil_released() now uses _sigsegv() instead of _read_null(),
because _read_null() cannot be used on AIX. On AIX, reading from NULL is
allowed: the first page of memory is a mapped read-only on AIX.

faulthandler: _sigsegv() and _sigabrt() don't accept parameters

faulthandler: suppress crash reporter directly in test functions written to
crash.

(Merge 3.4) Issue #22396: On 32-bit AIX platform, don't expose
os.posix_fadvise() nor os.posix_fallocate() because their prototypes in system
headers are wrong.

Issue #22396: On 32-bit AIX platform, don't expose os.posix_fadvise() nor
os.posix_fallocate() because their prototypes in system headers are wrong.

Fix "warning: comparison between signed and unsigned integer expressions"
-Wsign-compare warnings in unicodeobject.c.  These were all a result
of sizeof() being unsigned and being compared to a Py_ssize_t.
Not actual problems.

merge 3.4 (#22520)

merge 3.3 (#22520)

prevent overflow in unicode_repr (closes #22520)

merge 3.4 (#22517)

merge 3.3 (#22517)

clear BufferedRWPair weakrefs on deallocation (closes #22517)

fix windows tests (#16662)

From Robert Collins.

merge 3.4

merge 3.3

these variables ought to be Py_ssize_t

merge 3.4 (#22519)

merge 3.3 (closes #22519)

fix overflow checking in PyBytes_Repr (closes #22519)

merge 3.4 (closes #22518)

merge 3.3 (closes #22518)

NEWS issue for #22518

cleanup overflowing handling in unicode_decode_call_errorhandler and unicode_encode_ucs1 (closes #22518)

Issue #22437: Number of capturing groups in regular expression is no longer
limited by 100.

#17442: Add chained traceback support to InteractiveInterpreter.

Patch by Claudiu Popa.

Issue #22510: Get rid of little overhead of testing re.DEBUG flag.

Merge: #20135: FAQ entry for list mutation.  (See also 90b07d422bd9.)

I accidentally merged this in 90b07d422bd9; this merge addresses the
last review comments on the patch.

#20135: FAQ entry for list mutation.  (See also 6375bf34fff6.)

I accidentally committed this in 6375bf34fff6; this changeset addresses the
last review comments on the patch.

This is a perennial question and something someone opens a ticket for probably
every other month or so, so I'm surprised we didn't already have a FAQ entry
for it.

The original patch was written by M. Votz, refined first by Ezio Melotti and
further refined by me.

Closes issue #20858: Enhancements/fixes to pure-python datetime module

This patch brings the pure-python datetime more in-line with the C
module.  Patch contributed by Brian Kearns, a PyPy developer.  PyPy
project has been running these modifications in PyPy2 stdlib.

This commit includes:

- General PEP8/cleanups;
- Better testing of argument types passed to constructors;
- Removal of duplicate operations;
- Optimization of timedelta creation;
- Caching the result of __hash__ like the C accelerator;
- Enhancements/bug fixes in tests.

merge 3.4 (#22379)

check that exception messages are not empty (#22379)

Patch by Yongzhi Pan.

#10510: Fix bug in forward port of 2.7 distutils patch.

Pointed out by Arfrever.

#10510: Fix bug in forward port of 2.7 distutils patch.

Pointed out by Arfrever.

Removed a code for suport Python version <2.2.

Removed redundant casts to `char *`.
Corresponding functions now accept `const char *` (issue #1772673).

Revert #22251

Revert #22251

Merge: #10510: make distuitls upload/register use HTML standards compliant CRLF.

#10510: make distuitls upload/register use HTML standards compliant CRLF.

Patch by Ian Cordasco, approved by Éric Araujo.

Issue #22251: Fix ReST markup to avoid errors building docs.

Issue #22251: Fix ReST markup to avoid errors building docs.

Merge with 3.4.

Merge heads.

Merge heads.

Issue #16537: Check whether self.extensions is empty in setup.py.

Patch by Jonathan Hosmer.

Merge: #18854: make it explicit that is_multipart does not mean 'multipart/xxx'.

#18854: make it explicit that is_multipart does not mean 'multipart/xxx'.

Original patch (and the idea of using _structure) by Abhilash Raj.

Issue #16537: Check whether self.extensions is empty in setup.py.

Patch by Jonathan Hosmer.

Merge: #20974: Update version table in email intro.

#20974: Update version table in email intro.

Note that the email version string in 3.3 and 3.4 is inaccurate, since it
still exists but wasn't updated while the code was.

Issue #9850: Fixed macpath.join() for empty first component.  Patch by
Oleg Oshmyan.

Issue #9850: Fixed macpath.join() for empty first component.  Patch by
Oleg Oshmyan.

Issue #16324: _charset parameter of MIMEText now also accepts email.charset.Charset instances.

Initial patch by Claude Paroz.

inspect: Fix getsource() to support decorated functions.

Issue #1764286. Patch by Claudiu Popa.

Issue #5309: distutils' build and build_ext commands now accept a ``-j``
option to enable parallel building of extension modules.

null merge

tempfile: Fix docstring. Issue #21397, patch by R. David Murray.

tempfile: Fix docstring. Issue #21397, patch by R. David Murray.

os: Include posix functions in os.__all__. Closes issue #18554.

Patch by Ronald Oussoren.

Issue #17462: Add a paragraph about advantages of argparse over optparse.

Patch by Anastasia Filatova.

Issue #17462: Add a paragraph about advantages of argparse over optparse.

Patch by Anastasia Filatova.

Null merge

asyncio.test_tasks: Fix test_env_var_debug to use correct asyncio module

asyncio.test_tasks: Fix test_env_var_debug to use correct asyncio module

merge 3.4

asyncio: Improve canceled timer handles cleanup. Closes issue #22448.

Patch by Joshua Moore-Oliva.

asyncio: Improve canceled timer handles cleanup. Closes issue #22448.

Patch by Joshua Moore-Oliva.

Issue #18093: fix test_capi test skip due to _testembed move

merge 3.4

asyncio: Reverting 69d474dab479 as issue #21645 is now closed and debug is no longer needed

asyncio.test_events: Partially reverting f7643c893587 to stay in sync with tulip codebase

asyncio.unix_events: Move import statement to match code in tulip

asyncio.unix_events: Move import statement to match tulip code

merge 3.4 (#22484)

allow archives for rc releases to be built (closes #22484)

(Merge 3.4) test_faulthandler: fix typo

test_faulthandler: fix typo

Merge: Apply asyncio Task English fixes to docstrings as well.

Apply asyncio Task English fixes to docstrings as well.

Also fixed the phrasing in a comment.

Merge: Improve English phrasing in asyncio task docs.

Improve English phrasing in asyncio task docs.

Issue #16056: Rename test method in test_statistics to avoid conflict.

Issue #16056: Rename test method in test_statistics to avoid conflict.

Issue #22427: TemporaryDirectory no longer attempts to clean up twice when
used in the with statement in generator.

Issue #22427: TemporaryDirectory no longer attempts to clean up twice when
used in the with statement in generator.

Issue #21860: Correct docstrings of FileIO.seek() and FileIO.truncate() methods.

Patch by Terry Chia.

Issue #21860: Correct docstrings of FileIO.seek() and FileIO.truncate() methods.

Patch by Terry Chia.

Update importlib.h frozen bytecode (changed due to commit c0ca9d32aed4).

#22464: Speed up common Fraction operations by special-casing several
operations for int-type arguments: constructor and equality test.

Also avoid redundant property lookups in addition and subtraction.