[Zope3-dev] Re: New Pyskel changes

[Guido van Rossum]

> 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.

Yes, that's what I meant.  Many implementations provide additional
semantics, either in the form of restrictions and limitations, or in
the form of specifying behavior that isn't fully specified by the
interface.

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