[3.12] gh-116938: Fix `dict.update` docstring and remove erraneous full stop from...

gh-116938: Fix `dict.update` docstring and remove erraneous full stop from `dict` documentation (GH-125421)
(cherry picked from commit 5527c4051c0b58218ce69044f92b45f1d66ed43f)

Co-authored-by: Prometheus3375 <35541026+Prometheus3375@users.noreply.github.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>

diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index 0c1f29d8b69d971345866c19e6911087c2fbc82f..cc67a378d5906f457cae1f679b153b68318e7e8d 100644 (file)
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -4626,7 +4626,7 @@ can be used interchangeably to index the same dictionary entry.
 
       :meth:`update` accepts either another object with a ``keys()`` method (in
       which case :meth:`~object.__getitem__` is called with every key returned from
-      the method). or an iterable of key/value pairs (as tuples or other iterables
+      the method) or an iterable of key/value pairs (as tuples or other iterables
       of length two). If keyword arguments are specified, the dictionary is then
       updated with those key/value pairs: ``d.update(red=1, blue=2)``.
 

diff --git a/Objects/dictobject.c b/Objects/dictobject.c
index 0712bedc838eee34f2ab882d15c088bb9b1f2e73..4e965314945aca4735b8b20f4184ddc51d9a39e6 100644 (file)
--- a/Objects/dictobject.c
+++ b/Objects/dictobject.c
@@ -3634,8 +3634,8 @@ PyDoc_STRVAR(sizeof__doc__,
 "D.__sizeof__() -> size of D in memory, in bytes");
 
 PyDoc_STRVAR(update__doc__,
-"D.update([E, ]**F) -> None.  Update D from dict/iterable E and F.\n\
-If E is present and has a .keys() method, then does:  for k in E: D[k] = E[k]\n\
+"D.update([E, ]**F) -> None.  Update D from mapping/iterable E and F.\n\
+If E is present and has a .keys() method, then does:  for k in E.keys(): D[k] = E[k]\n\
 If E is present and lacks a .keys() method, then does:  for k, v in E: D[k] = v\n\
 In either case, this is followed by: for k in F:  D[k] = F[k]");