[3.12] gh-58282: Fix support of tuple metavar for positional arguments in argparse (GH-124782) (GH-124881)

Previously, formatting help output or error message for positional argument
with a tuple metavar raised exception.

(cherry picked from commit 9b31a2d83fa7cb0fe4d75ce7cf6a2c9ea2ce0728)

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

[3.12] Highlight `datetime.timedelta.seconds` vs `.total_seconds()` in docs. (GH-124811) (GH-124863)

Highlight `datetime.timedelta.seconds` vs `.total_seconds()` in docs. (GH-124811)

Thanks to the reviewers for suggesting the use of a "caution" section instead of "warning" or "note".
(cherry picked from commit d150e4abcfc13770c2d239878ed337fb53e51de5)

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

[3.12] gh-124842: Fix test.support.import_helper.make_legacy_pyc() (GH-124843) (GH-124854)

For source file "path/to/file.py" it created file with incorrect path
"/absolute/path/to/path/to/file.pyc" instead of "path/to/file.pyc".
(cherry picked from commit 60ff67d010078eca15a74b1429caf779ac4f9c74)

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

[3.12] Doc: Fix archive filenames for standard builds (GH-124826) (#124837)

Doc: Fix archive filenames for standard builds (GH-124826)
(cherry picked from commit 91e64be731fe42e6b252b95d79d900251388bfc6)

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

Post 3.12.7

Python 3.12.7

[3.12] gh-124309: Revert eager task factory fix to prevent breaking downstream (GH-124810) (#124817)

gh-124309: Revert eager task factory fix to prevent breaking downstream (GH-124810)

* Revert "GH-124639: add back loop param to staggered_race (GH-124700)"

This reverts commit e0a41a5dd12cb6e9277b05abebac5c70be684dd7.

* Revert "gh-124309: Modernize the `staggered_race` implementation to support eager task factories (GH-124390)"

This reverts commit de929f353c413459834a2a37b2d9b0240673d874.
(cherry picked from commit 133e929a791d209b578b4822a7a07f4570b3803b)

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

[3.12] gh-124785: Revert "[3.12] gh-116510: Fix a crash due to shared immortal interned strings. (gh-124541)" (#124814)

Revert "[3.12] gh-116510: Fix a crash due to shared immortal interned strings. (gh-124541)"

This reverts commit 5dd07ebc0c27e2fffdfd041401c8cc7f0cda0dfc.

[3.12] Docs: Update and proofread `library/venv.rst` (GH-124121) (#124680)

* [3.12] Docs: Update and proofread `library/venv.rst` (GH-124121)
(cherry picked from commit 23e812b84ae688a56a1011ed69a0d178c70e35ea)

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

---------

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

[3.12] Docs: for for/else clarify that return or raise also skip the else (GH-124591) (#124660)

Docs: for for/else clarify that return or raise also skip the else (GH-124591)

(cherry picked from commit 5329d1b74a86b3a22ff36f7976bfe720ee06d10d)

Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>

[3.12] gh-123223: Adding hyperlink of argument in warnings.catch_warnings: (GH-123231) (#124527)

gh-123223: Adding hyperlink of argument in warnings.catch_warnings: (GH-123231)
(cherry picked from commit 828583a7855f15edc96e6721c226ace098ba463b)

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

[3.12] gh-116810: fix memory leak in ssl module (GH-123249) (GH-124801)

gh-116810: fix memory leak in ssl module (GH-123249)

Resolve a memory leak introduced in CPython 3.10's :mod:`ssl` when the :attr:`ssl.SSLSocket.session` property was accessed. Speeds up read and write access to said property by no longer unnecessarily cloning session objects via serialization.

(cherry picked from commit 7e7223e18f58ec48fb36a68fb75b5c5b7a45042a)

Co-authored-by: Jeffrey R. Van Voorst <jeff.vanvoorst@gmail.com>
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: Gregory P. Smith <greg@krypto.org>
Co-authored-by: Antoine Pitrou <antoine@python.org>

[3.12] Doc: Run HTML and non-HTML daily builds separately (GH-124493) (#124791)

Doc: Run HTML and non-HTML daily builds separately (GH-124493)
(cherry picked from commit cce1125574f7b74343afda4bd0030706f67e13df)

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

[3.12] Fix `c-api/file.rst` indexes (GH-114608) (#124786)

(cherry picked from commit 23fb9f0777b054526b3b32f58e60b2a03132bf45)

[3.12] Create hyperlink and fix typos in macOS installer (#123805)

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

[3.12] Docs: improve generic `typing.NamedTuple` example (GH-124739) (#124765)

Docs: improve generic `typing.NamedTuple` example (GH-124739)
(cherry picked from commit 76fbee642e78eacf3866102f31e0ac969b57f1e6)

Co-authored-by: CBerJun <121291537+CBerJun@users.noreply.github.com>

[3.12] gh-58573: Fix conflicts between abbreviated long options in the parent parser and subparsers in argparse (GH-124631) (GH-124759)

Check for ambiguous options if the option is consumed, not when it is
parsed.
(cherry picked from commit 3f27153e077d7e9448e2f081275931968b40cc74)

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

[3.12] gh-116850: Fix argparse for namespaces with not directly writable dict (GH-124667) (GH-124758)

It now always uses setattr() instead of setting the dict item to modify
the namespace. This allows to use a class as a namespace.
(cherry picked from commit 95e92ef6c74e973ea13d15180190d0fa2af82fbf)

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

[3.12] gh-61181: Fix support of choices with string value in argparse (GH-124578) (GH-124756)

Substrings of the specified string no longer considered valid values.
(cherry picked from commit f1a2417b9e2993e584610851ac004c8b0599b323)

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

[3.12] gh-124345: Support abbreviated single-dash long options with = in argparse (GH-124428) (GH-124754)

(cherry picked from commit 61180446eee2aef07b042c7e8892c45afabd1499)

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

[3.12] gh-80259: Fix conflict between type and default=SUPPRESS in argparse (GH-124519) (GH-124752)

type() no longer called for SUPPRESS.

This only affects positional arguments with nargs='?'.
(cherry picked from commit 9bcadf589ab6f7b9d309290de7a80156b6905d35)

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

[3.12] gh-104860: Fix allow_abbrev=False for single-dash long options (GH-124340) (GH-124750)

(cherry picked from commit 49e105f9488de18d3d92948232fcbd956cbe0c6e)

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

[3.12] GH-124639: add back loop param to staggered_race (GH-124700) (#124744)

GH-124639: add back loop param to staggered_race (GH-124700)
(cherry picked from commit e0a41a5dd12cb6e9277b05abebac5c70be684dd7)

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

[3.12] docs: improve venv docs (GH-124540) (#124728)

- Move "versionchanged" notes that apply to the whole class to the
  end of the class docs
- Remove or move notes next to the method list that apply to individual
  methods.
- Mark up parameters using the appropriate syntax
- Do not capitalize "boolean"
- Shorten some text
(cherry picked from commit c976d789a98047ae7ddec6d13c9ea7086d9fa3f9)

[3.12] Doc: Fix default ``latex_elements['papersize']`` (GH-124525) (#124726)

Doc: Fix default ``latex_elements['papersize']`` (GH-124525)

https://www.sphinx-doc.org/en/master/latex.htmlGH-the-latex-elements-configuration-setting

It should be 'letterpaper' or 'a4paper' not 'letter' or 'a4'
(not to be confused with PAPER env variable).
(cherry picked from commit fae5058ec13aa3b4f1acc549fadfbbbc2628f1e9)

Co-authored-by: Jean-François B <2589111+jfbu@users.noreply.github.com>

[3.12] gh-90190: Add doc for using `singledispatch` with precise collection type hints (GH-116544) (#124711)

Co-authored-by: Matt Delengowski <matt.delengowski@gmail.com>

[3.12] gh-113993: Make interned strings mortal (GH-120520, GH-121364, GH-121903, GH-122303) (#123065)

This backports several PRs for gh-113993, making interned strings mortal so they can be garbage-collected when no longer needed.

* Allow interned strings to be mortal, and fix related issues (GH-120520)

  * Add an InternalDocs file describing how interning should work and how to use it.

  * Add internal functions to *explicitly* request what kind of interning is done:
    - `_PyUnicode_InternMortal`
    - `_PyUnicode_InternImmortal`
    - `_PyUnicode_InternStatic`

  * Switch uses of `PyUnicode_InternInPlace` to those.

  * Disallow using `_Py_SetImmortal` on strings directly.
    You should use `_PyUnicode_InternImmortal` instead:
    - Strings should be interned before immortalization, otherwise you're possibly
      interning a immortalizing copy.
    - `_Py_SetImmortal` doesn't handle the `SSTATE_INTERNED_MORTAL` to
      `SSTATE_INTERNED_IMMORTAL` update, and those flags can't be changed in
      backports, as they are now part of public API and version-specific ABI.

  * Add private `_only_immortal` argument for `sys.getunicodeinternedsize`, used in refleak test machinery.

   Make sure the statically allocated string singletons are unique. This means these sets are now disjoint:
    - `_Py_ID`
    - `_Py_STR` (including the empty string)
    - one-character latin-1 singletons

    Now, when you intern a singleton, that exact singleton will be interned.

  * Add a `_Py_LATIN1_CHR` macro, use it instead of `_Py_ID`/`_Py_STR` for one-character latin-1 singletons everywhere (including Clinic).

  * Intern `_Py_STR` singletons at startup.

  * Beef up the tests. Cover internal details (marked with `@cpython_only`).

  * Add lots of assertions

* Don't immortalize in PyUnicode_InternInPlace; keep immortalizing in other API (GH-121364)

  * Switch PyUnicode_InternInPlace to _PyUnicode_InternMortal, clarify docs

  * Document immortality in some functions that take `const char *`

  This is PyUnicode_InternFromString;
  PyDict_SetItemString, PyObject_SetAttrString;
  PyObject_DelAttrString; PyUnicode_InternFromString;
  and the PyModule_Add convenience functions.

  Always point out a non-immortalizing alternative.

  * Don't immortalize user-provided attr names in _ctypes

* Immortalize names in code objects to avoid crash (GH-121903)

* Intern latin-1 one-byte strings at startup (GH-122303)

There are some 3.12-specific changes, mainly to allow statically allocated strings in deepfreeze. (In 3.13, deepfreeze switched to the general `_Py_ID`/`_Py_STR`.)

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

[3.12] gh-118181: Fix parameter markup in AST docs (GH-124473). (#124705)

(cherry picked from commit 09aebb1fbc0c1d771d4942844d5e2077fcdf56c9)

[3.12] gh-124487: Update Windows API version to Windows 8.1 (#124676)

gh-124487: Update Windows API version to Windows 8.1

[3.12] gh-119004: fix a crash in equality testing between `OrderedDict` (GH-121329) (#124508)

gh-119004: fix a crash in equality testing between `OrderedDict` (GH-121329)
(cherry picked from commit 38a887dc3ec52c4a7222279bf4b3ca2431b86de9)

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

[3.12] Fixup indentation for docs on `ModuleSpec` attributes (#124681) (#124686)

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

[3.12] gh-89683: add tests for `deepcopy` on frozen dataclasses (GH-123098) (gh-124679)

gh-89683: add tests for `deepcopy` on frozen dataclasses (gh-123098)

Co-authored-by: Eric V. Smith <ericvsmith@users.noreply.github.com>

[3.12] GH-95079: document error behaviour for some unicode C APIs (GH-95080) (#124662)

(cherry picked from commit b79a21ea429844e84509430e636d808ea9cff244)

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

[3.12] gh-86673: Harden `test_ttk.test_element_create_image` (GH-123335) (#124655)

(cherry picked from commit 08e1bbe4a329e5961716f030c6ccfe92c736bf28)

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

[3.12] gh-116510: Fix a crash due to shared immortal interned strings. (gh-124541)

Fix a crash caused by immortal interned strings being shared between
sub-interpreters that use basic single-phase init.  In that case, the string
can be used by an interpreter that outlives the interpreter that created and
interned it.  For interpreters that share obmalloc state, also share the
interned dict with the main interpreter.

[3.12] gh-116510: Fix crash during sub-interpreter shutdown (gh-124536)

Fix a bug that can cause a crash when sub-interpreters use "basic"
single-phase extension modules.  Shared objects could refer to PyGC_Head
nodes that had been freed as part of interpreter shutdown.

[3.12] gh-115528: Update language reference for PEP 646 (GH-121181) (#124633)

gh-115528: Update language reference for PEP 646 (GH-121181)

To recap: the objective is to make starred expressions valid in `subscription`,
which is used for generics: `Generic[...]`, `list[...]`, etc.

What _is_ gramatically valid in such contexts? Seemingly any of the following.
(At least, none of the following throw `SyntaxError` in a 3.12.3 REPL.)

    Generic[x]
    Generic[*x]
    Generic[*x, y]
    Generic[y, *x]
    Generic[x := 1]
    Generic[x := 1, y := 2]

So introducting

    flexible_expression: expression | assignment_expression | starred_item

end then switching `subscription` to use `flexible_expression` sorts that.

But then we need to field `yield` - for which any of the following are
apparently valid:

    yield x
    yield x,
    yield x, y
    yield *x,
    yield *x, *y

Introducing a separate `yield_list` is the simplest way I've been figure out to
do this - separating out the special case of `starred_item ,`.

(cherry picked from commit 7d3497f617edf77cb6ead6f5e62bce98d77b9ab8)

Co-authored-by: Matthew Rahtz <matthew.rahtz@gmail.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>

[3.12] Programming FAQ: Mention object.__setattr__ as a technique for delegation (GH-124617) (#124625)

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

[3.12] gh-124378: Update test_ttk for Tcl/Tk 8.6.15 (GH-124545)

(cherry picked from commit fb6bd31cb74d2f7e7b525ee4fe9f45475fc94ce9)

Co-authored-by: Zachary Ware <zach@python.org>
Co-authored-by: Marc Culler <culler@users.noreply.github.com>

[3.12] Doc: Use the short version for daily downloads (GH-124602) (#124611)

Doc: Use the short version for daily downloads (GH-124602)
(cherry picked from commit 2c472d36b776636fb00881a717f69e43672588b1)

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

[3.12] gh-124498: Fix `TypeAliasType` not to be generic, when `type_params=()` (GH-124499) (#124604)

gh-124498: Fix `TypeAliasType` not to be generic, when `type_params=()` (GH-124499)
(cherry picked from commit abe5f799e6ce1d177f79554f1b84d348b6141045)

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

[3.12] gh-123560: Correct docs for "empty" format type for floats (GH-123561) (#124597)

gh-123560: Correct docs for "empty" format type for floats (GH-123561)
(cherry picked from commit 274d9ab619b8150a613275835234ea9ef935f21f)

Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>

[3.12] gh-124234: Improve docs for `Mock.reset_mock` (GH-124237) (#124592)

gh-124234: Improve docs for `Mock.reset_mock` (GH-124237)
(cherry picked from commit 19fed6cf6eb51044fd0c02c6338259e2dd7fd462)

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

[3.12] Doc: Improve documentation for the ``path`` argument in ``shutil.which()`` (GH-124494) (#124576)

[3.12] gh-101100: Make __subclasses__ doctest stable (GH-124577) (#124580)

Using a standard library class makes this test difficult to maintain
as other tests and other parts of the stdlib may create subclasses,
which may still be alive when this test runs depending on GC timing.
(cherry picked from commit 08a467b537b3d9b499d060697e79b3950374ab0f)

[3.12] gh-124309: Modernize the `staggered_race` implementation to support e… (#124574)

gh-124309: Modernize the `staggered_race` implementation to support eager task factories (#124390)

Co-authored-by: Thomas Grainger <tagrain@gmail.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
(cherry picked from commit de929f353c413459834a2a37b2d9b0240673d874)

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

[3.12] For-else deserves its own section in the tutorial (GH-123946) (#124563)

(cherry picked from commit ffdc80e93d9d947531fa0123e5b392c6f1fd9136)

Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>

[3.12] gh-123242: Note that type.__annotations__ may not exist (GH-124557) (#124562)

Closes GH-123242. The real criterion is that the attribute does not
exist on heap types, but I don't think we should discuss heap vs.
static types in the language reference.
(cherry picked from commit 99b23c64de301c9e77add6b0d8e60118ef807840)

[3.12] gh-101100: Add a table of class attributes to the "Custom classes" section of the data model docs (#124480) (#124558)

[3.12] Doc: Use ``major.minor`` for documentation distribution archive filenames (GH-124489) (#124535)

Doc: Use ``major.minor`` for documentation distribution archive filenames (GH-124489)
(cherry picked from commit 6318ffcba21f8fc155f5558237ab03aa45f0e174)

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

[3.12] gh-108951: Document how to terminate an asyncio.TaskGroup (GH-123837) (#123957)

gh-108951: Document how to terminate an asyncio.TaskGroup (GH-123837)

We don't want to add another API, since the recipe is straightforward and rarely needed.

The advantage is that we could backport this to the earliest Python version that has taskgroups (3.11, alas in security mode already, so we'll just do 3.12 and 3.13).
(cherry picked from commit ef05801ba0cbf090034df17e2a0420fb42c2d538)

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

[3.12] bpo-44864: Do not translate user-provided strings in ArgumentParser.add_subparsers() (GH-27667) (GH-124505)

Call _() on literal strings only.
(cherry picked from commit d3c76dff444046504754a437dceebc9a9c87ef18)

Co-authored-by: Jérémie Detrey <jdetrey@users.noreply.github.com>

[3.12] gh-123445: calendar: Improve descriptions for day and month attributes (GH-123483) (#124501)

gh-123445: calendar: Improve descriptions for day and month attributes (GH-123483)
(cherry picked from commit 8447c933da308939b06e33544ca9abc9fc46aa8b)

Co-authored-by: Mat S <mscull@gmail.com>
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
Co-authored-by: Eric V. Smith <ericvsmith@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>

[3.12] Adjust build_ubuntu_ssltests job to use cache for the correct OS version (GH-124482)

(cherry picked from commit 54dd77fb8c880d7655fffab934978e277b4275fe)

Authored-by: Zachary Ware <zach@python.org>

[3.12] gh-121735: Fix module-adjacent references in zip files (gh-123037) (#124011)

[3.12] GH-87358: Add clarification about nargs and default argparse behaviour (GH-124094) (#124441)

Co-authored-by: Savannah Ostrowski <savannahostrowski@gmail.com>

[3.12] gh-124120: Document `Annotated.__origin__` (GH-124125) (#124417)

gh-124120: Document `Annotated.__origin__` (GH-124125)
(cherry picked from commit faef3fa653f2901cc905f98eae0ddcd8dc334d33)

Co-authored-by: sobolevn <mail@sobolevn.me>
Co-authored-by: Brian Schubert <brianm.schubert@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

[3.12] gh-59317: Improve parsing optional positional arguments in argparse (GH-124303) (GH-124437)

Fix parsing positional argument with nargs equal to '?' or '*' if it is
preceded by an option and another positional argument.
(cherry picked from commit 4a5e4aade420c594c5b3fe0589e9e6b444bd6ee5)

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

[3.12] gh-65169: Clarify prog default in argparse (GH-31602) (GH-124431)

(cherry picked from commit e69ff34e81eceb69de6623205c87e0145f1831e4)

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

[3.12] gh-124188: Fix PyErr_ProgramTextObject() (GH-124189) (GH-124426)

* Detect source file encoding.
* Use the "replace" error handler even for UTF-8 (default) encoding.
* Remove the BOM.
* Fix detection of too long lines if they contain NUL.
* Return the head rather than the tail for truncated long lines.
(cherry picked from commit e2f710792b0418b8ca1ca3b8cdf39588c7268495)

[3.12] gh-72795: Make positional arguments with nargs='*' or REMAINDER non-required (GH-124306) (GH-124422)

This allows to use positional argument with nargs='*' and without default
in mutually exclusive group and improves error message about required
arguments.
(cherry picked from commit 3c83f9958c14cd62ad8951c53536f7788745b0ba)

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

[3.12] gh-53780: Ignore the first "--" (double dash) between an option and command in argparse (GH-124275) (GH-124420)

(cherry picked from commit c578271366176a1d1b0941897efefb6e4d6508b4)

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

[3.12] gh-63143: Fix parsing mutually exclusive arguments in argparse (GH-124307) (GH-124419)

Arguments with the value identical to the default value (e.g. booleans,
small integers, empty or 1-character strings) are no longer considered
"not present".
(cherry picked from commit 3094cd17b0e5ba69309c54964744c797a70aa11b)

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

[3.12] gh-124130: Increase test coverage for \b and \B in regular expressions (GH-124330) (GH-124414)

(cherry picked from commit b82f07653e1e15a48ebaf8de324f52559e470254)

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

[3.12] Docs: Update two FAQs for Python 3 (GH-124247) (GH-124256)

(cherry picked from commit 5f011115943933ff36adf997c886d73ea88003fb)

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

[3.12] Bump Ruff to 0.6.7 (#124384) (#124391)

[3.12] Doc: Add ``make dist-no-html`` (GH-124383) (#124388)

[3.12] GH-87041: Fix incorrect indentation in argparse help (GH-124230) (GH-124374)

In case of usage a long command along with max_help_position more than
the length of the command, the command's help was incorrectly started
on the new line.

(cherry picked from commit 7ee99217345af3010bf05b1f5241c661a5e0ea9b)

Co-authored-by: Savannah Ostrowski <savannahostrowski@gmail.com>
Co-authored-by: Pavel Ditenbir <pavel.ditenbir@gmail.com>

[3.12] GH-109975: Copyedit 3.13 What's New: Copyedit C API deprecations pending removal (GH-124336) (#124365)

(cherry picked from commit e7d465a607b77a552d1e07f3fafa81ef5fc799d2)

[3.12] GH-79714: Add mention of stderr for clarity to ArgumentParser.exit() (GH-123932) (GH-124356)

(cherry picked from commit 5f5c0b9c23238dc0a1fdb764f625ae0cc5604519)

[3.12] Replace the term `Immutable` with a `Hashable` in the `sequence` entry of the Glossary (GH-124350) (#124353)

Replace the term `Immutable` with a `Hashable` in the `sequence` entry of the Glossary (GH-124350)

The term `Immutable` in the `sequence` entry of the glossary is used incorrectly, in fact dicts accepts hashable keys, which is not the same as immutable.
(cherry picked from commit 6203ef35dd4ee9dd59759ce83eace8eacac69685)

Co-authored-by: decorator-factory <42166884+decorator-factory@users.noreply.github.com>

[3.12] Fix doctrees directory for the gettext builder (GH-122997) (#124339)

Fix doctrees directory for the gettext builder (GH-122997)
(cherry picked from commit 315a933a5b3ae4379077096b6852f85a81a7d75f)

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

[3.12] gh-124130: Notes on empty string corner case of category `\B` (GH-124133) (#124329)

gh-124130: Notes on empty string corner case of category `\B` (GH-124133)
(cherry picked from commit d3e79d75d164c338a64fd66edb26e69c501cee58)

Signed-off-by: y5c4l3 <y5c4l3@proton.me>
Co-authored-by: Y5 <124019959+y5c4l3@users.noreply.github.com>
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>

[3.12] Backport idlelib typos (#124324)

See https://github.com/python/cpython/pull/123597.

(cherry picked from commit 1f4a49e)

Co-authored-by: abstractee

[3.12] gh-112938: IDLE - Fix uninteruptable hang when Shell gets rapid continuous output. (GH-124310) (#124319)

gh-112938: IDLE - Fix uninteruptable hang when Shell gets rapid continuous output. (GH-124310)

https://github.com/python/cpython/issues/88496 replaced text.update with text.update_idletasks in colorizer.py and outwin.py to fix test failures on macOS.  While theoretically correct, the result was Shell freezing when receiving continuous short strings to print.  Test: `while 1: 1`.

The guess is that there is no idle time in which to do the screen update.  Reverting the change in one of the files,
outwin, fixes the issue.  Colorizer runs ever 1/20 second and seems to work fine.

When running test-outwin on macOS, alias 'update'
to 'update_idletasks on the text used for testing.
(cherry picked from commit d5f95ec07bb47a4d6554e04d13a979dbeac05f74)

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

[3.12] gh-95468: Add more tests for "--" (double dash) in test_argparse (GH-124274) (GH-124276)

(cherry picked from commit baa3550bc3a119f41cc4eaed5373f9d695208e8e)

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

[3.12] gh-124217, ipaddress: Add RFC 9637 reserved IPv6 block `3fff::/20` (GH-124240) (#124283)

gh-124217, ipaddress: Add RFC 9637 reserved IPv6 block `3fff::/20` (GH-124240)
(cherry picked from commit db6eb3640a7d98db6fea17cf9da4cb14504e5571)

Signed-off-by: y5c4l3 <y5c4l3@proton.me>
Co-authored-by: Y5 <124019959+y5c4l3@users.noreply.github.com>

[3.12] Fix typo in XMLParser doc (GH-124129) (#124281)

Fix typo in XMLParser doc (GH-124129)
(cherry picked from commit 622368d99c986ca1a9bdba951ac53f42d7ee6fca)

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

[3.12] gh-124248: Fix crash in struct when processing 0p fields (GH-124251) (#124278)

gh-124248: Fix crash in struct when processing 0p fields (GH-124251)
(cherry picked from commit 63f196090f90cbfe5f698824655f74dea5cb2b29)

Co-authored-by: Brian Schubert <brianm.schubert@gmail.com>

[3.12] gh-81691: Fix handling of multiple "--" (double dashes) in argparse (GH-124233) (GH-124267)

Only the first one has now been removed, all subsequent ones are now
taken literally.
(cherry picked from commit aae126748ff3d442fdbcd07933855ffd7ae6f59c)

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

[3.12] gh-124040: Adjust few tests in testHypot/testDist to get exactly computed results (GH-124042) (GH-124236)

(cherry picked from commit 4420cf4dc9ef7bd3c1c9b5465fa9397304bf0110)

Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>

[3.12] gh-123934: Fix `MagicMock` not to reset magic method return values (GH-124038) (#124232)

gh-123934: Fix `MagicMock` not to reset magic method return values (GH-124038)
(cherry picked from commit 7628f67d55cb65bad9c9266e0457e468cd7e3775)

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

[3.12] gh-124083: Skip test_signal.test_strsignal() on NetBSD (GH-124084) (#124224)

gh-124083: Skip test_signal.test_strsignal() on NetBSD (GH-124084)

Skip test_strsignal() on NetBSD due to TypeError.
(cherry picked from commit 36682c091407dc9c7e750c22fb71e62466952662)

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

[3.12] Fix `make htmllive` target (GH-124222)

Allow `make -C Doc htmllive` to work without manual venv activation

Set PATH to ensure that `sphinx-autobuild` can find `sphinx-build`.

(cherry picked from commit 9a6e2336e4b54fc13064b77826a67b03b3b45133)

Authored-by: Zachary Ware <zach@python.org>

gh-117505: Run ensurepip in isolated env in Windows installer (GH-118257)

ensurepip forks a subprocess to run pip itself, but that subprocess only inherits a -I isolated mode flag (see _run_pip() in Lib/ensurepip/__init__.py), not the "-E -s" flags that the installer has been using. This means that parts of ensurepip don't actually run in an isolated environment and can make incorrect decisions based on packages installed in the user site-packages.
(cherry picked from commit c9073eb1a99606df1efeb8959e9f11a8ebc23ae2)

Co-authored-by: Michael Vincent <377567+Vynce@users.noreply.github.com>

[3.12] Revert "gh-123974: Fix time.get_clock_info() on NetBSD (GH-123975)" (GH-124115) (GH-124200)

This reverts commit b1d6f8a2ee04215c64aa8752cc515b7e98a08d28.
(cherry picked from commit 79a74102362996bbd4ff5d410a0d57d43c236da4)

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

[3.12] gh-124194: Fix wrong issue number in What's New in Python 3.8 (GH-124195) (#124198)

gh-124194: Fix wrong issue number in What's New in Python 3.8 (GH-124195)
(cherry picked from commit d8c0fe1944ac41787e16fa60e608f56c8235e100)

Co-authored-by: Bradley Reynolds <bradley.reynolds@darbia.dev>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>

[3.12] gh-123836: workaround fmod(x, y) bug on Windows (GH-124171) (#124186)

Buildbot failure on Windows 10 with MSC v.1916 64 bit (AMD64):
FAIL: testFmod (test.test_math.MathTests.testFmod)
----------------------------------------------------------------------
Traceback (most recent call last):
  File "D:\buildarea\3.x.bolen-windows10\build\Lib\test\test_math.py", line 605, in testFmod
    self.ftest('fmod(-10, 1)', math.fmod(-10, 1), -0.0)
    ~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "D:\buildarea\3.x.bolen-windows10\build\Lib\test\test_math.py", line 258, in ftest
    self.fail("{}: {}".format(name, failure))
    ~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
AssertionError: fmod(-10, 1): expected -0.0, got 0.0 (zero has wrong sign)

Here Windows loose sign of the result; if y is nonzero, the result
should have the same sign as x.

This amends commit 28aea5d07d.
(cherry picked from commit f4dd4402108cc005d45acd4ca83c8530c36a93ca)

[3.12] GH-103484: Fix broken links reported by linkcheck (GH-124169) (#124180)

GH-103484: Fix broken links reported by linkcheck (GH-124169)
(cherry picked from commit ab80c6b402eeec379315fa3df111f6bec2de6900)

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

[3.12] Use pep role instead of url (GH-121611) (#124173)

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

[3.12] gh-123836: Check zero signs in math_testcases.txt (GH-123854) (#124162)

gh-123836: Check zero signs in math_testcases.txt (GH-123854)

Just like cmath_testcases.txt. These tests require IEEE 754 anyway.

Correct zero sign for sqrt tests to match math.h convention.
(cherry picked from commit 28aea5d07d163105b42acd81c1651397ef95ea57)

Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>

[3.12] GH-103484: Fix permanently redirects reported by linkcheck (GH-124144) (GH-124152)

Fix redirects reported by linkcheck, update docs conf.py checks.
(cherry picked from commit 0a32c6959c265d21d7c43fe8e4aefc8c0983e85e)

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

[3.12] GH-124108: Skip test_locale.test_strcoll_with_diacritic() on NetBSD (GH-124110) (#124147)

GH-124108: Skip test_locale.test_strcoll_with_diacritic() on NetBSD (GH-124110)

Skip test_strcoll_with_diacritic() and test_strxfrm_with_diacritic()
of test_locale on NetBSD due to lack of UTF-8 LC_COLLATE
support.
(cherry picked from commit 10de3600a908f96d1c43dac85ef867991d54708e)

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

[3.12] gh-121023: Improve `_xxtestfuzz/README.rst` (GH-121024) (#124141)

gh-121023: Improve `_xxtestfuzz/README.rst` (GH-121024)
(cherry picked from commit a9c2bc16349c2be3005f97249f3ae9699988f218)

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

[3.12] GH-103484: Tell linkcheck to ignore debian manpage redirects (GH-123019) (#124136)

GH-103484: Tell linkcheck to ignore debian manpage redirects (GH-123019)
(cherry picked from commit 1054a755a3016f95fcd24b3ad20e8ed9048b7939)

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

[3.12] Docs: Drop letter PDF (GH-123912) (#123999)

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

[3.12] gh-94808: Add test coverage for "starred kind" in _PyPegen_set_expr_context (GH-119222) (GH-119264)

Add test coverage for "starred kind" in _PyPegen_set_expr_context
(cherry picked from commit 8231a24454c854ea22590fd74733d29e4274122d)

Co-authored-by: Mark Jason Dominus (陶敏修) <mjd@pobox.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>

[3.12] gh-98442: fix locations of with statement's cleanup instructions (GH-120763) (#120787)

gh-98442: fix locations of with statement's cleanup instructions (GH-120763)
(cherry picked from commit 55596ae0446e40f47e2a28b8897fe9530c32a19a)

gh-98442: fix location of with statement's cleanup instructions

Co-authored-by: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>

[3.12] gh-123974: Fix time.get_clock_info() on NetBSD (GH-123975) (#124073)

gh-123974: Fix time.get_clock_info() on NetBSD (GH-123975)

Fix OSError for thread_time clock on NetBSD by setting default resolution.
(cherry picked from commit b1d6f8a2ee04215c64aa8752cc515b7e98a08d28)

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

[3.12] gh-124030: Skip test_tcsendbreak on NetBSD for ENOTTY error (GH-124031) (GH-124062)

(cherry picked from commit 9f42b62db998131bb5cd555e2fa72ba7e06e3130)

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