[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

Changes by Chris Jerdonek chris.jerdo...@gmail.com: -- resolution: - fixed stage: patch review - committed/rejected status: open - closed ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue16209

[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 rep...@bugs.python.org http://bugs.python.org/issue16209

[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

[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

[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

[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 rep...@bugs.python.org http://bugs.python.org/issue16209

[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

[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.

[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

[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.