doc: Link to `string.capwords` from `str.title` (GH-20913)

Since `title()` mentions its own short-comings, it should also mention the library function which does not possess them.

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit b786d9ec52a2c2b0b6627be7fd4a3948c61fbdea)

Co-authored-by: Eric Wieser <wieser.eric@gmail.com>

pkgutil docs: Link sys constants, add backticks (GH-32356)

Co-authored-by: Éric <merwok@netwok.org>
(cherry picked from commit 63bd72448a5af01206c2a9aec5f1ed1e903f1e12)

Co-authored-by: Boris Verkhovskiy <boris.verk@gmail.com>

ssl docs: Fix typo (GH-32314)

(cherry picked from commit 1da9c38fd352465fd3d1a00e64dc90444b421730)

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

[3.9] bpo-46769: Fix backticks in typing.rst to appease rstlint (GH-32375)

* Use double backticks to appease rstlint

* Update susp-ignored.csv

Fix whitespace/indentation issues in test_sys (GH-32369) (GH-32373)

(cherry picked from commit da922409ac3e65c6bf2911401c7dfdf8ee6e0036)

stdtypes docs: fix typo (GH-32349)

(cherry picked from commit b33c4564aceeae8323bcb19167fbbd2d5f5002bc)

Co-authored-by: Ian <40774387+isteptoe@users.noreply.github.com>

bpo-47235: Note where a typo is intentional in code. (GH-32348)

People keep popping up reporting these as typos in the docs despite
being described as typos in the surrounding text.  Hopefully a comment
on the line itself makes it more obvious?

Arguably some of the typo examples are not using the "right" typo as the
"assret" one in particular is now detected by default due to how common
it was in actual code.  But I don't want to to typo chasing by changing
these examples to be other not yet auto-detected typos as they still
illustrate the point well enough.
(cherry picked from commit ac1fb07b6ecb6b93446484f52894914e5199de63)

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

bpo-47230: Silence compiler warnings on Windows from zlib 1.2.12 (GH-32337)

(cherry picked from commit 944f09adfcc59f54432ac2947cf95f3465d90e1e)

Co-authored-by: Jeremy Kloth <jeremy.kloth@gmail.com>

[3.9] bpo-45790: List macros in same order in which fields are described (GH-29529) (GH-32321)

Signed-off-by: Rodrigo Tobar <rtobar@icrar.org>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>.
(cherry picked from commit b275267aa7d44ec90fa435c9cb1610c549da745a)

Co-authored-by: rtobar <rtobar@icrar.org>

bpo-40982: shutil docs: Remove outdated copytree() example (GH-24778)

It is not preferable to keep a copy of the implementation in the
docs.
(cherry picked from commit e06f920c5bc6e9fad29082ba0d84043722806e17)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>

crypt docs: Fix references to `methods` attr (GH-26806)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit cae0f5d3dad6db0d13690e5952ae2015ad8b3a05)

Co-authored-by: andrei kulakov <andrei.avk@gmail.com>

bpo-32658: Regex docs: Fix metacharacter reference (GH-32230)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit 43571a3eea8b5931769376daf4bdad1c9184ae0d)

Co-authored-by: Mike cm <mikecmcleod@gmail.com>

bpo-47007: [doc] `str` special method lookup (GH-31863)

Clarify the `str()` docs to point out that `object.__str__()`
follows special method lookup.

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit bb86d1d9fbd1888524e04475383f4ea764277f67)

Co-authored-by: Vanshaj Singhania <8797467+itsvs@users.noreply.github.com>

bpo-41233: Add links to errnos referenced in exceptions docs (GH-21380)

Co-authored-by: Andrew Kuchling <amk@amk.ca>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit a74892cb2168d249d9a8c53fad605a5def9b41d4)

Co-authored-by: yyyyyyyan <24644216+yyyyyyyan@users.noreply.github.com>

bpo-46484:Add test for Calendar.iterweekdays (GH-30825)

(cherry picked from commit 48269ea9fdbc5804f80962364f95e69097c417ba)

Co-authored-by: 180909 <734461790@qq.com>

Demonstrate `py --list` in the quickstart section of the Windows doc page (GH-29383)

