From 8b29d74fb79d2c4dcd9559b2b1d2d60026eac2ab Mon Sep 17 00:00:00 2001
From: Victor Stinner <vstinner@python.org>
Date: Wed, 29 Jan 2025 11:51:12 +0100
Subject: [PATCH] gh-101944: Clarify PyModule_AddObjectRef() documentation

---
 Doc/c-api/module.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/Doc/c-api/module.rst b/Doc/c-api/module.rst
index f82a050ab75de0..f71089370152ce 100644
--- a/Doc/c-api/module.rst
+++ b/Doc/c-api/module.rst
@@ -523,9 +523,6 @@ state:
 
    On success, return ``0``. On error, raise an exception and return ``-1``.
 
-   Return ``-1`` if *value* is ``NULL``. It must be called with an exception
-   raised in this case.
-
    Example usage::
 
        static int
@@ -540,6 +537,10 @@ state:
            return res;
         }
 
+   To be convenient, the function accepts ``NULL`` *value* with an exception
+   set. In this case, return ``-1`` and just leave the raised exception
+   unchanged.
+
    The example can also be written without checking explicitly if *obj* is
    ``NULL``::