Serhiy Storchaka added the comment:

> 1. Most data attributes cannot have individual docstrings, so I expect the 
> class docstring to list and possibly explain the data attributes. 

But almost all PyStructSequence field have individual docstrings.

> This does not create a second new class and is not a 'trick'.

Thanks for the tip.

> I presume that is why property docstrings are not used much.

Indeed, only 84 of 336 Python implemented properties have docstrings .
However this is even larger percent than for methods (about 8K of 43K).
And 100 of 115 PyStructSequence field have docstrings.

I think Python should have more docstrings, not less.

----------

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue16669>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to