Merge branch 'main' into pep736-final

Author: joshuabambrick

peps/pep-0352.rst

@@ -1,11 +1,8 @@
 PEP: 352
 Title: Required Superclass for Exceptions
-Version: $Revision$
-Last-Modified: $Date$
 Author: Brett Cannon, Guido van Rossum
 Status: Final
 Type: Standards Track
-Content-Type: text/x-rst
 Created: 27-Oct-2005
 Python-Version: 2.5
 Post-History:
@@ -276,24 +273,13 @@ References
 .. [#hierarchy-good] python-dev Summary for 2004-08-01 through 2004-08-15
    http://www.python.org/dev/summary/2004-08-01_2004-08-15.html#an-exception-is-an-exception-unless-it-doesn-t-inherit-from-exception
 
-.. [#SF_1104669] SF patch #1104669 (new-style exceptions)
-   https://bugs.python.org/issue1104669
-
 .. [#pycon2007-sprint-email]  python-3000 email ("How far to go with cleaning up exceptions")
     https://mail.python.org/pipermail/python-3000/2007-March/005911.html
 
+* Issue for new-style exceptions:
+  `python/cpython#41459 <https://github.com/python/cpython/issues/41459>`__
 
 Copyright
 =========
 
 This document has been placed in the public domain.
-
-
-
-..
-   Local Variables:
-   mode: indented-text
-   indent-tabs-mode: nil
-   sentence-end-double-space: t
-   fill-column: 70
-   End:

peps/pep-0740.rst

@@ -6,14 +6,17 @@ Author: William Woodruff <william@yossarian.net>,
 Sponsor: Donald Stufft <donald@stufft.io>
 PEP-Delegate: Donald Stufft <donald@stufft.io>
 Discussions-To: https://discuss.python.org/t/pep-740-index-support-for-digital-attestations/44498
-Status: Provisional
+Status: Final
 Type: Standards Track
 Topic: Packaging
 Created: 08-Jan-2024
 Post-History: `02-Jan-2024 <https://discuss.python.org/t/pre-pep-exposing-trusted-publisher-provenance-on-pypi/42337>`__,
               `29-Jan-2024 <https://discuss.python.org/t/pep-740-index-support-for-digital-attestations/44498>`__
-Resolution: https://discuss.python.org/t/pep-740-index-support-for-digital-attestations/44498/26
+Resolution: `17-Jul-2024 <https://discuss.python.org/t/pep-740-index-support-for-digital-attestations/44498/26>`__
 
+.. canonical-pypa-spec:: :ref:`packaging:index-hosted-attestations`
+
+.. canonical-doc:: `PyPI - Digital Attestations <https://docs.pypi.org/attestations/>`__
 
 Abstract
 ========

peps/pep-0757.rst

@@ -79,7 +79,7 @@ functions.
       - ``1`` for most significant digit first
       - ``-1`` for least significant digit first
 
-   .. c:member:: int8_t endianness
+   .. c:member:: int8_t digit_endianness
 
       Digit endianness:
 
@@ -177,19 +177,20 @@ create a Python :class:`int` object from a digits array.
 
    Create a :c:type:`PyLongWriter`.
 
-   On success, set *\*digits* and return a writer.
+   On success, allocate *\*digits* and return a writer.
    On error, set an exception and return ``NULL``.
 
    *negative* is ``1`` if the number is negative, or ``0`` otherwise.
 
-   *ndigits* is the number of digits in the *digits* array. It must be
-   greater than or equal to 0.
+   *ndigits* is the number of digits in the *digits* array.  It must be
+   greater than 0.
 
-   The caller can either initialize the array of digits *digits* and then call
-   :c:func:`PyLongWriter_Finish` to get a Python :class:`int`, or call
+   The caller can either initialize the array of digits *digits* and then
+   either call :c:func:`PyLongWriter_Finish` to get a Python :class:`int` or
    :c:func:`PyLongWriter_Discard` to destroy the writer instance.  Digits must
-   be in the range [``0``; ``(1 << sys.int_info.bits_per_digit) - 1``].  Unused
-   digits must be set to ``0``.
+   be in the range [``0``; ``(1 << bits_per_digit) - 1``]  (where the
+   :c:struct:`~PyLongLayout.bits_per_digit` is the number of bits per digit).
+   The unused most-significant digits must be set to ``0``.
 
 
 On CPython 3.14, the :c:func:`PyLongWriter_Create` implementation is a thin
@@ -206,11 +207,15 @@ wrapper to the private :c:func:`!_PyLong_New()` function.
    The function takes care of normalizing the digits and converts the
    object to a compact integer if needed.
 
+   The writer instance is invalid after the call.
+
 
 .. c:function:: void PyLongWriter_Discard(PyLongWriter *writer)
 
    Discard a :c:type:`PyLongWriter` created by :c:func:`PyLongWriter_Create`.
 
+   The writer instance is invalid after the call.
+
 
 Optimize import for small integers
 ==================================
@@ -252,7 +257,7 @@ Code::
     int int_digits_order = layout->digits_order;
     size_t int_bits_per_digit = layout->bits_per_digit;
     size_t int_nails = int_digit_size*8 - int_bits_per_digit;
-    int int_endianness = layout->endianness;
+    int int_endianness = layout->digit_endianness;
 
 
 Export: :c:func:`PyLong_Export()` with gmpy2