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@pythoncraft.com) <*> http://www.pythoncraft.com/ "Typing is cheap. Thinking is expensive." --Roy Smith, c.l.py