[Python-ideas] inheriting docstrings and mutable docstings for classes
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.
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the Python-ideas