[Python-Dev] readonly __doc__

[Antoine Pitrou]

Brett Cannon <brett <at> python.org> writes:
> 
> 
> I honestly don't follow that sentence. But __doc__ is special because of its 
> use; documenting how to use of an object. In this case when you call 
> something like help() on an instance of an object it skips the instance's 
> value for __doc__ and goes straight to the defining class and stops there as 
> you don't care how a subclass says to use itself as that is not what you are 
> working with.

I don't really understand how this explains the read-only __doc__.
I am talking about modifying __doc__ on a class, not on an instance.
(sure, a new-style class is also an instance of type, but still...)


Antoine.