Python 3.12.2

[3.12] GH-gh-75705: Set unixfrom envelope in mailbox._mboxMMDF (GH-107117) (GH-115098)

(cherry picked from commit 76108b8b05040fc49a6bc50eb2e990576595c57c)

Co-authored-by: Matthieu Caneill <matthieucan@users.noreply.github.com>

[3.12] gh-112302: Change 'licenseConcluded' field to 'NOASSERTION' (GH-115038) (#115088)

* gh-112302: Change 'licenseConcluded' field to 'NOASSERTION' (GH-115038)
(cherry picked from commit 4bf41879d03b1da3c6d38c39a04331e3ae2e7545)

Co-authored-by: Seth Michael Larson <seth@python.org>
* Update pip SBOM package to version in source

---------

Co-authored-by: Seth Michael Larson <seth@python.org>

[3.12] gh-46968: Fix invalid reference to Sound eXchange (SoX) 12.17.7 license (#115094)

Fix invalid reference to Sound eXchange (SoX) 12.17.7 license

[3.12] gh-112302: Backport SBOM generation tooling (#114730)

[3.12] Backport SBOM generation tooling

[3.12] gh-111239: Update Windows build to use zlib 1.3.1 (GH-114877) (GH-115076)

gh-111239: Update Windows build to use zlib 1.3.1 (GH-114877)
(cherry picked from commit 618d7256e78da8200f6e2c6235094a1ef885dca4)

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

[3.12] gh-106233: Fix stacklevel in zoneinfo.InvalidTZPathWarning (GH-106234) (GH-115081)

(cherry picked from commit d7334e2c2012defaf7aae920d6a56689464509d1)

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

[3.12] gh-115009: Update macOS installer to use SQLite 3.45.1 (#115066) (#115071)

(cherry picked from commit 13eb5215c9de9dd302f116ef0bca4ae23b02842b)

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

[3.12] gh-115015: Argument Clinic: fix generated code for METH_METHOD methods without params (#115016) (#115067)

(cherry picked from commit 09096a1647913526a3d4fa69a9d2056ec82a8f37)

[3.12] gh-109991: Update GitHub CI workflows to use OpenSSL 3.0.13. (GH-115055)

Also update multissltests to use 1.1.1w, 3.0.13, 3.1.5, and 3.2.1.
(cherry picked from commit 299e16ca0f303a1e00bd0e04679862a5d4db5ab2)

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

[3.12] gh-109991: Update macOS installer to use OpenSSL 3.0.13. (GH-115053)

(cherry picked from commit 638e811a3c54a81d8af5a4c08b9497d210823f78)

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

[3.12] gh-109991: Update Windows build to use OpenSSL 3.0.13 (#115047)

(cherry picked from commit 01dceba13e872e9ca24b8e00a2b75db3d0d6c1a3)

[3.12] gh-109475: Fix support of explicit option value "--" in argparse (GH-114814) (GH-115036)

For example "--option=--".
(cherry picked from commit 4aa4f0906df9fc9c6c6f6657f2c521468c6b1688)

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

[3.12] gh-114967: Fix "Built-in Exceptions" documentation ambiguous wording (GH-114968) (#115033)

Change the somewhat vague "listed below" to "listed in this chapter" in Doc/library/exceptions.rst.
The exceptions are listed in multiple sections after two intermediate sections.
---------

(cherry picked from commit 750489cc774df44daa2c0d23e8a404fe62be93d1)
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
Co-authored-by: HarryLHW <123lhw321@gmail.com>

[3.12] GH-69695: Update ``PyImport_ImportModule`` description (GH-103836) GH-114925)

GH-69695: Update ``PyImport_ImportModule`` description (GH-103836)

(cherry picked from commit 9872855a31720f514b84373848b49fca09d66ecd)

Co-authored-by: patenaud <33957588+patenaud@users.noreply.github.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>

[3.12] Remove bogus syntax error marker in csv doc (GH-115017) (#115018)

(cherry picked from commit 39ec7fbba84663ab760853da2ac422c2e988d189)

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

[3.12] gh-114887 Reject only sockets of type SOCK_STREAM in create_da… (#114980)

Also improve exception message.

(cherry picked from commit 94ec2b9c9ce898723c3fe61fbc64d6c8f4f68700)

Co-authored-by: Donghee Na <donghee.na92@gmail.com>

[3.12] gh-114480: Add docs for f_trace_opcodes behavior on 3.12 (#114540)

[3.12] gh-114392: Improve test_capi.test_structmembers (GH-114393) (GH-115010)

Test all integer member types with extreme values and values outside of
the valid range. Test support of integer-like objects. Test warnings for
wrapped out values.
(cherry picked from commit 15f6f048a6ecdf0f6f4fc076d013be3d110f8ed6)

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

[3.12] gh-113803: Fix inaccurate documentation for shutil.move when dst is an existing directory (GH-113837) (#115006)

* fix the usage of dst and destination in shutil.move doc
* update shutil.move doc
(cherry picked from commit da8f9fb2ea65cc2784c2400fc39ad8c800a67a42)

Co-authored-by: Dai Wentao <dwt136@gmail.com>

[3.12] gh-114388: Fix warnings when assign an unsigned integer member (GH-114391) (GH-115001)

* Fix a RuntimeWarning emitted when assign an integer-like value that
  is not an instance of int to an attribute that corresponds to a C
  struct member of type T_UINT and T_ULONG.
* Fix a double RuntimeWarning emitted when assign a negative integer value
  to an attribute that corresponds to a C struct member of type T_UINT.
(cherry picked from commit 3ddc5152550ea62280124c37d0b4339030ff7df4)

[3.12] gh-113951: Tkinter: "tag_unbind(tag, sequence, funcid)" now only unbinds "funcid" (GH-113955) (GH-114997)

Previously, "tag_unbind(tag, sequence, funcid)" methods of Text and
Canvas widgets destroyed the current binding for "sequence", leaving
"sequence" unbound, and deleted the "funcid" command.

Now they remove only "funcid" from the binding for "sequence", keeping
other commands, and delete the "funcid" command.
They leave "sequence" unbound only if "funcid" was the last bound command.
(cherry picked from commit 7e42fddf608337e83b30401910d76fd75d5cf20a)

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

[3.12] gh-113280: Always close socket if SSLSocket creation failed (GH-114659) (GH-114995)

(cherry picked from commit 0ea366240b75380ed7568acbe95d72e481a734f7)

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

[3.12] gh-101100: Fix dangling references in pickle.rst (#114972) (#114999)

gh-101100: Fix dangling references in pickle.rst (#114972)

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

[3.12] gh-113267: Revert "gh-106584: Fix exit code for unittest in Python 3.12 (GH-106588)" (GH-114470) (GH-114994)

This reverts commit 8fc071345b50dd3de61ebeeaa287ccef21d061b2.
(cherry picked from commit ecabff98c41453f15ecd26ac255d531b571b9bc1)

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

[3.12] gh-101100: Fix Sphinx warnings from PEP 3108 stdlib re-organisation (GH-114327) (#114988)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Fix Sphinx warnings from PEP 3108 stdlib re-organisation (#114327)

[3.12] gh-101100: Fix sphinx warnings in `c-api/file.rst` (GH-114546) (#114584)

* gh-101100: Fix sphinx warnings in `c-api/file.rst` (GH-114546)
(cherry picked from commit 01d970c1b8acf3ccf199d5de151a635ffd9d8c61)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>

[3.12] gh-114965: Updated bundled pip to 24.0 (gh-114966) (gh-114971)

gh-114965: Updated bundled pip to 24.0 (gh-114966)

Updated bundled pip to 24.0

(cherry picked from commit a4c298c1494b602a9650b597aad50b48e3fa1f41)

[3.12] gh-101100: Fix Sphinx reference warnings in the glossary (GH-114729) (#114969)

gh-101100: Fix Sphinx reference warnings in the glossary (GH-114729)
(cherry picked from commit ab76d37948fd506af44762dc1c3e32f27d1327a8)

Co-authored-by: Skip Montanaro <skip.montanaro@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

[3.12] gh-114959: tarfile: do not ignore errors when extract a directory on top of a file (GH-114960) (GH-114963)

Also, add tests common to tarfile and zipfile.
(cherry picked from commit 96bce033c4a4da7112792ba335ef3eb9a3eb0da0)

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

[3.12] gh-114955: Add clear to MutableSequence's mixin methods in document (gh-114956) (gh-114961)

[3.12] Update LOGGING example taken from Django docs. (GH-114903) (#114951)

Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com>

[3.12] Normalize heading underline in multiprocessing.rst (GH-114923) (#114946)

This gets rid of the mildly confusing `>>>>>>>' underlines which look vaguely like `diff` punctuation.
(cherry picked from commit 00d7109075dfaadf438362c084e8a1890c53d4c8)

Co-authored-by: Skip Montanaro <skip.montanaro@gmail.com>

[3.12] gh-114913: Add newline to subprocess doc (GH-114941) (#114942)

*creationflags* is a separate topic from *startupinfo*.
Start sentence with 'If given', like previous sentence.
(cherry picked from commit 1183f1e6bfba06ae6c8ea362f96e977bc288e627)

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

[3.12] Bump ruff to 0.2.0 (GH-114932) (#114935)

Bump ruff to 0.2.0 (GH-114932)
(cherry picked from commit 920b89f62751e64a35fa1bebc03701af6d6f31f2)

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

[3.12] Correct timedelta description (GH-101417) (GH-114938)

It only represents the difference between two datetime or
date objects, not between two time objects.
(cherry picked from commit 73d20cafb54193c94577ca60df1ba0410b3ced74)

Co-authored-by: John Belmonte <john@neggie.net>

[3.12] Fix indentation of "versionchanged" in datetime.rst (GH-114933) (GH-114937)

(cherry picked from commit b27812d6320e35d62d91f1b3714be1e38021101a)

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

[3.12] gh-114728: Fix documentation for comparison of objects in datetime module (GH-114749) (GH-114928)

(cherry picked from commit c12240ed28aac6494750e00143bc550c4d6d8ad1)

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

[3.12] gh-103360: Add link in stdtypes.rst to escape sequences in lexical_analysis.rst (GH-103638) (GH-114907)

(cherry picked from commit d29f57f6036353b4e705a42637177442bf7e07e5)

Co-authored-by: Justin Williams <97240811+juswil@users.noreply.github.com>

[3.12] gh-103820: IDLE: Do not interpret buttons 4/5 as scrolling on non-X11 (GH-103821) (GH-114901)

Also fix test_mousewheel: do not skip a check which was broken due to incorrect
delta on Aqua and XQuartz, and probably not because of `.update_idletasks()`.
(cherry picked from commit d25d4ee60cc789a8b9c222859bb720ade1ab2e30)

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

[3.12] Move "format" param doc of shutil.make_archive() on its own paragraph (GH-103829) (GH-114897)

(cherry picked from commit 53339a0ef72fcfc15221792b117c4670b07a0b20)

Co-authored-by: Michal Kaptur <kaptur.michal@gmail.com>

[3.12] gh-101100: Fix sphinx warnings in `howto/logging.rst` (GH-114846) (#114878)

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

[3.12] gh-89891: Refer SharedMemory implementation as POSIX (GH-104678) (GH-114873)

It only uses POSIX API.
(cherry picked from commit 500ede01178a8063bb2a3c664172dffa1b40d7c9)

Co-authored-by: Oleg Iarygin <oleg@arhadthedev.net>

[3.12] Correct description of inheriting from another class (GH-114660) (#114868)

"inherits <someclass>" grates to this reader. I think it should be "inherits from <someclass>".
(cherry picked from commit c9c6e04380ffedd25ea2e582f9057ab9612960c9)

Co-authored-by: Skip Montanaro <skip.montanaro@gmail.com>

[3.12] gh-105031: Clarify datetime documentation for ISO8601 (GH-105049) (GH-114866)

(cherry picked from commit e9dab656380ec03d628979975646748330b76b9b)

Co-authored-by: Nicholas Hollander <31573882+nhhollander@users.noreply.github.com>

[3.12] gh-105089: Fix test_create_directory_with_write test failure in AIX (GH-105228) (GH-114860)

(cherry picked from commit 4dbb198d279a06fed74ea4c38f93d658baf38170)

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

[3.12] gh-107461 ctypes: Add a testcase for nested `_as_parameter_` lookup (GH-107462) (GH-114858)

(cherry picked from commit 0bf42dae7e73febc76ea96fd58af6b765a12b8a7)

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

[3.12] Fix typos in ElementTree documentation (GH-108848) (GH-114854)

PI objects instead of comment objects.
(cherry picked from commit de6f97cd3519c5d8528d8ca1bb00fce4e9969671)

Co-authored-by: Christophe Nanteuil <35002064+christopheNan@users.noreply.github.com>

[3.12] gh-114648: Add IndexError exception to tutorial datastructures list.pop entry (GH-114681) (#114841)

Remove redundant explanation of optional argument.
(cherry picked from commit 57c3e775df5a5ca0982adf15010ed80a158b1b80)

Co-authored-by: srinivasan <shivnaren@gmail.com>

[3.12] gh-67230: Add versionadded notes for QUOTE_NOTNULL and QUOTE_STRINGS (GH-114816) (#114840)

As @GPHemsley pointed out, GH-29469 omitted `versionadded` notes for the 2 new items.
(cherry picked from commit 586057e9f80d57f16334c0eee8431931e4aa8cff)

Co-authored-by: Skip Montanaro <skip.montanaro@gmail.com>

[3.12] CI: Test on macOS M1 (GH-114766) (#114836)

Test on macOS M1
(cherry picked from commit 854e2bc42340b22cdeea5d16ac8b1ef3762c6909)

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

[3.12] gh-114811: Change  '\*' to '*' in warnings.rst (GH-114819) (#114837)

Regression in 3.12.
(cherry picked from commit ff8939e5abaad7cd87f4d1f07ca7f6d176090f6c)

Co-authored-by: Pradyot Ranjan <99216956+prady0t@users.noreply.github.com>

[3.12] gh-109534: fix reference leak when SSL handshake fails (GH-114074) (#114829)

gh-109534: fix reference leak when SSL handshake fails (GH-114074)
(cherry picked from commit 80aa7b3688b8fdc85cd53d4113cb5f6ce5500027)

Co-authored-by: Jamie Phan <jamie@ordinarylab.dev>

[3.12] gh-111112: Avoid potential confusion in TCP server example. (GH-111113) (#114831)

gh-111112: Avoid potential confusion in TCP server example. (GH-111113)

Improve misleading TCP server docs and example.

socket.recv(), as documented by the Python reference documentation,
returns at most `bufsize` bytes, and the underlying TCP protocol means
there is no guaranteed correspondence between what is sent by the client
and what is received by the server.

This conflation could mislead readers into thinking that TCP is
datagram-based or has similar semantics, which will likely appear to
work for simple cases, but introduce difficult to reproduce bugs.
(cherry picked from commit a79a27242f75fc33416d4d135a4a542898d140e5)

Co-authored-by: Aidan Holm <alfh@google.com>

[3.12] Add note to `sys.orig_argv` clarifying the difference from `sys.argv` (GH-114630) (#114821)

Add note to `sys.orig_argv` clarifying the difference from `sys.argv` (GH-114630)
(cherry picked from commit 1836f674c0d86ec3375189a550c8f4a52ff89ae8)

Co-authored-by: Bradley Reynolds <bradley.reynolds@darbia.dev>
Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>

[3.12] gh-114790: Do not execute `workflows/require-pr-label.yml` on forks (GH-114791) (#114800)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>

[3.12] gh-114737: Revert change to ElementTree.iterparse "root" attribute (GH-114755) (GH-114798)

Prior to gh-114269, the iterator returned by ElementTree.iterparse was
initialized with the root attribute as None. This restores the previous
behavior.
(cherry picked from commit 66f95ea6a65deff547cab0d312b8c8c8a4cf8beb)

Co-authored-by: Sam Gross <colesbury@gmail.com>

[3.12] gh-101100: Fix class reference in library/test.rst (GH-114769) (GH-114794)

The text clearly seems to be referencing `TestFuncAcceptsSequencesMixin`,
for which no target is available. Name the class properly and suppress
the dangling reference.
(cherry picked from commit 7a93db44257c0404dc407ff2ddc997f4bb8890ed)

Co-authored-by: Skip Montanaro <skip.montanaro@gmail.com>

[3.12] gh-101100: Fix references in csv docs (GH-114658) (GH-114771)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
(cherry picked from commit 3911b42cc0d404e0eac87fce30b740b08618ff06)

[3.12] Docs: mark up dbm.gnu.open() and dbm.ndbm.open() using param list (GH-114762) (#114783)

(cherry picked from commit c8cf5d7d148944f2850f25b02334400dd0238cb0)

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

[3.12] gh-106392: Fix inconsistency in deprecation warnings in datetime module (GH-114761) (#114767)

gh-106392: Fix inconsistency in deprecation warnings in datetime module (GH-114761)
(cherry picked from commit dc4cd2c9ba60e2ee7e534e2f6e93c4c135df23b9)

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

gh-110190: Fix ctypes structs with array on Windows ARM64 (GH-114753)

(cherry picked from commit a06b606462740058b5d52fefdcdcd679d4f40260)

Co-authored-by: Diego Russo <diego.russo@arm.com>

[3.12] Clarify one-item tuple (GH-114745) (#114757)

A 'single tuple' means 'one tuple, of whatever length.
Remove the unneeded and slightly distracting parenthetical 'singleton' comment.
(cherry picked from commit a1332a99cf1eb9b879d4b1f28761b096b5749a0d)

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

[3.12] Set `hosted_on` for Read the Docs builds (GH-114697) (#114734)

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

[3.12] Fix more references to datetime and time classes (GH-114717) (GH-114725)

They could be confused with references to datetime and time modules.
(cherry picked from commit 39c766b579cabc71a4a50773d299d4350221a70b)

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

[3.12] Remove limit in calendar CLI help message for year arg (GH-114719) (GH-114722)

The limit was removed in 66c88ce30ca2b23daa37038e1a3c0de98f241f50 (GH-4109).
(cherry picked from commit 0f54ee4c6cdba74492183eb2dd142393c7dba403)

Co-authored-by: Steven Ward <planet36@users.noreply.github.com>

[3.12] gh-101100: Fix datetime reference warnings (GH-114661) (GH-114716)

(cherry picked from commit e8b8f5e9c2da6a436360ce648061c90bdfcba863)

Co-authored-by: Skip Montanaro <skip.montanaro@gmail.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

[3.12] gh-89159: Add some TarFile attribute types  (GH-114520) (GH-114714)

(cherry picked from commit d7d0d13cd37651990586d31d8974c59bd25e1045)

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

[3.12] gh-101100: Fix Sphinx warnings in `whatsnew/2.2.rst` (GH-112366) (#114711)

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

[3.12] gh-114685: Fix incorrect use of PyBUF_READ in import.c (GH-114686) (GH-114700)

(cherry picked from commit 1ac1b2f9536a581f1656f0ac9330a7382420cda1)

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

[3.12] gh-101100: Fix sphinx warnings in `Doc/c-api/memoryview.rst` (GH-114669) (GH-114704)

(cherry picked from commit 97fb2480e4807a34b8197243ad57566ed7769e24)

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

[3.12] gh-110893: Improve the documentation for __future__ module (GH-114642) (#114702)

gh-110893: Improve the documentation for __future__ module (GH-114642)

nedbat took issue with the phrasing "real module". I'm actually fine
with that phrasing, but I do think the `__future__` page should be clear
about the way in which the `__future__` module is special. (Yes, there
was a footnote linking to the future statements part of the reference,
but there should be upfront discussion).

I'm sympathetic to nedbat's claim that no one really cares about
`__future__._Feature`, so I've moved the interesting table up to the
top.
(cherry picked from commit 3b86891fd69093b60141300862f278614ba80613)

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

[3.12] gh-100734: Add 'Notable change in 3.11.x' to `whatsnew/3.11.rst` (GH-114657) (#114688)

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

[3.12] Correct Skip Montanaro's email address (GH-114677) (#114679)

Correct Skip Montanaro's email address (GH-114677)
(cherry picked from commit 5ecfd750b4f511f270c38f0d748da9cffa279295)

Co-authored-by: Skip Montanaro <skip.montanaro@gmail.com>

[3.12] gh-114100: Remove superfluous writing to fd 1 in test_pty (GH-114647) (GH-114655)

(cherry picked from commit 7a470541e2bbc6f3e87a6d813e2ec42cf726de7a)

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

[3.12] gh-101100: Fix sphinx warnings in `reference/import.rst` (GH-114646) (#114652)

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

[3.12] gh-101100: Fix Sphinx warnings in `whatsnew/3.11.rst` and related (GH-114531) (#114649)

[3.12] gh-113560: Improve docstrings for set.issubset() and set.issuperset() (GH-113562) (GH-114644)

(cherry picked from commit 11c582235d86b6020710eff282eeb381a7bf7bb7)

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

[3.12] gh-101100: Fix sphinx warnings in `library/email.mime.rst` (GH-114635) (GH-114640)

(cherry picked from commit 6a8944acb61d0a2c210ab8066cdcec8602110e2f)

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

[3.12] gh-113445: Amend PyObject_RichCompareBool() docs (GH-113891) (GH-114638)

(cherry picked from commit 926881dc10ebf77069e02e66eea3e0d3ba500fe5)

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

[3.12] Docs: rework the dbm.dumb introduction (GH-114550) (#114620)

(cherry picked from commit 6c2b419fb91c8d7daa769d39f73768114b5eb45a)

- consistently use correct parameter markup
- consistently use submodule name as database name
- improve accuracy of the dbm.dumb.open() spec
- remove dumbdbm class refs and replace them with generic "database object"
- use parameter list for dbm.dumb.open()
(cherry picked from commit 6c2b419fb91c8d7daa769d39f73768114b5eb45a)

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

Use Unicode unconditionally for _winapi.CreateFile (GH-114611)

Currently it switches based on build settings, but argument clinic does not handle it correctly.

[3.12] Document PyOS_strtoul and PyOS_strtol (GH-114048) (GH-114618)

(cherry picked from commit 3f62bf32caf04cedb2c59579a0ce835d1e793d4d)

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

[3.12] gh-77749: Fix inconsistent behavior of non-ASCII handling in EmailPolicy.fold() (GH-6986) (GH-114606)

It now always encodes non-ASCII characters in headers if utf8 is false.

(cherry picked from commit 504334c7be5a56237df2598d338cd494a42fca4c)

Co-authored-by: Rito Takeuchi <licht-t@outlook.jp>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

[3.12] Docs: mark up dbm.open() with param list (GH-114601) (#114604)

Also consolidate following paragraphs regarding database objects.

(cherry picked from commit 0bd8297a2208125f76807cdf01f72abe5c94136b)

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

[3.12] Docs: reword dbm.ndbm introduction (#114549) (#114599)

(cherry picked from commit 4cf068ed0879cccf86a45f06fb274b350b89e911)

- add abbreviation directives for NDBM and GDBM
- consistently spell NDBM as NDBM
- silence broken ndbm class refs
- improve accuracy of dbm.ndbm.open() spec
- use replacement text for NDBM/GDBM file format incompatibility note

[3.12] Docs: fix versionchanged directives for dbm.open() and dbm.whichdb() (GH-114594) (#114595)

(cherry picked from commit 8710faeac28e65c65862359413e8341492f529af)

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

[3.12] Docs: rework dbm introduction (GH-114551) (#114590)

- add refs to other parts of the docs (dict, bytes, etc.)
- clarify whichdb() return value by using list markup
- silence refs to example or generic submodule methods (keys, get, etc.)

(cherry picked from commit 65cf5dce11a38e327b9b0abfca279d650452b34f)

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

[3.12] Docs: reword dbm.gnu introduction (#114548) (#114588)

(cherry picked from commit 06c5de36f222b926bbc94831536096b974bd5e77)

Also...
- consistently spell GDBM as GDBM
- silence gdbm class refs
- improve accuracy of dbm.gdbm.open() spec

gh-114561: Mark some tests in `test_wincosoleio` with `requires_resource('console')` decorator  (GH-114565)

(cherry picked from commit 33ae9895d4ac0d88447e529038bc4725ddd8c291)

Co-authored-by: Kirill Podoprigora <kirill.bast9@mail.ru>

[3.12] gh-77465: Increase test coverage for the numbers module (GH-111738) (GH-114556)

(cherry picked from commit e721adf4bd47b20ba0a93ad6471084de31bf20c7)

Co-authored-by: AN Long <aisk@users.noreply.github.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

gh-100107: Make py.exe launcher ignore app aliases that launch Microsoft Store (GH-114358)

(cherry picked from commit d5c21c12c17b6e4db2378755af8e3699516da187)

Co-authored-by: Vincent Cunningham <flagrama@users.noreply.github.com>

[3.12] gh-108731: Add description of __slots__ to MemberDescriptorType docs (GH-108745) (GH-114536)

(cherry picked from commit 6888cccac0776d965cc38a7240e1bdbacb952b91)

Co-authored-by: plokmijnuhby <39633434+plokmijnuhby@users.noreply.github.com>

[3.12] Docs: mark up the FTP_TLS() docs with param list (GH-114510) (#114532)

Also turn sentence about prot_p() into a note.

(cherry picked from commit 6fadd68da5dd928847264b17f62a5b8b369c1c1e)

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

[3.12] gh-104360: remove reference to removed module-level wrap_socket (GH-104361) (GH-114528)

* remove reference to removed module-level wrap_socket
* drive by typo fix
(cherry picked from commit 127a49785247ac8af158b18e38b722e520054d71)

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

[3.12] gh-101100: Fix Sphinx warnings in `c-api/structures.rst` (GH-113564) (#114527)

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

[3.12] gh-101100: Fix sphinx warnings in `concurrent.futures.rst` (GH-114521) (#114525)

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

[3.12] gh-114440: Close writer pipe in multiprocessing.Queue, not concurrent.futures (GH-114489)

This was left out of the 3.12 backport for three related issues:
- gh-107219 (which adds `self.call_queue._writer.close()` to `_ExecutorManagerThread` in `concurrent.futures`)
- gh-109370 (which changes this to be only called on Windows)
- gh-109047 (which moves the call to `multiprocessing.Queue`'s `_terminate_broken`)

Without this change, ProcessPoolExecutor sometimes hangs on Windows
when a worker process is terminated.

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

[3.12] gh-113205: test_multiprocessing.test_terminate: Give tasks a chance to start (GH-114249) (GH-114516)

(cherry picked from commit ce75b4c26d18dcd840fd2e7ee362a84209648d06)

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

[3.12] gh-101100: Fix sphinx warnings in `asyncio-task.rst` (GH-114469) (#114519)

Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>