CompuServe Messages

>as I pointed out, I did this using comments in ALL my code. Comments DO NOT a clear program make. Are they important? Yes. Are they they the full formula? Definitely not. >Comments are always the best weapon against obscure code. I thought this >was self-evident, apparently not. Definitely not at all IMO. My experience has led me to want them, however I don't view them as extremely as you, but as one my piece to the puzzle and but one more weapon. Which is best depends upon the issue at hand. You don't buy, in addition to _accurate_ comments, issues like making code more self-documenting? Or, in some case, rewriting code? Or using a different algorithm? Or in others, making identifier names more appropriate? Etc… (all when obsurity is not in order that is). I thought thesealternatives were self-evident. >This is an issue that transcends the particular language under review. Surely. I sense that you are placing too much faith or something in them though. This is not to dispute that I want to add them in my own code and see them in somebody else's, but the act of commenting alone is not the bottom line IMO. We won't talk about issue like comments that are wrong and stuff like that either. Oh boy, are they fun! 😉