(cherry picked from commit 1ecfe3d5ae4ddec4e73a6cfc93fed6df43fe0be5)

Co-authored-by: Christian Clauss <cclauss@me.com>

Follow PEP-8 guidelines in tutorial for standard library (GH-26127)

(cherry picked from commit 6db2db91b96aaa1270c200ec931a2250fe2799c7)

Co-authored-by: Bob Kline <bkline@users.noreply.github.com>

bpo-47205: Skip error check of sched_get/setaffinity on FreeBSD (GH-32285)

(cherry picked from commit b82cdd1dac9a9be52051abd90a1ce69236ac41f4)

Co-authored-by: Christian Heimes <christian@python.org>

Language reference: Remove duplicated text about iterable unpacking (GH-25212)

(cherry picked from commit 4f5d56f8f33196f5ed8ffad0ab2f012afda2f9b3)

Co-authored-by: Jiashuo Li <4003950+jiasli@users.noreply.github.com>

bpo-24563: Link encoding names to encoding declarations (GH-32274)

(cherry picked from commit 01be5d6446abbdd95d0c18bd19a58a62b05568d8)

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

[3.9] More minor fixes to C API docs (GH-31525) (GH-32259)

* wording fixes in type.rst

* grammar and punctuation in sys.rst

* set: grammar fixes

* structures: capitalization fix

* grammar fixes for sequence

* objects: point to Py_TYPE instead of direct object access

* numbers: add more explicit Python equivalences

* method: add missing period

* memory: grammar fix

* mapping: grammar fixes

* long: grammar fix

* iter: fix grammar for PyAIter_Check

* init: grammar fix.
(cherry picked from commit 897bc6f9282238d5fb32d232ab62d30675244736)

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

[3.9] More minor fixes to C API docs (GH-31714) (GH-32260)

* init_config: wording fixes

* bytearray: remove XXX, there is a good link to the buffer docs

* bytes, call, exceptions: minor wording fixes.
(cherry picked from commit 677a87946630c5fbd9998969669b4dd4f4b32545)

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

[3.9] Document func parameter of locale.atof (GH-18183) (GH-32261)

The second parameter (named `func`) has been present since the `locale`
module was introduced in eef1d4e8b1, but has never been documented.

This commit updates the documentation for `locale.atof` to clarify the
behavior of the function and how the `func` parameter is used.

Signed-off-by: Kevin Locke <kevin@kevinlocke.name>.
(cherry picked from commit 208da6d508bb2683732151f4ae288dfc8001267c)

Co-authored-by: Kevin Locke <kevin@kevinlocke.name>

bpo-45584: Clarify `math.trunc` documentation (GH-29183)

While floor/ceil 's documentation are very precise, `truncate` was not explained. I actually had to search online to understand the difference between `truncate` and `floor` (admittedly, once I remembered that numbers are signed, and that floating numbers actually uses a bit for negation symbol instead of two complement, it became obvious)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: Éric Araujo <merwok@netwok.org>
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit ebbdbbff5d6840807e46ec61b8a323e94ee88de2)

Co-authored-by: Arthur Milchior <arthur@milchior.fr>

codecs docs: fix grammar mistake (GH-29462)

(cherry picked from commit ea56845744e815ed468dfbdd835110254c3be997)

Co-authored-by: 180909 <wjh180909@gmail.com>

bpo-45114: Use lstat() instead of stat() in stat docs example (GH-29845)

(cherry picked from commit c93a0ac6972221787d8bea1c41a9feb667ed3d2c)

Co-authored-by: 180909 <wjh180909@gmail.com>

bpo-47031: Improve documentation for `math.nan` (GH-32170)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit 182e93c3f57b0c72e765c9896066d32e461c0865)

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

bpo-47194: Update zlib to v1.2.12 on Windows to resolve CVE-2018-25032 (GH-32241)

(cherry picked from commit 6066739ff7794e54c98c08b953a699cbc961cd28)

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

[3.9] bpo-47089: Avoid test_compileall failures on Windows (GH-32037). (GH-32240)

* [3.9] bpo-47089: Avoid test_compileall failures on Windows (GH-32037).
(cherry picked from commit 76b8a075b8a79b08468fd0ed06a489a5c815bc11)

