[3.13] gh-111999: Fix the signature of str.format_map() (GH-119540) (#119543)

miss-islington · serhiy-storchaka · web-flow · commit f49749cf8f61 · 2024-05-25T13:46:41.000Z
(cherry picked from commit 08e6543) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
@@ -1768,7 +1768,7 @@ expression support in the :mod:`re` module).
       cases.
 
 
-.. method:: str.format_map(mapping)
+.. method:: str.format_map(mapping, /)
 
    Similar to ``str.format(**mapping)``, except that ``mapping`` is
    used directly and not copied to a :class:`dict`.  This is useful
diff --git a/Misc/NEWS.d/next/Core and Builtins/2024-05-25-13-51-48.gh-issue-111999.L0q1gh.rst b/Misc/NEWS.d/next/Core and Builtins/2024-05-25-13-51-48.gh-issue-111999.L0q1gh.rst
@@ -0,0 +1 @@
+Fix the signature of :meth:`str.format_map`.
diff --git a/Objects/unicodeobject.c b/Objects/unicodeobject.c
@@ -13411,7 +13411,7 @@ Return a formatted version of the string, using substitutions from args and kwar
 The substitutions are identified by braces ('{' and '}').");
 
 PyDoc_STRVAR(format_map__doc__,
-             "format_map($self, /, mapping)\n\
+             "format_map($self, mapping, /)\n\
 --\n\
 \n\
 Return a formatted version of the string, using substitutions from mapping.\n\

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	+Fix the signature of :meth:`str.format_map`.