[Zope3-dev] Re: New Pyskel changes

[Steve Alexander]

Guido van Rossum wrote:
> 
>>>I'd be in favour of a tool that could re-apply docstrings to code,
>>>carefully changing "See Foo.Bar.Baz" style minimal docstrings into
>>>full copies of the originals. I could then use the cross-reference
>>>style during development, and switch to the full style once I'm
>>>sure the interfaces are fixed.
>>
> 
> But mindlessly reapplying the docstrings from the interfaces could
> create docstrings that don't match the implementation.

Hence "carefully" above. As in, only reapply docstrings when the 
existing docstring for the method is "See Foo.Bar.Baz". Do not reapply 
the docstring if it has been changed.

--
Steve Alexander