https://github.com/python/cpython/commit/797087c386dfaeaafe7fdd741194f10100f3ac13
commit: 797087c386dfaeaafe7fdd741194f10100f3ac13
branch: main
author: sobolevn <[email protected]>
committer: sobolevn <[email protected]>
date: 2026-11-14T08:42:42+03:00
summary:

gh-160669: Clarify `PyDict_Update` docs (#161314)

Co-authored-by: Petr Viktorin <[email protected]>
Co-authored-by: Victor Stinner <[email protected]>

files:
M Doc/c-api/dict.rst

diff --git a/Doc/c-api/dict.rst b/Doc/c-api/dict.rst
index 6db8dfca8a80db..e986c8b6456b74 100644
--- a/Doc/c-api/dict.rst
+++ b/Doc/c-api/dict.rst
@@ -472,11 +472,14 @@ Dictionary objects
 
 .. c:function:: int PyDict_Update(PyObject *a, PyObject *b)
 
-   This is the same as ``PyDict_Merge(a, b, 1)`` in C, and is similar to
-   ``a.update(b)`` in Python except that :c:func:`PyDict_Update` doesn't fall
-   back to the iterating over a sequence of key value pairs if the second
-   argument has no "keys" attribute.  Return ``0`` on success or ``-1`` if an
-   exception was raised.
+   This is the same as ``PyDict_Merge(a, b, 1)`` in C.
+
+   Similar to ``a.update(b)`` in Python, except that this function
+   does not fall back to the iterating over a sequence of key-value pairs
+   if *b* is not a mapping.
+   Use :c:func:`PyDict_MergeFromSeq2` for this case.
+
+   Return ``0`` on success or ``-1`` if an exception was raised.
 
    .. note::
 

_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]

Reply via email to