[issue24204] string.strip() documentation is misleading

Changes by Raymond Hettinger : -- assignee: docs@python -> rhettinger resolution: -> fixed stage: patch review -> resolved ___ Python tracker ___ ___

[issue24204] string.strip() documentation is misleading

Changes by Raymond Hettinger : -- status: open -> closed ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: https:

[issue24204] string.strip() documentation is misleading

Roundup Robot added the comment: New changeset 367e3923532f by Raymond Hettinger in branch 'default': Issue #24204: Elaborate of the str.strip() documentation. https://hg.python.org/cpython/rev/367e3923532f -- nosy: +python-dev ___ Python tracker

[issue24204] string.strip() documentation is misleading

Carol Willing added the comment: Updated patch with Terry's suggested changes. Thanks Terry and Raymond for the review of the initial patch. -- Added file: http://bugs.python.org/file39476/iss24204b.patch ___ Python tracker

[issue24204] string.strip() documentation is misleading

Raymond Hettinger added the comment: This patch looks reasonable. -- nosy: +rhettinger ___ Python tracker ___ ___ Python-bugs-list mai

[issue24204] string.strip() documentation is misleading

Terry J. Reedy added the comment: With 'leading end' and 'trailing end' replaced by 'left and 'right', the addition looks good to me. -- nosy: +terry.reedy ___ Python tracker __

[issue24204] string.strip() documentation is misleading

Carol Willing added the comment: Additional text added about stripping characters from the leading end and trailing end of the string. An additional example that illustrates the outer characters being stripped while the inner string characters, even though matching the chars set of characters,

[issue24204] string.strip() documentation is misleading

Jim added the comment: Maybe, "... all combinations of its values are stripped from the beginning and end." It is rather difficult to be both clear AND concise. Heck, I'm having trouble just trying to explain it. Mark, that part is clear, but I think somehow reiterating how the method works

[issue24204] string.strip() documentation is misleading

R. David Murray added the comment: Indeed, the sentence that confused you was added because people were continually confused by the fact that doing: 'foo.boo'.strip('.boo') would result in 'f' rather than 'foo'. We would welcome an improvement, but apparently this is very hard to make clea

[issue24204] string.strip() documentation is misleading

Mark Lawrence added the comment: https://docs.python.org/3/library/stdtypes.html#str.strip first sentence "Return a copy of the string with the leading and trailing characters removed." How can that be reworded to make it clearer? -- nosy: +BreamoreBoy ___

[issue24204] string.strip() documentation is misleading

New submission from Jim: This probably applies to all versions with the strip() method, but I'm using 3.4. Section 4.7.1 of the documentation has a poorly worded description/example for the behaviour of string.strip([chars]). A casual reading of "The chars argument is not a prefix or suffix; r