[issue24898] Documentation for str.find() is confusing

Senthil Kumaran added the comment: Updated the docs as per Georg's suggestion. Thank you Ted Lemon for bringing this up. -- assignee: docs@python -> orsenthil nosy: +orsenthil resolution: -> fixed stage: needs patch -> resolved status: open -> closed versions: +Python 3.4

[issue24898] Documentation for str.find() is confusing

Roundup Robot added the comment: New changeset da934a19855b by Senthil Kumaran in branch '2.7': Backport documentation improvement. https://hg.python.org/cpython/rev/da934a19855b -- ___ Python tracker _

[issue24898] Documentation for str.find() is confusing

Roundup Robot added the comment: New changeset 7150e8a38c63 by Senthil Kumaran in branch '3.4': Issue24898 - Improve str.find documentation. https://hg.python.org/cpython/rev/7150e8a38c63 New changeset 164b564e3c1a by Senthil Kumaran in branch '3.5': merge from 3.4 https://hg.python.org/cpython/

[issue24898] Documentation for str.find() is confusing

Changes by Ezio Melotti : -- keywords: +easy stage: -> needs patch type: -> enhancement versions: +Python 2.7, Python 3.5 ___ Python tracker ___ ___

[issue24898] Documentation for str.find() is confusing

Ted Lemon added the comment: Hm, okay, that explains it. I was previously mystified. How about this as a refinement on your proposal, though: Return the lowest index in the string where substring sub is found within the string. Optional arguments start and end restrict the search to the sl

[issue24898] Documentation for str.find() is confusing

Georg Brandl added the comment: The "slice" clause is talking about the additional arguments. A clearer version could be Return the lowest index in the string where substring sub is found within the slice s[start:end]. Optional arguments start and end are interpreted as in slice notation.

[issue24898] Documentation for str.find() is confusing

New submission from Ted Lemon: The documentation for str.find() on python.org, for all current versions, says: Return the lowest index in the string where substring sub is found, such that sub is contained in the slice s[start:end]. Optional arguments start and end are interpreted as in slice