I think the idea is to make code clear. If you cannot possibly make the code clear without comments, then put the comments into the code. Gratuitous comments are counter-productive.
On 9/29/05, Dave Newton <[EMAIL PROTECTED]> wrote: > Frank W. Zammetti wrote: > > > Let me ask this question... what's the HARM in "read in the bytes"? > > Having comments that are superfluous: > (a) still requires brain processing, and my brain is in short supply :/ > (b) obscures what's actually being done (see note below) > (c) requires maintenance > > Note: If comments like that are well to the right and justified along > some far-right column I'd be slightly mollified as it keeps them out of > the way. > > ...but I've never been through a code review where those comments > wouldn't have been tagged for deletion. They're just not helpful (in > this specific case). > > > Murray, have you ever actually had a compiler choke on a source file > > because of comments?!? > > I tweaked a compiler during college to do fun things when it encountered > naughty words in comments. That was fun. > > Dave > > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [EMAIL PROTECTED] > For additional commands, e-mail: [EMAIL PROTECTED] > > -- "You can lead a horse to water but you cannot make it float on its back." ~Dakota Jack~ --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
