Python 3.9.13

[3.9] gh-92112: Fix crash triggered by an evil custom `mro()` (GH-92113) (GH-92372)

(cherry picked from commit 85354ed78c0edb6d81a2bd53cabc85e547b8b26e)

Co-authored-by: Alexey Izbyshev <izbyshev@ispras.ru>

[3.9] bpo-34480: fix bug where match variable is used prior to being defined (GH-17643) (GH-32256)

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>

Check result of utc_to_seconds and skip fold probe in pure Python (GH-91582) (GH-92748)

The `utc_to_seconds` call can fail, here's a minimal reproducer on
Linux:

TZ=UTC python -c "from datetime import *; datetime.fromtimestamp(253402300799 + 1)"

The old behavior still raised an error in a similar way, but only
because subsequent calculations happened to fail as well. Better to fail
fast.

This also refactors the tests to split out the `fromtimestamp` and
`utcfromtimestamp` tests, and to get us closer to the actual desired
limits of the functions. As part of this, we also changed the way we
detect platforms where the same limits don't necessarily apply (e.g.
Windows).

As part of refactoring the tests to hit this condition explicitly (even
though the user-facing behvior doesn't change in any way we plan to
guarantee), I noticed that there was a difference in the places that
`datetime.utcfromtimestamp` fails in the C and pure Python versions, which
was fixed by skipping the "probe for fold" logic for UTC specifically —
since UTC doesn't have any folds or gaps, we were never going to find a
fold value anyway. This should prevent some failures in the pure python
`utcfromtimestamp` method on timestamps close to 0001-01-01.

There are two separate news entries for this because one is a
potentially user-facing change, the other is an internal code
correctness change that, if anything, changes some error messages. The
two happen to be coupled because of the test refactoring, but they are
probably best thought of as independent changes.

Fixes GH-91581
(cherry picked from commit 83c0247d47b99f4571e35ea95361436e1d2a61cd)

Co-authored-by: Paul Ganssle <1377457+pganssle@users.noreply.github.com>

gh-80143: Add clarification for escape characters (GH-92292) (GH-92630)

(cherry picked from commit 549567c6e70da4846c105a18a1a89e7dd09680d7)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>

gh-92530: Fix an issue that occurred after interrupting threading.Condition.notify (GH-92534) (GH-92831)

If Condition.notify() was interrupted just after it released the waiter lock,
but before removing it from the queue, the following calls of notify() failed
with RuntimeError: cannot release un-acquired lock.
(cherry picked from commit 70af994fee7c0850ae859727d9468a5f29375a38)

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

gh-87670: Add web.archive redirects from effbot (GH-92816)

(cherry picked from commit 3ed1cae9ed9d1f0dd9d68da4b30b731fdf6be768)

Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>

gh-92611: Link to PEP 594 sections & add key detail in doc deprecation notices (GH-92612)

(cherry picked from commit 9f68dab3d327335b938046c50b4f09944e993cc8)

Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>

Document Py_ssize_t. (GH-92512)

It fixes 252 errors from a Sphinx nitpicky run (sphinx-build -n). But
there's 8182 errors left.

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
(cherry picked from commit 664aa94b570a4a8f3535efb2e3d638a4ab655943)

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

