Comment placement

> I once read that a good comment will appear on every conditional branch or loop

But be sure to put them outside the loop, so people won't have to read them over and over.

That gave me a good chuckle. Found on Slashdot

Posted November 30, 2005 1:22 PM

Comments

LOL. I had a chance to work with an IBM RS-6000 back in the early 90s, and I noticed that the graphical sys admin tool left a lot of shell scripts lying around in a temp directory, so naturally I browsed through them to see how it worked. In one of the scripts, I remember finding a loop where the first line assigned to a variable called $spam, and the next line was something like "echo $spam | command | command | command". That's when I changed my opinion of IBM. Any company that has programmers who write loops that sing "spam, spam, spam, spam..." couldn't be all bad :-)

Richard Schwartz, November 30, 2005 4:48 PM