Take advantage of math.comb() in the nth_combination() recipe (#93027)

Fix a directive in the `pathlib` docs (GH-93030)

gh-72073: Add Windows case in pathlib.rename (GH-93002)

#72073

https://docs.python.org/3.12/library/pathlib.html#pathlib.Path.rename

gh-92611: Clarify planned removal version in PEP 594-deprecated modules (GH-92793)

As discussed in #92611 and #92564 and as a followup to PR #92612 , this 3.11+ only PR uses the proper `deprecated-removed` role for the modules deprecated by PEP 593 (PEP-594) to clearly indicate to users that a removal version is planned and what it is, so they can prepare accordingly or voice any unanticipated impacts.

Related to #92792 ; if we decide to backport that PR, the upgrade to using `deprecated-removed` on those functions can be moved to this one.

shutil._copyfileobj_readinto: tiny speedup (#92377)

gh-91860: documentation for typing.dataclass_transform (#92768)

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

gh-91922: Fix sqlite connection on nonstardard locales and paths (GH-92926)

Doc: add missing manpage and title references in tkinter docs (#29008)

- add bind(3tk) manpage markup
- add Tcl/Tk book reference markup

Doc: Minor adjustment of `socket.create_server` docs (#26938)

- fix spelling in create_server() docs
- add a line about create_server() in the socket.py docstring

Update globals-to-fix.tsv to follow recent changes (gh-92959)

gh-92817: Fix precedence of options to py.exe launcher (GH-92988)

gh-92984: Explicitly disable incremental linking for Windows Release and PGO builds (GH-92985)

gh-92913: Clarify changes to PyInitConfig.module_search_paths[_set] fields (GH-92980)

GH-89914: Make the oparg of the YIELD_VALUE instruction equal the stack depth. (GH-92960)

gh-92417: `importlib` docs: remove references to unsupported Python versions (GH-92424)

Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>

bpo-28249: fix `lineno` location for empty `DocTest` instances (GH-30498)

Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>

gh-78630: Drop invalid HP aCC compiler switch -fPIC on HP-UX (#8847)

At compile time, '+z' is already properly used with HP aCC, and shared
libraries are correctly linked with '+b'. The '-fPIC' switch can safely be
dropped.

bpo-46879: Fix incorrect sphinx object names in doc (GH-31615)

API members documented in sphinx have an object name, which allow the
documentation to be linked from other projects. Sphinx calculates the
object name by prefixing the current module name to the directive
argument, e.g:

.. module:: foo
.. function:: bar.baz

becomes foo.bar.baz. Since these anchors aren't displayed in the
documentation, some mistakes have crept in, namely the Python stdlib
documentation currently contains the objects:

* asyncio.asyncio.subprocess.DEVNULL
* asyncio.asyncio.subprocess.PIPE
* asyncio.asyncio.subprocess.STDOUT
* asyncio.asyncio.subprocess.Process
* multiprocessing.sharedctypes.multiprocessing.Manager
* xml.etree.ElementTree.xml.etree.ElementInclude

This commit fixes this by making use of the :module: option which
without an argument makes sphinx take the directive argument as is
for the object name (avoiding the prefixing of the current module
name that led to these broken object names).

Co-authored-by: Łukasz Langa <lukasz@langa.pl>

gh-92417: `subprocess` docs: remove note on compatibility with Python <3.5 (GH-92538)

gh-92417: `fractions`, `decimal`: Improve docs for alternative constructor methods (GH-92421)

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>

gh-92417: `socket` docs: remove references to Python <3.3 (GH-92544)

bpo-45393: help() on operator precedence has misleading entries (GH-31246)

Fix the formatting for "await x" and "not x" in the operator
precedence table.

gh-92417: Update docs and examples of doctest.IGNORE_EXCEPTION_DETAIL for Py>=3 (GH-92502)

gh-92675: venv: Fix ensure_directories() to again accept a Path for env_dir (#92676)

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

gh-91491: Complete Whats New in 3.11 for typing (#92708)

Fixes #91491

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

GH-92955: fix memory leak in code object lines and positions iterators (gh-92956)

gh-90473: Decrease recursion limit and skip tests on WASI (GH-92803)

GH-90690: Remove `PRECALL` instruction (GH-92925)

Doc: amend ssl.PROTOCOL_SSLv2 and ssl.PROTOCOL_SSLv3 wording (#92634)

gh-92670: Skip test_shutil.TestCopy.test_copyfile_nonexistent_dir on AIX (#92718)

Include ``asyncio.Barrier`` in 3.11 Whats New (GH-92927)

gh-92914: Round the allocated size for lists up to the even number (GH-92915)

gh-87901: Remove the encoding argument from os.popen (GH-92836)

gh-92812: Align ArgumentParser.add_subparsers() docs with argument spec (#92814)

Split refcount stats into 'interpreter' and 'non-interpreter' (GH-92919)

Remove Windows release build script (GH-92908)

The scripts have been migrated to the release-tools repository

bpo-42047: Add native thread ID for DragonFlyBSD (#22714)

Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: kj <28750310+Fidget-Spinner@users.noreply.github.com>
Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
Co-authored-by: Victor Stinner <vstinner@python.org>

gh-91755: Remove doc of C API private refcount functions (#92918)

These functions should only be used by Python internals.

gh-92780: Improve sqlite3.Connection.create_collation docs (#92790)

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

gh-91755: Document Py_IncRef and Py_DecRef as C functions (#91805)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>

bpo-40838: document `getdoc`, `getmodule`, `getsourcefile` in `inspect` returns `None` (#30575)

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

gh-92841: Fix asyncio's RuntimeError: Event loop is closed (GH-92842)

bpo-38704: Prevent installation on unsupported Windows versions (GH-17950)

gh-89898: Fix test_threading.test_args_argument() (#92885)

Join the thread to not leak threads running in the background to the
next test.

Fix the following warning on the "AMD64 FreeBSD Shared 3.11"
buildbot:

test_args_argument (test.test_threading.ThreadTests.test_args_argument) ...
Warning -- threading_cleanup() failed to cleanup 1 threads (count: 1, dangling: 2)
Warning -- Dangling thread: <_MainThread(MainThread, started 35026161664)>
Warning -- Dangling thread: <Thread(Thread-134 (<lambda>), started 35314998016)>
ok

gh-89653: Add assertions on PyUnicode_READ() index (#92883)

Add assertions on the index argument of PyUnicode_READ(),
PyUnicode_READ_CHAR() and PyUnicode_WRITE() functions.

gh-89653: PEP 670: Fix PyUnicode_READ() cast (#92872)

_Py_CAST() cannot be used with a constant type: use _Py_STATIC_CAST()
instead.

Fix NULL check in test_type_from_ephemeral_spec in_testcapimodule.c (GH-92863)

gh-92536: Update unicode struct size to ensure MemoryError is raised (GH-92867)

gh-92782: unify the style of CFG traversal algorithms in the compiler (GH-92784)

Summarize stats: Increase number of predecessor/successor pairs shown from 3 to 5. (GH-92853)

Fix NULL test in _testinternalcapi (GH-92861)

re docs: fix source code link (#92819)

gh-92265: set meta_path and path_hooks correctly in test_reload_namespace_changed (GH-92275)

Previously, we were blocking the frozen imports and forcing the source
version to be used, but we did not fix up sys.meta_path or
sys.path_hooks, causing the frozen importers to leak into the source
version of the test.

gh-92547: Remove deprecated sqlite3 features (#92548)

The following sqlite3 features were deprecated in 3.10, scheduled for
removal in 3.12:

- sqlite3.OptimizedUnicode (gh-23163)
- sqlite3.enable_shared_cache (gh-24008)

Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Signed-off-by: Erlend E. Aasland <erlend.aasland@protonmail.com>

gh-90473: Skip tests that don't apply to Emscripten and WASI (GH-92846)

Improve object stats (#92845)

* Add incref/decref stats

* Show ratios for allocation in summary

gh-92671: Don't omit parentheses when unparsing empty tuples (GH-92673)

gh-92820: Skip test_cppext if _ctypes is missing (#92844)

Add @test.support.requires_venv_with_pip decorator.

Speedup: build docs in parallel (GH-92733)

gh-81548: Clarify the deprecation of octal sequences affect byte strings (GH-92643)

Automerge-Triggered-By: GH:pablogsal

gh-90473: WASI: Mark tests that require os.pipe() (GH-92837)

gh-87670: Add web.archive redirects from effbot (GH-92816)

gh-92530: Fix an issue that occurred after interrupting threading.Condition.notify (GH-92534)

If Condition.notify() was interrupted just after it released the waiter lock,
but before removing it from the queue, the following calls of notify() failed
with RuntimeError: cannot release un-acquired lock.

Restore default role check in `make check`. (#92290)

* Restore default role check in `make check`.

* Options first, then files.

* Update `make.bat` too.

* Add a comment explaining the extra options.

* No reason to ignore the README.rst.

* Enable default-role check in sphinx-lint.

Co-authored-by: Julien Palard <julien@palard.fr>
* Update sphinx-lint default-role check.

* Fix use of the default role in the docs.

* Update make.bat to check for the default role too.

* Fix comment in make.bat.

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

gh-89668: Optimize ZipFile file header processing algorithm to avoid unneeded IO(gh-25966)

gh-92781: Avoid mixing declarations and code in C API (#92783)

Avoid mixing declarations and code in the C API to fix the compiler
warning: "ISO C90 forbids mixed declarations and code"
[-Werror=declaration-after-statement].

gh-90473: Fail subprocess early on Emscripten/WASI (GH-92802)

GH-92804: Fix memory leak in memoryview iterator (gh-92805)

gh-90861: Memory optimization for set.issubset (gh-92799)

gh-92611: Link to PEP 594 sections & add key detail in doc deprecation notices (GH-92612)

Fix numbers.Real.__rdivmod__ doc string (#31991)

gh-91249: Remove .bat extension in documentation for when activating venv on Windows. (GH-92770)

bpo-9182: Add a section on specifying positional arguments (#31810)

Fix small typo (#92721)

gh-92446: Argparse choices should be a sequence (#92450)

Document Py_ssize_t. (GH-92512)

It fixes 252 errors from a Sphinx nitpicky run (sphinx-build -n). But
there's 8182 errors left.

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>

gh-85858: Remove PyUnicode_InternImmortal() function (#92579)

Remove the PyUnicode_InternImmortal() function and the
SSTATE_INTERNED_IMMORTAL macro.

The PyUnicode_InternImmortal() function is still exported in the
stable ABI. The function is removed from the API.

PyASCIIObject.state.interned size is now a single bit, rather than 2
bits.

Keep SSTATE_NOT_INTERNED and SSTATE_INTERNED_MORTAL macros for
backward compatibility, but no longer use them internally since the
interned member is now a single bit and so can only have two values
(interned or not interned).

Update stats of _PyUnicode_ClearInterned().

gh-89653: Use int type for Unicode kind (#92704)

Use the same type that PyUnicode_FromKindAndData() kind parameter
type (public C API): int.

GH-92236: Remove spurious "line" event when starting coroutine or generator. (GH-92722)

gh-89653: PEP 670: Convert PyUnicode_KIND() macro to function (#92705)

In the limited C API version 3.12, PyUnicode_KIND() is now
implemented as a static inline function. Keep the macro for the
regular C API and for the limited C API version 3.11 and older to
prevent introducing new compiler warnings.

Update _decimal.c and stringlib/eq.h for PyUnicode_KIND().

gh-90473: Increase stack size, disable obmalloc on WASI (GH-92732)

gh-92536: Doc update about Py_UNICODE removal (GH-92756)

gh-92584: test_cppext uses setuptools (#92639)

Rewrite test_cppext to run in a virtual environment and to build the
C++ extension with setuptools rather than distutils.

gh-92311: Add tests for frame_setlineno jumping over listcomps (#92741)

Check result of utc_to_seconds and skip fold probe in pure Python (#91582)

The `utc_to_seconds` call can fail, here's a minimal reproducer on
Linux:

TZ=UTC python -c "from datetime import *; datetime.fromtimestamp(253402300799 + 1)"

The old behavior still raised an error in a similar way, but only
because subsequent calculations happened to fail as well. Better to fail
fast.

This also refactors the tests to split out the `fromtimestamp` and
`utcfromtimestamp` tests, and to get us closer to the actual desired
limits of the functions. As part of this, we also changed the way we
detect platforms where the same limits don't necessarily apply (e.g.
Windows).

As part of refactoring the tests to hit this condition explicitly (even
though the user-facing behvior doesn't change in any way we plan to
guarantee), I noticed that there was a difference in the places that
`datetime.utcfromtimestamp` fails in the C and pure Python versions, which
was fixed by skipping the "probe for fold" logic for UTC specifically —
since UTC doesn't have any folds or gaps, we were never going to find a
fold value anyway. This should prevent some failures in the pure python
`utcfromtimestamp` method on timestamps close to 0001-01-01.

There are two separate news entries for this because one is a
potentially user-facing change, the other is an internal code
correctness change that, if anything, changes some error messages. The
two happen to be coupled because of the test refactoring, but they are
probably best thought of as independent changes.

Fixes GH-91581

Add notes for maintaining ABCs (#92736)

gh-91578: improved error message when trying to instantiate an abstract class with missing methods (gh-47246)

gh-92514: Remove unused test.support.BasicTestRunner (#92515)

gh-92436: __future__ docs: add note on expectations for "from __future__ import annotations" (#92568)

Update outdated `LOAD_METHOD` comments in `Python/ceval.c` (GH-92641)

gh-92536: PEP 623: Remove wstr and legacy APIs from Unicode (GH-92537)

gh-86388 Remove deprecated behaviors in randrange() (#92677)

Fix typo in argparse docs. (GH-92691)

# Fix typo in argparse docs.

> Sometimes, when dealing with **a** particularly long argument list**s**, [...]

Mixture between plural and singular forms is incorrect. Use singular consistently since typically only a single argument list is employed. Change to:

> Sometimes, when dealing with a particularly long argument list, [...]

No issue was opened, since this is a trivial change.

Automerge-Triggered-By: GH:rhettinger

gh-89653: PEP 670: Fix Sphinx syntax in Unicode doc (#92707)

gh-89653: PEP 670: unicodeobject.h uses _Py_CAST() (#92696)

Use _Py_CAST() and _Py_STATIC_CAST() in macros wrapping static inline
functions of unicodeobject.h.

Change also the kind type from unsigned int to int: same parameter
type than PyUnicode_FromKindAndData().

The limited API version 3.11 no longer casts arguments to expected
types.

gh-89653: PEP 670: Update C API unicode documentation (#92702)

gh-89653: PEP 670: Convert PyDict_GET_SIZE() macro to function (#92695)

The limited C API version 3.12 no longer casts the argument.

Fix minor documentation error in bisect docs (GH-92697)

gh-92031, test_embed: Improve test for unquickening static code (#92440)

gh-89653: PEP 670: Use PyObject* type for parameters (#92694)

Use the PyObject* type for parameters of static inline functions:

* Py_SIZE(): same parameter type than PyObject_Size()
* PyList_GET_SIZE(), PyList_SET_ITEM(): same parameter type than
  PyList_Size() and PyList_SetItem()
* PyTuple_GET_SIZE(), PyTuple_SET_ITEM(): same parameter type than
  PyTuple_Size() and PyTuple_SetItem().