[3.9] Minor grammar edits for the descriptor howto guide (GH-GH-23175) (GH-23176)

(cherry picked from commit 803187796f06bdc47ae74ce3d28c443e8cc2a27f)

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
Automerge-Triggered-By: GH:JulienPalard

[3.9] bpo-38320: Clarify that expectedFailure is satisfied by either failure or error of the test. (GH-22740) (GH-22783)

(cherry picked from commit fa8748271a61177e9bf609921fa464cc6990478b)

Co-authored-by: Irit Katriel <iritkatriel@yahoo.com>

bpo-42336: Improve PCbuild batch files (GH-23275)

(cherry picked from commit 2156d964a12285280c533af1c96eb273c58451e6)

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

[3.9] bpo-40998: Fix a refleak in create_filter() (GH-23365) (GH-23369)

(cherry picked from commit d1e38d4023aa29e7ed64d4f8eb9c1e4a3c86a2e5)

bpo-42398: Fix "make regen-all" race condition (GH-23362) (GH-23367)

Fix a race condition in "make regen-all" when make -jN option is used
to run jobs in parallel. The clinic.py script now only use atomic
write to write files. Moveover, generated files are now left
unchanged if the content does not change, to not change the file
modification time.

The "make regen-all" command runs "make clinic" and "make
regen-importlib" targets:

* "make regen-importlib" builds object files (ex: Modules/_weakref.o)
  from source files (ex: Modules/_weakref.c) and clinic files (ex:
  Modules/clinic/_weakref.c.h)
* "make clinic" always rewrites all clinic files
  (ex: Modules/clinic/_weakref.c.h)

Since there is no dependency between "clinic" and "regen-importlib"
Makefile targets, these two targets can be run in parallel. Moreover,
half of clinic.py file writes are not atomic and so there is a race
condition when "make regen-all" runs jobs in parallel using make -jN
option (which can be passed in MAKEFLAGS environment variable).

Fix clinic.py to make all file writes atomic:

* Add write_file() function to ensure that all file writes are
  atomic: write into a temporary file and then use os.replace().
* Moreover, write_file() doesn't recreate or modify the file if the
  content does not change to avoid modifying the file modification
  file.
* Update test_clinic to verify these assertions with a functional
  test.
* Remove Clinic.force attribute which was no longer used, whereas
  Clinic.verify remains useful.

(cherry picked from commit 8fba9523cf08029dc2e280d9f48fdd57ab178c9d)

bpo-40998: Address compiler warnings found by ubsan (GH-20929)

Signed-off-by: Christian Heimes <christian@python.org>
Automerge-Triggered-By: GH:tiran
(cherry picked from commit 07f2adedf0940b06d136208ec386d69b7d2d5b43)

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

[3.9] bpo-41561: skip test_min_max_version_mismatch (GH-22308) (GH-23363)

skip test_min_max_version_mismatch when TLS 1.0 is not available

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

Co-authored-by: Christian Heimes <christian@python.org>
Automerge-Triggered-By: GH:tiran

[3.9] bpo-42332: Add weakref slot to types.GenericAlias (GH-23250) (GH-23309)

(cherry picked from commit 384b7a4bd988986bca227c7e85c32d766da74708)

[3.9] bpo-39934: Account for control blocks in 'except' in compiler. (GH-22395) (GH-23303)

* bpo-39934: backport PR 22395 to 3.9

bpo-41686: Always create the SIGINT event on Windows (GH-23344) (GH-23347)

bpo-41686, bpo-41713: On Windows, the SIGINT event,
_PyOS_SigintEvent(), is now created even if Python is configured to
not install signal handlers (PyConfig.install_signal_handlers=0 or
Py_InitializeEx(0)).

[3.9] bpo-42345: Fix three issues with typing.Literal parameters (GH-23294) (GH-23335)

Literal equality no longer depends on the order of arguments.

Fix issue related to `typing.Literal` caching by adding `typed` parameter to `typing._tp_cache` function.

Add deduplication of `typing.Literal` arguments.

(cherry picked from commit f03d318ca42578e45405717aedd4ac26ea52aaed)

Co-authored-by: Yurii Karabas <1998uriyyo@gmail.com>

bpo-40637: Don't test builtin PBKDF2 without builtin hashes (GH-20980)

Skip testing of pure Python PBKDF2 when one or more builtin hash module
is not available. Otherwise the import of hashlib prints noise on
stderr.

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

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

[3.9] bpo-42120: Remove macro defining copysign to _copysign on Windows (GH-23326) (GH-23331)

(cherry picked from commit 9cc9e277254023c0ca08e1a9e379fd89475ca9c2)

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

