how to inherit docstrings?

Eric Snow ericsnowcurrently at gmail.com
Thu Jun 9 19:16:47 EDT 2011


On Thu, Jun 9, 2011 at 4:27 PM, Gregory Ewing
<greg.ewing at canterbury.ac.nz> wrote:
> IMO, it shouldn't be necessary to explicitly copy docstrings
> around like this in the first place. Either it should happen
> automatically, or help() should be smart enough to look up
> the inheritance hierarchy when given a method that doesn't
> have a docstring of its own.
>

Auto inheriting docstrings would be nice, in some cases.  WRT help(),
keep in mind that docstrings are used for a bunch of other things,
like doctests and some DSLs.

-eric

> Unfortunately, since unbound methods were ditched,
> help(Foo.blarg) no longer has an easy way to find the base
> classes, so help from the compiler may be needed.
>
> --
> Greg
> --
> http://mail.python.org/mailman/listinfo/python-list
>



More information about the Python-list mailing list