[Zope3-dev] Re: New Pyskel changes

[Jim Fulton]

R. David Murray wrote:
 >
...

> It would be even nicer if the docstring could conventionally be
> broken into its two parts (Interface and implementation) so that
> the tool could (carefully) update the Interface part even on a
> method that has had its docstring expanded with implementation
> details. 

Note that a doc string should never be about implementation. That's
what comments are for. OTOH, a doc string may include additional usage
semantics that a particular implementation provides above and beyond
the semantics described in the interface. I *think* that that was what
Guido was refering to.

Jim

-- 
Jim Fulton           mailto:jim@zope.com       Python Powered!
CTO                  (888) 344-4332            http://www.python.org
Zope Corporation     http://www.zope.com       http://www.zope.org