Merge branch 'main' into fix-dict-get-docs

99cd7dc921cb8ea5e35218286d5bc4270e79e790
commit 99cd7dc921cb8ea5e35218286d5bc4270e79e790
diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
@@ -4578,6 +4578,22 @@ can be used interchangeably to index the same dictionary entry.
       to implement ``self[key]`` for dict subclasses when key is not in the
       dictionary. See ``d[key]`` above.
 
+   .. describe:: d | other
+
+      Create a new dictionary with the merged keys and values of *d* and
+      *other*, which must both be dictionaries. The values of *other* take
+      priority when *d* and *other* share keys.
+
+      .. versionadded:: 3.9
+
+   .. describe:: d |= other
+
+      Update the dictionary *d* with keys and values from *other*, which may be
+      either a :term:`mapping` or an :term:`iterable` of key/value pairs. The
+      values of *other* take priority when *d* and *other* share keys.
+
+      .. versionadded:: 3.9
+
    Dictionaries compare equal if and only if they have the same ``(key,
    value)`` pairs (regardless of ordering). Order comparisons ('<', '<=', '>=', '>') raise
    :exc:`TypeError`.