Lisandro Dalcin, 11.03.2010 15:29:
>> For comparison, Python attaches the docstrings
>> to the Foo.my_prop.fget, fset, and fdel methods. (The
>> Foo.my_prop.__get__ and whatnot all have generic docstrings.)
>
> Perhaps Cython could append the docstrings from
> __get__/__set__/__del__ to the top-level docstring?

-1, docstrings are often just used for code documentation, not necessarily 
for user documentation purposes. In any case, appending all three can have 
all sorts of ugly effects.

I'm fine with promoting the docstring of either __get__ or __set__ iff only 
one of them is used and no docstring has been defined. Doing more than that 
doesn't seem helpful.


> IIRC, Stefan did something similar for __cinit__ docstrings.

Nope.

Stefan
_______________________________________________
Cython-dev mailing list
[email protected]
http://codespeak.net/mailman/listinfo/cython-dev

Reply via email to