bpo-42374: Allow unparenthesized walrus in genexps (GH-23319) (GH-23329)

This fixes a regression that was introduced by the new parser.

(cherry picked from commit cb3e5ed0716114393696ec7201e51fe0595eab4f)

bpo-42350: Fix Thread._reset_internal_locks() (GH-23268)

Fix the threading.Thread class at fork: do nothing if the thread is
already stopped (ex: fork called at Python exit). Previously, an
error was logged in the child process.
(cherry picked from commit 5909a494cd3ba43143b28bd439773ed85a485dfc)

Co-authored-by: Victor Stinner <vstinner@python.org>

bpo-42153 Fix link to IMAP documents in imaplib.rst (GH-23297)

The University of Washington stopped hosting the IMAP documents. Link to a rescued copy on GitHub.
(cherry picked from commit aa01011003bb855cd52abfd49f2443446590d913)

Co-authored-by: Yash Shete <universeyash4@gmail.com>

More updates to the descriptor howto guide (GH-23238) (GH-23308)

bpo-42317: Improve docs of typing.get_args concerning Union (GH-23254)

(cherry picked from commit c3b9592244a9112d8af9610ff1c4e1e4cd4bfaca)

Co-authored-by: Dominik1123 <15989985+Dominik1123@users.noreply.github.com>

fix typo in ThreadedChildWatcher docs (GH-23277)

(cherry picked from commit 8836574a0f34ae81643c8af79bbb9062e332a4e3)

Co-authored-by: Thomas Grainger <tagrain@gmail.com>

bpo-40754: Adds _testinternalcapi to Windows installer for test suite (GH-23271)

(cherry picked from commit 9b6934230c35e24d8582ea8c58456fa8eab72ae2)

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

bpo-42344: Improve pseudo implementation for SimpleNamespace (GH-23264) (GH-23270)

(cherry picked from commit bbeb2d266d6fc1ca9778726d0397d9d6f7a946e3)

Co-authored-by: Jürgen Gmach <juergen.gmach@googlemail.com>
Co-authored-by: Jürgen Gmach <juergen.gmach@googlemail.com>

[3.9] bpo-42042: Use ids attribute instead of names attribute (GH-22739) (GH-23265)

(cherry picked from commit 09490a109faaee9cc393b52742a8575c116c56ba)

Co-authored-by: Dong-hee Na <donghee.na@python.org>

bpo-41617: Add _Py__has_builtin() macro (GH-23260) (GH-23262)

Fix building pycore_bitutils.h internal header on old clang version
without __builtin_bswap16() (ex: Xcode 4.6.3 on Mac OS X 10.7).

Add a new private _Py__has_builtin() macro to check for availability
of a preprocessor builtin function.

Co-Authored-By: Joshua Root <jmr@macports.org>
Co-authored-by: Joshua Root <jmr@macports.org>
(cherry picked from commit b3b98082c5431e77c64cab2c85525a804436b505)

bpo-42296: On Windows, fix CTRL+C regression (GH-23257)

On Windows, fix a regression in signal handling which prevented to
interrupt a program using CTRL+C. The signal handler can be run in a
thread different than the Python thread, in which case the test
deciding if the thread can handle signals is wrong.

On Windows, _PyEval_SignalReceived() now always sets eval_breaker to
1 since it cannot test _Py_ThreadCanHandleSignals(), and
  eval_frame_handle_pending() always calls
  _Py_ThreadCanHandleSignals() to recompute eval_breaker.
(cherry picked from commit d96a7a83133250377219227b5cfab4dbdddc5d3a)

Co-authored-by: Victor Stinner <vstinner@python.org>

[3.9] bpo-42086: Document AST operator nodes acts as a singleton (GH-22896) (GH-22897)

Automerge-Triggered-By: GH:gvanrossum
(cherry picked from commit b37c994e5ac73268abe23c52005b80cdca099793)

Co-authored-by: Batuhan Taskaya <batuhanosmantaskaya@gmail.com>

bpo-42237: Fix os.sendfile() on illumos (GH-23154)

(cherry picked from commit fd4ed57674c675e05bd5d577dd5047a333c76c78)

Co-authored-by: Jakub Stasiak <jakub@stasiak.at>

bpo-42140: Improve asyncio.wait function (GH-22938)

GH- Improve asyncio.wait function

The original code creates the futures set two times.
We can create this set before, avoiding the second creation.

