[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)

[3.12] Fix the documentation for PyCode_New add `qualname` parameter (GH-107186) (#107440)

Fix the documentation for PyCode_New add `qualname` parameter (GH-107186)
(cherry picked from commit f2abeb590dae5918388f91b60b31f040d44218f0)

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

[3.12] gh-107422: Remove outdated `TypedDict` example from typing docs (GH-107436) (#107437)

gh-107422: Remove outdated `TypedDict` example from typing docs (GH-107436)
(cherry picked from commit 89fd4f4a3fc5fb8076ec064c22a30108480e946b)

Co-authored-by: Rakesh Sabale <102187286+ghubrakesh@users.noreply.github.com>

[3.12] gh-101100: Sphinx warnings: pick the low hanging fruits (GH-107386) (GH-107419)

(cherry picked from commit f2d07d3289947d10b065b2bb7670c8fb6b6582f2)

[3.12] gh-107091: Fix some uses of :func: role (GH-107378) (GH-107416)

:c:func: or :c:macro: should be used instead.
(cherry picked from commit 413ba8943e2f1d896a0568eb571a041b88589440)

[3.12] gh-106881: Check for linux/limits.h before including it (#107397) (#107414)

* Check for linux/limits.h before including it

Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
(cherry picked from commit 11c055f5ff1a353de6d2e77f2af24aaa782878ba)

[3.12] gh-105699: Use a _Py_hashtable_t for the PyModuleDef Cache (gh-106974) (gh-107412)

gh-105699: Use a _Py_hashtable_t for the PyModuleDef Cache (gh-106974)

This fixes a crasher due to a race condition, triggered infrequently when two isolated (own GIL) subinterpreters simultaneously initialize their sys or builtins modules.  The crash happened due the combination of the "detached" thread state we were using and the "last holder" logic we use for the GIL.  It turns out it's tricky to use the same thread state for different threads.  Who could have guessed?

We solve the problem by eliminating the one object we were still sharing between interpreters.  We replace it with a low-level hashtable, using the "raw" allocator to avoid tying it to the main interpreter.

We also remove the accommodations for "detached" thread states, which were a dubious idea to start with.

(cherry picked from commit 8ba4df91ae60833723d8d3b9afeb2b642f7176d5)

[3.12] gh-107307: Update the importlib Docs for PEP 684 (gh-107400) (gh-107413)

gh-107307: Update the importlib Docs for PEP 684 (gh-107400)
(cherry picked from commit cf63df88d38ec3e6ebd44ed184312df9f07f9782)

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

[3.12] gh-104629: Build _testclinic extension module on Windows (GH-104723) (#107393)

(cherry picked from commit 3a1d819ebc36189e086198212822c9b29384f242)

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

[3.12] gh-107305: Update the C-API Docs for PEP 684 (gh-107324) (gh-107402)

gh-107305: Update the C-API Docs for PEP 684 (gh-107324)
(cherry picked from commit c0b81c4b5438a3565fadd9d6f5bc69f989a3fdee)

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

[3.12] gh-107091: Fix some uses of :const: role (GH-107379) (GH-107384)

It is for references, not for literals.
(cherry picked from commit 0aa58fa7a62cd0ee7ec27fa87122425aeff0467d)

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

[3.12] GH-106898: Add the exception as an argument to the `PY_UNWIND` event callback function. (GH-107347) (GH-107382)

[3.12] GH-106895: Raise a `ValueError` when attempting to disable events that cannot be disabled. (GH-107337) (GH-107351)

[3.12] GH-106897: Add `RERAISE` event to `sys.monitoring`. (GH-107291) (GH-107346)

* Ensures that exception handling events are balanced. Each [re]raise event has a matching unwind/handled event.

[3.12] gh-107298: Fix yet more Sphinx warnings in the C API doc (GH-107345) (GH-107380)

(cherry picked from commit 983305268e2291b0a7835621b81bf40cba7c27f3)

[3.12] gh-107298: Fix more Sphinx warnings in the C API doc (GH-107329) (GH-107376)

Declare the following functions as macros, since they are actually
macros. It avoids a warning on "TYPE" or "macro" argument.

* PyMem_New()
* PyMem_Resize()
* PyModule_AddIntMacro()
* PyModule_AddStringMacro()
* PyObject_GC_New()
* PyObject_GC_NewVar()
* PyObject_New()
* PyObject_NewVar()

Add C standard C types to nitpick_ignore in Doc/conf.py:

* int64_t
* uint64_t
* uintptr_t

No longer ignore non existing "__int" type in nitpick_ignore.

Update Doc/tools/.nitignore.
(cherry picked from commit 8d61a71f9c81619e34d4a30b625922ebc83c561b)

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

[3.12] gh-107298: Fix Sphinx warnings in the C API doc (GH-107302) (GH-107375)

(cherry picked from commit 391e03fa05b80d17a14ac88d30c974fa2fa00adb)

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

[3.12] gh-106723: forward -Xfrozen_modules option to spawned process interpreters (GH-106724) (#107367)

gh-106723: forward -Xfrozen_modules option to spawned process interpreters (GH-106724)
(cherry picked from commit 3dcac785810df4d9db50abe90847eaf03bbdaaf4)

Co-authored-by: Felipe A. Hernandez <ergoithz@gmail.com>
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
Co-authored-by: Gregory P. Smith <greg@krypto.org>

[3.12] gh-107298: Fix doc references to undocumented modules (GH-107300) (GH-107370)

Update also Doc/tools/.nitignore.
(cherry picked from commit 87b39028e5f453a949a1675526c439f6479a04a8)

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

[3.12] gh-106368: Argument clinic tests: improve failure message when tests in `ClinicExternalTests` fail (GH-107364) (#107365)

gh-106368: Argument clinic tests: improve failure message when tests in `ClinicExternalTests` fail (GH-107364)
(cherry picked from commit 76c26eaca4147ba7e3e8d7379c5a828f0b512a46)

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

[3.12] gh-104621: Check for Incompatible Extensions in import_find_extension() (gh-107184) (gh-107360)

gh-104621: Check for Incompatible Extensions in import_find_extension() (gh-107184)

This fixes a bug where incompatible modules could still be imported if attempted multiple times.
(cherry picked from commit 75c974f5353685f338344618ad7344e64c2293d0)

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

[3.12] gh-104432: Use `memcpy()` to avoid misaligned loads (GH-104433) (#107355)

gh-104432: Use `memcpy()` to avoid misaligned loads (GH-104433)

Fix potential unaligned memory access on C APIs involving returned sequences
of `char *` pointers within the :mod:`grp` and :mod:`socket` modules. These
were revealed using a ``-fsaniziter=alignment`` build on ARM macOS.
(cherry picked from commit f01e4cedba1a17d321664834bb255d9d04ad16ce)

Co-authored-by: Christopher Chavez <chrischavez@gmx.us>

[3.12] gh-105699: Disable the Interpreters Stress Tests (gh-107354) (gh-107357)

gh-105699: Disable the Interpreters Stress Tests (gh-107354)

The two tests are crashing periodically in CI and on buildbots.  I suspect the problem is in the _xxsubinterpreters module.
 Regardless, I'm disabling the tests temporarily, to reduce the noise as we approach 3.12rc1.  I'll be investigating the crashes separately.
(cherry picked from commit 4f67921ad28194155e3d4c16255fb140a6a4d89a)

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

[3.12] gh-101524: Only Use Public C-API in the _xxsubinterpreters Module (gh-105258) (gh-107303)

The _xxsubinterpreters module was meant to only use public API.  Some internal C-API usage snuck in over the last few years (e.g. gh-28969).  This fixes that.
(cherry picked from commit e6373c0d8b59512aa7f0dea7f3fb162b6ed10fa4)

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

[3.12] Bump some docs dependencies to resolve a Dependabot security alert (GH-107341) (#107342)

Bump some docs dependencies to resolve a Dependabot security alert (GH-107341)
(cherry picked from commit f84d77b4e07aeb6241c1ff9932627d3ba059efa8)

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

[3.12] gh-106996: Rewrite turtle explanation (GH-107244) (#107335)

Co-authored-by: Daniele Procida <daniele@vurt.org>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>

[3.12] Docs: Argument Clinic: Restructure "Basic concepts and usage" (GH-106981) (#107325)

Split "Basic concepts and usage" into:

- Reference
  - Terminology
  - CLI reference

- Background
  - Basic concepts

(cherry picked from commit 2ad699002e3ce09e9fa41e333ac72f16a32d94de)

Co-authored-by: Erlend E. Aasland <erlend@python.org>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>

[3.12] gh-107298: Docs: add targets for some :c:member: and :c:macro: references (GH-107316) (GH-107332)

Add targets for PyStructSequence_Desc and PyStructSequence_Field members
and macros like Py_EQ.
Fix target for Py_RETURN_RICHCOMPARE.
(cherry picked from commit abec9a1b20b70d8ced401d59fc4f02b331c6568b)

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

[3.12] gh-107091: Fix some uses of :attr: role (GH-107318) (GH-107330)

Fix also formatting of PyMethodDef members.
(cherry picked from commit d363eb5b0255c055e7b43f5e2c0847f555e1982e)

[3.12] Docs: Remove the numbered steps from the Argument Clinic tutorial (GH-107203) (#107317)

Instead, order the tutorial as one body of prose, making it easier to
align the tutorial according to Diátaxis principles.

(cherry picked from commit 592395577c679543d899e68a3cff538b8b4df80d)

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

[3.12] gh-105002: [pathlib] Fix relative_to with walk_up=True using ".." (GH-107014) (#107315)

gh-105002: [pathlib] Fix relative_to with walk_up=True using ".." (GH-107014)

It makes sense to raise an Error because ".." can not
be resolved and the current working directory is unknown.
(cherry picked from commit e7e6e4b035f51ab4a962b45a957254859f264f4f)

Co-authored-by: János Kukovecz <kukoveczjanos@gmail.com>

[3.12] Document that `os.link()` is not available on Emscripten (GH-104822) (GH-107308)

Document that `os.link()` is not available on Emscripten (GH-104822)
(cherry picked from commit 737d1da0746053d515158eac5b115e8bd813f6d3)

Co-authored-by: Roman Yurchak <rth.yurchak@gmail.com>

[3.12] gh-107091: Fix some uses of :c:type: role (GH-107138) (GH-107312)

(cherry picked from commit 6d5b6e71c87fca7c5c26f5dd8f325087962215cc)

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

[3.12] gh-107091: Fix some uses of :c:member: role (GH-107129) (GH-107310)

(cherry picked from commit af61cb9c7837ff3c11da79e3ee1cab3fdd0ba4da)

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

[3.12] gh-106948: Update documentation nitpick_ignore for c:identifer domain (GH-107295) (#107297)

gh-106948: Update documentation nitpick_ignore for c:identifer domain (GH-107295)

Update the nitpick_ignore of the documentation configuration to fix
Sphinx warnings about standard C types when declaring functions with
the "c:function" markups.

Copy standard C types declared in the "c:type" domain to the
"c:identifier" domain, since "c:function" markup looks for types in
the "c:identifier" domain.

(cherry picked from commit b1de3807b832b72dfeb66dd5646159d08d2cc74a)

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

[3.12] gh-106350: Tkinter: do not ignore return value of `mp_init()` (GH-106351) (GH-107258)

(cherry picked from commit b5ae7c498438657a6ba0bf4cc216b9c2c93a06c7)

Co-authored-by: Christopher Chavez <chrischavez@gmx.us>

[3.12] gh-106368: Increase Argument Clinic CLI test coverage (GH-107277) (#107282)

(cherry picked from commit 579100f6d75a27429e7f8de74935d7bc3a3e44e6)

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

[3.12] gh-106185: Deduplicate `CPythonTracebackErrorCaretTests` in `test_traceback` (GH-106187) (GH-107268)

(cherry picked from commit 7c89f1189229c5c67a3766e24ecf00cde658b7fd)

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

[3.12] gh-106939: document ShareableList nul-strip quirk. (GH-107266) (#107269)

gh-106939: document ShareableList nul-strip quirk. (GH-107266)

* gh-106939: document ShareableList nul-strip quirk.
* Mention the `int` size constraint.
(cherry picked from commit 70dc00946938027d5a79bcb7b65038319040144e)

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

[3.12] gh-107226: PyModule_AddObjectRef() should only be in the limited API 3.10 (GH-107227) (GH-107260)

(cherry picked from commit 698b01513550798886add5e06a1c3f9a89d7dfc6)

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

[3.12] gh-62519: Make pgettext search plurals when translation is not found (GH-107118) (GH-107134)

(cherry picked from commit b3c34e55c053846beb35f5e4253ef237b3494bd0)

Co-authored-by: Tomas R <tomas.roun8@gmail.com>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>

[3.12] Remove superflous whitespaces in `layout.html`. (#107251)

Remove superflous whitespaces in layout.html.

[3.12] gh-105699: Add some stress tests for subinterpreter creation (GH-106966) (gh-107012)

gh-105699: Add some stress tests for subinterpreter creation (GH-106966)
(cherry picked from commit adda43dc0bcea853cbfa33126e5549c584cef8be)

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

[3.12] gh-105059: Fix MSCV compiler warning on PyObject union (GH-107239) (#107248)

gh-105059: Fix MSCV compiler warning on PyObject union (GH-107239)

Use pragma to ignore the MSCV compiler warning on the PyObject
nameless union.
(cherry picked from commit 1c8fe9bdb624d356643ee569151a9e4f2963179a)

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

[3.12] gh-107237: Fix test_udp_reconnection() of test_logging (GH-107238) (#107242)

gh-107237: Fix test_udp_reconnection() of test_logging (GH-107238)

test_logging: Fix test_udp_reconnection() by increasing the timeout
from 100 ms to 5 minutes (LONG_TIMEOUT).

Replace also blocking wait() with wait(LONG_TIMEOUT) in
test_output() to prevent the test to hang.
(cherry picked from commit ed082383272c2c238e364e9cc83229234aee23cc)

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

[3.12] gh-105059: Use GCC/clang extension for PyObject union (GH-107232) (#107236)

gh-105059: Use GCC/clang extension for PyObject union (GH-107232)

Anonymous union is new in C11. To prevent compiler warning
when using -pedantic compiler option, use Clang and GCC
extension on C99 and older.
(cherry picked from commit 6261585d63a31835b65d445d99dc14cca3fe9cf5)

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

[3.12] gh-106996: Add a how-to section to the turtle documentation (GH-107153) (#107233)

Co-authored-by: Daniele Procida <daniele@vurt.org>
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>

[3.12] gh-106774: Update bundled pip version to 23.2.1 (GH-106775) (gh-107222)

gh-106774: Update bundled pip version to 23.2.1 (GH-106775)

[3.12] gh-106917: fix super classmethod calls to non-classmethods (GH-106977). (#107204)

(cherry picked from commit e5d5522612e03af3941db1d270bf6caebf330b8a)

[3.12] gh-102304: Rename _Py_IncRefTotal_DO_NOT_USE_THIS() (GH-107193) (#107199)

gh-102304: Rename _Py_IncRefTotal_DO_NOT_USE_THIS() (GH-107193)

* Rename _Py_IncRefTotal_DO_NOT_USE_THIS() to _Py_INCREF_IncRefTotal()
* Rename _Py_DecRefTotal_DO_NOT_USE_THIS() to _Py_DECREF_DecRefTotal()
* Remove temporary _Py_INC_REFTOTAL() and _Py_DEC_REFTOTAL() macros
(cherry picked from commit 8ebc9fc321ba1eeb3282c2170f351c54956893e6)

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

[3.12] gh-98608: Move PyInterpreterConfig to pylifecycle.h (GH-107191) (#107198)

gh-98608: Move PyInterpreterConfig to pylifecycle.h (GH-107191)

Move PyInterpreterConfig structure and associated macros from
initconfig.h to pylifecycle.h: it's not related to the Python
Initialization Configuration.
(cherry picked from commit e717b47ed8ae7017f0bfb835fe673aa836e8fcca)

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

[3.12] GH-96803: Move PyUnstable_InterpreterFrame_GetCode() to Python.h (GH-107188) (#107195)

GH-96803: Move PyUnstable_InterpreterFrame_GetCode() to Python.h (GH-107188)

Declare the following 3 PyUnstable functions in
Include/cpython/pyframe.h rather than Include/cpython/frameobject.h,
so they are now provided by the standard "GH-include <Python.h>".
(cherry picked from commit 837fa5c0cd92e70f625377c9ffb7ac31a23d7d63)

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

[3.12] gh-106368: Increase Argument Clinic CLI test coverage (GH-107156) (#107189)

Instead of hacking into the Clinic class, use the Argument Clinic tool
to run the ClinicExternalTest test suite.

(cherry picked from commit 83a2837b328c58b243f7d97bec12c64ec66681c5)

Co-authored-by: Erlend E. Aasland <erlend@python.org>
Co-authored-by: Nikita Sobolev <mail@sobolevn.me>

[3.12] gh-107017: Change Chapter Strings to Texts in the Introduction chapter. (GH-107104) (#107167)

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

[3.12] Docs: Add missing markup to Argument Clinic docs (GH-106876) (#107181)

(cherry picked from commit ff5f94b72c8aad8e45c397c263dbe7f19221735f)

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

[3.12] Fix PyVectorcall_Function doc versionadded (GH-107140) (#107173)

Fix PyVectorcall_Function doc versionadded (GH-107140)

The documentation implies that PyVectorcall_Function() was available in Python 3.8.
This is half-true - it was available under a different name. I think it's clearer to set
the "version added" to 3.9.
(cherry picked from commit 0a9b339363a59be1249189c767ed6f46fd71e1c7)

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

[3.12] Docs: Remove duplicate word in Argument Clinic howto heading (GH-107169) (#107171)

(cherry picked from commit ebe44a5155e9abc70c4b8914ad26b27c2b84f72b)

Co-authored-by: Hakan Celik <hakancelikdev@gmail.com>

[3.12] gh-105291: Add link to migration guide for distutils (GH-107130) (#107160)

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

[3.12] gh-106948: Docs: Disable links for C standard library functions, OS utility functions and system calls (GH-107062) (#107154)

(cherry picked from commit b447e19e720e6781025432a40eb72b1cc93ac944)

Co-authored-by: Erlend E. Aasland <erlend@python.org>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

[3.12] gh-107017: Analolgy to Pascal and C replaced. (GH-107025) (#107124)

(cherry picked from commit e59da0c4f283b966ccb175fb94460f58211a9704)

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

[3.12] Introduce a gate/check GHA job (GH-97533) (#107114)

(cherry picked from commit e7cd557)

[3.12] bpo-18319: gettext() can retrieve a message even if a plural form exists (GH-19869) (#107108)

(cherry picked from commit 54632528eeba841e4a8cc95ecbd84c9aca8eef57)

Co-authored-by: Gilles Bassière <gbassiere@gmail.com>

[3.12] gh-106186: Don't report MultipartInvariantViolationDefect for valid multipart emails when parsing header only (GH-107016) (#107111)

(cherry picked from commit c65592c4d6d7552fb6284442906a96a6874cb266)

Co-authored-by: htsedebenham <31847376+htsedebenham@users.noreply.github.com>

[3.12] gh-107091: Fix the use of some C domain roles (GH-107092) (GH-107113)

(cherry picked from commit 08a228da05a7aec937b65eea21f4091fa3c6b5cf)

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

[3.12] gh-106969: Indicate no modules were added in 3.10 & 3.12 (GH-106988) (#107094)

The "New Modules" section was left in place to ensure that the anchor
link for new modules will still exist:

/whatsnew/3.12.htmlGH-new-modules
/whatsnew/3.10.htmlGH-new-modules

This means that existing links to this section don't break.
(cherry picked from commit 6dbffaed17d59079d6a2788d686009f762a3278f)

Co-authored-by: Sebastiaan Zeeff <33516116+SebastiaanZ@users.noreply.github.com>

[3.12] gh-106996: Add the basics of a turtle graphics tutorial (GH-107072) (#107109)

[3.12] gh-101100: Fix some broken sphinx references (GH-107095) (#107103)

(cherry picked from commit f5147c0cfbd7943ff10917225448c36a53f9828d)

Co-authored-by: wulmer <wulmer@users.noreply.github.com>