https://github.com/python/cpython/commit/13242eea537403292d887e1188bc92b478e74503
commit: 13242eea537403292d887e1188bc92b478e74503
branch: 3.15
author: Miss Islington (bot) <[email protected]>
committer: sobolevn <[email protected]>
date: 2026-11-14T05:49:43Z
summary:

[3.15] gh-160669: Clarify `PyDict_Update` docs (GH-161314) (#161983)

gh-160669: Clarify `PyDict_Update` docs (GH-161314)
(cherry picked from commit 797087c386dfaeaafe7fdd741194f10100f3ac13)

Co-authored-by: sobolevn <[email protected]>
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 4ac4445e25886c..4d78924b07dd9c 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