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 ncoghlan
Recipients eric.snow, ncoghlan
Date 2012-08-20.04:37:09
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1345437452.28.0.514901819881.issue15731@psf.upfronthosting.co.za>
In-reply-to
Content
While working on #8810, I was reminded of the problem of wanting to inherit docstrings while replacing a method implementation.

The abstract base class method docstrings for tzinfo.utcoffset and tzinfo.dst are also correct for the concrete subclasses in the pure Python and the C versions. However, the docstrings currently need to be duplicated in all 3 places manually.

functools.wraps already plays in this space, but arguably asserts *too much* about the relationship between components

A couple of descriptors on bound and unbound methods (for __doc__ and __signature__) could have dealt with this fairly easily, but we don't have unbound methods any more :(
History
Date User Action Args
2012-08-20 04:37:32ncoghlansetrecipients: + ncoghlan, eric.snow
2012-08-20 04:37:32ncoghlansetmessageid: <1345437452.28.0.514901819881.issue15731@psf.upfronthosting.co.za>
2012-08-20 04:37:10ncoghlanlinkissue15731 messages
2012-08-20 04:37:09ncoghlancreate