[issue34612] doc Some classes are treated as functions in Built-in Functions

Raymond Hettinger added the comment: I concur with Eric. These were marked as functions in the function section of the docs. Their role as classes is noted in the body. And their role as complete classes with a listing of their methods is documented elsewhere. -- nosy:

[issue34612] doc Some classes are treated as functions in Built-in Functions

Eric V. Smith added the comment: Ah, you're correct. I just looked for the word "class" inside the "int" text, and it doesn't appear there: I thought it was deliberately left out. But it does show up in the sub-section header (before "int" itself). Sorry about that. The text changes look

[issue34612] doc Some classes are treated as functions in Built-in Functions

Andrés Delfino added the comment: Please note that several classes are marked as such (e.g., int, float, str, dict, list) and bool for example treats itself as a class in it's description. Perhaps your concerns applies to all those ocurrences too? --

[issue34612] doc Some classes are treated as functions in Built-in Functions

Eric V. Smith added the comment: I'm not sure this is an improvement. While it's true that 'complex' is a class, it's described here as a function. Same as 'int'. The fact that it's a function or class isn't so important here. I suspect it will confuse people to have something described as

[issue34612] doc Some classes are treated as functions in Built-in Functions

Change by Andrés Delfino : -- keywords: +patch pull_requests: +8572 stage: -> patch review ___ Python tracker ___ ___

[issue34612] doc Some classes are treated as functions in Built-in Functions

New submission from Andrés Delfino : Beyond other classes documented as functions (classmethod, enumerate, filter, map, reversed, staticmethod, super and zip), the following issues exist: * memoryview, range, and tuple are marked as functions * complex and object treat themselves as functions