Merge remote-tracking branch 'upstream/main' into release-toml

AA-Turner · AA-Turner · commit 9dc331190606 · 2025-08-08T22:48:23.000+01:00
# Conflicts: # peps/pep-0790.rst
diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
@@ -431,7 +431,7 @@ peps/pep-0557.rst  @ericvsmith
 peps/pep-0558.rst  @ncoghlan
 peps/pep-0559.rst  @warsaw
 peps/pep-0560.rst  @ilevkivskyi
-# peps/pep-0561.rst
+peps/pep-0561.rst  @emmatyping
 peps/pep-0562.rst  @ilevkivskyi
 peps/pep-0563.rst  @ambv
 peps/pep-0564.rst  @vstinner
@@ -636,7 +636,7 @@ peps/pep-0755.rst  @warsaw
 peps/pep-0756.rst  @vstinner
 peps/pep-0757.rst  @vstinner
 peps/pep-0758.rst  @pablogsal @brettcannon
-peps/pep-0759.rst  @warsaw
+peps/pep-0759.rst  @warsaw @emmatyping
 peps/pep-0760.rst  @pablogsal @brettcannon
 peps/pep-0761.rst  @sethmlarson @hugovk
 peps/pep-0762.rst  @pablogsal @ambv @lysnikolaou @emilyemorehouse
@@ -654,15 +654,15 @@ peps/pep-0773.rst  @zooba
 peps/pep-0774.rst  @savannahostrowski
 peps/pep-0775.rst  @encukou
 peps/pep-0776.rst  @hoodmane @ambv
-peps/pep-0777.rst  @warsaw
-peps/pep-0778.rst  @warsaw
+peps/pep-0777.rst  @warsaw @emmatyping
+peps/pep-0778.rst  @warsaw @emmatyping
 # ...
 peps/pep-0779.rst  @Yhg1s @colesbury @mpage
 peps/pep-0780.rst  @lysnikolaou
 peps/pep-0781.rst  @methane
 peps/pep-0782.rst  @vstinner
 peps/pep-0783.rst  @hoodmane @ambv
-peps/pep-0784.rst  @gpshead
+peps/pep-0784.rst  @gpshead @emmatyping
 peps/pep-0785.rst  @gpshead
 # ...
 peps/pep-0787.rst  @ncoghlan
@@ -677,6 +677,7 @@ peps/pep-0798.rst  @JelleZijlstra
 peps/pep-0799.rst  @pablogsal
 peps/pep-0800.rst  @JelleZijlstra
 peps/pep-0801.rst  @warsaw
+peps/pep-0802.rst  @AA-Turner
 # ...
 peps/pep-2026.rst  @hugovk
 # ...
diff --git a/README.rst b/README.rst
@@ -49,7 +49,7 @@ You can find it in the merge box at the bottom of the PR page:
 Render PEPs locally
 -------------------
 
-See the `build documentation <./docs/build.rst>`__ for full
+See the `build documentation <./peps/docs/build.rst>`__ for full
 instructions on how to render PEPs locally.
 In summary, run the following in a fresh, activated virtual environment:
 