Fix typo in argparse docs. (GH-92691) (#92731)

[3.9] gh-92311: Let frame_setlineno jump over listcomps (#92740)

[3.9] gh-92436: __future__ docs: add note on expectations for "from __future__ import annotations" (GH-92568). (#92726)

(cherry picked from commit 6582c96454ddb731eb412c2a473300172225fdb9)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>

bpo-42627: Fix incorrect parsing of Windows registry proxy settings (GH-26307)

(cherry picked from commit b69297ea23c0ab9866ae8bd26a347a9b5df567a6)

Co-authored-by: 狂男风 <CrazyBoyFeng@Live.com>

[3.9] gh-91810: ElementTree: Use text file's encoding by default in XML declaration (GH-91903) (GH-92665)

ElementTree method write() and function tostring() now use the text file's
encoding ("UTF-8" if not available) instead of locale encoding in XML
declaration when encoding="unicode" is specified.
(cherry picked from commit 707839b0fe02ba2c891a40f40e7a869d84c2c9c5)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Automerge-Triggered-By: GH:serhiy-storchaka

[3.9] Fix typo in unittest.rst: addCleanupModule -> addModuleCleanup (GH-92631) (GH-92661)

(cherry picked from commit 38486ca212c0827d54e7b0d0b1e2c1ccc2bdad33)

Co-authored-by: Mikhail Terekhov <termim@gmail.com>
Automerge-Triggered-By: GH:serhiy-storchaka

[3.9] gh-76773: Update docs mentioning no-longer-supported Windows versions & features (GH-92529) (GH-92610)

(cherry picked from commit f1bbcba74f77eff2a4c0881f3d529f3bf0664d40)

Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
Automerge-Triggered-By: GH:serhiy-storchaka

gh-92256: Improve Argument Clinic parser error messages (GH-92268)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>
(cherry picked from commit 4bd07d1dbd493fc9b2c2a77e9e905c517682052e)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>

bpo-13553: Document tkinter.Tk args (GH-4786)

(cherry picked from commit c56e2bb9949c95ec8911cd5554b07044a564796f)

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

bpo-46785: Fix race condition between os.stat() and unlink on Windows (GH-31858)

* [3.9] bpo-46785: Fix race condition between os.stat() and unlink on Windows (GH-31858).
(cherry picked from commit 39e6b8ae6a5b49bb23746fdcc354d148ff2d98e3)

Co-authored-by: Itai Steinherz <itaisteinherz@gmail.com>

Doc: Update py2app link. (GH-91585)

See: https://mail.python.org/archives/list/docs@python.org/thread/KDVFGNGGUGGPVRZT7WZYHHWXCRS2GEN7/
(cherry picked from commit b77a95f44a024d1afab28e380252aa6d9c4efb1c)

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

gh-92417: `asyncio` docs: `asyncio.run()` is available on all supported Python versions (GH-92419)

(cherry picked from commit f4e317b304c7f86e48885b4b74c7a8826648922c)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

CODEOWNERS: Add Erlend Aasland as sqlite3 code owner (GH-92535)

Signed-off-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
(cherry picked from commit 3edda031e4abcdc8a2974f2708db99eeb109de32)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>

bpo-38056: overhaul Error Handlers section in codecs documentation (GH-15732)

* Some handlers were wrongly described as text-encoding only, but actually they can also be used in text-decoding.
* Add more description to each handler.
* Add two REPL examples.
* Add indexes for Error Handler's name.

Co-authored-by: Kyle Stanley <aeros167@gmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit 5bc2390229bbcb4f13359e867fd8a140a1d5496b)

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

pdb docs: workaround for double semicolon in strings (GH-17011)

see https://github.com/gotcha/ipdb/issues/172

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit 2888b1107fd0b43cc800987a00155bdbeacdb23a)

Co-authored-by: Godefroid Chapelle <gotcha@bubblenet.be>

gh-77521: Add link to builtin module names in modules tutorial (GH-92438)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit 859250cc55711f4d62b65922d3f7537826c3801e)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>

