[issue16209] add a "class str" entry to the docs

Changes by Chris Jerdonek : -- resolution: -> fixed stage: patch review -> committed/rejected status: open -> closed ___ Python tracker ___ _

[issue16209] add a "class str" entry to the docs

Roundup Robot added the comment: New changeset 0097379df2e1 by Chris Jerdonek in branch '3.3': Add a str class entry to the "Text Sequence Type" section (issue #16209). http://hg.python.org/cpython/rev/0097379df2e1 New changeset 81ac75c64780 by Chris Jerdonek in branch 'default': Merge from 3.3:

[issue16209] add a "class str" entry to the docs

Chris Jerdonek added the comment: Attaching new patch to address Ezio's suggestions on Rietveld. -- Added file: http://bugs.python.org/file28143/issue-16209-3-default.patch ___ Python tracker __

[issue16209] add a "class str" entry to the docs

Chris Jerdonek added the comment: Updating patch to fix up affected/related index entries. -- Added file: http://bugs.python.org/file28124/issue-16209-2-default.patch ___ Python tracker

[issue16209] add a "class str" entry to the docs

Chris Jerdonek added the comment: > The simpler approach Chris has taken here (i.e. just leaving the string > methods separate from the class definition) also works. Yes, though I mentioned nesting the string methods beneath the class entry in the original post for this issue, I figured we cou

[issue16209] add a "class str" entry to the docs

Nick Coghlan added the comment: The simpler approach Chris has taken here (i.e. just leaving the string methods separate from the class definition) also works. Patch looks good to me - I'm definitely in favour of moving towards a more consistent approach of having the builtin function definiti

[issue16209] add a "class str" entry to the docs

Nick Coghlan added the comment: Right, aside from my recent revamp, much of the existing layout of the types section has been inherited from the pre-new style classes days when you *couldn't* inherit from types, and strings were the only one with a non-trivial number of methods. Rearranging a

[issue16209] add a "class str" entry to the docs

Chris Jerdonek added the comment: Attaching patch. Adding Nick to the nosy list because he did the work of originally breaking out the "Text Sequence Type" section for issue #4966, as well as Terry who created that issue. I view the current issue and patch as a progression of some of the iss

[issue16209] add a "class str" entry to the docs

Chris Jerdonek added the comment: Let me start over with what I'm suggesting, because the idea wasn't fully developed when I first filed this issue. I'm thinking that we should create a class entry for str that contains the current string methods nested beneath it -- a bit like issue 12901. :)

[issue16209] add a "class str" entry to the docs

Éric Araujo added the comment: This sort of request came up before, the last time only a few months ago if memory serves. The shot answer is that str is a built-in function as well as a class, and trying to split hairs over that does not really add value to the docs. I can dig up the issue(s

[issue16209] add a "class str" entry to the docs

New submission from Chris Jerdonek: This issue is to add a str class entry to the built-in types page like we have for dict, set, memoryview, etc: http://docs.python.org/dev/library/stdtypes.html This will let us reference ``str`` the class separately from ``str()`` the built-in function. It