merge 3.4 (#21121)

add -Werror=declaration-after-statement only to stdlib extension modules (closes #21121)

Patch from Stefan Krah.

- Merge 3.4

 - Issue #22176: Fix build failure on ARM with -Werror=declaration-after-statement

merge 3.4.

 - Issue #22176: Add src/x86/win32.S for x86 libffi builds.

- Issue #22176: Update the ctypes module's libffi to v3.1.  This release
  adds support for the Linux AArch64 and POWERPC ELF ABIv2 little endian
  architectures.

- Issue #22176: Update the ctypes module's libffi to v3.1.  This release
  adds support for the Linux AArch64 and POWERPC ELF ABIv2 little endian
  architectures.

Issue #22161: Conformed arguments type checks in ctype to actually supported
types.  Corrected error messages about bytes arguments.

Issue #22161: Conformed arguments type checks in ctype to actually supported
types.  Corrected error messages about bytes arguments.

Merge #21777 from 3.4

Issue #21777: separate docs for binary sequence methods

Merge with 3.4

Issue #14105: Stop removing breakpoints from Idle editors.
Move BREAK tag configuration to PyShellEditorWindow.

Closes #22060: Merge with 3.4

Issue #22060: Clean up/simplify test_ctypes, use test discovery

#22170: merge with 3.4.

#22170: avoid printing newlines twice in tutorial example.

Issue #20056: Fixed deprecation warning about bytes path in test_shutil on
Windows.  Path by Vajrasky Kok.

Issue #20056: Fixed deprecation warning about bytes path in test_shutil on
Windows.  Path by Vajrasky Kok.

Null merge with 3.4

add matrix multiplication operator to correct lists (closes #22142)

Issue #22160: Update OpenSSL to 1.0.1i for the Windows build.

Issue #22160: Update OpenSSL to 1.0.1i for the Windows build.

Update prepare_ssl.py script to generate the .asm files.

#22092: merge with 3.4.

#22092: use absolute imports in unittest tests.  Patch by Vajrasky Kok.

Issue #22116: C functions and methods (of the 'builtin_function_or_method' type) can now be weakref'ed.  Patch by Wei Wu.

Issue #5411: Fixed version number.

Issue #5411: Added support for the "xztar" format in the shutil module.

Issue #21975: Fixed crash when using uninitialized sqlite3.Row (in particular
when unpickling pickled sqlite3.Row).  sqlite3.Row is now initialized in the
__new__() method.

Issue #21975: Fixed crash when using uninitialized sqlite3.Row (in particular
when unpickling pickled sqlite3.Row).  sqlite3.Row is now initialized in the
__new__() method.

Move misplaced Misc/NEWS entries to correct locations.
Eliminate deprecated the "Extension Modules" section.

Closes #22146: Merge with 3.4

Issue #22146: Fix typo in __build_class__ error message

Closes #22136: Fix MSVC compiler warnings introduced by #22085

Issue #21972: Make it clear that the PEP 401 future import works,
despite the PEP being rejected.

- Issue #21539: Add a *exists_ok* argument to `Pathlib.mkdir()` to mimic
  `mkdir -p` and `os.makedirs()` functionality.  When true, ignore
  FileExistsErrors.  Patch by Berker Peksag.

(With minor cleanups, additional tests, doc tweaks, etc. by Barry)

Also:

* Remove some unused imports in test_pathlib.py reported by pyflakes.

Issue #22127: fix typo.

Issue #22127: Bypass IDNA for pure-ASCII host names (in particular for numeric IPs).

Issue #22127: Bypass IDNA for pure-ASCII host names (in particular for numeric IPs).

Issue #22120: For functions using an unsigned integer return converter,
Argument Clinic now generates a cast to that type for the comparison
to -1 in the generated code.  (This supresses a compilation warning.)

Closes #22130: Merged documentation update from 3.4.

Issue #22130: Corrected fileConfig() documentation.

More fixes for the unhappy AMD FreeBSD 9 buildbot.  Fingers crossed.

Fix for AMD FreeBSD 9 buildbot (hopefully), broken by my last checkin.

#21928: merge with 3.4.

#21928: clarify functools.wraps docs.

Issue #20170: Convert posixmodule to use Argument Clinic.

#11955: merge with 3.4.

#11955: show the list of args in case of error in test_argparse.

#18034: merge with 3.4.

#18034: update FAQ to suggest importlib.import_module instead of __import__.  Patch by Wouter van Heyst.

Closes #22104: Merge with 3.4

Issue #22104: Don't hold a reference to the loaded TestSuite in runtest_inner

#20977: merge with 3.4.

#20977: fix undefined name in the email module.  Patch by Rose Ames.

#18588: merge with 3.4.

#18588: update the timeit examples to be consistent.

merge

Remove unused leftover stray line

merge

Fix markup.

merge

Improve regex tokenizer example by using re.finditer().

Also, improve variable names and fix column numbers
in the generated output.

Use two-argument form of next() and use a return-statement instead of an explicit raise StopIteration

Make the import private to keep the global namespace clean.

Use reversed() instead of creating a new temporary list.

Merge with 3.4

PEP 8 spacing in idlelib.configDialog: mostly a = b in assignments,
a, b in arg lists, and hanging indents for long arg lists.

Issue #13540: Merge changes from 3.4

Issue #13540: Merge changes from 3.3

Issue #13540: Merge changes from 3.2

Issue #13540: Update references to Action class to match syntax used for other classes in this file.

merge

Fix whitespace in example.

Fix whitespace in example.

#15114, #21047: update whatsnew in Python 3.5.

#21047: set the default value for the *convert_charrefs* argument of HTMLParser to True.  Patch by Berker Peksag.

Add an __all__ to html.entities.

#15114: the strict mode and argument of HTMLParser, HTMLParser.error, and the HTMLParserError exception have been removed.

Issue #22077: Improve index error messages for bytearrays, bytes, lists, and
tuples by adding 'or slices'. Added ', not <typename' for bytearrays.
Original patch by Claudiu Popa.

Issue #22110: Enable extra compilation warnings.

 - update config.guess and config.sub to support openrisc.

 - update config.guess and config.sub to support openrisc.

Issue #18395, #22108: Update embedded Python examples to decode correctly
command line parameters: use Py_DecodeLocale() and PyUnicode_DecodeFSDefault().

Issue #18395: Rename ``_Py_char2wchar()`` to :c:func:`Py_DecodeLocale`, rename
``_Py_wchar2char()`` to :c:func:`Py_EncodeLocale`, and document these
functions.

Issue #21907: Avoid using double quotes to check argument values.

Double quotes in expanded variables can match literal double quotes,
which makes for a big mess when passing in a quoted argument (like
"/p:externalsDir=..\externals", for example).

Issue #21907: Further improvments to build_pgo.bat.  Patch by Ingolf Becker.

Simplify code in multiprocessing.Connection.send_bytes().
Followup to issue #20540; patch by Serhiy.

Issue #22111: Assorted cleanups in test_imaplib.  Patch by Milan Oberkirch.

timemodule.c: Replace PyExc_IOError with PyExc_OSError

Back out of changes to Tkinter variables trace commands (issue #22085).

Merge with 3.4

Issue #22068: Don't create self reference cycles in idlelib.ConfigDialog.

Issue #22085: Dropped support of Tk 8.3 in Tkinter.

Issue #21580: Now Tkinter correctly handles bytes arguments passed to Tk.
In particular this allows to initialize images from binary data.

Issue #21580: Now Tkinter correctly handles bytes arguments passed to Tk.
In particular this allows to initialize images from binary data.

Issue #22018: Fix test_signal: use assertEqual() not assertIs()

Issue #21951: Temporary skip crashing test_user_command on AIX.