Co-authored-by: Jeremy Kloth <jeremy.kloth@gmail.com>

bpo-14911: Corrected generator.throw() documentation (GH-32207)

Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com>
(cherry picked from commit 8be7c2bc5ad5e295f0f855bb31db412eef2c7c92)

Co-authored-by: Dave Goncalves <davegoncalves@gmail.com>

bpo-46775: OSError should call winerror_to_errno unconditionally on Windows (GH-32179)

(cherry picked from commit d0c67ea0645b7ad37b867c167882a346a24de641)

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

bpo-42340: Document issues around KeyboardInterrupt (GH-23255)

Update documentation to note that in some circumstances,
KeyboardInterrupt may cause code to enter an inconsistent state. Also
document sample workaround to avoid KeyboardInterrupt, if needed.
(cherry picked from commit d0906c90fcfbc4cfb9bb963eaa6bb152dd543b56)

Co-authored-by: benfogle <benfogle@gmail.com>

ctypes docs: Fix array-length reference to "non-negative" from "positive" (GH-32097) (GH-32143)

(cherry picked from commit 76f14b0463dc2c53911eaf95e85374e511ba9bcc)

Co-authored-by: Yonatan Goldschmidt <yon.goldschmidt@gmail.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>

Fix typo in the sqlite3 docs (GH-31915) (GH-32158)

Co-authored-by: Jonathan <89750679+AHypnotoad@users.noreply.github.com>
(cherry picked from commit 66584c890d016e40d707400130d1cd98f2aedde9)

Co-authored-by: Jonathan <jonathan.joyner94@gmail.com>

bpo-47138: Ensure Windows docs build uses the same pinned version as other platforms (GH-32161)

(cherry picked from commit 0dfabf9b4a58b835b61fc3d17784d4746f677e56)

Co-authored-by: Steve Dower <steve.dower@python.org>

bpo-27929: resolve names only for AF_INET/AF_INET6 with asyncio (GH-32131)

Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com>
(cherry picked from commit 5c30388f3c586ba2f33e349e22e5949cb92de621)

Co-authored-by: Vincent Bernat <vincent@bernat.ch>

[3.9] bpo-44493: Add missing terminated NUL in sockaddr_un's length (GH-26866) (GH-32140) (GH-32156)

Add missing terminated NUL in sockaddr_un's length

- Linux: https://man7.org/linux/man-pages/man7/unix.7.html
- *BSD: SUN_LEN
(cherry picked from commit f6b3a07b7df60dc04d0260169ffef6e9796a2124)

Co-authored-by: ty <zonyitoo@users.noreply.github.com>
Automerge-Triggered-By: GH:gpshead
(cherry picked from commit 5944807b09717d43bb017f700e8c451dd07199ed)

Co-authored-by: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>

bpo-28516: document contextlib.ExitStack.__enter__ behavior (GH-31636) (GH-32145)

The enter_context is updated with following information: 'The :meth:`__enter__` method
      returns the ExitStack instance, and performs no additional operations.'

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit 86384cf83f96fcaec03e2ad6516e2e24f20d3b92)

Co-authored-by: vidhya <96202776+Vidhyavinu@users.noreply.github.com>
Co-authored-by: Ned Deily <nad@python.org>

bpo-47138: Fix documentation build by pinning Jinja version to 3.0.3 (GH-32153)

Co-authored-by: Maciej Olko <maciej.olko@gmail.com>

bpo-47105: Cite grp.h instead of pwd.h in grp docs (GH-32091) (GH-32121)

(cherry picked from commit ee912ad6f66bb8cf5a8a2b4a7ecd2752bf070864)

Co-authored-by: Alex Hedges <aphedges@users.noreply.github.com>

Post 3.9.12

Python 3.9.12

bpo-47101: list only activated algorithms in hashlib.algorithms_available (GH-32076)

(cherry picked from commit 48e2010d92076b472922fa632fffc98ee150004f)

Co-authored-by: Christian Heimes <christian@python.org>

[3.9] bpo-47061: document module deprecations due to PEP 594 (GH-31984) (GH-32082)

Also removed asynchat, asyncore, and smtpd from their respective toctree entries so they are only  in the superceded subtree.
(cherry picked from commit 9ac2de922a0f783bd43b8e026e4fb70fd1888572)

