[Python-Dev] Re: Signature discrepancies between documentation and implementation

2021-02-09 Thread Victor Stinner
If there are applications relying on the parameter name, it's better to trust the Python implementation, rather than the documentation. It would be better to make these parameters positional only in the first place, but now it's too late for such backward incompatible change :-( Victor On Tue, F

[Python-Dev] Re: Signature discrepancies between documentation and implementation

2021-02-09 Thread Erlend Aasland
Hi Victor, and thanks for you reply. > On 9 Feb 2021, at 11:46, Victor Stinner wrote: > If there are applications relying on the parameter name, it's better > to trust the Python implementation, rather than the documentation. I feared that answer :) > It would be better to make these parameters

[Python-Dev] Re: Signature discrepancies between documentation and implementation

2021-02-09 Thread Jakub Stasiak
> On 9 Feb 2021, at 11:22, Erlend Aasland wrote: > > Hi all, > > 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. > > > > Erlend To provide

[Python-Dev] Re: Signature discrepancies between documentation and implementation

2021-02-09 Thread Serhiy Storchaka
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 contradi

[Python-Dev] Re: Signature discrepancies between documentation and implementation

2021-02-09 Thread Brett Cannon
On Tue., Feb. 9, 2021, 12:20 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. >

[Python-Dev] Re: Signature discrepancies between documentation and implementation

2021-02-09 Thread Petr Viktorin
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 documentatio

[Python-Dev] Re: Signature discrepancies between documentation and implementation

2021-02-10 Thread Erlend Aasland
Thanks, Jakub. E > On 9 Feb 2021, at 19:42, Jakub Stasiak wrote: > > To provide some context as you looked for issues on bpo: in the two I was > involved in[1][2] the resolution was to update the documenttion to reflect > the actual situation. > > Best, > Jakub > > [1] https://bugs.python.o

[Python-Dev] Re: Signature discrepancies between documentation and implementation

2021-02-10 Thread Erlend Aasland
> On 10 Feb 2021, at 01:28, Petr Viktorin 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 o