From: Sergey B Kirpichev <skirpichev@gmail.com>
Date: Tue, 11 Nov 2025 13:52:37 +0000 (+0300)
Subject: [3.14] gh-141004: document Py_INFINITY and Py_NAN macros (GH-141145) (#141399)
X-Git-Tag: v3.14.1~152
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=8b9494099ace29df8619391d7449ca4b18917ce8;p=thirdparty%2FPython%2Fcpython.git

[3.14] gh-141004: document Py_INFINITY and Py_NAN macros (GH-141145) (#141399)

(cherry picked from commit d69447445cbacf7537bf59c5c683a3b17060312d)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
---

diff --git a/Doc/c-api/float.rst b/Doc/c-api/float.rst
index edee498a0b80..21e254aa6fb6 100644
--- a/Doc/c-api/float.rst
+++ b/Doc/c-api/float.rst
@@ -78,6 +78,34 @@ Floating-Point Objects
    Return the minimum normalized positive float *DBL_MIN* as C :c:expr:`double`.
 
 
+.. c:macro:: Py_INFINITY
+
+   This macro expands a to constant expression of type :c:expr:`double`, that
+   represents the positive infinity.
+
+   On most platforms, this is equivalent to the :c:macro:`!INFINITY` macro from
+   the C11 standard ``<math.h>`` header.
+
+
+.. c:macro:: Py_NAN
+
+   This macro expands a to constant expression of type :c:expr:`double`, that
+   represents a quiet not-a-number (qNaN) value.
+
+   On most platforms, this is equivalent to the :c:macro:`!NAN` macro from
+   the C11 standard ``<math.h>`` header.
+
+
+.. c:macro:: Py_MATH_El
+
+   High precision (long double) definition of :data:`~math.e` constant.
+
+
+.. c:macro:: Py_MATH_PIl
+
+   High precision (long double) definition of :data:`~math.pi` constant.
+
+
 .. c:macro:: Py_RETURN_NAN
 
    Return :data:`math.nan` from a function.