[3.13] GH-125722: Use long options for Sphinx (GH-129039) (#129041)

GH-125722: Use long options for Sphinx (GH-129039)
(cherry picked from commit 4967fa6a9c0db7ea3ade905d724a04688cfc7a5e)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>

[3.13] GH-125722: Increase minimum supported Sphinx to 8.1.3 (GH-128922) (#129037)

(cherry picked from commit d46b577ec026c2e700a9f920f81cfbf698e53eb6)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>

[3.13] gh-129020: Remove ambiguous sentence from `tokenize.untokenize` docs (GH-129021) (#129035)

gh-129020: Remove ambiguous sentence from `tokenize.untokenize` docs (GH-129021)
(cherry picked from commit bca35f0e782848ae2acdcfbfb000cd4a2af49fbd)

Co-authored-by: Tomas R <tomas.roun8@gmail.com>

[3.13] gh-80222: Fix email address header folding with long quoted-string (GH-122753) (#129007)

gh-80222: Fix email address header folding with long quoted-string (GH-122753)

Email generators using email.policy.default could incorrectly omit the
quote ('"') characters from a quoted-string during header refolding,
leading to invalid address headers and enabling header spoofing. This
change restores the quote characters on a bare-quoted-string as the
header is refolded, and escapes backslash and quote chars in the string.
(cherry picked from commit 5aaf41685834901e4ed0a40f4c055b92991a0bb5)

Co-authored-by: Mike Edmunds <medmunds@gmail.com>

[3.13] gh-128679: Fix tracemalloc.stop() race conditions (#128897)

tracemalloc_alloc(), tracemalloc_realloc(), PyTraceMalloc_Track(),
PyTraceMalloc_Untrack() and _PyTraceMalloc_TraceRef() now check
tracemalloc_config.tracing after calling TABLES_LOCK().

_PyTraceMalloc_Stop() now protects more code with TABLES_LOCK(),
especially setting tracemalloc_config.tracing to 1.

Add a test using PyTraceMalloc_Track() to test tracemalloc.stop()
race condition.

Call _PyTraceMalloc_Init() at Python startup.

[3.13] gh-128991: Release the enter frame reference within bdb callba… (#129002)

[3.13] gh-128991: Release the enter frame reference within bdb callback (GH-128992)

* Release the enter frame reference within bdb callback

* 📜🤖 Added by blurb_it.

---------

(cherry picked from commit 61b35f74aa4a6ac606635e245147ff3658628d99)

[3.13] gh-128998: Fix indentation of numbered list and literal block (GH-128999) (#129000)

gh-128998: Fix indentation of numbered list and literal block (GH-128999)
(cherry picked from commit e8092e5cdcd6707ac0b16d8fb37fa080a88bcc97)

Co-authored-by: Rafael Fontenelle <rffontenelle@users.noreply.github.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>

[3.13] Pre-commit: Drop specific language version and bump hooks (GH-128801) (#128994)

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>

[3.13] gh-121542: Document trailing newline behavior in `set_content()` (GH-121543) (#128995)

gh-121542: Document trailing newline behavior in `set_content()` (GH-121543)
(cherry picked from commit fba475ae6f932d0aaee6832b4102b2d4c50df70f)

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
Co-authored-by: Yizheng Meng <dev@rapidcow.org>

[3.13] gh-127599: Fix _Py_RefcntAdd missing calls to _Py_INCREF_STAT_INC/_Py_INCREF_IMMORTAL_STAT_INC (GH-127717) (#128713)

Previously, `_Py_RefcntAdd` hasn't called
`_Py_INCREF_STAT_INC/_Py_INCREF_IMMORTAL_STAT_INC` which is incorrect.

Now it has been fixed.
(cherry picked from commit ab05beb8cea62636bd86f6f7cf1a82d7efca7162)

[3.13] gh-111495: Add more tests on PyEval C APIs (#122789) (#128987)

* gh-111495: Add more tests on PyEval C APIs (#122789)

* Add Lib/test/test_capi/test_eval.py
* Add Modules/_testlimitedcapi/eval.c

(cherry picked from commit bf8b3746398ea756c97e3cf263d63ca3ce3a544e)

* gh-111495: Fix refleaks in test_capi.test_eval tests (#122851)

(cherry picked from commit b4a316087c32d83e375087fd35fc511bc430ee8b)

[3.13] gh-125997: suggest efficient alternatives for `time.sleep(0)` (GH-128752) (#128984)

gh-125997: suggest efficient alternatives for `time.sleep(0)` (GH-128752)
(cherry picked from commit f4afaa6f1190fbbea3e27c590096951d8ffdfb71)

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>

[3.13] gh-128961: Fix exhausted array iterator crash in __setstate__() (GH-128962) (#128976)

(cherry picked from commit 4dade055f4e18a7e91bc70293abb4db745ad16ca)

Co-authored-by: Tomasz Pytel <tompytel@gmail.com>

[3.13] gh-128916: Do not set `SO_REUSEPORT` on non-`AF_INET*` sockets (GH-128933) (#128969)

gh-128916: Do not set `SO_REUSEPORT` on non-`AF_INET*` sockets (GH-128933)

* gh-128916: Do not set `SO_REUSEPORT` on non-`AF_INET*` sockets

Do not attempt to set ``SO_REUSEPORT`` on sockets of address familifies other
than ``AF_INET`` and ``AF_INET6``, as it is meaningless with these address
families, and the call with fail with Linux kernel 6.12.9 and newer.

* Apply suggestions from code review

---------
(cherry picked from commit 3829104ab412a47bf3f36b8c133c886d2cc9a6d4)

Co-authored-by: Michał Górny <mgorny@gentoo.org>
Co-authored-by: Vinay Sajip <vinay_sajip@yahoo.co.uk>

[3.13] Fix definition of a `generator iterator` in `glossary.rst` (GH-128952) (#128967)

Fix definition of a `generator iterator` in `glossary.rst` (GH-128952)

Fix possible typo/grammar in glossary.rst

As discussed in https://discuss.python.org/t/typo-in-glossary-entry-for-generator-iterator/77163
(cherry picked from commit 8174770d311ba09c07a47cc3ae90a1db2e7d7708)

Co-authored-by: Daniel F Moisset <dfmoisset@gmail.com>

[3.13] gh-128911: Add tests on the PyImport C API (#128915) (#128960)

gh-128911: Add tests on the PyImport C API (#128915)

* Add Modules/_testlimitedcapi/import.c
* Add Lib/test/test_capi/test_import.py
* Remove _testcapi.check_pyimport_addmodule(): tests already covered
  by newly added tests.

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
(cherry picked from commit d95ba9fa1110534b7247fa2ff12b90e930c93256)

[3.13] gh-58956: Fix a frame refleak in bdb (GH-128190) (#128947)

* gh-58956: Fix a frame refleak in bdb (GH-128190)
(cherry picked from commit 767c89ba7c5a70626df6e75eb56b546bf911b997)

Co-authored-by: Tian Gao <gaogaotiantian@hotmail.com>

[3.13] gh-128017: Make a note that sys variables are read-only (GH-128887) (#128908)

Co-authored-by: Srinivas Reddy Thatiparthy (తాటిపర్తి శ్రీనివాస్ రెడ్డి) <thatiparthysreenivas@gmail.com>

[3.13] gh-58689: Fix os.kill() error handling on Windows (GH-128932) (#128937)

gh-58689: Fix os.kill() error handling on Windows (GH-128932)
(cherry picked from commit 939df0f9f6a76e0916b3ba53841e1413ab90952e)

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

[3.13] gh-128816: Fix warnings in test_doctest (GH-128817) (GH-128870)

* Fix a deprecation warning for using importlib.resources.abc.ResourceReader.
* Fix an import warning when importing readline (if it has not yet been imported).
(cherry picked from commit 599be687ec7327c30c6469cf743aa4ee9e82232d)

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

[3.13] gh-97850: Suggest `TraversableResources` as the alternative for `ResourceLoader` (GH-128601) (GH-128895)

gh-97850: Suggest `TraversableResources` as the alternative for `ResourceLoader` (GH-128601)

Suggest TraversableResources as the alternative for ResourceLoader.

Previously, ResourceReader was the suggested alternative, but it
is itself deprecated in favour of TraversableResources.
(cherry picked from commit 256d6d2131541b3ff8f06f42c8157f808fde464c)

Co-authored-by: Tomas R <tomas.roun8@gmail.com>

[3.13] gh-67206: Document that `string.printable` is not printable in the POSIX sense (GH-128820) (#128868)

gh-67206: Document that `string.printable` is not printable in the POSIX sense (GH-128820)
(cherry picked from commit d906bde250d59c396d8dab92285b832c66cdec27)

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>

[3.13] gh-128874: Fix the documentation for blurb 2.0 (GH-128875) (#128877)

gh-128874: Fix the documentation for blurb 2.0 (GH-128875)
(cherry picked from commit 40a4d88a14c741172a158683c39d232c587c6f11)

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

[3.13] gh-106320: Document replacement for removed C API (GH-128787) (#128837)

gh-106320: Document replacement for removed C API (GH-128787)
(cherry picked from commit 43ef9587ae869fd11711a3bb126e65afe9177342)

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

[3.13] Fix a "doctest" block in `Doc/library/turtle.rst` (GH-128831) (#128835)

Fix a "doctest" block in `Doc/library/turtle.rst` (GH-128831)
(cherry picked from commit 1598e18a659ef3a533caa0a79a489a3ed1d80bdd)

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

[3.13] gh-109959: Skip test_glob.test_selflink() flaky test (GH-128812) (#128821)

gh-109959: Skip test_glob.test_selflink() flaky test (GH-128812)
(cherry picked from commit 1153e66e20124b8f3484bcaddbc0e252d31161a6)

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

[3.13] gh-128717: Stop-the-world when setting the recursion limit (GH-128741) (#128757)

[3.13] gh-128717: Stop-the-world when setting the recursion limit (GH-128741)
(cherry picked from commit f6c61bf2d7d8b66ccd9f16e723546bdcc251a3d0)

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>

[3.13] gh-125997: Increase test coverage for `time.sleep()` (GH-128751) (#128796)

gh-125997: Increase test coverage for `time.sleep()` (GH-128751)

- Add tests for durations of invalid types.
- Add tests for `int` and `float` durations, including signed zeroes durations.
- Add tests for nonzero very small durations and durations close to the clock resolution.

---------
(cherry picked from commit b70a567575db37846beecbe8b40fb56b875274db)

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
Co-authored-by: Victor Stinner <vstinner@python.org>

[3.13] Explicitly import `urllib.error` in `urllib.robotparser` (GH-128737) (#128793)

Explicitly import `urllib.error` in `urllib.robotparser` (GH-128737)
(cherry picked from commit 53e8942e6938df3a32b783815f1bd4b76eed3dd0)

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>

[3.13] gh-128731: Explicitly close socket on error in robotparser.RobotFileParser.read() (GH-128733) (GH-128755)

(cherry picked from commit 5e65a1acc0b630397f1d190aed279114e6e99612)

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

[3.13] gh-128562: Fix generation of the tkinter widget names (GH-128604) (GH-128791)

There were possible conflicts if the widget class name ends with a digit.
(cherry picked from commit da8825ea95a7096bb4f933d33b212a94ade10f6e)

Co-authored-by: Zhikang Yan <2951256653@qq.com>

[3.13] gh-128078: Clear exception in `anext` before calling `_PyGen_SetStopIterationValue` (GH-128780) (#128785)

gh-128078: Clear exception in `anext` before calling `_PyGen_SetStopIterationValue` (GH-128780)
(cherry picked from commit 76ffaef729c91bb79da6df2ade48f3ec51118300)

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
Co-authored-by: Kumar Aditya <kumaraditya@python.org>

[3.13] gh-128759: fix data race in `type_modified_unlocked` (GH-128764) (#128769)

* gh-128759: fix data race in `type_modified_unlocked` (GH-128764)
(cherry picked from commit 6e1e78054060ad326f26dd8dbf12adfedbb52883)

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

[3.13] gh-128595: Add test class helper to force no terminal colour (GH-128687) (#128778)

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

[3.13] gh-123345: improve `fnmatch` docs (GH-123346) (#128776)

gh-123345: improve `fnmatch` docs (GH-123346)
(cherry picked from commit 29fe8072cf404b891dde9c1d415095edddbe19de)

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>

[3.13] gh-128409: Document that pdb.post_mortem() accepts exceptions … (#128767)

* [3.13] gh-128409: Document that pdb.post_mortem() accepts exceptions (GH-128410)
(cherry picked from commit 1b39b502d33c68f52fd775c4e6c2174baddd40bd)

Co-authored-by: Adam Johnson <me@adamj.eu>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>

[3.13] gh-128734: Explicitly close sockets in urllib tests (GH-128735) (GH-128748)

(cherry picked from commit 5ace71713b03cb37d829f50c849a8bb8a518738d)

[3.13] gh-127614: Correctly check for ttyname_r() in configure (#128503) (#128598)

(cherry picked from commit e08b28235a863323ca3a7e444776bb7803e77caf)

PR #14868 replaced the ttyname() call with ttyname_r(), but the old
check remained.

[3.13] gh-128302: Fix bugs in xml.dom.xmlbuilder (GH-128284) (#128582)

gh-128302: Fix bugs in xml.dom.xmlbuilder (GH-128284)

* Allow DOMParser.parse() to correctly handle DOMInputSource instances
  that only have a systemId attribute set.
* Fix DOMEntityResolver.resolveEntity(), which was broken by the
  Python 3.0 transition.
* Add Lib/test/test_xml_dom_xmlbuilder.py with few tests.
(cherry picked from commit 6ea04da27036eaa69d65150148bb8c537d9beacf)

Co-authored-by: Stephen Morton <git@tungol.org>

[3.13] gh-118915: Document `PyUnstable_InterpreterState_GetMainModule` (GH-128483) (GH-128677)

(cherry picked from commit ea39c8b08d8f025273bfa5b7a95f7b5984dc1e86)

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>

[3.13] gh-126862: Use `Py_ssize_t` instead of `int` when processing the number of super-classes  (GH-127523) (#128699)

gh-126862: Use `Py_ssize_t` instead of `int` when processing the number of super-classes  (GH-127523)
(cherry picked from commit 2fcdc8488c32d18f4567f797094068a994777f16)

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>

[3.13] gh-127196: Fix crash in `_interpreters`, when `shared` had invalid encodings (GH-127220) (#128689)

gh-127196: Fix crash in `_interpreters`, when `shared` had invalid encodings (GH-127220)
(cherry picked from commit 087bb48acac997c06e69dae25bae2dd75194b980)

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

[3.13] gh-124433: fix docs for `asyncio.Queue.task_done` (GH-128669) (#128671)

gh-124433: fix docs for `asyncio.Queue.task_done` (GH-128669)
(cherry picked from commit 4322a318ea98ceeb95d88b7ae6b5cfa3572d2069)

Co-authored-by: Kumar Aditya <kumaraditya@python.org>

[3.13] gh-126137: improve docs for `loop.add_reader` and `loop.add_writer` (GH-128666) (#128667)

gh-126137: improve docs for `loop.add_reader` and `loop.add_writer` (GH-128666)
(cherry picked from commit b2adf556747d080f04b53ba4063b627c2dbe41d1)

Co-authored-by: Kumar Aditya <kumaraditya@python.org>

[3.13] gh-79149: document reentrant safety of `loop.call_soon_threadsafe` (GH-128662) (#128664)

gh-79149: document reentrant safety of `loop.call_soon_threadsafe` (GH-128662)
(cherry picked from commit 4685401845ba3e2ab8c9f4a9a10aa2969b11985f)

Co-authored-by: Kumar Aditya <kumaraditya@python.org>
Co-authored-by: Thomas Grainger <tagrain@gmail.com>

[3.13] gh-128552: fix refcycles in eager task creation (#128553) (#128585)

gh-128552: fix refcycles in eager task creation (#128553)

(cherry picked from commit 61b9811ac6843e22b5896ef96030d421b79cd892)

[3.13] gh-128615: Cover pickling of `ParamSpecArgs` and `ParamSpecKwargs` (GH-128616) (#128625)

gh-128615: Cover pickling of `ParamSpecArgs` and `ParamSpecKwargs` (GH-128616)
(cherry picked from commit 74a517181a9bb65a1f6da149af7427a9fcb3add3)

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

[3.13] gh-128613: Increase `typing.Concatenate` coverage (GH-128614) (#128623)

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

[3.13] gh-41872: Fix quick extraction of module docstrings from a file in pydoc (GH-127520) (GH-128620)

It now supports docstrings with single quotes, escape sequences,
raw string literals, and other Python syntax.

(cherry picked from commit 474e419792484d1c16e7d9c99b7bf144136b9307)

Co-authored-by: Srinivas Reddy Thatiparthy (తాటిపర్తి శ్రీనివాస్ రెడ్డి) <thatiparthysreenivas@gmail.com>
Co-authored-by: Éric <merwok@netwok.org>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

[3.13] gh-128617: Fix `test_typing.test_readonly_inheritance` (GH-128618) (#128622)

gh-128617: Fix `test_typing.test_readonly_inheritance` (GH-128618)
(cherry picked from commit 971a52b5495e3d596e599faa1f31d4671897026d)

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

[3.13] gh-109413: Add more type hints to `libregrtest` (GH-126352) (#126388)

gh-109413: Add more type hints to `libregrtest` (GH-126352)
(cherry picked from commit bfc1d2504c183a9464e65c290e48516d176ea41f)

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

[3.13] gh-87506: Document that json.load*() can raise UnicodeDecodeError (GH-127355) (#128607)

(cherry picked from commit 15372d0112ac7fbbbe313725dd87d5a45af2f6d3)
(cherry picked from commit cdfb8bc93a4d8c06d2404ba2d243937ba209438c)

Co-authored-by: Srinivas Reddy Thatiparthy (తాటిపర్తి శ్రీనివాస్ రెడ్డి) <thatiparthysreenivas@gmail.com>
Co-authored-by: Erlend Aasland <erlend@python.org>

[3.13] Docs: mark up json.load() using parameter list (GH-128488) (#128596)

(cherry picked from commit a21e31ec5417374497b0f969ee2b3dc84a0944ff)

Co-authored-by: Erlend E. Aasland <erlend@python.org>

[3.13] gh-98188: Fix EmailMessage.get_payload to decode data when CTE value has extra text (GH-127547) (#128528)

gh-98188: Fix EmailMessage.get_payload to decode data when CTE value has extra text (GH-127547)

Up to this point message handling has been very strict with regards to content encoding values: mixed case was accepted, but trailing blanks or other text would cause decoding failure, even if the first token was a valid encoding.  By Postel's Rule we should go ahead and decode as long as we can recognize that first token.  We have not thought of any security or backward compatibility concerns with this fix.

This fix does introduce a new technique/pattern to the Message code: we look to see if the header has a 'cte' attribute, and if so we use that.  This effectively promotes the header API exposed by HeaderRegistry to an API that any header parser "should" support.  This seems like a reasonable thing to do.  It is not, however, a requirement, as the string value of the header is still used if there is no cte attribute.

The full fix (ignore any trailing blanks or blank-separated trailing text) applies only to the non-compat32 API.  compat32 is only fixed to the extent that it now ignores trailing spaces.  Note that the HeaderRegistry parsing still records a HeaderDefect if there is extra text.

(cherry picked from commit a62ba52f1439c1f878a3ff9b8544caf9aeef9b90)

Co-authored-by: RanKKI <hliu86.me@gmail.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>

[3.13] gh-128472: Add `-skip-funcs` to BOLT options to fix computed goto errors (gh-128511) (#128573)

gh-128472: Add `-skip-funcs` to BOLT options to fix computed goto errors (gh-128511)

* Add `-skip-funcs` to BOLT options to fix computed goto errors

* NEWS

---------

(cherry picked from commit 24b147a19b360c49cb1740aa46211d342aaa071f)

Co-authored-by: Zanie Blue <contact@zanie.dev>
Co-authored-by: Gregory Szorc <gregory.szorc@gmail.com>

[3.13] gh-108202: Document calendar.Calendar.firstweekday (GH-128566) (#128579)

(cherry picked from commit b3cbd8f1b58b9e71df20bdda9960e7d3190c509e)

Co-authored-by: Erlend E. Aasland <erlend@python.org>

[3.13] gh-128146: Exclude os/log.h import on older macOS versions. (GH-128165) (#128575)

gh-128146: Exclude os/log.h import on older macOS versions. (GH-128165)

Reworks the handling of Apple system log handling to account for older macOS
versions that don't provide os-log.
(cherry picked from commit e837a1f71e832ce8f551a6fac05e346f654457e0)

Co-authored-by: Russell Keith-Magee <russell@keith-magee.com>

[3.13] gh-108202: Document `calendar.Calendar` methods `getfirstweekday` and `setfirstweekday` (GH-127579) (#128564)

(cherry picked from commit 953b49e5468d02afaddadc2307f4763422078603)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>

[3.13] gh-90241: Clarify documentation for PyUnicode_FSConverter and PyUnicode_FSDecoder (GH-128451) (GH-128542)

(cherry picked from commit 657d7b77e5c69967e9c0000b986fa4872d13958c)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>

[3.13] gh-77214: Update outdated documentation for numeric PyArg_Parse formats (GH-128454) (GH-128538)

(cherry picked from commit 8d15058d61681e98579cf3fbd3c6fd13b3df6a72)

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

[3.13] gh-114990: Add missing mixin methods in collections.abc's document (GH-114991) (#128535)

Co-authored-by: AN Long <aisk@users.noreply.github.com>
Co-authored-by: Carol Willing <carolcode@willingconsulting.com>

[3.13] gh-128519: Align the docstring of untokenize() to match the docs (GH-128521) (#128531)

(cherry picked from commit aef52ca8b334ff90e8032da39f4d06e7b5130eb9)

Co-authored-by: Tomas R <tomas.roun8@gmail.com>

[3.13] Docs: fix `MessageDefect` references in email.policy docs (GH-128468) (#128526)

(cherry picked from commit 3b231be8f000ae59faa04d5a2f1af11beafee866)

Co-authored-by: Yuki Kobayashi <drsuaimqjgar@gmail.com>

[3.13] gh-128504: Upgrade doctest to ubuntu-24.04 (GH-128506) (#128517)

gh-128504: Upgrade doctest to ubuntu-24.04 (GH-128506)
(cherry picked from commit 2228e92da31ca7344a163498f848973a1b356597)

Co-authored-by: Damien <81557462+Damien-Chen@users.noreply.github.com>
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>

[3.13] gh-128437: Add `BOLT_COMMON_FLAGS` with `-update-debug-sections` (gh-128455) (gh-128512)

gh-128437: Add `BOLT_COMMON_FLAGS` with `-update-debug-sections` (gh-128455)

Add `BOLT_COMMON_FLAGS` with `-update-debug-sections`

(cherry picked from commit b60044b838f3ea97395cd6f3adbd5330356fc273)

Co-authored-by: Zanie Blue <contact@zanie.dev>
Co-authored-by: Gregory Szorc <gregory.szorc@gmail.com>

[3.13] gh-127553: Remove outdated TODO comment in _pydatetime (GH-127564) (#128500)

(cherry picked from commit e8b6b39ff707378da654e15ccddde9c28cefdd30)

Co-authored-by: Beomsoo Kim <beoms424@gmail.com>

[3.13] gh-127954: Document PyObject_DelItemString (GH-127986) (#128496)

(cherry picked from commit 8ade15343d5daec3bf79ff7c47f03726fb2bcadf)

Co-authored-by: RUANG (James Roy) <rruuaanng@outlook.com>

[3.13] Docs: amend json.dump() post gh-128482 (GH-128489) (#128493)

(cherry picked from commit 87ee76062a7eb9c0fa2b94e36cfed21d86ae90ac)

Co-authored-by: Erlend E. Aasland <erlend@python.org>

[3.13] gh-126719: Clarify math.fmod docs (GH-127741) (#128491)

(cherry picked from commit f28d471fbe99f9eaac05d60ed40da47b0b56fe86)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>

[3.13] Docs: mark up json.dump() using parameter list (GH-128482) (#128486)

(cherry picked from commit a0088b40bb212dc132e147d04f9287cabd72d163)

Co-authored-by: Erlend E. Aasland <erlend@python.org>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>

[3.13] gh-128152: Argument Clinic: ignore pre-processor directives inside C comments (GH-128464) (#128478)

(cherry picked from commit a4e773c540cfd3a9c2bb3b5033d2f79ef50962c8)

Co-authored-by: Erlend E. Aasland <erlend@python.org>

[3.13] gh-128354: Consistently use LIBS over LDFLAGS in library build… (#128465)

(cherry picked from commit b75ed951d4de8ba85349d80c8e7f097b3cd6052f)

[3.13] gh-128456: Use '-reorder-functions=cdsort' for BOLT builds (GH-128457) (#128461)

'hfsort+' is deprecated in favor of 'cdsort'.

(cherry picked from commit 4974bbdb290b61a2d8860de490fde1228c296753)

Co-authored-by: Zanie Blue <contact@zanie.dev>

[3.13] gh-127903: Fix a crash on debug builds when calling `Objects/unicodeobject::_copy_characters` (GH-127876) (#128458)

gh-127903: Fix a crash on debug builds when calling `Objects/unicodeobject::_copy_characters`` (GH-127876)
(cherry picked from commit 46cb6340d7bad955edfc0a20f6a52dabc03b0932)

Co-authored-by: Alexander Shadchin <shadchin@yandex-team.com>

[3.13] gh-125674: Doc: Fix type of newfunc first parameter (GH-125675) (#128449)

(cherry picked from commit 616468b87bc5bcf5a4db688637ef748e1243db8a)

Co-authored-by: Richard Hansen <rhansen@rhansen.org>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>

[3.13] gh-108202: Document calendar.TextCalendar formatting helpers (GH-127608) (#128440)

Document the following TextCalendar methods:
- formatday()
- formatmonthname()
- formatweekday()
- formatweekheader()

(cherry picked from commit bb73426cafb78691b249ffa50f1872ab6f899d4a)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>

[3.13] gh-128400: Stop-the-world when manually calling `faulthandler` (GH-128422) (GH-128423)

(cherry picked from commit c9356feef28e6dfc4dc32830d3427a5ae0e426e2)

Co-authored-by: Peter Bierma <zintensitydev@gmail.com>

[3.13] gh-128013: fix data race in PyUnicode_AsUTF8AndSize on free-threading (#128021) (#128417)

[3.13] gh-128014:  Fix passing default='' to the tkinter method wm_iconbitmap() (GH-128015) (GH-128418)

(cherry picked from commit 58e9f95c4aa970db32a94b9152b51ede22f823bd)

Co-authored-by: Zhikang Yan <2951256653@qq.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

[3.13] Revert "Doc: Show object descriptions in the table of contents (GH-125757)" (GH-128406) (#128413)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>

[3.13] gh-123925: Fix building curses on platforms without libncursesw (GH-128405) (GH-128407)

(cherry picked from commit 8d16919a06a55a50756bf083221a6f6cab43de50)

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

[3.13] gh-128349: Use `.. data::` instead of `.. class::` for pre-defined decimal `Context` objects (GH-128379) (#128401)

gh-128349: Use `.. data::` instead of `.. class::` for pre-defined decimal `Context` objects (GH-128379)
(cherry picked from commit 60c65184695a3eab766b3bc26fc99f695deb998f)

Co-authored-by: abkmystery <36216019+abkmystery@users.noreply.github.com>

[3.13] Reword `about.rst` to not limit Sphinx (GH-128325) (#128382)

Reword `about.rst` to not limit Sphinx (GH-128325)
(cherry picked from commit c5438fdf4706a70bdd19338edc000dacffff6837)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>

[3.13] gh-88834: Unify the instance check for typing.Union and types.UnionType (GH-128363) (GH-128370)

Union now uses the instance checks against its parameters instead of
the subclass checks.
(cherry picked from commit b2ac70a62ad1be8e037ce45ccf5f1b753ea5e64b)

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

[3.13] gh-128342: Specify timeout unit in subprocess docstrings (GH-128343) (#128365)

gh-128342: Specify timeout unit in subprocess docstrings (GH-128343)

Specify timeout unit (seconds) in subprocess docstrings
(cherry picked from commit dafe7a44630aa32bb411cceb45c7b7df725e3fe3)

Co-authored-by: n-l-i <57808975+n-l-i@users.noreply.github.com>
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>

[3.13] gh-128321: Set LIBS instead of LDFLAGS when checking sqlite3 requirements (GH-128322) (#128356)

(cherry picked from commit 81376fef76a53fb79893bfa9c9db18d97c228fbe)

Co-authored-by: Zanie Blue <contact@zanie.dev>
Co-authored-by: Erlend E. Aasland <erlend@python.org>

[3.13] gh-128317: Document `calendar.TextCalendar.formatweek` (GH-128353) (#128357)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>

[3.13] gh-127586: multiprocessing.Pool does not properly restore blocked signals (try 2) (GH-128011) (#128298)

gh-127586: multiprocessing.Pool does not properly restore blocked signals (try 2) (GH-128011)

Correct pthread_sigmask in resource_tracker to restore old signals

Using SIG_UNBLOCK to remove blocked "ignored signals" may accidentally
cause side effects if the calling parent already had said signals
blocked to begin with and did not intend to unblock them when
creating a pool. Use SIG_SETMASK instead with the previous mask of
blocked signals to restore the original blocked set.
(cherry picked from commit aeb9b65aa26444529e4adc7d6e5b0d3dd9889ec2)

Co-authored-by: Stephen Hansen <stephen.paul.hansen@gmail.com>
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
Co-authored-by: Gregory P. Smith <greg@krypto.org>

[3.13] Mention loop_factory argument in docstring for asyncio.run() (GH-128288) (#128291)

Mention loop_factory argument in docstring for asyncio.run() (GH-128288)
(cherry picked from commit 0b5f1fae573a2c658eb000433ad7b87e9c40c697)

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

[3.13] gh-125887: Update PyObject_HasAttr exception behavior (GH-125907) (#128283)

gh-125887: Update PyObject_HasAttr exception behavior (GH-125907)

Update PyObject_HasAttr exception behavior

(cherry picked from commit 08a0728d6c32986d35edb26872b4512a71ae60f3)

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

[3.13] gh-127537: Add __class_getitem__ to the python implementation of functools.partial (GH-127537) (#128281)

gh-127537: Add __class_getitem__ to the python implementation of functools.partial (GH-127537)
(cherry picked from commit 401bba6b58497ce59e7b45ad33e43ae8c67abcb9)

Co-authored-by: CF Bolz-Tereick <cfbolz@gmx.de>

[3.13] Clean up redundant ifdef in list getitem (GH-128257) (#128276)

Clean up redundant ifdef in list getitem (GH-128257)

It's already inside a `Py_GIL_DISABLED` block so the `#else` clause is always unused.
(cherry picked from commit 42f7a00ae8b6b3fa09115e24b9512216c6c8978e)

Co-authored-by: da-woods <dw-git@d-woods.co.uk>

[3.13] gh-128198: Add missing error checks for usages of PyIter_Next() (GH-128199) (GH-128272)

(cherry picked from commit 5c814c83cdd3dc42bd9682106ffb7ade7ce6b5b3)

Co-authored-by: Yan Yanchii <yyanchiy@gmail.com>

[3.13] gh-126664: revert: Use `else` instead of `finally` in docs explaining "with" (GH-128169) (#128170)

gh-126664: revert: Use `else` instead of `finally` in docs explaining "with" (GH-128169)

Revert "gh-126664: Use `else` instead of `finally` in "The with statement" documentation. (GH-126665)"

This reverts commit 25257d61cfccc3b4189f96390a5c4db73fd5302c.
(cherry picked from commit 228f275737615cc9be713a8c3f9325b359bf8aec)

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

[3.13] gh-112328: Make EnumDict usable on its own and document it (GH-123669) (GH-128142)

Co-authored-by: Petr Viktorin <pviktori@redhat.com>

[3.13] gh-128227: Regenerate `Doc/requirements-oldest-sphinx.txt` (GH-128228) (#128229)

gh-128227: Regenerate `Doc/requirements-oldest-sphinx.txt` (GH-128228)
(cherry picked from commit 7985d460c731b2c48419a33fc1820f9512bb6f21)

Co-authored-by: Bogdan Romanyuk <65823030+wrongnull@users.noreply.github.com>

[3.13] gh-127847: Fix position in the special-cased zipfile seek (GH-127856) (#128225)

gh-127847: Fix position in the special-cased zipfile seek (GH-127856)

---------
(cherry picked from commit 7ed6c5c6961d0849f163d4d449fb36bae312b6bc)

Co-authored-by: Dima Ryazanov <dima@bucket.xxx>
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
Co-authored-by: Jason R. Coombs <jaraco@jaraco.com>

gh-128217: Validate the normalized_environment variable instead of the similarly named function (GH-128220)

(cherry picked from commit 3ddd70ceaaf67b111ee4251817e150396d6d10a9)

Co-authored-by: Sergey Muraviov <smurav@mail.ru>

[3.13] gh-126180: Remove getopt and optparse deprecation notices (GH-128191)

* Remove getopt and optparse deprecation notices
* Add new docs sections for command line app helper libraries
* Add guidance on choosing a CLI parsing library to the optparse docs
* Link to the new guidance from the argparse and getopt docs
* Reword intro in docs section for superseded stdlib modules
* Reframe the optparse->argparse guide as a migration guide
  rather than as an upgrade guide

---------
(cherry picked from commit 831b6de6d725c697f2f61fd35c4448cd8a9354ff)

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

[3.13] gh-128049: Fix type confusion bug with the return value of a custom ExceptionGroup split function (GH-128079) (#128139)

gh-128049: Fix type confusion bug with the return value of a custom ExceptionGroup split function (GH-128079)
(cherry picked from commit 3879ca0100942ae15a09ac22889cbe3e46d424eb)

Co-authored-by: Nico-Posada <102486290+Nico-Posada@users.noreply.github.com>