On Friday 18 January 2002 11:24, Ian Bicking wrote:
> On Fri, 2002-01-18 at 14:20, Tavis Rudd wrote:
> > This 'quasi-properties' approach is faster than the
> > 'accessor-method' approach that Webware currently uses.  The true
> > 'properties' style is the equivalent to, or possibly slower than,
> > accessor methods.
>
> Ah, I see.  You mean the plain attribute style, which properties
> simulate.
>
> I feel like there's been proposals for adding doc strings to
> attributes...?  Ah... it's PEP 224, which has been rejected.  Guido
> proposed using a convention like:
>
> class Whatever
>     a = 10
>     __doc_a__ = 'a is used for whatever'


But then what about docstring processing tools like pydoc?

> Usually I'd just summarize all the attributes in the class doc
> string. It's easier to read anyway, though it can't be
> automatically extracted.

That works, but its not as clean as the current approach.  And it 
increases the chances of the docstring being out of date.

_______________________________________________
Webware-discuss mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/webware-discuss

Reply via email to