[issue39574] str.__doc__ is misleading

Steven D'Aprano added the comment: Sorry everyone, due to technology problems I am unable to comment on the github page, and due to ISP problems I've been off the internet for a few days. > pull_request: https://github.com/python/cpython/pull/18401 [Serhiy] > Is not "or both" redundant? I

[issue39574] str.__doc__ is misleading

Change by Terry J. Reedy : -- versions: -Python 3.5, Python 3.6 ___ Python tracker ___ ___ Python-bugs-list mailing list

[issue39574] str.__doc__ is misleading

Eric V. Smith added the comment: I agree that the current changes are an improvement, and should be committed. -- ___ Python tracker ___

[issue39574] str.__doc__ is misleading

Steven D'Aprano added the comment: On Fri, Feb 07, 2020 at 12:33:45PM +, Serhiy Storchaka wrote: > > Serhiy Storchaka added the comment: > > See a discussion on Python-Dev: > https://mail.python.org/archives/list/python-...@python.org/message/YMIGWRUERUG66CKRJXDXNPCIDHRQJY6V/ I don't

[issue39574] str.__doc__ is misleading

Serhiy Storchaka added the comment: See a discussion on Python-Dev: https://mail.python.org/archives/list/python-...@python.org/message/YMIGWRUERUG66CKRJXDXNPCIDHRQJY6V/ -- nosy: +serhiy.storchaka ___ Python tracker

[issue39574] str.__doc__ is misleading

Eric V. Smith added the comment: I've created a PR and requested review from stevendaprano. I think the backports are correct. -- ___ Python tracker ___

[issue39574] str.__doc__ is misleading

Change by Eric V. Smith : -- keywords: +patch pull_requests: +1 stage: -> patch review pull_request: https://github.com/python/cpython/pull/18401 ___ Python tracker ___

[issue39574] str.__doc__ is misleading

Steven D'Aprano added the comment: Eric: sure, I'm happy with your modification. Alas, I'm currently having technology issues which prevents me from doing a PR. Would you care to do the honours? -- ___ Python tracker

[issue39574] str.__doc__ is misleading

Eric V. Smith added the comment: That's a good improvement, Steven. I like your wording about errors better than the wording about encoding, so how about changing the next to last sentence to: "If errors is specified, encoding defaults to sys.getdefaultencoding()." -- nosy:

[issue39574] str.__doc__ is misleading

Steven D'Aprano added the comment: The docs are correct, you are just misinterpreting them. Which could, I guess, suggest the docs could do with improvement. With *one* argument, `str(obj)` returns a string via `object.__str__(obj)` or `repr(obj)`, whichever is defined. That includes the

[issue39574] str.__doc__ is misleading

New submission from Zachary Westrick : The docstring for the str() builtin reads str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str Create a new string object from the given object. If encoding or errors is specified, then the object must expose a data buffer that will be

[issue39574] str.__doc__ is misleading

Change by Zachary Westrick : -- assignee: docs@python components: Documentation nosy: docs@python, kcirtsew priority: normal severity: normal status: open title: str.__doc__ is misleading type: enhancement versions: Python 3.5 ___ Python tracker