Update documentation.

python · serhiy-storchaka · Jul 13, 2025 · Apr 17, 2025 · Apr 17, 2025 · Apr 23, 2025
commit f51a0528b0d425b54e8011d5380c8a3079acfcab
diff --git a/Doc/c-api/arg.rst b/Doc/c-api/arg.rst
@@ -244,8 +244,8 @@ is out of range for the C type.
 For unsigned integer formats, the
 most significant bits are silently truncated when the receiving field is too
 small to receive the value, and :exc:`DeprecationWarning` is emitted when
-the value is larger than the maximal value for the corresponding C type or less than the
-minimal value for the corresponding signed integer type.
+the value is larger than the maximal value for the C type or less than
+the minimal value for the corresponding signed integer type of the same size.
 
 ``b`` (:class:`int`) [unsigned char]
    Convert a nonnegative Python integer to an unsigned tiny integer, stored in a C
@@ -313,8 +313,8 @@ minimal value for the corresponding signed integer type.
 
    For unsigned integer formats ``B``, ``H``, ``I``, ``k`` and ``K``,
    :exc:`DeprecationWarning` is emitted when the value is larger than
-   the maximal value for the corresponding C type or less than the minimal value for
-   the corresponding signed integer type.
+   the maximal value for the C type or less than the minimal value for
+   the corresponding signed integer type of the same size.
 
 
 Other objects

diff --git a/Doc/whatsnew/3.15.rst b/Doc/whatsnew/3.15.rst
@@ -216,10 +216,9 @@ Deprecated C APIs
 -----------------
 
 * For unsigned integer formats in :c:func:`PyArg_ParseTuple`,
-  accepting Python integers with value that is larger than
-  the maximal value the corresponding C type or less than
-  the minimal value for the corresponding signed integer type
-  is now deprecated.
+  accepting Python integers with value that is larger than the maximal value
+  for the C type or less than the minimal value for the corresponding
+  signed integer type of the same size is now deprecated.
   (Contributed by Serhiy Storchaka in :gh:`132629`.)
 
 .. Add C API deprecations above alphabetically, not here at the end.

diff --git a/Misc/NEWS.d/next/C_API/2025-04-17-12-37-27.gh-issue-132629.01ArwX.rst b/Misc/NEWS.d/next/C_API/2025-04-17-12-37-27.gh-issue-132629.01ArwX.rst
@@ -1,4 +1,4 @@
 For unsigned integer formats in :c:func:`PyArg_ParseTuple`, accepting Python
-integers with value that is larger than the maximal value for the corresponding
-C type or less than the minimal value for the corresponding signed integer
-type is now deprecated.
+integers with value that is larger than the maximal value for the C type or
+less than the minimal value for the corresponding signed integer type
+of the same size is now deprecated.