This new behaviour [breaks the aiokafka library](https://github.com/aio-libs/aiokafka/pull/672), because it gives an iterator to that function, so the second iteration become empty.

Automerge-Triggered-By: GH:1st1
(cherry picked from commit 7e5ef0a5713f968f6e942566c78bf57ffbef01de)

Co-authored-by: Diogo Dutra <diogodutradamata@gmail.com>

[3.9] bpo-4bpo-42314: Fix the documentation for venv --upgrade-deps (GH-22113) (GH-23232)

It was added in 3.9, not 3.8.

bpo-42014: shutil.rmtree: call onerror with correct function (GH-22585)

The onerror is supposed to be called with failed function, but in this case lstat is wrongly used instead of open.

Not sure if this needs bug or not...

Automerge-Triggered-By: GH:hynek
(cherry picked from commit e59b2deffde61e5641cabd65034fa11b4db898ba)

Co-authored-by: Michal Čihař <michal@cihar.com>

bpo-42183: Fix a stack overflow error for asyncio Task or Future repr() (GH-23020)

The overflow occurs under some circumstances when a task or future
recursively returns itself.

Co-authored-by: Kyle Stanley <aeros167@gmail.com>
(cherry picked from commit 42d873c63aa9d160c132be4a34599531574db12c)

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

Fix typo in unicodeobject.c (GH-23180)

exeeds -> exceeds

Automerge-Triggered-By: GH:Mariatta
(cherry picked from commit 38811d68caf9b782ea7168479acb09557e126efe)

Co-authored-by: Ikko Ashimine <eltociear@gmail.com>

bpo-41754: Ignore NotADirectoryError in invocation of xdg-settings (GH-23075)

It is not clear why this can happen, but several users have mentioned
getting this exception on macOS.
(cherry picked from commit 23831a7a90956e38b7d70304bb6afe30d37936de)

Co-authored-by: Ronald Oussoren <ronaldoussoren@mac.com>

Minor wording change in concurrent.futures. (GH-23194)

Fixes a grammar problem by adding a missing "as", and clarifies the wording of the valid ranges for max_workers.
(cherry picked from commit fd6f6fa403789c8877b1099cc6fcc437d2e54634)

Co-authored-by: Don Kirkby <donkirkby@users.noreply.github.com>

bpo-42233: Correctly repr GenericAlias when used with typing module (GH-23081)

Noticed by @serhiy-storchaka in the bpo.  `typing`'s types were not showing the parameterized generic.
Eg. previously:
```python
>>> typing.Union[dict[str, float], list[int]]
'typing.Union[dict, list]'
```
Now:
```python
>>> typing.Union[dict[str, float], list[int]]
'typing.Union[dict[str, float], list[int]]'
```

Automerge-Triggered-By: GH:gvanrossum
(cherry picked from commit 1f7dfb277e5b88cddc13e5024766be787a3e9127)

Co-authored-by: kj <28750310+Fidget-Spinner@users.noreply.github.com>

Minor grammar edits for the descriptor howto guide (GH-#23175) (GH-23186)

Remove outdated reference to pywin32 from platform module (GH-22005)

(cherry picked from commit 7c01f1540f958d4f52188b28afca721a9a6925c3)

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

bpo-42179: Doc/tutorial: Remove mention of __cause__ (GH-23162)

(cherry picked from commit bde33e428d5b5f88ec7667598fd27d1091840537)

Co-authored-by: Inada Naoki <songofacandy@gmail.com>

Disable peg generator tests when building with PGO (GH-23141)

Otherwise, when running the testsuite, test_peg_generator tries to compile C
code using the optimized flags and fails because it cannot find the profile
data.
(cherry picked from commit 100964e0310d3a2040d0db976f7984d0507b2dbd)

Co-authored-by: serge-sans-paille <serge.guelton@telecom-bretagne.eu>

bpo-35455: Fix thread_time for Solaris OS (GH-11118) (GH-23130)

(cherry picked from commit 9568622c9983b682b2a2a7bacfd3c341028ea099)

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

Enable signing of nuget.org packages and update to supported timestamp server (GH-23132)

(cherry picked from commit db6434c474f7389a98b8118ca87fca988416bf33)

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

bpo-42249: Fix writing binary Plist files larger than 4 GiB. (GH-23121)

(cherry picked from commit 212d32f45c91849c17a82750df1ac498d63976be)

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

bpo-42180: fix plural in arguments and control (GH-23015) (GH-23114)

https://bugs.python.org/issue42180
(cherry picked from commit b76a8400217827e604ebb543f45156f3caacd9a0)

Co-authored-by: Rafael Fontenelle <rffontenelle@users.noreply.github.com>

bpo-42103: Improve validation of Plist files. (GH-22882)

* Prevent some possible DoS attacks via providing invalid Plist files
  with extremely large number of objects or collection sizes.
* Raise InvalidFileException for too large bytes and string size instead of returning garbage.
* Raise InvalidFileException instead of ValueError for specific invalid datetime (NaN).
* Raise InvalidFileException instead of TypeError for non-hashable dict keys.
* Add more tests for invalid Plist files.
(cherry picked from commit 34637a0ce21e7261b952fbd9d006474cc29b681f)

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

bpo-42224: Fix test_format when locale does not expect number grouping (GH-23067)

(cherry picked from commit 301822859b3fc34801a06f1090d62f9f2ee5b092)

bpo-42230: Improve asyncio documentation regarding accepting sets vs iterables (GH-23073)

People call wait() and as_completed() with various non-set iterables,
a list should be the most common but there are others as well[1].

Considering typeshed also documents wait()[2] and as_completed()[3]
as accepting arbitrary iterables I think it's a good idea to document
the status quo better.

[1] https://github.com/aio-libs/aiokafka/pull/672
[2] https://github.com/python/typeshed/blob/620989bac572f30349b95590ebe81a73ce0fe862/stdlib/3/asyncio/tasks.pyiGH-L161
[3] https://github.com/python/typeshed/blob/620989bac572f30349b95590ebe81a73ce0fe862/stdlib/3/asyncio/tasks.pyiGH-L40
(cherry picked from commit 3d86d090dcbbdfdd3e5a5951cab30612d6131222)

Co-authored-by: Jakub Stasiak <jakub@stasiak.at>

Minor formatting edits to the descriptor howto guide (GH-23092) (GH-23095)

bpo-40511: Stop unwanted flashing of IDLE calltips (GH-20910)

They were occurring with both repeated 'force-calltip' invocations and by typing parentheses
 in expressions, strings, and comments in the argument code.

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
(cherry picked from commit da7bb7b4d769350c5fd03e6cfb16b23dc265ed72)

Co-authored-by: Tal Einat <taleinat+github@gmail.com>

Add member objects to the descriptor howto guide (GH-23084) (GH-23090)

Expand and clarify the "Invoking Descriptors" section of the Descriptor HowTo (GH-23078) (GH-23080)

bpo-37483: Add PyObject_CallOneArg() in the What's New in Python 3.9 (GH-23062)

(cherry picked from commit 7feb54a6348f6220b27986777786c812f110b53d)

Co-authored-by: Dong-hee Na <donghee.na@python.org>

[3.9] bpo-29566: binhex.binhex now consitently writes MacOS 9 line endings. (GH-23059) (GH-23071)

[[bpo-29566]()]() notes that binhex.binhex uses inconsistent line endings (both Unix and MacOS9 line endings are used). This PR changes this to use the MacOS9 line endings everywhere.
(cherry picked from commit 2165cea548f961b308050f30d1f042a377651d44)

Co-authored-by: Ronald Oussoren <ronaldoussoren@mac.com>
Automerge-Triggered-By: GH:ronaldoussoren

[3.9] bpo-42218: Correctly handle errors in left-recursive rules (GH-23065) (GH-23066)

Left-recursive rules need to check for errors explicitly, since
even if the rule returns NULL, the parsing might continue and lead
to long-distance failures.

Co-authored-by: Pablo Galindo <Pablogsal@gmail.com>
(cherry picked from commit 02cdfc93f82fecdb7eae97a868d4ee222b9875d9)

Automerge-Triggered-By: GH:lysnikolaou

[3.9] bpo-42198: Document __new__ for types.GenericAlias (GH-23039) (GH-23061)

(cherry picked from commit bcbf758476c1148993ddf4b54d3f6169b973ee1c)

[3.9] bpo-42214: Fix check for NOTEQUAL token in the PEG parser for the barry_as_flufl rule (GH-23048) (GH-23051)

(cherry picked from commit 06f8c3328dcd81c84d1ee2b3a57b5381dcb38482)

Co-authored-by: Pablo Galindo <Pablogsal@gmail.com>

 bpo-42208: GitHub Action: Add gdb to posix dependencies (GH-23043) (GH-23047)

Sort also dependencies and remove duplicates (liblzma-dev).
(cherry picked from commit 6e03c0ad156797cd6e9132e895d55dac0344d340)

Co-authored-by: Victor Stinner <vstinner@python.org>
Co-authored-by: Victor Stinner <vstinner@python.org>

bpo-42198: Link to GenericAlias in typing and expressions (GH-23030)

Follow up to 7cdf30fff39ea97f403b5472096349998d190e30 and 4173320920706b49a004bdddd8d7108e8984e3fc. This addresses the point "1. Update links in typing, subscription and union to point to GenericAlias." in the bpo for this PR.
(cherry picked from commit 9129af6050b747f288baa9d4e7d43031647ed222)

Co-authored-by: kj <28750310+Fidget-Spinner@users.noreply.github.com>

bpo-42061: Document __format__ for IP addresses (GH-23018)

Automerge-Triggered-By: GH:ericvsmith
(cherry picked from commit 3317466061509c83dce257caab3661d52571cab1)

Co-authored-by: Teugea Ioan-Teodor <teodor.teugea@gmail.com>

bpo-42143: Ensure PyFunction_NewWithQualName() can't fail after creating the func object (GH-22953) (GH-23021)

func_dealloc() does not handle partially-created objects. Best not to give it any.
(cherry picked from commit 350526105fa9b131d8b941ae753378b741dabb2f)

Co-authored-by: Yonatan Goldschmidt <yon.goldschmidt@gmail.com>

[3.9] bpo-41805: Documentation for PEP 585 (GH-22615) (GH-23016)

Backport of #22615 to 3.9 since that couldn't be auto-merged due to conflicts.

[3.9] bpo-42123: Run the parser two times and only enable invalid rules on the second run (GH-22111) (GH-23011)

* Implement running the parser a second time for the errors messages

The first parser run is only responsible for detecting whether
there is a `SyntaxError` or not. If there isn't the AST gets returned.
Otherwise, the parser is run a second time with all the `invalid_*`
rules enabled so that all the customized error messages get produced.

(cherry picked from commit bca701403253379409dece03053dbd739c0bd059)

[3.9] bpo-41659: Disallow curly brace directly after primary (GH-22996) (#23006)

(cherry picked from commit 15acc4eaba8519d7d5f2acaffde65446b44dcf79)

[3.9] Remove git conflict lines from test_parse_directory in peg_generator (GH-23007)

bpo-6761: Enhance __call__ documentation (GH-7987)

(cherry picked from commit 95f710c55714153f0c8cce48f8215bb3d866ac1d)

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

bpo-41474, Makefile: Add dependency on cpython/frameobject.h (GH-22999)

Co-Authored-By: Skip Montanaro <skip.montanaro@gmail.com>
(cherry picked from commit a6879d9445f98833c4e300e187956e2a218a2315)

Co-authored-by: Victor Stinner <vstinner@python.org>

Add a link to buffer protocol in bytearray() doc (GH-22675)

(cherry picked from commit 0f25c231b3a024e358c3e55d9aba2f7bcc49630c)

Co-authored-by: Antoine <43954001+awecx@users.noreply.github.com>

Added some makefile generated files to .gitignore (GH-22435)

(cherry picked from commit 96a9eed2457c05af6953890d89463704c9d99c57)

Co-authored-by: Marco Sulla <github@marco.sulla.e4ward.com>

[3.9] bpo-42146: Fix memory leak in subprocess.Popen() in case of uid/gid overflow (GH-22966) (GH-22980)

Fix memory leak in subprocess.Popen() in case of uid/gid overflow

Also add a test that would catch this leak with `--huntrleaks`.

Alas, the test for `extra_groups` also exposes an inconsistency
in our error reporting: we use a custom ValueError for `extra_groups`,
but propagate OverflowError for `user` and `group`.
(cherry picked from commit c0590c0033e86f98cdf5f2ca6898656f98ab4053)

Co-authored-by: Alexey Izbyshev <izbyshev@ispras.ru>
Automerge-Triggered-By: GH:gpshead

bpo-42150: Avoid buffer overflow in the new parser (GH-22978)

(cherry picked from commit e68c67805e6a4c4ec80bea64be0e8373cc02d322)

Co-authored-by: Pablo Galindo <Pablogsal@gmail.com>

bpo-42144: Add a missing "goto error;" in the _ssl module (GH-22959)

(cherry picked from commit c32f2976b8f4034724c3270397aa16f38daf470f)

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

[3.9] bpo-41052: Fix pickling heap types implemented in C with protocols 0 and 1 (GH-22870). (GH-22963)

(cherry picked from commit 8cd1dbae32d9303caac3a473d3332f17bc98c921)

bpo-39108: Document threading issues for random.gauss() (GH-22928) (GH-22972)

Split-out a fourth section in the descriptor HowTo guide (GH-22965) (GH-22969)

Second round of updates to the descriptor howto guide (GH-22946) (GH-22958)

bpo-33987: Add master ttk Frame to IDLE search dialogs (GH-22942)

(cherry picked from commit 5df6c99cb450fe2f30be681dbf68cd1d34d3bbe4)

Co-authored-by: Mark Roseman <mark@markroseman.com>

bpo-29981: Add examples and update index for set, dict, and generator comprehensions'(GH-20272)

Co-authored-by: Rémi Lapeyre <remi.lapeyre@henki.fr>
(cherry picked from commit 2d55aa9e37c9c84f4f6a8135d0326da0bcd8f38b)

Co-authored-by: Florian Dahlitz <f2dahlitz@freenet.de>

bpo-42127:  Document effect of cached_property on key-sharing dictionaries (GH-22930) (GH-22955)

bpo-33987: Use master ttk Frame for IDLE config dialog (GH-22943)

(cherry picked from commit c579ad14d3b5bb9a45d7b9cc708eaf0bf4884c50)

Co-authored-by: Mark Roseman <mark@markroseman.com>

[doc] Fix link to abc.ABCMeta.register in Glossary (GH-22932)

(cherry picked from commit e01e442125bbc98e6dab66f38ecc6c45f69e6587)

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

bpo-33987: Use ttk Label on IDLE statusbar (GH-22941)

(cherry picked from commit e53e54425d9b7b9b7b082817da104d60bb25e3a2)

Co-authored-by: Mark Roseman <mark@markroseman.com>

bpo-19072: Update descriptor howto for decorator chaining (GH-22934) (GH-22935)

bpo-41950: Typo in Python 3.9 what's new page (GH-22573)

build(deps): bump actions/upload-artifact from v1 to v2.2.0 (GH-22920)

Bumps [actions/upload-artifact](https://github.com/actions/upload-artifact) from v1 to v2.2.0.
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a href="https://github.com/actions/upload-artifact/releases">actions/upload-artifact's releases</a>.</em></p>
<blockquote>
<h2>v2.2.0</h2>
<ul>
<li>Support for artifact retention</li>
</ul>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a href="https://github.com/actions/upload-artifact/commit/27bce4eee761b5bc643f46a8dfb41b430c8d05f6"><code>27bce4e</code></a> Merge pull request <a href="https://github-redirect.dependabot.com/actions/upload-artifact/issues/112">GH-112</a> from thboop/main</li>
<li><a href="https://github.com/actions/upload-artifact/commit/f8b42f7ab442a66b3d51a5ca02855b194a36ae2d"><code>f8b42f7</code></a> update licensed files</li>
<li><a href="https://github.com/actions/upload-artifact/commit/2106e8cf10e032ca9d5724c4c676543febe74f0b"><code>2106e8c</code></a> update contributing.md</li>
<li><a href="https://github.com/actions/upload-artifact/commit/db66798ebcfbaa7f3f8ff66bce013213265c30d1"><code>db66798</code></a> Ignore Generated Files in Git PR's</li>
<li><a href="https://github.com/actions/upload-artifact/commit/d359fd0772ed6802a84728dd6b09ec99f41a67b7"><code>d359fd0</code></a> Manual Verification of licenses</li>
<li><a href="https://github.com/actions/upload-artifact/commit/350822c32f871c559dbe1667c24424e06c4f03e3"><code>350822c</code></a> Add Licensed Workflow and config</li>
<li><a href="https://github.com/actions/upload-artifact/commit/abecf4abf4b70bc636949d61150be883b87416c2"><code>abecf4a</code></a> Updated README.md (<a href="https://github-redirect.dependabot.com/actions/upload-artifact/issues/118">GH-118</a>)</li>
<li><a href="https://github.com/actions/upload-artifact/commit/604e071d21906545dedcfaf210deae74f8c5276a"><code>604e071</code></a> Merge pull request <a href="https://github-redirect.dependabot.com/actions/upload-artifact/issues/126">GH-126</a> from yacaovsnc/main</li>
<li><a href="https://github.com/actions/upload-artifact/commit/4560c23b396d494f0cb7066e1d6e258e8feb8051"><code>4560c23</code></a> Check for invalid retention-days input</li>
<li><a href="https://github.com/actions/upload-artifact/commit/59018c2f85dd0e101b75544aa87f13bb0c94e0b7"><code>59018c2</code></a> Add an option to specify retention period</li>
<li>Additional commits viewable in <a href="https://github.com/actions/upload-artifact/compare/v1...27bce4eee761b5bc643f46a8dfb41b430c8d05f6">compare view</a></li>
</ul>
</details>
<br />

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting `@dependabot rebase`.

[//]: GH- (dependabot-automerge-start)
[//]: GH- (dependabot-automerge-end)

---

<details>
<summary>Dependabot commands and options</summary>
<br />

You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it
- `@dependabot merge` will merge this PR after your CI passes on it
- `@dependabot squash and merge` will squash and merge this PR after your CI passes on it
- `@dependabot cancel merge` will cancel a previously requested merge and block automerging
- `@dependabot reopen` will reopen this PR if it is closed
- `@dependabot close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
- `@dependabot ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

</details>

Automerge-Triggered-By: GH:Mariatta
(cherry picked from commit a3c4ceffe61df89cc9ce5c437cae0276521dc83b)

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

build(deps): bump actions/cache from v1 to v2.1.2 (GH-22919)

Bumps [actions/cache](https://github.com/actions/cache) from v1 to v2.1.2.
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a href="https://github.com/actions/cache/releases">actions/cache's releases</a>.</em></p>
<blockquote>
<h2>v2.1.2</h2>
<ul>
<li>Adds input to limit the chunk upload size, useful for self-hosted runners with slower upload speeds</li>
<li>No-op when executing on GHES</li>
</ul>
</blockquote>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a href="https://github.com/actions/cache/commit/d1255ad9362389eac595a9ae406b8e8cb3331f16"><code>d1255ad</code></a> Merge pull request <a href="https://github-redirect.dependabot.com/actions/cache/issues/424">GH-424</a> from actions/dhadka/upload-chunk-size</li>
<li><a href="https://github.com/actions/cache/commit/68cfb2ccb73b1982be3fa55e3d7c842697d7f1ed"><code>68cfb2c</code></a> Add units to description</li>
<li><a href="https://github.com/actions/cache/commit/cce3c03a74623545a53c433d301f3f7725c72454"><code>cce3c03</code></a> Add new input to action.yml</li>
<li><a href="https://github.com/actions/cache/commit/4bceb75b5b7743784c63c94b81c50a485cbdcda0"><code>4bceb75</code></a> Use parseInt instead of Number to handle empty strings</li>
<li><a href="https://github.com/actions/cache/commit/a6f1f4b32eec85780fedc5b354a583e9b2999100"><code>a6f1f4b</code></a> Adds input for upload chunk size</li>
<li><a href="https://github.com/actions/cache/commit/d606e039ae32f64a8593bf4a37b0bf205c695237"><code>d606e03</code></a> Merge pull request <a href="https://github-redirect.dependabot.com/actions/cache/issues/421">GH-421</a> from actions/dhadka/ghes</li>
<li><a href="https://github.com/actions/cache/commit/d3e4f218f30bd71a2c29e2b2a1e4f811f4327162"><code>d3e4f21</code></a> Use warning instead of info</li>
<li><a href="https://github.com/actions/cache/commit/55a58944386e69f7c5bad52ef43a61c578b6c1c6"><code>55a5894</code></a> Update dist</li>
<li><a href="https://github.com/actions/cache/commit/3f6dfcbcc44a8e2fd9e539c1dd15af6559e74ced"><code>3f6dfcb</code></a> Merge branch 'main' of <a href="http://github.com/actions/cache">http://github.com/actions/cache</a> into dhadka/ghes</li>
<li><a href="https://github.com/actions/cache/commit/0f71d4ac9a7f4c36aba5ac3cfc4567d2d4eae813"><code>0f71d4a</code></a> Add tests for isGhes</li>
<li>Additional commits viewable in <a href="https://github.com/actions/cache/compare/v1...d1255ad9362389eac595a9ae406b8e8cb3331f16">compare view</a></li>
</ul>
</details>
<br />

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting `@dependabot rebase`.

[//]: GH- (dependabot-automerge-start)
[//]: GH- (dependabot-automerge-end)

---

<details>
<summary>Dependabot commands and options</summary>
<br />

You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it
- `@dependabot merge` will merge this PR after your CI passes on it
- `@dependabot squash and merge` will squash and merge this PR after your CI passes on it
- `@dependabot cancel merge` will cancel a previously requested merge and block automerging
- `@dependabot reopen` will reopen this PR if it is closed
- `@dependabot close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
- `@dependabot ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

</details>

Automerge-Triggered-By: GH:Mariatta
(cherry picked from commit cd0edbc716d64ccd437d97af1eaa3b7a6f0f6de5)

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

[3.9] bpo-40592: shutil.which will not return None anymore if ; is the last char in PATHEXT (GH-20088) (GH-22912)

shutil.which will not return None anymore for empty str in PATHEXT
Empty PATHEXT will now be defaulted to _WIN_DEFAULT_PATHEXT
(cherry picked from commit da6f098188c9825f10ae60db8987056b3a54c2e8)

Co-authored-by: Christopher Marchfelder <marchfelder@googlemail.com>

Create a primer section for the descriptor howto guide (GH-22906) (GH0-22918)

[3.9] bpo-38486: Fix dead qmail links in the mailbox docs (GH-22239) (GH-22901)

(cherry picked from commit ec388cfb4ede56dace2bb78851ff6f38fa2a6abe)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>
Automerge-Triggered-By: GH:warsaw

bpo-33987: IDLE: Use ttk Frame on doc window and statusbar (GH-11433) (GH-22899)

(cherry picked from commit facb522d44fceaf15de6bc95de1cd680c4621c2a)

Co-authored-by: Cheryl Sabella <cheryl.sabella@gmail.com>

bpo-25655: Improve Win DLL loading failures doc (GH-22372)

Add documentation to help diagnose CDLL dependent DLL loading errors
on windows for OSError with message:
"[WinError 126] The specified module could not be found"
This error is otherwise difficult to diagnose.
(cherry picked from commit b6f2fc90409e291822166d74ce7402e0ef4dba91)

Co-authored-by: Philippe Ombredanne <pombredanne@gmail.com>

[3.9] Remove 3.5 from Doc version switcher in master. (GH-22886) (#22888)

(cherry picked from commit 283f9a253b4ff4df728558205629b3bb3af6e47f)

bpo-42057: Add a test case (GH-22878)

bpo-42057: Fix peephole optimizer (GH-22802)

bpo-41910: specify the default implementations of object.__eq__ and object.__ne__ (GH-22874) (#22876)

See Objects/typeobject.c:object_richcompare() for the implementation of this in CPython.

Co-authored-by: Brett Cannon <brett@python.org>

bpo-35181: Correct importlib documentation for some module attributes (GH-15190)

@ericsnowcurrently This PR will change the following:

In the library documentation importlib.rst:

- `module.__package__` can be `module.__name__` for packages;
- `spec.parent` can be `spec.__name__` for packages;
- `spec.loader` is not `None` for namespaces packages.

In the language documentation import.rst:

- `spec.loader` is not `None` for namespace packages.

Automerge-Triggered-By: GH:warsaw
(cherry picked from commit 27f1bd8787d24ac53cc3dc6ea5eb00b8a3499839)

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

Fix bpo-39416: Change "Numeric" to lower case; an english word, not a class name (GH-22867)

This is a trivial fix to [bpo-39416](), which didn't come up until it was already committed

```
Change "Numeric" to "numeric".

I believe this is trivial enough to not need an issue or a NEWS entry, although
I'm unclear on what branches the original pull request received backports.
```

Automerge-Triggered-By: GH:merwok
(cherry picked from commit f8b1ccd63c94bcde1c15d56d24add89861b6ceee)

Co-authored-by: kpinc <kop@karlpinc.com>

bpo-41959: Fix grammar around class asyncio.MultiLoopChildWatcher text (GH-22580) (#22865)

While translating the following document to Spanish we found there is a grammar issue on the original documentation.
(cherry picked from commit caff2934f46510920a6169e192707d59e9c55f6b)

Co-authored-by: Raúl Cumplido <raulcumplido@gmail.com>
Co-authored-by: Raúl Cumplido <raulcumplido@gmail.com>

[3.9] bpo-39416: Document some restrictions on the default string representations of numeric classes (GH-18111) (GH-22860)

[[bpo-39416]()](): Document string representations of the Numeric classes

This is a change to the specification of the Python language.

The idea here is to put sane minimal limits on the Python language's default
representations of its Numeric classes.  That way "Marty's Robotic Massage Parlor
and Python Interpreter" implementation of Python won't do anything too
crazy.

Some discussion in the email thread:
Subject: Documenting Python's float.__str__()
https://mail.python.org/archives/list/python-dev@python.org/thread/FV22TKT3S2Q3P7PNN6MCXI6IX3HRRNAL/
(cherry picked from commit c60394c7fc9cc09b16e9675a3eeb5844b6d8523f)

Co-authored-by: kpinc <kop@karlpinc.com>
Automerge-Triggered-By: GH:merwok

bpo-38439: Add 256px IDLE icon to the .ico, drop gifs from it (GH-19648)

(cherry picked from commit faddc7449d07e883b8ad8bb95dd68ce6dbdc06e8)

Co-authored-by: Miro Hrončok <miro@hroncok.cz>

Doc: Fix a typo/error in the docs for cached bytecode (GH-22445)

(cherry picked from commit cb115e36e1aba04b90b0ecac6f043e60064ac65b)

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

Doc: Do not suggest `s[::-1]` for reversed order (GH-22457)

(cherry picked from commit fb2e94692e3a8eb66915575f4a122d56fe8999a0)

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

Doc: Do not encourage using a base class name in a derived class (GH-22177)

(cherry picked from commit 4642ccd1c3e460cb2746d3f2095f1c1d1bafa4fe)

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