> On 10 Feb 2021, at 01:28, Petr Viktorin <encu...@gmail.com> wrote: > > On 2/9/21 9:15 PM, Serhiy Storchaka wrote: >> 09.02.21 12:22, Erlend Aasland пише: >>> What's the recommended approach with issues like >>> https://bugs.python.org/issue43094? Change the docs or the implementation? >>> I did a quick search on bpo, but could not find similar past issues. >> If the documentation and the C implemented function contradict about >> parameter name, we are free to treat the parameter as positional-only. >> User cannot pass the argument as keyword because the documented name >> does not work, and the real name is not exposed to the user. > > It is. Python will correct you if you try to use the documented name:
Correct. However, I suspect that most users use positional arguments with these functions (since this is the first (?) report of the inconsistency) so I guess it's ok, in this case, to make the arguments positional only and normalise the argument naming. Erlend _______________________________________________ Python-Dev mailing list -- python-dev@python.org To unsubscribe send an email to python-dev-le...@python.org https://mail.python.org/mailman3/lists/python-dev.python.org/ Message archived at https://mail.python.org/archives/list/python-dev@python.org/message/4U3IYJE5ZAXJQWHPXCQZC2K4OYDZWVFE/ Code of Conduct: http://python.org/psf/codeofconduct/
