New GitHub issue #119391 from eendebakpt:<br>

<hr>

<pre>
# Documentation

The docstring for `PyMapping_Keys`

> /* On success, return a list or tuple of the keys in mapping object 'o'.

 does not reflect the documentation (see https://docs.python.org/3/c-api/mapping.html#c.PyMapping_Keys) or the implementation (see [abstract.c#L2519](https://github.com/python/cpython/blob/858b9e85fcdd495947c9e892ce6e3734652c48f2/Objects/abstract.c#L2519)) as `PyMapping_Keys` can only return a list. Similar for the other methods.

The docstrings show up in IDEs (such as Visual Studio Code) and can cause confusion. I encountered this when working on the making the json module compatible with free-threading



</pre>

<hr>

<a href="https://github.com/python/cpython/issues/119391">View on GitHub</a>
<p>Labels: docs</p>
<p>Assignee: </p>