<div>They are actually quite easy to get to. help() on both the class or instance produces the docstring, and __doc__ on the property as accessed from the class produces the docstring.</div><div><br></div><div><div>>>> class Test(object):</div>

<div>...     @property</div><div>...     def fred(self):</div><div>...             """<b>This is a docstring.</b>"""</div><div>...             return 1</div><div>...</div><div>>>> help(Test)</div>

<div>Help on class Test in module __main__:</div><div><br></div><div>class Test(__builtin__.object)</div><div> |  Data descriptors defined here:</div><div> |</div><div> |  __dict__</div><div> |      dictionary for instance variables (if defined)</div>

<div> |</div><div> |  __weakref__</div><div> |      list of weak references to the object (if defined)</div><div> |</div><div> |  fred</div><div> |      <b>This is a docstring.</b></div></div><div><div>>>> Test.fred.__doc__</div>

<div>'<b>This is a docstring</b>.'</div><div><div>>>> t = Test()</div><div>>>> t.fred.__doc__</div><div>'int(x[, base]) -> integer\n\n...'</div><div>>>> help(t)</div><div>Help on Test in module __main__ object:</div>

<div><br></div><div>class Test(__builtin__.object)</div><div> |  Data descriptors defined here:</div><div> |</div><div> |  __dict__</div><div> |      dictionary for instance variables (if defined)</div><div> |</div><div>
 |  __weakref__</div>
<div> |      list of weak references to the object (if defined)</div><div> |</div><div> |  fred</div><div> |      <b>This is a docstring.</b></div><div><br></div><div><br></div></div></div><div><br></div><div><br></div><br clear="all">

Chris<br>
<br><br><div class="gmail_quote">On Mon, Aug 8, 2011 at 12:05 PM, Steven D'Aprano <span dir="ltr"><<a href="mailto:steve%2Bcomp.lang.python@pearwood.info">steve+comp.lang.python@pearwood.info</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;"><div class="im">Ethan Furman wrote:<br>
<br>
> So if property docstrings are so hard to get to, what's the point in<br>
> having them?<br>
<br>
</div>Hard to get, not impossible. But I have no idea really -- they don't seem<br>
very useful to me.<br>
<div><div></div><div class="h5"><br>
<br>
<br>
--<br>
Steven<br>
<br>
--<br>
<a href="http://mail.python.org/mailman/listinfo/python-list" target="_blank">http://mail.python.org/mailman/listinfo/python-list</a><br>
</div></div></blockquote></div><br>