From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Wed, 12 Nov 2025 09:57:08 +0000 (+0100)
Subject: [3.13] gh-141370: document undefined behavior of Py_ABS() (GH-141439) (GH-141455)
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=c317cf51f18e8265c12cf3bfcf7080710037e0ae;p=thirdparty%2FPython%2Fcpython.git

[3.13] gh-141370: document undefined behavior of Py_ABS() (GH-141439) (GH-141455)

(cherry picked from commit 20f53df07d42c495a08c73a3d54b8dd9098a62f0)

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

diff --git a/Doc/c-api/intro.rst b/Doc/c-api/intro.rst
index 22ad080828bc..bb790de11c35 100644
--- a/Doc/c-api/intro.rst
+++ b/Doc/c-api/intro.rst
@@ -133,6 +133,10 @@ complete listing.
 
    Return the absolute value of ``x``.
 
+   If the result cannot be represented (for example, if ``x`` has
+   :c:macro:`!INT_MIN` value for :c:expr:`int` type), the behavior is
+   undefined.
+
    .. versionadded:: 3.3
 
 .. c:macro:: Py_ALWAYS_INLINE