PyModule_SetDocString documentation doesn't describe the return value or success or failure conditions

[ngoldbaum]

Documentation

See https://docs.python.org/3.15/c-api/module.html#c.PyModule_SetDocString. It should say it returns -1 on failure and 0 on success. Failure can happen if creating a Python string from the C string docstring fails or if setting the __doc__ attribute on the module object fails.

Linked PRs

• gh-144257: document return values of PyModule_SetDocString #144258
• [3.14] gh-144257: document return values of PyModule_SetDocString (GH-144258) #144263
• [3.13] gh-144257: document return values of PyModule_SetDocString (GH-144258) #144286