[Zope3-dev] Re: New Pyskel changes

[Guido van Rossum]

> In that case, the 'See IFoo' bit works fine;  it makes it clear that
> the implementation-specifc bits are extensions of the original. E.g.:
> 
>    class Foo:
>        __implements__(IFoo,)
>        #...
>        def getBar(self, optional_extra_hint=None):
>            """ See IFoo.
> 
>            'optional_extra_hint', if provided, ....
>            """

It may work for you.  I've repeatedly stated that it doesn't work for
me (or for anyone else here at PythonLabs).  That's not an opinion.
That's a fact.  The boilerplate docstring is unhelpful for me.

--Guido van Rossum (home page: http://www.python.org/~guido/)