[Python-ideas] inheriting docstrings and mutable docstings for classes

David Stanek dstanek at dstanek.com
Fri Jun 10 12:37:23 CEST 2011

On Fri, Jun 10, 2011 at 3:04 AM, Greg Ewing <greg.ewing at canterbury.ac.nz>wrote:

> Maybe the best thing would be for the inherited docstring
> to get put into a different property, such as __basedoc__.
> Then tools that examine docstrings can decide for themselves
> whether using inherited docstrings makes sense.
How would a tool know if the behavior of a method changed without analyzing
the code? I think this could very easily lead to a situation where a
project's generated documentation is incorrect.

blog: http://www.traceback.org
twitter: http://twitter.com/dstanek
www: http://dstanek.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/python-ideas/attachments/20110610/b58ae078/attachment.html>

More information about the Python-ideas mailing list