gh-92417: `fractions`, `decimal`: Improve docs for alternative constructor methods (GH-92421) (GH-92971)

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

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

gh-92417: `socket` docs: remove references to Python <3.3 (GH-92544) (GH-92969)

(cherry picked from commit 639b62c9c479e38a6f91a80b261097574a1e7ac7)

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

bpo-45393: help() on operator precedence has misleading entries (GH-31246) (GH-92966)

(cherry picked from commit fb082c2fc5a925085b179e63ca10b7f60b356d2f)

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

gh-92417: Update docs and examples of doctest.IGNORE_EXCEPTION_DETAIL for Py>=3 (GH-92502) (GH-92963)

(cherry picked from commit 97b9c1096feff77a564787ef520cc7d4e1d1c45f)

gh-92670: Skip test_shutil.TestCopy.test_copyfile_nonexistent_dir on AIX (GH-92718)

(cherry picked from commit 654032ac5f6982b36d45e024037f37fb65166aed)

Co-authored-by: Ayappan Perumal <ayappap2@in.ibm.com>

Doc: amend ssl.PROTOCOL_SSLv2 and ssl.PROTOCOL_SSLv3 wording (GH-92634)

(cherry picked from commit 41638967a0e0bf1114c9bba9454d081605b49009)

Co-authored-by: Jan Brasna <1784648+janbrasna@users.noreply.github.com>

gh-92812: Align ArgumentParser.add_subparsers() docs with argument spec (GH-92814)

(cherry picked from commit f2d994da104eed38f9e110e7d8f37fa6d845b207)

Co-authored-by: 180909 <734461790@qq.com>

bpo-40838: document `getdoc`, `getmodule`, `getsourcefile` in `inspect` returns `None` (GH-30575)

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

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>

gh-92780: Improve sqlite3.Connection.create_collation docs (GH-92790)

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

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

gh-91755: Document Py_IncRef and Py_DecRef as C functions (GH-91805)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit 58a3d28039863b014f57a1ac93b51e20920ebe7b)

Co-authored-by: Charlie Zhao <zhaoyu_hit@qq.com>

bpo-39829: Fix `__len__()` is called twice in list() constructor (GH-31816)

(cherry picked from commit 2153daf0a02a598ed5df93f2f224c1ab2a2cca0d)

This patch fixes gh-87740 too.

Co-authored-by: Crowthebird <78076854+thatbirdguythatuknownot@users.noreply.github.com>

Fix NULL test in _testinternalcapi (GH-92861)

(cherry picked from commit 702e0da000bf28aa20cb7f3893b575d977506495)

Co-authored-by: Dennis Sweeney <36520290+sweeneyde@users.noreply.github.com>

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

(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-92830)

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>

Speedup: build docs in parallel (GH-92733) (GH-92850)

(cherry picked from commit a487623c6b784847a8a1e47b4597b0ae2b8def87)

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>

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

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>

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

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>

[3.10] gh-92311: Let frame_setlineno jump over listcomps (GH-92717)

gh-92436: __future__ docs: add note on expectations for "from __future__ import annotations" (GH-92568)

(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>

Fix minor documentation error in bisect docs (GH-92697)

(cherry picked from commit b3f99b69d03cf0ea72a567a81e8bc4bc074ab303)

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

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

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.10] Fix typo in unittest.rst: addCleanupModule -> addModuleCleanup (GH-92631) (GH-92660)

(cherry picked from commit 38486ca212c0827d54e7b0d0b1e2c1ccc2bdad33)

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

gh-91966 Document where key functions are applied in the bisect module (GH-92602) (#92666)

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

* [3.10] 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>

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

(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>

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>

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>

bpo-39229: fix formatting in library/functions.rst (GH-17857)

Missing reference of auditing event presents error when building translated documentation
(cherry picked from commit f298ba1f2712ad10530a30bb225548a6889820b5)

Co-authored-by: Rafael Fontenelle <rffontenelle@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>

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

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

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>

gh-80856: doc: reveal doctest directives (GH-92318)

* Doc: Reveal doctest directives.

* Fix whitespace.

Co-authored-by: Julien Palard <julien@palard.fr>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
(cherry picked from commit 7b024e3a3f77027f747da7580ed0a3ed2dec276a)

Co-authored-by: Davide Rizzo <sorcio@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.10] gh-92417: `asyncio` docs: `asyncio.run()` is available on all supported Python versions (GH-92419) (GH-92463)

(cherry picked from commit f4e317b304c7f86e48885b4b74c7a8826648922c)

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

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

(cherry picked from commit bc098cfdb756f207d8fa84793e8ad91a2f263efb)

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

[3.10] gh-92417: `doctest` docs: remove references to Python <3.6 (GH-92420) (GH-92468)

(cherry picked from commit 5639ea1ef9ba8452f81b61ad73152bd1bf1fd3a6)

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

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

* 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.10] gh-77630: Change Charset to charset (GH-92439) (GH-92476)

