problem with property docstrings

Michael Muller mmuller at
Sat Jul 23 17:28:30 CEST 2005

I've observed something strange about property docstrings and I'm
wondering if anyone here can clarify what's going on:  if I create a class
derived from property, the docstrings of the instances end up being that
of the derived class, not the docstring passed into the property
constructor.  Example:

class MyProp(property):
	"MyProp docstring"
class Foo:
	p = MyProp(None, None, None, "property p docstring")
>>> Foo.p.__doc__
'MyProp docstring'

Can anyone explain why this is?  Is this a bug?

More information about the Python-list mailing list