gh-141004: Deprecate Py_MATH_El and Py_MATH_PIl macros (#141035)

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

gh-141174: Improve `annotationlib._Stringifier` test coverage (#141220)

* Test `_Stringifier.__convert_to_ast()` for containers

* Test partial evaluation of `ForwardRef`s in `_Stringifier`

gh-141343: Fix swapped words in `sorted` doc (GH-141348)

gh-141174: Improve `annotationlib.call_annotate_function()` test coverage (#141176)

* Test passing unsupported Format values to call_annotate_function()

* Test call_evaluate_function with fake globals that raise errors

* Fix typo and comparison in test_fake_global_evaluation

gh-141174: Improve `ForwardRef` test coverage (#141175)

* Test unsupported format in ForwardRef.evaluate()

* Test dict cell closure with multiple variables

* Test all options in ForwardRef repr

* Test ForwardRef being a final class

gh-141341: Rename COMPILER macro to _Py_COMPILER on Windows (#141342)

gh-141174: Improve `annotationlib.get_annotations()` test coverage (#141286)

* Test `get_annotations(format=Format.VALUE)` for stringized annotations on custom objects

* Test `get_annotations(format=Format.VALUE)` for stringized annotations on wrapped partial functions

* Update test_stringized_annotations_with_star_unpack() to actually test stringized annotations

* Test __annotate__ returning a non-dict

* Test passing globals and locals to stringized `get_annotations()`

gh-137530: generate an __annotate__ function for dataclasses __init__ (GH-137711)

gh-136702: Clear codec caches for refleak tests; use test.support helpers (GH-141345)

This should fix refleak buildbots.

gh-139707: Specify `winreg`, `msvcrt` and `winsound` module availability in docs (GH-140429)

gh-140500: Update download.html instructions (#141320)

Co-authored-by: Joseph Anthony Pasquale Holsten <joseph@josephholsten.com>

gh-141004: Document `pyctype.h` macros (GH-141272)

gh-141004: Document `Py_DTSF_*` macros (GH-141310)

gh-62480: De-personalize "Partial mocking" section in `unittest.mock` examples (#141321)

* Refine some wording in unittest partial mock doc

Some of the descriptions were addressed in first person,
but have now been changed to address the user reading the documentation instead.

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>

gh-62480: De-personalize "Mocking Unbound Methods" section in `unittest.mock` examples (#141322)

* Rewrite Mocking Unbound Methods paragraph to second person

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

gh-141004: Document `PySuper_Type` (GH-141315)

gh-140980: document `SET_FUNCTION_ATTRIBUTE` flag for `annotate` function  (#141306)

gh-141004: Document `PyClassMethod*` and `PyStaticMethod*` APIs (GH-141296)

gh-141004: Document `PyFunction_SetKwDefaults` (GH-141294)

gh-141004: Document `PyExceptionInstance*` APIs (GH-141301)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>

gh-141004: Document `Py_func_type_input` (GH-141273)

gh-141004: document `curses` C API (#141254)

gh-141004: Document `PyWeakref_CheckRefExact` (GH-141279)

gh-141004: Document deprecated aliases for memory allocation (GH-141146)

gh-111389: replace deprecated occurrences of `_PyHASH_*` macros (#141236)

gh-100218: correctly set `errno` when `socket.if_{nametoindex,indextoname}` raise `OSError` (#140905)

Previously, socket.if_nametoindex() and socket.if_indextoname() could raise
an `OSError` with a `None` errno. Now, the errno from libc is propagated.

gh-140530: fix a reference leak in an error path for `raise exc from cause` (#140908)

Fix a reference leak in `raise E from T` when `T` is an exception
subtype for which `T.__new__` does not return an exception instance.

gh-136702: Deprecate passing non-ascii *encoding* (str) to `encodings.normalize_encoding` (#140030)

Closes #136702

gh-141127: Clarify o?s.symlink() documentation for argument order (#141144)

gh-141186: document `asyncio.Task` cancellation propagation behavior (#141249)

gh-141004: Document `Py_BUILD_ASSERT*` macros (GH-141266)

gh-141004: Document the `PyDoc_VAR` macro (GH-141263)

gh-141004: Document `PyBUF_WRITEABLE` (GH-141255)

gh-141004: Document `PyErr_ProgramTextObject` and `PyErr_ProgramText` (GH-141250)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>

gh-141246: Link to correct Windows docs in `time.sleep()` doc (#141248)

gh-141004: correctly document `Py_HASH_*` and `PyHASH_*` as `hash_info` attributes (#141233)

gh-139741: Make `dist-pdf` docs archive build work for macOS (#140837)

gh-140615: Update docstrings in the fcntl module (GH-140619)

* Refer to bytes objects or bytes-like objects instead of strings.
* Remove backticks -- they do not have effect on formatting.
* Re-wrap lines to ensure the pydoc output fits in 80 coluimns.
* Remove references to the 1024 bytes limit.

gh-140793: Improve documentatation and tests for the ensure_ascii option in the json module (GH-140906)

* Document that ensure_ascii=True forces escaping not only non-ASCII, but also
  non-printable characters (the only affected ASCII character is U+007F).
* Ensure that the help output for the json module does not exceed 80
  columns (except one long line in an example and generated lines).
* Add more tests.

gh-141004: fix `versionadded` typo for `Py_HASH_SIPHASH13` (#141223)

fix typos in contextvars asyncio support example docs (#141219)

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

gh-140849: Update bundled liblzma to 5.8.1 on Windows (#141022)

gh-141004: Document `PyTraceBack*` APIs (GH-141192)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>

gh-141004: Document `Py_HASH_*` macros (#141205)

gh-141004: Document `PyErr_WarnExplicitFormat` (GH-141187)

gh-141004: Document `PyCapsule_Type` (GH-141079)

Update NaNs handling description in `c-api/float.rst` (#141179)

Clarified the behavior of NaNs on IEEE platforms regarding signaling and quiet NaNs.

Clarify argument/result ownership/validity for PyModule_* functions (GH-141159)

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

gh-141141: Make base64.b85decode() thread safe (GH-141149)

gh-140734: fix off-by-one error when comparing to `_SUN_PATH_MAX` (#140903)

The limit includes a NULL terminator.

gh-141125: delete unused import textwrap in interpreter.py (#141126)

GH-136895: Fixes for pulling LLVM as a release artifact (#141002)

Minor documentation improvements (#140626)

Remove duplicated tests in test_base64 (gh-125346) (GH-141153)

gh-141004: Document `Py_GetRecursionLimit` and `Py_SetRecursionLimit` (GH-141151)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>

gh-140826: Update winreg's docstring (GH-141050)

gh-141150: Don't rely on implicit conversion from void * to pointer in _PyModule… (#141147)

Don't rely on implicit conversion from void * to pointer in _PyModule_GetToken

gh-134745: Use "pymutex" for sys.thread_info on Windows (#141140)

gh-141004: Document `PyLong_FromPid` and `PyLong_AsPid` (GH-141028)

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

gh-141004: Document `Py_hexdigits` (GH-141059)

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

gh-141004: Document built-in iterator types in the C API (GH-141006)

Adds documentation for each of the following:

- PyEnum_Type
- PyFilter_Type
- PyMap_Type
- PyReversed_Type
- PyZip_Type

In addition, PyRange_Type and PyRange_Check are also documented.

gh-139707: Add docs for optional modules (GH-140171)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Co-authored-by: Emma Smith <emma@emmatyping.dev>
Co-authored-by: Author: Terry Jan Reedy <tjreedy@udel.edu>
Co-authored-by: Victor Stinner <vstinner@python.org>

gh-137232: Update free-threading HOWTOs with up-to-date info for 3.14 (#140817)

gh-125346: Add more base64 tests (GH-141061)

Add more tests for the altchars argument of b64decode() and for the map01
argument of b32decode().

Minor fixes to `idle.rst` and regenerate `help.html` (#140037)

gh-129876: Move misplaced IDLE news item (#141118)

gh-140939: Fix memory leak in `_PyBytes_FormatEx` error path (#140957)

docs: fix a grammatical error in function.rst (#140990)

gh-140569: recommend the new REPL in the asyncio REPL docs (#140570)

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

gh-118516: clarify that subprocess are automatically killed if transport gets garbage collected (#140997)

GH-108009: Add clarification of parser and argument defaults in argparse docs (#124154)

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>

gh-141004: Document `PyDict_GET_SIZE` (GH-141078)

gh-76007: remove curses.__version__ doc (#141052)

gh-141004: Document `Py_RETURN_NAN` and `Py_RETURN_INF` (GH-141029)

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

gh-140916: Remove unused codes in winreg.c (#140934)

gh-133467: Fix typeobject `tp_base` race in free threading (gh-140549)

gh-83714: Fix stat_nanosecond_timestamp() for 32-bit time_t (#141069)

Fix compiler warnings in remote debugging (#141060)

Example of fixed warnings on 32-bit Windows:

    Python\remote_debugging.c(24,53): warning C4244: 'function':
    conversion from 'uint64_t' to 'uintptr_t', possible loss of data

    Modules\_remote_debugging_module.c(789,44): warning C4244:
    'function': conversion from 'uint64_t' to 'size_t', possible loss
    of data

gh-140650: Fix write(), flush() and close() methods of io.BufferedWriter (GH-140653)

They could raise SystemError or crash when getting the "closed" attribute
or converting it to boolean raises an exception.

gh-131527: Stackref debug borrow checker (#140599)

Add borrow checking to the stackref debug mode

---------

Co-authored-by: mpage <mpage@meta.com>

gh-139313: Improve docs on XML security (GH-139460)

Clarify that:
- it takes parsing for an attack
- that some doors are closed by default
- only Expat version 2.7.2 has all the fixes
- use of the bundle depends on configuration

Fix a compiler warning in _randommodule.c (#141058)

The test just before the cast ensures that the cast cannot overflow.

Fix the warning on 32-bit Windows:

    Modules\_randommodule.c(525,28): warning C4244: '=': conversion
    from 'uint64_t' to 'Py_ssize_t', possible loss of data

Remove internal _PyTime_AsLong() function (#141053)

* Replace _PyTime_AsLong() with PyLong_FromInt64()
* Replace _PyTime_FromLong() with PyLong_AsInt64().

gh-83714: Fix a compiler warning in stat_nanosecond_timestamp() (#141043)

Disable the fast path on systems with 32-bit long.

gh-140550: Run make regen-limited-abi (#141056)

gh-141004: Document `PyMemoryView_Type` (GH-141034)

gh-141004: Document missing iterator types in the C API (GH-141010)

Add documentation for each of the following:

- PyByteArrayIter_Type
- PyBytesIter_Type
- PyListIter_Type
- PyListRevIter_Type
- PySetIter_Type
- PyTupleIter_Type
- PyRangeIter_Type
- PyLongRangeIter_Type
- PyDictIterKey_Type
- PyDictRevIterKey_Type
- PyDictIterValue_Type
- PyDictRevIterValue_Type
- PyDictIterItem_Type
- PyDictRevIterItem_Type

---------

Co-authored-by: Petr Viktorin <encukou@gmail.com>

gh-140550: Initial implementation of PEP 793 – PyModExport (GH-140556)

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

gh-140691: urllib.request: Close FTP control socket if data socket can't connect (GH-140835)

Co-authored-by: codenamenam <bluetire27@gmail.com>

Fix typo in Apple/__main__.py (#141038)

Corrected a typo in a return value docstring.

Docs: Fix cached calls count in factorial example (gh-140882)

gh-141007: update string module source code link (#141008)

In 3.14, the former string.py became `__init__.py` within a new `string` directory that also contains a new submodule file, `templatelib.py`.

gh-140454: Normalize the JIT stencils filename on Linux to avoid mismatches between the Makefile and the generator (#140823)

gh-138189: Document type slots, and other constants, as part of Limited API (GH-138190)

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

gh-141004: Document `Py_UNICODE_{HIGH, LOW}_SURROGATE` functions (GH-141019)

gh-139434: Update selected RFC 2822 references to RFC 5322 (#139435)

Update selected RFC 2822 references to RFC 5322

RFC 2822 was obsoleted by RFC 5322 in 2008. This updates references
to use the current standard in documentation, docstrings, and comments.

It preserves RFC 2822 references in legacy API components to maintain their
historical context.

RFC 822 → RFC 2822 → RFC 5322 progression is explained where relevant.

In some places specific sections of RFC are referenced where it seems helpful.

Scout rule was applied in some places and RFC mentions format was
normalized in doc strings and comments.

Docs: Fix typo in `email.headerregistry.rst` (#140965)

Fix missing 'Header' suffix on header class name in `email.headerregistry.rst`

gh-134817: Restore accidentally deleted line in documentation. (GH-141013)

Document that returning `sys.monitoring.DISABLE` in response to a global event raises `ValueError` (#140726)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>

GH-139946: Colorize error and warning messages in argparse (#140695)

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