On Sun, 17 Feb 2002 12:36:53 -0800, Nick Masluk wrote:

>I purposely left out all comments I had made, so when
>the code was looked at my potentially false thoughts
>on what was happening wouldn t interfere with other
>people s views (sort of like proofreading your own
>papers for grammar errors).  Without my comments, it
>forces you to look at each segment and figure out what
>is going on, and what I may have been trying to do.
>

Including the comments gives all of us a chance to see *why* you're
doing something and, from that, any areas of confusion that you may be
encountering. Divining someone's intentions from the code itself is
difficult at best and sometimes impossible.

My personal rule of thumb - The code lines say what I'm doing; the
comments say why I'm doing it.


Regards, Bob

--
http://www.piclist.com hint: The list server can filter out subtopics
(like ads or off topics) for you. See http://www.piclist.com/#topics