From: Petr Viktorin <encukou@gmail.com>
Date: Mon, 23 Jun 2025 10:35:59 +0000 (+0200)
Subject: gh-89488: Add warning about `Py_BuildValue("p")` needing exact `int` (GH-135610)
X-Git-Tag: v3.15.0a1~1212
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=6aa0826ed7688e5f40742cdcaf57420b284e194f;p=thirdparty%2FPython%2Fcpython.git

gh-89488: Add warning about `Py_BuildValue("p")` needing exact `int` (GH-135610)
---

diff --git a/Doc/c-api/arg.rst b/Doc/c-api/arg.rst
index 49dbc8d71cce..ab9f9c4539ae 100644
--- a/Doc/c-api/arg.rst
+++ b/Doc/c-api/arg.rst
@@ -686,6 +686,12 @@ Building values
    ``p`` (:class:`bool`) [int]
       Convert a C :c:expr:`int` to a Python :class:`bool` object.
 
+      Be aware that this format requires an ``int`` argument.
+      Unlike most other contexts in C, variadic arguments are not coerced to
+      a suitable type automatically.
+      You can convert another type (for example, a pointer or a float) to a
+      suitable ``int`` value using ``(x) ? 1 : 0`` or ``!!x``.
+
       .. versionadded:: 3.14
 
    ``c`` (:class:`bytes` of length 1) [char]