[3.12] gh-107980: fix doc role for asyncio.timeouts (GH-108126) (#108152)

gh-107980: fix doc role for asyncio.timeouts (GH-108126)
(cherry picked from commit a47c13cae5b32e6f3d7532cc6dbb4e1ac31219de)

Co-authored-by: Tin Tvrtković <tinchester@gmail.com>

[3.12] Docs: Remove links to external C functions and macros in os.rst (GH-108138) (#108143)

Docs: Remove links to external C functions and macros in os.rst (GH-108138)
(cherry picked from commit c31c61c04e55ef431615ffec959d84ac73a3db81)

Co-authored-by: Erlend E. Aasland <erlend@python.org>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>

[3.12] gh-108083: Don't ignore exceptions in sqlite3.Connection.__init__() and .close() (#108084) (#108141)

- Add explanatory comments
- Add return value to connection_close() for propagating errors
- Always check the return value of connection_exec_stmt()
- Assert pre/post state in remove_callbacks()
- Don't log unraisable exceptions in case of interpreter shutdown
- Make sure we're not initialized if reinit fails
- Try to close the database even if ROLLBACK fails

(cherry picked from commit fd195092204aa7fc9f13c5c6d423bc723d0b3520)

Co-authored-by: Victor Stinner <vstinner@python.org>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

[3.12] gh-107801: Improve the accuracy of os.lseek docs (#107935) (#108136)

- name the last parameter *whence*, like it is for seek() methods on
  file objects
- add param docstrings
- structure the valid *whence* params

(cherry picked from commit dd4442c8f597af1ec3eaf20f7ad89c4ac7e2dbc9)

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

[3.12] Docs: format sys.float_info properly (GH-108107) (#108130)

Docs: format sys.float_info properly (GH-108107)

- Normalise capitalisation and punctuation
- Use attribute markup for named tuple attributes
- Use :c:macro: markup for C macros
- Use a list for the 'rounds' attribute values
- Use list-table, for better .rst readability
- Remove one unneeded sys.float_info.dig link

(cherry picked from commit ca0c6c1f1ef79d10bc49b61d638d87cde265aa94)

Co-authored-by: Erlend E. Aasland <erlend@python.org>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>

[3.12] gh-101100: Only show GitHub check annotations on changed doc paragraphs (GH-108065) (#108127)

gh-101100: Only show GitHub check annotations on changed doc paragraphs (GH-108065)

* Only show GitHub check annotations on changed doc paragraphs
* Improve check-warnings script arg parsing following Hugo's suggestions
* Factor filtering warnings by modified diffs into helper function
* Build docs on unmerged branch so warning lines match & avoid deep clone

---------

(cherry picked from commit eb953d6e4484339067837020f77eecac61f8d4f8)

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>

[3.12] gh-107565: Update macOS installer to use OpenSSL 3.0.10. (GH-107897) (#108121)

gh-107565: Update macOS installer to use OpenSSL 3.0.10. (GH-107897)
(cherry picked from commit dc7b630b2359663bb7b8212d9f2f720c978d3daa)

Co-authored-by: Ned Deily <nad@python.org>

[3.12] gh-101100: Docs: Check Sphinx warnings and fail if improved (GH-106460) (#108116)

* gh-101100: Docs: Check Sphinx warnings and fail if improved (#106460)

(cherry picked from commit 806d7c98a5da5c1fd2e52a5b666f36ca4f545092)

* [3.12] gh-101100: Docs: Check Sphinx warnings and fail if improved (GH-106460).
(cherry picked from commit 806d7c98a5da5c1fd2e52a5b666f36ca4f545092)

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

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

[3.12] gh-107565: Update multissltests and GitHub CI workflows to use OpenSSL 1.1.1v, 3.0.10, and 3.1.2. (GH-108118)

Co-authored-by: Ned Deily <nad@python.org>

[3.12] Docs: emphasise warning and add accurate markups for sys.unraisablehook (GH-108105) (#108109)

Docs: emphasise warning and add accurate markups for sys.unraisablehook (GH-108105)
(cherry picked from commit cc58ec9724772a8d5c4a5c9a6525f9f96e994227)

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

[3.12] gh-107801: Improve the docs of the SEEK_* constants (#108099) (#108108)

(cherry picked from commit 02079b010c39a89b284e8f0bb6d5f378e554260e)

[3.12] Docs: Fix Sphinx warnings in io.rst (GH-107903) (#108093)

Docs: Fix Sphinx warnings in io.rst (GH-107903)

- Mark up parameter and argument names properly
- If possible, link to docs for methods like `seek`, `tell`, `write`, `read`, etc.

(cherry picked from commit 5c76899dadf3bdcfdedf6f30b3ab9742cb87af04)

Co-authored-by: Erlend E. Aasland <erlend@python.org>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: T. Wouters <thomas@python.org>

[3.12] gh-107801: Document SEEK_HOLE and SEEK_DATA (GH-107936) (#108086)

gh-107801: Document SEEK_HOLE and SEEK_DATA (GH-107936)
(cherry picked from commit 8a19f225b948db1eebe1d9fc71a486258841f578)

Co-authored-by: Erlend E. Aasland <erlend@python.org>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Antoine Pitrou <antoine@python.org>

[3.12] gh-107909: Test explicit `object` base in PEP695 generic classes (GH-108001) (#108022)

gh-107909: Test explicit `object` base in PEP695 generic classes (GH-108001)
(cherry picked from commit b61f5995aebb93496e968ca8d307375fa86d9329)

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

[3.12] GH-92584: Remove Installing Python Modules (Distutils version) (GH-108020) (#108062)

* [3.12] GH-92584: Remove Installing Python Modules (Distutils version) (GH-108020).
(cherry picked from commit fbb7cbc0e92168077fd56de942901511e99ca60a)

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

[3.12] gh-107298: Fix some references in the C API documentation (GH-108072) (#108074)

gh-107298: Fix some references in the C API documentation (GH-108072)
(cherry picked from commit f51f0466c07eabc6177c2f64f70c952dada050e8)

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

[3.12] gh-107298: Add standard exceptions and warnings in the nitpick_ignore list (GH-108029) (#108070)

gh-107298: Add standard exceptions and warnings in the nitpick_ignore list (GH-108029)
(cherry picked from commit c9d83f93d804b80ee14480466ebee63a6f97dac2)

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

[3.12] gh-108000: Test that `lambda` also has `__type_params__` (GH-108002) (#108019)

gh-108000: Test that `lambda` also has `__type_params__` (GH-108002)
(cherry picked from commit a8d440b3837273926af5ce996162b019290ddad5)

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

[3.12] GH-107987: Remove the Distributing Python Modules guide (GH-108016) (#108081)

GH-107987: Remove the Distributing Python Modules guide (GH-108016)
(cherry picked from commit 33e6e3fec02ff3035dec52692542d3dd10124bef)

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

[3.12] GH-92584: Remove references to Distutils in configure.rst (GH-108043) (#108063)

GH-92584: Remove references to Distutils in configure.rst (GH-108043)

Remove references to Distutils in configure.rst
(cherry picked from commit e88eb3775ecdcb3af6c6d694a935b7fa5f41e5ce)

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

[3.12] GH-92584: Redirect macOS package installation to the PPUG (GH-108044) (#108058)

GH-92584: Redirect macOS package installation to the PPUG (GH-108044)
(cherry picked from commit 902864256cb261428ae9682ca0ffddd597e1f894)

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

[3.12] GH-92584: Remove references to Distutils in ``PYTHONUSERBASE`` (GH-108040) (#108060)

GH-92584: Remove references to Distutils in ``PYTHONUSERBASE`` (GH-108040)

Remove references to Distutils in ``PYTHONUSERBASE``
(cherry picked from commit 636ca313b2f7ce09a311889995778dccae8ebe40)

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

[3.12] gh-107298: Fix C API Buffer documentation (GH-108011). (#108048)

(cherry picked from commit c2941cba7a986e6158eebb2a0bf33906dcd78616)

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

[3.12] gh-106242: Fix path truncation in os.path.normpath (GH-106816) (#107981)

* gh-106242: Fix path truncation in os.path.normpath (GH-106816)
* gh-106242: Minor fixup to avoid compiler warnings

---------

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

[3.12] GH-92584: Remove reference to Distutils in ``cx_Freeze``'s description (GH-108047) (#108057)

GH-92584: Remove reference to Distutils in ``cx_Freeze``'s description (GH-108047)

Remove reference to Distutils in ``cx_Freeze``'s description
(cherry picked from commit 57fcf96e4f21b8955b3ae4b4d70e4b756949712f)

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

[3.12] gh-91051: fix type watcher test to be robust to existing watcher (GH-107989) (#108053)

gh-91051: fix type watcher test to be robust to existing watcher (GH-107989)
(cherry picked from commit fce93c80ae2d792b8ca443b044e28abbf28bb89a)

Co-authored-by: Carl Meyer <carl@oddbird.net>

[3.12] Remove Sphinx problem matcher to avoid annotating unchanged files (GH-108005) (#108049)

Remove Sphinx problem matcher to avoid annotating unchanged files (GH-108005)
(cherry picked from commit 0d7f5d3ba3641f8c7d32facbb177bf70ee7520d1)

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

[3.12] GH-92584: Drop reference to Distutils in ``site.USER_BASE`` (GH-108031) (#108039)

GH-92584: Drop reference to Distutils in ``site.USER_BASE`` (GH-108031)

Drop reference to Distutils in ``site.USER_BASE``
(cherry picked from commit f2a9dfdee9de381e4adf29a7f1e2aec56580bfda)

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

[3.12] gh-104496: Use correct Tcl or Tk version in Tkinter tests (GH-107688) (#107709)

gh-104496: Use correct Tcl or Tk version in Tkinter tests (GH-107688)

In future Tcl and Tk versions can be desynchronized.
(cherry picked from commit 3c8e8f3ceeae08fc43d885f5a4c65a3ee4b1a2c8)

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

[3.12] Docs: Fix more Sphinx annotations in ctypes.rst (GH-107708) (#107717)

Docs: Fix more Sphinx annotations in ctypes.rst (GH-107708)
(cherry picked from commit 8c9af6b9a0d6fc9cb237e96588d8dcab727e32b8)

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

[3.12] gh-100814: Fix exception for invalid callable value of Tkinter image option (GH-107692) (#107722)

gh-100814: Fix exception for invalid callable value of Tkinter image option (GH-107692)

Passing a callable object as an option value to a Tkinter image now raises
the expected TclError instead of an AttributeError.
(cherry picked from commit 50e3cc9748eb2103eb7ed6cc5a74d177df3cfb13)

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

[3.12] gh-107715: Escape class name in regular expression (GH-107716) (#107726)

* gh-107715: Escape class name in regular expression (GH-107716)

This patch escapes the class name before embedding it in the regular expression
for `pat` in `doctest.DocTestFinder._find_lineno`. While class names do not
ordinarily contain special characters, it is possible to encounter these when a
class is created dynamically. Escaping the name will correctly return `None` in
this scenario, rather than potentially matching a different class or raising
`re.error` depending on the symbols used.
(cherry picked from commit 85793278793708ad6b7132a54ac9fb4b2c5bcac1)

Co-authored-by: Gertjan van Zwieten <git@gjvz.nl>
* Update 2023-08-07-14-12-07.gh-issue-107715.238r2f.rst

---------

Co-authored-by: Gertjan van Zwieten <git@gjvz.nl>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

[3.12] gh-107178: Add the C API tests for the Abstract Objects Layer (GH-107179) (#107728)

Cover all the Mapping Protocol, almost all the Sequence Protocol
(except PySequence_Fast) and a part of the Object Protocol.

Move existing tests to Lib/test/test_capi/test_abstract.py and
Modules/_testcapi/abstract.c.

Add also tests for PyDict C API..
(cherry picked from commit 16c9415fba4972743f1944ebc44946e475e68bc4)

[3.12] gh-107735: Add C API tests for PySys_GetObject() and PySys_SetObject() (GH-107736) (#107740)

[3.12] gh-107735: Add C API tests for PySys_GetObject() and PySys_SetObject() (GH-107736).
(cherry picked from commit bea5f93196d213d6fbf4ba8984caf4c3cd1da882)

[3.12] gh-86457: Fix signature for code.replace() (GH-23199) (#107744)

* [3.12] gh-86457: Fix signature for code.replace() (GH-23199)

Also add support of @text_signature in Argument Clinic..
(cherry picked from commit 0e6e32fb84b2f7cb668e0b9927637587081e38cd)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* Update 2023-08-07-16-30-48.gh-issue-95065.-im4R5.rst

[3.12] README: remove unmaintained sections (GH-107703) (#107762)

README: remove unmaintained sections (GH-107703)
(cherry picked from commit 7a250fdc16bb6f1fe0a6b0df8bb502870405b5d6)

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

[3.12] gh-91795: Update build optimization part of PCbuild/readme.txt (GH-91849) (#107776)

gh-91795: Update build optimization part of PCbuild/readme.txt (GH-91849)
(cherry picked from commit 906b73be5eada1995bd667a02c59f7a11998310f)

Co-authored-by: Fatih <77548106+fatihkabakk@users.noreply.github.com>

[3.12] More actionable error message when spawn is incorrectly used. (GH-102203) (#107990)

More actionable error message when spawn is incorrectly used. (GH-102203)
(cherry picked from commit a794ebeb028f7ef287c780d3890f816db9c21c51)

Co-authored-by: Yuxin Wu <ppwwyyxxc@gmail.com>
Co-authored-by: Yuxin Wu <ppwwyyxx@users.noreply.github.com>
Co-authored-by: Oleg Iarygin <oleg@arhadthedev.net>

[3.12] gh-99203: shutil.make_archive(): restore select CPython <= 3.10.5 behavior (GH-99802) (#107998)

gh-99203: shutil.make_archive(): restore select CPython <= 3.10.5 behavior (GH-99802)

Restore following CPython <= 3.10.5 behavior of shutil.make_archive()
that went away as part of gh-93160:

Do not create an empty archive if root_dir is not a directory, and, in
that case, raise FileNotFoundError or NotADirectoryError regardless
of format choice. Beyond the brought-back behavior, the function may
now also raise these exceptions in dry_run mode.
(cherry picked from commit a86df298df5b02e2d69ea6879e9ed10a7adb85d0)

Co-authored-by: 6t8k <58048945+6t8k@users.noreply.github.com>

[3.12] gh-106300: Improve errors testing in test_unittest.test_runner (GH-106737) (#108006)

gh-106300: Improve errors testing in test_unittest.test_runner (GH-106737)

Use a custom exception to prevent unintentional silence of actual errors.
(cherry picked from commit fd9d70a94de5b0756b52b9ae21e236e25545db4f)

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

[3.12] gh-106844: Fix issues in _winapi.LCMapStringEx (GH-107832) (#107874)

* Strings with length from 2**31-1 to 2**32-2 always caused MemoryError,
   it doesn't matter how much memory is available.
* Strings with length exactly 2**32-1 caused OSError.
* Strings longer than 2**32-1 characters were truncated due to integer overflow bug.
* Strings containing the null character were truncated at the first null character.

Now strings longer than 2**31-1 characters caused OverflowError and the null character is allowed..
(cherry picked from commit 04cc01453db2f0af72a06440831637f8bf512daf)

[3.12] gh-107080: Fix Py_TRACE_REFS Crashes Under Isolated Subinterpreters (#107751)

* Unrevert "[3.12] gh-107080: Fix Py_TRACE_REFS Crashes Under Isolated Subinterpreters (gh-107567) (#107599)".

This reverts commit 6e4eec760648a71e1cd8f8f551997b1823b4bb9f (gh-107648).

* Initialize each interpreter's refchain properly.

* Skip test_basic_multiple_interpreters_deleted_no_reset on tracerefs builds.

[3.12] gh-100061: Proper fix of the bug in the matching of possessive quantifiers (GH-102612) (#108003)

Restore the global Input Stream pointer after trying to match a sub-pattern.

.
(cherry picked from commit abd9cc52d94b8e2835322b62c29f09bb0e6fcfe9)

Co-authored-by: SKO <41810398+uyw4687@users.noreply.github.com>

[3.12] gh-91051: fix segfault when using all 8 type watchers (GH-107853) (#107876)

* gh-91051: fix segfault when using all 8 type watchers (GH-107853)
(cherry picked from commit 66e4edd7346b1cd65ddff6da890a0d725e325116)

Co-authored-by: Carl Meyer <carl@oddbird.net>

[3.12] gh-107963: Fix set_forkserver_preload to check the type of given list (GH-107965) (#107975)

gh-107963: Fix set_forkserver_preload to check the type of given list (GH-107965)
(cherry picked from commit 6515ec3d3d5acd3d0b99c88794bdec09f0831e5b)

gh-107963: Fix set_forkserver_preload to check the type of given list

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

[3.12] gh-107967: Fix infinite recursion on invalid escape sequence warning (GH-107968) (#107970)

gh-107967: Fix infinite recursion on invalid escape sequence warning (GH-107968)
(cherry picked from commit d66bc9e8a7a8d6774d912a4b9d151885c4d8de1d)

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

[3.12] Add another example to the statistics docs (GH-107904) (#107941)

Add another example to the statistics docs (GH-107904)
(cherry picked from commit 2b6dc2accc315ce279d259ed39e058a225068531)

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

[3.12] gh-107877: Update logging levels reference table with usage criteria. (GH-107894) (#107922)

gh-107877: Update logging levels reference table with usage criteria. (GH-107894)
(cherry picked from commit cc2cf85d03cf29994a707aae5cc9a349a4165b84)

Co-authored-by: Vinay Sajip <vinay_sajip@yahoo.co.uk>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

[3.12] gh-107891: Fix typo in 3.12 whatsnew  (GH-107892) (#107893)

gh-107891: Fix typo in 3.12 whatsnew  (GH-107892)
(cherry picked from commit 2e1f688fe0f0a612e54c09f5a7027a834dd8b8d5)

Co-authored-by: wookie184 <wookie1840@gmail.com>

[3.12] Docs: Document PyBUF_MAX_NDIM (GH-107865) (#107871)

Docs: Document PyBUF_MAX_NDIM (GH-107865)
(cherry picked from commit 637f7ff2c60f262659da0334f1cb672bd361f398)

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

[3.12] gh-91054: make code watcher tests resilient to other watchers (GH-107821) (#107835)

gh-91054: make code watcher tests resilient to other watchers (GH-107821)
(cherry picked from commit 2ec16fed14aae896e38dd5bd9e73e2eddc974439)

Co-authored-by: Carl Meyer <carl@oddbird.net>

[3.12] gh-107810: Improve DeprecationWarning for metaclasses with custom tp_new (GH-107834) (#107864)

gh-107810: Improve DeprecationWarning for metaclasses with custom tp_new (GH-107834)

(cherry picked from commit 16dcce21768ba381996a88ac8c255bf1490b3680)

Co-authored-by: Marc Mueller <30130371+cdce8p@users.noreply.github.com>
Co-authored-by: Kirill Podoprigora <kirill.bast9@mail.ru>

[3.12] Fix the long64 reader in umarshal.py (GH-107828) (#107849)

Fix the long64 reader in umarshal.py (GH-107828)
(cherry picked from commit 50bbc56009ae7303d2482f28eb62f2603664b58f)

Co-authored-by: Martin DeMello <martindemello@gmail.com>

[3.12] GH-107774: Add missing audit event for PEP 669 (GH-107775) (#107839)

GH-107774: Add missing audit event for PEP 669 (GH-107775)
(cherry picked from commit 494e3d4436774a5ac1a569a635b8c5c881ef1c0c)

Co-authored-by: Mark Shannon <mark@hotpy.org>

[3.12] GH-107724: Fix the signature of `PY_THROW` callback functions. (GH-107725) (#107802)

GH-107724: Fix the signature of `PY_THROW` callback functions. (GH-107725)
(cherry picked from commit 52fbcf61b5a70993c2d32332ff0ad9f369d968d3)

Co-authored-by: Mark Shannon <mark@hotpy.org>

[3.12] GH-106684:  Close `asyncio.StreamWriter` when `asyncio.StreamWriter` is not closed by application (GH-107650) (#107656)

GH-106684: raise `ResourceWarning` when `asyncio.StreamWriter` is not closed (GH-107650)
(cherry picked from commit 41178e41995992bbe417f94bce158de93f9e3188)

Co-authored-by: Kumar Aditya <kumaraditya@python.org>
Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>

[3.12] gh-107814: Avoid output from Nuget installation in find_python.bat (GH-107815) (#107823)

gh-107814: Avoid output from Nuget installation in find_python.bat (GH-107815)
(cherry picked from commit 1e229e2c3d212accbd5fbe3a46cd42f8252b2868)

Co-authored-by: Max Bachmann <kontakt@maxbachmann.de>

[3.12] gh-106052: Fix bug in the matching of possessive quantifiers (GH-106515) (#107796)

[3.12] gh-106052: Fix bug in the matching of possessive quantifiers (gh-106515)

It did not work in the case of a subpattern containing backtracking.

Temporary implement possessive quantifiers as equivalent greedy qualifiers
in atomic groups..
(cherry picked from commit 7b6e34e5baeb4162815ffa4d943b09a58e3f6580)

[3.12] gh-98154: Clarify Usage of "Reference Count" In the Docs (gh-107552) (#107752)

* gh-98154: Clarify Usage of "Reference Count" In the Docs (gh-107552)

PEP 683 (immortal objects) revealed some ways in which the Python documentation has been unnecessarily coupled to the implementation details of reference counts.  In the end users should focus on reference ownership, including taking references and releasing them, rather than on how many reference counts an object has.

This change updates the documentation to reflect that perspective.  It also updates the docs relative to immortal objects in a handful of places.
(cherry picked from commit 5dc825d504ad08d64c9d1ce578f9deebbe012604)

Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>
* Fix a typo.

---------

Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>

[3.12] gh-107442: Document all valid types for ctypes _as_parameter_ (GH-107443) (#107707)

gh-107442: Document all valid types for ctypes _as_parameter_ (GH-107443)
(cherry picked from commit 6925c578a0e3cbb00858e64da813a7ffe79623c4)

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

[3.12] Docs: Argument Clinic: Move the CConverter class to the reference (GH-107671) (#107701)

Docs: Argument Clinic: Move the CConverter class to the reference (GH-107671)
(cherry picked from commit a6675b1a597c67be972598ac8562883fabe48099)

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

[3.12] Improve cross-references in `runpy` docs (GH-107673) (#107698)

Improve cross-references in `runpy` docs (GH-107673)

- Add links to `__main__` and `sys.path` where appropriate
- Ensure each paragraph never has more than one link to the same thing, to avoid visual clutter from too many links
(cherry picked from commit 4e242d1ffb2d165443fe2680f7d1fef9fecbcfc0)

Co-authored-by: Kamil Turek <kamil.turek@hotmail.com>

[3.12] Docs: Argument Clinic: Improve 'How to write a custom converter' (GH-107328) (#107669)

Docs: Argument Clinic: Improve 'How to write a custom converter' (GH-107328)

- Omit unneccesary wording and sentences
- Don't mention implementation details (no digression, explanation)

(cherry picked from commit 4a5b4221e381c541f3f73537b7b87580d100158b)

Co-authored-by: Erlend E. Aasland <erlend@python.org>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>

[3.12] Docs: Fix Sphinx annotations in Doc/library/ctypes.rst (GH-107672) (#107685)

Docs: Fix Sphinx annotations in Doc/library/ctypes.rst (GH-107672)
(cherry picked from commit 71a7c96ffeb0d7fef06be3e57468896e030967a5)

Co-authored-by: Erlend E. Aasland <erlend@python.org>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>

[3.12] GH-84435: Make pyspecific directives translatable (GH-19470) (#107681)

GH-84435: Make pyspecific directives translatable (GH-19470)
(cherry picked from commit ecb05e0b9842ba03b42b4dec8767b1c18a4e28b3)

Co-authored-by: cocoatomo <cocoatomo77@gmail.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>

[3.12] Do not use deprecated ``logger.warn()`` in pyspecific (GH-107694) (#107695)

Do not use deprecated ``logger.warn()`` in pyspecific (GH-107694)
(cherry picked from commit 9564e31cbc95a723f2414537231bc4611b56644f)

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

[3.12] Docs: skip python-docs-theme 2023.7 to fix mobile menu (GH-107666) (#107690)

Docs: skip python-docs-theme 2023.7 to fix mobile menu (GH-107666)
(cherry picked from commit 9641c4d8e2bdf9b00dd9f373d4a74dfad000afd1)

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

[3.12] gh-107662: Switch 'any' and 'anext' in functions.rst (GH-107663) (#107664)

gh-107662: Switch 'any' and 'anext' in functions.rst (GH-107663)

Order was reversed in index at top, not in body.
(cherry picked from commit 9ebc6ecbc336d7b17cd158d1a4522f832df3e6e2)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>

Post 3.12.0rc1

Python 3.12.0rc1

[3.12] gh-107432 Fix incorrect indentation in annotations HOWTO (GH-107445) (#107654)

gh-107432 Fix incorrect indentation in annotations HOWTO (GH-107445)

gh-107432 Fix incorrect indentation in annotations document

Body text in https://docs.python.org/3/howto/annotations.html was
indented throughout, and was being rendered in blockquote elements.
(cherry picked from commit 5e2746d6e2fb0da29225ead7135f078c5f087b57)

Co-authored-by: Daniele Procida <daniele@vurt.org>

[3.12] gh-107630: Revert "[3.12] gh-107080: Fix Py_TRACE_REFS Crashes Under Isolated Subinterpreters (gh-107567) (#107599)" (#107648)

Revert "[3.12] gh-107080: Fix Py_TRACE_REFS Crashes Under Isolated Subinterpreters (gh-107567) (#107599)"

This reverts commit 58af2293c52a1ad3754d254690c0e54f787c545b.

[3.12] Docs: Only include Plausible for html, not for epub etc (GH-107637) (#107642)

Docs: Only include Plausible for html, not for epub etc (GH-107637)

Only include Plausible for html, not for epub etc
(cherry picked from commit 904b5319b3cc72063f4bfcd7beb3a1ef0fc641be)

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

[3.12] Docs: upgrade to python-docs-theme 2023.7 (GH-107617) (#107633)

(cherry picked from commit 19f32b24b2e1680ff9929bb64d681397b259c6fb)

[3.12] Update the expected bytecode magic in test_importlib.test_util (#107626)

Update the expected bytecode magic in test_importlib.test_util to the final
3.12 magic number. From now on it's not allowed to change for any 3.12
release.

[3.12] GH-107263: Increase C stack limit for most functions, except `_PyEval_EvalFrameDefault()` (GH-107535) (#107618)

GH-107263: Increase C stack limit for most functions, except `_PyEval_EvalFrameDefault()` (GH-107535)

* Set C recursion limit to 1500, set cost of eval loop to 2 frames, and compiler mutliply to 2.
(cherry picked from commit fa45958450aa3489607daf9855ca0474a2a20878)

Co-authored-by: Mark Shannon <mark@hotpy.org>

[3.12] gh-107080: Fix Py_TRACE_REFS Crashes Under Isolated Subinterpreters (gh-107567) (#107599)

gh-107080: Fix Py_TRACE_REFS Crashes Under Isolated Subinterpreters (gh-107567)

The linked list of objects was a global variable, which broke isolation between interpreters, causing crashes. To solve this, we've moved the linked list to each interpreter.
(cherry picked from commit 58ef74186795c56e3ec86e8c8f351a1d7826638a)

Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>

[3.12] gh-107576: Ensure `__orig_bases__` are our own in `get_original_bases` (GH-107584) (#107592)

gh-107576: Ensure `__orig_bases__` are our own in `get_original_bases` (GH-107584)
(cherry picked from commit ed4a978449c856372d1a7cd389f91cafe2581c87)

Co-authored-by: James Hilton-Balfe <gobot1234yt@gmail.com>
Co-authored-by: Chris Bouchard <chris@upliftinglemma.net>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

[3.12] gh-107077: Raise SSLCertVerificationError even if the error is set via SSL_ERROR_SYSCALL (GH-107586) (#107587)

Co-authored-by: Pablo Galindo Salgado <Pablogsal@gmail.com>
Co-authored-by: T. Wouters <thomas@python.org>

[3.12] gh-107471: Fix Refleaks in test_import (gh-107569) (#107571)

gh-107471: Fix Refleaks in test_import (gh-107569)

gh-107184 introduced a refleak in test_import.SubinterpImportTests (specifically test_singlephase_check_with_setting_and_override and test_single_init_extension_compat).  We fix it here by making sure _testsinglephase is removed from sys.modules whenever we clear the runtime's internal state for the module.

The underlying problem is strictly contained in the internal function _PyImport_ClearExtension() (AKA _testinternalcapi.clear_extension()), which is only used in tests.

(This also fixes an intermittent segfault introduced in the same place, in test_disallowed_reimport.)
(cherry picked from commit 017f047183fa33743f7e36c5c360f5c670032be3)

Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>

[3.12] Clarify `Self` interaction with subclasses (GH-107511) (#107548)

Clarify `Self` interaction with subclasses (GH-107511)
(cherry picked from commit c8872f4285d3b61c252e3384bec6d30618b7d698)

Co-authored-by: Alexandru Mărășteanu <alexei@users.noreply.github.com>

[3.12] gh-106092: Fix use-after-free crash in frame_dealloc (GH-106875) (#107532)

gh-106092: Fix use-after-free crash in frame_dealloc (GH-106875)

It was possible for the trashcan to delay the deallocation of a
PyFrameObject until after its corresponding _PyInterpreterFrame has
already been freed.  So frame_dealloc needs to avoid dereferencing the
f_frame pointer unless it first checks that the pointer still points
to the interpreter frame within the frame object.

(cherry picked from commit 557b05c7a5334de5da3dc94c108c0121f10b9191)

Signed-off-by: Anders Kaseorg <andersk@mit.edu>
Co-authored-by: Anders Kaseorg <andersk@mit.edu>

[3.12] gh-105766: Document that Custom Allocators Must Be Thread-Safe (gh-107519) (gh-107522)

gh-105766: Document that Custom Allocators Must Be Thread-Safe (gh-107519)
(cherry picked from commit db361a340af3970c279908c8746a6b9ed45f47b8)

Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>

[3.12] gh-99113: Add a What's New Entry for PEP 684 (gh-107520) (gh-107523)

gh-99113: Add a What's New Entry for PEP 684 (gh-107520)
(cherry picked from commit 79e479c45fc63b6001b206fec832064c31fc1f11)

Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>

[3.12] gh-107306: Add a Doc Entry for Py_mod_multiple_interpreters (GH-107403) (gh-107521)

gh-107306: Add a Doc Entry for Py_mod_multiple_interpreters (GH-107403)

It was added in 3.12 for PEP 684 (per-interpreter GIL).
(cherry picked from commit fb344e99aa0da5bef9318684ade69978585fe060)

Co-authored-by: Eric Snow <ericsnowcurrently@gmail.com>

[3.12] gh-107507: Replace 'The goals of Argument Clinic' with a summary (GH-107508) (#107516)

Summarise the goals of Argument Clinic in a single sentence.
Mention that Argument Clinic was introduced with PEP-436.
(cherry picked from commit abb71c6a8f73482c910ffdf050a86089a48e0e60)

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

[3.12] gh-106762: Add news for `EnumMeta.__getattr__` removal (GH-107466) (GH-107509)

gh-106762: Add news for `EnumMeta.__getattr__` removal (GH-107466)
(cherry picked from commit de51dede5b48ef23d7d33d92f3616824e23fd205)

Co-authored-by: Jacob Walls <jacobtylerwalls@gmail.com>

[3.12] GH-101291: Add warning to "what's new" that `PyLongObject` internals have changed. (GH-107388) (#107392)

(cherry picked from commit 1ee605c5888fbc3d51b3e7610bac38ea6bc25e31)

Co-authored-by: Mark Shannon <mark@hotpy.org>

[3.12] gh-106368: Add test for Argument Clinic misbehaving custom converter_init() (GH-107496) (#107499)

(cherry picked from commit 2c5d206b33e4cdcafaaaf1eeaa189c10de332dc5)

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

[3.12] gh-105578: Add more usage examples to `typing.AnyStr` docs (GH-107045) (#107503)

gh-105578: Add more usage examples to `typing.AnyStr` docs (GH-107045)

``typing.AnyStr`` has different semantics to ``str | bytes``, which often leads to user confusion
(cherry picked from commit f877b32b879f2076bb1c52826af0c28ebf1aaeed)

Co-authored-by: Michael The <michael-the1@users.noreply.github.com>

[3.12] gh-105751: Remove obsolete `object` base class in some ctypes tests (GH-107460) (#107501)

(cherry picked from commit 520efecfc3aed34d3a44545c7cd872d1aea8c7dc)

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

[3.12] gh-106263: Fix segfault in `signaldict_repr`  in `_decimal` module (#… (#107491)

Co-authored-by: sunmy2019 <59365878+sunmy2019@users.noreply.github.com>
(cherry picked from commit 3979150a0d406707f6d253d7c15fb32c1e005a77)

[3.12] gh-102509: Start initializing `ob_digit` of `_PyLongValue` (GH-102510) (#107464)

gh-102509: Start initializing `ob_digit` of `_PyLongValue` (GH-102510)
(cherry picked from commit fc130c47daa715d60d8925c478a96d5083e47b6a)

Co-authored-by: Illia Volochii <illia.volochii@gmail.com>

[3.12] gh-46376: Return existing pointer when possible in ctypes (GH-107131) (#107487)

(cherry picked from commit 08447b5deb47e2a0df87fa0a0576d300e5c909b4)

Co-authored-by: Konstantin <kpp.live+github@gmail.com>

[3.12] gh-104280: Add test cases for DTrace probes (GH-107125) (#107489)

gh-104280: Add test cases for DTrace probes (GH-107125)
(cherry picked from commit a1c737b73d3658be0e1d072a340d42e3d96373c6)

Co-authored-by: Furkan Onder <furkanonder@protonmail.com>

[3.12] gh-105751, test_ctypes: Remove disabled tests (GH-105826) (#107483)

* The following tests were disabled since the initial ctypes commit
  in 2006, commit babddfca758abe34ff12023f63b18d745fae7ca9:

  * Callbacks.test_char_p()
  * DeletePointerTestCase.test_X()
  * NumberTestCase.test_perf()
  * StructureTestCase.test_subclass_creation()
  * Tests.test_X() of test_byteswap

* NumberTestCase.test_bool_from_address() was disabled in 2007 by
  commit 5dc4fe09b7648f9801558e766b21a3d3b2dcad3b.
* Remove check_perf() and run_test() of test_numbers.
(cherry picked from commit 8f10140e74d141a0a894702044e213e6f0690d9c)

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

[3.12] gh-99079: add What's New item (GH-107481)

[3.12] Update macOS installer screens for 3.12rc/final. (GH-107473)

[3.12] gh-99079: Update macOS installer to use OpenSSL 3.0.9. (gh-107472)

[3.12] gh-107427: Update the description of UNPACK_SEQUENCE (gh-107429) (gh-107459)