Dossy Shiobara wrote on 2011-09-03 15:42: > On one hand, I agree with Sam, for the most part, comments are a waste > of time and effort. Given a choice between NO comments vs. outdated > (now inaccurate) comments, I'd always, without hesitation, choose no > comments.
There's no outdated comments when you add onliners around the code. moslty because you comment the logic not the code itself. If you remove portion of code, comments shall be removed too. if you change one line > I'd rather the code be written cleaner. I suspect there are at least 2 > distinct bugs in spamdyke.c:middleman(), but it's so difficult to read, So you want comments or not? :) This is code, not a poem. It may not be clear at first glance and this is sometimes the right thing (i.e. optimalisations etc). That's why you shall have comment that tells what it meant there which significantly helps because once you know what the outcome is you can follow author way of writting (which usually differs from yours). If you got no development experience even perfect code with comments will be of no help. Regards, -- "Daddy, what "Formatting drive C:" means?"... Marcin http://wfmh.org.pl/carlos/ _______________________________________________ spamdyke-users mailing list [email protected] http://www.spamdyke.org/mailman/listinfo/spamdyke-users