diff --git a/peps/contents.rst b/peps/contents.rst
@@ -15,6 +15,7 @@ This is an internal Sphinx page; please go to the :doc:`PEP Index <pep-0000>`.
    :caption: PEP Table of Contents (needed for Sphinx):
 
    api/*
+   docs/*
    topic/*
    numerical
    pep-*
diff --git a/peps/docs/build.rst b/peps/docs/build.rst
diff --git a/peps/docs/index.rst b/peps/docs/index.rst
@@ -0,0 +1,14 @@
+..
+   We can't use :pep:`N` references in this document, as they use links relative
+   to the current file, which doesn't work in a subdirectory like this one.
+
+PEPs Internal Documentation
+===========================
+
+This is documentation for the internals of the PEPs website and PEP rendering
+system. To read the PEPs, see the :doc:`PEP Index <../pep-0000>`.
+
+------------------------------------------------------------------------------
+
+* :doc:`Building PEPs Locally <./build>`
+* :doc:`An Overview of the PEP Rendering System <./rendering_system>`
diff --git a/peps/docs/rendering_system.rst b/peps/docs/rendering_system.rst
@@ -35,7 +35,7 @@ The configuration:
 ----------------
 
 ``build.py`` manages the rendering process.
-Usage is covered in `Building PEPs Locally <./build.rst>`_.
+Usage is covered in :doc:`Building PEPs Locally <./build>`.
 
 
 3. Extension
diff --git a/peps/pep-0676.rst b/peps/pep-0676.rst
@@ -1,6 +1,6 @@
 PEP: 676
 Title: PEP Infrastructure Process
-Author: Adam Turner <python@quite.org.uk>
+Author: Adam Turner <adam@python.org>
 Sponsor: Mariatta <mariatta@python.org>
 PEP-Delegate: Barry Warsaw <barry@python.org>
 Discussions-To: https://discuss.python.org/t/10774
diff --git a/peps/pep-0694.rst b/peps/pep-0694.rst
@@ -1,6 +1,7 @@
 PEP: 694
 Title: Upload 2.0 API for Python Package Indexes
 Author: Barry Warsaw <barry@python.org>, Donald Stufft <donald@stufft.io>, Ee Durbin <ee@python.org>
+PEP-Delegate: Dustin Ingram <di@python.org>
 Discussions-To: https://discuss.python.org/t/pep-694-upload-2-0-api-for-python-package-repositories/16879
 Status: Draft
 Type: Standards Track
diff --git a/peps/pep-0723.rst b/peps/pep-0723.rst
@@ -1,7 +1,7 @@
 PEP: 723
 Title: Inline script metadata
 Author: Ofek Lev <ofekmeister@gmail.com>
-Sponsor: Adam Turner <python@quite.org.uk>
+Sponsor: Adam Turner <adam@python.org>
 PEP-Delegate: Brett Cannon <brett@python.org>
 Discussions-To: https://discuss.python.org/t/31151
 Status: Final
diff --git a/peps/pep-0726.rst b/peps/pep-0726.rst
@@ -1,7 +1,7 @@
 PEP: 726
 Title: Module ``__setattr__`` and ``__delattr__``
 Author: Sergey B Kirpichev <skirpichev@gmail.com>
-Sponsor: Adam Turner <python@quite.org.uk>
+Sponsor: Adam Turner <adam@python.org>
 Discussions-To: https://discuss.python.org/t/32640/
 Status: Rejected
 Type: Standards Track
diff --git a/peps/pep-0791.rst b/peps/pep-0791.rst
@@ -39,6 +39,12 @@ return values are integers." would be accurate.  In a similar way we
 can simplify the description of the accepted arguments for functions in both the
 new module and in :external+py3.14:mod:`math`.
 
+Now it's a lot harder to satisfy people's expectations about the module
+content.  For example, should they expect that ``math.factorial(100)`` will
+return an exact answer?  Many languages, Python packages (like :pypi:`scipy`)
+or pocket calculators have functions with same or similar name, that return a
+floating-point value, which is only an approximation in this example.
+
 Apparently, the :external+py3.14:mod:`math` module can't serve as a catch-all place
 for mathematical functions since we also have the :external+py3.14:mod:`cmath` and
 :external+py3.14:mod:`statistics` modules.  Let's do the same for integer-related
@@ -56,16 +62,26 @@ And this situation tends to get worse.  When the module split `was first
 proposed
 <https://mail.python.org/archives/list/python-ideas@python.org/thread/YYJ5YJBJNCVXQWK5K3WSVNMPUSV56LOR/>`_,
 there were only two integer-related functions:
-:external+py3.14:func:`~math.factorial` and :external+py3.14:func:`~math.gcd`.
-Now there are six and :external+py3.14:func:`~math.factorial` doesn't accept
+:external+py3.14:func:`~math.factorial` (accepting also :class:`float`'s, like other
+functions in the module) and :external+py3.14:func:`~math.gcd` (moved from the
+::external+py3.14:mod:`fractions` module).  Then
+:external+py3.14:func:`~math.isqrt`, :external+py3.14:func:`~math.comb` and
+:external+py3.14:func:`~math.perm` were added, and addition of the new module
+was `proposed second time <https://github.com/python/cpython/issues/81313>`_,
+so all new functions would go directly to it, without littering the
+:external+py3.14:mod:`math` namespace.
+Now there are six functions and :external+py3.14:func:`~math.factorial` doesn't accept
 :class:`float`'s anymore.
 
 Some possible additions, among those proposed in the initial discussion thread
 and issue
 `python/cpython#81313 <https://github.com/python/cpython/issues/81313>`_ are:
 
-* ``ceil_div()`` --- for integer ceiling divide, see
-  `relevant discussion thread <https://discuss.python.org/t/91269>`_.
+* ``c_div()`` and ``n_div()`` --- for integer division with rounding towards
+  positive infinity (ceiling divide) and to the nearest integer, see `relevant
+  discussion thread <https://discuss.python.org/t/91269>`_.  This is reinvented
+  several times in the stdlib, e.g. in the :mod:`datetime` and the
+  :mod:`fractions`.
 * ``gcdext()`` --- to solve linear `Diophantine equation <https://en.wikipedia.org/wiki/Diophantine_equation>`_ in two variables (the
   :external+py3.14:class:`int` implementation actually includes an extended
   Euclidean algorithm)
@@ -110,6 +126,7 @@ module, called ``intmath``:
 * :external+py3.14:func:`~math.perm`
 
 Their aliases in :external+py3.14:mod:`math` will be :term:`soft deprecated`.
+This PEP doesn't introduce backward-incompatible changes.
 
 Module functions will accept integers and objects that implement the
 :external+py3.14:meth:`~object.__index__` method, which is used to convert the
diff --git a/peps/pep-0802.rst b/peps/pep-0802.rst
