bpo-38158: Removing nonexistant member "doc" from PyType_Spec documentation (GH-16142) (GH-16154)

(cherry picked from commit 8b31a11a698cb5aa9b439b349c8de4e388846f73)

Co-authored-by: t k <tahia.khan@utoronto.ca>

bpo-37635: Update arg name for seek() in IO tutorial (GH-16147)

Typically, the second positional argument for ``seek()`` is *whence*. That is the POSIX standard name (http://man7.org/linux/man-pages/man3/lseek.3p.html) and the name listed in the documentation for ``io`` module (https://docs.python.org/3/library/io.htmlGH-io.IOBase.seek).

The tutorial for IO is the only location where the second positional argument for ``seek()`` is referred to as *from_what*. I suspect this was created at an early point in Python's history, and was never updated (as this section predates the GitHub repository):

```
$ git grep "from_what"
Doc/tutorial/inputoutput.rst:To change the file object's position, use ``f.seek(offset, from_what)``.  The position is computed
Doc/tutorial/inputoutput.rst:the *from_what* argument.  A *from_what* value of 0 measures from the beginning
Doc/tutorial/inputoutput.rst:the reference point.  *from_what* can be omitted and defaults to 0, using the
```

For consistency, I am suggesting that the tutorial be updated to use the same argument name as the IO documentation and POSIX standard for ``seek()``, particularly since this is the only location where *from_what* is being used.

Note: In the POSIX standard, *whence* is technically the third positional argument, but the first argument *fildes* (file descriptor) is implicit in Python.

https://bugs.python.org/issue37635
(cherry picked from commit ff603f6c3d3dc0e9ea8c1c51ce907c4821f42c54)

Co-authored-by: Kyle Stanley <aeros167@gmail.com>

[3.8] bpo-38005: Fixed comparing and creating of InterpreterID and ChannelID. (GH-15652) (GH-16145)

* Fix a crash in comparing with float (and maybe other crashes).
* They are now never equal to strings and non-integer numbers.
* Comparison with a large number no longer raises OverflowError.
* Arbitrary exceptions no longer silenced in constructors and comparisons.
* TypeError raised in the constructor contains now the name of the type.
* Accept only ChannelID and int-like objects in channel functions.
* Accept only InterpreterId, int-like objects and str in the InterpreterId constructor.
* Accept int-like objects, not just int in interpreter related functions.
(cherry picked from commit bf169915ecdd42329726104278eb723a7dda2736)

[3.8] bpo-37206: Unrepresentable default values no longer represented as None. (GH-13933) (GH-16141)

In ArgumentClinic, value "NULL" should now be used only for unrepresentable default values
(like in the optional third parameter of getattr). "None" should be used if None is accepted
as argument and passing None has the same effect as not passing the argument at all.
(cherry picked from commit 279f44678c8b84a183f9eeb85e0b086228154497)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

bpo-37953: Fix deprecation warnings in test_typing (GH-16133)

self.assertEquals() is deprecated.

```
./python -We -m test test_typing
Run tests sequentially
0:00:00 load avg: 0.23 [1/1] test_typing
test test_typing failed -- Traceback (most recent call last):
  File "/home/lubuntu2/cpython/Lib/test/test_typing.py", line 2382, in test_forward_equality_gth
    self.assertEquals(Union[c1, c1_gth], Union[c1])
  File "/home/lubuntu2/cpython/Lib/unittest/case.py", line 1390, in deprecated_func
    warnings.warn(
DeprecationWarning: Please use assertEqual instead.

test_typing failed

== Tests result: FAILURE ==

1 test failed:
    test_typing

Total duration: 140 ms
Tests result: FAILURE
```

https://bugs.python.org/issue37953
(cherry picked from commit d057b896f97e6d7447b9bf9246770c41cf205299)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>

[3.8] Doc: Fix link to window.getch in curses documentation (GH-16132) (GH-16135)

(cherry picked from commit a26ace19bddea2d7a999a6de8286b3f27b132f35)

Co-authored-by: Anthony Sottile <asottile@umich.edu>

bpo-37953: Fix ForwardRef hash and equality checks (GH-15400)

Ideally if we stick a ForwardRef in a dictionary we would like to reliably be able to get it out again.

https://bugs.python.org/issue37953
(cherry picked from commit e082e7cbe4a934b86f7a07354d97d4e14a9dd46a)

Co-authored-by: plokmijnuhby <39633434+plokmijnuhby@users.noreply.github.com>

Fix typo in test_api.py. (GH-16119)

(cherry picked from commit 0bc17ea2f5966f429b5b8d6b4ccb9c01f1f610d0)

Co-authored-by: Benjamin Peterson <benjamin@python.org>

bpo-34706: Preserve subclassing in inspect.Signature.from_callable (GH-16108) (GH-16113)

https://bugs.python.org/issue34706

Specifically in the case of a class that does not override its
constructor signature inherited from object.

These are Buck Evan @bukzor's changes cherrypicked from GH-9344.
(cherry picked from commit 5b9ff7a0dcb16d6f5c3cd4f1f52e0ca6a4bde586)

Co-authored-by: Gregory P. Smith <greg@krypto.org>

Doc: fcntl.lockf() is more powerful than written (GH-6750)

(cherry picked from commit 77cd0ceab2f6c1696fb1d31115c2f880b2e21934)

Co-authored-by: Eric O. LEBIGOT (EOL) <lebigot@users.noreply.github.com>

bpo-32790: Add info about alt format using GH- for 'g' in chart (GH-6624)

(cherry picked from commit d44542f9a231bf725ecd82eb640a672c759a8227)

Co-authored-by: bchhabra2490 <bchhabra2490@gmail.com>

[3.8] bpo-38150: Fix refleak in the finalizer of a _testcapimodule type (GH-16115) (GH-16118)

The PyLong created in the finalizer was not being cleaned up

https://bugs.python.org/issue38150

Automerge-Triggered-By: @matrixise
(cherry picked from commit a67ac2f2d9550e5a36d28f9b6eeacf6575dda2d5)

Co-authored-by: Eddie Elizondo <eelizondo@fb.com>

bpo-38092: Reduce overhead when using multiprocessing in a Windows virtual environment (GH-16098)

https://bugs.python.org/issue38092
(cherry picked from commit f2b7556ef851ac85e7cbf189d1b29fdeb9539b88)

Co-authored-by: Steve Dower <steve.dower@python.org>

bpo-37199: Replace the early returns added in c2cda63. (GH-14535)

(cherry picked from commit 81319a81b2a3f42fe1047c2e6f5fd958faab6cdb)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>

Run autoreconf. (GH-16106)

(cherry picked from commit f3095b0b58ad9d59cf221bb6498f5aa673c0b25a)

Co-authored-by: Benjamin Peterson <benjamin@python.org>

bpo-25068: urllib.request.ProxyHandler now lowercases the dict keys (GH-13489)

(cherry picked from commit b761e3aed1fbada4572a776f6a0d3c4be491d595)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>

closes bpo-36002: Use AC_PATH_TOOL to find llvm-profdata and llvm-ar. (GH-14998)

(cherry picked from commit 0519d497b04b252f50dfff9101fb7f4b9e33f1c4)

Co-authored-by: Doyle Rowland <doyle.rowland@reliaqual.com>

bpo-26468: Doc: improve the documentation of shutil.copy2 when it can fail. (GH-13765)

(cherry picked from commit 9585f46b97931d2640c3343dfe03aed15beb9fea)

Co-authored-by: Windson yang <wiwindson@outlook.com>

[3.8] bpo-38148: Add slots to asyncio transports (GH-16077) (GH-16093)

* bpo-38148: Add slots to asyncio transports

* Update Misc/NEWS.d/next/Library/2019-09-13-08-55-43.bpo-38148.Lnww6D.rst

Co-Authored-By: Kyle Stanley <aeros167@gmail.com>
(cherry picked from commit 9eb35ab0d71a6bd680e84fa0f828cb634e72b681)

Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com>

bpo-29986: Doc: Delete tip to raise TypeError from tp_richcompare. (GH-16095)

(cherry picked from commit 375a3e2bdbeb4dce69aba4b5bc90f55fe27e81b4)

Co-authored-by: Julien Palard <julien@palard.fr>

Doc: Improve consistency of os.path.normcase with other os.path functions (GH-14004)

(cherry picked from commit 53f78ec9e181f544b1a4575f32d42e296e05e4b4)

Co-authored-by: Kexuan Sun <me@kianasun.com>

bpo-12144: Handle cookies with expires attribute in CookieJar.make_cookies (GH-13921)

Handle time comparison for cookies with `expires` attribute when `CookieJar.make_cookies` is called.

Co-authored-by: Demian Brecht <demianbrecht@gmail.com>
https://bugs.python.org/issue12144

Automerge-Triggered-By: @asvetlov
(cherry picked from commit bb41147eab15a2958f4ad38261e5bf608f6ace1b)

Co-authored-by: Xtreak <tir.karthi@gmail.com>

bpo-36889: Document Stream class and add docstrings (GH-14488)

* This just copies the docs from `StreamWriter` and `StreamReader`.
* Add docstring for asyncio functions.

https://bugs.python.org/issue36889

Automerge-Triggered-By: @asvetlov
(cherry picked from commit d31b31516c71890e8735606aec1dbf2bfb8fd6be)

Co-authored-by: Xtreak <tir.karthi@gmail.com>

Fix the ImportWarning regarding __spec__ and __package__ being None (GH-16003)

(cherry picked from commit 6e1a30b15e73ebc82e6790495fd54cc8971723ec)

Co-authored-by: Xtreak <tir.karthi@gmail.com>

bpo-37785: Fix xgettext warning in argparse (GH-15161)

(cherry picked from commit 42671aea2db6cbc54369617da0fd3545048e0a45)

Co-authored-by: Jakub Kulík <Kulikjak@gmail.com>

bpo-38133: Allow py.exe launcher to locate installations from the Microsoft Store (GH-16025)

(cherry picked from commit ed93a8852d120c5a3606720edc723bf5aa6a1fc2)

Co-authored-by: Steve Dower <steve.dower@python.org>

Emphasize the need to always call PySequence_Fast. (GH-11140)

(cherry picked from commit 57b7dbc46e71269d855e644d30826d33eedee2a1)

Co-authored-by: Matti Picus <matti.picus@gmail.com>

closes bpo-37803: pdb: fix handling of options (--help / --version) (GH-15193)

The "--" should not be included with long options passed to
getopt.getopt.

Fixes https://bugs.python.org/issue37803
(cherry picked from commit 855df7f273c3988c72f01e51ba57091887ec38b2)

Co-authored-by: Daniel Hahler <github@thequod.de>

bpo-37908: Add an example of ArgumentParser.exit() (GH-15455)

Co-Authored-By: Brandt Bucher <brandtbucher@gmail.com>
(cherry picked from commit b1a2abdb06408ffc4f13d6ff50351ad49c99afc0)

Co-authored-by: Hai Shi <shihai1992@gmail.com>

[3.8] bpo-38121: Sync importlib.metadata with 0.22 backport (GH-15993) (GH-16064)

* bpo-38121: Sync importlib.metadata with 0.22 backport

* 📜🤖 Added by blurb_it..
(cherry picked from commit 8ed6503eca4e3ea4949479d8d7fd9ffd54f81038)

Co-authored-by: Jason R. Coombs <jaraco@jaraco.com>

bpo-38096:  Complete the "structseq" and "named tuple" cleanup (GH-16010) (GH-16062)

(cherry picked from commit 4210ad5ebd5769f585035e022876e161cd0e9a3e)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>

bpo-37935: Added tests for os.walk(), glob.iglob() and Path.glob() (GH-15956) (GH-16043)

Test that they do not keep too many file descriptors open for the host OS in a reasonable test scenario.

See [bpo-37935](https://bugs.python.org/issue37935).
(cherry picked from commit f9dc2ad89032201427ed5f08061c703794627ad9)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

[3.8] bpo-38137: Re-add OpenSSL 1.0.2 compat (GH-16051) (GH-16057)

The defines are required for OpenSSL 1.0.2 and LibreSSL.

https://bugs.python.org/issue38134

Automerge-Triggered-By: @tiran
(cherry picked from commit 9a4963b932a087b78596cca0b8394ac898faa490)

Co-authored-by: Christian Heimes <christian@python.org>
https://bugs.python.org/issue38137

Automerge-Triggered-By: @matrixise

bpo-37488 : Document a warning for datetime.utcnow() and utcfromtimestamp() (GH-15773)

https://bugs.python.org/issue37488

Automerge-Triggered-By: @pganssle
(cherry picked from commit 1a53c785e62e00bad87ae19466c3a32ebcebb915)

Co-authored-by: Joannah Nanjekye <33177550+nanjekyejoannah@users.noreply.github.com>

bpo-21872: fix lzma library decompresses data incompletely (GH-14048)

* 1. add test case with wrong behavior
* 2. fix bug when max_length == -1
* 3. allow b"" as valid input data for decompress_buf()
* 4. when max_length >= 0, let needs_input mechanism works
* add more asserts to test case
(cherry picked from commit 4ffd05d7ec47cfd0d7fc95dce851633be9663255)

Co-authored-by: animalize <animalize@users.noreply.github.com>

Overhaul datetime documentation (GH-13410)

This is a restructuring of the datetime documentation to hopefully make
them more user-friendly and approachable to new users without losing any
of the detail.

Changes include:
 - Creating dedicated subsections for some concepts such as:
    - "Constants"
    - "Naive vs Aware"
    - "Determining if an Object is Aware"
 - Give 'naive vs aware' its own subsection
 - Give 'constants' their own subsection
 - Overhauling the strftime-strptime section by:
    - Breaking it into logical, linkable, and digestable parts
    - Adding a high-level comparison table
    - Moving the technical detail to bottom: readers come to this
      section primarily to remind themselves to things:
      - How do I write the format code for X?
      - strptime/strftime: which one is which again?
 - Touching up fromisoformat + isoformat sections by:
    - Revising fromisoformat + isoformat for date, time, and
      datetime
    - Adding basic examples
    - Enforcing consistency about putting formats (i.e. ``HH:MM``)
      in double backticks.  This was previously done in some places
      but not all
    - Putting long 'supported formats', on their own line to improve
      readability
 - Moving the 'seealso' section to the top and add a link to dateutil
    Rationale: This doesn't really belong nested under the
    'constants' section.  Let readers know right away that
    datetime is one of several related tools.
 - Moving common features of several types into one place:
    Previously, each type went out of its way to note separately
    that it was hashable and picklable.  These can be brought
    into one single place that is more prominent.
 - Reducing some verbose explanations to improve readability
 - Breaking up long paragraphs into digestable chunks
 - Displaying longer "equivalent to" examples, as short code blocks
 - Using the dot notation for datetime/time classes:
    Use :class:`.time` and :class:`.datetime` rather than :class:`time` and
    :class:`datetime`; otherwise, the generated links will route to the
    respective modules, not classes.
 - Rewording the tzinfo class description
    The top paragraph should get straight to the point of telling the reader
    what subclasses of tzinfo _do_.  Previously, that was hidden in a later
    paragraph.
 - Adding a note on .today() versus .now()
 - Rearranging and expanding example blocks, including:
    - Moved long, multiline inline examples to standalone examples
    - Simplified the example block for timedelta arithmetic:
        - Broke the example into two logical sections:
          1. normalization/parameter 'merging'
          2. timedelta arithmetic
        - Reduced the complexity of the some of the examples.  Show
          reasonable, real-world uses cases that are easy to follow
          along with and progres in difficult slightly.
    - Broke up the example sections for date and datetime sections by putting
      the easy examples first, progressing to more esoteric situations and
      breaking it up into logical sections based on what the methods are
      doing at a high level.
    - Simplified the KabulTz example:
        - Put the class definition itself into a non-REPL block since there is
          no interactive output involved there
        - Briefly explained what's happening before launching into the code
        - Broke the example section into visually separate chunks
 - Various whitespace, formatting, style and grammar fixes including:
    - Consistently using backctics for 'date_string' formats
    - Consistently using one space after periods.
    - Consistently using bold for vocab terms
    - Consistently using italics when referring to params:
      See https://devguide.python.org/documenting/GH-id4
    - Using '::' to lead into code blocks
        Per https://devguide.python.org/documenting/GH-source-code, this will
        let the reader use the 'expand/collapse' top-right button for REPL
        blocks to hide or show the prompt.
    - Using consistent captialization schemes
    - Removing use of the default role
    - Put 'example' blocks in Markdown subsections

This is a combination of 66 commits.

See bpo-36960: https://bugs.python.org/issue36960
(cherry picked from commit 3fb1363fe87a24cdb2ee1dd9746f1c49046af958)

Co-authored-by: Brad <brad.solomon.1124@gmail.com>

bpo-36991: Fix incorrect exception escaping ZipFile.extract() (GH-13632)

(cherry picked from commit 2f1b857562b0f1601c9019db74c29b7d7e21ac9f)

Co-authored-by: Berker Peksag <berker.peksag@gmail.com>

bpo-38132: Check EVP_DigestUpdate for error (GH-16041)

(cherry picked from commit 8c74574e0aaf1a00719fbc9acbdc27a3923520aa)

Co-authored-by: Christian Heimes <christian@python.org>

bpo-37363: Document internal audit events (GH-14663)

Three internal cpython events were not documented, yet.

Signed-off-by: Christian Heimes <christian@python.org>
https://bugs.python.org/issue37363
(cherry picked from commit ed4b3216e59df4806e5ef63b3357fc577a9443d7)

Co-authored-by: Christian Heimes <christian@python.org>

bpo-38132: Simplify _hashopenssl code (GH-16023) (#16040)

Signed-off-by: Christian Heimes <christian@python.org>
(cherry picked from commit 5a4f82f457049b5b07b6fba4ca42bc1ecf597976)

Co-authored-by: Christian Heimes <christian@python.org>

bpo-36373: Deprecate explicit loop in task and subprocess API (GH-16033)

(cherry picked from commit a488879cbaf4b8b52699cadccf73bb4c271bcb29)

Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com>

bpo-26868: Fix example usage of PyModule_AddObject. (GH-15725)

* Add a note to the PyModule_AddObject docs.

* Correct example usages of PyModule_AddObject.

* Whitespace.

* Clean up wording.

* 📜🤖 Added by blurb_it.

* First code review.

* Add < 0 in the tests with PyModule_AddObject
(cherry picked from commit 224b8aaa7e8f67f748e8b7b6a4a77a25f6554651)

Co-authored-by: Brandt Bucher <brandtbucher@gmail.com>

bpo-35325: Doc: imp.find_module() return value documentation discrepancy (GH-11040)

(cherry picked from commit 967b84c913c7b09ae2fc86272cb9373415e2beaf)

Co-authored-by: Windson yang <wiwindson@outlook.com>

bpo-38134: Remove PKBDF2_HMAC_fast from _hashopenssl (GH-16028)

Signed-off-by: Christian Heimes <christian@python.org>
(cherry picked from commit 64117e059b79236c7345bc9afc1cc707162411de)

Co-authored-by: Christian Heimes <christian@python.org>

bpo-35685: Add examples of unittest.mock.patch.dict usage (GH-11456)

(cherry picked from commit 31a82e25b6044a5b5ee25246bad3eb7b873cf5ec)

Co-authored-by: Emmanuel Arias <emmanuelarias30@gmail.com>

bpo-36675: Remove obsolete code. (GH-16024)

Does no longer work since Sphinx moved the trim_doctest_flag option in
the configuration.
(cherry picked from commit 2c910c1e732c9a3ec4c67a7c43d789d6c729304a)

Co-authored-by: Julien Palard <julien@palard.fr>

[3.8] bpo-32008: Prefer client or TLSv1_2 in examples (GH-5797) (GH-16027)

Prefer client or TLSv1_2 in examples

Signed-off-by: Christian Heimes <christian@python.org>
(cherry picked from commit 894d0f7d5542ee04556ec1bee8c58506f7c916d4)

Co-authored-by: Christian Heimes <christian@python.org>

bpo-38110: Use fdwalk for os.closerange() when available. (GH-15224)

Use fdwalk() on platforms that support it to implement os.closerange().
(cherry picked from commit e20134f889a0cfcc37a46979f31a1c98b800de07)

Co-authored-by: Jakub Kulík <Kulikjak@gmail.com>

bpo-37972: unittest.mock._Call now passes on __getitem__ to the __getattr__ chaining so that call() can be subscriptable (GH-15565) (GH-15965)

* bpo-37972: unittest.mock._Call now passes on __getitem__ to the __getattr__ chaining so that call() can be subscriptable

* 📜🤖 Added by blurb_it.

* Update 2019-08-28-21-40-12.bpo-37972.kP-n4L.rst

added name of the contributor

* bpo-37972: made all dunder methods chainable for _Call

* bpo-37972: delegate only attributes of tuple instead to __getattr__
(cherry picked from commit 72c359912d36705a94fca8b63d80451905a14ae4)

Co-authored-by: blhsing <github@ydooby.com>

closes bpo-37405: Make socket.getsockname() always return a tuple for AF_CAN. (GH-14392) (GH-16018)

This fixes a regression from 3.5. In recent releases, `getsockname()` in the AF_CAN case has returned a string.
(cherry picked from commit 954900a3f98a8c0dea14dd575490237f3f8626b3)

Co-authored-by: bggardner <brent@ebrent.net>

bpo-38008: Move builtin protocol whitelist to mapping instead of list (GH-15647)

Fixes https://bugs.python.org/issue38008
(cherry picked from commit 692a0dc91597b7fb350383b633dc4d044cbd360e)

Co-authored-by: Divij Rajkumar <drajkuma1@gmail.com>

bpo-13927: time.ctime and time.asctime return string explantion (GH-11303)

* bpo-13927: time.ctime and time.asctime return string explantion

* Add note explaining that time.ctime and time.asctime returns a space padded date value in case it contains a single digit date

* Reformat linebreaks
(cherry picked from commit 2d32bf1ef23c9e468b2e8afab3c24e7a2047ac36)

Co-authored-by: Harmandeep Singh <harmandeep.singh1@delhivery.com>

closes bpo-38127: _ctypes: PyObject_IsSubclass() should be checked for failure. (GH-16011)

An exception may occur during a PyObject_IsSubclass() call.
(cherry picked from commit ea683deccc505a78bbbb1eb8c6a88b0835ad5151)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>

[3.8] bpo-37879: Suppress subtype_dealloc decref when base type is a C heap type (GH-15323, GH-16004) (GH-15966)

The instance destructor for a type is responsible for preparing
an instance for deallocation by decrementing the reference counts
of its referents.

If an instance belongs to a heap type, the type object of an instance
has its reference count decremented while for static types, which
are permanently allocated, the type object is unaffected by the
instance destructor.

Previously, the default instance destructor searched the class
hierarchy for an inherited instance destructor and, if present,
would invoke it.

Then, if the instance type is a heap type, it would decrement the
reference count of that heap type.  However, this could result in the
premature destruction of a type because the inherited instance
destructor should have already decremented the reference count
of the type object.

This change avoids the premature destruction of the type object
by suppressing the decrement of its reference count when an
inherited, non-default instance destructor has been invoked.

Finally, an assertion on the Py_SIZE of a type was deleted.  Heap
types have a non zero size, making this into an incorrect assertion.

https://github.com/python/cpython/pull/15323.
(cherry picked from commit ff023ed36ea260ab64be5895f1f1f087c798987a)
Fixup: https://github.com/python/cpython/pull/16004.
(cherry picked from commit 5e9caeec76119a0d61c25f1466c27b7dbd5115bd)

Co-authored-by: Eddie Elizondo <eduardo.elizondorueda@gmail.com>

Doc: Update pickle.rst (GH-14128) (GH-16014)

* Edits for readability and grammar
(cherry picked from commit 362f5350eb5e2c7bfb0b0a8c306a2e128c3aee93)

Co-authored-by: Géry Ogam <gery.ogam@gmail.com>

bpo-38096: Clean up the "struct sequence" / "named tuple" docs (GH-15895) (GH-15961)

closes bpo-38124: Fix bounds check in PyState_AddModule. (GH-16007)

The >=, checking whether a module index was in already in the module-by-index list, needed to be strict.

Also, fold nested ifs into one and fix some bad spacing.
(cherry picked from commit 39de95b746c990e6a2fe9af5fad01747f58b2e5f)

Co-authored-by: Benjamin Peterson <benjamin@python.org>

Correct typo in min version test (GH-16001)

Signed-off-by: Christian Heimes <christian@python.org>
(cherry picked from commit de606ea169435fe4dd40dc3e3b2b591e11396a14)

Co-authored-by: Christian Heimes <christian@python.org>

bpo-36270: Doc: add link to traceback object reference (GH-13119)

(cherry picked from commit 9936371af298d465095ae70bc9c2943b4b16eac4)

Co-authored-by: Björn Meier <bjoern@opentrash.org>

bpo-34001: Fix test_ssl with LibreSSL (GH-13783) (#15997)

(cherry picked from commit c9bc49c5f6e26a7c958307c2ac338951a7534d9a)

Co-authored-by: Christian Heimes <christian@python.org>

Improve clarity of try-return-finally-return (GH-15677) (GH-15981)

Clarify execution in try-return-finally-return case.
(cherry picked from commit 0cc27417f2cd399c432d7dda9aeca1d81af76936)

Co-authored-by: toonarmycaptain <toonarmycaptain@hotmail.com>

[3.8] bpo-37698: Update doc of PyBuffer_ToContiguous (GH-14992) (GH-15999)

https://bugs.python.org/issue37698
(cherry picked from commit 15f5a7527b87e11fcf23069c147fd4cb7d42cfb0)

Co-authored-by: Hai Shi <shihai1992@gmail.com>

Doc: recursive glob ** follows symlinks to directories (GH-12918)

(cherry picked from commit e24594bfe75aff3e654665cb940ddc4d4acffd2f)

Co-authored-by: Marc <Marc.Herbert+github@gmail.com>

bpo-37750: Add doc of PyBuffer_FromContiguous (GH-15988) (GH-15990)

https://bugs.python.org/issue37750

Automerge-Triggered-By: @matrixise
(cherry picked from commit 5a56ce4a0e820fefcd598b94715a7ff7e199858d)

Co-authored-by: Hai Shi <shihai1992@gmail.com>

bpo-38117: Test with OpenSSL 1.1.1d (GH-15983)

Signed-off-by: Christian Heimes <christian@python.org>
(cherry picked from commit 58ab13479d854491ac9207bacfae25e8b18b044a)

Co-authored-by: Christian Heimes <christian@python.org>

bpo-36528: Remove duplicate re tests. (GH-2689)

Co-Authored-By: Makdon <makdon@makdon.me>
(cherry picked from commit e6557d3c62800f51ee6530c94a10b93d725504fa)

Co-authored-by: Xtreak <tir.karthi@gmail.com>

Doc: Fix missing negation. (GH-14640)

Reported by Hug Capella on docs@.

Automerge-Triggered-By: @matrixise
(cherry picked from commit 1fae844451b120b93880d9360f288c70e125520c)

Co-authored-by: Julien Palard <julien@palard.fr>

bpo-36260: Add pitfalls to zipfile module documentation (GH-13378) (GH-15976)

* bpo-36260: Add pitfalls to zipfile module documentation

We saw vulnerability warning description (including zip bomb) in Doc/library/xml.rst file.
This gave us the idea of documentation improvement.

So, we moved a little bit forward :P
And the doc patch can be found (pr).

* fix trailing whitespace

* 📜🤖 Added by blurb_it.

* Reformat text for consistency.
(cherry picked from commit 3ba51d587f6897a45301ce9126300c14fcd4eba2)

Co-authored-by: JunWei Song <sungboss2004@gmail.com>

bpo-38114: Do not include pip.ini in Nuget package (GH-15964)

(cherry picked from commit 19f6940cd7fb91246b88e1fbdbce97a02e7f3fa1)

Co-authored-by: Steve Dower <steve.dower@python.org>

bpo-33166: Change os.cpu_count to return active (real) processors (GH-15949)

(cherry picked from commit aa929273caca2f4e24e3aa9e790272fd4458ad35)

Co-authored-by: Steve Dower <steve.dower@python.org>

bpo-37885: venv: Don't produce unbound variable warning on deactivate (GH-15973)

Before, running deactivate from a bash shell configured to treat undefined variables as errors (`set -u`) would produce a warning:

```
$ python3 -m venv test
$ source test/bin/activate
(test) $ deactivate
-bash: $1: unbound variable
```
(cherry picked from commit 5209e586b7cac9a43b2c44349a26b1b0af06ead3)

Co-authored-by: Daniel Abrahamsson <hamsson@gmail.com>

bpo-36182: Update pathlib.Path.write_text() docs (GH-12161) (GH-15977)

with the case of an existing file
(cherry picked from commit af636f4f91b8289b6dad95cb84123f6e22fd7f4f)

Co-authored-by: Lysandros Nikolaou <lisandrosnik@gmail.com>

bpo-36634: Fixes activate.bat when existing values contain double quotes (GH-15924)

(cherry picked from commit 574b324bdc9a126b5a4488c3613f11ad2555415e)

Co-authored-by: Steve Dower <steve.dower@python.org>

bpo-35224: Additional documentation for Assignment Expressions (GH-15935) (GH-15967)

Add or update assignment expression documentation for:
- FAQ - Design
- Reference - Expressions
- Reference - Lexical Analysis

https://bugs.python.org/issue35224

Automerge-Triggered-By: @matrixise
(cherry picked from commit 6357c95716d89ac1f80587fbc4133df8d2e8396c)

Co-authored-by: Emily Morehouse <emily@cuttlesoft.com>

bpo-37651: Document CancelledError is now a subclass of BaseException (GH-15950)

https://bugs.python.org/issue37651

Automerge-Triggered-By: @1st1
(cherry picked from commit 7b69069e9aa0047a0dbe8af1a67aa2b355dc68d8)

Co-authored-by: Xtreak <tir.karthi@gmail.com>

Doc: Indicate locations of parse_qs, parse_qsl, escape (GH-14828)

Since they have been removed from cgi it's useful to remind people where they
can be found instead.
(cherry picked from commit 1abf54336fd2cb545c453d22dd5501392b3350b2)

Co-authored-by: Simon Willison <swillison@gmail.com>

Update ftplib.all_errors documentation to match code (GH-15026)

The documentation doesn't mention the `EOFError` that https://github.com/python/cpython/blob/master/Lib/ftplib.pyGH-L66 includes
(cherry picked from commit 51adfc6ed2c6c466dda84edc11d9b2b8ae2903e8)

Co-authored-by: Andrew Scheller <github@loowis.durge.org>

bpo-33187: Document ElementInclude (XInclude) support in ElementTree (GH-8861) (GH-15958)

(cherry picked from commit 97b817eae34b77be1ced382e15098a112f547848)

Co-authored-by: Anjali Bansal <anjali.mca17.du@gmail.com>

[3.8] Turn off AppVeyor CI (GH-15929) (GH-15941)

(cherry picked from commit 6f55b0394bce8e64a59c61f465fec8079a00e55c)

bpo-23460: Fix documentation for decimal string :g formatting (GH-11850) (GH-15954)

(cherry picked from commit 1660a61a105bcd62e2dfa77885959a8992e9f14e)

Co-authored-by: Brennan D Baraban <34765317+bdbaraban@users.noreply.github.com>

closes bpo-37252: Fix devpoll tests. (GH-14017) (GH-15948)

(cherry picked from commit 95da826db9ed4acbc81f32296f14429c06bd2124)

Co-authored-by: Jakub Kulík <Kulikjak@gmail.com>

bpo-36919: make test_source_encoding.test_issue2301 implementation-independent (GH-13639) (GH-15952)

* bpo-36919: make test_issue2301 implementation-independent
(cherry picked from commit b6643dcfc26859f935e4b3a6a2a203e8ef5320e2)

Co-authored-by: Pavel Koneski <pavel.koneski@gmail.com>

bpo-38107: Replace direct future and task contructor calls with factories in asyncio tests (GH-15928)

(cherry picked from commit 9aee90018a5213e3529768e0b873955d23f5e50b)

Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com>

bpo-34519: Add additional aliases for HP Roman 8 (GH-8956) (GH-15945)

* bpo-34519: Add additional aliases for HP Roman 8

HP Roman 8 is known under mode aliases than listed in aliases.py.

Patch by Michael Osipov.
(cherry picked from commit a828514cc3715ebbc700fefa41c0ef044cbd6741)

Co-authored-by: Michael Osipov <michael.osipov@siemens.com>

bpo-37305: add MIME type for Web App Manifest (GH-14199) (#15946)

* bpo-37305: add MIME type for Web App Manifest

Co-authored-by: Filip Š <filip.stamcar@hotmail.com>

bpo-31163: Added return values to pathlib.Path instance's rename and replace methods. (GH-13582) (GH-15944)

* bpo-31163: Added return values to pathlib.Path instance's rename and replace methods.
(cherry picked from commit 088a09af4bdeff52b9dedeb7acd1e82069f37d98)

Co-authored-by: hui shang <shangdahao@gmail.com>

bpo-33459: Fix "tuple displays" term in Expressions.rst (GH-6760) (GH-15940)

https://bugs.python.org/issue33459

Automerge-Triggered-By: @matrixise
(cherry picked from commit dc269971091710563a0d730a0d4b084901826c15)

Co-authored-by: Andre Delfino <adelfino@gmail.com>

bpo-33944: note about the intended use of code in .pth files (GH-10131) (GH-15942)

https://bugs.python.org/issue33944
(cherry picked from commit f9b5840fb4497a9e2ba2c1f01ad0dafba04c8496)

Co-authored-by: native-api <ivan_pozdeev@mail.ru>

bpo-37326: Include libffi license when available (GH-15921)

(cherry picked from commit 8fcaffb048d2359a4c06ed5d8fbbf46d3ae1a472)

Co-authored-by: Steve Dower <steve.dower@python.org>

[3.8] Doc: Use walrus operator in example. (GH-15934) (GH-15936)

(cherry picked from commit e1d455f3a3b82c2e08d5e133bcbab5a181b66cfb)

Co-authored-by: Julien Palard <julien@palard.fr>

Doc: Fix typo in fastsearch comments (GH-14608) (GH-15933)

(cherry picked from commit 60bba83b5d9947fb3106325293e3a4e9c9cdea7e)

Co-authored-by: Valentin Haenel <esc@users.noreply.github.com>

bpo-35649: update http client example (GH-11441) (GH-15930)

(cherry picked from commit 62cf6981425c6a6b136c5e2abef853364f535e9d)

Co-authored-by: Ashwin Ramaswami <aramaswamis@gmail.com>

[3.8] bpo-35168: Make shlex.punctuation_chars read-only (GH-11631) (GH-15927)

(cherry picked from commit 972cf5c06a5ba16ad243a442dbb9c15307fbed95)

Co-authored-by: Alex <a.v.shkop@gmail.com>

Minor ReST formatting fixes in subprocess docs (GH-14876)

(cherry picked from commit 1a13efb7e05b545def26f29c954751fdb6b22fa3)

Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>

bpo-38103: fix conflicting labels in the docs. (GH-15906)

(cherry picked from commit 2d8d597bb8f882a7677db5a2739df0e617098634)

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>

bpo-35603: Add a note on difflib table header interpreted as HTML (GH-11439)

(cherry picked from commit c78dae8d2b890d487e428dce00c7f600612cce7b)

Co-authored-by: Xtreak <tir.karthi@gmail.com>

bpo-20504 : in cgi.py, fix bug when a multipart/form-data request has… (GH-10638)

* bpo-20504 : in cgi.py, fix bug when a multipart/form-data request has no content-length header

* Add Misc/NEWS.d/next file.

* Add rst formatting for NEWS.d/next file

* Reaplce assert by self.assertEqual
(cherry picked from commit 2d7cacacc310b65b43e7e2de89e7722291dea6a4)

Co-authored-by: Pierre Quentel <pierre.quentel@gmail.com>

bpo-35066: Make trailing percent test more portable. (GH-15907)

Different libc implementations have different behavior when presented with trailing % in strftime strings. To make test_strftime_trailing_percent more portable, compare the output of datetime.strftime directly to that of time.strftime rather than hardcoding.
(cherry picked from commit f2173ae38fa49235c3cdc28ae2ca2e19a375a596)

Co-authored-by: Benjamin Peterson <benjamin@python.org>

[3.8] bpo-37409: fix relative import with no parent (GH-14956) (GH-15913)

Relative imports use resolve_name to get the absolute target name,
which first seeks the current module's absolute package name from the globals:
If __package__ (and __spec__.parent) are missing then
import uses __name__, truncating the last segment if
the module is a submodule rather than a package __init__.py
(which it guesses from whether __path__ is defined).

The __name__ attempt should fail if there is no parent package (top level modules),
if __name__ is '__main__' (-m entry points), or both (scripts).
That is, if both __name__ has no subcomponents and the module does not seem
to be a package __init__ module then import should fail..
(cherry picked from commit 92420b3e679959a7d0ce875875601a4cee45231e)

Co-authored-by: Ben Lewis <benjimin@users.noreply.github.com>

bpo-32972: Document IsolatedAsyncioTestCase of unittest module (GH-15878) (GH-15918)

* Document `unittest.IsolatedAsyncioTestCase` API
* Add a simple example with respect to order of evaluation of setup and teardown calls.

https://bugs.python.org/issue32972

Automerge-Triggered-By: @asvetlov
(cherry picked from commit 6a9fd66f6e4445a418c43c92585b9e06d76df4b1)

Co-authored-by: Xtreak <tir.karthi@gmail.com>