Co-authored-by: Brett Cannon <brett@python.org>
Automerge-Triggered-By: GH:brettcannon

[3.9] bpo-46769: Improve documentation for `typing.TypeVar` (GH-31712) (GH-31941) (GH-32067)

* [3.9] [3.10] bpo-46769: Improve documentation for `typing.TypeVar` (GH-31712) (GH-31941)

* [3.10] bpo-46769: Improve documentation for `typing.TypeVar` (GH-31712)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit 81b425d4dc43b60dd11a3e9abc5c84a4b8b384db)

* Remove references to `reveal_type`, add new section on `self` types.
(cherry picked from commit d5ed8a8258eaf7a241978b1b0aeb971108d0f7e0)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* remove unused susp allowlist

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

[doc] configparser: avoid inline comments. (GH-31247)

People are testing those blocs with the default
inline_comment_prefixes of None, leading to a:

configparser.InterpolationSyntaxError: '$' must be followed by '$' or '{', found: '$ sign ($ is the only character that needs to be escaped)'
(cherry picked from commit 3ac4e783e077ffd7b51c6acc1591002974644051)

Co-authored-by: Julien Palard <julien@palard.fr>

Fix typo in Path.iterdir docs (GH-31822)

(cherry picked from commit 795b365e8a6dfbeaa75780ed7807f8116f4537ca)

Co-authored-by: Matt Williams <matt@milliams.com>

bpo-2604: Make doctest.DocTestCase reset globs in teardown (GH-31932)

Co-authored-by: Piet Delport
Co-authored-by: Hugo Lopes Tavares
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit 7ba7eae50803b11766421cb8aae1780058a57e2b)

Co-authored-by: Daniël van Noord <13665637+DanielNoord@users.noreply.github.com>

