This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author veky
Recipients docs@python, gone, steven.daprano, veky
Date 2017-08-26.13:39:25
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1503754766.39.0.261487701146.issue31283@psf.upfronthosting.co.za>
In-reply-to
Content
It's not hard to find a link. https://docs.python.org/3.7/reference/compound_stmts.html#class-definitions

But trying to change that to incorporate what OP is asking is a wild goose chase. There are numerous instances when a documentation is referring to a builtin. E.g.

(print): All non-keyword arguments are converted to strings like str() does
(repr): this function makes an attempt to return a string that would yield an object with the same value when passed to eval()
(type): The isinstance() built-in function is recommended for testing the type of an object

Of course, all of these must be changed, since they don't work as advertised if you rebind str, eval or isinstance.

I claim this is nonsense. If anything, we should educate people that when documentation refers to "the builtin X", it doesn't mean "whatever is current referrent of builtins.X". Never. Only "__import__" kinda works this way (though not in builtins, but in globals), and that's mostly a historic accident.
History
Date User Action Args
2017-08-26 13:39:26vekysetrecipients: + veky, steven.daprano, docs@python, gone
2017-08-26 13:39:26vekysetmessageid: <1503754766.39.0.261487701146.issue31283@psf.upfronthosting.co.za>
2017-08-26 13:39:26vekylinkissue31283 messages
2017-08-26 13:39:25vekycreate