[Python-Dev] Best way to specify docstrings for member objects

[Raymond Hettinger]

> On Mar 20, 2019, at 3:47 PM, Ivan Pozdeev via Python-Dev <python-dev at python.org> wrote:
> 
>> NormalDist.mu.__doc__ = 'Arithmetic mean'
>> NormalDist.sigma.__doc__ = 'Standard deviation'
> 
> IMO this is another manifestation of the problem that things in the class definition have no access to the class object.
> Logically speaking, a definition item should be able to see everything that is defined before it.

The member objects get created downstream by the type() metaclass.  So, there isn't a visibility issue because the objects don't exist yet.


Raymond