This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author rhettinger
Recipients docs@python, nedbat, rhettinger
Date 2015-03-05.09:17:40
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1425547061.06.0.146047567046.issue19931@psf.upfronthosting.co.za>
In-reply-to
Content
I don't think we should strip-out all the docstrings because you're unhappy with automatically (mindlessly) generated documentation.  What you really need is more control over the documentation tool (the ability to save how much detail you want, particularly with subclasses of builtins which have a ton of methods with simplistic docstrings and with abstract base classes).  

The docstring for __repr__ isn't especially useful but it is a key feature of a namedtuple.  

The docstring for __getnewargs__ is informative especially if you're subclassing a named tuple and need to know what it is used for.   

The docstring for the individual property attributes doesn't look helpful when you list them all but does add information for one-at-a-time help, such as help(Key.blockscope), or for tooltips.   FWIW, there is also a proposal to make it easier to custom the default docstrings for the properties (to turn it into more of a data dictionary).
History
Date User Action Args
2015-03-05 09:17:41rhettingersetrecipients: + rhettinger, nedbat, docs@python
2015-03-05 09:17:41rhettingersetmessageid: <1425547061.06.0.146047567046.issue19931@psf.upfronthosting.co.za>
2015-03-05 09:17:41rhettingerlinkissue19931 messages
2015-03-05 09:17:40rhettingercreate