[Python-Dev] Re: decorators and 2.4

[Aahz]

On Fri, Jun 25, 2004, Bill Janssen wrote:
> Paul Prescod writes:
>>
>> Nobody reads code one line at a time from the top down. You scan for the 
>> bit that interests you and then look around for its context.
> 
> But I disagree with your statement here.  Everyone reads *unfamiliar*
> code one line at a time from the top.  If you're really reading it, I
> mean, rather than just looking for something in it.

Well, I'm not "everyone", though I suppose you could argue that I'm just
looking for something.  When I look at a module, I first skim it to find
the interesting parts.  I almost always know what the module is supposed
to do, so I'm looking for the bits that support the module's primary
purpose.  

You've got a point about cluttering the code, but *all* the proposed
solutions clutter code in some way.  I agree with Paul that you're being
unnecessarily alarmist.

My ordering of preference is:

Decorator after ``def``
JavaDoc style

I'm -1 on the proposal to put decorator before ``def``.
-- 
Aahz (aahz at pythoncraft.com)           <*>         http://www.pythoncraft.com/

"Typing is cheap.  Thinking is expensive."  --Roy Smith, c.l.py