Re: Normalized Numbers

Robert Cummings wrote: > On Fri, 2007-01-12 at 14:40 +0000, Roman Neuhauser wrote: >> I know it sounds crazy, but (most) comments are evil. Comments are are >> excuses for better code, they're often no more than a vague repetition >> of what the code says. If the code doesn't describe what it's doing >> while it's doing it, then the code should be fixed. > > Amen. > > There are not that many cases were comments are actually useful. > Generally when necessary they give a brief summary of what is intended > or they clarify ambiguity or specialized techniques. Well chosen > variable and function names cause the code to practically comment > itself. > > I think the discipline of using longer and more descriptive > variable/function/class names is far more helpful than commenting every > second line of code with the obvious. > >>> 2 // check if th function was passed only a single character >>> 3 if(1==strlen($cd)) { > > Ummm, DUH! :) I guess some of the comments are a little obvious. > Cheers, > Rob. -- Brian P. Giroux Sénécal & Associé.e.s / Associates Recherche et marketing / Research and marketing Tél : (705) 476-9667 Fax : (705) 476-1618 www.senecal.ca