[3.10] gh-90622: Do not spawn ProcessPool workers on demand via fork method. (GH-91598) (GH-92497) (#92499)

Do not spawn ProcessPool workers on demand when they spawn via fork.

This avoids potential deadlocks in the child processes due to forking from
a multithreaded process..
(cherry picked from commit ebb37fc3fdcb03db4e206db017eeef7aaffbae84)

Co-authored-by: Gregory P. Smith <greg@krypto.org>
(cherry picked from commit b795376a628ae7cc354addbb926d724ebe364fec)

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

Fix use of the default role in a news entry. (GH-92500)

(cherry picked from commit 8883172893b6c3bb553cd22fc351e0206dec8388)

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

gh-92417: `logging` docs: Remove warning that only applies to Python <3.2 (GH-92425)

(cherry picked from commit 318c4e91ef166bcd5d513bb42b9156d54d423d4a)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

[3.9] gh-92417: `json` docs: `dict` is ordered on all supported Python versions (GH-92422) (GH-92466)

(cherry picked from commit bc098cfdb756f207d8fa84793e8ad91a2f263efb)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Automerge-Triggered-By: GH:serhiy-storchaka

[3.9] GH-92431: Fix footnotes in  Doc/c-api/exceptions.rst (GH-92432) (GH-92471)

* Remove redundant footnote ref: the footnote has been removed
* Fix footnote ref to match footnote
* Convert footnotes into reST footnotes: will error if missing
(cherry picked from commit 788ef54bc94b0a7aa2a93f626e4067ab8561424c)

Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
Automerge-Triggered-By: GH:serhiy-storchaka

[3.9] gh-77630: Change Charset to charset (GH-92439) (GH-92477)

(cherry picked from commit 8f293180791f2836570bdfc29aadba04a538d435)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>
Automerge-Triggered-By: GH:serhiy-storchaka

[3.9] gh-92417: `stdtypes` docs: delete discussion of Python 2 differences (GH-92423) (GH-92474)

Given that 2.7 has now been end-of-life for two and a half years,
I don't think we need such a detailed explanation here anymore of
the differences between Python 2 and Python 3.
(cherry picked from commit 8efda1e7c6343b1671d93837bf2c146e4cf77bbf)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Automerge-Triggered-By: GH:serhiy-storchaka

gh-92417: `typing` docs: `from __future__ import annotations` can be used in all supported Python versions (GH-92418)

(cherry picked from commit e5b4bd4d60aaf0292c5b9d628512145b8987b3c6)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

[3.9] gh-92448: Update the documentation builder to render the GitHub issue. (GH-92449). (GH-92458)

gh-92368: Fix missing possessive apostrophe (GH-92397)

* Fix missing possessive apostrophe
(cherry picked from commit a79001ee16b3ea8b5d0fad595c969d9e1b7627f3)

Co-authored-by: gophra <105054704+gophra@users.noreply.github.com>

gh-92047: Py_GetVersion multi-digit minor version (GH-92047) (GH-92048) (#92329)

(cherry picked from commit 43b135f94ebf3e6e84ddb0f75ed8510b96a610e4)

Co-authored-by: Robert Howlett <robert@howletts.org.uk>
Co-authored-by: Robert Howlett <robert@howletts.org.uk>

Add source for character mappings (GH-92014) (#92388)

(cherry picked from commit d707d073be5ecacb7ad341a1c1716f4998907d6b)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>
Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>

Document the lifetime of `PyUnicode_AsUTF8String` (GH-92325)

The current wording implied this, but didn't state it explicitly.
(cherry picked from commit 740da8d37a84638f4a8893bee3648f36fc6beb0f)

Co-authored-by: Matt Wozniski <godlygeek@gmail.com>

NEWS: Reorder items by section (GH-92373)

They caused duplicated sections.
(cherry picked from commit 9b491ae04c900579ec82776aacdf71b2fd1e9d6a)

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

[3.9] gh-80254: Disallow recursive usage of cursors in `sqlite3` converters (#92278)

* [3.9] gh-80254: Disallow recursive usage of cursors in `sqlite3` converters

(cherry picked from commit c908dc5b4798c311981bd7e1f7d92fb623ee448b)

Co-authored-by: Sergey Fedoseev <fedoseev.sergey@gmail.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* Fix ref leak in pysqlite_cursor_iternext

* Explicitly free resources at test tearDown()

gh-92223: Remove pre-Python 3.7 alternative in asyncio docs (GH-92224)

(cherry picked from commit d1b2e989be2bc5128d6602e4f370d0ee6f5ac476)

Co-authored-by: Sebastian Rittau <srittau@rittau.biz>

gh-92036: Fix gc_fini_untrack() (GH-92037)

Fix a crash in subinterpreters related to the garbage collector. When
a subinterpreter is deleted, untrack all objects tracked by its GC.
To prevent a crash in deallocator functions expecting objects to be
tracked by the GC, leak a strong reference to these objects on
purpose, so they are never deleted and their deallocator functions
are not called.
(cherry picked from commit 14243369b5f80613628a565c224bba7fb3fcacd8)

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

bpo-47029: Fix BrokenPipeError in multiprocessing.Queue at garbage collection and explicit close (GH-31913)

(cherry picked from commit dfb1b9da8a4becaeaed3d9cffcaac41bcaf746f4)

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

[3.9] Improve the typing docs (GH-92264) (#92271)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>.
(cherry picked from commit 27e366571590e9e98f61dccf69dbeaa88ee66737)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>

gh-87304: Improve comments in language reference for imports (GH-92164)

(cherry picked from commit ee2205b208389611e8a278ac1bc74b34f4994fd2)

Co-authored-by: Robert Yang <35813883+robert861212@users.noreply.github.com>

bpo-29890: Test IPv*Interface construction with tuple argument (GH-30862)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit b295a92c50b128e494f47c28f12b8e9eac2927ea)

Co-authored-by: Humbled Drugman <humbled.drugman@gmail.com>

bpo-46604: fix function name in ssl module docstring (GH-31064)

The function fetch_server_certificate is replaced by get_server_certificate in the module. I reflected the change in the module docstrings.

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit feca9bbd1f6489f2b6d2783bfc22fdb96e45b69f)

Co-authored-by: Kossi GLOKPOR <83467320+glk0@users.noreply.github.com>

bpo-46415: Use f-string for ValueError in ipaddress.ip_{address,network,interface} helper functions (GH-30642)

`IPv*Network` and `IPv*Interface` constructors accept a 2-tuple of
(address description, netmask) as the address parameter.
When the tuple-based address is used errors are not propagated
correctly through the `ipaddress.ip_*` helper because of the %-formatting now expecting several arguments:

In [7]: ipaddress.ip_network(("192.168.100.0", "fooo"))
        ...
TypeError: not all arguments converted during string formatting

Compared to:

In [8]: ipaddress.IPv4Network(("192.168.100.0", "foo"))
        ...
NetmaskValueError: 'foo' is not a valid netmask

Use an f-string to make sure the error is always properly formatted.

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit 52dc9c3066bcdc67a7a45d41cf158ecb1434d5f3)

Co-authored-by: Thomas Cellerier <thomascellerier@gmail.com>

[3.9] bpo-46586: Fix more erroneous doc links to builtins (GH-31429) (#92199)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Éric <merwok@netwok.org>.
(cherry picked from commit cc6ae4f4835f9e76a34f24cd1f666c1cc0fecfa3)

Co-authored-by: Meer Suri <46469858+meersuri@users.noreply.github.com>

[3.9] gh-91583: AC: Fix regression for functions with defining_class (GH-91739) (GH-92080)

Argument Clinic now generates the same efficient code as before
adding the defining_class parameter.
(cherry picked from commit a055dac0b45031878a8196a8735522de018491e3)

gh-92106: Add test that subscription works on arbitrary TypedDicts (GH-92176)

(cherry picked from commit 81fb3548be5a18bf40a6f4505a02cc7fb72c9c34)

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

bpo-46787: Fix `ProcessPoolExecutor exception` memory leak (GH-31408) (GH-31408)

Do not store `ProcessPoolExecutor` work item exception traceback that prevents
exception frame locals from being garbage collected.
(cherry picked from commit 9c204b148fad9742ed19b3bce173073cdec79819)

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

bpo-6686: Replace String with Bytes in xml.sax.handler documentation (GH-30612)

(cherry picked from commit 32e4f450af3fbcc5c7e186f83ff74e2efe164136)

Co-authored-by: Yassir Karroum <ukarroum17@gmail.com>

[3.9] Remove effbot urls (GH-26308). (#92162)

(cherry picked from commit e9f66aedf44ccc3be27975cfb070a44ce6a6bd13)

Co-authored-by: E-Paine <63801254+E-Paine@users.noreply.github.com>

gh-91783: Document security considerations for shutil.unpack_archive (GH-91844)

(cherry picked from commit 4b297a9ffd4a1d420c1a8016f4ed2c7f1d298469)

Co-authored-by: Sam Ezeh <sam.z.ezeh@gmail.com>

concurrent.futures: Fix typo in docstring (GH-92121)

(cherry picked from commit b11243e85e020ed2f524bdd83c339faf11ef03d4)

Co-authored-by: Yiannis Hadjicharalambous <hadjicharalambous.yiannis@gmail.com>

gh-88546: glob.glob docs: Make new paragraph for emphasis and reordered sentence (GH-91614)

(cherry picked from commit b9ab6cea0819bd498063f0934cb5bb0bb5a6a2d4)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>

asyncio.subprocess: Fix a typo in doc (GH-92030)

Remove a confusion for read method in asyncio-subprocess doc for stderr StreamReader instance
(cherry picked from commit bb857a96ef368ba9de1da2db12b1a1f1870606ac)

Co-authored-by: Harsh <65716674+Harsh-br0@users.noreply.github.com>

Fix typo in Programming FAQ (GH-92083)

I believe the word "with" was missing here.
(cherry picked from commit 2a7efa324274a54fe0e5480cae1438d8294b9ec3)

Co-authored-by: Matt Harding <majaharding@gmail.com>

gh-85133: os docs: Add that getenv uses os.environ (GH-91874)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit b25352a5c039d95e019dd8ca111f6f77c43ca1f7)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>

gh-84714: Add behavior if dst file exists (GH-91867)

(cherry picked from commit 9166ace805d915c8a918cd89fff0e58b65e3327c)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>

[3.9] gh-81488: Add recursive wording for issubclass docs (GH-92087) (#92131)

(cherry picked from commit 1066ecb97042b8e89de554e6f9dc2e3d634208c0)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>

bpo-36819: Fix crashes in built-in encoders with weird error handlers (GH-28593)

If the error handler returns position less or equal than the starting
position of non-encodable characters, most of built-in encoders didn't
properly re-size the output buffer. This led to out-of-bounds writes,
and segfaults.
(cherry picked from commit 18b07d773e09a2719e69aeaa925d5abb7ba0c068)

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

gh-85679: Recommend `encoding="utf-8"` in tutorial (GH-91778)

(cherry picked from commit 614420df9796c8a4f01e24052fc0128b4c20c5bf)

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

[3.9] build(deps): bump actions/cache from 3.0.1 to 3.0.2 (GH-92111) (#92125)

Bumps [actions/cache](https://github.com/actions/cache) from 3.0.1 to 3.0.2.
- [Release notes](https://github.com/actions/cache/releases)
- [Changelog](https://github.com/actions/cache/blob/main/RELEASES.md)
- [Commits](https://github.com/actions/cache/compare/v3.0.1...v3.0.2)

---
updated-dependencies:
- dependency-name: actions/cache
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>.
(cherry picked from commit eefe6911f4f497e8b73e0690f9b3f47904fdb02a)

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

[3.9] gh-92049: Forbid pickling constants re._constants.SUCCESS etc (GH-92070) (GH-92073) (GH-92102)

Previously, pickling did not fail, but the result could not be unpickled.
(cherry picked from commit 6d0d547033e295f91f05030322acfbb0e280fc1f)
(cherry picked from commit e8ff3c92f69b475aa20ba7c08efccbc329f9b42e)

typing docs: Add example for async functions (GH-20386)

Fixes python/typingGH-424
(cherry picked from commit 9588f880a286a8cc5597188f6ab44108c8f18761)

Co-authored-by: Sam Bull <aa6bs0@sambull.org>

gh-91611: Use example.com for documentation, not mydomain.com (GH-91613)

example.com is reserved by the IANA as special-use domain name for documentation
purposes. The domain names are used widely in books, tutorials, sample network
configurations, and generally as examples for the use of domain name.

On the other hand, mydomain.com is real Domain Name Registration service.
(cherry picked from commit ea392467829d6e93f824bde8eb87bdb31d9e4c62)

Co-authored-by: Motoki Naruse <motoki@naru.se>

gh-87801: Add run() to subprocess.CalledProcessError description (GH-91628)

(cherry picked from commit 567be058b403db9689af45bf831d4c732c8b1105)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>

gh-87192: Update wording for fcntl 'Changed in' (GH-91658)

(cherry picked from commit d7eb1ffbe8f913693e4c9ffa1b32edccac987ab6)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>

gh-85864: io docs: Add missing position-only parameters (GH-91950)

(cherry picked from commit 3a8e2b6e65fea1252477f6e29a384fa9a492ed06)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>

bpo-43323: Fix UnicodeEncodeError in the email module (GH-32137)

It was raised if the charset itself contains characters not encodable
in UTF-8 (in particular \udcxx characters representing non-decodable
bytes in the source).
(cherry picked from commit e91dee87edcf6dee5dd78053004d76e5f05456d4)

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

sorting howto: Add clarification on < using __lt__ (GH-92010)

(cherry picked from commit 53ca774497fde7c5fcf3a84813ea42f95f75c639)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>

bpo-26792: Improve docstrings of runpy module run_functions (GH-30729)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
(cherry picked from commit 117836f123a1c65d9ba50401822b883f11f0a347)

Co-authored-by: Humbled Drugman <humbled.drugman@gmail.com>

gh-91832: Add 'required' attr to argparse.Action repr (GH-91841)

GH- Adding 'required' to names in Lib.argparse.Action

gh-91832:
Added 'required' to the list `names` in `Lib.argparse.Action`.
Changed constant strings that test the Action object.

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

Co-authored-by: Abhigyan Bose <abhigyandeepbose@gmail.com>

Add note that headers added via urllib.request.add_header are added to redirected requests (GH-30708) (#92005)

(cherry picked from commit f348154c8f8a9c254503306c59d6779d4d09b3a9)

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

gh-84459: Make wording more specific for Path.replace (GH-91853)

GH-84459
(cherry picked from commit 161dff7e10eeb7eaf6d418b91e993aaf84770a5c)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>

[3.9] gh-91810: Expand ElementTree.write() tests to use non-ASCII data (GH-91989). (GH-91994)

(cherry picked from commit f60b4c3d74f241775f80affe60dcba6448634fe3)

gh-68966: Document mailcap deprecation in Python 3.11 (GH-91971)

(cherry picked from commit 80de0273c0caf8bae19787bb00255eb3fb2a2d0c)
(cherry picked from commit a36d97e3f1daeb431e1c5bc8ab83daca93b747b0)

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

Fix missing `f` prefix on f-strings (GH-91910)

(cherry picked from commit f882d33778ee2625ab32d90e28edb6878fb8af93)

Co-authored-by: Alexander Shadchin <alexandr.shadchin@gmail.com>

gh-91914: Fix test_curses on non-UTF-8 locale (GH-91919)

(cherry picked from commit f41c16bf512778fca4bfabca887c4c303cc21896)

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

gh-91916: Fix test_runpy on non-UTF-8 locale (GH-91920)

If use a non-builtin codec, partially implemented in Python
(e.g. ISO-8859-15), a new RecursionError (with empty error message)
can be raised while handle a RecursionError.

Testing for error message was needed to distinguish
a recursion error from arbitrary RuntimeError. After introducing
RecursionError, it became unnecessary.
(cherry picked from commit a568585069174cec35ce26cdf4d4862c634d9f6d)

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

[3.9] gh-91888: add a `:gh:` role to the documentation (GH-91889) (#91935)

* gh-91888: Add a :gh: role to the documentation (GH-91889).

* [3.9] gh-91888: add a `:gh:` role to the documentation (GH-91889)

* Add a new :gh:`...` role for GitHub issues.

* Fix a GitHub id to use the :gh: role.

* Add Misc/NEWS entry.

* Refactoring and rephrasing.

Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>.
(cherry picked from commit f7641a2ffec243e5f600028a84debe9028a9ee44)

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

[3.9] Update Sphinx bpo role to use redirect URI. (#91891)

* Update Sphinx bpo role to use redirect URI. (GH-32342)

* [3.9] Update Sphinx bpo role to use redirect URI. (GH-32342).
(cherry picked from commit 08cfe079503ffd19d8b7ab324f0fdb1c6b150ca8)

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

[3.9] gh-85864: Mark positional-only args in io docs (GH-91683). (#91848)

(cherry picked from commit a3f2cf3ced378db2569df4e7389ec1f79c85d55c)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>

RE: Add more tests for inline flag "x" and re.VERBOSE (GH-91854)

(cherry picked from commit 6b45076bd62407103433daea8acf085a99e6cb7e)

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

gh-91547: Remove "Undocumented modules" page (GH-91682)

(cherry picked from commit 254aaa7981d8773658fb14795da5dec888c95f93)

Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>

[3.9] gh-91575: Update case-insensitive matching in re to the latest Unicode version (GH-91580). (GH-91661) (GH-91837)

(cherry picked from commit 1c2fcebf3c5e2ab41d376bb481834445617c8f3c)
(cherry picked from commit 1748816e80b23744667e239b49b477c0e283d201)

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

[3.9] gh-91700: Validate the group number in conditional expression in RE (GH-91702) (GH-91831) (GH-91836)

In expression (?(group)...) an appropriate re.error is now
raised if the group number refers to not defined group.

Previously it raised RuntimeError: invalid SRE code.
(cherry picked from commit 48ec61a89a959071206549819448405c2cea61b0)
(cherry picked from commit 080781cd49b13da4a73db87b6f5e0c7aeec83e92)

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

[3.9] gh-90568: Fix exception type for \N with a named sequence in RE (GH-91665) (GH-91830) (GH-91834)

re.error is now raised instead of TypeError.
(cherry picked from commit 6ccfa31421393910b52936e0447625db06f2a655)
(cherry picked from commit 9c18d783c38fca57a63b61aa778d8a8d18945d95)

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

[3.9] build(deps): bump actions/upload-artifact from 2.3.1 to 3 (GH-32227) (#91749)

Bumps [actions/upload-artifact](https://github.com/actions/upload-artifact) from 2.3.1 to 3.
- [Release notes](https://github.com/actions/upload-artifact/releases)
- [Commits](https://github.com/actions/upload-artifact/compare/v2.3.1...v3)

---
updated-dependencies:
- dependency-name: actions/upload-artifact
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>.
(cherry picked from commit b8812c9ca3f6864a233574001e16f1b9e92daf6e)

[3.9] build(deps): bump actions/cache from 2.1.7 to 3.0.1 (GH-32228) (#91747)

Bumps [actions/cache](https://github.com/actions/cache) from 2.1.7 to 3.0.1.
- [Release notes](https://github.com/actions/cache/releases)
- [Changelog](https://github.com/actions/cache/blob/main/RELEASES.md)
- [Commits](https://github.com/actions/cache/compare/v2.1.7...v3.0.1)

---
updated-dependencies:
- dependency-name: actions/cache
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>.
(cherry picked from commit 3ace1034b8202bc7034e15f34561725934f04ff6)

bpo-40859: Update Windows build to use xz-5.2.5 (GH-20622)

Co-authored-by: Ma Lin <animalize@users.noreply.github.com>
(cherry picked from commit 73af4b0264aeb866536b01a132f8c26a5808d64d)

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

bpo-23747: Enhance platform doc, document default behavior (GH-31462)

(cherry picked from commit ad3ca17ff5cd63f907430073b52be27695674148)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>

[3.9] build(deps): bump actions/checkout from 2 to 3 (GH-32226) (#91722)

Bumps [actions/checkout](https://github.com/actions/checkout) from 2 to 3.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v2...v3)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>.
(cherry picked from commit 1ba63e3a9bb176e5ad8e8dd744b9d2b9d588e275)

gh-91734: Fix ossaudio support on Solaris (GH-91735)

(cherry picked from commit 4420faf273e9e2d03226a9375e1e04a336230c84)

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

bpo-30718: Add information about text buffering (GH-32351)

(cherry picked from commit 5101d97d0b13425ccc5ed37abfabb07701db81fe)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>

Add link to sys.path in os lib (GH-91679)

(cherry picked from commit 692aea6f3823df48b7fc267ba0aa1ccc45ac606d)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>

Fix awkward sentence in signal docs (GH-91508)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit 326ae71f1d93c12100150baa1173ea7ce7a96ea0)

Co-authored-by: AJ Jordan <alex@strugee.net>

build(deps): bump actions/setup-python from 2 to 3 (GH-31630)

Bumps [actions/setup-python](https://github.com/actions/setup-python) from 2 to 3.
- [Release notes](https://github.com/actions/setup-python/releases)
- [Commits](https://github.com/actions/setup-python/compare/v2...v3)

---
updated-dependencies:
- dependency-name: actions/setup-python
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit 74e319239b0a2a5ef8bc27670f4f533ee701d57f)

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