(cherry picked from commit 8f293180791f2836570bdfc29aadba04a538d435)

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

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

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.10] gh-92448: Update the documentation builder to render the GitHub issue (GH-92449). (GH-92457)

[3.10] gh-92112: Fix crash triggered by an evil custom `mro()` (GH-92113) (#92370)

(cherry picked from commit 85354ed78c0edb6d81a2bd53cabc85e547b8b26e)

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

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) (#92330)

(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) (#92389)

(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>

Issues/88027: A potential double free in list_sort_impl (GH-92367)

merge_freemem(): set keys to NULL do it's harmless to call this again.
(cherry picked from commit 9652900969df77b1ac245595419431df19296af9)

Co-authored-by: Tim Peters <tim.peters@gmail.com>

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

* [3.10] gh-80254: Disallow recursive usage of cursors in `sqlite3` converters (#29054)

(cherry picked from commit f629dcfe835e349433e4c5099381d668e8fe69c8)

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

[3.10] gh-92118: Add test for traceback when exception is modified by (Async)ExitStack.__exit__ (GH-92339) (GH-92343)

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.10] Improve the typing docs (GH-92264) (#92270)

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.10] gh-91583: AC: Fix regression for functions with defining_class (GH-91739) (GH-92079)

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-46586: Fix more erroneous doc links to builtins (GH-31429)

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>

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>

importlib docs: Update importlib.abc hierarchy (GH-31113)

Fixed some inconsistencies in the text about relationships
(cherry picked from commit 5f45a9d3c3de97a4eafedb60ecea224a78bae52c)

Co-authored-by: David Gilbertson <gilbertson.david@gmail.com>

[3.10] bpo-43504: Remove effbot urls (GH-26308) (#92161)

* [3.10] Remove effbot urls (GH-26308).
(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>

[3.10] Fix typo in Programming FAQ (GH-92083) (GH-92148)

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

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

gh-92082: contextlib docs: Change aclosing from a class to a function for consistency (GH-92155)

Signed-off-by: prwatson <prwatson@redhat.com>
(cherry picked from commit 958f21c5cdb3bbbd16fec87164785cff3dacce96)

Co-authored-by: Thaddeus1499 <104600742+Thaddeus1499@users.noreply.github.com>

[3.10] gh-89301: Fix regression with bound values in traced SQLite statements (#92147)

(cherry picked from commit 721aa96540bb96700f8c4bab0b4095b43491dca1)

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

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)

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>

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>

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.10] build(deps): bump actions/stale from 4 to 5 (GH-92108) (#92127)

Bumps [actions/stale](https://github.com/actions/stale) from 4 to 5.
- [Release notes](https://github.com/actions/stale/releases)
- [Changelog](https://github.com/actions/stale/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/stale/compare/v4...v5)

---
updated-dependencies:
- dependency-name: actions/stale
  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 34129f7c42b31d12d8ed692cd3f82c8d36c6c644)

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.10] gh-91401: Conservative backport of `subprocess._USE_VFORK` (#91932)

This does not alter the `_posixsubprocess.fork_exec()` private API to
avoid issues for anyone relying on that (bad idea) or for anyone who's
`subprocess.py` and `_posixsubprocess.so` upgrades may not become
visible to existing Python 3.10 processes at the same time.

Backports the concept of cd5726fe674eaff442510eeb6c75628858be9e9f.

Provides a fail-safe way to disable vfork for #91401.

I didn't backport the documentation as I don't actually expect this to be used and `.. versionadded: 3.10.5` always looks weird in docs. It's being done more to have a fail-safe in place for people just in case.

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-81488: Add recursive wording for issubclass docs (GH-92087)

(cherry picked from commit 1066ecb97042b8e89de554e6f9dc2e3d634208c0)

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

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-89253: Add 3.10 whatsnew section for itertools.pairwise (GH-91563)

GH-89253

[`pairwise()`](https://docs.python.org/3/library/itertools.htmlGH-itertools.pairwise) already has the 'new in python3.10'

Automerge-Triggered-By: GH:rhettinger
(cherry picked from commit 5dcfb916c765d825b2e8372281d71d32316b41cf)

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

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>

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

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

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) (#92004)

(cherry picked from commit f348154c8f8a9c254503306c59d6779d4d09b3a9)

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