[3.9] bpo-47022: Document asynchat, asyncore and smtpd removals in 3.12 (GH-31891) (#31998)

Document the deprecation of asyncore, asynchat, and smtpd with a slated removal in Python 3.12 thanks to PEP 594..
(cherry picked from commit 77473846439b8a3eae66de1a1cfe931619f38513)

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

bpo-44336: Prevent tests hanging on child process handles on Windows (GH-26578)

Replace the child process `typeperf.exe` with a daemon thread that reads the performance counters directly.  This prevents the issues that arise from inherited handles in grandchild processes (see issue37531 for discussion).

We only use the load tracker when running tests in multiprocess mode. This prevents inadvertent interactions with tests expecting a single threaded environment.  Displaying load is really only helpful for buildbots running in multiprocess mode anyway..

Co-authored-by: Jeremy Kloth <jeremy.kloth@gmail.com>

[3.9] bpo-45997: Fix asyncio.Semaphore re-acquiring order (GH-31910) (GH-32049)

Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>.
(cherry picked from commit 32e77154ddfc514a3144d5912bffdd957246fd6c)

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

bpo-12029: [doc] clarify that except does not match virtual subclasses of the specified exception type (GH-32027) (GH-32035)

(cherry picked from commit 45833b50f0ccf2abb01304c900afee05b6d01b9e)

bpo-23691: Protect the re.finditer() iterator from re-entering (GH-32012)

(cherry picked from commit 08eb754d840696914928355014c2d424131f8835)

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

bpo-38256: Fix binascii.crc32 large input. (GH-32000) (GH-32013) (GH-32015)

Inputs >= 4GiB to `binascii.crc32(...)` when compiled to use the zlib
crc32 implementation (the norm on POSIX) no longer return the wrong
result.

(cherry picked from commit 4c989e19c84ec224655bbbde9422e16d4a838a80)

bpo-42369: Fix thread safety of zipfile._SharedFile.tell (GH-26974)

The `_SharedFile` tracks its own virtual position into the file as
`self._pos` and updates it after reading or seeking. `tell()` should
return this position instead of calling into the underlying file object,
since if multiple `_SharedFile` instances are being used concurrently on
the same file, another one may have moved the real file position.
Additionally, calling into the underlying `tell` may expose thread
safety issues in the underlying file object because it was called
without taking the lock.
(cherry picked from commit e730ae7effe4f13b24f1b5fb1fca005709c86acb)

Co-authored-by: Kevin Mehall <km@kevinmehall.net>

bpo-46013: Fix confusing kerning on period in docs (GH-29989) (GH-32006)

(cherry picked from commit 3af68fc77c528d4e7749046cf6e41fd79902e6e6)

Co-authored-by: jmcb <joel.mcbride1@live.com>
Co-authored-by: jmcb <joel.mcbride1@live.com>

[3.10] bpo-47040: improve document of checksum functions (GH-31955) (GH-32002)

Clarifies a versionchanged note on crc32 & adler32 docs that the workaround is only needed for Python 2 and earlier.
Also cleans up an unnecessary intermediate variable in the implementation.

Authored-By: Ma Lin / animalize
Co-authored-by: Gregory P. Smith <greg@krypto.org>
(cherry picked from commit 6d290d5862375799e997f1192ef56abca4e9182e)

Co-authored-by: Ma Lin <animalize@users.noreply.github.com>

[3.9] bpo-40296: Fix supporting generic aliases in pydoc (GH-30253). (GH-31976) (GH-31981)

(cherry picked from commit cd44afc573e2e2de8d7e5a9119c347373066cd10)
(cherry picked from commit a5b7678a67ac99edd50822827b772e7d9afc8e64)

bpo-39394: Improve warning message in the re module (GH-31988)

A warning about inline flags not at the start of the regular
expression now contains the position of the flag.
(cherry picked from commit 4142961b9f5ad3bf93976a6a7162f8049e354018)

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

bpo-44544: add textwrap placeholder arg (GH-27671)

(cherry picked from commit cb7874f49d3d55df73a3c529773af14e2e344fb7)

Co-authored-by: andrei kulakov <andrei.avk@gmail.com>

[3.9] bpo-14156: Make argparse.FileType work correctly for binary file modes when argument is '-' (GH-13165) (GH-31979)

Also made modes containing 'a' or 'x' act the same as a mode containing 'w' when argument is '-'
(so 'a'/'x' return sys.stdout like 'w', and 'ab'/'xb' return sys.stdout.buffer like 'wb').
(cherry picked from commit eafec26ae5327bb23b6dace2650b074c3327dfa0)

Co-authored-by: MojoVampire <shadowranger+github@gmail.com>

[3.9] bpo-46968: Check for 'sys/auxv.h' in the configure script (GH-31961). (GH-31975)

(cherry picked from commit 8e3fde728f547f1d32bde8adf62b4c50bb877b9d)

Co-authored-by: Pablo Galindo Salgado <Pablogsal@gmail.com>

[3.9] bpo-46421: Fix unittest filename evaluation when called as a module (GH-30654) (GH-31970)

(cherry picked from commit a0db11b10fca0fee6bb2b8d6277e266bad8c0fdb)

Co-authored-by: Bader Zaidan <bader@zaidan.pw>

[3.9] bpo-42782: fix broken shutil test (GH-31971)

We were using os_helper, which doesn't exist on 3.9. This wasn't
caught because the test is only run as root. I confirmed that when
run as root, the test previously failed and now passes.

bpo-45979: Fix Tkinter tests with old Tk (>= 8.5.12) (GH-31938)

(cherry picked from commit dbbe4d2d0075fa0e95b069fb4780d79aae3514c7)

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

bpo-47038: Increase a test timeout for slow CI machines (GH-31951)

(cherry picked from commit a7c54148322781cb0f332d440a3454d550ef6414)

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

bpo-47038: Rewrite missed asyncio.wait_for test to use IsolatedAnsyncioTestCase (GH-31946)

(cherry picked from commit 3dd9bfac04d3dcdbfd3f8011a6c9d4b9ac8c116a)

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

[3.9] bpo-47038: Rewrite asyncio.wait_for test to use IsolatedAsyncioTestCase (GH-31942). (GH-31944)

(cherry picked from commit dd0082c627713634c7fd88ad33d18b5cc9f4a7b8)

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

Post 3.9.11, take two

Python 3.9.11, take two

[3.10] bpo-45382: test.pythoninfo logs more Windows versions (GH-30891) (GH-30894)

Add the following info to test.pythoninfo:

* windows.ver: output of the shell "ver" command
* windows.version and windows.version_caption: output of the
  "wmic os get Caption,Version /value" command.

(cherry picked from commit b0898f4aa90d9397e23aef98a2d6b82445ee7455)

* bpo-45382: test.pythoninfo: set wmic.exe encoding to OEM (GH-30890)

(cherry picked from commit cef0a5458f254c2f8536b928dee25862ca90ffa6)
(cherry picked from commit 4a57fa296b92125e41220ecd201eb2e432b79fb0)

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

[3.9] bpo-47032: Ensure Windows install builds fail correctly with a non-zero exit code when part of the build fails (GH-31921) (GH-31927)

Automerge-Triggered-By: GH:zooba

bpo-46948: Fix launcher installer build failure due to first part of fix (GH-31920)

(cherry picked from commit 708812085355c92f32e547d1f1d1f29aefbbc27e)

Co-authored-by: Steve Dower <steve.dower@python.org>

Post 3.9.11

Python 3.9.11

[3.9] bpo-47024: Update OpenSSL to 1.1.1n (GH-31895) (#31917)

Co-authored-by: Zachary Ware <zachary.ware@gmail.com>.
Co-authored-by: Christian Heimes <christian@python.org>.
Co-authored-by: Christian Heimes <christian@python.org>

bpo-20392: Fix inconsistency with uppercase file extensions in mimetypes.guess_type (GH-30229)

(cherry picked from commit 5dd7ec52b83e7f239774cf7478106fcc7b0a36f3)

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

bpo-43253: Don't call shutdown() for invalid socket handles (GH-31892)

(cherry picked from commit 70155412f1543f100d4aa309b8691cbcabd3e0e1)

Co-authored-by: Maximilian Hils <git@maximilianhils.com>

But Add missing newline to NEWS entry (GH-31893)

(cherry picked from commit 16995ed0f2b697ca1ff966741288e787e1701ca9)

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

bpo-43721: Fix docstrings for property.getter/setter/deleter (GH-31046)

(cherry picked from commit e3d348a5252549708fd19338b675a2c23b60d677)

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

bpo-31415: importtime was made by Inada Naoki (GH-31875)

(cherry picked from commit 29624e769c5c3c1e59c6acc8b69383ead53e8a9f)

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

Revert "bpo-46986: Upgrade bundled setuptools to 60.9.3 (GH-31820)" (GH-31881)

This reverts commit bda64b3c0c4e45de4c82ba1b8722f56db5ac88ba
as it breaks test_bdb and test_distutils with installed Pythons.

[3.9] bpo-30677: [doc] mention that os.mkdir() can raise FileNotFoundError (GH-31548) (GH-31878)

(cherry picked from commit 879fbd9472753149b627f32add3ddca90ac47ab7)

Co-authored-by: slateny <46876382+slateny@users.noreply.github.com>
Automerge-Triggered-By: GH:iritkatriel

[3.9] bpo-43215: Document Happy Eyeballs args of asyncio.open_connection (GH-24525) (GH-31868)

Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com>.
(cherry picked from commit 3543ddb4c4ebc26fb2d6c67a97e66f5267876f72)

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

[3.9] bpo-47004: Sync with importlib_metadata 4.11.3. (GH-31854). (GH-31859)

(cherry picked from commit b1e286860742e7ba6fadc75e3ddb6c2899a56919)

Co-authored-by: Jason R. Coombs <jaraco@jaraco.com>

bpo-46986: Upgrade bundled setuptools to 60.9.3 (GH-31820) (GH-31855)

(cherry picked from commit c99ac3c364ee21be72263791b71ee8b55f64de08)

Co-authored-by: Pradyun Gedam <pgedam@bloomberg.net>

[3.9] bpo-46985: Upgrade bundled pip to 22.0.4 (GH-31819) (GH-31850)

(cherry picked from commit d87f1b787ed38dfd307d82452f2efe9dc5b93942)

Co-authored-by: Pradyun Gedam <pgedam@bloomberg.net>
Automerge-Triggered-By: GH:ned-deily

[3.9] bpo-46677: Add examples of inheritance and attributes to `TypedDict` docs. (GH-31349) (GH-31808)

* bpo-46677: Add examples of inheritance and attributes to `TypedDict` docs (GH-31349)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
(cherry picked from commit 8a207e0321db75f3342692905e342f1d5e1add54)

[3.9] sqlite3: normalise pre-acronym determiners (GH-31772) (GH-31807)

For consistency, replace "a SQL" with "an SQL"..
(cherry picked from commit 2d5835a019a46573d5b1b614c8ef88d6b564d8d4)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>

bpo-46968: Fix faulthandler for Sapphire Rapids Xeon (GH-31789) (GH-31831)

In Linux kernel 5.14 one can dynamically request size of altstacksize
based on hardware capabilities with getauxval(AT_MINSIGSTKSZ).

This changes allows for Python extension's request to Linux kernel
to use AMX_TILE instruction set on Sapphire Rapids Xeon processor
to succeed, unblocking use of the ISA in frameworks.

Introduced HAVE_LINUX_AUXVEC_H in configure.ac and pyconfig.h.in
Used cpython_autoconf:269 docker container to generate configure.

(cherry picked from commit 3b128c054885fe881c3b57a5978de3ea89c81a9c)

Co-authored-by: Oleksandr Pavlyk <oleksandr.pavlyk@intel.com>

bpo-31327: Update time documentation to reflect possible errors (GH-31460)

As per the comments, this mirrors the [datetime documentation](https://docs.python.org/3/library/datetime.htmlGH-datetime.datetime.fromtimestamp).

```
>>> import time
>>> time.localtime(999999999999999999999)
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
OverflowError: timestamp out of range for platform time_t
>>> time.localtime(-3600)
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
OSError: [Errno 22] Invalid argument
```
(cherry picked from commit c83fc9c02c9846ec3a2d0123999c98e02f00b3f5)

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

[3.9] bpo-46198: rename duplicate tests and remove unused code (GH-30297) (GH-31797)

(cherry picked from commit 6c83c8e6b56b57a8a794e7b6c07837be4ce3bb97)

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

[3.9] Docstring: replace pysqlite with sqlite3 (GH-31758) (GH-31778)

Replace two instances of "pysqlite" with "sqlite3" in sqlite3
docstrings. Also reword "is a no-op" to "does nothing" for clarity..
(cherry picked from commit b33a1ae703338e09dc0af5fbfd8ffa01d3ff75da)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@innova.no>

bpo-24959: fix unittest.assertRaises bug where traceback entries are dropped from chained exceptions (GH-23688) (GH-31776)

(cherry picked from commit 88b7d86a73da9388aa65c96401c2984c8c16f8db)

bpo-46955: Expose asyncio.base_events.Server as asyncio.Server (GH-31760)

This change aligns the documentation at https://docs.python.org/3/library/asyncio-eventloop.htmlGH-asyncio.Server
with the actual implementation

Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com>
(cherry picked from commit da80d6b2f3beff519cb1457d5e055168c89f7224)

Co-authored-by: Stefan Zabka <zabkaste@informatik.hu-berlin.de>

Removed confusing reference to sys (GH-31638)

(cherry picked from commit 28f84c72b6cee145f9c00e9b999656e9a2517e49)

Co-authored-by: David Gilbertson <gilbertson.david@gmail.com>

[3.9] bpo-46878: Purge 'non-standard' from sqlite3 docstrings (GH-31612) (GH-31754)

(cherry picked from commit 4d95fa1ac5d31ff450fb2f31b55ce1eb99d6efcb)

bpo-44439: _ZipWriteFile.write() handle buffer protocol correctly (GH-29468)

Co-authored-by: Marco Ribeiro <marcoffee@users.noreply.github.com>
(cherry picked from commit 36dd7396fcd26d8bf9919d536d05d7000becbe5b)

Co-authored-by: Ma Lin <animalize@users.noreply.github.com>

Removed ambiguity in __init_subclass__ docs (GH-31540)

(cherry picked from commit ab014978aef303ac60465c9010505d798dc34df8)

Co-authored-by: David Gilbertson <gilbertson.david@gmail.com>

docs: Don't use code formatting for emphasis (GH-30519)

(cherry picked from commit badb637c8ce91625122d5f4d71276bfe1a8ed5e9)

Co-authored-by: William Andrea <william.j.andrea@gmail.com>