bpo-37194: Add PyObject_CallNoArgs() rationale (GH-14159)
Explain in the doc why PyObject_CallNoArgs() should be preferred over
other existing ways to call a function without any arguments.
diff --git a/Doc/c-api/object.rst b/Doc/c-api/object.rst
index e4787ad..13f13b3 100644
--- a/Doc/c-api/object.rst
+++ b/Doc/c-api/object.rst
@@ -255,7 +255,8 @@
.. c:function:: PyObject* PyObject_CallNoArgs(PyObject *callable)
- Call a callable Python object *callable* without any arguments.
+ Call a callable Python object *callable* without any arguments. It is the
+ most efficient way to call a callable Python object without any argument.
Return the result of the call on success, or raise an exception and return
*NULL* on failure.
diff --git a/Doc/whatsnew/3.9.rst b/Doc/whatsnew/3.9.rst
index c5cb626..3da8b16 100644
--- a/Doc/whatsnew/3.9.rst
+++ b/Doc/whatsnew/3.9.rst
@@ -103,7 +103,10 @@
=======================
* Add a new public :c:func:`PyObject_CallNoArgs` function to the C API:
- call a callable Python object without any arguments.
+ call a callable Python object without any arguments. It is the most efficient
+ way to call a callable Python object without any argument.
+ (Contributed by Victor Stinner in :issue:`37194`.)
+
Deprecated